@flighthq/particles-formats 0.1.0

package/dist/particleDesignerParse.js

@@ -0,0 +1,214 @@
+import { createParticleEmitterConfig } from '@flighthq/particles';
+const DEG2RAD = Math.PI / 180;
+// ─── Minimal plist XML parser ────────────────────────────────────────────────
+function parsePlistRawDict(xml) {
+    const result = {};
+    const TAG_RE = /<(\/?)(\w+)([^>]*)>/g;
+    let currentKey = null;
+    let inTag = null;
+    let lastTagEnd = 0;
+    let m;
+    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) {
+                result[currentKey] = name === 'true';
+                currentKey = null;
+            }
+        }
+        else {
+            if (name === 'key' && inTag === 'key') {
+                currentKey = text || null;
+                inTag = null;
+            }
+            else if (currentKey !== null) {
+                if (name === 'integer' && inTag === 'integer')
+                    result[currentKey] = parseInt(text, 10);
+                else if (name === 'real' && inTag === 'real')
+                    result[currentKey] = parseFloat(text);
+                else if (name === 'string' && inTag === 'string')
+                    result[currentKey] = unescapeXml(text);
+                if (['integer', 'real', 'string'].includes(name)) {
+                    currentKey = null;
+                    inTag = null;
+                }
+            }
+        }
+    }
+    return result;
+}
+function unescapeXml(s) {
+    return s
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&');
+}
+function num(d, key, def = 0) {
+    const v = d[key];
+    // Reject NaN (e.g. from an empty or malformed <integer>/<real> tag) so a
+    // corrupt field falls back to its default instead of poisoning the config.
+    return typeof v === 'number' && Number.isFinite(v) ? v : def;
+}
+function str(d, key, def = '') {
+    const v = d[key];
+    return typeof v === 'string' ? v : def;
+}
+// ─── Shared conversion logic operating directly on the raw dict ──────────────
+function rawDictToConfig(d, textureSize) {
+    const angleRad = num(d, 'angle', 90) * DEG2RAD;
+    const lifespan = num(d, 'particleLifespan', 1);
+    const lifespanVar = num(d, 'particleLifespanVariance', 0);
+    const speed = num(d, 'speed', 100);
+    const speedVar = num(d, 'speedVariance', 0);
+    const vx = num(d, 'sourcePositionVariancex', 0);
+    const vy = num(d, 'sourcePositionVariancey', 0);
+    const emitterShape = vx === 0 && vy === 0 ? 'point' : vx === vy ? 'circle' : 'rect';
+    const startSize = num(d, 'startParticleSize', 32) / textureSize;
+    const startVar = num(d, 'startParticleSizeVariance', 0) / textureSize;
+    const finishSize = num(d, 'finishParticleSize', 16) / textureSize;
+    const rotStart = num(d, 'rotationStart', 0);
+    const rotEnd = num(d, 'rotationEnd', 0);
+    const rotStartVar = num(d, 'rotationStartVariance', 0);
+    const rotEndVar = num(d, 'rotationEndVariance', 0);
+    const lifetimeMid = lifespan + lifespanVar * 0.5 || 1;
+    const rotSpeedMid = ((rotStart + rotEnd) * 0.5 * DEG2RAD) / lifetimeMid;
+    const rotSpeedVar = (Math.max(rotStartVar, rotEndVar) * DEG2RAD) / lifetimeMid;
+    // Particle Designer `duration` is in seconds; -1 (or 0) means emit forever.
+    const pdDuration = num(d, 'duration', -1);
+    return createParticleEmitterConfig({
+        maxParticles: num(d, 'maxParticles', 200) | 0,
+        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: num(d, 'angleVariance', 0) * DEG2RAD,
+        gravityX: num(d, 'gravityx', 0),
+        gravityY: num(d, 'gravityy', 0),
+        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: num(d, 'startColorRed', 1),
+        colorStartG: num(d, 'startColorGreen', 1),
+        colorStartB: num(d, 'startColorBlue', 1),
+        colorStartVarianceR: num(d, 'startColorVarianceRed', 0),
+        colorStartVarianceG: num(d, 'startColorVarianceGreen', 0),
+        colorStartVarianceB: num(d, 'startColorVarianceBlue', 0),
+        colorEndR: num(d, 'finishColorRed', 1),
+        colorEndG: num(d, 'finishColorGreen', 1),
+        colorEndB: num(d, 'finishColorBlue', 1),
+        colorEndVarianceR: num(d, 'finishColorVarianceRed', 0),
+        colorEndVarianceG: num(d, 'finishColorVarianceGreen', 0),
+        colorEndVarianceB: num(d, 'finishColorVarianceBlue', 0),
+        alphaStart: num(d, 'startColorAlpha', 1),
+        alphaEnd: num(d, 'finishColorAlpha', 0),
+        rotationSpeedMin: rotSpeedMid - rotSpeedVar,
+        rotationSpeedMax: rotSpeedMid + rotSpeedVar,
+        blendMode: pdBlendMode(num(d, 'blendFuncSource', 770), num(d, 'blendFuncDestination', 771)),
+    });
+}
+function pdBlendMode(src, dst) {
+    // GL_ONE=1, GL_SRC_ALPHA=770, GL_ONE_MINUS_SRC_ALPHA=771
+    if ((src === 770 || src === 1) && dst === 1)
+        return 'add';
+    if (src === 770 && dst === 771)
+        return 'normal';
+    if (src === 1 && dst === 771)
+        return 'normal'; // premultiplied alpha
+    return null;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Parse a Particle Designer plist XML string directly to a ParticleEmitterConfig.
+ *
+ *  Single-pass: no intermediate document object is allocated.
+ *  Use `parseParticleDesignerPlistDocument` instead when you need round-trip serialisation. */
+export function parseParticleDesignerPlist(plistXml, options) {
+    return rawDictToConfig(parsePlistRawDict(plistXml), options?.textureSize ?? 1);
+}
+function collectParticleDesignerWarnings(d) {
+    const warnings = [];
+    if (num(d, 'emitterType', 0) === 1) {
+        warnings.push('Radial (emitterType=1) emitter was approximated as a gravity emitter; radial motion is not simulated');
+    }
+    if (num(d, 'radialAcceleration', 0) !== 0 || num(d, 'radialAccelVariance', 0) !== 0) {
+        warnings.push('radialAcceleration is not supported and was ignored');
+    }
+    if (num(d, 'tangentialAcceleration', 0) !== 0 || num(d, 'tangentialAccelVariance', 0) !== 0) {
+        warnings.push('tangentialAcceleration is not supported and was ignored');
+    }
+    return warnings;
+}
+/** Parse a Particle Designer plist XML string and preserve the full document for
+ *  round-trip serialisation via `serializeParticleDesignerPlist`. */
+export function parseParticleDesignerPlistDocument(plistXml, options) {
+    const textureSize = options?.textureSize ?? 1;
+    const d = parsePlistRawDict(plistXml);
+    const document = {
+        maxParticles: num(d, 'maxParticles', 200) | 0,
+        emitterType: (num(d, 'emitterType', 0) === 1 ? 1 : 0),
+        duration: num(d, 'duration', -1),
+        particleLifespan: num(d, 'particleLifespan', 1),
+        particleLifespanVariance: num(d, 'particleLifespanVariance', 0),
+        speed: num(d, 'speed', 100),
+        speedVariance: num(d, 'speedVariance', 0),
+        angle: num(d, 'angle', 90),
+        angleVariance: num(d, 'angleVariance', 0),
+        gravityx: num(d, 'gravityx', 0),
+        gravityy: num(d, 'gravityy', 0),
+        sourcePositionVariancex: num(d, 'sourcePositionVariancex', 0),
+        sourcePositionVariancey: num(d, 'sourcePositionVariancey', 0),
+        startParticleSize: num(d, 'startParticleSize', 32),
+        startParticleSizeVariance: num(d, 'startParticleSizeVariance', 0),
+        finishParticleSize: num(d, 'finishParticleSize', 16),
+        finishParticleSizeVariance: num(d, 'finishParticleSizeVariance', 0),
+        startColorRed: num(d, 'startColorRed', 1),
+        startColorGreen: num(d, 'startColorGreen', 1),
+        startColorBlue: num(d, 'startColorBlue', 1),
+        startColorAlpha: num(d, 'startColorAlpha', 1),
+        startColorVarianceRed: num(d, 'startColorVarianceRed', 0),
+        startColorVarianceGreen: num(d, 'startColorVarianceGreen', 0),
+        startColorVarianceBlue: num(d, 'startColorVarianceBlue', 0),
+        startColorVarianceAlpha: num(d, 'startColorVarianceAlpha', 0),
+        finishColorRed: num(d, 'finishColorRed', 1),
+        finishColorGreen: num(d, 'finishColorGreen', 1),
+        finishColorBlue: num(d, 'finishColorBlue', 1),
+        finishColorAlpha: num(d, 'finishColorAlpha', 0),
+        finishColorVarianceRed: num(d, 'finishColorVarianceRed', 0),
+        finishColorVarianceGreen: num(d, 'finishColorVarianceGreen', 0),
+        finishColorVarianceBlue: num(d, 'finishColorVarianceBlue', 0),
+        finishColorVarianceAlpha: num(d, 'finishColorVarianceAlpha', 0),
+        rotationStart: num(d, 'rotationStart', 0),
+        rotationStartVariance: num(d, 'rotationStartVariance', 0),
+        rotationEnd: num(d, 'rotationEnd', 0),
+        rotationEndVariance: num(d, 'rotationEndVariance', 0),
+        maxRadius: num(d, 'maxRadius', 0),
+        maxRadiusVariance: num(d, 'maxRadiusVariance', 0),
+        minRadius: num(d, 'minRadius', 0),
+        minRadiusVariance: num(d, 'minRadiusVariance', 0),
+        rotatePerSecond: num(d, 'rotatePerSecond', 0),
+        rotatePerSecondVariance: num(d, 'rotatePerSecondVariance', 0),
+        blendFuncSource: num(d, 'blendFuncSource', 770),
+        blendFuncDestination: num(d, 'blendFuncDestination', 771),
+        textureFileName: str(d, 'textureFileName', ''),
+    };
+    return { config: rawDictToConfig(d, textureSize), document, warnings: collectParticleDesignerWarnings(d) };
+}
+//# sourceMappingURL=particleDesignerParse.js.map

package/dist/particleDesignerParse.js.map

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

package/dist/particleDesignerSchema.d.ts

@@ -0,0 +1,51 @@
+export type ParticleDesignerEmitterType = 0 | 1;
+export interface ParticleDesignerDocument {
+    maxParticles: number;
+    emitterType: ParticleDesignerEmitterType;
+    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;
+    startColorRed: number;
+    startColorGreen: number;
+    startColorBlue: number;
+    startColorAlpha: number;
+    startColorVarianceRed: number;
+    startColorVarianceGreen: number;
+    startColorVarianceBlue: number;
+    startColorVarianceAlpha: number;
+    finishColorRed: number;
+    finishColorGreen: number;
+    finishColorBlue: number;
+    finishColorAlpha: number;
+    finishColorVarianceRed: number;
+    finishColorVarianceGreen: number;
+    finishColorVarianceBlue: number;
+    finishColorVarianceAlpha: number;
+    rotationStart: number;
+    rotationStartVariance: number;
+    rotationEnd: number;
+    rotationEndVariance: number;
+    maxRadius: number;
+    maxRadiusVariance: number;
+    minRadius: number;
+    minRadiusVariance: number;
+    rotatePerSecond: number;
+    rotatePerSecondVariance: number;
+    blendFuncSource: number;
+    blendFuncDestination: number;
+    textureFileName: string;
+}
+export type ParticleDesignerRawDict = Record<string, string | number | boolean>;
+//# sourceMappingURL=particleDesignerSchema.d.ts.map

package/dist/particleDesignerSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleDesignerSchema.d.ts","sourceRoot":"","sources":["../src/particleDesignerSchema.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,2BAA2B,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhD,MAAM,WAAW,wBAAwB;IAEvC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,2BAA2B,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAGjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IAGjC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IAGtB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IAGtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IAGjB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAGhC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,EAAE,MAAM,CAAC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IAGnC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAGhC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IAGjC,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,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;IAGhC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAG7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC"}

package/dist/particleDesignerSchema.js

@@ -0,0 +1,5 @@
+// Particle Designer plist schema — field names as they appear in the XML file.
+// Reference: https://www.71squared.com/particledesigner (format documented in the tool's export)
+// Targets Particle Designer 3.x and cocos2d-compatible plist files.
+export {};
+//# sourceMappingURL=particleDesignerSchema.js.map

package/dist/particleDesignerSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleDesignerSchema.js","sourceRoot":"","sources":["../src/particleDesignerSchema.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iGAAiG;AACjG,oEAAoE"}

package/dist/particleDesignerSerialize.d.ts

@@ -0,0 +1,22 @@
+import type { ParticleEmitterConfig } from '@flighthq/types';
+import type { ParticleDesignerDocument } from './particleDesignerSchema';
+import type { ParticleSerializeResult } from './serializeResult';
+export interface ParticleDesignerSerializeOptions {
+    /** Side length of the particle texture in pixels — reverses the normalisation
+     *  applied during parsing.  Defaults to 1. */
+    textureSize?: number;
+}
+/** Serialise a ParticleEmitterConfig to a Particle Designer plist XML string.
+ *
+ *  Pass the `document` returned by `parseParticleDesignerPlist` to preserve
+ *  any fields that don't round-trip through the config (texture name, blend
+ *  function, emitter type, duration, color variances). */
+export declare function serializeParticleDesignerPlist(config: Readonly<ParticleEmitterConfig>, existing?: Partial<ParticleDesignerDocument>, options?: ParticleDesignerSerializeOptions): string;
+/** Serialise a ParticleEmitterConfig to a Particle Designer plist XML string,
+ *  returning both the serialized text and any warnings for features the format
+ *  cannot represent.
+ *
+ *  Pass the `document` returned by `parseParticleDesignerPlistDocument` to
+ *  preserve any fields that don't round-trip through the config. */
+export declare function serializeParticleDesignerPlistDocument(config: Readonly<ParticleEmitterConfig>, existing?: Partial<ParticleDesignerDocument>, options?: ParticleDesignerSerializeOptions): ParticleSerializeResult;
+//# sourceMappingURL=particleDesignerSerialize.d.ts.map

package/dist/particleDesignerSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleDesignerSerialize.d.ts","sourceRoot":"","sources":["../src/particleDesignerSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,gCAAgC;IAC/C;kDAC8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmLD;;;;0DAI0D;AAC1D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,QAAQ,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,EAC5C,OAAO,CAAC,EAAE,gCAAgC,GACzC,MAAM,CAIR;AAED;;;;;oEAKoE;AACpE,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EACvC,QAAQ,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,EAC5C,OAAO,CAAC,EAAE,gCAAgC,GACzC,uBAAuB,CAIzB"}

package/dist/particleDesignerSerialize.js

@@ -0,0 +1,209 @@
+const RAD2DEG = 180 / Math.PI;
+function configToDocument(config, existing, textureSize) {
+    // Direction vector → degrees (0°=right, 90°=up-screen)
+    const angleDeg = Math.atan2(-config.directionY, config.directionX) * RAD2DEG;
+    // Scale multipliers → absolute pixel sizes
+    const startSize = (config.scaleMin + config.scaleMax) * 0.5 * textureSize;
+    const startVar = (config.scaleMax - config.scaleMin) * 0.5 * textureSize;
+    const finishSize = startSize * config.scaleEnd;
+    // Rotation speed → Particle Designer rotation range
+    const rotSpeedMid = (config.rotationSpeedMin + config.rotationSpeedMax) * 0.5;
+    const rotSpeedVar = (config.rotationSpeedMax - config.rotationSpeedMin) * 0.5;
+    const lifetimeMid = (config.lifetimeMin + config.lifetimeMax) * 0.5;
+    const rotStart = rotSpeedMid * lifetimeMid * RAD2DEG;
+    const rotVar = rotSpeedVar * lifetimeMid * RAD2DEG;
+    // Emitter shape → sourcePositionVariance
+    let vx = 0;
+    let vy = 0;
+    if (config.emitterShape === 'circle') {
+        vx = config.emitterRadius;
+        vy = config.emitterRadius;
+    }
+    else if (config.emitterShape === 'rect') {
+        vx = config.emitterWidth * 0.5;
+        vy = config.emitterHeight * 0.5;
+    }
+    return {
+        maxParticles: config.maxParticles,
+        emitterType: existing.emitterType ?? 0,
+        duration: config.duration > 0 && !config.loop ? config.duration : (existing.duration ?? -1),
+        particleLifespan: (config.lifetimeMin + config.lifetimeMax) * 0.5,
+        particleLifespanVariance: (config.lifetimeMax - config.lifetimeMin) * 0.5,
+        speed: (config.speedMin + config.speedMax) * 0.5,
+        speedVariance: (config.speedMax - config.speedMin) * 0.5,
+        angle: angleDeg,
+        angleVariance: config.spread * RAD2DEG,
+        gravityx: config.gravityX,
+        gravityy: config.gravityY,
+        sourcePositionVariancex: vx,
+        sourcePositionVariancey: vy,
+        startParticleSize: startSize,
+        startParticleSizeVariance: startVar,
+        finishParticleSize: finishSize,
+        finishParticleSizeVariance: existing.finishParticleSizeVariance ?? 0,
+        startColorRed: config.colorStartR,
+        startColorGreen: config.colorStartG,
+        startColorBlue: config.colorStartB,
+        startColorAlpha: config.alphaStart,
+        startColorVarianceRed: config.colorStartVarianceR !== 0 ? config.colorStartVarianceR : (existing.startColorVarianceRed ?? 0),
+        startColorVarianceGreen: config.colorStartVarianceG !== 0 ? config.colorStartVarianceG : (existing.startColorVarianceGreen ?? 0),
+        startColorVarianceBlue: config.colorStartVarianceB !== 0 ? config.colorStartVarianceB : (existing.startColorVarianceBlue ?? 0),
+        startColorVarianceAlpha: existing.startColorVarianceAlpha ?? 0,
+        finishColorRed: config.colorEndR,
+        finishColorGreen: config.colorEndG,
+        finishColorBlue: config.colorEndB,
+        finishColorAlpha: config.alphaEnd,
+        finishColorVarianceRed: config.colorEndVarianceR !== 0 ? config.colorEndVarianceR : (existing.finishColorVarianceRed ?? 0),
+        finishColorVarianceGreen: config.colorEndVarianceG !== 0 ? config.colorEndVarianceG : (existing.finishColorVarianceGreen ?? 0),
+        finishColorVarianceBlue: config.colorEndVarianceB !== 0 ? config.colorEndVarianceB : (existing.finishColorVarianceBlue ?? 0),
+        finishColorVarianceAlpha: existing.finishColorVarianceAlpha ?? 0,
+        rotationStart: rotStart,
+        rotationStartVariance: rotVar,
+        rotationEnd: rotStart,
+        rotationEndVariance: rotVar,
+        maxRadius: existing.maxRadius ?? 0,
+        maxRadiusVariance: existing.maxRadiusVariance ?? 0,
+        minRadius: existing.minRadius ?? 0,
+        minRadiusVariance: existing.minRadiusVariance ?? 0,
+        rotatePerSecond: existing.rotatePerSecond ?? 0,
+        rotatePerSecondVariance: existing.rotatePerSecondVariance ?? 0,
+        blendFuncSource: blendModeToSrc(config.blendMode, existing.blendFuncSource ?? 770),
+        blendFuncDestination: blendModeToDst(config.blendMode, existing.blendFuncDestination ?? 771),
+        textureFileName: existing.textureFileName ?? '',
+    };
+}
+function documentToPlist(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>',
+    ];
+    function kv(key, value) {
+        lines.push(`\t<key>${key}</key>`);
+        if (typeof value === 'boolean') {
+            lines.push(`\t<${value ? 'true' : 'false'}/>`);
+        }
+        else if (typeof value === 'number') {
+            if (Number.isInteger(value))
+                lines.push(`\t<integer>${value}</integer>`);
+            else
+                lines.push(`\t<real>${value}</real>`);
+        }
+        else {
+            lines.push(`\t<string>${escapeXml(value)}</string>`);
+        }
+    }
+    kv('maxParticles', doc.maxParticles);
+    kv('emitterType', doc.emitterType);
+    kv('duration', doc.duration);
+    kv('particleLifespan', doc.particleLifespan);
+    kv('particleLifespanVariance', doc.particleLifespanVariance);
+    kv('speed', doc.speed);
+    kv('speedVariance', doc.speedVariance);
+    kv('angle', doc.angle);
+    kv('angleVariance', doc.angleVariance);
+    kv('gravityx', doc.gravityx);
+    kv('gravityy', doc.gravityy);
+    kv('sourcePositionVariancex', doc.sourcePositionVariancex);
+    kv('sourcePositionVariancey', doc.sourcePositionVariancey);
+    kv('startParticleSize', doc.startParticleSize);
+    kv('startParticleSizeVariance', doc.startParticleSizeVariance);
+    kv('finishParticleSize', doc.finishParticleSize);
+    kv('finishParticleSizeVariance', doc.finishParticleSizeVariance);
+    kv('startColorRed', doc.startColorRed);
+    kv('startColorGreen', doc.startColorGreen);
+    kv('startColorBlue', doc.startColorBlue);
+    kv('startColorAlpha', doc.startColorAlpha);
+    kv('startColorVarianceRed', doc.startColorVarianceRed);
+    kv('startColorVarianceGreen', doc.startColorVarianceGreen);
+    kv('startColorVarianceBlue', doc.startColorVarianceBlue);
+    kv('startColorVarianceAlpha', doc.startColorVarianceAlpha);
+    kv('finishColorRed', doc.finishColorRed);
+    kv('finishColorGreen', doc.finishColorGreen);
+    kv('finishColorBlue', doc.finishColorBlue);
+    kv('finishColorAlpha', doc.finishColorAlpha);
+    kv('finishColorVarianceRed', doc.finishColorVarianceRed);
+    kv('finishColorVarianceGreen', doc.finishColorVarianceGreen);
+    kv('finishColorVarianceBlue', doc.finishColorVarianceBlue);
+    kv('finishColorVarianceAlpha', doc.finishColorVarianceAlpha);
+    kv('rotationStart', doc.rotationStart);
+    kv('rotationStartVariance', doc.rotationStartVariance);
+    kv('rotationEnd', doc.rotationEnd);
+    kv('rotationEndVariance', doc.rotationEndVariance);
+    kv('maxRadius', doc.maxRadius);
+    kv('maxRadiusVariance', doc.maxRadiusVariance);
+    kv('minRadius', doc.minRadius);
+    kv('minRadiusVariance', doc.minRadiusVariance);
+    kv('rotatePerSecond', doc.rotatePerSecond);
+    kv('rotatePerSecondVariance', doc.rotatePerSecondVariance);
+    kv('blendFuncSource', doc.blendFuncSource);
+    kv('blendFuncDestination', doc.blendFuncDestination);
+    kv('textureFileName', doc.textureFileName);
+    lines.push('</dict>');
+    lines.push('</plist>');
+    return lines.join('\n');
+}
+function escapeXml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function blendModeToSrc(mode, fallback) {
+    if (mode === 'add')
+        return 770; // GL_SRC_ALPHA
+    if (mode === 'normal')
+        return 770;
+    return fallback;
+}
+function blendModeToDst(mode, fallback) {
+    if (mode === 'add')
+        return 1; // GL_ONE
+    if (mode === 'normal')
+        return 771; // GL_ONE_MINUS_SRC_ALPHA
+    return fallback;
+}
+/** Serialise a ParticleEmitterConfig to a Particle Designer plist XML string.
+ *
+ *  Pass the `document` returned by `parseParticleDesignerPlist` to preserve
+ *  any fields that don't round-trip through the config (texture name, blend
+ *  function, emitter type, duration, color variances). */
+export function serializeParticleDesignerPlist(config, existing, options) {
+    const textureSize = options?.textureSize ?? 1;
+    const doc = configToDocument(config, existing ?? {}, textureSize);
+    return documentToPlist(doc);
+}
+/** Serialise a ParticleEmitterConfig to a Particle Designer plist XML string,
+ *  returning both the serialized text and any warnings for features the format
+ *  cannot represent.
+ *
+ *  Pass the `document` returned by `parseParticleDesignerPlistDocument` to
+ *  preserve any fields that don't round-trip through the config. */
+export function serializeParticleDesignerPlistDocument(config, existing, options) {
+    const text = serializeParticleDesignerPlist(config, existing, options);
+    const warnings = collectParticleDesignerSerializeWarnings(config);
+    return { text, warnings };
+}
+/** Collect serialize-side warnings for features in `config` that the Particle
+ *  Designer plist format cannot represent. */
+function collectParticleDesignerSerializeWarnings(config) {
+    const warnings = [];
+    if (config.blendMode !== null && config.blendMode !== 'add' && config.blendMode !== 'normal') {
+        warnings.push(`Blend mode '${config.blendMode}' has no Particle Designer equivalent and was approximated as 'normal'`);
+    }
+    if (config.colorCurve !== null) {
+        warnings.push('Color curve has more than two stops; Particle Designer stores only start and end colors');
+    }
+    if (config.alphaCurve !== null) {
+        warnings.push('Alpha curve has more than two stops; Particle Designer stores only start and end alpha');
+    }
+    if (config.scaleCurve !== null) {
+        warnings.push('Scale curve has more than two stops; Particle Designer stores only start and end size');
+    }
+    if (config.burstCount > 0) {
+        warnings.push('Emission bursts are not supported by the Particle Designer format and were ignored');
+    }
+    if (config.velocityInheritance !== 0) {
+        warnings.push('velocityInheritance is not supported by the Particle Designer format and was ignored');
+    }
+    return warnings;
+}
+//# sourceMappingURL=particleDesignerSerialize.js.map

package/dist/particleDesignerSerialize.js.map

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

package/dist/pixiParse.d.ts

@@ -0,0 +1,18 @@
+import type { ParticleEmitterConfig } from '@flighthq/types';
+export interface PixiParseResult {
+    config: ParticleEmitterConfig;
+    /** 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 `PixiParseResult`. */
+export type PixiParsed = PixiParseResult;
+/** Parse a Pixi.js / pixi-particle-emitter JSON config string directly to a ParticleEmitterConfig.
+ *
+ *  Supports the pixi-particle-emitter v3/v4/v5 config shape.
+ *  Throws a clear, format-tagged error when the input is not valid JSON or not an object. */
+export declare function parsePixiParticle(json: string): ParticleEmitterConfig;
+/** Parse a Pixi.js / pixi-particle-emitter JSON config string, returning the config
+ *  and any import warnings for features that could not be represented. */
+export declare function parsePixiParticleDocument(json: string): PixiParseResult;
+//# sourceMappingURL=pixiParse.d.ts.map

package/dist/pixiParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixiParse.d.ts","sourceRoot":"","sources":["../src/pixiParse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B;iFAC6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC;AAEzC;;;6FAG6F;AAC7F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAErE;AAED;0EAC0E;AAC1E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAMvE"}