bc39c94851
- casInsert verifies an existing object's bytes before trusting it, fsyncs before the rename, and the store records object sizes so a crash-truncated object reads as dirty instead of clean forever. - The driver hashes sources over the producer closure, so partial builds (inspect) that pull in producers outside the demanded set work. - Unknown executor errors are reported and abort the build instead of vanishing into allSettled. - %b/%B expand to nominal names at declaration (never CAS basenames), which also puts name-dependence in the identity key; cmds are key-joined with NUL so a multi-line command cannot collide with split commands. This churns every rule key once. - Rules must declare at least one output; output names reject shell-hostile characters. - run --link copies read-only (CAS) sources instead of hardlinking 0444 modes into deploy trees; ctx.list filters dotfiles and directories like the build-side glob; inspect resolves targets against the invoking cwd. - The registry dedupes identical declarations (same cmds/inputs/deps/ outputs/display), returning the existing artifacts, so shared rule sets are plain functions and memo() is gone; ps.deploy.ts no longer declares the gen5 gif set it never ships. - rule() returns a tuple typed by its literal output list (single string output returns the Artifact directly), so destructuring needs no non-null assertions. - Manifest is a class carrying the deploy ctx: set() rejects duplicate keys, write(dst) emits the sorted JSON, and spritecopy/itemspritecopy/ stampcopy take just the manifest. The unstamped smogon sets (xyitems, fbsprites, twittersprites) are deprecated and commented out. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Pokémon Sprites
The Smogon / Pokémon Showdown! sprite repository.
Installation
This project depends on
- ImageMagick >= 7
- gifsicle
- AdvPng (optional)
- OptiPNG (optional)
- pngquant (optional)
- pnpm
- node.js >= 24
- cwebp
Windows
Windows binaries of these dependencies can be found on the download pages of the sites listed above.
Linux
$ sudo apt install nodejs imagemagick gifsicle advancecomp optipng pngquant webp
$ sudo npm install -g pnpm
You may have to build imagemagick from source to get version 7.
$ sudo apt install build-essential pkg-config libltdl-dev libperl-dev libpng-dev libjpeg-dev
$ wget https://imagemagick.org/download/ImageMagick.tar.gz
$ tar xf ImageMagick.tar.gz
$ cd ImageMagick-*
$ ./configure --with-modules --enable-shared --with-perl
$ sudo make -j install
$ sudo ldconfig /usr/local/lib
macOS
Using brew on a macOS:
$ brew install imagemagick gifsicle advancecomp optipng pngquant webp
Building and deploying
Install dependencies once with pnpm install.
Each deploy is a root *.deploy.ts module: it declares its build rules
(shared sets are plain functions in rules/; declaring an identical rule
twice is a no-op returning the existing artifacts, so any number of deploys
can call the same set) and a finish function that maps the built artifacts
to their published names. Build outputs are content-addressed:
rules declare nominal output filenames but the store names every object by
the hash of its bytes (under .build/cas/), so incrementality keys on
content, same-byte renames rebuild nothing, and hash-stamped publishing
reuses the build's digests. All state lives in .build/.
$ pnpm build # build every deploy's rules, GC stale state
$ pnpm deploy # assets.deploy.ts -> tar -> DEPLOY_COMMAND (.env)
$ node tools/deploy/index.ts build ps.deploy.ts # build one deploy's rules
$ node tools/deploy/index.ts run smogon.deploy.ts -o deploy/smogon
$ node tools/deploy/index.ts inspect src/minisprites/items/i1.png -o /tmp/out
run materializes a deploy to a directory (--link hardlinks, --tar
writes a tar file) without uploading anything. inspect builds every rule
that consumes the given source paths (and their transitive consumers) and
copies the outputs out under readable names for eyeballing.
Useful flags: -j <n> parallelism, -n dry run, -v verbose,
--fail-fast stop after the first failure.
Configuration
Build settings are configurable in build.config (not tracked by git).
DEFAULT_OPTIPNG: Command line to pass tooptipng.DEFAULT_ADVPNG: Command line to pass toadvpng.DEFAULT_PNGQUANT: Command line to pass topngquant.
There are src-specific versions of these settings:
TRAINERS_<PROGRAM>: Compression options fortrainers/only.DEX_<PROGRAM>: Compression options fordex/only.MODELS_<PROGRAM>: Compression options formodels/only.SPRITESHEET_<PROGRAM>: Compression options for spritesheets only.MINISPRITE_<PROGRAM>: Compression options forminisprites/only.
For example, these settings reflect the compression settings for the files chaos uploaded in src/:
DEFAULT_OPTIPNG=-o7
DEFAULT_ADVPNG=-z4 -i5000
Gotchas
- The build tool only tracks the inputs a rule declares. If a build tool reads
files that aren't on its command line (e.g. it does a
readdir()), declare them with the rule'sdeps:so changes are detected. - Rule identity is content-only by default: renaming a source without
changing its bytes rebuilds nothing. If a tool bakes input names into
its output bytes (the spritesheet builders do), the rule must set
nameSensitive: trueor renames will leave its output silently stale. - Rules must be declared when a deploy module is imported (top level), not
inside
finish— the build runs before finish does.
License
All code in this repository is licensed under the MIT License.
The sprites themselves are property of Nintendo / Game Freak / The Pokémon Company, though Black & White sprites for Pokémon from later generations were created by artists in the community. The license for these community-created sprites is still being determined and may change in the future, but in the meantime please talk to use first before using them.
The PMD sprites are from SpriteCollab. The exact list of contributors can be found in spritecollab_credit_names.txt of this repository.