@flighthq/spritesheet-formats 0.1.0

package/dist/starlingParse.js

@@ -0,0 +1,138 @@
+import { createSpritesheetAnimationData, createSpritesheetData, createSpritesheetFrameData, } from '@flighthq/spritesheet';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { parseTextureAtlasStarlingXml } from '@flighthq/textureatlas-formats';
+// ─── Minimal XML attribute parser ────────────────────────────────────────────
+function parseAttrs(attrs) {
+    const result = {};
+    const RE = /(\w+)\s*=\s*"([^"]*)"/g;
+    let m;
+    while ((m = RE.exec(attrs)) !== null) {
+        result[m[1]] = m[2];
+    }
+    return result;
+}
+function parseStarlingXml(xml) {
+    const atlasRE = /<TextureAtlas([^>]*)>/;
+    const atlasMatch = atlasRE.exec(xml);
+    const atlasAttrs = atlasMatch ? parseAttrs(atlasMatch[1]) : {};
+    const imagePath = atlasAttrs['imagePath'] ?? '';
+    const subTextures = [];
+    const stRE = /<SubTexture([^/]*)\/?>/g;
+    let m;
+    while ((m = stRE.exec(xml)) !== null) {
+        const a = parseAttrs(m[1]);
+        if (!a['name'])
+            continue;
+        const st = {
+            height: parseFloat(a['height'] ?? '0'),
+            name: a['name'],
+            width: parseFloat(a['width'] ?? '0'),
+            x: parseFloat(a['x'] ?? '0'),
+            y: parseFloat(a['y'] ?? '0'),
+        };
+        if (a['frameX'] !== undefined)
+            st.frameX = parseFloat(a['frameX']);
+        if (a['frameY'] !== undefined)
+            st.frameY = parseFloat(a['frameY']);
+        if (a['frameWidth'] !== undefined)
+            st.frameWidth = parseFloat(a['frameWidth']);
+        if (a['frameHeight'] !== undefined)
+            st.frameHeight = parseFloat(a['frameHeight']);
+        if (a['pivotX'] !== undefined)
+            st.pivotX = parseFloat(a['pivotX']);
+        if (a['pivotY'] !== undefined)
+            st.pivotY = parseFloat(a['pivotY']);
+        if (a['rotated'] !== undefined)
+            st.rotated = a['rotated'] === 'true';
+        subTextures.push(st);
+    }
+    return { imagePath, subTextures };
+}
+// ─── Internal helpers ────────────────────────────────────────────────────────
+// Maps an atlas region (geometry owned by @flighthq/textureatlas-formats — incl. Starling's negated
+// frameX/Y offsets and trim handling) to a spritesheet frame. Starling pivots are authored in source
+// pixels; the spritesheet layer normalizes them to the 0..1 range, so re-divide the atlas's raw pivot
+// by the source size here.
+function frameFromRegion(region) {
+    const sourceWidth = region.originalWidth ?? region.width;
+    const sourceHeight = region.originalHeight ?? region.height;
+    return createSpritesheetFrameData({
+        height: region.height,
+        name: region.name ?? '',
+        offsetX: region.sourceX,
+        offsetY: region.sourceY,
+        pivotX: region.pivotX !== null && sourceWidth > 0 ? region.pivotX / sourceWidth : null,
+        pivotY: region.pivotY !== null && sourceHeight > 0 ? region.pivotY / sourceHeight : null,
+        rotated: region.rotated,
+        sourceHeight,
+        sourceWidth,
+        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;
+}
+// Region geometry is delegated to @flighthq/textureatlas-formats; this layer keeps the imagePath and
+// the inferred `baseName_NNN` animations. `regions` come from the atlas parser over the same XML.
+function documentToData(doc, regions, frameDuration) {
+    const frames = regions.map(frameFromRegion);
+    const frameNames = frames.map((f) => f.name);
+    const animations = inferAnimations(frameNames, frameDuration);
+    return createSpritesheetData({
+        animations,
+        frames,
+        imageFile: doc.imagePath,
+        imageHeight: 0,
+        imageWidth: 0,
+        scale: 1,
+    });
+}
+function regionsFromXml(xml) {
+    return parseTextureAtlasStarlingXml(xml, createTextureAtlas()).regions;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** 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 function parseStarlingSpritesheet(xml, options) {
+    return documentToData(parseStarlingXml(xml), regionsFromXml(xml), options?.frameDuration ?? 100);
+}
+/** Parse a Starling / Sparrow XML atlas string and preserve the full document
+ *  for round-trip serialisation via `serializeStarlingSpritesheet`. */
+export function parseStarlingSpritesheetDocument(xml, options) {
+    const document = parseStarlingXml(xml);
+    return { data: documentToData(document, regionsFromXml(xml), options?.frameDuration ?? 100), document };
+}
+//# sourceMappingURL=starlingParse.js.map

package/dist/starlingParse.js.map

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

package/dist/starlingSchema.d.ts

@@ -0,0 +1,32 @@
+export interface StarlingSubTexture {
+    /** Original untrimmed frame height (present when frame is trimmed). */
+    frameHeight?: number;
+    /** Original untrimmed frame width (present when frame is trimmed). */
+    frameWidth?: number;
+    /** Left edge of the visible area within the original frame; typically negative. */
+    frameX?: number;
+    /** Top edge of the visible area within the original frame; typically negative. */
+    frameY?: number;
+    /** Height of the atlas rectangle. */
+    height: number;
+    /** Frame identifier used to look up the sub-texture at runtime. */
+    name: string;
+    /** Absolute X pivot position in the original frame coordinate space. */
+    pivotX?: number;
+    /** Absolute Y pivot position in the original frame coordinate space. */
+    pivotY?: number;
+    /** Whether the frame is rotated 90° CW inside the atlas. */
+    rotated?: boolean;
+    /** Width of the atlas rectangle. */
+    width: number;
+    /** Atlas X offset of the rectangle. */
+    x: number;
+    /** Atlas Y offset of the rectangle. */
+    y: number;
+}
+export interface StarlingDocument {
+    /** Relative path to the atlas image file, value of the `imagePath` attribute. */
+    imagePath: string;
+    subTextures: StarlingSubTexture[];
+}
+//# sourceMappingURL=starlingSchema.d.ts.map

package/dist/starlingSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingSchema.d.ts","sourceRoot":"","sources":["../src/starlingSchema.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC"}

package/dist/starlingSchema.js

@@ -0,0 +1,6 @@
+// Starling / Sparrow spritesheet XML schema — field names as they appear in the file.
+// Reference: https://doc.starling-framework.org/current/starling/textures/TextureAtlas.html
+// This is the same format used by OpenFL's AssetType.IMAGE texture atlas support and
+// is commonly exported by Texture Packer (Starling / Sparrow XML preset).
+export {};
+//# sourceMappingURL=starlingSchema.js.map

package/dist/starlingSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingSchema.js","sourceRoot":"","sources":["../src/starlingSchema.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,4FAA4F;AAC5F,qFAAqF;AACrF,0EAA0E"}

package/dist/starlingSerialize.d.ts

@@ -0,0 +1,8 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { StarlingDocument } from './starlingSchema';
+/** Serialise a SpritesheetData to a Starling / Sparrow XML atlas string.
+ *
+ *  Pass the `document` returned by `parseStarlingSpritesheetDocument` to preserve any fields that
+ *  don't round-trip through the data (pivot values stored in the document). */
+export declare function serializeStarlingSpritesheet(data: Readonly<SpritesheetData>, existing?: Partial<StarlingDocument>): string;
+//# sourceMappingURL=starlingSerialize.d.ts.map

package/dist/starlingSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingSerialize.d.ts","sourceRoot":"","sources":["../src/starlingSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAsD7E;;;+EAG+E;AAC/E,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACnC,MAAM,CAMR"}

package/dist/starlingSerialize.js

@@ -0,0 +1,67 @@
+// ─── Internal helpers ────────────────────────────────────────────────────────
+function frameToSubTexture(frame) {
+    const st = {
+        height: frame.height,
+        name: frame.name,
+        width: frame.width,
+        x: frame.x,
+        y: frame.y,
+    };
+    if (frame.offsetX !== 0)
+        st.frameX = -frame.offsetX;
+    if (frame.offsetY !== 0)
+        st.frameY = -frame.offsetY;
+    if (frame.sourceWidth !== frame.width)
+        st.frameWidth = frame.sourceWidth;
+    if (frame.sourceHeight !== frame.height)
+        st.frameHeight = frame.sourceHeight;
+    if (frame.pivotX !== null && frame.sourceWidth > 0) {
+        st.pivotX = frame.pivotX * frame.sourceWidth;
+    }
+    if (frame.pivotY !== null && frame.sourceHeight > 0) {
+        st.pivotY = frame.pivotY * frame.sourceHeight;
+    }
+    if (frame.rotated)
+        st.rotated = true;
+    return st;
+}
+function subTextureToAttr(st) {
+    const parts = [`name="${st.name}"`, `x="${st.x}"`, `y="${st.y}"`];
+    parts.push(`width="${st.width}"`, `height="${st.height}"`);
+    if (st.frameX !== undefined)
+        parts.push(`frameX="${st.frameX}"`);
+    if (st.frameY !== undefined)
+        parts.push(`frameY="${st.frameY}"`);
+    if (st.frameWidth !== undefined)
+        parts.push(`frameWidth="${st.frameWidth}"`);
+    if (st.frameHeight !== undefined)
+        parts.push(`frameHeight="${st.frameHeight}"`);
+    if (st.pivotX !== undefined)
+        parts.push(`pivotX="${st.pivotX}"`);
+    if (st.pivotY !== undefined)
+        parts.push(`pivotY="${st.pivotY}"`);
+    if (st.rotated)
+        parts.push(`rotated="true"`);
+    return parts.join(' ');
+}
+function documentToXml(doc) {
+    const lines = ['<?xml version="1.0" encoding="UTF-8"?>', `<TextureAtlas imagePath="${doc.imagePath}">`];
+    for (const st of doc.subTextures) {
+        lines.push(`\t<SubTexture ${subTextureToAttr(st)}/>`);
+    }
+    lines.push('</TextureAtlas>');
+    return lines.join('\n');
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Serialise a SpritesheetData to a Starling / Sparrow XML atlas string.
+ *
+ *  Pass the `document` returned by `parseStarlingSpritesheetDocument` to preserve any fields that
+ *  don't round-trip through the data (pivot values stored in the document). */
+export function serializeStarlingSpritesheet(data, existing) {
+    const doc = {
+        imagePath: data.imageFile || existing?.imagePath || '',
+        subTextures: data.frames.map(frameToSubTexture),
+    };
+    return documentToXml(doc);
+}
+//# sourceMappingURL=starlingSerialize.js.map

package/dist/starlingSerialize.js.map

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

package/dist/texturePackerParse.d.ts

@@ -0,0 +1,15 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { TexturePackerDocument } from './texturePackerSchema';
+export interface TexturePackerParsed {
+    data: SpritesheetData;
+    document: TexturePackerDocument;
+}
+/** Parse a Texture Packer JSON string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseTexturePackerSpritesheetDocument` instead when you need round-trip serialisation. */
+export declare function parseTexturePackerSpritesheet(json: string): SpritesheetData;
+/** Parse a Texture Packer JSON string and preserve the full document for
+ *  round-trip serialisation via `serializeTexturePackerSpritesheet`. */
+export declare function parseTexturePackerSpritesheetDocument(json: string): TexturePackerParsed;
+//# sourceMappingURL=texturePackerParse.d.ts.map

package/dist/texturePackerParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturePackerParse.d.ts","sourceRoot":"","sources":["../src/texturePackerParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAU7G,OAAO,KAAK,EAAE,qBAAqB,EAA4C,MAAM,uBAAuB,CAAC;AAE7G,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAgED;;;kGAGkG;AAClG,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAE3E;AAED;wEACwE;AACxE,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAGvF"}

package/dist/texturePackerParse.js

@@ -0,0 +1,70 @@
+import { createSpritesheetAnimationData, createSpritesheetData, createSpritesheetFrameData, } from '@flighthq/spritesheet';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { parseTextureAtlasPackerDocument } from '@flighthq/textureatlas-formats';
+// ─── Internal helpers ────────────────────────────────────────────────────────
+// Maps an atlas region (geometry owned by @flighthq/textureatlas-formats — the single source of truth
+// for the region rect, rotation, and trim handling) to a spritesheet frame. This package adds only the
+// animation/frame metadata on top. The untrimmed source size falls back to the region rect, because the
+// atlas parser leaves originalW/H null when a frame is not trimmed (where the source equals the 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,
+    });
+}
+function animationsFromFrameTags(tags, frameNames) {
+    return tags.map((tag) => createSpritesheetAnimationData({
+        direction: tag.direction ?? 'forward',
+        frameDuration: 100,
+        frameNames: frameNames.slice(tag.from, tag.to + 1),
+        loop: true,
+        name: tag.name,
+    }));
+}
+function metaScale(meta) {
+    if (typeof meta.scale === 'string')
+        return parseFloat(meta.scale) || 1;
+    return meta.scale;
+}
+function documentToData(doc) {
+    // Delegate region geometry to the atlas-formats parser (the TexturePacker document shapes are shared),
+    // then layer the spritesheet frame/animation metadata on top — no independent re-parse of the frames.
+    const regions = parseTextureAtlasPackerDocument(doc, createTextureAtlas()).regions;
+    const frames = regions.map(frameFromRegion);
+    const frameNames = regions.map((region) => region.name ?? '');
+    const { meta } = doc;
+    const animations = meta.frameTags ? animationsFromFrameTags(meta.frameTags, frameNames) : [];
+    return createSpritesheetData({
+        animations,
+        frames,
+        imageFile: meta.image,
+        imageHeight: meta.size.h,
+        imageWidth: meta.size.w,
+        scale: metaScale(meta),
+    });
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Parse a Texture Packer JSON string directly to a SpritesheetData.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseTexturePackerSpritesheetDocument` instead when you need round-trip serialisation. */
+export function parseTexturePackerSpritesheet(json) {
+    return documentToData(JSON.parse(json));
+}
+/** Parse a Texture Packer JSON string and preserve the full document for
+ *  round-trip serialisation via `serializeTexturePackerSpritesheet`. */
+export function parseTexturePackerSpritesheetDocument(json) {
+    const document = JSON.parse(json);
+    return { data: documentToData(document), document };
+}
+//# sourceMappingURL=texturePackerParse.js.map

package/dist/texturePackerParse.js.map

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

package/dist/texturePackerSchema.d.ts

@@ -0,0 +1,52 @@
+export interface TexturePackerRect {
+    h: number;
+    w: number;
+    x: number;
+    y: number;
+}
+export interface TexturePackerSize {
+    h: number;
+    w: number;
+}
+export interface TexturePackerPivot {
+    x: number;
+    y: number;
+}
+export interface TexturePackerFrameTag {
+    direction: 'forward' | 'pingpong' | 'pingpong_reverse' | 'reverse';
+    from: number;
+    name: string;
+    to: number;
+}
+export interface TexturePackerHashFrame {
+    frame: TexturePackerRect;
+    pivot?: TexturePackerPivot;
+    rotated: boolean;
+    sourceSize: TexturePackerSize;
+    spriteSourceSize: TexturePackerRect;
+    trimmed: boolean;
+}
+export interface TexturePackerArrayFrame extends TexturePackerHashFrame {
+    filename: string;
+}
+export interface TexturePackerMeta {
+    app: string;
+    format: string;
+    frameTags?: TexturePackerFrameTag[];
+    image: string;
+    scale: number | string;
+    size: TexturePackerSize;
+    version: string;
+}
+/** Hash-keyed variant: `frames` is a plain object whose keys are frame names. */
+export interface TexturePackerHashDocument {
+    frames: Record<string, TexturePackerHashFrame>;
+    meta: TexturePackerMeta;
+}
+/** Array variant: `frames` is an array and each entry carries a `filename` field. */
+export interface TexturePackerArrayDocument {
+    frames: TexturePackerArrayFrame[];
+    meta: TexturePackerMeta;
+}
+export type TexturePackerDocument = TexturePackerArrayDocument | TexturePackerHashDocument;
+//# sourceMappingURL=texturePackerSchema.d.ts.map

package/dist/texturePackerSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturePackerSchema.d.ts","sourceRoot":"","sources":["../src/texturePackerSchema.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC/C,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,qFAAqF;AACrF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,GAAG,yBAAyB,CAAC"}

package/dist/texturePackerSchema.js

@@ -0,0 +1,5 @@
+// Texture Packer JSON schema — field names as they appear in the exported file.
+// Reference: https://www.codeandweb.com/texturepacker/documentation/texture-settings
+// Supports both the Hash (dict-keyed frames) and Array (array of frames with filename) variants.
+export {};
+//# sourceMappingURL=texturePackerSchema.js.map

package/dist/texturePackerSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturePackerSchema.js","sourceRoot":"","sources":["../src/texturePackerSchema.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qFAAqF;AACrF,iGAAiG"}

package/dist/texturePackerSerialize.d.ts

@@ -0,0 +1,14 @@
+import type { SpritesheetData } from '@flighthq/spritesheet';
+import type { TexturePackerDocument } from './texturePackerSchema';
+export interface TexturePackerSerializeOptions {
+    /** Override the output format variant. Defaults to the variant of `existing`, or `'hash'`. */
+    variant?: 'array' | 'hash';
+}
+/** Serialise a SpritesheetData to a Texture Packer JSON string.
+ *
+ *  Pass the `document` returned by `parseTexturePackerSpritesheetDocument` to preserve any fields
+ *  that don't round-trip through the data (app name, format string, scale).
+ *  The output variant (hash vs array) is inferred from the existing document or
+ *  overridden via `options.variant`. */
+export declare function serializeTexturePackerSpritesheet(data: Readonly<SpritesheetData>, existing?: Partial<TexturePackerDocument>, options?: TexturePackerSerializeOptions): string;
+//# sourceMappingURL=texturePackerSerialize.d.ts.map

package/dist/texturePackerSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texturePackerSerialize.d.ts","sourceRoot":"","sources":["../src/texturePackerSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAGV,qBAAqB,EAItB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,6BAA6B;IAC5C,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B;AAwED;;;;;wCAKwC;AACxC,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,EACzC,OAAO,CAAC,EAAE,6BAA6B,GACtC,MAAM,CAWR"}

package/dist/texturePackerSerialize.js

@@ -0,0 +1,74 @@
+// ─── Internal helpers ────────────────────────────────────────────────────────
+function dataToMeta(data, existing) {
+    return {
+        app: existing.app ?? 'https://www.codeandweb.com/texturepacker',
+        format: existing.format ?? 'RGBA8888',
+        frameTags: data.animations.length
+            ? data.animations.map((anim) => {
+                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,
+                };
+            })
+            : undefined,
+        image: data.imageFile || existing.image || '',
+        scale: data.scale !== 1 ? data.scale : (existing.scale ?? 1),
+        size: { h: data.imageHeight, w: data.imageWidth },
+        version: existing.version ?? '1.0',
+    };
+}
+function frameToEntry(frame) {
+    const trimmed = frame.offsetX !== 0 ||
+        frame.offsetY !== 0 ||
+        frame.sourceWidth !== frame.width ||
+        frame.sourceHeight !== frame.height;
+    return {
+        frame: { h: frame.height, w: frame.width, x: frame.x, y: frame.y },
+        ...(frame.pivotX !== null && frame.pivotY !== null ? { pivot: { x: frame.pivotX, y: frame.pivotY } } : {}),
+        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 dataToHashDocument(data, existing) {
+    const frames = {};
+    for (const frame of data.frames) {
+        frames[frame.name] = frameToEntry(frame);
+    }
+    return { frames, meta: dataToMeta(data, existing.meta ?? {}) };
+}
+function dataToArrayDocument(data, existing) {
+    const frames = data.frames.map((frame) => ({
+        filename: frame.name,
+        ...frameToEntry(frame),
+    }));
+    return { frames, meta: dataToMeta(data, existing.meta ?? {}) };
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Serialise a SpritesheetData to a Texture Packer JSON string.
+ *
+ *  Pass the `document` returned by `parseTexturePackerSpritesheetDocument` to preserve any fields
+ *  that don't round-trip through the data (app name, format string, scale).
+ *  The output variant (hash vs array) is inferred from the existing document or
+ *  overridden via `options.variant`. */
+export function serializeTexturePackerSpritesheet(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=texturePackerSerialize.js.map

package/dist/texturePackerSerialize.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@flighthq/spritesheet-formats",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/textureatlas": "0.1.0",
+    "@flighthq/textureatlas-formats": "0.1.0",
+    "@flighthq/spritesheet": "0.1.0",
+    "@flighthq/types": "0.1.0",
+    "@flighthq/xml": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Import/export spritesheet atlas configs from industry-standard formats (Texture Packer, Aseprite, Starling)",
+  "sideEffects": false
+}