@cyanheads/pixoo-mcp-server 1.2.0 → 1.2.2

package/dist/renderer/finish.js

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Palette finishing — reduce a rendered canvas, or every frame of an
+ * animation, to a palette with optional dithering through the toolkit's `quantize`.
+ * Tool-agnostic: any render path applies a caller's `finish` here, after the load and
+ * before the preview, so the preview is exactly the frame the device receives.
+ * @module renderer/finish
+ */
+import { Canvas, quantize } from '@cyanheads/pixoo-toolkit';
+/**
+ * Apply `finish` to one canvas.
+ *
+ * @returns A new canvas; the input is never mutated.
+ * @throws {Error} The toolkit's `Unknown color` error for an unresolvable palette entry.
+ */
+export function finishFrame(canvas, finish) {
+    return quantize(canvas, finish);
+}
+/**
+ * Apply `finish` to every frame of an animation. `colors` builds one palette from all
+ * the frames' visible pixels together, so the whole loop holds at most that many colors;
+ * `palette` and `dither` apply to each frame on its own, so dither error never crosses
+ * from one frame into the next.
+ *
+ * @param frames - Frames of one size, up to 4096 stacked rows in all (64 frames of a
+ *   64-pixel panel).
+ * @returns New canvases, one per frame; the inputs are never mutated.
+ * @throws {Error} The toolkit's `Unknown color` error for an unresolvable palette entry.
+ */
+export function finishFrames(frames, finish) {
+    if (finish.colors === undefined || frames.length <= 1) {
+        return frames.map((frame) => quantize(frame, finish));
+    }
+    const palette = sharedPalette(frames, finish.colors);
+    // Nothing visible to reduce — quantize returns such a frame unchanged too.
+    if (palette.length === 0)
+        return frames.map((frame) => frame.clone());
+    return frames.map((frame) => quantize(frame, { palette, dither: finish.dither ?? 'none' }));
+}
+/**
+ * The palette of at most `colors` colors `quantize` builds from every frame's visible
+ * pixels at once: the frames stacked into one canvas and reduced without dithering,
+ * then the reduced canvas's distinct visible colors read back in raster order.
+ */
+function sharedPalette(frames, colors) {
+    const [first] = frames;
+    const stack = new Canvas(first.width, first.height * frames.length);
+    frames.forEach((frame, k) => {
+        stack.buffer.set(frame.buffer, k * frame.buffer.length);
+    });
+    const buf = quantize(stack, { colors }).buffer;
+    const palette = new Map();
+    for (let i = 0; i < buf.length; i += 4) {
+        if (buf[i + 3] === 0)
+            continue;
+        const rgb = [buf[i] ?? 0, buf[i + 1] ?? 0, buf[i + 2] ?? 0];
+        const key = (rgb[0] << 16) | (rgb[1] << 8) | rgb[2];
+        if (!palette.has(key))
+            palette.set(key, rgb);
+    }
+    return [...palette.values()];
+}
+//# sourceMappingURL=finish.js.map

package/dist/renderer/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","sourceRoot":"","sources":["../../src/renderer/finish.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAwB,QAAQ,EAAY,MAAM,0BAA0B,CAAC;AAS5F;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc;IACxD,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAyB,EAAE,MAAc;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,2EAA2E;IAC3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAyB,EAAE,MAAc;IAC9D,MAAM,CAAC,KAAK,CAAC,GAAG,MAAwC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/B,MAAM,GAAG,GAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/B,CAAC"}

package/dist/renderer/icons.d.ts

@@ -2,15 +2,25 @@
  * @fileoverview Built-in icon registry with SVG path data by category.
  * @module renderer/icons
  */
+/**
+ * An icon's SVG path data, split by how each part draws. `fill` subpaths rasterize with the
+ * even-odd rule; `stroke` subpaths draw as 1-pixel lines along their segments — the parts
+ * designed as outlines, since a line has no area for a fill to cover.
+ */
+export type IconPaths = {
+    fill: string;
+    stroke?: string;
+} | {
+    fill?: undefined;
+    stroke: string;
+};
 /** A single icon entry. */
-export interface IconEntry {
+export type IconEntry = IconPaths & {
     category: string;
-    /** SVG d attribute for the icon path. */
-    d: string;
     name: string;
     /** viewBox string (default "0 0 16 16"). */
     viewBox: string;
-}
+};
 /** All icons indexed by name. */
 export declare const ICONS: Record<string, IconEntry>;
 export declare const ICON_NAMES: string[];

package/dist/renderer/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/renderer/icons.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iCAAiC;AACjC,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA6H3C,CAAC;AAEF,eAAO,MAAM,UAAU,UAAqB,CAAC;AAE7C,eAAO,MAAM,eAAe,UAA4D,CAAC;AAEzF,qCAAqC;AACrC,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAO7D"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/renderer/icons.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAKF,iCAAiC;AACjC,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAoI3C,CAAC;AAEF,eAAO,MAAM,UAAU,UAAqB,CAAC;AAE7C,eAAO,MAAM,eAAe,UAA4D,CAAC;AAEzF,qCAAqC;AACrC,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAO7D"}

package/dist/renderer/icons.js

@@ -2,130 +2,138 @@
  * @fileoverview Built-in icon registry with SVG path data by category.
  * @module renderer/icons
  */
+/** The circle every status badge is drawn around, as a stroke. */
+const STATUS_RING = 'M8 1a7 7 0 1 0 0 14A7 7 0 0 0 8 1z';
 /** All icons indexed by name. */
 export const ICONS = {
     // --- weather ---
     sun: {
         name: 'sun',
         category: 'weather',
-        d: 'M8 5a3 3 0 1 0 0 6 3 3 0 0 0 0-6zM8 1v2M8 13v2M3.22 3.22l1.41 1.41M11.37 11.37l1.41 1.41M1 8h2M13 8h2M3.22 12.78l1.41-1.41M11.37 4.63l1.41-1.41',
+        fill: 'M8 5a3 3 0 1 0 0 6 3 3 0 0 0 0-6z',
+        stroke: 'M8 1v2M8 13v2M3.22 3.22l1.41 1.41M11.37 11.37l1.41 1.41M1 8h2M13 8h2M3.22 12.78l1.41-1.41M11.37 4.63l1.41-1.41',
         viewBox: '0 0 16 16',
     },
     cloud: {
         name: 'cloud',
         category: 'weather',
-        d: 'M13 10a3 3 0 0 0-3-3h-.5A4.5 4.5 0 1 0 3 10h10z',
+        fill: 'M13 10a3 3 0 0 0-3-3h-.5A4.5 4.5 0 1 0 3 10h10z',
         viewBox: '0 0 16 16',
     },
     rain: {
         name: 'rain',
         category: 'weather',
-        d: 'M13 8a3 3 0 0 0-3-3h-.5A4.5 4.5 0 1 0 3 8h10zM5 12l-1 3M8 12v3M11 12l1 3',
+        fill: 'M13 8a3 3 0 0 0-3-3h-.5A4.5 4.5 0 1 0 3 8h10z',
+        stroke: 'M5 12l-1 3M8 12v3M11 12l1 3',
         viewBox: '0 0 16 16',
     },
     snow: {
         name: 'snow',
         category: 'weather',
-        d: 'M8 1v14M3.5 4l9 8M12.5 4l-9 8M1 8h14M3 5.5l-2-2M13 5.5l2-2M3 10.5l-2 2M13 10.5l2 2',
+        stroke: 'M8 1v14M3.5 4l9 8M12.5 4l-9 8M1 8h14M3 5.5l-2-2M13 5.5l2-2M3 10.5l-2 2M13 10.5l2 2',
         viewBox: '0 0 16 16',
     },
     wind: {
         name: 'wind',
         category: 'weather',
-        d: 'M1 6h8a2 2 0 1 0-2-2M1 10h12a2 2 0 1 1-2 2M1 8h6',
+        stroke: 'M1 6h8a2 2 0 1 0-2-2M1 10h12a2 2 0 1 1-2 2M1 8h6',
         viewBox: '0 0 16 16',
     },
     lightning: {
         name: 'lightning',
         category: 'weather',
-        d: 'M9 1L4 9h5l-2 6 7-8H9z',
+        fill: 'M9 1L4 9h5l-2 6 7-8H9z',
         viewBox: '0 0 16 16',
     },
-    // --- arrows ---
+    // --- arrows: a filled head on a stroked shaft ---
     'arrow-up': {
         name: 'arrow-up',
         category: 'arrows',
-        d: 'M8 2L8 14M3 7l5-5 5 5',
+        fill: 'M3 7l5-5 5 5',
+        stroke: 'M8 2L8 14',
         viewBox: '0 0 16 16',
     },
     'arrow-down': {
         name: 'arrow-down',
         category: 'arrows',
-        d: 'M8 14L8 2M3 9l5 5 5-5',
+        fill: 'M3 9l5 5 5-5',
+        stroke: 'M8 14L8 2',
         viewBox: '0 0 16 16',
     },
     'arrow-left': {
         name: 'arrow-left',
         category: 'arrows',
-        d: 'M2 8L14 8M7 3L2 8l5 5',
+        fill: 'M7 3L2 8l5 5',
+        stroke: 'M2 8L14 8',
         viewBox: '0 0 16 16',
     },
     'arrow-right': {
         name: 'arrow-right',
         category: 'arrows',
-        d: 'M14 8L2 8M9 3L14 8l-5 5',
+        fill: 'M9 3L14 8l-5 5',
+        stroke: 'M14 8L2 8',
         viewBox: '0 0 16 16',
     },
-    // --- status ---
+    // --- status: a stroked ring around a stroked mark, so the mark shows ---
     'check-circle': {
         name: 'check-circle',
         category: 'status',
-        d: 'M8 1a7 7 0 1 0 0 14A7 7 0 0 0 8 1zM5 8l2 2 4-4',
+        stroke: `${STATUS_RING}M5 8l2 2 4-4`,
         viewBox: '0 0 16 16',
     },
     'x-circle': {
         name: 'x-circle',
         category: 'status',
-        d: 'M8 1a7 7 0 1 0 0 14A7 7 0 0 0 8 1zM5 5l6 6M11 5l-6 6',
+        stroke: `${STATUS_RING}M5 5l6 6M11 5l-6 6`,
         viewBox: '0 0 16 16',
     },
     'alert-circle': {
         name: 'alert-circle',
         category: 'status',
-        d: 'M8 1a7 7 0 1 0 0 14A7 7 0 0 0 8 1zM8 5v4M8 11v1',
+        stroke: `${STATUS_RING}M8 5v4M8 11v1`,
         viewBox: '0 0 16 16',
     },
     info: {
         name: 'info',
         category: 'status',
-        d: 'M8 1a7 7 0 1 0 0 14A7 7 0 0 0 8 1zM8 7v5M8 5v1',
+        stroke: `${STATUS_RING}M8 8v4M8 5v1`,
         viewBox: '0 0 16 16',
     },
     heart: {
         name: 'heart',
         category: 'status',
-        d: 'M8 13S1 9 1 4.5a3.5 3.5 0 0 1 7 0 3.5 3.5 0 0 1 7 0C15 9 8 13 8 13z',
+        fill: 'M8 13S1 9 1 4.5a3.5 3.5 0 0 1 7 0 3.5 3.5 0 0 1 7 0C15 9 8 13 8 13z',
         viewBox: '0 0 16 16',
     },
     star: {
         name: 'star',
         category: 'status',
-        d: 'M8 1l2 5h5l-4 3 1.5 5L8 11l-4.5 3L5 9 1 6h5z',
+        fill: 'M8 1l2 5h5l-4 3 1.5 5L8 11l-4.5 3L5 9 1 6h5z',
         viewBox: '0 0 16 16',
     },
     // --- media ---
     play: {
         name: 'play',
         category: 'media',
-        d: 'M3 2l10 6-10 6z',
+        fill: 'M3 2l10 6-10 6z',
         viewBox: '0 0 16 16',
     },
     pause: {
         name: 'pause',
         category: 'media',
-        d: 'M5 2h2v12H5zM9 2h2v12H9z',
+        fill: 'M5 2h2v12H5zM9 2h2v12H9z',
         viewBox: '0 0 16 16',
     },
     stop: {
         name: 'stop',
         category: 'media',
-        d: 'M3 3h10v10H3z',
+        fill: 'M3 3h10v10H3z',
         viewBox: '0 0 16 16',
     },
     music: {
         name: 'music',
         category: 'media',
-        d: 'M12 2v7a2 2 0 1 1-2-2V2l-6 1v7a2 2 0 1 1-2-2V3z',
+        fill: 'M12 2v7a2 2 0 1 1-2-2V4l-6 1v5a2 2 0 1 1-2-2V3z',
         viewBox: '0 0 16 16',
     },
 };

package/dist/renderer/icons.js.map

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

package/dist/renderer/keyframes.d.ts

@@ -9,14 +9,50 @@ export type KeyframeMap = Record<string, KeyframeEntry[]>;
 /** Effect preset names. */
 export type EffectName = 'float' | 'scroll-left' | 'scroll-right' | 'pulse' | 'blink' | 'twinkle' | 'drift' | 'fade-in' | 'fade-out';
 export declare const EFFECT_NAMES: EffectName[];
-/** Compile a named effect preset into a keyframe map. */
+/**
+ * Compile a named effect preset into a keyframe map.
+ *
+ * `amplitude` is pixels of movement for `float`, `scroll-left`/`scroll-right` (speed), and
+ * `drift`, default 2. For `pulse` and `twinkle` it is the depth of the opacity dip below 100,
+ * on a 0–1 scale: default 0.5 for `pulse` (a 50–100 ramp) and 0.6 for `twinkle` (40–100).
+ * `blink`, `fade-in`, and `fade-out` ignore it.
+ *
+ * `twinkle` jitters each frame's phase by an amount fixed by the frame and `element`, the
+ * element's index in the scene, so the flicker is irregular and differs between elements
+ * while identical scenes render identically.
+ */
 export declare function compileEffect(name: EffectName, opts: {
     amplitude?: number;
     period?: number;
     phase?: number;
-}, totalFrames: number): KeyframeMap;
-/** Interpolate a keyframe property at a given frame index. */
-export declare function interpolateKeyframe(frames: KeyframeEntry[], frameIdx: number): number | string | boolean;
+}, totalFrames: number, element?: number): KeyframeMap;
+/** A keyframe's value. */
+type KeyframeValue = KeyframeEntry[1];
+/**
+ * A number, or a string that reads as one (`"40"`, `"000"`, `"-2.5"`); `undefined` otherwise.
+ * `pixoo_compose_scene` validates `dx`, `dy`, and `opacity` keyframes with it, so the input
+ * schema and the interpolation agree on what a numeric string is.
+ */
+export declare function numericValue(value: KeyframeValue): number | undefined;
+/**
+ * Interpolate a keyframe property at a given frame index. Booleans snap at the midpoint.
+ * Numbers lerp, and so do numeric strings, read as the same numbers — `"000"` is 0 here, never
+ * a color: only the `color` track lerps through RGB, in {@link interpolateColorKeyframe}.
+ * Any other value holds until the next keyframe.
+ */
+export declare function interpolateKeyframe(frames: KeyframeEntry[], frameIdx: number): KeyframeValue;
+/**
+ * Interpolate a `color` keyframe track at a frame index: each keyframe value, number or
+ * string, is read as a color and the track lerps through RGB, returning `#rrggbb` between
+ * keyframes so it resolves like any other color. Every keyframe value is resolved first, so
+ * one that isn't a color fails on every frame — including a keyframe the scene never
+ * reaches, which interpolation alone would skip past by holding the previous color.
+ *
+ * @throws {Error} The toolkit's `Unknown color` error for the first value that isn't a color,
+ *   or an error for an empty track, which input validation rejects before any render.
+ */
+export declare function interpolateColorKeyframe(frames: KeyframeEntry[], frameIdx: number): string;
 /** Get the interpolated value for a named property at a frame index. */
 export declare function getKeyframeValue(keyframes: KeyframeMap | undefined, prop: string, frameIdx: number, defaultValue: number | string | boolean): number | string | boolean;
+export {};
 //# sourceMappingURL=keyframes.d.ts.map

package/dist/renderer/keyframes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/renderer/keyframes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEhE,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAE1D,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,aAAa,GACb,cAAc,GACd,OAAO,GACP,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,CAAC;AAEf,eAAO,MAAM,YAAY,EAAE,UAAU,EAUpC,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,WAAW,EAAE,MAAM,GAClB,WAAW,CAkFb;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,MAAM,GAAG,OAAO,CAmD3B;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,WAAW,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GACtC,MAAM,GAAG,MAAM,GAAG,OAAO,CAG3B"}
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/renderer/keyframes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEhE,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAE1D,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,aAAa,GACb,cAAc,GACd,OAAO,GACP,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,CAAC;AAEf,eAAO,MAAM,YAAY,EAAE,UAAU,EAUpC,CAAC;AAaF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,WAAW,EAAE,MAAM,EACnB,OAAO,SAAI,GACV,WAAW,CAoFb;AAED,0BAA0B;AAC1B,KAAK,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AA4BtC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAKrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAY5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,WAAW,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GACtC,MAAM,GAAG,MAAM,GAAG,OAAO,CAG3B"}

package/dist/renderer/keyframes.js

@@ -2,7 +2,7 @@
  * @fileoverview Keyframe interpolation and effect compiler for animation presets.
  * @module renderer/keyframes
  */
-import { lerpColor, resolveColor } from '@cyanheads/pixoo-toolkit';
+import { lerpColor, resolveColor, rgbToHex } from '@cyanheads/pixoo-toolkit';
 export const EFFECT_NAMES = [
     'float',
     'scroll-left',
@@ -14,8 +14,29 @@ export const EFFECT_NAMES = [
     'fade-in',
     'fade-out',
 ];
-/** Compile a named effect preset into a keyframe map. */
-export function compileEffect(name, opts, totalFrames) {
+/**
+ * A fixed value in [0, 1) for one frame of one element: a 32-bit integer hash of the pair,
+ * so a render repeats exactly while neighbouring frames and elements still land far apart.
+ */
+function flicker(frame, element) {
+    let h = Math.imul(frame, 0x9e3779b1) ^ Math.imul(element + 1, 0x85ebca6b);
+    h = Math.imul(h ^ (h >>> 16), 0x7feb352d);
+    h = Math.imul(h ^ (h >>> 15), 0x846ca68b);
+    return ((h ^ (h >>> 16)) >>> 0) / 2 ** 32;
+}
+/**
+ * Compile a named effect preset into a keyframe map.
+ *
+ * `amplitude` is pixels of movement for `float`, `scroll-left`/`scroll-right` (speed), and
+ * `drift`, default 2. For `pulse` and `twinkle` it is the depth of the opacity dip below 100,
+ * on a 0–1 scale: default 0.5 for `pulse` (a 50–100 ramp) and 0.6 for `twinkle` (40–100).
+ * `blink`, `fade-in`, and `fade-out` ignore it.
+ *
+ * `twinkle` jitters each frame's phase by an amount fixed by the frame and `element`, the
+ * element's index in the scene, so the flicker is irregular and differs between elements
+ * while identical scenes render identically.
+ */
+export function compileEffect(name, opts, totalFrames, element = 0) {
     const amp = opts.amplitude ?? 2;
     const period = opts.period ?? totalFrames;
     const phase = opts.phase ?? 0;
@@ -45,12 +66,12 @@ export function compileEffect(name, opts, totalFrames) {
             return { dx: frames };
         }
         case 'pulse': {
+            const depth = (opts.amplitude ?? 0.5) * 100;
             const frames = [];
             for (let i = 0; i < totalFrames; i++) {
                 const t = (i / period + phase) * 2 * Math.PI;
                 const brightness = 0.5 + 0.5 * Math.sin(t);
-                // Encode brightness as opacity 50–100
-                frames.push([i, Math.round(50 + 50 * brightness)]);
+                frames.push([i, Math.round(100 - depth + depth * brightness)]);
             }
             return { opacity: frames };
         }
@@ -63,10 +84,12 @@ export function compileEffect(name, opts, totalFrames) {
             return { visible: frames };
         }
         case 'twinkle': {
+            const depth = (opts.amplitude ?? 0.6) * 100;
             const frames = [];
             for (let i = 0; i < totalFrames; i++) {
                 const t = (i / period + phase) * 2 * Math.PI;
-                frames.push([i, Math.round(40 + 60 * (0.5 + 0.5 * Math.sin(t + Math.random() * 0.3)))]);
+                const brightness = 0.5 + 0.5 * Math.sin(t + flicker(i, element) * 0.3);
+                frames.push([i, Math.round(100 - depth + depth * brightness)]);
             }
             return { opacity: frames };
         }
@@ -97,59 +120,83 @@ export function compileEffect(name, opts, totalFrames) {
             return {};
     }
 }
-/** Interpolate a keyframe property at a given frame index. */
-export function interpolateKeyframe(frames, frameIdx) {
-    if (frames.length === 0)
-        return 0;
+/**
+ * The keyframes around `frameIdx` and how far between them it falls: `t` runs from 0 on
+ * `from`'s frame to 1 on `to`'s. Before the first keyframe or past the last, that keyframe's
+ * value is held: `from` and `to` are both it and `t` is 0. `undefined` for an empty track.
+ */
+function keyframeSpan(frames, frameIdx) {
     const first = frames[0];
-    const last = frames[frames.length - 1];
+    const last = frames.at(-1);
     if (!first || !last)
-        return 0;
+        return;
     if (frameIdx <= first[0])
-        return first[1];
-    if (frameIdx >= last[0])
-        return last[1];
-    // Find surrounding keyframes
-    let lo = 0;
-    let hi = frames.length - 1;
-    for (let i = 0; i < frames.length - 1; i++) {
-        const a = frames[i];
-        const b = frames[i + 1];
-        if (a && b && a[0] <= frameIdx && b[0] >= frameIdx) {
-            lo = i;
-            hi = i + 1;
-            break;
+        return { from: first[1], to: first[1], t: 0 };
+    if (frameIdx < last[0]) {
+        let before = first;
+        for (const keyframe of frames) {
+            if (keyframe[0] >= frameIdx) {
+                const t = (frameIdx - before[0]) / (keyframe[0] - before[0]);
+                return { from: before[1], to: keyframe[1], t };
+            }
+            before = keyframe;
         }
     }
-    const loEntry = frames[lo];
-    const hiEntry = frames[hi];
-    if (!loEntry || !hiEntry)
+    return { from: last[1], to: last[1], t: 0 };
+}
+/**
+ * A number, or a string that reads as one (`"40"`, `"000"`, `"-2.5"`); `undefined` otherwise.
+ * `pixoo_compose_scene` validates `dx`, `dy`, and `opacity` keyframes with it, so the input
+ * schema and the interpolation agree on what a numeric string is.
+ */
+export function numericValue(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value !== 'string' || value.trim() === '')
+        return;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : undefined;
+}
+/**
+ * Interpolate a keyframe property at a given frame index. Booleans snap at the midpoint.
+ * Numbers lerp, and so do numeric strings, read as the same numbers — `"000"` is 0 here, never
+ * a color: only the `color` track lerps through RGB, in {@link interpolateColorKeyframe}.
+ * Any other value holds until the next keyframe.
+ */
+export function interpolateKeyframe(frames, frameIdx) {
+    const span = keyframeSpan(frames, frameIdx);
+    if (!span)
         return 0;
-    const [f0, v0] = loEntry;
-    const [f1, v1] = hiEntry;
-    if (f0 === f1)
-        return v0;
-    const t = (frameIdx - f0) / (f1 - f0);
-    // Boolean: snap at midpoint
-    if (typeof v0 === 'boolean')
-        return t < 0.5 ? v0 : v1;
-    // Number: lerp
-    if (typeof v0 === 'number' && typeof v1 === 'number') {
-        return v0 + (v1 - v0) * t;
-    }
-    // Color string: lerp through RGB
-    if (typeof v0 === 'string' && typeof v1 === 'string') {
-        try {
-            const c0 = resolveColor(v0);
-            const c1 = resolveColor(v1);
-            const lerped = lerpColor(c0, c1, t);
-            return `rgb(${lerped[0]},${lerped[1]},${lerped[2]})`;
-        }
-        catch {
-            return v0;
-        }
-    }
-    return v0;
+    const { from, to, t } = span;
+    if (typeof from === 'boolean')
+        return t < 0.5 ? from : to;
+    const n0 = numericValue(from);
+    const n1 = numericValue(to);
+    if (n0 !== undefined && n1 !== undefined)
+        return n0 + (n1 - n0) * t;
+    return from;
+}
+/**
+ * Interpolate a `color` keyframe track at a frame index: each keyframe value, number or
+ * string, is read as a color and the track lerps through RGB, returning `#rrggbb` between
+ * keyframes so it resolves like any other color. Every keyframe value is resolved first, so
+ * one that isn't a color fails on every frame — including a keyframe the scene never
+ * reaches, which interpolation alone would skip past by holding the previous color.
+ *
+ * @throws {Error} The toolkit's `Unknown color` error for the first value that isn't a color,
+ *   or an error for an empty track, which input validation rejects before any render.
+ */
+export function interpolateColorKeyframe(frames, frameIdx) {
+    for (const [, value] of frames)
+        resolveColor(String(value));
+    const span = keyframeSpan(frames, frameIdx);
+    if (!span)
+        throw new Error('A color keyframe track needs at least one keyframe.');
+    const { from, to, t } = span;
+    if (t === 0)
+        return String(from);
+    const lerped = lerpColor(resolveColor(String(from)), resolveColor(String(to)), t);
+    return `#${rgbToHex(lerped).toString(16).padStart(6, '0')}`;
 }
 /** Get the interpolated value for a named property at a frame index. */
 export function getKeyframeValue(keyframes, prop, frameIdx, defaultValue) {

package/dist/renderer/keyframes.js.map

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

package/dist/renderer/remote-image.d.ts

@@ -1,15 +1,16 @@
 /**
- * @fileoverview Remote image fetch — downloads an https image to a temp PNG for the
- * toolkit's `loadImage`, which reads from disk only. Shared by the scene renderer's
- * image elements and the pixoo_push_image tool.
+ * @fileoverview Remote image fetch — downloads an https image's encoded bytes into
+ * memory for the toolkit's image loaders. Shared by the scene renderer's image elements
+ * and the pixoo_push_image tool.
  * @module renderer/remote-image
  */
 import type { Context } from '@cyanheads/mcp-ts-core';
 /** True when the string is a URL rather than a local filesystem path. */
 export declare function isRemoteSource(source: string): boolean;
 /**
- * Fetch an https image and write it to a temp PNG, returning the path. The caller
- * owns the file and must unlink it once `loadImage` has read it.
+ * Fetch an https image and return its bytes as served, undecoded. Nothing is written to
+ * disk: the caller passes the bytes to the toolkit's loader, where a body that is not an image
+ * fails to decode.
  *
  * Private and loopback addresses are deliberately reachable: this server drives a
  * LAN device, so a NAS or local web server is a legitimate image host.
@@ -18,8 +19,13 @@ export declare function isRemoteSource(source: string): boolean;
  * down instead of reading on to the deadline or the byte cap.
  *
  * @throws {McpError} NotFound with `reason: 'asset_not_found'` for a non-https URL,
- *   an unreachable or non-2xx endpoint, or a response over {@link MAX_IMAGE_BYTES}.
+ *   an unreachable or non-2xx endpoint, or a response over {@link MAX_IMAGE_BYTES}. The
+ *   message names the failure; the recovery is the calling tool's declared one.
  * @throws {McpError} RequestCancelled when `ctx.signal` aborts while the body streams.
+ * @throws {McpError} Timeout when the body outlasts {@link FETCH_TIMEOUT_MS}, or when the
+ *   `ctx.signal` abort is a caller-side deadline (a `TimeoutError` reason). A tool handler
+ *   still answers the deadline as RequestCancelled: the handler factory settles any throw
+ *   after the request's signal fired as a cancellation.
  */
-export declare function fetchRemoteImageToTempPng(source: string, ctx: Context): Promise<string>;
+export declare function fetchRemoteImageBytes(source: string, ctx: Context): Promise<Uint8Array>;
 //# sourceMappingURL=remote-image.d.ts.map