@bscotch/sprite-source 1.4.0

package/dist/SpriteSource.js

@@ -0,0 +1,153 @@
+import { __decorate, __metadata } from "tslib";
+import { existsSafe, pathy } from '@bscotch/pathy';
+import { sequential } from '@bscotch/utility';
+import { SpriteCache } from './SpriteCache.js';
+import { spriteSourceConfigSchema, } from './SpriteSource.schemas.js';
+import { FIO_RETRY_DELAY, MAX_FIO_RETRIES, retryOptions } from './constants.js';
+import { SpriteSourceError, assert, deletePngChildren, getDirs, rethrow, } from './utility.js';
+export class SpriteSource extends SpriteCache {
+    get configFile() {
+        return this.stitchDir
+            .join('sprites.source.json')
+            .withValidator(spriteSourceConfigSchema);
+    }
+    async resolveStaged(staging) {
+        const dir = pathy(staging.dir, this.spritesRoot);
+        if (!(await existsSafe(dir, retryOptions))) {
+            this.issues.push(new SpriteSourceError(`Staging directory does not exist: ${dir}`));
+            return;
+        }
+        // Identify all "SpriteDirs". Stored as a set so we
+        // can remove the ones we process.
+        const spriteDirs = new Set(await this.getSpriteDirs(await getDirs(dir.absolute)));
+        for (const transform of staging.transforms) {
+            // filter to matching sprites
+            const pattern = transform.include
+                ? new RegExp(transform.include)
+                : undefined;
+            const sprites = [];
+            for (const sprite of spriteDirs) {
+                if (!pattern || sprite.path.relative.match(pattern)) {
+                    sprites.push(sprite);
+                    spriteDirs.delete(sprite);
+                }
+            }
+            const waits = [];
+            for (const sprite of sprites) {
+                let outDirPath = sprite.path.relative;
+                if (transform.renames) {
+                    for (const rename of transform.renames) {
+                        outDirPath = outDirPath.replace(new RegExp(rename.from), rename.to);
+                    }
+                }
+                const outDir = pathy(outDirPath, this.spritesRoot);
+                // Crop it!
+                const cropWait = transform.crop ? sprite.crop() : Promise.resolve();
+                // Bleed it!
+                const bleedWait = cropWait.then(() => transform.bleed ? sprite.bleed() : Promise.resolve());
+                // Purge the output location!
+                const deleteWait = bleedWait.then(() => transform.synced
+                    ? deletePngChildren(outDir).then((deleted) => {
+                        this.logs.push(...deleted.map((path) => ({
+                            action: 'deleted',
+                            path: path.absolute,
+                        })));
+                    })
+                    : Promise.resolve());
+                // Save to destination (including renames)
+                const moveWait = deleteWait.then(() => sprite.moveTo(outDir));
+                waits.push(moveWait);
+            }
+            await Promise.allSettled(waits);
+            // Delete any folders-of-empty-folders
+            const dirs = await getDirs(dir.absolute);
+            for (const dir of dirs) {
+                if ((await dir.exists()) && (await dir.isEmptyDirectory())) {
+                    await dir.delete({
+                        recursive: true,
+                        force: true,
+                        retryDelay: FIO_RETRY_DELAY,
+                        maxRetries: MAX_FIO_RETRIES,
+                    });
+                }
+            }
+        }
+    }
+    async loadConfig(overrides = {}) {
+        // Validate options. Show error out if invalid.
+        try {
+            overrides = spriteSourceConfigSchema.parse(overrides);
+        }
+        catch (err) {
+            rethrow(err, 'Invalid SpriteSource options');
+        }
+        assert(await this.spritesRoot.isDirectory(), 'Source must be an existing directory.');
+        // Update the config
+        await this.stitchDir.ensureDirectory();
+        const config = await this.configFile.read({
+            fallback: {},
+            maxRetries: MAX_FIO_RETRIES,
+            retryDelayMillis: FIO_RETRY_DELAY,
+        });
+        const snapshot = JSON.stringify(config);
+        if (overrides?.ignore !== undefined) {
+            config.ignore = overrides.ignore;
+        }
+        if (overrides?.staging !== undefined) {
+            config.staging = overrides.staging;
+        }
+        if (snapshot !== JSON.stringify(config)) {
+            try {
+                await this.configFile.write(config, {
+                    maxRetries: MAX_FIO_RETRIES,
+                    retryDelayMillis: FIO_RETRY_DELAY,
+                });
+            }
+            catch (err) {
+                console.error(err);
+            }
+        }
+        return config;
+    }
+    /**
+     * Transform any staged sprites and add them to the source,
+     * and compute updated sprite info.
+     */
+    async update(
+    /** Optionally override config options */
+    options) {
+        const config = await this.loadConfig(options);
+        // Process any staging folders
+        for (const staging of config.staging ?? []) {
+            // Do them sequentially since later patterns could overlap earlier ones
+            await this.resolveStaged(staging);
+        }
+        // Update the sprite info cache
+        const info = await this.updateSpriteInfo(config.ignore);
+        return info;
+    }
+    /**
+     * @param options If specified, creates/overwrites the config file with these options.
+     */
+    static async from(spritesRoot, options) {
+        // Ensure the spritesRoot exists
+        assert(await existsSafe(spritesRoot, retryOptions), `Sprites root does not exist: ${spritesRoot}`);
+        const source = new SpriteSource(spritesRoot);
+        // Ensure a config file
+        await source.loadConfig(options);
+        return source;
+    }
+}
+__decorate([
+    sequential,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SpriteSource.prototype, "loadConfig", null);
+__decorate([
+    sequential,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], SpriteSource.prototype, "update", null);
+//# sourceMappingURL=SpriteSource.js.map

package/dist/SpriteSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSource.js","sourceRoot":"","sources":["../src/SpriteSource.ts"],"names":[],"mappings":"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"}

package/dist/SpriteSource.schemas.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export type SpriteSourceStage = z.infer<typeof spriteStagingSchema>;
+declare const spriteStagingSchema: z.ZodObject<{
+    dir: z.ZodString;
+    transforms: z.ZodArray<z.ZodObject<{
+        include: z.ZodOptional<z.ZodString>;
+        bleed: z.ZodOptional<z.ZodBoolean>;
+        crop: z.ZodOptional<z.ZodBoolean>;
+        synced: z.ZodOptional<z.ZodBoolean>;
+        renames: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type SpriteSourceConfig = z.infer<typeof spriteSourceConfigSchema>;
+export declare const spriteSourceConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    staging: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        dir: z.ZodString;
+        transforms: z.ZodArray<z.ZodObject<{
+            include: z.ZodOptional<z.ZodString>;
+            bleed: z.ZodOptional<z.ZodBoolean>;
+            crop: z.ZodOptional<z.ZodBoolean>;
+            synced: z.ZodOptional<z.ZodBoolean>;
+            renames: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>>;
+    ignore: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+}, z.core.$loose>;
+export declare const spriteSourceConfigInfo: {
+    schema: z.ZodObject<{
+        $schema: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+        staging: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            dir: z.ZodString;
+            transforms: z.ZodArray<z.ZodObject<{
+                include: z.ZodOptional<z.ZodString>;
+                bleed: z.ZodOptional<z.ZodBoolean>;
+                crop: z.ZodOptional<z.ZodBoolean>;
+                synced: z.ZodOptional<z.ZodBoolean>;
+                renames: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>>>;
+        ignore: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$loose>;
+    name: string;
+    filename: string;
+};
+export {};
+//# sourceMappingURL=SpriteSource.schemas.d.ts.map

package/dist/SpriteSource.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSource.schemas.d.ts","sourceRoot":"","sources":["../src/SpriteSource.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqCxB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACpE,QAAA,MAAM,mBAAmB;;;;;;;;;;;;iBAWvB,CAAC;AAIH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;iBAgBnC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;CAIlC,CAAC"}

package/dist/SpriteSource.schemas.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { jsonSchemaRemoteDir } from './constants.js';
+const spriteSourceTransformSchema = z.looseObject({
+    include: z
+        .string()
+        .optional()
+        .describe('Pattern to match against the folder path (relative to the staging root, using POSIX seps) for it to be included. If omitted, all sprites are included. Converted to a regex with `new RegExp(include)`.'),
+    bleed: z.boolean().optional().describe('Whether to bleed the image.'),
+    crop: z.boolean().optional().describe('Whether to crop the image.'),
+    synced: z
+        .boolean()
+        .optional()
+        .describe('Whether to sync the target folder to the staging folder, by deleting any files in the target folder that are not in the staging folder.'),
+    renames: z
+        .array(z.looseObject({
+        from: z
+            .string()
+            .describe('Regex pattern to match against the filename, for use as the 1st arg in the JavaScript `String.replace` function.'),
+        to: z
+            .string()
+            .describe('Replacement string for the filename, for use as the 2nd arg in the JavaScript `String.replace` function.'),
+    }))
+        .optional()
+        .describe('Rules for renaming when moving to the SpriteSource directory.'),
+});
+const spriteStagingSchema = z.looseObject({
+    dir: z
+        .string()
+        .describe('Path to the folder containing the raw images. Either relative to the SpriteSource root or absolute.'),
+    transforms: z
+        .array(spriteSourceTransformSchema)
+        .describe('Transformations to apply to the raw images while moving them to the SpriteSource directory. Images are removed after a matching transform, and any images not matching any transforms are left alone.'),
+});
+const schemaFilename = 'stitch.sprite-source.schema.json';
+const remoteFilename = `${jsonSchemaRemoteDir}/${schemaFilename}`;
+export const spriteSourceConfigSchema = z.looseObject({
+    $schema: z.string().default(remoteFilename).optional(),
+    staging: z
+        .array(spriteStagingSchema)
+        .nullable()
+        .describe('List of folders containing raw images to be imported into a GameMaker project, along with transformation options for those images to apply during import.')
+        .optional(),
+    ignore: z
+        .array(z.string())
+        .nullable()
+        .optional()
+        .describe('List of ignore patterns for sprites that should be excluded from caching and importing. Will be converted to a regex with `new RegExp()` and checked against the spritefolder path (relative to the SpritSource root, using POSIX seps).'),
+});
+export const spriteSourceConfigInfo = {
+    schema: spriteSourceConfigSchema,
+    name: 'Sprite Source Configuration',
+    filename: schemaFilename,
+};
+//# sourceMappingURL=SpriteSource.schemas.js.map

package/dist/SpriteSource.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSource.schemas.js","sourceRoot":"","sources":["../src/SpriteSource.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,2BAA2B,GAAG,CAAC,CAAC,WAAW,CAAC;IAChD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yMAAyM,CAC1M;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACnE,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,yIAAyI,CAC1I;IACH,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,WAAW,CAAC;QACZ,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,kHAAkH,CACnH;QACH,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,QAAQ,CACP,0GAA0G,CAC3G;KACJ,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC,CAAC;AAGH,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC;IACxC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,qGAAqG,CACtG;IACH,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,2BAA2B,CAAC;SAClC,QAAQ,CACP,uMAAuM,CACxM;CACJ,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D,MAAM,cAAc,GAAG,GAAG,mBAAmB,IAAI,cAAc,EAAE,CAAC;AAElE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACtD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,mBAAmB,CAAC;SAC1B,QAAQ,EAAE;SACV,QAAQ,CACP,2JAA2J,CAC5J;SACA,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,0OAA0O,CAC3O;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,wBAAwB;IAChC,IAAI,EAAE,6BAA6B;IACnC,QAAQ,EAAE,cAAc;CACzB,CAAC"}

package/dist/checksum.d.ts

@@ -0,0 +1,4 @@
+export declare function computeFileChecksum(filePath: string): Promise<string>;
+export declare function computeFilesChecksum(paths: string[]): Promise<string>;
+export declare function computeStringChecksum(str: string): string;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../src/checksum.ts"],"names":[],"mappings":"AAcA,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3E;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIzD"}

package/dist/checksum.js

@@ -0,0 +1,28 @@
+import { computePngChecksum } from '@bscotch/pixel-checksum';
+import crypto from 'node:crypto';
+import fsp from 'node:fs/promises';
+/**
+ * A quick checksum for arbitrary text-based file types
+ * (like JSON or atlas), where newlines are first normalized.
+ */
+async function textFileChecksum(filePath) {
+    const content = await fsp.readFile(filePath, 'utf8');
+    const normalized = content.replace(/\r/g, '').trim();
+    return computeStringChecksum(normalized);
+}
+export async function computeFileChecksum(filePath) {
+    if (!filePath.match(/\.png$/i)) {
+        return await textFileChecksum(filePath);
+    }
+    return computePngChecksum(filePath);
+}
+export async function computeFilesChecksum(paths) {
+    const checksums = await Promise.all(paths.map(computeFileChecksum));
+    return computeStringChecksum(checksums.join('-'));
+}
+export function computeStringChecksum(str) {
+    const hash = crypto.createHash('md5');
+    hash.update(str);
+    return hash.digest('hex');
+}
+//# sourceMappingURL=checksum.js.map

package/dist/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../src/checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,GAAG,MAAM,kBAAkB,CAAC;AAEnC;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAe;IACxD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACpE,OAAO,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/cli.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","sourceRoot":"","sources":["../src/cli.mts"],"names":[],"mappings":""}

package/dist/cli.mjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+import { pathy } from '@bscotch/pathy';
+import { defineCommand, runMain } from 'citty';
+import { pathToFileURL } from 'node:url';
+import meta from '../package.json' with { type: 'json' };
+import { SpriteDest } from './SpriteDest.js';
+import { SpriteSource } from './SpriteSource.js';
+const main = defineCommand({
+    meta: {
+        name: 'spsrc',
+        version: meta.version,
+        description: 'sprite-source pipeline utilities',
+    },
+    subCommands: {
+        'add-source': defineCommand({
+            meta: {
+                name: 'add-source',
+                description: `ensure that a sprite source directory is initialized and use it in a destination GameMaker project (doesn't overwrite your configs if they're already set up)`,
+            },
+            args: {
+                source: {
+                    type: 'positional',
+                    description: 'a directory serving as a sprite source root',
+                    required: true,
+                    valueHint: '.',
+                },
+                project: {
+                    type: 'positional',
+                    description: 'path to the .yyp file for the target GameMaker project (or folder containing that file) into which the sprites should be imported',
+                    valueHint: 'path/to/project.yyp',
+                },
+            },
+            async run(context) {
+                const src = await SpriteSource.from(context.args.source);
+                const srcConfig = await src.loadConfig();
+                // Ensure a source config with a default stage
+                if (!srcConfig.staging?.length) {
+                    srcConfig.staging = [{ dir: '.', transforms: [] }];
+                    await src.loadConfig(srcConfig);
+                }
+                console.log('Edit your source config at');
+                console.log(pathToFileURL(src.configFile.relative).toString());
+                console.log();
+                // Ensure a dest config that imports it
+                let projectYypPath = pathy(context.args.project);
+                if (!projectYypPath.hasExtension('yyp')) {
+                    // Assume it's a directory containing a yyp file and find it
+                    projectYypPath = (await pathy(projectYypPath).findChild(/\.yyp$/));
+                    if (!projectYypPath) {
+                        console.error('Provided project path was neither a yyp file nor a folder containing one.');
+                        process.exit(1);
+                    }
+                }
+                const dest = await SpriteDest.from(projectYypPath);
+                const destConfig = await dest.loadConfig();
+                destConfig.sources ||= [];
+                const relativeSourcePath = dest.yypPath
+                    .up()
+                    .relativeTo(src.spritesRoot);
+                if (!destConfig.sources.find((src) => pathy(src.source).equals(relativeSourcePath))) {
+                    destConfig.sources.push({
+                        source: relativeSourcePath,
+                    });
+                    // Reload with this new config as an override
+                    await dest.loadConfig(destConfig);
+                }
+                console.log('Edit your project config at');
+                console.log(pathToFileURL(dest.configFile.relative).toString());
+                console.log();
+            },
+        }),
+        import: defineCommand({
+            meta: {
+                name: 'import',
+                description: 'import new/updated sprites from any configured sprite sources into a GameMaker project',
+            },
+            args: {
+                project: {
+                    type: 'positional',
+                    default: '.',
+                    description: 'path to the GameMaker project, either the yyp file or the folder containing it',
+                    required: false,
+                },
+            },
+            async run(context) {
+                // Find the project
+                let projectYypPath = pathy(context.args.project || '.');
+                if (!projectYypPath.hasExtension('yyp')) {
+                    // Assume it's a directory containing a yyp file and find it
+                    projectYypPath = (await pathy(projectYypPath).findChild(/\.yyp$/));
+                    if (!projectYypPath) {
+                        console.error('Provided project path was neither a yyp file nor a folder containing one.');
+                        process.exit(1);
+                    }
+                }
+                const dest = await SpriteDest.from(projectYypPath);
+                console.log('Importing new and updated sprites...');
+                const results = await dest.import();
+                for (const result of results || []) {
+                    console.log('  ✅', result.resource.name);
+                }
+                if (!results?.length) {
+                    console.log('  No changes found.');
+                }
+                else {
+                    console.log('Import complete!');
+                }
+            },
+        }),
+    },
+});
+runMain(main);
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sourceRoot":"","sources":["../src/cli.mts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+import type { FileRetryOptions } from '@bscotch/pathy';
+export declare const MAX_FIO_RETRIES = 20;
+export declare const FIO_RETRY_DELAY = 100;
+export declare const retryOptions: FileRetryOptions;
+export declare const spriteDestConfigFilename = "sprites.import.json";
+export declare const spriteCacheFilename = "sprites.info.json";
+export declare const jsonSchemaRemoteDir = "https://raw.githubusercontent.com/bscotch/stitch/refs/heads/develop/packages/sprite-source/schemas";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,YAAY,EAAE,gBAG1B,CAAC;AAEF,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,eAAO,MAAM,mBAAmB,uGACsE,CAAC"}

package/dist/constants.js

@@ -0,0 +1,10 @@
+export const MAX_FIO_RETRIES = 20;
+export const FIO_RETRY_DELAY = 100;
+export const retryOptions = {
+    maxRetries: MAX_FIO_RETRIES,
+    retryDelayMillis: FIO_RETRY_DELAY,
+};
+export const spriteDestConfigFilename = 'sprites.import.json';
+export const spriteCacheFilename = 'sprites.info.json';
+export const jsonSchemaRemoteDir = 'https://raw.githubusercontent.com/bscotch/stitch/refs/heads/develop/packages/sprite-source/schemas';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,UAAU,EAAE,eAAe;IAC3B,gBAAgB,EAAE,eAAe;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAC9B,oGAAoG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { spritesInfoSchema, type SpritesInfo } from './SpriteCache.schemas.js';
+export * from './SpriteDest.actions.js';
+export { SpriteDest } from './SpriteDest.js';
+export { spriteDestConfigSchema, type SpriteDestConfig, type SpriteDestSource, } from './SpriteDest.schemas.js';
+export { SpriteDir } from './SpriteDir.js';
+export { SpriteSource } from './SpriteSource.js';
+export { spriteSourceConfigSchema, type SpriteSourceConfig, type SpriteSourceStage, } from './SpriteSource.schemas.js';
+export type { Issue, Log } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC/E,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { spritesInfoSchema } from './SpriteCache.schemas.js';
+export * from './SpriteDest.actions.js';
+export { SpriteDest } from './SpriteDest.js';
+export { spriteDestConfigSchema, } from './SpriteDest.schemas.js';
+export { SpriteDir } from './SpriteDir.js';
+export { SpriteSource } from './SpriteSource.js';
+export { spriteSourceConfigSchema, } from './SpriteSource.schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,0BAA0B,CAAC;AAC/E,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,wBAAwB,GAGzB,MAAM,2BAA2B,CAAC"}

package/dist/safeFs.d.ts

@@ -0,0 +1,5 @@
+import { Pathy } from '@bscotch/pathy';
+import type { Dirent } from 'node:fs';
+export declare function readdirSafe(dir: string | Pathy): Promise<string[]>;
+export declare function readdirSafeWithFileTypes(dir: string | Pathy): Promise<Dirent[]>;
+//# sourceMappingURL=safeFs.d.ts.map

package/dist/safeFs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeFs.d.ts","sourceRoot":"","sources":["../src/safeFs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAgCtC,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAExE;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,GAAG,KAAK,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB"}

package/dist/safeFs.js

@@ -0,0 +1,34 @@
+import fsp from 'node:fs/promises';
+import { FIO_RETRY_DELAY, MAX_FIO_RETRIES } from './constants.js';
+import { SpriteSourceError } from './utility.js';
+/**
+ * A wrapper around `fs.readdir` that retries a few times and
+ * uses the `withFileTypes` option.
+ */
+async function _readdirSafe(dir, withFileTypes) {
+    let retries = 0;
+    let files = [];
+    let error = null;
+    while (retries < MAX_FIO_RETRIES) {
+        error = null;
+        try {
+            // @ts-expect-error withFileTypes can only be `true` in the types
+            files = await fsp.readdir(dir.toString(), { withFileTypes });
+            return files;
+        }
+        catch (err) {
+            error = new SpriteSourceError(`Failed to read directory ${dir}`, err);
+            retries++;
+            await new Promise((resolve) => setTimeout(resolve, FIO_RETRY_DELAY));
+            continue;
+        }
+    }
+    throw error;
+}
+export async function readdirSafe(dir) {
+    return await _readdirSafe(dir, false);
+}
+export async function readdirSafeWithFileTypes(dir) {
+    return await _readdirSafe(dir, true);
+}
+//# sourceMappingURL=safeFs.js.map

package/dist/safeFs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeFs.js","sourceRoot":"","sources":["../src/safeFs.ts"],"names":[],"mappings":"AAEA,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;GAGG;AACH,KAAK,UAAU,YAAY,CACzB,GAAmB,EACnB,aAAiB;IAEjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAU,EAAE,CAAC;IACtB,IAAI,KAAK,GAA6B,IAAI,CAAC;IAC3C,OAAO,OAAO,GAAG,eAAe,EAAE,CAAC;QACjC,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,CAAC;YACH,iEAAiE;YACjE,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,IAAI,iBAAiB,CAAC,4BAA4B,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;YACtE,OAAO,EAAE,CAAC;YACV,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAmB;IACnD,OAAO,MAAM,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAmB;IAEnB,OAAO,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+export interface Log {
+    action: 'deleted' | 'moved' | 'skipped-collaborator-owned';
+    path: string;
+    to?: string;
+}
+export interface BBox {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export interface Issue {
+    level: 'error' | 'warning';
+    message: string;
+    cause?: any;
+}
+export type AnyFunction<R> = (...args: any) => R extends Promise<infer U> ? Promise<U> : R;
+export type Reporter = {
+    report(value: {
+        message?: string | undefined;
+        /** Percentage points to add to the completion metric */
+        increment?: number | undefined;
+    }): void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,4BAA4B,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAC3B,GAAG,IAAI,EAAE,GAAG,KACT,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEjD,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,CAAC,KAAK,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,wDAAwD;QACxD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,GAAG,IAAI,CAAC;CACV,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utility.d.ts

@@ -0,0 +1,25 @@
+import { Pathy } from '@bscotch/pathy';
+export type AnyFunc = (...args: any) => any;
+export type Checked<T extends AnyFunc> = [error: Error, result: null] | [error: null, result: ReturnType<T>];
+export type AsyncableChecked<T extends AnyFunc> = ReturnType<T> extends Promise<any> ? Promise<Checked<T>> : Checked<T>;
+export declare function check<T extends AnyFunc>(func: T, message: string): AsyncableChecked<T>;
+export declare class SpriteSourceError extends Error {
+    constructor(message: string, cause?: any, asserter?: Function);
+}
+export declare function assert(condition: any, message: string, cause?: any): asserts condition;
+export declare function rethrow(cause: any, message: string): void;
+export declare function getDirs(rootFolder: string, maxDepth?: number): Promise<Pathy[]>;
+/**
+ * Delete the PNG images inside a folder. Returns the list of
+ * deleted images.
+ */
+export declare function deletePngChildren(path: Pathy): Promise<Pathy<unknown>[]>;
+/**
+ * Asynchronously get the size of a PNG image, given its path,
+ * with maximal speed.
+ */
+export declare function getPngSize(path: Pathy): Promise<{
+    width: number;
+    height: number;
+}>;
+//# sourceMappingURL=utility.d.ts.map

package/dist/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../src/utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAiB,MAAM,gBAAgB,CAAC;AAKtD,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;AAC5C,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,OAAO,IACjC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAC5B,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzC,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,IAC5C,UAAU,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAExE,wBAAgB,KAAK,CAAC,CAAC,SAAS,OAAO,EACrC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,MAAM,GACd,gBAAgB,CAAC,CAAC,CAAC,CAmBrB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,QAAQ;CAM9D;AAED,wBAAgB,MAAM,CACpB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,SAAS,CAKnB;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,QAIlD;AAED,wBAAsB,OAAO,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAW,GAClB,OAAO,CAAC,KAAK,EAAE,CAAC,CAoBlB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,KAAK,6BAgBlD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,KAAK,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAc5C"}