@flighthq/particles-formats 0.1.0

package/dist/spineSerialize.js

@@ -0,0 +1,108 @@
+import { particleColorCurveToKeyframes, particleCurveToKeyframes } from '@flighthq/particles';
+const RAD2DEG = 180 / Math.PI;
+function rgbToHex(r, g, b) {
+    const byte = (v) => Math.round(Math.max(0, Math.min(1, v)) * 255)
+        .toString(16)
+        .padStart(2, '0');
+    return `${byte(r)}${byte(g)}${byte(b)}`;
+}
+function configToDocument(config, existing) {
+    const angleMid = Math.atan2(-config.directionY, config.directionX) * RAD2DEG;
+    const spreadDeg = config.spread * RAD2DEG;
+    return {
+        name: existing.name ?? '',
+        maxParticles: config.maxParticles,
+        continuous: config.loop,
+        duration: config.duration > 0 && !config.loop ? config.duration * 1000 : (existing.duration ?? -1),
+        emission: { low: config.spawnRate * 0.8, high: config.spawnRate * 1.2 },
+        life: { low: config.lifetimeMin * 1000, high: config.lifetimeMax * 1000 },
+        lifeOffset: existing.lifeOffset ?? { low: 0, high: 0 },
+        x: existing.x ?? { low: 0, high: 0 },
+        y: existing.y ?? { low: 0, high: 0 },
+        spawnShape: config.emitterShape === 'rect' ? 'ellipse' : config.emitterShape === 'circle' ? 'ellipse' : 'point',
+        spawnWidth: config.emitterShape === 'circle'
+            ? { low: config.emitterRadius * 2, high: config.emitterRadius * 2 }
+            : config.emitterShape === 'rect'
+                ? { low: config.emitterWidth, high: config.emitterWidth }
+                : { low: 0, high: 0 },
+        spawnHeight: config.emitterShape === 'circle'
+            ? { low: config.emitterRadius * 2, high: config.emitterRadius * 2 }
+            : config.emitterShape === 'rect'
+                ? { low: config.emitterHeight, high: config.emitterHeight }
+                : { low: 0, high: 0 },
+        velocity: { low: config.speedMin, high: config.speedMax },
+        angle: { low: angleMid - spreadDeg, high: angleMid + spreadDeg },
+        rotation: { low: config.rotationSpeedMin * RAD2DEG, high: config.rotationSpeedMax * RAD2DEG },
+        wind: { low: 0, high: 0 }, // gravityX not representable as wind range
+        gravity: { low: config.gravityY, high: config.gravityY },
+        scale: { low: config.scaleMin, high: config.scaleMax },
+        scaleEnd: {
+            low: config.scaleMin * config.scaleEnd,
+            high: config.scaleMax * config.scaleEnd,
+        },
+        // A baked color/alpha curve serializes back to a full multi-stop timeline;
+        // otherwise emit the 2-stop start→end timeline.
+        tint: config.colorCurve
+            ? particleColorCurveToKeyframes(config.colorCurve).map((k) => ({ time: k.time, color: rgbToHex(k.r, k.g, k.b) }))
+            : [
+                { time: 0, color: rgbToHex(config.colorStartR, config.colorStartG, config.colorStartB) },
+                { time: 1, color: rgbToHex(config.colorEndR, config.colorEndG, config.colorEndB) },
+            ],
+        alpha: config.alphaCurve
+            ? particleCurveToKeyframes(config.alphaCurve).map((k) => ({ time: k.time, alpha: k.value }))
+            : [
+                { time: 0, alpha: config.alphaStart },
+                { time: 1, alpha: config.alphaEnd },
+            ],
+        blendMode: configToSpineBlendMode(config.blendMode) ?? existing.blendMode ?? 'normal',
+        premultiplied: existing.premultiplied ?? false,
+        images: existing.images ?? [],
+    };
+}
+function configToSpineBlendMode(mode) {
+    if (mode === 'add')
+        return 'additive';
+    if (mode === 'multiply')
+        return 'multiply';
+    if (mode === 'screen')
+        return 'screen';
+    if (mode === 'normal')
+        return 'normal';
+    return null;
+}
+/** Serialise a ParticleEmitterConfig to a Spine particle effect JSON string.
+ *
+ *  Pass the `document` returned by `parseSpineParticle` to preserve fields
+ *  that don't round-trip through the config (name, image list, blend mode, etc.). */
+export function serializeSpineParticle(config, existing) {
+    const doc = configToDocument(config, existing ?? {});
+    return JSON.stringify(doc, null, 2);
+}
+/** Serialise a ParticleEmitterConfig to a Spine particle effect JSON string,
+ *  returning both the serialized text and any warnings for features the format
+ *  cannot represent.
+ *
+ *  Pass the `document` returned by `parseSpineParticleDocument` to preserve
+ *  fields that don't round-trip through the config. */
+export function serializeSpineParticleDocument(config, existing) {
+    const text = serializeSpineParticle(config, existing);
+    const warnings = collectSpineSerializeWarnings(config);
+    return { text, warnings };
+}
+function collectSpineSerializeWarnings(config) {
+    const warnings = [];
+    if (config.burstCount > 0) {
+        warnings.push('Emission bursts are not supported by the Spine particle format and were ignored');
+    }
+    if (config.colorEndVarianceR !== 0 || config.colorEndVarianceG !== 0 || config.colorEndVarianceB !== 0) {
+        warnings.push('colorEndVariance is not supported by the Spine format and was ignored');
+    }
+    if (config.colorStartVarianceR !== 0 || config.colorStartVarianceG !== 0 || config.colorStartVarianceB !== 0) {
+        warnings.push('colorStartVariance is not supported by the Spine format and was ignored');
+    }
+    if (config.velocityInheritance !== 0) {
+        warnings.push('velocityInheritance is not supported by the Spine format and was ignored');
+    }
+    return warnings;
+}
+//# sourceMappingURL=spineSerialize.js.map

package/dist/spineSerialize.js.map

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

package/dist/starlingPexParse.d.ts

@@ -0,0 +1,29 @@
+import type { ParticleEmitterConfig } from '@flighthq/types';
+import type { StarlingPexDocument } from './starlingPexSchema';
+export interface StarlingPexParseOptions {
+    /** Side length of the particle texture in pixels, used to normalise pixel sizes
+     *  to dimensionless scale multipliers. Defaults to 1 (no normalisation). */
+    textureSize?: number;
+}
+export interface StarlingPexParseResult {
+    config: ParticleEmitterConfig;
+    document: StarlingPexDocument;
+    /** Features present in the source that the common-subset importer cannot
+     *  represent and silently dropped — surface these in your asset pipeline. */
+    warnings: string[];
+}
+/** @deprecated Use `StarlingPexParseResult`. */
+export type StarlingPexParsed = StarlingPexParseResult;
+/** Parse a Starling / Sparrow PEX XML string directly to a ParticleEmitterConfig.
+ *
+ *  Handles both attribute-style (`<attribute name="X" value="Y"/>`) and
+ *  element-style (plist-like key/value pairs) PEX variants.
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseStarlingPexDocument` instead when you need round-trip serialisation.
+ *  Throws a clear, format-tagged error when the input is not XML. */
+export declare function parseStarlingPex(xml: string, options?: StarlingPexParseOptions): ParticleEmitterConfig;
+/** Parse a Starling / Sparrow PEX XML string and preserve the full document for
+ *  round-trip serialisation via `serializeStarlingPex`.
+ *  Throws a clear, format-tagged error when the input is not XML. */
+export declare function parseStarlingPexDocument(xml: string, options?: StarlingPexParseOptions): StarlingPexParseResult;
+//# sourceMappingURL=starlingPexParse.d.ts.map

package/dist/starlingPexParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingPexParse.d.ts","sourceRoot":"","sources":["../src/starlingPexParse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,uBAAuB;IACtC;gFAC4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;iFAC6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD;;;;;;qEAMqE;AACrE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,qBAAqB,CAOtG;AAED;;qEAEqE;AACrE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CAW/G"}

package/dist/starlingPexParse.js

@@ -0,0 +1,254 @@
+import { createParticleEmitterConfig } from '@flighthq/particles';
+/** Parse a Starling / Sparrow PEX XML string directly to a ParticleEmitterConfig.
+ *
+ *  Handles both attribute-style (`<attribute name="X" value="Y"/>`) and
+ *  element-style (plist-like key/value pairs) PEX variants.
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseStarlingPexDocument` instead when you need round-trip serialisation.
+ *  Throws a clear, format-tagged error when the input is not XML. */
+export function parseStarlingPex(xml, options) {
+    if (typeof xml !== 'string' || !xml.trim().startsWith('<')) {
+        throw new Error('Invalid Starling PEX: input must be an XML string beginning with <');
+    }
+    const d = parsePexXml(xml);
+    const doc = dictToDocument(d);
+    return documentToConfig(doc, options?.textureSize ?? 1);
+}
+/** Parse a Starling / Sparrow PEX XML string and preserve the full document for
+ *  round-trip serialisation via `serializeStarlingPex`.
+ *  Throws a clear, format-tagged error when the input is not XML. */
+export function parseStarlingPexDocument(xml, options) {
+    if (typeof xml !== 'string' || !xml.trim().startsWith('<')) {
+        throw new Error('Invalid Starling PEX: input must be an XML string beginning with <');
+    }
+    const d = parsePexXml(xml);
+    const doc = dictToDocument(d);
+    return {
+        config: documentToConfig(doc, options?.textureSize ?? 1),
+        document: doc,
+        warnings: collectStarlingPexWarnings(doc),
+    };
+}
+const DEG2RAD = Math.PI / 180;
+function collectStarlingPexWarnings(doc) {
+    const warnings = [];
+    if (doc.emitterType === 1) {
+        warnings.push('Radial (emitterType=1) emitter was approximated as a gravity emitter; radial motion is not simulated');
+    }
+    if (doc.radialAcceleration !== 0 || doc.radialAccelVariance !== 0) {
+        warnings.push('radialAcceleration is not supported and was ignored');
+    }
+    if (doc.tangentialAcceleration !== 0 || doc.tangentialAccelVariance !== 0) {
+        warnings.push('tangentialAcceleration is not supported and was ignored');
+    }
+    return warnings;
+}
+function dictToDocument(d) {
+    const WHITE = { red: 1, green: 1, blue: 1, alpha: 1 };
+    const CLEAR = { red: 1, green: 1, blue: 1, alpha: 0 };
+    const ZERO = { red: 0, green: 0, blue: 0, alpha: 0 };
+    return {
+        maxParticles: pNum(d, 'maxParticles', 200) | 0,
+        emitterType: (pNum(d, 'emitterType', 0) === 1 ? 1 : 0),
+        duration: pNum(d, 'duration', -1),
+        particleLifespan: pNum(d, 'particleLifespan', 1),
+        particleLifespanVariance: pNum(d, 'particleLifespanVariance', 0),
+        speed: pNum(d, 'speed', 100),
+        speedVariance: pNum(d, 'speedVariance', 0),
+        angle: pNum(d, 'angle', 90),
+        angleVariance: pNum(d, 'angleVariance', 0),
+        gravityx: pNum(d, 'gravityx', 0),
+        gravityy: pNum(d, 'gravityy', 0),
+        sourcePositionVariancex: pNum(d, 'sourcePositionVariancex', 0),
+        sourcePositionVariancey: pNum(d, 'sourcePositionVariancey', 0),
+        startParticleSize: pNum(d, 'startParticleSize', 32),
+        startParticleSizeVariance: pNum(d, 'startParticleSizeVariance', 0),
+        finishParticleSize: pNum(d, 'finishParticleSize', 16),
+        finishParticleSizeVariance: pNum(d, 'finishParticleSizeVariance', 0),
+        startColor: pColor(d, 'startColor', WHITE),
+        startColorVariance: pColor(d, 'startColorVariance', ZERO),
+        finishColor: pColor(d, 'finishColor', CLEAR),
+        finishColorVariance: pColor(d, 'finishColorVariance', ZERO),
+        rotationStart: pNum(d, 'rotationStart', 0),
+        rotationStartVariance: pNum(d, 'rotationStartVariance', 0),
+        rotationEnd: pNum(d, 'rotationEnd', 0),
+        rotationEndVariance: pNum(d, 'rotationEndVariance', 0),
+        maxRadius: pNum(d, 'maxRadius', 0),
+        maxRadiusVariance: pNum(d, 'maxRadiusVariance', 0),
+        minRadius: pNum(d, 'minRadius', 0),
+        minRadiusVariance: pNum(d, 'minRadiusVariance', 0),
+        rotatePerSecond: pNum(d, 'rotatePerSecond', 0),
+        rotatePerSecondVariance: pNum(d, 'rotatePerSecondVariance', 0),
+        radialAcceleration: pNum(d, 'radialAcceleration', 0),
+        radialAccelVariance: pNum(d, 'radialAccelVariance', 0),
+        tangentialAcceleration: pNum(d, 'tangentialAcceleration', 0),
+        tangentialAccelVariance: pNum(d, 'tangentialAccelVariance', 0),
+        blendFuncSource: pNum(d, 'blendFuncSource', 770),
+        blendFuncDestination: pNum(d, 'blendFuncDestination', 771),
+        textureFileName: pStr(d, 'textureFileName', ''),
+    };
+}
+function documentToConfig(doc, textureSize) {
+    const angleRad = doc.angle * DEG2RAD;
+    const lifespan = doc.particleLifespan;
+    const lifespanVar = doc.particleLifespanVariance;
+    const speed = doc.speed;
+    const speedVar = doc.speedVariance;
+    const vx = doc.sourcePositionVariancex;
+    const vy = doc.sourcePositionVariancey;
+    const emitterShape = vx === 0 && vy === 0 ? 'point' : vx === vy ? 'circle' : 'rect';
+    const startSize = doc.startParticleSize / textureSize;
+    const startVar = doc.startParticleSizeVariance / textureSize;
+    const finishSize = doc.finishParticleSize / textureSize;
+    const rotStart = doc.rotationStart;
+    const rotEnd = doc.rotationEnd;
+    const rotStartVar = doc.rotationStartVariance;
+    const rotEndVar = doc.rotationEndVariance;
+    const lifetimeMid = lifespan + lifespanVar * 0.5 || 1;
+    const rotSpeedMid = ((rotStart + rotEnd) * 0.5 * DEG2RAD) / lifetimeMid;
+    const rotSpeedVar = (Math.max(rotStartVar, rotEndVar) * DEG2RAD) / lifetimeMid;
+    const pdDuration = doc.duration;
+    return createParticleEmitterConfig({
+        maxParticles: doc.maxParticles,
+        loop: pdDuration <= 0,
+        duration: pdDuration > 0 ? pdDuration : 0,
+        lifetimeMin: Math.max(0, lifespan - lifespanVar),
+        lifetimeMax: lifespan + lifespanVar,
+        speedMin: Math.max(0, speed - speedVar),
+        speedMax: speed + speedVar,
+        directionX: Math.cos(angleRad),
+        directionY: -Math.sin(angleRad),
+        spread: doc.angleVariance * DEG2RAD,
+        gravityX: doc.gravityx,
+        gravityY: doc.gravityy,
+        emitterShape,
+        emitterRadius: emitterShape === 'circle' ? vx : 0,
+        emitterWidth: emitterShape === 'rect' ? vx * 2 : 0,
+        emitterHeight: emitterShape === 'rect' ? vy * 2 : 0,
+        scaleMin: Math.max(0, startSize - startVar),
+        scaleMax: startSize + startVar,
+        scaleEnd: startSize > 0 ? finishSize / startSize : 1,
+        colorStartR: doc.startColor.red,
+        colorStartG: doc.startColor.green,
+        colorStartB: doc.startColor.blue,
+        colorStartVarianceR: doc.startColorVariance.red,
+        colorStartVarianceG: doc.startColorVariance.green,
+        colorStartVarianceB: doc.startColorVariance.blue,
+        colorEndR: doc.finishColor.red,
+        colorEndG: doc.finishColor.green,
+        colorEndB: doc.finishColor.blue,
+        colorEndVarianceR: doc.finishColorVariance.red,
+        colorEndVarianceG: doc.finishColorVariance.green,
+        colorEndVarianceB: doc.finishColorVariance.blue,
+        alphaStart: doc.startColor.alpha,
+        alphaEnd: doc.finishColor.alpha,
+        rotationSpeedMin: rotSpeedMid - rotSpeedVar,
+        rotationSpeedMax: rotSpeedMid + rotSpeedVar,
+        blendMode: pexBlendMode(doc.blendFuncSource, doc.blendFuncDestination),
+    });
+}
+/** Minimal XML attribute extractor. Reads `name="..."` and `value="..."` from self-closing tags. */
+function extractAttr(tag, attrName) {
+    const re = new RegExp(`${attrName}\\s*=\\s*["']([^"']*)["']`);
+    const m = re.exec(tag);
+    return m ? m[1] : null;
+}
+function pColor(d, prefix, defColor) {
+    // Try dot-notation (from attribute-style) first, then direct keys.
+    const r = pNum(d, `${prefix}.red`, pNum(d, `${prefix}Red`, defColor.red));
+    const g = pNum(d, `${prefix}.green`, pNum(d, `${prefix}Green`, defColor.green));
+    const b = pNum(d, `${prefix}.blue`, pNum(d, `${prefix}Blue`, defColor.blue));
+    const a = pNum(d, `${prefix}.alpha`, pNum(d, `${prefix}Alpha`, defColor.alpha));
+    return { red: r, green: g, blue: b, alpha: a };
+}
+function pexBlendMode(src, dst) {
+    if ((src === 770 || src === 1) && dst === 1)
+        return 'add';
+    if (src === 770 && dst === 771)
+        return 'normal';
+    if (src === 1 && dst === 771)
+        return 'normal';
+    return null;
+}
+function pNum(d, key, def = 0) {
+    const v = d[key];
+    if (v === undefined)
+        return def;
+    const n = parseFloat(v);
+    return Number.isFinite(n) ? n : def;
+}
+/** Parse the PEX XML into a flat key/value dict supporting both attribute-style and element-style. */
+function parsePexXml(xml) {
+    const dict = {};
+    // Pass 1: attribute-style <attribute name="X" value="Y"/>
+    const ATTR_RE = /<attribute\b([^>]*)\/>/gi;
+    let m;
+    while ((m = ATTR_RE.exec(xml)) !== null) {
+        const tag = m[1];
+        const name = extractAttr(tag, 'name');
+        const value = extractAttr(tag, 'value');
+        if (name !== null && value !== null)
+            dict[name] = value;
+    }
+    // Pass 2: color attribute-style <attribute name="X" red="R" green="G" blue="B" alpha="A"/>
+    const COL_RE = /<attribute\b([^>]*)\/>/gi;
+    while ((m = COL_RE.exec(xml)) !== null) {
+        const tag = m[1];
+        const name = extractAttr(tag, 'name');
+        if (name === null)
+            continue;
+        const red = extractAttr(tag, 'red');
+        const green = extractAttr(tag, 'green');
+        const blue = extractAttr(tag, 'blue');
+        const alpha = extractAttr(tag, 'alpha');
+        if (red !== null)
+            dict[`${name}.red`] = red;
+        if (green !== null)
+            dict[`${name}.green`] = green;
+        if (blue !== null)
+            dict[`${name}.blue`] = blue;
+        if (alpha !== null)
+            dict[`${name}.alpha`] = alpha;
+    }
+    // Pass 3: element-style <key>X</key>...<real/integer/string>Y</...> (plist variant)
+    const TAG_RE = /<(\/?)(\w+)([^>]*)>/g;
+    let currentKey = null;
+    let inTag = null;
+    let lastTagEnd = 0;
+    while ((m = TAG_RE.exec(xml)) !== null) {
+        const [full, close, name, attrs] = m;
+        const isSelfClose = attrs.trimEnd().endsWith('/') || full.endsWith('/>');
+        const text = xml.slice(lastTagEnd, m.index).trim();
+        lastTagEnd = m.index + full.length;
+        if (!close && !isSelfClose) {
+            if (name === 'key')
+                inTag = 'key';
+            else if (name === 'integer' || name === 'real' || name === 'string')
+                inTag = name;
+        }
+        else if (isSelfClose) {
+            if ((name === 'true' || name === 'false') && currentKey !== null && !(currentKey in dict)) {
+                dict[currentKey] = name;
+                currentKey = null;
+            }
+        }
+        else {
+            if (name === 'key' && inTag === 'key') {
+                currentKey = text || null;
+                inTag = null;
+            }
+            else if (currentKey !== null && !(currentKey in dict)) {
+                if ((name === 'integer' || name === 'real' || name === 'string') && inTag === name) {
+                    dict[currentKey] = text;
+                    currentKey = null;
+                    inTag = null;
+                }
+            }
+        }
+    }
+    return dict;
+}
+function pStr(d, key, def = '') {
+    return d[key] ?? def;
+}
+//# sourceMappingURL=starlingPexParse.js.map

package/dist/starlingPexParse.js.map

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

package/dist/starlingPexSchema.d.ts

@@ -0,0 +1,49 @@
+export interface StarlingPexColor {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+}
+/** Full Starling PEX particle document. */
+export interface StarlingPexDocument {
+    maxParticles: number;
+    /** Emitter type: 0 = gravity, 1 = radial. */
+    emitterType: 0 | 1;
+    duration: number;
+    particleLifespan: number;
+    particleLifespanVariance: number;
+    speed: number;
+    speedVariance: number;
+    angle: number;
+    angleVariance: number;
+    gravityx: number;
+    gravityy: number;
+    sourcePositionVariancex: number;
+    sourcePositionVariancey: number;
+    startParticleSize: number;
+    startParticleSizeVariance: number;
+    finishParticleSize: number;
+    finishParticleSizeVariance: number;
+    startColor: StarlingPexColor;
+    startColorVariance: StarlingPexColor;
+    finishColor: StarlingPexColor;
+    finishColorVariance: StarlingPexColor;
+    rotationStart: number;
+    rotationStartVariance: number;
+    rotationEnd: number;
+    rotationEndVariance: number;
+    maxRadius: number;
+    maxRadiusVariance: number;
+    minRadius: number;
+    minRadiusVariance: number;
+    rotatePerSecond: number;
+    rotatePerSecondVariance: number;
+    radialAcceleration: number;
+    radialAccelVariance: number;
+    tangentialAcceleration: number;
+    tangentialAccelVariance: number;
+    blendFuncSource: number;
+    blendFuncDestination: number;
+    textureFileName: string;
+}
+//# sourceMappingURL=starlingPexSchema.d.ts.map

package/dist/starlingPexSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingPexSchema.d.ts","sourceRoot":"","sources":["../src/starlingPexSchema.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,EAAE,MAAM,CAAC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,mBAAmB,EAAE,gBAAgB,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/starlingPexSchema.js

@@ -0,0 +1,15 @@
+// Starling / Sparrow PEX particle format schema.
+// The PEX format is an XML particle descriptor popularised by the Sparrow framework
+// and used by Starling, Cocos2d-x, and various OpenFL/Starling toolchains.
+// It differs from Particle Designer's plist in that values are stored as XML attributes
+// rather than nested key/value pairs: <attribute name="key" value="val"/>.
+//
+// Two common sub-variants:
+//  - "attribute" style: <attribute name="key" value="v"/> (original Sparrow/Starling)
+//  - "element" style: identical to Particle Designer plist (common in some exporters)
+// This parser handles both.
+//
+// Field naming follows the Starling PEX 2.x convention.
+// Units: time in seconds, sizes in pixels, angles in degrees.
+export {};
+//# sourceMappingURL=starlingPexSchema.js.map

package/dist/starlingPexSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingPexSchema.js","sourceRoot":"","sources":["../src/starlingPexSchema.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,oFAAoF;AACpF,2EAA2E;AAC3E,wFAAwF;AACxF,2EAA2E;AAC3E,EAAE;AACF,2BAA2B;AAC3B,sFAAsF;AACtF,sFAAsF;AACtF,4BAA4B;AAC5B,EAAE;AACF,wDAAwD;AACxD,8DAA8D"}

package/dist/starlingPexSerialize.d.ts

@@ -0,0 +1,20 @@
+import type { ParticleEmitterConfig } from '@flighthq/types';
+import type { ParticleSerializeResult } from './serializeResult';
+import type { StarlingPexDocument } from './starlingPexSchema';
+export interface StarlingPexSerializeOptions {
+    /** Side length of the particle texture in pixels — reverses the normalisation
+     *  applied during parsing. Defaults to 1. */
+    textureSize?: number;
+}
+/** Serialise a ParticleEmitterConfig to a Starling / Sparrow PEX XML string
+ *  (attribute style).
+ *
+ *  Pass the `document` returned by `parseStarlingPexDocument` to preserve fields
+ *  that don't round-trip through the config (texture filename, emitter type,
+ *  radial parameters). */
+export declare function serializeStarlingPex(config: Readonly<ParticleEmitterConfig>, existing?: Partial<StarlingPexDocument>, options?: StarlingPexSerializeOptions): string;
+/** Serialise a ParticleEmitterConfig to a Starling / Sparrow PEX XML string,
+ *  returning both the serialized text and any warnings for features the format
+ *  cannot represent. */
+export declare function serializeStarlingPexDocument(config: Readonly<ParticleEmitterConfig>, existing?: Partial<StarlingPexDocument>, options?: StarlingPexSerializeOptions): ParticleSerializeResult;
+//# sourceMappingURL=starlingPexSerialize.d.ts.map

package/dist/starlingPexSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlingPexSerialize.d.ts","sourceRoot":"","sources":["../src/starlingPexSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,2BAA2B;IAC1C;iDAC6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;0BAK0B;AAC1B,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,QAAQ,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACvC,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAIR;AAED;;wBAEwB;AACxB,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,QAAQ,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACvC,OAAO,CAAC,EAAE,2BAA2B,GACpC,uBAAuB,CAIzB"}