@flighthq/spritesheet-formats 0.1.0

package/dist/cocosPlistSerialize.js

@@ -0,0 +1,86 @@
+/** Serialise a SpritesheetData to a Cocos Creator / Cocos2d-x plist XML atlas string.
+ *
+ *  Pass the `document` returned by `parseCocosPlistSpritesheetDocument` to preserve any
+ *  fields that don't round-trip through the data (format version, metadata). */
+export function serializeCocosPlistSpritesheet(data, existing) {
+    const frames = {};
+    for (const frame of data.frames) {
+        frames[frame.name] = frameToEntry(frame);
+    }
+    const doc = {
+        frames,
+        metadata: {
+            format: existing?.metadata?.format ?? 3,
+            size: `{${data.imageWidth},${data.imageHeight}}`,
+            textureFileName: data.imageFile || existing?.metadata?.textureFileName || '',
+        },
+    };
+    return documentToXml(doc);
+}
+function documentToXml(doc) {
+    const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+        '<plist version="1.0">',
+        '<dict>',
+        '\t<key>frames</key>',
+        '\t<dict>',
+    ];
+    for (const [name, frame] of Object.entries(doc.frames)) {
+        lines.push(`\t\t<key>${escapeXml(name)}</key>`);
+        lines.push('\t\t<dict>');
+        lines.push(`\t\t\t<key>frame</key>`);
+        lines.push(`\t\t\t<string>${escapeXml(frame.frame)}</string>`);
+        lines.push(`\t\t\t<key>spriteOffset</key>`);
+        lines.push(`\t\t\t<string>${escapeXml(frame.spriteOffset)}</string>`);
+        lines.push(`\t\t\t<key>spriteSize</key>`);
+        lines.push(`\t\t\t<string>${escapeXml(frame.spriteSize)}</string>`);
+        lines.push(`\t\t\t<key>spriteSourceSize</key>`);
+        lines.push(`\t\t\t<string>${escapeXml(frame.spriteSourceSize)}</string>`);
+        lines.push(`\t\t\t<key>spriteTrimmed</key>`);
+        lines.push(`\t\t\t${plistValue(frame.spriteTrimmed)}`);
+        lines.push(`\t\t\t<key>textureRotated</key>`);
+        lines.push(`\t\t\t${plistValue(frame.textureRotated)}`);
+        lines.push('\t\t</dict>');
+    }
+    lines.push('\t</dict>');
+    lines.push('\t<key>metadata</key>');
+    lines.push('\t<dict>');
+    lines.push('\t\t<key>format</key>');
+    lines.push(`\t\t<integer>${doc.metadata.format}</integer>`);
+    lines.push('\t\t<key>size</key>');
+    lines.push(`\t\t<string>${escapeXml(doc.metadata.size)}</string>`);
+    lines.push('\t\t<key>textureFileName</key>');
+    lines.push(`\t\t<string>${escapeXml(doc.metadata.textureFileName)}</string>`);
+    lines.push('\t</dict>');
+    lines.push('</dict>');
+    lines.push('</plist>');
+    return lines.join('\n');
+}
+function escapeXml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function frameToEntry(frame) {
+    const rectStr = `{{${frame.x},${frame.y}},{${frame.width},${frame.height}}}`;
+    const offsetStr = `{${frame.offsetX},${frame.offsetY}}`;
+    const sourceSizeStr = `{${frame.sourceWidth},${frame.sourceHeight}}`;
+    const sizeStr = `{${frame.width},${frame.height}}`;
+    const trimmed = frame.offsetX !== 0 ||
+        frame.offsetY !== 0 ||
+        frame.sourceWidth !== frame.width ||
+        frame.sourceHeight !== frame.height;
+    return {
+        frame: rectStr,
+        spriteOffset: offsetStr,
+        spriteSize: sizeStr,
+        spriteSourceSize: sourceSizeStr,
+        spriteTrimmed: trimmed,
+        textureRotated: frame.rotated,
+    };
+}
+function plistValue(el) {
+    if (typeof el === 'boolean')
+        return el ? '<true/>' : '<false/>';
+    return `<string>${escapeXml(String(el))}</string>`;
+}
+//# sourceMappingURL=cocosPlistSerialize.js.map

package/dist/cocosPlistSerialize.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './asepriteParse';
+export * from './asepriteSchema';
+export * from './asepriteSerialize';
+export * from './cocosPlistParse';
+export * from './cocosPlistSchema';
+export * from './cocosPlistSerialize';
+export * from './libgdxAtlasParse';
+export * from './libgdxAtlasSchema';
+export * from './spritesheetDetect';
+export * from './starlingParse';
+export * from './starlingSchema';
+export * from './starlingSerialize';
+export * from './texturePackerParse';
+export * from './texturePackerSchema';
+export * from './texturePackerSerialize';
+//# 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,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from './asepriteParse';
+export * from './asepriteSchema';
+export * from './asepriteSerialize';
+export * from './cocosPlistParse';
+export * from './cocosPlistSchema';
+export * from './cocosPlistSerialize';
+export * from './libgdxAtlasParse';
+export * from './libgdxAtlasSchema';
+export * from './spritesheetDetect';
+export * from './starlingParse';
+export * from './starlingSchema';
+export * from './starlingSerialize';
+export * from './texturePackerParse';
+export * from './texturePackerSchema';
+export * from './texturePackerSerialize';
+//# 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,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/libgdxAtlasParse.d.ts

@@ -0,0 +1,13 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+export interface LibgdxAtlasParseOptions {
+    /** Default duration (ms) per frame when building inferred animations. Defaults to 100. */
+    frameDuration?: number;
+}
+/** Parse a LibGDX `.atlas` text string directly to a `SpritesheetData`.
+ *
+ *  Single-pass line-by-line parser. Handles single-page and multi-page atlases.
+ *  `rotate: true` regions are marked as `rotated` (90° clockwise in the atlas).
+ *  Animations are inferred from the standard `baseName_NNN` frame-naming convention;
+ *  indexed regions (`index >= 0`) are also grouped into animations. */
+export declare function parseLibgdxAtlasSpritesheet(text: string, options?: LibgdxAtlasParseOptions): SpritesheetData;
+//# sourceMappingURL=libgdxAtlasParse.d.ts.map

package/dist/libgdxAtlasParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libgdxAtlasParse.d.ts","sourceRoot":"","sources":["../src/libgdxAtlasParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAU7G,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoND;;;;;uEAKuE;AACvE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,eAAe,CAyB5G"}

package/dist/libgdxAtlasParse.js

@@ -0,0 +1,209 @@
+import { createSpritesheetAnimationData, createSpritesheetData, createSpritesheetFrameData, } from '@flighthq/spritesheet';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { parseTextureAtlasLibgdxAtlas } from '@flighthq/textureatlas-formats';
+// ─── Parser ───────────────────────────────────────────────────────────────────
+function parseIntPair(value) {
+    const parts = value.split(',');
+    return [parseInt(parts[0] ?? '0', 10), parseInt(parts[1] ?? '0', 10)];
+}
+function isFilename(line) {
+    return /[./]/.test(line) || /^\w+\.\w+$/.test(line);
+}
+function parseLibgdxAtlas(text) {
+    const lines = text.split(/\r?\n/);
+    const pages = [];
+    const regions = [];
+    let currentPage = null;
+    let currentRegion = null;
+    for (const raw of lines) {
+        const trimmed = raw.trim();
+        if (trimmed === '') {
+            // Blank line: commit any in-progress region; next unindented non-empty line is a page filename
+            if (currentRegion !== null) {
+                regions.push(currentRegion);
+                currentRegion = null;
+            }
+            continue;
+        }
+        const isIndented = raw[0] === ' ' || raw[0] === '\t';
+        if (isIndented) {
+            // Key: value line belonging to current page header or current region
+            const colonIdx = trimmed.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const key = trimmed.slice(0, colonIdx).trim();
+            const value = trimmed.slice(colonIdx + 1).trim();
+            if (currentRegion !== null) {
+                // Region attribute
+                switch (key) {
+                    case 'rotate':
+                        currentRegion.rotated = value === 'true';
+                        break;
+                    case 'xy': {
+                        const [x, y] = parseIntPair(value);
+                        currentRegion.x = x;
+                        currentRegion.y = y;
+                        break;
+                    }
+                    case 'size': {
+                        const [w, h] = parseIntPair(value);
+                        currentRegion.spriteWidth = w;
+                        currentRegion.spriteHeight = h;
+                        break;
+                    }
+                    case 'orig': {
+                        const [sw, sh] = parseIntPair(value);
+                        currentRegion.sourceWidth = sw;
+                        currentRegion.sourceHeight = sh;
+                        break;
+                    }
+                    case 'offset': {
+                        const [ox, oy] = parseIntPair(value);
+                        currentRegion.offsetX = ox;
+                        currentRegion.offsetY = oy;
+                        break;
+                    }
+                    case 'index':
+                        currentRegion.index = parseInt(value, 10);
+                        break;
+                }
+            }
+            else if (currentPage !== null) {
+                // Page header attribute
+                switch (key) {
+                    case 'size': {
+                        const [w, h] = parseIntPair(value);
+                        currentPage.width = w;
+                        currentPage.height = h;
+                        break;
+                    }
+                }
+            }
+        }
+        else {
+            // Unindented non-empty line: either a page filename or a region name
+            if (currentRegion !== null) {
+                regions.push(currentRegion);
+                currentRegion = null;
+            }
+            if (isFilename(trimmed) && currentPage === null) {
+                // First unindented non-kv line after a blank (or at start) is a page filename
+                currentPage = { filename: trimmed, height: 0, width: 0 };
+                pages.push(currentPage);
+            }
+            else if (isFilename(trimmed) && currentPage !== null && trimmed !== currentPage.filename) {
+                // Another page filename (multi-page atlas)
+                currentPage = { filename: trimmed, height: 0, width: 0 };
+                pages.push(currentPage);
+            }
+            else {
+                // Region name
+                if (currentPage === null) {
+                    // Malformed: no page seen yet; create a stub page
+                    currentPage = { filename: '', height: 0, width: 0 };
+                    pages.push(currentPage);
+                }
+                currentRegion = {
+                    index: -1,
+                    name: trimmed,
+                    offsetX: 0,
+                    offsetY: 0,
+                    page: currentPage,
+                    rotated: false,
+                    sourceHeight: 0,
+                    sourceWidth: 0,
+                    spriteHeight: 0,
+                    spriteWidth: 0,
+                    x: 0,
+                    y: 0,
+                };
+            }
+        }
+    }
+    // Commit trailing region
+    if (currentRegion !== null) {
+        regions.push(currentRegion);
+    }
+    return { pages, regions };
+}
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+// Maps an atlas region (geometry owned by @flighthq/textureatlas-formats — incl. libGDX rotate/orig/
+// offset handling and the `name_index` disambiguation for indexed regions) to a spritesheet frame.
+function frameFromRegion(region) {
+    return createSpritesheetFrameData({
+        height: region.height,
+        name: region.name ?? '',
+        offsetX: region.sourceX,
+        offsetY: region.sourceY,
+        pivotX: region.pivotX,
+        pivotY: region.pivotY,
+        rotated: region.rotated,
+        sourceHeight: region.originalHeight ?? region.height,
+        sourceWidth: region.originalWidth ?? region.width,
+        width: region.width,
+        x: region.x,
+        y: region.y,
+    });
+}
+/** Infer animations from frame names using the `baseName_NNN` convention.
+ *  Frames whose names do not end in a numeric suffix are left as standalone frames. */
+function inferAnimations(frameNames, frameDuration) {
+    const groups = new Map();
+    for (const name of frameNames) {
+        const noExt = name.replace(/\.\w+$/, '');
+        const match = noExt.match(/^(.*?)_?(\d+)$/);
+        if (!match)
+            continue;
+        const [, base, numStr] = match;
+        const index = parseInt(numStr, 10);
+        const bucket = groups.get(base);
+        if (bucket)
+            bucket.push({ index, name });
+        else
+            groups.set(base, [{ index, name }]);
+    }
+    const animations = [];
+    for (const [base, entries] of groups) {
+        if (entries.length < 2)
+            continue;
+        entries.sort((a, b) => a.index - b.index);
+        animations.push(createSpritesheetAnimationData({
+            frameDuration,
+            frameNames: entries.map((e) => e.name),
+            loop: true,
+            name: base,
+        }));
+    }
+    return animations;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/** Parse a LibGDX `.atlas` text string directly to a `SpritesheetData`.
+ *
+ *  Single-pass line-by-line parser. Handles single-page and multi-page atlases.
+ *  `rotate: true` regions are marked as `rotated` (90° clockwise in the atlas).
+ *  Animations are inferred from the standard `baseName_NNN` frame-naming convention;
+ *  indexed regions (`index >= 0`) are also grouped into animations. */
+export function parseLibgdxAtlasSpritesheet(text, options) {
+    const frameDuration = options?.frameDuration ?? 100;
+    // Page metadata (image file + size) is libGDX-specific and not modeled by TextureAtlas, so it is read
+    // from the local page parse; the region geometry is delegated to the atlas-formats parser.
+    const { pages } = parseLibgdxAtlas(text);
+    // Use the first page for top-level image metadata
+    const firstPage = pages[0];
+    const imageFile = firstPage?.filename ?? '';
+    const imageWidth = firstPage?.width ?? 0;
+    const imageHeight = firstPage?.height ?? 0;
+    const regions = parseTextureAtlasLibgdxAtlas(text, createTextureAtlas()).regions;
+    const frames = regions.map(frameFromRegion);
+    const frameNames = frames.map((f) => f.name);
+    const animations = inferAnimations(frameNames, frameDuration);
+    return createSpritesheetData({
+        animations,
+        frames,
+        imageFile,
+        imageHeight,
+        imageWidth,
+        scale: 1,
+    });
+}
+//# sourceMappingURL=libgdxAtlasParse.js.map

package/dist/libgdxAtlasParse.js.map

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

package/dist/libgdxAtlasSchema.d.ts

@@ -0,0 +1,38 @@
+export interface LibgdxAtlasDocument {
+    pages: LibgdxAtlasPage[];
+}
+export interface LibgdxAtlasPage {
+    /** Texture filter for downscaling. */
+    filterMag: string;
+    /** Texture filter for upscaling. */
+    filterMin: string;
+    /** Pixel format string (e.g. 'RGBA8888'). */
+    format: string;
+    /** Relative path to the atlas image file for this page. */
+    imageFile: string;
+    /** Regions packed onto this page. */
+    regions: LibgdxAtlasRegion[];
+    /** Texture repeat mode. */
+    repeat: string;
+    /** Atlas image dimensions [width, height]. */
+    size: [number, number];
+}
+export interface LibgdxAtlasRegion {
+    /** Zero-based sequential index for animation grouping (-1 when unused). */
+    index: number;
+    /** Region name as written in the atlas. */
+    name: string;
+    /** Packed [x, y] position used for 9-patch or trim (same as xy when untrimmed). */
+    offset: [number, number];
+    /** Offset from original image top-left to the trimmed content [x, y]. */
+    orig: [number, number];
+    /** [originalWidth, originalHeight] of the region before trimming. */
+    origSize: [number, number];
+    /** Whether the region is rotated 90° CCW in the atlas. */
+    rotate: boolean;
+    /** [width, height] of the region in the atlas. */
+    size: [number, number];
+    /** [x, y] position of the region in the atlas. */
+    xy: [number, number];
+}
+//# sourceMappingURL=libgdxAtlasSchema.d.ts.map

package/dist/libgdxAtlasSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libgdxAtlasSchema.d.ts","sourceRoot":"","sources":["../src/libgdxAtlasSchema.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,yEAAyE;IACzE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,qEAAqE;IACrE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,kDAAkD;IAClD,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtB"}

package/dist/libgdxAtlasSchema.js

@@ -0,0 +1,6 @@
+// libGDX / Spine text-format atlas schema.
+// Reference: https://libgdx.com/wiki/tools/texture-packer#atlas-file-format
+// The .atlas / pack.atlas text format is widely used across libGDX, Spine, and related tooling.
+// A file may contain multiple pages, each beginning with a blank line followed by the image filename.
+export {};
+//# sourceMappingURL=libgdxAtlasSchema.js.map

package/dist/libgdxAtlasSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libgdxAtlasSchema.js","sourceRoot":"","sources":["../src/libgdxAtlasSchema.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,4EAA4E;AAC5E,gGAAgG;AAChG,sGAAsG"}

package/dist/spritesheetDetect.d.ts

@@ -0,0 +1,41 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { SpritesheetFormatKind } from '@flighthq/types';
+export interface SpritesheetParseOptions {
+    /** Default frame duration in ms used by formats that do not embed per-frame timing. Defaults to 100. */
+    frameDuration?: number;
+    /** Atlas image height for formats that omit dimensions (e.g. Starling). */
+    imageHeight?: number;
+    /** Atlas image width for formats that omit dimensions (e.g. Starling). */
+    imageWidth?: number;
+}
+/** Detect the format kind of a spritesheet text document.
+ *
+ *  Returns the `SpritesheetFormatKind` of the first registered format whose
+ *  `detect` function returns `true`, or `null` when no format is recognized. */
+export declare function detectSpritesheetFormat(text: string): SpritesheetFormatKind | null;
+/** Retrieve the registered entry for a given `SpritesheetFormatKind`.
+ *
+ *  Returns the `{ detect, parse }` entry for the given kind, or `null` when no
+ *  format with that kind has been registered. Useful for introspecting which formats
+ *  are in the registry or for building meta-dispatch logic on top of the registry. */
+export declare function getSpritesheetFormat(kind: SpritesheetFormatKind): Readonly<{
+    detect: (text: string) => boolean;
+    parse: (text: string, options: SpritesheetParseOptions) => SpritesheetData;
+}> | null;
+/** Parse a spritesheet text document to a SpritesheetData, auto-detecting the format.
+ *
+ *  Accepts an optional `formatKind` override — useful when the format is known in advance
+ *  and sniffing overhead is undesirable, or when the input is ambiguous.
+ *
+ *  Returns `null` when the format cannot be recognized (expected failure — not a throw). */
+export declare function parseSpritesheet(text: string, formatKind?: SpritesheetFormatKind, options?: SpritesheetParseOptions): SpritesheetData | null;
+/** Register a custom spritesheet format for use with `detectSpritesheetFormat` and `parseSpritesheet`.
+ *
+ *  Registration is last-write-wins; a built-in entry can be replaced by registering
+ *  the same `SpritesheetFormatKind`. Third-party formats should use a vendor-prefixed kind
+ *  (e.g. `'acme.MyAtlas'`) to avoid colliding with built-ins. */
+export declare function registerSpritesheetFormat(kind: SpritesheetFormatKind, entry: {
+    detect: (text: string) => boolean;
+    parse: (text: string, options: SpritesheetParseOptions) => SpritesheetData;
+}): void;
+//# sourceMappingURL=spritesheetDetect.d.ts.map

package/dist/spritesheetDetect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetDetect.d.ts","sourceRoot":"","sources":["../src/spritesheetDetect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAe7D,MAAM,WAAW,uBAAuB;IACtC,wGAAwG;IACxG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkED;;;gFAGgF;AAChF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAKlF;AAED;;;;sFAIsF;AACtF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,QAAQ,CAAC;IAC1E,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,eAAe,CAAC;CAC5E,CAAC,GAAG,IAAI,CAER;AAED;;;;;4FAK4F;AAC5F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,uBAAuB,GAChC,eAAe,GAAG,IAAI,CAOxB;AAED;;;;iEAIiE;AACjE,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE;IACL,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,eAAe,CAAC;CAC5E,GACA,IAAI,CAEN"}

package/dist/spritesheetDetect.js

@@ -0,0 +1,101 @@
+import { SpritesheetFormatKindAseprite as ASEPRITE, SpritesheetFormatKindCocosPlist as COCOS_PLIST, SpritesheetFormatKindLibgdxAtlas as LIBGDX_ATLAS, SpritesheetFormatKindStarling as STARLING, SpritesheetFormatKindTexturePacker as TEXTURE_PACKER, } from '@flighthq/types';
+import { parseAsepriteSpritesheet } from './asepriteParse';
+import { parseCocosPlistSpritesheet } from './cocosPlistParse';
+import { parseLibgdxAtlasSpritesheet } from './libgdxAtlasParse';
+import { parseStarlingSpritesheet } from './starlingParse';
+import { parseTexturePackerSpritesheet } from './texturePackerParse';
+let _registry = null;
+function detectTexturePacker(text) {
+    if (text.trimStart()[0] !== '{')
+        return false;
+    return /"meta"\s*:/.test(text) && /"app"\s*:/.test(text);
+}
+function detectAseprite(text) {
+    if (text.trimStart()[0] !== '{')
+        return false;
+    return /"meta"\s*:/.test(text) && /aseprite\.org/i.test(text);
+}
+function detectCocosPlist(text) {
+    const trimmed = text.trimStart();
+    return (trimmed[0] === '<' || trimmed.startsWith('<?xml')) && /<plist\b/i.test(text);
+}
+function detectStarling(text) {
+    return /<TextureAtlas\b/i.test(text);
+}
+function detectLibgdxAtlas(text) {
+    const ch = text.trimStart()[0];
+    if (ch === '<' || ch === '{')
+        return false;
+    return /^\s*rotate\s*:/m.test(text) || /^\s*xy\s*:/m.test(text);
+}
+function getRegistry() {
+    if (_registry !== null)
+        return _registry;
+    _registry = new Map();
+    _registry.set(ASEPRITE, {
+        detect: detectAseprite,
+        parse: (text) => parseAsepriteSpritesheet(text),
+    });
+    _registry.set(COCOS_PLIST, {
+        detect: detectCocosPlist,
+        parse: (text) => parseCocosPlistSpritesheet(text),
+    });
+    _registry.set(TEXTURE_PACKER, {
+        detect: detectTexturePacker,
+        parse: (text) => parseTexturePackerSpritesheet(text),
+    });
+    _registry.set(STARLING, {
+        detect: detectStarling,
+        parse: (text, opts) => parseStarlingSpritesheet(text, { frameDuration: opts.frameDuration }),
+    });
+    _registry.set(LIBGDX_ATLAS, {
+        detect: detectLibgdxAtlas,
+        parse: (text, opts) => parseLibgdxAtlasSpritesheet(text, { frameDuration: opts.frameDuration }),
+    });
+    return _registry;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Detect the format kind of a spritesheet text document.
+ *
+ *  Returns the `SpritesheetFormatKind` of the first registered format whose
+ *  `detect` function returns `true`, or `null` when no format is recognized. */
+export function detectSpritesheetFormat(text) {
+    for (const [kind, entry] of getRegistry()) {
+        if (entry.detect(text))
+            return kind;
+    }
+    return null;
+}
+/** Retrieve the registered entry for a given `SpritesheetFormatKind`.
+ *
+ *  Returns the `{ detect, parse }` entry for the given kind, or `null` when no
+ *  format with that kind has been registered. Useful for introspecting which formats
+ *  are in the registry or for building meta-dispatch logic on top of the registry. */
+export function getSpritesheetFormat(kind) {
+    return getRegistry().get(kind) ?? null;
+}
+/** Parse a spritesheet text document to a SpritesheetData, auto-detecting the format.
+ *
+ *  Accepts an optional `formatKind` override — useful when the format is known in advance
+ *  and sniffing overhead is undesirable, or when the input is ambiguous.
+ *
+ *  Returns `null` when the format cannot be recognized (expected failure — not a throw). */
+export function parseSpritesheet(text, formatKind, options) {
+    const opts = options ?? {};
+    const kind = formatKind ?? detectSpritesheetFormat(text);
+    if (!kind)
+        return null;
+    const entry = getRegistry().get(kind);
+    if (!entry)
+        return null;
+    return entry.parse(text, opts);
+}
+/** Register a custom spritesheet format for use with `detectSpritesheetFormat` and `parseSpritesheet`.
+ *
+ *  Registration is last-write-wins; a built-in entry can be replaced by registering
+ *  the same `SpritesheetFormatKind`. Third-party formats should use a vendor-prefixed kind
+ *  (e.g. `'acme.MyAtlas'`) to avoid colliding with built-ins. */
+export function registerSpritesheetFormat(kind, entry) {
+    getRegistry().set(kind, entry);
+}
+//# sourceMappingURL=spritesheetDetect.js.map

package/dist/spritesheetDetect.js.map

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

package/dist/starlingParse.d.ts

@@ -0,0 +1,20 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { StarlingDocument } from './starlingSchema';
+export interface StarlingParsed {
+    data: SpritesheetData;
+    document: StarlingDocument;
+}
+export interface StarlingParseOptions {
+    /** Default duration (ms) per frame when building inferred animations. Defaults to 100. */
+    frameDuration?: number;
+}
+/** Parse a Starling / Sparrow XML atlas string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Animations are inferred from the standard `baseName_NNN` frame-naming convention.
+ *  Use `parseStarlingSpritesheetDocument` instead when you need round-trip serialisation. */
+export declare function parseStarlingSpritesheet(xml: string, options?: StarlingParseOptions): SpritesheetData;
+/** Parse a Starling / Sparrow XML atlas string and preserve the full document
+ *  for round-trip serialisation via `serializeStarlingSpritesheet`. */
+export declare function parseStarlingSpritesheetDocument(xml: string, options?: StarlingParseOptions): StarlingParsed;
+//# sourceMappingURL=starlingParse.d.ts.map

package/dist/starlingParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingParse.d.ts","sourceRoot":"","sources":["../src/starlingParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAU7G,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkID;;;;6FAI6F;AAC7F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,eAAe,CAErG;AAED;uEACuE;AACvE,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAG5G"}