@pinepaper.studio/mcp-server 1.6.18 → 1.6.20

package/dist/tools/effect-check.d.ts

@@ -0,0 +1,26 @@
+/**
+ * NO SILENT SUCCESS, the runtime half. A call classed 'mutates'
+ * (effect-class.ts) is fingerprinted before and after; a success that changed
+ * nothing measurable is FLAGGED in the result text the model reads, and a
+ * result that names an item not on the canvas FAILS.
+ *
+ * Flag, not fail: an idempotent call (a background set to the colour it
+ * already is) rightly changes nothing, and refusing it would be the mirror of
+ * the bug this hunts. A named item that does not exist is no such case — it
+ * is a contradiction (add_marker's invented 'marker_added').
+ *
+ * The fingerprint is the AUTHORED scene — items' data, un-animated style and
+ * placement, relations, background, canvas, map colours, placed sounds — kept
+ * IN THE PAGE between the two probes; only the verdict crosses the wire. It
+ * was the engine's full snapshot until the first live sweep: that carries the
+ * playhead and live transforms, so during playback every no-op looked changed.
+ */
+export declare const EFFECT_BEFORE_JS = "(function () {\n  function __ppFingerprint() {\n  // AUTHORED state, not the live frame. The engine's full snapshot carries the\n  // playhead and every item's CURRENT transform, so while the timeline plays\n  // every call looked changed \u2014 the three misses of the first live sweep\n  // (re-applied colour, same canvas size, a repeated highlight). Animated\n  // values are left out; what a call can author is kept.\n  const o = {};\n  const playing = !!app.isPlayingKeyframes;\n  const plain = function (k, v) {\n    if (typeof k === 'string' && (k.charAt(0) === '_' || /^(selected|hovered|isHovered|cached|lastRender|renderTick|frame|playbackTime|time)$/.test(k))) return undefined;\n    if (typeof v === 'function') return undefined;\n    if (v && typeof v === 'object' && (v.data instanceof Uint8ClampedArray || (typeof ImageData !== 'undefined' && v instanceof ImageData))) return undefined;\n    if (v && typeof v === 'object' && typeof v.toCSS === 'function') return v.toCSS(true);\n    return v;\n  };\n  const S = function (v) { try { return JSON.stringify(v, plain); } catch (e) { return ''; } };\n  try {\n    const reg = app.itemRegistry && app.itemRegistry.getAll ? app.itemRegistry.getAll() : null;\n    if (reg) {\n      o.items = reg.map(function (e) {\n        const it = e.item || {};\n        const d = it.data || {};\n        const keys = Array.isArray(d.keyframes) ? d.keyframes : [];\n        const animated = {};\n        keys.forEach(function (k) { Object.keys((k && k.properties) || {}).forEach(function (p) { animated[p] = 1; }); });\n        const moves = keys.length || (d.animationType && d.animationType !== 'none');\n        const style = {};\n        ['fillColor', 'strokeColor', 'strokeWidth', 'opacity', 'fontSize', 'fontFamily', 'content', 'visible', 'blendMode'].forEach(function (p) {\n          if (!animated[p] && !(p === 'fillColor' && animated.color) && it[p] !== undefined) style[p] = plain(p, it[p]);\n        });\n        if (!moves && it.position) style.at = [Math.round(it.position.x), Math.round(it.position.y)];\n        if (!moves && it.scaling) style.scale = [Math.round(it.scaling.x * 1000), Math.round(it.scaling.y * 1000)];\n        if (!moves && typeof it.rotation === 'number') style.rot = Math.round(it.rotation * 100);\n        return (e.id || e.itemId) + '|' + (e.type || '') + '|' + S(d) + '|' + S(style);\n      }).join('\\n');\n    }\n  } catch (e) {}\n  try { const rr = app.relationRegistry; if (rr && rr.exportForSave) o.relations = S(rr.exportForSave()); } catch (e) {}\n  try { if (app.listRenderHooks) o.renderHooks = S(app.listRenderHooks()); } catch (e) {}\n  // SCENE-LEVEL STATE OUTSIDE ITEMS (sweep v2: add_filter and camera_animate\n  // were real changes read as none). The camera's track is a relation on the\n  // pseudo-source 'camera', which no registry item carries.\n  try { if (app.filterSystem && app.filterSystem.exportForSave) o.filters = S(app.filterSystem.exportForSave()); } catch (e) {}\n  try {\n    // Camera keyframes live in relationRegistry._cameraAnimation.params (a\n    // virtual item, no registry entry), read through getCameraAnimationParams.\n    // getRelations('camera') looks in the associations and is always empty\n    // for them (sweep v3: camera_animate still read as no change).\n    const rr = app.relationRegistry;\n    const cam = rr && rr.getCameraAnimationParams ? rr.getCameraAnimationParams() : null;\n    const tilt = rr && rr.cameraTilt;\n    o.camera = S([cam, tilt && tilt.serialize ? tilt.serialize() : null]);\n  } catch (e) {}\n  try { const c = app.config || {}; o.background = S([c.currentBackgroundMode, c.currentBackgroundGenerator, c.generatorParams, app.canvasEl && app.canvasEl.style && app.canvasEl.style.backgroundColor]); } catch (e) {}\n  try { const cs = app.getCanvasSize && app.getCanvasSize(); if (cs) o.canvas = cs.width + 'x' + cs.height + (cs.unbounded ? ':unbounded' : ''); } catch (e) {}\n  try {\n    // The view moves on its own while a camera animation plays.\n    const v = app.view || (typeof paper !== 'undefined' && paper.view);\n    if (!playing && v && v.center) o.view = Math.round(v.zoom * 1000) + '@' + Math.round(v.center.x) + ',' + Math.round(v.center.y);\n  } catch (e) {}\n  try { if (app.mapSystem && app.mapSystem.getRegionOverrideCount) o.mapColours = app.mapSystem.getRegionOverrideCount() + ':' + S(app.mapSystem._regionColorOverrides ? Array.from(app.mapSystem._regionColorOverrides.entries()) : null); } catch (e) {}\n  try { if (app._initialized && app._initialized.has('synthSounds')) o.sounds = S(app.synthSounds.list().map(function (x) { return [x.id, x.startTime, x.duration]; })); } catch (e) {}\n  return o;\n}\n  window.__ppEffectBefore = __ppFingerprint();\n  return { ok: true };\n})();";
+/** After-probe: compares against the before fingerprint; checks the named ids exist. */
+export declare function effectAfterJs(ids: string[]): string;
+/** The item ids a result names as made or touched (itemId, itemIds, ids). */
+export declare function namedItemIds(result: unknown): string[];
+/** Calls whose returned id is legitimately gone afterwards. */
+export declare function idMayBeGone(tool: string, action: string | undefined): boolean;
+export declare const NO_CHANGE_NOTE: (checked: string[]) => string;
+//# sourceMappingURL=effect-check.d.ts.map

package/dist/tools/effect-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-check.d.ts","sourceRoot":"","sources":["../../src/tools/effect-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAoEH,eAAO,MAAM,gBAAgB,qqJAIvB,CAAC;AAEP,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBnD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAQtD;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE7E;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,WAGuC,CAAC"}

package/dist/tools/effect-check.js

@@ -0,0 +1,129 @@
+/**
+ * NO SILENT SUCCESS, the runtime half. A call classed 'mutates'
+ * (effect-class.ts) is fingerprinted before and after; a success that changed
+ * nothing measurable is FLAGGED in the result text the model reads, and a
+ * result that names an item not on the canvas FAILS.
+ *
+ * Flag, not fail: an idempotent call (a background set to the colour it
+ * already is) rightly changes nothing, and refusing it would be the mirror of
+ * the bug this hunts. A named item that does not exist is no such case — it
+ * is a contradiction (add_marker's invented 'marker_added').
+ *
+ * The fingerprint is the AUTHORED scene — items' data, un-animated style and
+ * placement, relations, background, canvas, map colours, placed sounds — kept
+ * IN THE PAGE between the two probes; only the verdict crosses the wire. It
+ * was the engine's full snapshot until the first live sweep: that carries the
+ * playhead and live transforms, so during playback every no-op looked changed.
+ */
+/** In-page fingerprint, shared by both probes. */
+const FINGERPRINT_JS = `function __ppFingerprint() {
+  // AUTHORED state, not the live frame. The engine's full snapshot carries the
+  // playhead and every item's CURRENT transform, so while the timeline plays
+  // every call looked changed — the three misses of the first live sweep
+  // (re-applied colour, same canvas size, a repeated highlight). Animated
+  // values are left out; what a call can author is kept.
+  const o = {};
+  const playing = !!app.isPlayingKeyframes;
+  const plain = function (k, v) {
+    if (typeof k === 'string' && (k.charAt(0) === '_' || /^(selected|hovered|isHovered|cached|lastRender|renderTick|frame|playbackTime|time)$/.test(k))) return undefined;
+    if (typeof v === 'function') return undefined;
+    if (v && typeof v === 'object' && (v.data instanceof Uint8ClampedArray || (typeof ImageData !== 'undefined' && v instanceof ImageData))) return undefined;
+    if (v && typeof v === 'object' && typeof v.toCSS === 'function') return v.toCSS(true);
+    return v;
+  };
+  const S = function (v) { try { return JSON.stringify(v, plain); } catch (e) { return ''; } };
+  try {
+    const reg = app.itemRegistry && app.itemRegistry.getAll ? app.itemRegistry.getAll() : null;
+    if (reg) {
+      o.items = reg.map(function (e) {
+        const it = e.item || {};
+        const d = it.data || {};
+        const keys = Array.isArray(d.keyframes) ? d.keyframes : [];
+        const animated = {};
+        keys.forEach(function (k) { Object.keys((k && k.properties) || {}).forEach(function (p) { animated[p] = 1; }); });
+        const moves = keys.length || (d.animationType && d.animationType !== 'none');
+        const style = {};
+        ['fillColor', 'strokeColor', 'strokeWidth', 'opacity', 'fontSize', 'fontFamily', 'content', 'visible', 'blendMode'].forEach(function (p) {
+          if (!animated[p] && !(p === 'fillColor' && animated.color) && it[p] !== undefined) style[p] = plain(p, it[p]);
+        });
+        if (!moves && it.position) style.at = [Math.round(it.position.x), Math.round(it.position.y)];
+        if (!moves && it.scaling) style.scale = [Math.round(it.scaling.x * 1000), Math.round(it.scaling.y * 1000)];
+        if (!moves && typeof it.rotation === 'number') style.rot = Math.round(it.rotation * 100);
+        return (e.id || e.itemId) + '|' + (e.type || '') + '|' + S(d) + '|' + S(style);
+      }).join('\\n');
+    }
+  } catch (e) {}
+  try { const rr = app.relationRegistry; if (rr && rr.exportForSave) o.relations = S(rr.exportForSave()); } catch (e) {}
+  try { if (app.listRenderHooks) o.renderHooks = S(app.listRenderHooks()); } catch (e) {}
+  // SCENE-LEVEL STATE OUTSIDE ITEMS (sweep v2: add_filter and camera_animate
+  // were real changes read as none). The camera's track is a relation on the
+  // pseudo-source 'camera', which no registry item carries.
+  try { if (app.filterSystem && app.filterSystem.exportForSave) o.filters = S(app.filterSystem.exportForSave()); } catch (e) {}
+  try {
+    // Camera keyframes live in relationRegistry._cameraAnimation.params (a
+    // virtual item, no registry entry), read through getCameraAnimationParams.
+    // getRelations('camera') looks in the associations and is always empty
+    // for them (sweep v3: camera_animate still read as no change).
+    const rr = app.relationRegistry;
+    const cam = rr && rr.getCameraAnimationParams ? rr.getCameraAnimationParams() : null;
+    const tilt = rr && rr.cameraTilt;
+    o.camera = S([cam, tilt && tilt.serialize ? tilt.serialize() : null]);
+  } catch (e) {}
+  try { const c = app.config || {}; o.background = S([c.currentBackgroundMode, c.currentBackgroundGenerator, c.generatorParams, app.canvasEl && app.canvasEl.style && app.canvasEl.style.backgroundColor]); } catch (e) {}
+  try { const cs = app.getCanvasSize && app.getCanvasSize(); if (cs) o.canvas = cs.width + 'x' + cs.height + (cs.unbounded ? ':unbounded' : ''); } catch (e) {}
+  try {
+    // The view moves on its own while a camera animation plays.
+    const v = app.view || (typeof paper !== 'undefined' && paper.view);
+    if (!playing && v && v.center) o.view = Math.round(v.zoom * 1000) + '@' + Math.round(v.center.x) + ',' + Math.round(v.center.y);
+  } catch (e) {}
+  try { if (app.mapSystem && app.mapSystem.getRegionOverrideCount) o.mapColours = app.mapSystem.getRegionOverrideCount() + ':' + S(app.mapSystem._regionColorOverrides ? Array.from(app.mapSystem._regionColorOverrides.entries()) : null); } catch (e) {}
+  try { if (app._initialized && app._initialized.has('synthSounds')) o.sounds = S(app.synthSounds.list().map(function (x) { return [x.id, x.startTime, x.duration]; })); } catch (e) {}
+  return o;
+}`;
+export const EFFECT_BEFORE_JS = `(function () {
+  ${FINGERPRINT_JS}
+  window.__ppEffectBefore = __ppFingerprint();
+  return { ok: true };
+})();`;
+/** After-probe: compares against the before fingerprint; checks the named ids exist. */
+export function effectAfterJs(ids) {
+    return `(function () {
+  ${FINGERPRINT_JS}
+  const a = window.__ppEffectBefore || null;
+  const b = __ppFingerprint();
+  window.__ppEffectBefore = null;
+  const checked = Object.keys(b);
+  const changed = a ? checked.filter(function (k) { return a[k] !== b[k]; }) : null;
+  const ids = ${JSON.stringify(ids)};
+  const missing = ids.filter(function (id) {
+    try {
+      if (app.getItemById && app.getItemById(id)) return false;
+      if (app.itemRegistry && app.itemRegistry.get && app.itemRegistry.get(id)) return false;
+    } catch (e) {}
+    return true;
+  });
+  return { ok: !!a, checked: checked, changed: changed, missing: missing };
+})();`;
+}
+/** The item ids a result names as made or touched (itemId, itemIds, ids). */
+export function namedItemIds(result) {
+    if (!result || typeof result !== 'object')
+        return [];
+    const r = result;
+    const out = [];
+    const add = (v) => { if (typeof v === 'string' && /^item_\d+$/.test(v))
+        out.push(v); };
+    add(r.itemId);
+    for (const k of ['itemIds', 'ids'])
+        if (Array.isArray(r[k]))
+            r[k].forEach(add);
+    return [...new Set(out)].slice(0, 50);
+}
+/** Calls whose returned id is legitimately gone afterwards. */
+export function idMayBeGone(tool, action) {
+    return /delete|remove|clear|ungroup|break_apart|unhighlight/.test(`${tool}:${action ?? ''}`);
+}
+export const NO_CHANGE_NOTE = (checked) => `⚠️ NO CHANGE: this call reported success, but nothing it could have changed did (checked: ${checked.join(', ')}). `
+    + 'If you expected a change, it did not happen — check the ids and arguments before building on it. '
+    + '(Re-applying a value an item already has is the one case where this is expected.)';
+//# sourceMappingURL=effect-check.js.map

package/dist/tools/effect-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-check.js","sourceRoot":"","sources":["../../src/tools/effect-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kDAAkD;AAClD,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+DrB,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,cAAc;;;MAGZ,CAAC;AAEP,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,GAAa;IACzC,OAAO;IACL,cAAc;;;;;;gBAMF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;;;;;;;;;MAS7B,CAAC;AACP,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAAG,CAAC,CAAC,CAAC,CAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAA0B;IAClE,OAAO,qDAAqD,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAiB,EAAE,EAAE,CAClD,6FAA6F,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;MAClH,mGAAmG;MACnG,mFAAmF,CAAC"}

package/dist/tools/effect-class.d.ts

@@ -0,0 +1,31 @@
+/**
+ * NO SILENT SUCCESS, the classification half (tracker: handler-layer sweep).
+ *
+ * Every tool, and every action of an action-dispatched tool, is one of:
+ * - 'mutates'     it exists to change the scene. A success that changed
+ *                 nothing measurable is flagged (the runtime half).
+ * - 'read-only'   it reads; it must not change the scene.
+ * - 'side-effect' its effect is outside the scene: a file, playback, a sound
+ *                 heard now, UI state (selection, rulers, modes), the server.
+ * - 'unchecked'   it changes state the scene fingerprint cannot see (the 3D
+ *                 world, physics bodies, the font studio, rig internals,
+ *                 registries of definitions), or it only sometimes changes the
+ *                 scene. Named here as a blind spot rather than guessed at,
+ *                 because a false "nothing changed" teaches a model to ignore
+ *                 the flag.
+ *
+ * The class behind D59, D37, D62 and the audioTracks drop: a handler that
+ * reported success for work the engine did not do.
+ */
+export type EffectClass = 'mutates' | 'read-only' | 'side-effect' | 'unchecked';
+/** Tools with no action enum and no readOnlyHint: each is named, so a new one fails the test until it is. */
+export declare const TOOL_CLASS: Readonly<Record<string, EffectClass>>;
+/** Whole action-dispatched tools whose state the fingerprint cannot see. */
+export declare const UNCHECKED_TOOLS: ReadonlySet<string>;
+/** Whole action-dispatched tools that only touch UI or session state. */
+export declare const SIDE_EFFECT_TOOLS: ReadonlySet<string>;
+/** Per-action exceptions to the prefix rules, `tool:action`. */
+export declare const ACTION_CLASS: Readonly<Record<string, EffectClass>>;
+/** The class of one call. `readOnlyHint` comes from the tool's annotations. */
+export declare function effectClass(tool: string, action: string | undefined, readOnlyHint: boolean | undefined): EffectClass;
+//# sourceMappingURL=effect-class.d.ts.map

package/dist/tools/effect-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-class.d.ts","sourceRoot":"","sources":["../../src/tools/effect-class.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;AAEhF,6GAA6G;AAC7G,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuE3D,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAK9C,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAGhD,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAsC7D,CAAC;AAKH,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAapH"}

package/dist/tools/effect-class.js

@@ -0,0 +1,170 @@
+/**
+ * NO SILENT SUCCESS, the classification half (tracker: handler-layer sweep).
+ *
+ * Every tool, and every action of an action-dispatched tool, is one of:
+ * - 'mutates'     it exists to change the scene. A success that changed
+ *                 nothing measurable is flagged (the runtime half).
+ * - 'read-only'   it reads; it must not change the scene.
+ * - 'side-effect' its effect is outside the scene: a file, playback, a sound
+ *                 heard now, UI state (selection, rulers, modes), the server.
+ * - 'unchecked'   it changes state the scene fingerprint cannot see (the 3D
+ *                 world, physics bodies, the font studio, rig internals,
+ *                 registries of definitions), or it only sometimes changes the
+ *                 scene. Named here as a blind spot rather than guessed at,
+ *                 because a false "nothing changed" teaches a model to ignore
+ *                 the flag.
+ *
+ * The class behind D59, D37, D62 and the audioTracks drop: a handler that
+ * reported success for work the engine did not do.
+ */
+/** Tools with no action enum and no readOnlyHint: each is named, so a new one fails the test until it is. */
+export const TOOL_CLASS = Object.freeze({
+    pinepaper_set_background_color: 'mutates',
+    pinepaper_set_canvas_size: 'mutates',
+    pinepaper_clear_canvas: 'mutates',
+    pinepaper_refresh_page: 'side-effect',
+    pinepaper_create_item: 'mutates',
+    pinepaper_modify_item: 'mutates',
+    pinepaper_delete_item: 'mutates',
+    pinepaper_create_glossy_sphere: 'mutates',
+    pinepaper_create_diagonal_stripes: 'mutates',
+    pinepaper_import_motion_capture: 'unchecked', // rig internals
+    pinepaper_import_svg: 'mutates',
+    pinepaper_import_mermaid: 'mutates',
+    pinepaper_import_image: 'mutates',
+    pinepaper_import_asset: 'mutates',
+    pinepaper_batch_create: 'mutates',
+    pinepaper_batch_modify: 'mutates',
+    pinepaper_create_grid: 'mutates',
+    pinepaper_geometry: 'unchecked', // creates an item only when asked
+    pinepaper_equation_path: 'mutates',
+    pinepaper_beat_cuts: 'unchecked', // splits a clip only when asked
+    pinepaper_generate: 'unchecked', // cloud job; places when it finishes
+    pinepaper_generate_status: 'unchecked',
+    pinepaper_render_batch: 'side-effect', // exports per row
+    pinepaper_detect_objects: 'unchecked', // nodes only with asNodes
+    pinepaper_extract_object: 'mutates',
+    pinepaper_capture_frames: 'side-effect',
+    pinepaper_crop_image: 'mutates',
+    pinepaper_chroma_key: 'mutates',
+    pinepaper_shatter_image: 'mutates',
+    pinepaper_import_layered_character: 'mutates',
+    pinepaper_character: 'mutates',
+    pinepaper_instantiate_ontology: 'mutates',
+    pinepaper_add_relation: 'mutates',
+    pinepaper_remove_relation: 'mutates',
+    pinepaper_register_custom_relation: 'unchecked', // a definition, not the scene
+    pinepaper_execute_custom_code: 'unchecked', // may only read; has its own rollback
+    pinepaper_animate: 'mutates',
+    pinepaper_keyframe_animate: 'mutates',
+    pinepaper_apply_animated_mask: 'mutates',
+    pinepaper_apply_custom_mask: 'mutates',
+    pinepaper_remove_mask: 'mutates',
+    pinepaper_camera_animate: 'mutates',
+    pinepaper_create_scene: 'mutates',
+    pinepaper_apply_template: 'mutates',
+    pinepaper_create_diagram_shape: 'mutates',
+    pinepaper_connect: 'mutates',
+    pinepaper_connect_ports: 'mutates',
+    pinepaper_add_ports: 'mutates',
+    pinepaper_auto_layout: 'mutates',
+    pinepaper_update_connector: 'mutates',
+    pinepaper_remove_connector: 'mutates',
+    pinepaper_create_letter_collage: 'mutates',
+    pinepaper_animate_letter_collage: 'mutates',
+    pinepaper_execute_generator: 'mutates',
+    pinepaper_apply_effect: 'mutates',
+    pinepaper_add_filter: 'mutates',
+    pinepaper_styled_scene: 'mutates',
+    pinepaper_choreograph: 'mutates',
+    pinepaper_morph_sequence: 'mutates',
+    pinepaper_place_on_surface: 'mutates',
+    pinepaper_import_scene: 'mutates',
+    pinepaper_browser_connect: 'side-effect',
+    pinepaper_browser_disconnect: 'side-effect',
+    pinepaper_agent_start_job: 'side-effect', // clearing an empty canvas changes nothing, rightly
+    pinepaper_agent_end_job: 'side-effect',
+    pinepaper_agent_reset: 'side-effect',
+    pinepaper_agent_batch_execute: 'mutates',
+    pinepaper_p5_draw: 'mutates',
+    pinepaper_register_item: 'mutates',
+    pinepaper_set_toolkit: 'side-effect',
+});
+/** Whole action-dispatched tools whose state the fingerprint cannot see. */
+export const UNCHECKED_TOOLS = new Set([
+    'pinepaper_world3d', 'pinepaper_rigging', 'pinepaper_globe', 'pinepaper_physics',
+    'pinepaper_font', 'pinepaper_interaction', 'pinepaper_sprite_sheet', 'pinepaper_game',
+    'pinepaper_relight', 'pinepaper_shader_graph', 'pinepaper_component', 'pinepaper_comment',
+    'pinepaper_template_params', 'pinepaper_design_system', 'pinepaper_motion', 'pinepaper_magic',
+]);
+/** Whole action-dispatched tools that only touch UI or session state. */
+export const SIDE_EFFECT_TOOLS = new Set([
+    'pinepaper_selection', 'pinepaper_measurement', 'pinepaper_diagram_mode', 'pinepaper_play_timeline',
+    'pinepaper_scene_playback', 'pinepaper_export_store',
+]);
+/** Per-action exceptions to the prefix rules, `tool:action`. */
+export const ACTION_CLASS = Object.freeze({
+    'pinepaper_provenance:record': 'unchecked',
+    'pinepaper_event:pulse': 'side-effect',
+    'pinepaper_lasso:activate': 'side-effect',
+    'pinepaper_sound:define_instrument': 'unchecked',
+    'pinepaper_sound:define_percussion': 'unchecked',
+    'pinepaper_sound:define_sfx': 'unchecked',
+    'pinepaper_story:distill': 'read-only',
+    'pinepaper_story:plan_book': 'read-only',
+    'pinepaper_brand_kit:plan': 'read-only',
+    'pinepaper_brand_kit:from_url': 'read-only',
+    'pinepaper_brand_kit:clear': 'side-effect', // page state; the canvas keeps its colours
+    'pinepaper_audio_beats:analyze': 'read-only',
+    'pinepaper_compose:apply': 'mutates',
+    'pinepaper_camera:state': 'read-only',
+    'pinepaper_camera:fit_view': 'side-effect',
+    'pinepaper_camera:stop': 'side-effect',
+    'pinepaper_media:upload_video': 'mutates',
+    'pinepaper_manage_scenes:save': 'side-effect',
+    'pinepaper_manage_scenes:rename': 'side-effect',
+    'pinepaper_manage_scenes:duplicate': 'side-effect',
+    'pinepaper_manage_scenes:reorder': 'side-effect',
+    'pinepaper_manage_scenes:delete': 'side-effect',
+    'pinepaper_manage_scenes:import': 'side-effect',
+    'pinepaper_history:get_state': 'read-only',
+    'pinepaper_artboard:list_presets': 'read-only',
+    'pinepaper_image_filter:analyze_palette': 'read-only',
+    'pinepaper_map_regions:get_at_point': 'read-only',
+    'pinepaper_map_regions:get_highlighted': 'read-only',
+    'pinepaper_map_regions:select': 'side-effect',
+    'pinepaper_map_regions:deselect': 'side-effect',
+    'pinepaper_construction_sequence:clear': 'mutates',
+    'pinepaper_original_character:bases': 'read-only',
+    'pinepaper_look:grid': 'side-effect', // renders a contact sheet; the scene is left as it was
+    'pinepaper_original_character:random': 'read-only', // computes a variant; draws nothing
+    'pinepaper_flip:record': 'side-effect', // snapshots the before-state only
+    'pinepaper_path:set_locked': 'unchecked', // a lock flag the fingerprint does not read
+    'pinepaper_path:unlock_all': 'unchecked',
+});
+const READ_ONLY_ACTION = /^(list|get|describe|query|analyze|validate|check|resolve|catalogue|status|state|info|preview|estimate|lint|coverage|find|choose|node_types|from_text|chord_frequencies|timbre_from_path|lineage|dependents|history|version|hit_test|is_empty|source_info)(_|$)/;
+const SIDE_EFFECT_ACTION = /^(play|stop|pause|resume|seek|export|render|download|show_studio|toggle_loop|jump|set_time_scale|set_progress|bind_scroll|unbind_scroll)(_|$)/;
+/** The class of one call. `readOnlyHint` comes from the tool's annotations. */
+export function effectClass(tool, action, readOnlyHint) {
+    if (action !== undefined) {
+        const exact = ACTION_CLASS[`${tool}:${action}`];
+        if (exact)
+            return exact;
+    }
+    if (readOnlyHint)
+        return 'read-only';
+    if (TOOL_CLASS[tool])
+        return TOOL_CLASS[tool];
+    if (UNCHECKED_TOOLS.has(tool))
+        return 'unchecked';
+    if (SIDE_EFFECT_TOOLS.has(tool))
+        return 'side-effect';
+    if (action === undefined)
+        return 'unchecked';
+    if (READ_ONLY_ACTION.test(action))
+        return 'read-only';
+    if (SIDE_EFFECT_ACTION.test(action))
+        return 'side-effect';
+    return 'mutates';
+}
+//# sourceMappingURL=effect-class.js.map

package/dist/tools/effect-class.js.map

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

package/dist/tools/engine-lists.d.ts

@@ -4,17 +4,32 @@
  * Name lists the engine owns and the tool surface must offer exactly. See
  * scripts/sync-engine-lists.mjs for why each is generated.
  *
- * Source: FxTool origin/main b2ddccfeabe97f6a2b42e6ad6b35f2451ece3620
- *   js/core/KeyframeInterpolator.js  sha256: 4c38752d86cae944
+ * Source: FxTool origin/main c2d922787576249eeb37b1fa8c4cb0cfec943204
+ *   js/core/KeyframeInterpolator.js  sha256: 1134ba0e2ce5d1f5
  *   js/world3d/worlds.js  sha256: 0e0973f7587c06e1
- *   js/core/DesignMedia.js  sha256: 46fae8ceafe54b11
+ *   js/core/DesignMedia.js  sha256: ab07f330e4060cb7
+ *   js/FilterSystem.js  sha256: 3cfb0f9e54eb50ab
+ *   js/core/Provenance.js  sha256: 27e4d8becfa382c8
+ *   js/core/StyledScene.js  sha256: ea647c014de59faf
  */
-/** 37 names: EASING_NAMES, the keys of the engine's easing table. Keyframes, masks, relations and the camera all resolve through it. */
-export declare const ENGINE_EASING_NAMES: readonly ["linear", "easeIn", "easeOut", "easeInOut", "easeInCubic", "easeOutCubic", "easeInOutCubic", "bounce", "easeOutBounce", "easeInBounce", "elastic", "easeOutElastic", "easeInElastic", "easeOutBack", "easeInBack", "easeInOutBack", "spring", "springSnappy", "springPlayful", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInSine", "easeOutSine", "easeInOutSine", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc"];
+/** 39 names: EASING_NAMES, the keys of the engine's easing table. Keyframes, masks, relations and the camera all resolve through it. */
+export declare const ENGINE_EASING_NAMES: readonly ["linear", "easeIn", "easeOut", "easeInOut", "easeInCubic", "easeOutCubic", "easeInOutCubic", "bounce", "easeOutBounce", "easeInBounce", "elastic", "easeOutElastic", "easeInElastic", "easeOutBack", "easeInBack", "easeInOutBack", "spring", "springSnappy", "springPlayful", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInSine", "easeOutSine", "easeInOutSine", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "hold", "step"];
 /** 11 paths: WORLD_SCHEMA entries of kind 'color' — the world spec's colour fields. */
 export declare const WORLD3D_COLOR_PATHS: readonly ["env.zenith", "env.horizon", "env.fogColor", "env.sunColor", "env.ambient", "env.lowColor", "env.midColor", "env.highColor", "env.rockColor", "env.propColorA", "env.propColorB"];
 /** 9 media: the keys of DesignMedia MEDIA. */
 export declare const DESIGN_MEDIA: readonly ["vector", "thread", "ink", "watercolor", "hatch", "cutPaper", "charcoal", "oil", "encaustic"];
 /** The engine method that applies each medium that has one (MEDIA[key].apply). The others are refused by the engine, by name. */
 export declare const DESIGN_MEDIA_APPLY: Readonly<Record<string, string>>;
+/** 20 filters: everything FilterSystem.js registers. */
+export declare const FILTER_TYPES: readonly ["grayscale", "sepia", "brightness", "contrast", "saturation", "invert", "blur", "noise", "vignette", "vintage", "colorOverlay", "sharpen", "emboss", "posterize", "hsl", "colorTint", "edgeDetect", "halftoneDots", "halftoneCMYK", "dither"];
+/** Numeric parameter ranges per filter, [min, max], as the engine registers them. */
+export declare const FILTER_PARAM_RANGES: Readonly<Record<string, Readonly<Record<string, readonly [number, number]>>>>;
+/** 5 kinds: LINEAGE_KINDS, what provenance record accepts. */
+export declare const LINEAGE_KINDS: readonly ["derivedFrom", "instanceOf", "placedFrom", "importedFrom", "copyOf"];
+/** 6 styles: STYLES, the looks a styled scene is drawn in. */
+export declare const STYLED_SCENE_STYLES: readonly ["cut", "ink", "watercolor", "dither", "flow", "ascii"];
+/** One line per styled-scene style: the engine's STYLE_INFO. */
+export declare const STYLED_SCENE_STYLE_INFO: Readonly<Record<string, string>>;
+/** One line per filter: the engine's own description and parameter ranges. */
+export declare const FILTER_DOCS: Readonly<Record<string, string>>;
 //# sourceMappingURL=engine-lists.d.ts.map

package/dist/tools/engine-lists.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-lists.d.ts","sourceRoot":"","sources":["../../src/tools/engine-lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wIAAwI;AACxI,eAAO,MAAM,mBAAmB,ojBAsCtB,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,6LAYtB,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,YAAY,yGAUf,CAAC;AAEX,iIAAiI;AACjI,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM9D,CAAC"}
+{"version":3,"file":"engine-lists.d.ts","sourceRoot":"","sources":["../../src/tools/engine-lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wIAAwI;AACxI,eAAO,MAAM,mBAAmB,okBAwCtB,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,6LAYtB,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,YAAY,yGAUf,CAAC;AAEX,iIAAiI;AACjI,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9D,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,YAAY,yPAqBf,CAAC;AAEX,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAqB5G,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,aAAa,gFAMhB,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,kEAOtB,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnE,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBvD,CAAC"}

package/dist/tools/engine-lists.js

@@ -4,12 +4,15 @@
  * Name lists the engine owns and the tool surface must offer exactly. See
  * scripts/sync-engine-lists.mjs for why each is generated.
  *
- * Source: FxTool origin/main b2ddccfeabe97f6a2b42e6ad6b35f2451ece3620
- *   js/core/KeyframeInterpolator.js  sha256: 4c38752d86cae944
+ * Source: FxTool origin/main c2d922787576249eeb37b1fa8c4cb0cfec943204
+ *   js/core/KeyframeInterpolator.js  sha256: 1134ba0e2ce5d1f5
  *   js/world3d/worlds.js  sha256: 0e0973f7587c06e1
- *   js/core/DesignMedia.js  sha256: 46fae8ceafe54b11
+ *   js/core/DesignMedia.js  sha256: ab07f330e4060cb7
+ *   js/FilterSystem.js  sha256: 3cfb0f9e54eb50ab
+ *   js/core/Provenance.js  sha256: 27e4d8becfa382c8
+ *   js/core/StyledScene.js  sha256: ea647c014de59faf
  */
-/** 37 names: EASING_NAMES, the keys of the engine's easing table. Keyframes, masks, relations and the camera all resolve through it. */
+/** 39 names: EASING_NAMES, the keys of the engine's easing table. Keyframes, masks, relations and the camera all resolve through it. */
 export const ENGINE_EASING_NAMES = [
     'linear',
     'easeIn',
@@ -48,6 +51,8 @@ export const ENGINE_EASING_NAMES = [
     'easeInCirc',
     'easeOutCirc',
     'easeInOutCirc',
+    'hold',
+    'step',
 ];
 /** 11 paths: WORLD_SCHEMA entries of kind 'color' — the world spec's colour fields. */
 export const WORLD3D_COLOR_PATHS = [
@@ -78,9 +83,106 @@ export const DESIGN_MEDIA = [
 /** The engine method that applies each medium that has one (MEDIA[key].apply). The others are refused by the engine, by name. */
 export const DESIGN_MEDIA_APPLY = Object.freeze({
     thread: 'applyThreadPainting',
+    ink: 'applyInkBrush',
     watercolor: 'applyWatercolorWash',
     hatch: 'applyHatching',
     cutPaper: 'applyCutPaper',
+    charcoal: 'applyCharcoalBrush',
     oil: 'applyOilWash',
 });
+/** 20 filters: everything FilterSystem.js registers. */
+export const FILTER_TYPES = [
+    'grayscale',
+    'sepia',
+    'brightness',
+    'contrast',
+    'saturation',
+    'invert',
+    'blur',
+    'noise',
+    'vignette',
+    'vintage',
+    'colorOverlay',
+    'sharpen',
+    'emboss',
+    'posterize',
+    'hsl',
+    'colorTint',
+    'edgeDetect',
+    'halftoneDots',
+    'halftoneCMYK',
+    'dither',
+];
+/** Numeric parameter ranges per filter, [min, max], as the engine registers them. */
+export const FILTER_PARAM_RANGES = Object.freeze({
+    grayscale: { intensity: [0, 1] },
+    sepia: { intensity: [0, 1] },
+    brightness: { value: [-100, 100] },
+    contrast: { value: [-100, 100] },
+    saturation: { value: [-100, 100] },
+    invert: { intensity: [0, 1] },
+    blur: { radius: [0, 20] },
+    noise: { intensity: [0, 100], grainSize: [1, 4], refresh: [0, 8], seed: [0, 99999] },
+    vignette: { intensity: [0, 1], radius: [0, 1], falloff: [0.5, 4] },
+    vintage: { intensity: [0, 1] },
+    colorOverlay: { intensity: [0, 1] },
+    sharpen: { intensity: [0, 100] },
+    emboss: { intensity: [0, 1] },
+    posterize: { levels: [2, 32] },
+    hsl: { hue: [-180, 180], saturation: [-100, 100], lightness: [-100, 100] },
+    colorTint: { intensity: [0, 1] },
+    edgeDetect: { strength: [0, 4] },
+    halftoneDots: { size: [2, 32], angle: [0, 3.14] },
+    halftoneCMYK: { size: [2, 32] },
+    dither: { levels: [2, 16] },
+});
+/** 5 kinds: LINEAGE_KINDS, what provenance record accepts. */
+export const LINEAGE_KINDS = [
+    'derivedFrom',
+    'instanceOf',
+    'placedFrom',
+    'importedFrom',
+    'copyOf',
+];
+/** 6 styles: STYLES, the looks a styled scene is drawn in. */
+export const STYLED_SCENE_STYLES = [
+    'cut',
+    'ink',
+    'watercolor',
+    'dither',
+    'flow',
+    'ascii',
+];
+/** One line per styled-scene style: the engine's STYLE_INFO. */
+export const STYLED_SCENE_STYLE_INFO = Object.freeze({
+    cut: "paper cut-out with soft drop shadows and paper grain",
+    ink: "ink line and hatching, boiling on twos (12 fps)",
+    watercolor: "translucent watercolour glazes on cold-press paper",
+    dither: "1-bit ordered (Bayer) dither in two inks",
+    flow: "contour streamlines on dark ground, animated along their length",
+    ascii: "ASCII broadcast with scanlines and a timecode",
+});
+/** One line per filter: the engine's own description and parameter ranges. */
+export const FILTER_DOCS = Object.freeze({
+    grayscale: "Convert to black and white — intensity 0..1, default 1",
+    sepia: "Apply warm sepia tone — intensity 0..1, default 1",
+    brightness: "Adjust image brightness — value -100..100, default 0",
+    contrast: "Adjust image contrast — value -100..100, default 0",
+    saturation: "Adjust color saturation — value -100..100, default 0",
+    invert: "Invert colors — intensity 0..1, default 1",
+    blur: "Apply gaussian blur — radius 0..20, default 5",
+    noise: "Add film grain effect — intensity 0..100, default 20; monochrome (boolean), default true; grainSize 1..4; refresh 0..8; seed 0..99999, default 0; blend add|multiply, default add",
+    vignette: "Add vignette darkening — intensity 0..1, default 0.5; radius 0..1, default 0.5; color (color); falloff 0.5..4, default 2",
+    vintage: "Retro vintage look — intensity 0..1, default 1",
+    colorOverlay: "Add color tint — color (color), default #ff0000; intensity 0..1, default 0.3; blendMode multiply|overlay|screen, default overlay",
+    sharpen: "Increase image sharpness — intensity 0..100, default 50",
+    emboss: "3D emboss effect — intensity 0..1, default 1",
+    posterize: "Reduce color levels — levels 2..32, default 4",
+    hsl: "Shift hue, saturation, lightness — hue -180..180, default 0; saturation -100..100, default 0; lightness -100..100, default 0",
+    colorTint: "Tint image toward a color — intensity 0..1, default 0.3; color (color), default #ff0000; blendMode multiply|screen|overlay, default overlay",
+    edgeDetect: "Sobel edge detection — strength 0..4, default 1.0",
+    halftoneDots: "Black-and-white halftone dot pattern — size 2..32, default 6; angle 0..3.14, default 0.4",
+    halftoneCMYK: "CMYK halftone separations (newspaper rosette) — size 2..32, default 6",
+    dither: "Ordered Bayer 4x4 dithering — levels 2..16, default 2",
+});
 //# sourceMappingURL=engine-lists.js.map

package/dist/tools/engine-lists.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-lists.js","sourceRoot":"","sources":["../../src/tools/engine-lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wIAAwI;AACxI,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,QAAQ;IACR,eAAe;IACf,cAAc;IACd,SAAS;IACT,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,YAAY;IACZ,eAAe;IACf,QAAQ;IACR,cAAc;IACd,eAAe;IACf,YAAY;IACZ,aAAa;IACb,eAAe;IACf,YAAY;IACZ,aAAa;IACb,eAAe;IACf,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,YAAY;IACZ,aAAa;IACb,eAAe;IACf,YAAY;IACZ,aAAa;IACb,eAAe;CACP,CAAC;AAEX,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY;IACZ,aAAa;IACb,cAAc;IACd,cAAc;IACd,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAEX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,KAAK;IACL,WAAW;CACH,CAAC;AAEX,iIAAiI;AACjI,MAAM,CAAC,MAAM,kBAAkB,GAAqC,MAAM,CAAC,MAAM,CAAC;IAChF,MAAM,EAAE,qBAAqB;IAC7B,UAAU,EAAE,qBAAqB;IACjC,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,eAAe;IACzB,GAAG,EAAE,cAAc;CACpB,CAAC,CAAC"}
+{"version":3,"file":"engine-lists.js","sourceRoot":"","sources":["../../src/tools/engine-lists.ts"],"names":[],"mappings":"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"}

package/dist/tools/engine-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-methods.d.ts","sourceRoot":"","sources":["../../src/tools/engine-methods.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAuNpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAyCpD,CAAC"}
+{"version":3,"file":"engine-methods.d.ts","sourceRoot":"","sources":["../../src/tools/engine-methods.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAsOpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EA+CpD,CAAC"}