@pinepaper.studio/mcp-server 1.6.29 → 1.6.30

package/dist/types/code-generator.js

@@ -402,8 +402,13 @@ const item = app.create(${jsLiteral(itemType)}, ${JSON.stringify(params, null, 2
     if (hasCreateScale) {
         code += `
 const __scale = (function(it) {
+  // A studio whose create() applies scale (FxTool #262) already has it: nothing to redo.
+  const __want = ${JSON.stringify(createScale)};
+  const __s0 = (it && it.scaling) || { x: 1, y: 1 };
+  const __near = function(a, b) { return b === undefined || Math.abs(a - b) < 1e-6; };
+  if (__near(__s0.x, __want.scaleX) && __near(__s0.y, __want.scaleY)) return { applied: true, x: __s0.x, y: __s0.y };
   if (!it || !it.data || typeof app.modifyItem !== 'function') return { applied: false, note: 'this studio has no app.modifyItem, so the scale was not applied at create; set it with pinepaper_modify_item.' };
-  app.modifyItem(it.data.registryId, ${JSON.stringify(createScale)});
+  app.modifyItem(it.data.registryId, __want);
   const s = it.scaling || { x: 1, y: 1 };
   return { applied: true, x: s.x, y: s.y };
 })(item);`;
@@ -1916,12 +1921,14 @@ const TEXT_KEY_ENGINE_NAMES = {
     wordSpacing: ['wordSpacing'],
     textDecoration: ['textDecoration'],
     textTransform: ['textTransform'],
-    // Not text, same failure (SHEARKEY, mcp-cloud #29): no studio has a skew
-    // channel yet, so skew keys were stored and drew nothing. A sheared motion
-    // today is a `transform` matrix track.
+    // Not text, same failure (SHEARKEY, mcp-cloud #29): a studio before FxTool
+    // #263 has no skew channel, so skew keys were stored and drew nothing. The
+    // current one animates skewX / skewY. `shear` is no channel on any studio:
+    // keyed, it drew nothing with no word (measured on 56c79202), so it is named
+    // unless a studio ever lists `shear` itself.
     skewX: ['skewX'],
     skewY: ['skewY'],
-    shear: ['shear', 'skewX'],
+    shear: ['shear'],
 };
 /** A JS expression (run in the page) → the keys of `keys` this studio does not animate. '' when none are text keys. */
 function unanimatedTextKeysJs(keys) {
@@ -1936,7 +1943,7 @@ function unanimatedTextKeysJs(keys) {
   })()`;
 }
 /** The sentence for the keys unanimatedTextKeysJs found, built in the page. */
-const UNANIMATED_TEXT_KEYS_SENTENCE = `' is not an animatable property in this studio (app.listAnimatableProperties does not list it), so it had no effect: a key animates only where that list names it. Here, set a fixed value with pinepaper_modify_item, or animate fontSize or scaleX (a skew: a transform matrix track).'`;
+const UNANIMATED_TEXT_KEYS_SENTENCE = `' is not an animatable property in this studio (app.listAnimatableProperties does not list it), so it had no effect: a key animates only where that list names it. Here, set a fixed value with pinepaper_modify_item, or animate fontSize or scaleX. For a skew, key skewX / skewY (degrees) where the studio lists them, else a transform matrix track.'`;
 function generateKeyframeAnimateCode(itemId, keyframes, duration, loop = false, timeOffset, clipInPoint, clipOutPoint, timeUnits, append = false, easingAt) {
     const ID = jsLiteral(itemId); // caller text: a quoted literal, never spliced raw
     const keyframesJson = JSON.stringify(normalizeKeyframePositions(keyframes), null, 2);
@@ -2010,12 +2017,13 @@ String(JSON.stringify(levelKeys)) +
     const loopNote = loop
         ? `, loopNote: ${JSON.stringify('loop:true repeats in the editor, but has been measured playing ONCE in an exported video and then holding the last keyframe. For an export longer than one cycle, check a frame in the second cycle — if it holds, write the keyframes out per cycle, or use a loop preset (pinepaper_animate), which does cycle in export.')}`
         : '';
-    // SIZEKEY-PAIR (mcp-cloud #28): x (or position) keyed beside fontSize on one
-    // text item has been measured drifting in an export: the size is applied
-    // after the position, and a text resizes around its anchor, so the box leaves
-    // the keyed x. Said, with the two ways that hold.
+    // SIZEKEY-PAIR (mcp-cloud #28): on a studio before FxTool #262, x (or
+    // position) keyed beside fontSize on one text item drifted in an export: the
+    // size was applied after the position, and a text resizes around its anchor.
+    // Said there, with the two ways that hold; a current studio is quiet.
     const sizekeyPairNote = (allProps.includes('x') || allProps.includes('position')) && allProps.includes('fontSize')
-        ? `, sizekeyPairWarning: ${JSON.stringify('x (or position) and fontSize keyed on the same text item have been measured drifting off the keyed position in an export (SIZEKEY-PAIR). Animate scaleX / scaleY instead of fontSize, or move a group that holds the text.')}`
+        // A studio that writes text size before position (FxTool #262, which also brought _applyScaleParams) holds x.
+        ? `, ...(typeof app._applyScaleParams !== 'function' ? { sizekeyPairWarning: ${JSON.stringify('x (or position) and fontSize keyed on the same text item drift off the keyed position in an export on this studio (SIZEKEY-PAIR). Animate scaleX / scaleY instead of fontSize, or move a group that holds the text; or update the studio.')} } : {})`
         : '';
     const easingNote = easingAt !== 'departure' && first?.easing && first.easing !== 'linear'
         ? `, note: ${JSON.stringify(`easing '${first.easing}' is on the first keyframe, where it has no effect by default: easing shapes the segment ARRIVING at a keyframe. Put it on the keyframe you are moving to, or pass easingAt: 'departure' to read every easing as the move LEAVING its key (current studio).`)}`
@@ -5643,11 +5651,12 @@ String(JSON.stringify(scaled)) +
 String(format === 'webm' && transparent === true ? '' : ", 'webm'") +
 String(format === 'apng' && transparent === false ? ", 'apng'" : '') +
 "].indexOf(fmt) === -1) return [];\n      const bg = app.canvasEl && app.canvasEl.style && app.canvasEl.style.backgroundColor;\n      const hasColor = !!bg && !/^(transparent|rgba\\([^)]*,\\s*0\\))$/i.test(bg);\n      const hasBgItems = !!(app.patternGroup && app.patternGroup.children && app.patternGroup.children.length);\n      // A 3D world under the canvas IS the background: since FxTool #50\n      // (747315e3) jpg/webp stills composite it, so nothing turns white/black.\n      const hasWorld = !!app._world3d;\n      // So does a styled scene: one raster sized to COVER the frame (gate run 3:\n      // every export after styled_scene warned of black areas it does not have).\n      const h" +
-"asStyledScene = !!(app.textItemGroup && app.textItemGroup.children\n        && app.textItemGroup.children.some(function (it) { return it && it.data && it.data.styledScene && it.visible !== false; }));\n      if (hasColor || hasBgItems || hasWorld || hasStyledScene) return [];\n      return [{ code: 'alpha_dropped', message: fmt === 'apng'\n        ? 'apng with transparent: false and no background colour: the frames are filled BLACK. Set a background colour, or drop transparent: false to keep the alpha.'\n        : fmt === 'jpg'\n        ? 'jpg has no transparency and this scene has no background, so transparent areas are filled white. Use png or webp to keep them.'\n        : fmt + ' is ex" +
-"ported without transparency and this scene has no background, so transparent areas come out BLACK. Set a background colour, or export apng (animated, full alpha) or png to keep it.' }];\n    } catch (e) { return []; }\n  }\n  // TEXT THAT DOES NOT FIT (FxTool 661224ef: textOverflowReport) — text past\n  // its fit box at the minimum size, or off the frame. The pre-batch check for\n  // certificates, speaker cards and localised variants, on every export.\n  function textOverflow() {\n    try {\n      const rep = (typeof app.textOverflowReport === 'function' && app.textOverflowReport()) || [];\n      return rep.slice(0, 10).map(function(o) {\n        return { code: 'text_overflow', message: " +
-"(o.id || 'a text item') + ' (' + JSON.stringify(String(o.content || '').slice(0, 40)) + '): ' + (o.reason || 'overflows'), items: [o.id] };\n      });\n    } catch (e) { return []; }\n  }\n  function fidelity(fmt) {\n    const own = alphaLoss(fmt).concat(textOverflow());\n    try {\n      if (!app.exportEngine || typeof app.exportEngine.exportFidelity !== 'function') {\n        return { fidelity: { available: false, reason: 'this studio cannot check export fidelity — update PinePaper Studio.', ...(own.length ? { warnings: own } : {}) } };\n      }\n      const r = app.exportEngine.exportFidelity(fmt);\n      if (!r) { return { fidelity: { available: false, reason: 'the fidelity check retur" +
-"ned nothing.', ...(own.length ? { warnings: own } : {}) } }; }\n      const warnings = (r.warnings || []).concat(own);\n      return {\n        fidelity: {\n          available: true,\n          warnings: warnings,\n          checked: r.checked,\n          ...(warnings.length === 0\n            ? { note: 'this scene loses nothing to ' + fmt + '. That is a statement about THIS SCENE, not a claim that the format is lossless.' }\n            : {}),\n        },\n      };\n    } catch (e) {\n      return { fidelity: { available: false, reason: (e && e.message) || 'the fidelity check threw.', ...(own.length ? { warnings: own } : {}) } };\n    }\n  }\n\n  // Preflight: same resolved settings as t" +
-"he real export, but render nothing.\n  // Branching HERE rather than in a separate tool is deliberate — the estimate\n  // has to see the same platform dimensions, fps and quality the export would\n  // use, and a parallel tool would re-derive them and drift.\n  if (" +
+"asStyledScene = !!(app.textItemGroup && app.textItemGroup.children\n        && app.textItemGroup.children.some(function (it) { return it && it.data && it.data.styledScene && it.visible !== false; }));\n      if (hasColor || hasBgItems || hasWorld || hasStyledScene) return [];\n      // The fill is the studio's page colour, not black: every opaque export\n      // path asks the engine's _pageColor, which is white when no page colour\n      // is set (an older engine fell back to black for video). An apng was\n      // measured white (bitrate sweep, 11.02), so name the page colour, not a hue.\n      return [{ code: 'alpha_dropped', message: fmt === 'apng'\n        ? 'apng with transparent: f" +
+"alse and no background colour: the frames are filled with the studio page colour (white in current studios), not a colour this scene chose. Set a background colour, or drop transparent: false to keep the alpha.'\n        : fmt === 'jpg'\n        ? 'jpg has no transparency and this scene has no background, so transparent areas are filled white. Use png or webp to keep them.'\n        : fmt + ' is exported without transparency and this scene has no background, so transparent areas are filled with the studio page colour (white in current studios), not a colour this scene chose. Set a background colour, or export apng (animated, full alpha) or png to keep it.' }];\n    } catch (e) { return [];" +
+" }\n  }\n  // TEXT THAT DOES NOT FIT (FxTool 661224ef: textOverflowReport) — text past\n  // its fit box at the minimum size, or off the frame. The pre-batch check for\n  // certificates, speaker cards and localised variants, on every export.\n  function textOverflow() {\n    try {\n      const rep = (typeof app.textOverflowReport === 'function' && app.textOverflowReport()) || [];\n      return rep.slice(0, 10).map(function(o) {\n        return { code: 'text_overflow', message: (o.id || 'a text item') + ' (' + JSON.stringify(String(o.content || '').slice(0, 40)) + '): ' + (o.reason || 'overflows'), items: [o.id] };\n      });\n    } catch (e) { return []; }\n  }\n  function fidelity(fmt) {" +
+"\n    const own = alphaLoss(fmt).concat(textOverflow());\n    try {\n      if (!app.exportEngine || typeof app.exportEngine.exportFidelity !== 'function') {\n        return { fidelity: { available: false, reason: 'this studio cannot check export fidelity — update PinePaper Studio.', ...(own.length ? { warnings: own } : {}) } };\n      }\n      const r = app.exportEngine.exportFidelity(fmt);\n      if (!r) { return { fidelity: { available: false, reason: 'the fidelity check returned nothing.', ...(own.length ? { warnings: own } : {}) } }; }\n      const warnings = (r.warnings || []).concat(own);\n      return {\n        fidelity: {\n          available: true,\n          warnings: warnings," +
+"\n          checked: r.checked,\n          ...(warnings.length === 0\n            ? { note: 'this scene loses nothing to ' + fmt + '. That is a statement about THIS SCENE, not a claim that the format is lossless.' }\n            : {}),\n        },\n      };\n    } catch (e) {\n      return { fidelity: { available: false, reason: (e && e.message) || 'the fidelity check threw.', ...(own.length ? { warnings: own } : {}) } };\n    }\n  }\n\n  // Preflight: same resolved settings as the real export, but render nothing.\n  // Branching HERE rather than in a separate tool is deliberate — the estimate\n  // has to see the same platform dimensions, fps and quality the export would\n  // use, and a " +
+"parallel tool would re-derive them and drift.\n  if (" +
 String(estimateOnly ? 'true' : 'false') +
 ") {\n    if (typeof app.estimateExportSize !== 'function') {\n      return { success: false, estimateOnly: true, error: 'This PinePaper build has no estimateExportSize() — update the editor to preflight export size.' };\n    }\n    const est = await app.estimateExportSize({\n      format,\n      duration: " +
 String(videoDuration) +
@@ -7160,6 +7169,9 @@ String(jsLiteral(format)) +
 
 
 
+
+
+
 
 
 
@@ -10569,7 +10581,7 @@ String(jsLiteral(input.filterName || '')) +
 String(JSON.stringify(input.itemId)) +
 ", filter: " +
 String(JSON.stringify(input.filterName || '')) +
-String(input.filterName === 'bloom' ? `, warning: 'bloom is drawn inside the image\\'s own pixels, so its halo stops at the image edge and does not spill onto the canvas (BLOOMCLIP). For a halo past the edge, use pinepaper_apply_effect glow or a shadow.'` : '') +
+String(input.filterName === 'bloom' ? `, ...(typeof app._writeRasterPixels !== 'function' ? { warning: 'on this studio bloom is drawn inside the image\\'s own pixels, so its halo stops at the image edge (BLOOMCLIP). For a halo past the edge, use pinepaper_apply_effect glow or a shadow, or update the studio.' } : {})` : '') +
 " };\n  } catch (e) {\n    return { success: false, action: 'apply', error: 'Failed to apply filter: ' + e.message };\n  }\n})();"
 ).trim();
             case 'chain':
@@ -12688,12 +12700,32 @@ String(diagJson) +
 String(optsJson) +
 ");\n  // THE RELATIONS AS BOUND, so a later agent can find the one to edit without exporting the scene to read it:\n  // from, to, type and params, capped. And the custom relation definitions registered on this page, as given.\n  const __rels = [];\n  let __relCount = 0;\n  try {\n    const __rr = app.relationRegistry;\n    const __active = __rr && typeof __rr.queryActive === 'function' ? __rr.queryActive() : [];\n    __active.forEach((e) => (e.associations || []).forEach((a) => {\n      __relCount++;\n      if (__rels.length >= " +
 String(RELATIONS_READBACK_CAP) +
-") return;\n      const __name = e.item && e.item.data && e.item.data.name;\n      __rels.push({ from: e.itemId, ...(__name ? { fromName: __name } : {}), to: a.target === undefined ? null : a.target, type: a.relation, params: a.params || {} });\n    }));\n  } catch (e) { /* the relations are an addition; the lint stands without them */ }\n  const __custom = (typeof window !== 'undefined' && window.__ppCustomRelations) ? Object.values(window.__ppCustomRelations) : [];\n  // HOW TO CHANGE IT (#43): an editing agent needs the op, not the schemas. Each relation comes with the batch op that\n  // changes it; a group bound by a name pattern (\"dot-*\", recorded in each member's params) comes once" +
-", with the ops\n  // that add and remove a member; a custom motion with the call that redefines it.\n  const __edit = { hint: 'To change this scene, send the ops below (your values in relationOptions) in ONE pinepaper_agent_batch_execute call; a custom motion changes by sending its pinepaper_register_custom_relation call again.', groups: [], relations: [], customRelations: [] };\n  try {\n    const __byPat = new Map();\n    __rels.forEach((r) => {\n      const pat = r.params && r.params.pattern;\n      if (typeof pat === 'string') {\n        const k = pat + '|' + r.type + '|' + r.to;\n        if (!__byPat.has(k)) __byPat.set(k, { pattern: pat, type: r.type, to: r.to, members: [] });\n     " +
-"   __byPat.get(k).members.push(r);\n        return;\n      }\n      __edit.relations.push({ from: r.from, ...(r.fromName ? { fromName: r.fromName } : {}), to: r.to, relationType: r.type,\n        change: { type: 'relation', sourceId: r.fromName || r.from, ...(r.to != null ? { targetId: r.to } : {}), relationType: r.type, update: true, relationOptions: r.params } });\n    });\n    __byPat.forEach((g) => {\n      const base = Object.assign({}, g.members[0].params); delete base.index; delete base.count; delete base.pattern;\n      const names = g.members.map((m) => m.fromName).filter(Boolean).sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));\n      const prefix = g.pattern.spl" +
-"it('*')[0];\n      const nums = names.map((n) => Number(n.slice(prefix.length))).filter((n) => Number.isFinite(n));\n      const next = prefix + (nums.length ? Math.max.apply(null, nums) + 1 : g.members.length + 1);\n      const firstEntry = app.itemRegistry.get(g.members[0].from);\n      const bind = { type: 'relation', sourceId: g.pattern, ...(g.to != null ? { targetId: g.to } : {}), relationType: g.type, relationOptions: base };\n      __edit.groups.push({ pattern: g.pattern, relationType: g.type, members: g.members.length, ...(names.length ? { first: names[0], last: names[names.length - 1] } : {}), relationOptions: base,\n        change: Object.assign({}, bind, { update: true }),\n    " +
-"    addMember: [{ type: 'create', itemType: (firstEntry && firstEntry.type) || 'circle', position: [0, 0], properties: { name: next } }, bind],\n        ...(names.length ? { removeMember: [{ type: 'delete', itemId: names[names.length - 1] }, bind] } : {}) });\n    });\n    __custom.forEach((d) => __edit.customRelations.push({ name: d.name, change: { tool: 'pinepaper_register_custom_relation', args: d } }));\n  } catch (e) { /* the read-back stands without the edit ops */ }\n  // warnings: what the engine's own rules found (TEXT_CLIPS_FRAME: a centre-anchored text running past the\n  // frame edge). Passed through when the studio reports them; an older studio has none to pass.\n  return { s" +
-"uccess: true, density: result.density, suggestions: result.suggestions,\n    ...(Array.isArray(result.warnings) && result.warnings.length ? { warnings: result.warnings } : {}),\n    relations: __rels, ...(__relCount > __rels.length ? { relationsShown: __rels.length, relationCount: __relCount } : {}),\n    ...(__custom.length ? { customRelations: __custom } : {}),\n    ...(__edit.groups.length || __edit.relations.length || __edit.customRelations.length ? { edit: __edit } : {}) };\n})();"
+") return;\n      const __name = e.item && e.item.data && e.item.data.name;\n      __rels.push({ from: e.itemId, ...(__name ? { fromName: __name } : {}), to: a.target === undefined ? null : a.target, type: a.relation, params: a.params || {} });\n    }));\n  } catch (e) { /* the relations are an addition; the lint stands without them */ }\n  // CUSTOM RELATIONS THIS SCENE USES (#43): one registered before a clear_canvas stayed in the read-back of the scene\n  // after it. Those in use are listed; the rest are named in registeredUnused. Their source (computeFunction /\n  // applyFunction) only with withSource: true, since an edit of params never needs it.\n  const __usedTypes = new Set();\n  " +
+"try { const __rr2 = app.relationRegistry; (__rr2 && typeof __rr2.queryActive === 'function' ? __rr2.queryActive() : []).forEach((e) => (e.associations || []).forEach((a) => __usedTypes.add(a.relation))); } catch (e) { /* none known */ }\n  const __allCustom = (typeof window !== 'undefined' && window.__ppCustomRelations) ? Object.values(window.__ppCustomRelations) : [];\n  const __strip = (d) => { if (" +
+String(input.withSource === true ? 'true' : 'false') +
+") return d; const o = Object.assign({}, d); delete o.computeFunction; delete o.applyFunction; return o; };\n  const __custom = __allCustom.filter((d) => __usedTypes.has(d.name)).map(__strip);\n  const __unusedCustom = __allCustom.filter((d) => !__usedTypes.has(d.name)).map((d) => d.name);\n  // HOW TO CHANGE IT (#43): an editing agent needs the op, not the schemas. Each relation comes with the batch op that\n  // changes it; a group bound by a name pattern (\"dot-*\", recorded in each member's params) comes once, with the ops\n  // that add and remove a member; a custom motion with the call that redefines it.\n  const __edit = { hint: 'To change this scene, send the ops below (your values " +
+"in relationOptions) in ONE pinepaper_agent_batch_execute call; a custom motion changes by sending its pinepaper_register_custom_relation call again.', groups: [], relations: [], customRelations: [] };\n  try {\n    const __byPat = new Map();\n    __rels.forEach((r) => {\n      const pat = r.params && r.params.pattern;\n      if (typeof pat === 'string') {\n        const k = pat + '|' + r.type + '|' + r.to;\n        if (!__byPat.has(k)) __byPat.set(k, { pattern: pat, type: r.type, to: r.to, members: [] });\n        __byPat.get(k).members.push(r);\n        return;\n      }\n      __edit.relations.push({ from: r.from, ...(r.fromName ? { fromName: r.fromName } : {}), to: r.to, relationType: r." +
+"type,\n        change: { type: 'relation', sourceId: r.fromName || r.from, ...(r.to != null ? { targetId: r.to } : {}), relationType: r.type, update: true, relationOptions: r.params } });\n    });\n    __byPat.forEach((g) => {\n      const base = Object.assign({}, g.members[0].params); delete base.index; delete base.count; delete base.pattern;\n      const names = g.members.map((m) => m.fromName).filter(Boolean).sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));\n      const prefix = g.pattern.split('*')[0];\n      const nums = names.map((n) => Number(n.slice(prefix.length))).filter((n) => Number.isFinite(n));\n      const next = prefix + (nums.length ? Math.max.apply(null, " +
+"nums) + 1 : g.members.length + 1);\n      const firstEntry = app.itemRegistry.get(g.members[0].from);\n      const bind = { type: 'relation', sourceId: g.pattern, ...(g.to != null ? { targetId: g.to } : {}), relationType: g.type, relationOptions: base };\n      __edit.groups.push({ pattern: g.pattern, relationType: g.type, members: g.members.length, ...(names.length ? { first: names[0], last: names[names.length - 1] } : {}), relationOptions: base,\n        change: Object.assign({}, bind, { update: true }),\n        addMember: [{ type: 'create', itemType: (firstEntry && firstEntry.type) || 'circle', position: [0, 0], properties: { name: next } }, bind],\n        ...(names.length ? { removeM" +
+"ember: [{ type: 'delete', itemId: names[names.length - 1] }, bind] } : {}) });\n    });\n    __custom.forEach((d) => __edit.customRelations.push({ name: d.name, change: { tool: 'pinepaper_register_custom_relation', args: d } }));\n  } catch (e) { /* the read-back stands without the edit ops */ }\n  if (!" +
+String(input.withSource === true ? 'true' : 'false') +
+" && __custom.length) __edit.customHint = 'custom relation source is left out; pass withSource: true to read the current computeFunction / applyFunction before rewriting one.';\n  // A GROUP IS LISTED ONCE (#43): members bound by a name pattern repeated the same relation once per item in\n  // `relations`; they are in edit.groups, and counted here.\n  const __loose = __rels.filter((r) => !(r.params && typeof r.params.pattern === 'string'));\n  const __grouped = __rels.length - __loose.length;\n  const __editOut = __edit.groups.length || __edit.relations.length || __edit.customRelations.length ? { edit: __edit } : {};\n  if (" +
+String(input.only === 'edit' ? 'true' : 'false') +
+") {\n    return Object.assign({ success: true }, __editOut.edit ? __editOut : { edit: { hint: 'nothing to change: this scene binds no relations.' } },\n      __unusedCustom.length ? { registeredUnused: __unusedCustom } : {});\n  }\n  // warnings: what the engine's own rules found (TEXT_CLIPS_FRAME: a centre-anchored text running past the\n  // frame edge). Passed through when the studio reports them; an older studio has none to pass.\n  return { success: true, density: result.density, suggestions: result.suggestions,\n    ...(Array.isArray(result.warnings) && result.warnings.length ? { warnings: result.warnings } : {}),\n    relations: __loose, ...(__grouped ? { groupedRelations: __grouped" +
+", groupedNote: 'relations bound by a name pattern are listed once per group in edit.groups' } : {}),\n    ...(__relCount > __rels.length ? { relationsShown: __rels.length, relationCount: __relCount } : {}),\n    ...(__custom.length ? { customRelations: __custom } : {}),\n    ...(__unusedCustom.length ? { registeredUnused: __unusedCustom } : {}),\n    ...__editOut };\n})();"
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 
 
@@ -13699,7 +13731,7 @@ String(interval === null ? 'null' : interval) +
   ${guard}
   const r = await app.removeLook(${target});
   if (!r || r.ok === false) return { success: false, action: 'remove', error: (r && r.error) || 'nothing to remove' };
-  return { success: true, action: 'remove', target: ${target}, removed: r.removed, scene: r.scene, note: 'removing a look restores colours, strokes, shadows, fonts and pixels, not geometry; it has been measured leaving a multi-part character rig about 1 px off its pose (LOOKRESTORE). Check the pose if pixel-exact alignment matters.' };
+  return { success: true, action: 'remove', target: ${target}, removed: r.removed, scene: r.scene, ...(typeof app._applySkewKeyframePose !== 'function' ? { note: 'this studio restores colours, strokes, shadows, fonts and pixels when a look is removed, not geometry; it has been measured leaving a multi-part character rig about 1 px off its pose (LOOKRESTORE). Check the pose if pixel-exact alignment matters, or update the studio.' } : {}) };
 })();`.trim();
             case 'grid':
                 return `
@@ -13933,16 +13965,18 @@ ${body}
                 return ("\n// Medium: apply " +
 String(oneLine(input.medium)) +
 "\n(async function() {\n  if (typeof app.applyMedium !== 'function') { return { success: false, error: 'app.applyMedium unavailable — update FxTool' }; }\n" +
-String(input.medium === 'ink' && input.options && input.options.keepColor && !input.options.color ? `  // INKCOLOR (mcp-cloud #30): keepColor keeps the item's colour, but with no
-  // color the ink MARKS take the brush default (#16141c). They take the item's
-  // own colour instead.
-  const __mopts = ${S(input.options)};
-  const __e0 = app.itemRegistry && app.itemRegistry.get(${S(input.itemId)});
-  const __it0 = (__e0 && __e0.item) || (app.getItemById ? app.getItemById(${S(input.itemId)}) : null);
-  const __css = function(c) { try { return c && typeof c.toCSS === 'function' ? c.toCSS(true) : null; } catch (_) { return null; } };
-  const __c0 = __it0 && (__css(__it0.strokeColor) || __css(__it0.fillColor));
-  if (__c0) __mopts.color = __c0;
-  const r = await app.applyMedium(${S(input.itemId)}, ${S(input.medium)}, __mopts);` : `  const r = await app.applyMedium(${S(input.itemId)}, ${S(input.medium)}, ${S(input.options ?? {})});`) +
+String(input.medium === 'ink' && input.options && input.options.keepColor && !input.options.color ? ("  // INKCOLOR (mcp-cloud #30): keepColor keeps the item's colour, but with no\n  // color the ink MARKS take the brush default (#16141c). They take the item's\n  // own colour instead.\n  const __mopts = " +
+String(S(input.options)) +
+";\n  // A studio from FxTool #261 on (which also brought _writeRasterPixels) picks the item's colour itself, gradients\n  // and text included, and says so in colorNote: leave it to the studio there.\n  const __e0 = typeof app._writeRasterPixels === 'function' ? null : app.itemRegistry && app.itemRegistry.get(" +
+String(S(input.itemId)) +
+");\n  const __it0 = typeof app._writeRasterPixels === 'function' ? null : ((__e0 && __e0.item) || (app.getItemById ? app.getItemById(" +
+String(S(input.itemId)) +
+") : null));\n  const __css = function(c) { try { return c && typeof c.toCSS === 'function' ? c.toCSS(true) : null; } catch (_) { return null; } };\n  const __c0 = __it0 && (__css(__it0.strokeColor) || __css(__it0.fillColor));\n  if (__c0) __mopts.color = __c0;\n  const r = await app.applyMedium(" +
+String(S(input.itemId)) +
+", " +
+String(S(input.medium)) +
+", __mopts);"
+) : `  const r = await app.applyMedium(${S(input.itemId)}, ${S(input.medium)}, ${S(input.options ?? {})});`) +
 "\n  if (!r || r.ok === false) {\n    return { success: false, error: (r && (r.error || r.reason)) || 'the medium could not be applied', medium: " +
 String(S(input.medium)) +
 ", ...(r && r.fidelity ? { fidelity: r.fidelity } : {}) };\n  }\n  // ink / charcoal restyle IN PLACE (FxTool D32): the same item, marked with\n  // data.brushStyle on its paths and texts. Read the mark back, so an item\n  // the engine passed over is a failure rather than a success (gate D32).\n  if (" +
@@ -13975,6 +14009,8 @@ String(S(input.medium)) +
 
 
 
+
+
 ).trim();
             case 'sdf_stroke': {
                 // FxTool D5: an SDF capsule stroke rendered to a bitmap and created as a