@nice2dev/ui-graphics 1.0.0

package/dist/cjs/animation/characterTypes.js.map

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

package/dist/cjs/animation/choreoDSL.js

@@ -0,0 +1,190 @@
+'use strict';
+
+var animationHelper = require('./animationHelper.js');
+
+/**
+ * Builder-pattern DSL for choreography sequences.
+ *
+ * @example
+ * ```ts
+ * seq()
+ *   .enterFromLeft(0.6)
+ *   .happy(300)
+ *   .waveHand(600)
+ *   .celebrate(500)
+ * ```
+ */
+class ChoreoBuilder {
+    constructor() {
+        this.steps = [];
+        this.labels = {};
+    }
+    pose(pose, holdMs = 0, options) {
+        this.steps.push({ type: "pose", pose, holdMs, options });
+        return this;
+    }
+    wait(ms) {
+        this.steps.push({ type: "wait", ms });
+        return this;
+    }
+    tempo(multiplier) {
+        const m = Math.max(0, multiplier);
+        this.steps = this.steps.map((s) => {
+            if (s.type === "pose") {
+                return {
+                    ...s,
+                    holdMs: typeof s.holdMs === "number" ? Math.round(s.holdMs * m) : s.holdMs,
+                    options: s.options
+                        ? {
+                            ...s.options,
+                            duration: typeof s.options.duration === "number"
+                                ? s.options.duration * m
+                                : s.options.duration,
+                        }
+                        : s.options,
+                };
+            }
+            if (s.type === "wait")
+                return { ...s, ms: Math.round(s.ms * m) };
+            return s;
+        });
+        return this;
+    }
+    repeat(times) {
+        const t = Math.max(0, Math.floor(times));
+        const base = this.steps.slice();
+        for (let i = 1; i < t; i++)
+            this.steps.push(...base);
+        return this;
+    }
+    loop(times) {
+        this.loopCount = times;
+        return this;
+    }
+    label(name) {
+        this.labels[name] = this.steps.length;
+        this.steps.push({ type: "label", name });
+        return this;
+    }
+    goto(name) {
+        this.steps.push({ type: "goto", name });
+        return this;
+    }
+    gotoIf(name, when) {
+        this.steps.push({ type: "goto", name, when });
+        return this;
+    }
+    // Convenience shortcuts
+    idle(ms = 0) { return this.pose("idle", ms); }
+    enterFromLeft(duration = 0.6) { return this.pose("enterFromLeft", 0, { duration }); }
+    enterFromRight(duration = 0.6) { return this.pose("enterFromRight", 0, { duration }); }
+    exitLeft(duration = 0.6) { return this.pose("exitLeft", 0, { duration }); }
+    exitRight(duration = 0.6) { return this.pose("exitRight", 0, { duration }); }
+    hideDown(duration = 0.6) { return this.pose("hideDown", 0, { duration }); }
+    happy(ms = 350) { return this.pose("happy", ms); }
+    angry(ms = 350) { return this.pose("angry", ms); }
+    disappointed(ms = 350) { return this.pose("disappointed", ms); }
+    swearing(ms = 350) { return this.pose("swearing", ms); }
+    shouting(ms = 350) { return this.pose("shouting", ms); }
+    rock(ms = 500) { return this.pose("rock", ms); }
+    danceA(ms = 350) { return this.pose("danceA", ms); }
+    danceB(ms = 350) { return this.pose("danceB", ms); }
+    danceC(ms = 350) { return this.pose("danceC", ms); }
+    waveHand(ms = 600) { return this.pose("waveHand", ms); }
+    facepalm(ms = 500) { return this.pose("facepalm", ms); }
+    shrug(ms = 450) { return this.pose("shrug", ms); }
+    nodYes(ms = 450) { return this.pose("nodYes", ms); }
+    shakeNo(ms = 450) { return this.pose("shakeNo", ms); }
+    pointRight(ms = 400) { return this.pose("pointRight", ms); }
+    leanBack(ms = 400) { return this.pose("leanBack", ms); }
+    jump(ms = 450) { return this.pose("jump", ms); }
+    spin(ms = 650) { return this.pose("spin", ms); }
+    celebrate(ms = 600) { return this.pose("celebrate", ms); }
+    raiseCard(score = 10, holdMs = 800, duration = 0.6) {
+        return this.pose("raiseCard", holdMs, { duration, score });
+    }
+    build() { return this.steps.slice(); }
+    getLoop() { return this.loopCount; }
+}
+/** Create a new ChoreoBuilder. */
+const seq = () => new ChoreoBuilder();
+/** Compile builder or steps into flat ChoreoStep[] (resolving gotos). */
+function compile(builderOrSteps, ctx = {}) {
+    const internal = builderOrSteps instanceof ChoreoBuilder
+        ? builderOrSteps.build()
+        : builderOrSteps;
+    const labelIndex = {};
+    internal.forEach((s, i) => { if (s.type === "label")
+        labelIndex[s.name] = i; });
+    const out = [];
+    for (let pc = 0; pc < internal.length; pc++) {
+        const s = internal[pc];
+        if (s.type === "pose")
+            out.push({ pose: s.pose, holdMs: s.holdMs, options: s.options });
+        else if (s.type === "wait")
+            out.push({ pose: "idle", holdMs: s.ms });
+        else if (s.type === "goto") {
+            const should = s.when ? !!s.when(ctx) : true;
+            if (should) {
+                const idx = labelIndex[s.name];
+                if (idx !== undefined)
+                    pc = idx;
+            }
+        }
+    }
+    return out;
+}
+/** Run compiled choreography on a single actor (with optional looping). */
+async function runSeq(fx, builderOrSteps, ctx = {}) {
+    if (builderOrSteps instanceof ChoreoBuilder) {
+        const loop = builderOrSteps.getLoop();
+        if (loop === Infinity) {
+            // Intentional infinite loop for unbounded choreography playback
+            // eslint-disable-next-line no-constant-condition
+            while (true) {
+                const steps = compile(builderOrSteps, ctx);
+                await animationHelper.runChoreo(fx, steps);
+            }
+        }
+        else {
+            const times = Math.max(1, loop !== null && loop !== void 0 ? loop : 1);
+            for (let i = 0; i < times; i++) {
+                const steps = compile(builderOrSteps, ctx);
+                await animationHelper.runChoreo(fx, steps);
+            }
+        }
+    }
+    else {
+        await animationHelper.runChoreo(fx, compile(builderOrSteps, ctx));
+    }
+}
+async function runChoreoWithDelay(fx, steps, delayMs) {
+    if (delayMs > 0)
+        await new Promise((r) => setTimeout(r, delayMs));
+    await animationHelper.runChoreo(fx, steps);
+}
+/** Wave pattern: stagger actors left→right. */
+async function runWave(actors, choreo, staggerMs = 220, ctx = {}) {
+    const steps = compile(choreo, ctx);
+    await Promise.all(actors.map((fx, i) => runChoreoWithDelay(fx, steps, i * Math.max(0, staggerMs))));
+}
+/** Cannon pattern: wave left→right, then right→left. */
+async function runCannon(actors, choreo, staggerMs = 220, ctx = {}) {
+    await runWave(actors, choreo, staggerMs, ctx);
+    const reversed = [...actors].reverse();
+    await runWave(reversed, choreo, staggerMs, ctx);
+}
+/** Assign programs to actors round-robin. */
+async function runRounds(actors, programs, staggerMs = 0, ctx = {}) {
+    const jobs = actors.map((fx, i) => runChoreoWithDelay(fx, compile(programs[i % programs.length], ctx), staggerMs * i));
+    await Promise.all(jobs);
+}
+
+exports.ChoreoBuilder = ChoreoBuilder;
+exports.compile = compile;
+exports.runCannon = runCannon;
+exports.runRounds = runRounds;
+exports.runSeq = runSeq;
+exports.runWave = runWave;
+exports.seq = seq;
+//# sourceMappingURL=choreoDSL.js.map

package/dist/cjs/animation/choreoDSL.js.map

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

package/dist/cjs/animation/choreography.js

@@ -0,0 +1,41 @@
+'use strict';
+
+var choreoDSL = require('./choreoDSL.js');
+
+/** Wave + score reveal choreography. */
+const waveScoreChoreo = (score) => choreoDSL.seq()
+    .enterFromLeft(0.6)
+    .waveHand(600)
+    .raiseCard(score, 700)
+    .idle(200);
+/** Boo / disapproval choreography. */
+const booChoreo = choreoDSL.seq()
+    .angry(400)
+    .shouting(400)
+    .facepalm(350)
+    .exitLeft(0.6);
+/** Dance party loop. */
+const danceParty = choreoDSL.seq()
+    .danceA(350)
+    .danceB(350)
+    .danceC(350)
+    .loop(Infinity);
+/** Showcase all poses. */
+const showcaseAll = choreoDSL.seq()
+    .idle(300)
+    .happy(400).angry(400).disappointed(400)
+    .swearing(400).shouting(400)
+    .rock(500)
+    .danceA(350).danceB(350).danceC(350)
+    .waveHand(600).facepalm(500).shrug(450)
+    .nodYes(450).shakeNo(450)
+    .pointRight(400).leanBack(400)
+    .jump(450).spin(650).celebrate(600)
+    .raiseCard(10, 800)
+    .idle(400);
+
+exports.booChoreo = booChoreo;
+exports.danceParty = danceParty;
+exports.showcaseAll = showcaseAll;
+exports.waveScoreChoreo = waveScoreChoreo;
+//# sourceMappingURL=choreography.js.map

package/dist/cjs/animation/choreography.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choreography.js","sources":["../../../src/animation/choreography.ts"],"sourcesContent":[null],"names":["seq"],"mappings":";;;;AAEA;AACO,MAAM,eAAe,GAAG,CAAC,KAAa,KACzCA,aAAG;KACE,aAAa,CAAC,GAAG;KACjB,QAAQ,CAAC,GAAG;AACZ,KAAA,SAAS,CAAC,KAAK,EAAE,GAAG;KACpB,IAAI,CAAC,GAAG;AAEjB;AACO,MAAM,SAAS,GAClBA,aAAG;KACE,KAAK,CAAC,GAAG;KACT,QAAQ,CAAC,GAAG;KACZ,QAAQ,CAAC,GAAG;KACZ,QAAQ,CAAC,GAAG;AAErB;AACO,MAAM,UAAU,GACnBA,aAAG;KACE,MAAM,CAAC,GAAG;KACV,MAAM,CAAC,GAAG;KACV,MAAM,CAAC,GAAG;KACV,IAAI,CAAC,QAAQ;AAEtB;AACO,MAAM,WAAW,GACpBA,aAAG;KACE,IAAI,CAAC,GAAG;AACR,KAAA,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG;AACtC,KAAA,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG;KAC1B,IAAI,CAAC,GAAG;AACR,KAAA,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG;AAClC,KAAA,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG;AACrC,KAAA,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG;AACvB,KAAA,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG;AAC5B,KAAA,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG;AACjC,KAAA,SAAS,CAAC,EAAE,EAAE,GAAG;KACjB,IAAI,CAAC,GAAG;;;;;;;"}

package/dist/cjs/animation/karaokeIntegration.js

@@ -0,0 +1,98 @@
+'use strict';
+
+var choreoDSL = require('./choreoDSL.js');
+
+class ScoreBus {
+    constructor() {
+        this.target = new EventTarget();
+    }
+    push(score) {
+        const e = { score, at: Date.now() };
+        this.target.dispatchEvent(new CustomEvent("score", { detail: e }));
+    }
+    subscribe(handler) {
+        const wrap = (ev) => handler(ev.detail);
+        this.target.addEventListener("score", wrap);
+        return () => this.target.removeEventListener("score", wrap);
+    }
+}
+/** Shared score event bus. */
+const scoreBus = new ScoreBus();
+/** Subscribe to score events with throttling + dedup. */
+function onScore(handler, opts = {}) {
+    var _a, _b, _c;
+    const min = (_a = opts.minIntervalMs) !== null && _a !== void 0 ? _a : 400;
+    const dedupe = (_b = opts.dedupeWindowMs) !== null && _b !== void 0 ? _b : 800;
+    const roundTo = Math.max(0, Math.floor((_c = opts.roundTo) !== null && _c !== void 0 ? _c : 1));
+    let lastEventAt = 0;
+    let lastRounded = null;
+    let lastRoundedAt = 0;
+    return scoreBus.subscribe((e) => {
+        const now = e.at;
+        if (now - lastEventAt < min)
+            return;
+        lastEventAt = now;
+        const factor = Math.pow(10, roundTo);
+        const rounded = (Math.round(e.score * factor) / factor).toFixed(roundTo);
+        if (lastRounded && rounded === lastRounded && now - lastRoundedAt < dedupe)
+            return;
+        lastRounded = rounded;
+        lastRoundedAt = now;
+        handler(e.score);
+    });
+}
+/** Map a score to a reaction choreography. */
+function reactionForScore(score, rng = Math.random) {
+    const r = rng();
+    if (score >= 8.5) {
+        const strong = [
+            choreoDSL.seq().happy(300).celebrate(600),
+            choreoDSL.seq().danceA(300).danceB(300).celebrate(500),
+            choreoDSL.seq().jump(400).raiseCard(score, 700),
+        ];
+        return strong[Math.floor(r * strong.length)];
+    }
+    if (score >= 5.5) {
+        const mid = [
+            choreoDSL.seq().shrug(450),
+            choreoDSL.seq().nodYes(450),
+            choreoDSL.seq().leanBack(400),
+        ];
+        return mid[Math.floor(r * mid.length)].raiseCard(score, 700);
+    }
+    const low = [
+        choreoDSL.seq().angry(400).shouting(400),
+        choreoDSL.seq().facepalm(500).disappointed(400),
+        choreoDSL.seq().swearing(450).shakeNo(450),
+    ];
+    return low[Math.floor(r * low.length)].raiseCard(score, 900);
+}
+/** Play intro choreography for actors. */
+async function playIntro(actors) {
+    if (!actors.length)
+        return;
+    const programs = [
+        choreoDSL.seq().enterFromLeft(0.6).waveHand(600).raiseCard(9, 700).idle(200),
+        choreoDSL.seq().enterFromRight(0.6).spin(600).danceA(400).idle(200),
+        choreoDSL.seq().enterFromLeft(0.5).jump(450).pointRight(350).idle(200),
+        choreoDSL.seq().enterFromRight(0.5).happy(300).raiseCard(10, 800),
+    ];
+    await choreoDSL.runRounds(actors, programs);
+}
+/** Emit a score event for testing. */
+const simulateScore = (score) => scoreBus.push(score);
+/** Attach score reactions to actors. */
+function attachScoreReactions(actors, opts = {}, rng = Math.random) {
+    return onScore(async (score) => {
+        const programs = actors.map(() => reactionForScore(score, rng));
+        await choreoDSL.runRounds(actors, programs, 80, { score });
+    }, opts);
+}
+
+exports.attachScoreReactions = attachScoreReactions;
+exports.onScore = onScore;
+exports.playIntro = playIntro;
+exports.reactionForScore = reactionForScore;
+exports.scoreBus = scoreBus;
+exports.simulateScore = simulateScore;
+//# sourceMappingURL=karaokeIntegration.js.map

package/dist/cjs/animation/karaokeIntegration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeIntegration.js","sources":["../../../src/animation/karaokeIntegration.ts"],"sourcesContent":[null],"names":["seq","runRounds"],"mappings":";;;;AAUA,MAAM,QAAQ,CAAA;AAAd,IAAA,WAAA,GAAA;AACY,QAAA,IAAA,CAAA,MAAM,GAAG,IAAI,WAAW,EAAE;IAYtC;AAVI,IAAA,IAAI,CAAC,KAAa,EAAA;AACd,QAAA,MAAM,CAAC,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;AAC/C,QAAA,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAa,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF;AAEA,IAAA,SAAS,CAAC,OAAqB,EAAA;AAC3B,QAAA,MAAM,IAAI,GAAG,CAAC,EAAS,KAAK,OAAO,CAAE,EAA8B,CAAC,MAAM,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAqB,CAAC;AAC5D,QAAA,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAqB,CAAC;IAChF;AACH;AAED;AACO,MAAM,QAAQ,GAAG,IAAI,QAAQ;AAQpC;SACgB,OAAO,CACnB,OAAgC,EAChC,OAA6B,EAAE,EAAA;;IAE/B,MAAM,GAAG,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,aAAa,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,GAAG;IACrC,MAAM,MAAM,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,cAAc,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,GAAG;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA,EAAA,GAAA,IAAI,CAAC,OAAO,mCAAI,CAAC,CAAC,CAAC;IAE1D,IAAI,WAAW,GAAG,CAAC;IACnB,IAAI,WAAW,GAAkB,IAAI;IACrC,IAAI,aAAa,GAAG,CAAC;AAErB,IAAA,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,KAAI;AAC5B,QAAA,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE;AAChB,QAAA,IAAI,GAAG,GAAG,WAAW,GAAG,GAAG;YAAE;QAC7B,WAAW,GAAG,GAAG;QAEjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC;QACpC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;QACxE,IAAI,WAAW,IAAI,OAAO,KAAK,WAAW,IAAI,GAAG,GAAG,aAAa,GAAG,MAAM;YAAE;QAC5E,WAAW,GAAG,OAAO;QACrB,aAAa,GAAG,GAAG;AAEnB,QAAA,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpB,IAAA,CAAC,CAAC;AACN;AAEA;AACM,SAAU,gBAAgB,CAAC,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAA;AAC7D,IAAA,MAAM,CAAC,GAAG,GAAG,EAAE;AACf,IAAA,IAAI,KAAK,IAAI,GAAG,EAAE;AACd,QAAA,MAAM,MAAM,GAAG;YACXA,aAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;AAC/B,YAAAA,aAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;AAC5C,YAAAA,aAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC;SACxC;AACD,QAAA,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD;AACA,IAAA,IAAI,KAAK,IAAI,GAAG,EAAE;AACd,QAAA,MAAM,GAAG,GAAG;AACR,YAAAA,aAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;AAChB,YAAAA,aAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;AACjB,YAAAA,aAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;SACtB;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC;IAChE;AACA,IAAA,MAAM,GAAG,GAAG;QACRA,aAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC9BA,aAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC;QACrCA,aAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;KACnC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC;AAChE;AAEA;AACO,eAAe,SAAS,CAAC,MAAwB,EAAA;IACpD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE;AACpB,IAAA,MAAM,QAAQ,GAAG;QACbA,aAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAClEA,aAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACzDA,aAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AAC5D,QAAAA,aAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC;KAC1D;AACD,IAAA,MAAMC,mBAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;AACrC;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,KAAa,KAAK,QAAQ,CAAC,IAAI,CAAC,KAAK;AAEnE;AACM,SAAU,oBAAoB,CAChC,MAAwB,EACxB,IAAA,GAA6B,EAAE,EAC/B,GAAG,GAAG,IAAI,CAAC,MAAM,EAAA;AAEjB,IAAA,OAAO,OAAO,CAAC,OAAO,KAAK,KAAI;AAC3B,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/D,QAAA,MAAMA,mBAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAgB,CAAC;IAClE,CAAC,EAAE,IAAI,CAAC;AACZ;;;;;;;;;"}

package/dist/cjs/animation/lottieExport.js

@@ -0,0 +1,128 @@
+'use strict';
+
+var rigTypes = require('./rig/rigTypes.js');
+var rigMath = require('./rig/rigMath.js');
+
+// ── Conversion ──────────────────────────────────────────────────
+function msToFrame(ms, fps) {
+    return Math.round(ms * fps / 1000);
+}
+function createPositionKeyframes(keyframes, rig, bone, size, fps) {
+    return keyframes.map((kf, i) => {
+        var _a, _b;
+        const fk = rigMath.solveFK(rig, kf.pose, size);
+        const solved = fk[bone];
+        return {
+            i: i < keyframes.length - 1 ? { x: 0.667, y: 1 } : undefined,
+            o: i < keyframes.length - 1 ? { x: 0.333, y: 0 } : undefined,
+            t: msToFrame(kf.time, fps),
+            s: [(_a = solved === null || solved === void 0 ? void 0 : solved.x) !== null && _a !== void 0 ? _a : 0, (_b = solved === null || solved === void 0 ? void 0 : solved.y) !== null && _b !== void 0 ? _b : 0],
+            e: i < keyframes.length - 1
+                ? (() => {
+                    var _a, _b;
+                    const nextFk = rigMath.solveFK(rig, keyframes[i + 1].pose, size);
+                    const nextSolved = nextFk[bone];
+                    return [(_a = nextSolved === null || nextSolved === void 0 ? void 0 : nextSolved.x) !== null && _a !== void 0 ? _a : 0, (_b = nextSolved === null || nextSolved === void 0 ? void 0 : nextSolved.y) !== null && _b !== void 0 ? _b : 0];
+                })()
+                : undefined,
+        };
+    });
+}
+function createBoneShapeLayer(bone, index, keyframes, rig, size, fps, totalFrames) {
+    const posKf = createPositionKeyframes(keyframes, rig, bone, size, fps);
+    return {
+        ddd: 0,
+        ind: index,
+        ty: 4, // shape layer
+        nm: bone,
+        sr: 1,
+        ks: {
+            o: { a: 0, k: 100 }, // opacity
+            r: { a: 0, k: 0 }, // rotation
+            p: { a: 1, k: posKf }, // animated position
+            a: { a: 0, k: [0, 0, 0] }, // anchor
+            s: { a: 0, k: [100, 100, 100] }, // scale
+        },
+        ao: 0,
+        shapes: [
+            {
+                ty: "el", // ellipse
+                d: 1,
+                s: { a: 0, k: [4, 4] }, // joint dot size
+                p: { a: 0, k: [0, 0] },
+                nm: `${bone}_joint`,
+            },
+            {
+                ty: "fl", // fill
+                c: { a: 0, k: [0.2, 0.5, 1, 1] },
+                o: { a: 0, k: 100 },
+                r: 1,
+                bm: 0,
+                nm: `${bone}_fill`,
+            },
+        ],
+        ip: 0,
+        op: totalFrames,
+        st: 0,
+        bm: 0,
+    };
+}
+// ── Public API ──────────────────────────────────────────────────
+/**
+ * Export a sequence of RigPose keyframes to Lottie JSON format.
+ * Returns a Lottie animation object that can be serialized with JSON.stringify().
+ */
+function exportToLottie(keyframes, options = {}) {
+    const { name = "Nice2Dev Animation", width = 400, height = 400, fps = 30, rig = rigTypes.DEFAULT_RIG, size = 200, author = "Nice2Dev", } = options;
+    if (keyframes.length === 0) {
+        throw new Error("At least one keyframe is required for Lottie export");
+    }
+    const sorted = [...keyframes].sort((a, b) => a.time - b.time);
+    const totalDurationMs = sorted[sorted.length - 1].time - sorted[0].time;
+    const totalFrames = msToFrame(totalDurationMs, fps) + 1;
+    const layers = rigTypes.BONE_ORDER.map((bone, idx) => createBoneShapeLayer(bone, idx + 1, sorted, rig, size, fps, totalFrames));
+    return {
+        v: "5.12.2",
+        fr: fps,
+        ip: 0,
+        op: totalFrames,
+        w: width,
+        h: height,
+        nm: name,
+        ddd: 0,
+        assets: [],
+        layers,
+        meta: { a: author, g: "@nice2dev/ui-graphics" },
+    };
+}
+/** Serialize Lottie animation to a JSON string. */
+function lottieToJSON(animation) {
+    return JSON.stringify(animation);
+}
+/** Create a downloadable Blob for the Lottie animation. */
+function lottieToBlob(animation) {
+    return new Blob([lottieToJSON(animation)], { type: "application/json" });
+}
+/**
+ * Convert a choreography sequence (pose name + duration) to Lottie keyframes.
+ * Utility for bridging the choreography system to Lottie export.
+ */
+function choreoToLottieKeyframes(poses) {
+    const keyframes = [];
+    let time = 0;
+    for (const { pose, durationMs } of poses) {
+        keyframes.push({ time, pose });
+        time += durationMs;
+    }
+    // Add final frame
+    if (poses.length > 0) {
+        keyframes.push({ time, pose: poses[poses.length - 1].pose });
+    }
+    return keyframes;
+}
+
+exports.choreoToLottieKeyframes = choreoToLottieKeyframes;
+exports.exportToLottie = exportToLottie;
+exports.lottieToBlob = lottieToBlob;
+exports.lottieToJSON = lottieToJSON;
+//# sourceMappingURL=lottieExport.js.map

package/dist/cjs/animation/lottieExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lottieExport.js","sources":["../../../src/animation/lottieExport.ts"],"sourcesContent":[null],"names":["solveFK","DEFAULT_RIG","BONE_ORDER"],"mappings":"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"}