@flighthq/spritesheet-formats 0.1.0

package/dist/asepriteParse.d.ts

@@ -0,0 +1,18 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { AsepriteDocument } from './asepriteSchema';
+export interface AsepriteParsed {
+    data: SpritesheetData;
+    document: AsepriteDocument;
+}
+/** Parse an Aseprite JSON string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseAsepriteSpritesheetDocument` instead when you need round-trip serialisation.
+ *
+ *  Per-frame durations from Aseprite are preserved in `animation.frameDurations`
+ *  when frames within a tag have varying durations. */
+export declare function parseAsepriteSpritesheet(json: string): SpritesheetData;
+/** Parse an Aseprite JSON string and preserve the full document for round-trip
+ *  serialisation via `serializeAsepriteSpritesheet`. */
+export declare function parseAsepriteSpritesheetDocument(json: string): AsepriteParsed;
+//# sourceMappingURL=asepriteParse.d.ts.map

package/dist/asepriteParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteParse.d.ts","sourceRoot":"","sources":["../src/asepriteParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAU7G,OAAO,KAAK,EAAsB,gBAAgB,EAAkC,MAAM,kBAAkB,CAAC;AAE7G,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAgFD;;;;;;uDAMuD;AACvD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEtE;AAED;wDACwD;AACxD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAG7E"}

package/dist/asepriteParse.js

@@ -0,0 +1,87 @@
+import { createSpritesheetAnimationData, createSpritesheetData, createSpritesheetFrameData, } from '@flighthq/spritesheet';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { parseTextureAtlasAsepriteDocument } from '@flighthq/textureatlas-formats';
+// ─── Internal helpers ────────────────────────────────────────────────────────
+// Maps an atlas region (geometry owned by @flighthq/textureatlas-formats) to a spritesheet frame.
+// Aseprite carries no pivot; per-frame durations are layered on separately from the document.
+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,
+    });
+}
+function metaScale(meta) {
+    if (typeof meta.scale === 'string')
+        return parseFloat(meta.scale) || 1;
+    return meta.scale;
+}
+function animationFromTag(tag, frameNames, durationMap) {
+    const tagFrameNames = frameNames.slice(tag.from, tag.to + 1);
+    const durations = tagFrameNames.map((n) => durationMap.get(n) ?? 100);
+    const firstDuration = durations[0] ?? 100;
+    const uniform = durations.every((d) => d === firstDuration);
+    return createSpritesheetAnimationData({
+        direction: tag.direction ?? 'forward',
+        frameDuration: firstDuration,
+        frameDurations: uniform ? null : durations,
+        frameNames: tagFrameNames,
+        loop: true,
+        name: tag.name,
+    });
+}
+function documentToData(doc) {
+    // Region geometry is delegated to the atlas-formats parser (shared Aseprite document shape); this
+    // package adds the per-frame durations and tag-based animations, which the atlas layer does not model.
+    const regions = parseTextureAtlasAsepriteDocument(doc, createTextureAtlas()).regions;
+    const frames = regions.map(frameFromRegion);
+    const frameNames = regions.map((region) => region.name ?? '');
+    const durationMap = new Map();
+    if (Array.isArray(doc.frames)) {
+        for (const entry of doc.frames)
+            durationMap.set(entry.filename, entry.duration);
+    }
+    else {
+        for (const [name, entry] of Object.entries(doc.frames))
+            durationMap.set(name, entry.duration);
+    }
+    const { meta } = doc;
+    const animations = meta.frameTags && meta.frameTags.length > 0
+        ? meta.frameTags.map((tag) => animationFromTag(tag, frameNames, durationMap))
+        : [];
+    return createSpritesheetData({
+        animations,
+        frames,
+        imageFile: meta.image,
+        imageHeight: meta.size.h,
+        imageWidth: meta.size.w,
+        scale: metaScale(meta),
+    });
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Parse an Aseprite JSON string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseAsepriteSpritesheetDocument` instead when you need round-trip serialisation.
+ *
+ *  Per-frame durations from Aseprite are preserved in `animation.frameDurations`
+ *  when frames within a tag have varying durations. */
+export function parseAsepriteSpritesheet(json) {
+    return documentToData(JSON.parse(json));
+}
+/** Parse an Aseprite JSON string and preserve the full document for round-trip
+ *  serialisation via `serializeAsepriteSpritesheet`. */
+export function parseAsepriteSpritesheetDocument(json) {
+    const document = JSON.parse(json);
+    return { data: documentToData(document), document };
+}
+//# sourceMappingURL=asepriteParse.js.map

package/dist/asepriteParse.js.map

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

package/dist/asepriteSchema.d.ts

@@ -0,0 +1,64 @@
+export interface AsepriteRect {
+    h: number;
+    w: number;
+    x: number;
+    y: number;
+}
+export interface AsepriteSize {
+    h: number;
+    w: number;
+}
+export interface AsepriteFrameTag {
+    /** Playback direction for this tag range. */
+    direction: 'forward' | 'pingpong' | 'pingpong_reverse' | 'reverse';
+    /** Index of last frame in this tag (inclusive). */
+    from: number;
+    name: string;
+    /** Index of first frame in this tag (inclusive). */
+    to: number;
+    /** Optional hex colour label assigned in Aseprite. */
+    color?: string;
+}
+export interface AsepriteLayer {
+    blendMode: string;
+    name: string;
+    opacity: number;
+}
+export interface AsepriteBaseFrame {
+    /** Per-frame display duration in milliseconds — key difference from Texture Packer. */
+    duration: number;
+    frame: AsepriteRect;
+    rotated: boolean;
+    sourceSize: AsepriteSize;
+    spriteSourceSize: AsepriteRect;
+    trimmed: boolean;
+}
+/** Hash variant: each value in the `frames` dict is one of these. */
+export type AsepriteHashFrame = AsepriteBaseFrame;
+/** Array variant: each element of the `frames` array is one of these. */
+export interface AsepriteArrayFrame extends AsepriteBaseFrame {
+    filename: string;
+}
+export interface AsepriteMeta {
+    app: string;
+    format: string;
+    frameTags: AsepriteFrameTag[];
+    image: string;
+    layers?: AsepriteLayer[];
+    scale: number | string;
+    size: AsepriteSize;
+    slices?: unknown[];
+    version: string;
+}
+/** Hash-keyed variant: `frames` is a plain object whose keys are frame names. */
+export interface AsepriteHashDocument {
+    frames: Record<string, AsepriteHashFrame>;
+    meta: AsepriteMeta;
+}
+/** Array variant: `frames` is an array and each entry carries a `filename` field. */
+export interface AsepriteArrayDocument {
+    frames: AsepriteArrayFrame[];
+    meta: AsepriteMeta;
+}
+export type AsepriteDocument = AsepriteArrayDocument | AsepriteHashDocument;
+//# sourceMappingURL=asepriteSchema.d.ts.map

package/dist/asepriteSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteSchema.d.ts","sourceRoot":"","sources":["../src/asepriteSchema.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACnE,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;IACzB,gBAAgB,EAAE,YAAY,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAElD,yEAAyE;AACzE,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1C,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC"}

package/dist/asepriteSchema.js

@@ -0,0 +1,6 @@
+// Aseprite JSON export schema — field names as they appear in the exported file.
+// Reference: https://www.aseprite.org/docs/cli/#sheet-json
+// Aseprite exports either a Hash variant (frames is a dict keyed by name) or
+// an Array variant (frames is an array with a filename field per entry).
+export {};
+//# sourceMappingURL=asepriteSchema.js.map

package/dist/asepriteSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteSchema.js","sourceRoot":"","sources":["../src/asepriteSchema.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,2DAA2D;AAC3D,6EAA6E;AAC7E,yEAAyE"}

package/dist/asepriteSerialize.d.ts

@@ -0,0 +1,14 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { AsepriteDocument } from './asepriteSchema';
+export interface AsepriteSerializeOptions {
+    /** Override the output format variant. Defaults to the variant of `existing`, or `'hash'`. */
+    variant?: 'array' | 'hash';
+}
+/** Serialise a SpritesheetData to an Aseprite JSON string.
+ *
+ *  Pass the `document` returned by `parseAsepriteSpritesheetDocument` to preserve any fields that
+ *  don't round-trip through the data (app name, layer list, tag colours).
+ *  Per-frame durations in `animation.frameDurations` are written back to each
+ *  frame's `duration` field so they survive a reload. */
+export declare function serializeAsepriteSpritesheet(data: Readonly<SpritesheetData>, existing?: Partial<AsepriteDocument>, options?: AsepriteSerializeOptions): string;
+//# sourceMappingURL=asepriteSerialize.d.ts.map

package/dist/asepriteSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteSerialize.d.ts","sourceRoot":"","sources":["../src/asepriteSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAIV,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B;AAoFD;;;;;yDAKyD;AACzD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACpC,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAWR"}

package/dist/asepriteSerialize.js

@@ -0,0 +1,86 @@
+// ─── Internal helpers ────────────────────────────────────────────────────────
+function dataToMeta(data, existing) {
+    const tags = data.animations.map((anim, i) => {
+        const firstIdx = data.frames.findIndex((f) => f.name === anim.frameNames[0]);
+        const lastIdx = data.frames.findIndex((f) => f.name === anim.frameNames[anim.frameNames.length - 1]);
+        return {
+            direction: anim.direction,
+            from: firstIdx >= 0 ? firstIdx : 0,
+            name: anim.name,
+            to: lastIdx >= 0 ? lastIdx : 0,
+            ...(existing.frameTags?.[i]?.color !== undefined ? { color: existing.frameTags[i].color } : {}),
+        };
+    });
+    return {
+        app: existing.app ?? 'https://www.aseprite.org/',
+        format: existing.format ?? 'RGBA8888',
+        frameTags: tags,
+        image: data.imageFile || existing.image || '',
+        ...(existing.layers !== undefined ? { layers: existing.layers } : {}),
+        scale: data.scale !== 1 ? String(data.scale) : (existing.scale ?? '1'),
+        size: { h: data.imageHeight, w: data.imageWidth },
+        version: existing.version ?? '1.3',
+    };
+}
+function frameToEntry(frame, durationMs) {
+    const trimmed = frame.offsetX !== 0 ||
+        frame.offsetY !== 0 ||
+        frame.sourceWidth !== frame.width ||
+        frame.sourceHeight !== frame.height;
+    return {
+        duration: durationMs,
+        frame: { h: frame.height, w: frame.width, x: frame.x, y: frame.y },
+        rotated: frame.rotated,
+        sourceSize: { h: frame.sourceHeight, w: frame.sourceWidth },
+        spriteSourceSize: {
+            h: frame.height,
+            w: frame.width,
+            x: frame.offsetX,
+            y: frame.offsetY,
+        },
+        trimmed,
+    };
+}
+function resolveFrameDuration(data, frameName) {
+    for (const anim of data.animations) {
+        const idx = anim.frameNames.indexOf(frameName);
+        if (idx === -1)
+            continue;
+        if (anim.frameDurations !== null)
+            return anim.frameDurations[idx] ?? anim.frameDuration;
+        return anim.frameDuration;
+    }
+    return 100;
+}
+function dataToHashDocument(data, existing) {
+    const frames = {};
+    for (const frame of data.frames) {
+        frames[frame.name] = frameToEntry(frame, resolveFrameDuration(data, frame.name));
+    }
+    return { frames, meta: dataToMeta(data, existing.meta ?? {}) };
+}
+function dataToArrayDocument(data, existing) {
+    const frames = data.frames.map((frame) => ({
+        filename: frame.name,
+        ...frameToEntry(frame, resolveFrameDuration(data, frame.name)),
+    }));
+    return { frames, meta: dataToMeta(data, existing.meta ?? {}) };
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Serialise a SpritesheetData to an Aseprite JSON string.
+ *
+ *  Pass the `document` returned by `parseAsepriteSpritesheetDocument` to preserve any fields that
+ *  don't round-trip through the data (app name, layer list, tag colours).
+ *  Per-frame durations in `animation.frameDurations` are written back to each
+ *  frame's `duration` field so they survive a reload. */
+export function serializeAsepriteSpritesheet(data, existing, options) {
+    const existingIsArray = existing !== undefined && Array.isArray(existing.frames);
+    const variant = options?.variant ?? (existingIsArray ? 'array' : 'hash');
+    if (variant === 'array') {
+        const doc = dataToArrayDocument(data, existing ?? {});
+        return JSON.stringify(doc, null, 2);
+    }
+    const doc = dataToHashDocument(data, existing ?? {});
+    return JSON.stringify(doc, null, 2);
+}
+//# sourceMappingURL=asepriteSerialize.js.map

package/dist/asepriteSerialize.js.map

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

package/dist/cocosPlistParse.d.ts

@@ -0,0 +1,15 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { CocosPlistDocument } from './cocosPlistSchema';
+export interface CocosPlistParsed {
+    data: SpritesheetData;
+    document: CocosPlistDocument;
+}
+/** Parse a Cocos Creator / Cocos2d-x plist XML atlas string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseCocosPlistSpritesheetDocument` instead when you need round-trip serialisation. */
+export declare function parseCocosPlistSpritesheet(xml: string): SpritesheetData;
+/** Parse a Cocos Creator / Cocos2d-x plist XML atlas string and preserve the full document
+ *  for round-trip serialisation via `serializeCocosPlistSpritesheet`. */
+export declare function parseCocosPlistSpritesheetDocument(xml: string): CocosPlistParsed;
+//# sourceMappingURL=cocosPlistParse.d.ts.map

package/dist/cocosPlistParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cocosPlistParse.d.ts","sourceRoot":"","sources":["../src/cocosPlistParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAKnF,OAAO,KAAK,EAAE,kBAAkB,EAAuC,MAAM,oBAAoB,CAAC;AAElG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAsKD;;;+FAG+F;AAC/F,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAEvE;AAED;yEACyE;AACzE,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAGhF"}

package/dist/cocosPlistParse.js

@@ -0,0 +1,157 @@
+import { createSpritesheetData, createSpritesheetFrameData } from '@flighthq/spritesheet';
+import { parseXmlDocument } from '@flighthq/xml';
+// ─── plist structural helpers ─────────────────────────────────────────────────
+/** Parse a Cocos plist size/offset string of the form "{w,h}" or "{x,y}". */
+function parsePlistPair(s) {
+    const m = s.match(/{?\s*([-\d.]+)\s*,\s*([-\d.]+)\s*}?/);
+    return [parseFloat(m?.[1] ?? '0'), parseFloat(m?.[2] ?? '0')];
+}
+/** Parse a Cocos plist rect string of the form "{{x,y},{w,h}}". */
+function parsePlistRect(s) {
+    const m = s.match(/\{\s*\{\s*([-\d.]+)\s*,\s*([-\d.]+)\s*\}\s*,\s*\{\s*([-\d.]+)\s*,\s*([-\d.]+)\s*\}\s*\}/);
+    return {
+        h: parseFloat(m?.[4] ?? '0'),
+        w: parseFloat(m?.[3] ?? '0'),
+        x: parseFloat(m?.[1] ?? '0'),
+        y: parseFloat(m?.[2] ?? '0'),
+    };
+}
+/** Walk a plist <dict> element and return a key→value map, values still as XmlElement. */
+function dictToMap(el) {
+    const map = new Map();
+    const children = el.children;
+    for (let i = 0; i < children.length; i += 2) {
+        const keyEl = children[i];
+        const valEl = children[i + 1];
+        if (keyEl?.name === 'key' && valEl) {
+            map.set(keyEl.text, valEl);
+        }
+    }
+    return map;
+}
+function getTextValue(el) {
+    return el?.text ?? '';
+}
+function getBoolValue(el) {
+    return el?.name === 'true';
+}
+function getIntValue(el) {
+    return parseInt(el?.text ?? '0', 10);
+}
+// ─── Internal parser ─────────────────────────────────────────────────────────
+function parseCocosPlistXml(xml) {
+    const root = parseXmlDocument(xml);
+    // Locate the root <dict> (may be under <plist>)
+    let rootDict = null;
+    if (root?.name === 'plist') {
+        rootDict = root.children.find((c) => c.name === 'dict') ?? null;
+    }
+    else if (root?.name === 'dict') {
+        rootDict = root;
+    }
+    if (!rootDict)
+        return { frames: {}, metadata: { format: 0, size: '{0,0}', textureFileName: '' } };
+    const rootMap = dictToMap(rootDict);
+    // Parse metadata
+    const metaEl = rootMap.get('metadata');
+    let metadata = { format: 0, size: '{0,0}', textureFileName: '' };
+    if (metaEl?.name === 'dict') {
+        const metaMap = dictToMap(metaEl);
+        metadata = {
+            format: getIntValue(metaMap.get('format')),
+            size: getTextValue(metaMap.get('size')),
+            textureFileName: getTextValue(metaMap.get('textureFileName')) || getTextValue(metaMap.get('realTextureFileName')),
+        };
+    }
+    // Parse frames
+    const framesEl = rootMap.get('frames');
+    const frames = {};
+    if (framesEl?.name === 'dict') {
+        const framesMap = dictToMap(framesEl);
+        for (const [frameName, frameEl] of framesMap) {
+            if (frameEl.name !== 'dict')
+                continue;
+            const fm = dictToMap(frameEl);
+            // Detect format version from available keys
+            const hasSpriteFields = fm.has('spriteOffset');
+            const hasFrame = fm.has('frame') || fm.has('textureRect');
+            if (!hasFrame && !hasSpriteFields)
+                continue;
+            // Support both old-style (frame) and new-style (textureRect) keys
+            const rectStr = getTextValue(fm.get('frame') ?? fm.get('textureRect'));
+            const rotated = getBoolValue(fm.get('textureRotated') ?? fm.get('rotated'));
+            const offsetStr = getTextValue(fm.get('spriteOffset') ?? fm.get('offset'));
+            const sourceSizeStr = getTextValue(fm.get('spriteSourceSize') ?? fm.get('sourceSize'));
+            const sizeStr = getTextValue(fm.get('spriteSize') ?? fm.get('size'));
+            const trimmed = getBoolValue(fm.get('spriteTrimmed') ?? fm.get('trimmed'));
+            const aliasEl = fm.get('aliases');
+            const aliases = [];
+            if (aliasEl?.name === 'array') {
+                for (const child of aliasEl.children) {
+                    if (child.name === 'string')
+                        aliases.push(child.text);
+                }
+            }
+            frames[frameName] = {
+                aliases: aliases.length > 0 ? aliases : undefined,
+                frame: rectStr,
+                spriteOffset: offsetStr,
+                spriteSize: sizeStr,
+                spriteSourceSize: sourceSizeStr,
+                spriteTrimmed: trimmed,
+                textureRotated: rotated,
+            };
+        }
+    }
+    return { frames, metadata };
+}
+// ─── Internal conversion ─────────────────────────────────────────────────────
+function plistFrameToData(name, pf) {
+    const rect = parsePlistRect(pf.frame);
+    const [offsetX, offsetY] = parsePlistPair(pf.spriteOffset);
+    const [sourceWidth, sourceHeight] = parsePlistPair(pf.spriteSourceSize);
+    // Rotated frames in plist have swapped w/h in the atlas rect
+    const atlasWidth = pf.textureRotated ? rect.h : rect.w;
+    const atlasHeight = pf.textureRotated ? rect.w : rect.h;
+    return createSpritesheetFrameData({
+        height: atlasHeight,
+        name,
+        offsetX,
+        offsetY,
+        pivotX: null,
+        pivotY: null,
+        rotated: pf.textureRotated,
+        sourceHeight: sourceHeight > 0 ? sourceHeight : atlasHeight,
+        sourceWidth: sourceWidth > 0 ? sourceWidth : atlasWidth,
+        width: atlasWidth,
+        x: rect.x,
+        y: rect.y,
+    });
+}
+function documentToData(doc) {
+    const frames = Object.entries(doc.frames).map(([name, pf]) => plistFrameToData(name, pf));
+    const [imageWidth, imageHeight] = parsePlistPair(doc.metadata.size);
+    return createSpritesheetData({
+        animations: [],
+        frames,
+        imageFile: doc.metadata.textureFileName,
+        imageHeight,
+        imageWidth,
+        scale: 1,
+    });
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Parse a Cocos Creator / Cocos2d-x plist XML atlas string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseCocosPlistSpritesheetDocument` instead when you need round-trip serialisation. */
+export function parseCocosPlistSpritesheet(xml) {
+    return documentToData(parseCocosPlistXml(xml));
+}
+/** Parse a Cocos Creator / Cocos2d-x plist XML atlas string and preserve the full document
+ *  for round-trip serialisation via `serializeCocosPlistSpritesheet`. */
+export function parseCocosPlistSpritesheetDocument(xml) {
+    const document = parseCocosPlistXml(xml);
+    return { data: documentToData(document), document };
+}
+//# sourceMappingURL=cocosPlistParse.js.map

package/dist/cocosPlistParse.js.map

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

package/dist/cocosPlistSchema.d.ts

@@ -0,0 +1,31 @@
+export interface CocosPlistFrame {
+    /** Rect of this frame in the atlas, as a plist string "{{x,y},{w,h}}". */
+    frame: string;
+    /** Pixel offset of the trimmed sprite within its original bounds, as a plist string "{x,y}". */
+    spriteOffset: string;
+    /** Trimmed size of this frame in the atlas, as a plist string "{w,h}". */
+    spriteSize: string;
+    /** Original (untrimmed) size of the source sprite, as a plist string "{w,h}". */
+    spriteSourceSize: string;
+    /** Whether the sprite was trimmed to remove transparent borders. */
+    spriteTrimmed: boolean;
+    /** Whether the frame is rotated 90 degrees clockwise in the atlas. */
+    textureRotated: boolean;
+    /** Optional aliases (alternate names) for this frame. */
+    aliases?: string[];
+}
+export interface CocosPlistMetadata {
+    /** Plist format version (2 = old-style, 3 = new-style sprite-prefixed keys). */
+    format: number;
+    /** Size of the atlas texture, as a plist string "{w,h}". */
+    size: string;
+    /** File name of the atlas texture image. */
+    textureFileName: string;
+}
+export interface CocosPlistDocument {
+    /** Map of frame name to frame descriptor. */
+    frames: Record<string, CocosPlistFrame>;
+    /** Atlas metadata. */
+    metadata: CocosPlistMetadata;
+}
+//# sourceMappingURL=cocosPlistSchema.d.ts.map

package/dist/cocosPlistSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cocosPlistSchema.d.ts","sourceRoot":"","sources":["../src/cocosPlistSchema.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,sBAAsB;IACtB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B"}

package/dist/cocosPlistSchema.js

@@ -0,0 +1,6 @@
+// Cocos Creator / Cocos2d-x plist atlas schema — field names as they appear in the plist file.
+// Supports both old-style keys (frame, offset, sourceSize, size, rotated, trimmed) and
+// new-style sprite-prefixed keys (textureRect, spriteOffset, spriteSourceSize, spriteSize,
+// textureRotated, spriteTrimmed). The parser normalises both variants into this shape.
+export {};
+//# sourceMappingURL=cocosPlistSchema.js.map

package/dist/cocosPlistSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cocosPlistSchema.js","sourceRoot":"","sources":["../src/cocosPlistSchema.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,uFAAuF;AACvF,2FAA2F;AAC3F,uFAAuF"}

package/dist/cocosPlistSerialize.d.ts

@@ -0,0 +1,8 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { CocosPlistDocument } from './cocosPlistSchema';
+/** 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 declare function serializeCocosPlistSpritesheet(data: Readonly<SpritesheetData>, existing?: Partial<CocosPlistDocument>): string;
+//# sourceMappingURL=cocosPlistSerialize.d.ts.map

package/dist/cocosPlistSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cocosPlistSerialize.d.ts","sourceRoot":"","sources":["../src/cocosPlistSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,oBAAoB,CAAC;AAE9E;;;gFAGgF;AAChF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,MAAM,CAcR"}