@popcraft/cli 0.58.1 → 0.59.0

package/dist/popcraft.mjs

@@ -1198,7 +1198,7 @@ function operations(spec = openapi) {
 }
 async function call(target2, method, path, opts = {}) {
   const qs = new URLSearchParams(opts.query ?? {}).toString();
-  const headers = { "user-agent": `popcraft-cli/${"0.58.1"}`, ...opts.headers };
+  const headers = { "user-agent": `popcraft-cli/${"0.59.0"}`, ...opts.headers };
   if (target2.token) headers.authorization = `Bearer ${target2.token}`;
   if (opts.contentType) headers["content-type"] = opts.contentType;
   try {
@@ -254384,6 +254384,7 @@ function repairDocumentPaints(doc2) {
 var broken;
 var init_paint_repair = __esm({
   "lib/document/paint-repair.ts"() {
+    "use strict";
     init_shader_graph();
     broken = (p2) => {
       if (!p2 || typeof p2 !== "object") return false;
@@ -260666,7 +260667,6 @@ function repairFx(raw) {
 var isObj5, finite6, optFinite, isVec2, TIMELINE_COLOR_IDS, TIMELINE_COLORS, UNITS, ORDERS, PROP_KEYS, ANIMATOR_ID, MOTION_TYPES, TRANSITIONS, isFraction, MEDIA_HASH, LAYER_KINDS, ADJUSTMENT_TYPES, OPACITY_PROPERTY, CAPTION_PRESET_NAMES, inRange;
 var init_invariants = __esm({
   "lib/motion/invariants.ts"() {
-    "use strict";
     init_adjustments();
     init_captions();
     init_lut();
@@ -263475,7 +263475,6 @@ function resizeWindow(doc2, target2, rect) {
 }
 var init_crop = __esm({
   "lib/editor/crop.ts"() {
-    "use strict";
     init_dist_node();
     init_scene_graph();
     init_photo_frames();
@@ -273392,6 +273391,16 @@ var init_plugin_store = __esm({
       toasts: [],
       permissionPrompt: null,
       managerOpen: false,
+      panelIcons: {},
+      setPanelIcon: (tab, icon) => set4((st3) => {
+        const next2 = { ...st3.panelIcons };
+        if (icon) next2[tab] = icon;
+        else delete next2[tab];
+        return { panelIcons: next2 };
+      }),
+      clearPanelIcons: (pluginId) => set4((st3) => ({
+        panelIcons: Object.fromEntries(Object.entries(st3.panelIcons).filter(([, v]) => v.pluginId !== pluginId))
+      })),
       setInstalled: (installed4) => set4({ installed: installed4 }),
       setManagerOpen: (managerOpen) => set4({ managerOpen }),
       upsertSession: (s) => set4((st3) => ({ sessions: [...st3.sessions.filter((x2) => x2.sessionId !== s.sessionId), s] })),
@@ -317455,7 +317464,6 @@ function decodeSource(key5, label3) {
 var DECODE_CACHE_BYTES, cache7, pending4, held, sizeOf, lengths, decodedLengths, DECODE_TIMEOUT_MS, decodedAudio, decodedSource, pcmOf;
 var init_audio_decode = __esm({
   "lib/motion/audio-decode.ts"() {
-    "use strict";
     init_media_store();
     init_audio_plan();
     init_time_stretch();
@@ -322648,6 +322656,7 @@ function startCloudSync() {
 var status, readOnlyDoc, activeLink, statusListeners, notice, urlArmed, opening, syncStatus, canEdit, uploaded, MEDIA_UPLOAD_PARALLEL, pushTimer, pushing, dirty, pendingMedia, collab, collabSession, collabAnonymous, uploadedThumbs, thumbCheckedAt, THUMB_EVERY_MS, THUMB_MIN_GAP_MS, putThumbnail, openingFiles, mediaHealed, SEEN_KEY, started2;
 var init_sync2 = __esm({
   "lib/client/cloud/sync.ts"() {
+    "use strict";
     init_kinds();
     init_paint_repair();
     init_migrate();
@@ -328171,7 +328180,6 @@ async function selectionReferenceImages(doc2, selection, opts = {}) {
 var FIT_QUALITIES, FIT_SCALES, blobToDataUrl;
 var init_reference_images = __esm({
   "lib/ai/reference-images.ts"() {
-    "use strict";
     init_export();
     init_selection_bounds();
     init_renderer_registry();
@@ -339074,7 +339082,7 @@ var init_package = __esm({
   "packages/runtime/package.json"() {
     package_default = {
       name: "@popcraft/runtime",
-      version: "0.58.1",
+      version: "0.59.0",
       description: "What code exported from PopCraft shares: the meaning of expressions (operators and functions) and, as it grows, the parts of a design's behaviour that are common code rather than generated React.",
       license: "MIT",
       homepage: "https://popcraft.app/docs/exporting/nextjs",
@@ -369945,6 +369953,7 @@ var init_sequence2 = __esm({
         length: external_exports.number().min(500).max(6e5).optional().describe("ms, default 3000.")
       }),
       expose: {
+        plugin: { method: "addTitle" },
         ui: { label: "Add a title", keywords: ["title", "text", "lower third", "subtitle", "caption", "name"], enabled: (c2) => inEdit(c2) },
         agent: { name: "add_title", description: "Put a title on a sequence: a new transparent frame (the sequence's size) with the text in a look \u2014 a big centred title, a lower third or a subtitle line \u2014 placed as a clip on a track above V1. Restyle or animate it in its frame like any text; change its words with set_text." }
       },
@@ -370005,6 +370014,7 @@ var init_sequence2 = __esm({
         clip: external_exports.string().optional().describe("The multicam clip (default: the picked one).")
       }),
       expose: {
+        plugin: { method: "syncAngles" },
         ui: { label: "Sync angles by sound", keywords: ["multicam", "sync", "align", "audio", "clap", "angles"], enabled: (c2) => withPicked(c2) },
         agent: { name: "sync_angles", description: "Line up a multicam clip's camera angles by their sound: each angle's audio is matched against the first one's (a clap, speech or music works) and moved so the same moment plays together. Runs in the editor (it decodes the sound)." }
       },
@@ -370078,6 +370088,7 @@ var init_sequence2 = __esm({
         multicam: external_exports.boolean().optional().describe("A multicam clip: each track of the picked clips is a camera angle (in sync as placed), and the clip shows one at a time \u2014 the first to start with; cut between them with edit_sequence `angle`.")
       }),
       expose: {
+        plugin: { method: "nestClips" },
         ui: { label: "Nest clips", keywords: ["nest", "precompose", "group", "sequence", "compound clip"], enabled: (c2) => withPicked(c2) },
         agent: { name: "nest_clips", description: "Nest clips on V2 and up into a new sequence (a precomp / compound clip), replaced by one clip of it on the lowest of their tracks. Its picture and sound play as before; open the new sequence to edit inside it." }
       },
@@ -370156,6 +370167,7 @@ var init_sequence2 = __esm({
         to: external_exports.number().min(-24).max(0).optional().describe("Peak level, dBFS (default \u22121).")
       }),
       expose: {
+        plugin: { method: "normalizeAudio" },
         ui: { label: "Normalize audio", keywords: ["normalize", "loudness", "level", "peak", "volume", "gain"], enabled: (c2) => inEdit(c2) },
         agent: { name: "normalize_audio", description: "Bring audio clips to one peak level (default \u22121 dBFS): each clip's level is scaled so its loudest sample reaches it. Runs in the editor (it reads the sound files)." }
       },
@@ -380984,16 +380996,16 @@ var init_api5 = __esm({
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/generated/runtime.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/generated/runtime.js
 var MAIN_RUNTIME, UI_RUNTIME;
 var init_runtime6 = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/generated/runtime.js"() {
-    MAIN_RUNTIME = '"use strict";\n(() => {\n  // src/runtime/rpc.ts\n  function createRpcClient() {\n    let port = null;\n    const queue = [];\n    const pending = {};\n    const listeners = {};\n    let nextId = 1;\n    function send(msg) {\n      if (port) port.postMessage(msg);\n      else queue.push(msg);\n    }\n    function call(method, params) {\n      return new Promise((resolve, reject) => {\n        const id = nextId++;\n        pending[id] = { resolve, reject };\n        send({ kind: "rpc", id, method, params });\n      });\n    }\n    function emit(event, data) {\n      for (const cb of (listeners[event] || []).slice()) {\n        try {\n          cb(data);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n    }\n    window.addEventListener("message", (e) => {\n      const data = e.data;\n      if (e.source !== window.parent || !data || data.type !== "popcraft-plugin-port" || port) return;\n      port = e.ports[0];\n      port.onmessage = (ev) => {\n        const m = ev.data || {};\n        if (m.kind === "result" && m.id !== void 0 && pending[m.id]) {\n          const p = pending[m.id];\n          delete pending[m.id];\n          if (m.error) p.reject(new Error(m.error));\n          else p.resolve(m.result);\n        } else if (m.kind === "event" && m.event) {\n          emit(m.event, m.data);\n        }\n      };\n      for (const msg of queue.splice(0)) port.postMessage(msg);\n    });\n    return {\n      call,\n      send,\n      on(event, cb) {\n        (listeners[event] = listeners[event] || []).push(cb);\n      },\n      off(event, cb) {\n        listeners[event] = (listeners[event] || []).filter((x) => x !== cb);\n      }\n    };\n  }\n\n  // src/runtime/main.ts\n  function clone(v) {\n    return v === void 0 ? {} : JSON.parse(JSON.stringify(v));\n  }\n  function createMainApi(rpc = createRpcClient()) {\n    const uiHandlers = [];\n    let uiOnMessage = null;\n    const uiQueue = [];\n    function deliverUI(msg) {\n      for (const cb of uiHandlers) {\n        try {\n          cb(msg);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n      if (typeof uiOnMessage === "function") {\n        try {\n          uiOnMessage(msg);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n    }\n    function flushUI() {\n      if (uiHandlers.length || typeof uiOnMessage === "function") uiQueue.splice(0).forEach(deliverUI);\n    }\n    rpc.on("uimessage", (msg) => {\n      if (!uiHandlers.length && typeof uiOnMessage !== "function") uiQueue.push(msg);\n      else deliverUI(msg);\n    });\n    let widgetDef = null;\n    const widgetQueue = [];\n    function renderWidget(state) {\n      const handlers = {};\n      function walk(el, path) {\n        if (!el || typeof el !== "object") return el;\n        const out = {};\n        for (const k of Object.keys(el)) {\n          const v = el[k];\n          if (k === "children") {\n            out.children = (Array.isArray(v) ? v : [v]).filter((c) => c !== null && c !== void 0 && c !== false).map((c, i) => walk(c, path + "." + i));\n          } else if (k === "onClick" && typeof v === "function") {\n            handlers[path] = v;\n            out.onClick = path;\n          } else {\n            out[k] = v;\n          }\n        }\n        return out;\n      }\n      return { tree: walk(widgetDef.render(state), "root"), handlers };\n    }\n    function initialWidgetState() {\n      const s = widgetDef && widgetDef.initialState;\n      return clone(typeof s === "function" ? s() : s);\n    }\n    function commitWidget(nodeId, state) {\n      return rpc.call("widgetUpdate", { id: nodeId, state, tree: renderWidget(clone(state)).tree });\n    }\n    function handleWidgetClick(e) {\n      Promise.resolve().then(() => {\n        const state = clone(e.state);\n        const rendered = renderWidget(state);\n        const h = rendered.handlers[e.handler] || widgetDef.handlers && widgetDef.handlers[e.handler];\n        if (typeof h !== "function") return;\n        return Promise.resolve(h(state, { nodeId: e.nodeId })).then((ret) => commitWidget(e.nodeId, ret === void 0 ? state : ret));\n      }).catch((err) => rpc.send({ kind: "error", message: String((err == null ? void 0 : err.message) || err) }));\n    }\n    rpc.on("widgetclick", (e) => {\n      if (widgetDef) handleWidgetClick(e);\n      else widgetQueue.push(e);\n    });\n    const popcraft = {\n      /** Which menu command the user picked, or null when the plugin ran some other way. */\n      command: null,\n      /** Host import mode when launched as an importer, else null. */\n      importMode: null,\n      /** Pending import file when the host handed one over, else null. */\n      importFile: null,\n      /** Pending export request (File \u2192 Export \u2192 this plugin\'s format), else null. */\n      exportRequest: null,\n      getSelection: () => rpc.call("getSelection"),\n      setSelection: (ids) => rpc.call("setSelection", { ids }),\n      getNode: (id) => rpc.call("getNode", { id }),\n      findNodes: (query) => rpc.call("findNodes", query || {}),\n      getCurrentPage: () => rpc.call("getCurrentPage"),\n      createNode: (type, props) => rpc.call("createNode", { type, props: props || {} }),\n      updateNode: (id, props) => rpc.call("updateNode", { id, props }),\n      deleteNode: (id) => rpc.call("deleteNode", { id }),\n      setText: (id, characters) => rpc.call("setText", { id, characters }),\n      /** Put TEXT layers on a path (another layer\'s outline, or their own arc, circle or wave), or tune one: brackets, alignment, placement, effect, overflow. */\n      setTextPath: (opts) => rpc.call("setTextPath", opts || {}),\n      /** Area type: flow a TEXT layer inside a closed shape, kept `inset` px in. */\n      flowTextIntoShape: (opts) => rpc.call("flowTextIntoShape", opts || {}),\n      /** Take TEXT layers off their path or out of their shape (or free every text linked to a path / shape). */\n      detachText: (opts) => rpc.call("detachText", opts || {}),\n      /** Auto-size TEXT layers\' type to their box, shape or path. */\n      setTextFit: (opts) => rpc.call("setTextFit", opts || {}),\n      createPage: (name) => rpc.call("createPage", name != null ? { name: String(name) } : {}),\n      setCurrentPage: (pageId) => rpc.call("setCurrentPage", { pageId }),\n      createImage: (opts) => rpc.call("createImage", opts || {}),\n      createDocument: (opts) => rpc.call("createDocument", opts || {}),\n      getImportMode: () => rpc.call("getImportMode"),\n      getImportFile: () => rpc.call("getImportFile"),\n      /**\n      * The open page as a storefront design in a neutral form, for an exporter that writes its own store\'s templates:\n      * each page\'s HTML with the store\'s data marked (`{{page.title}}`, `{{item.price}}`, `<!-- pc:each \u2026 -->` lists,\n      * `data-pc-action` forms), and its collections with their commerce schema and sample records.\n      */\n      getStorefront: () => rpc.call("getStorefront"),\n      /**\n      * A design\'s data (docs: Collections): a collection and its fields (`schema`: what it stands for, e.g.\n      * `commerce.product`, whose fields are made for it), its records, and reading them.\n      */\n      editCollection: (opts) => rpc.call("editCollection", opts || {}),\n      editRecords: (opts) => rpc.call("editRecords", opts || {}),\n      getRecords: (opts) => rpc.call("getRecords", opts || {}),\n      /** A layer as a web page\'s form control (a FORM\'s `formAction`, an INPUT\'s name and value), repeated per record, a page\'s address, its semantics. */\n      setControl: (opts) => rpc.call("setControl", opts || {}),\n      setRepeat: (opts) => rpc.call("setRepeat", opts || {}),\n      setRoute: (opts) => rpc.call("setRoute", opts || {}),\n      setSemantics: (opts) => rpc.call("setSemantics", opts || {}),\n      /** Which record layers are about (one product, picked from a collection), and which of its fields a layer\'s words, picture or an instance\'s properties follow. */\n      setRecord: (opts) => rpc.call("setRecord", opts || {}),\n      bindField: (opts) => rpc.call("bindField", opts || {}),\n      /** The site\'s environment: public settings its host reads by name when it is deployed (never a secret: the file keeps them). */\n      getSiteEnvironment: () => rpc.call("getSiteEnvironment"),\n      setSiteEnvironment: (set) => rpc.call("setSiteEnvironment", { set }),\n      /** What this plugin keeps with the open file (its settings for this design), under its own id; JSON only. */\n      getFileData: (key) => rpc.call("getFileData", { key }),\n      setFileData: (key, value) => rpc.call("setFileData", { key, value }),\n      /** A store\'s project built from the open page, zipped (needs `export`): what an exporter saves with `saveExport`. */\n      getStorefrontFiles: (target) => rpc.call("getStorefrontFiles", { target }),\n      getExportRequest: () => rpc.call("getExportRequest"),\n      /** Save the exporter\'s file (once per export request); the host enforces the contributed extension. */\n      saveExport: (file) => rpc.call("saveExport", file || {}),\n      /**\n      * Presentation audio (docs/plugins/presentation-audio.md): the deck\'s slides, notes, narration and timing; the\n      * soundtrack\'s settings, bed and stinger.\n      */\n      getPresentationAudio: (opts) => rpc.call("getPresentationAudio", opts || {}),\n      /** Change the soundtrack\'s settings (voice, style, mood, loudness, beat alignment, levels) and re-time it. */\n      setPresentationAudioSettings: (opts) => rpc.call("setPresentationAudioSettings", opts || {}),\n      /** Put a sound in (a slide\'s narration, the bed or the stinger): bytes are normalised to the soundtrack\'s target and stored. */\n      setPresentationAudioClip: (opts) => rpc.call("setPresentationAudioClip", opts || {}),\n      removePresentationAudioClip: (opts) => rpc.call("removePresentationAudioClip", opts || {}),\n      /** Re-time: fixed slide lengths (ms, null clears) and beat-aligned changes. */\n      setPresentationTiming: (opts) => rpc.call("setPresentationTiming", opts || {}),\n      /** The mix as the export carries it: loudness, true peak, and (wav: true) the 48 kHz stereo WAV. */\n      getPresentationMix: (opts) => rpc.call("getPresentationMix", opts || {}),\n      /** Ask the user to generate with AI (the panel opens with the request filled in; the user decides). */\n      requestPresentationAudio: (opts) => rpc.call("requestPresentationAudio", opts || {}),\n      /** Editor commands: each takes the arguments documented in docs/plugins/methods.md (the agent tool of the same purpose). */\n      moveNodes: (opts) => rpc.call("moveNodes", opts || {}),\n      resizeNodes: (opts) => rpc.call("resizeNodes", opts || {}),\n      renameNodes: (opts) => rpc.call("renameNodes", opts || {}),\n      reparentNodes: (opts) => rpc.call("reparentNodes", opts || {}),\n      duplicateNodes: (opts) => rpc.call("duplicateNodes", opts || {}),\n      groupNodes: (opts) => rpc.call("groupNodes", opts || {}),\n      ungroupNodes: (opts) => rpc.call("ungroupNodes", opts || {}),\n      alignNodes: (opts) => rpc.call("alignNodes", opts || {}),\n      distributeNodes: (opts) => rpc.call("distributeNodes", opts || {}),\n      flipNodes: (opts) => rpc.call("flipNodes", opts || {}),\n      rotateNodes: (opts) => rpc.call("rotateNodes", opts || {}),\n      reorderNodes: (opts) => rpc.call("reorderNodes", opts || {}),\n      setLocked: (opts) => rpc.call("setLocked", opts || {}),\n      setVisible: (opts) => rpc.call("setVisible", opts || {}),\n      setAutoLayout: (opts) => rpc.call("setAutoLayout", opts || {}),\n      importSvg: (opts) => rpc.call("importSvg", opts || {}),\n      measureNodes: (opts) => rpc.call("measureNodes", opts || {}),\n      setFills: (opts) => rpc.call("setFills", opts || {}),\n      setStrokes: (opts) => rpc.call("setStrokes", opts || {}),\n      setEffects: (opts) => rpc.call("setEffects", opts || {}),\n      replaceColor: (opts) => rpc.call("replaceColor", opts || {}),\n      setTypography: (opts) => rpc.call("setTypography", opts || {}),\n      applyStyle: (opts) => rpc.call("applyStyle", opts || {}),\n      createComponent: (opts) => rpc.call("createComponent", opts || {}),\n      createInstance: (opts) => rpc.call("createInstance", opts || {}),\n      renamePage: (opts) => rpc.call("renamePage", opts || {}),\n      getDocumentOutline: (opts) => rpc.call("getDocumentOutline", opts || {}),\n      setPageSetup: (opts) => rpc.call("setPageSetup", opts || {}),\n      setShowAdvance: (opts) => rpc.call("setShowAdvance", opts || {}),\n      booleanOperation: (opts) => rpc.call("booleanOperation", opts || {}),\n      flattenNodes: (opts) => rpc.call("flattenNodes", opts || {}),\n      outlineStroke: (opts) => rpc.call("outlineStroke", opts || {}),\n      setMask: (opts) => rpc.call("setMask", opts || {}),\n      setMaskType: (opts) => rpc.call("setMaskType", opts || {}),\n      shapeBuilder: (opts) => rpc.call("shapeBuilder", opts || {}),\n      setKeyframes: (opts) => rpc.call("setKeyframes", opts || {}),\n      getAnimation: (opts) => rpc.call("getAnimation", opts || {}),\n      getCompositions: (opts) => rpc.call("getCompositions", opts || {}),\n      editBehaviours: (opts) => rpc.call("editBehaviours", opts || {}),\n      setTimeline: (opts) => rpc.call("setTimeline", opts || {}),\n      setLayerTiming: (opts) => rpc.call("setLayerTiming", opts || {}),\n      editTextAnimation: (opts) => rpc.call("editTextAnimation", opts || {}),\n      edit3DScene: (opts) => rpc.call("edit3DScene", opts || {}),\n      setInstancePlayback: (opts) => rpc.call("setInstancePlayback", opts || {}),\n      editComponentProperty: (opts) => rpc.call("editComponentProperty", opts || {}),\n      setShaderFill: (opts) => rpc.call("setShaderFill", opts || {}),\n      createComposition: (opts) => rpc.call("createComposition", opts || {}),\n      editComposition: (opts) => rpc.call("editComposition", opts || {}),\n      /**\n       * Sequences (Edit mode): a composition as a multi-track timeline \u2014 V1 main scenes, V2\u2026 layered scenes / videos / stills,\n       * A1\u2026 audio. `editSequence({ id, op })` cuts, trims, slips, rolls, slides, places, stretches, blends, mixes and ducks\n       * (docs/plugins/methods.md); `getSequence({ id? })` reads it by track.\n       */\n      editSequence: (opts) => rpc.call("editSequence", opts || {}),\n      getSequence: (opts) => rpc.call("getSequence", opts || {}),\n      editStateMachine: (opts) => rpc.call("editStateMachine", opts || {}),\n      getStateMachine: (opts) => rpc.call("getStateMachine", opts || {}),\n      applyMotionPreset: (opts) => rpc.call("applyMotionPreset", opts || {}),\n      staggerMotion: (opts) => rpc.call("staggerMotion", opts || {}),\n      createMotionComponent: (opts) => rpc.call("createMotionComponent", opts || {}),\n      addAudio: (opts) => rpc.call("addAudio", opts || {}),\n      editFrameAudio: (opts) => rpc.call("editFrameAudio", opts || {}),\n      editVideoClip: (opts) => rpc.call("editVideoClip", opts || {}),\n      detectAudioOnsets: (opts) => rpc.call("detectAudioOnsets", opts || {}),\n      cutToBeat: (opts) => rpc.call("cutToBeat", opts || {}),\n      editPrototype: (opts) => rpc.call("editPrototype", opts || {}),\n      usePresentationFallbackAudio: (opts) => rpc.call("usePresentationFallbackAudio", opts || {}),\n      /** Bring a Lottie, PDF or PopCraft file into the open document (the `importFile` field is the file an importer was handed). */\n      importDocumentFile: (opts) => rpc.call("importDocumentFile", opts || {}),\n      getStyles: () => rpc.call("getStyles"),\n      createPaintStyle: (name, paints) => rpc.call("createPaintStyle", { name, paints }),\n      getVariables: () => rpc.call("getVariables"),\n      setVariableValue: (variableId, modeId, value) => rpc.call("setVariableValue", { variableId, modeId, value }),\n      exportNode: (id, options) => rpc.call("exportNode", { id, options: options || {} }),\n      openExternal: (url) => rpc.call("openExternal", { url }),\n      /**\n       * Send a file to an https URL. PopCraft makes the request, not the sandbox, so it works for files of\n       * any size the server accepts, including straight to a presigned storage URL. Needs `network`.\n       */\n      upload: (url, options) => {\n        const body = options.body instanceof ArrayBuffer ? new Uint8Array(options.body) : options.body;\n        return rpc.call("upload", {\n          url,\n          body,\n          method: options.method,\n          contentType: options.contentType,\n          headers: options.headers\n        });\n      },\n      notify: (message, options) => rpc.call("notify", { message: String(message), error: !!(options && options.error) }),\n      showUI: (options) => rpc.call("showUI", options || {}),\n      hideUI: () => rpc.call("hideUI"),\n      /** Ends the run. The optional message is shown as a notification. */\n      closePlugin: (message) => rpc.call("closePlugin", { message }),\n      storage: {\n        get: (key) => rpc.call("storageGet", { key }),\n        set: (key, value) => rpc.call("storageSet", { key, value })\n      },\n      ui: {\n        get onmessage() {\n          return uiOnMessage;\n        },\n        set onmessage(cb) {\n          uiOnMessage = cb;\n          flushUI();\n        },\n        postMessage: (msg) => rpc.send({ kind: "toUI", data: msg }),\n        on: (cb) => {\n          uiHandlers.push(cb);\n          flushUI();\n        }\n      },\n      widget: {\n        register(def) {\n          if (!def || typeof def.render !== "function") throw new Error("popcraft.widget.register needs a render(state) function");\n          widgetDef = def;\n          widgetQueue.splice(0).forEach(handleWidgetClick);\n        },\n        insert(options) {\n          if (!widgetDef) return Promise.reject(new Error("Call popcraft.widget.register first"));\n          const o = options || {};\n          const state = o.state !== void 0 ? clone(o.state) : initialWidgetState();\n          return rpc.call("widgetInsert", { state, tree: renderWidget(state).tree, x: o.x, y: o.y });\n        },\n        getState: (nodeId) => rpc.call("widgetGet", { id: nodeId }),\n        setState(nodeId, state) {\n          if (!widgetDef) return Promise.reject(new Error("Call popcraft.widget.register first"));\n          return commitWidget(nodeId, clone(state));\n        }\n      },\n      on: (event, cb) => rpc.on(event, cb),\n      off: (event, cb) => rpc.off(event, cb)\n    };\n    rpc.on("init", (data) => {\n      var _a, _b, _c;\n      popcraft.command = data.command;\n      popcraft.importMode = (_a = data.importMode) != null ? _a : null;\n      popcraft.importFile = (_b = data.importFile) != null ? _b : null;\n      popcraft.exportRequest = (_c = data.exportRequest) != null ? _c : null;\n    });\n    return popcraft;\n  }\n  function installMainApi() {\n    const rpc = createRpcClient();\n    const api = createMainApi(rpc);\n    const w = window;\n    w.__popcraftRpc = rpc;\n    w.popcraft = api;\n    w.vizpops = api;\n    window.addEventListener("error", (e) => rpc.send({ kind: "error", message: String(e.message || e) }));\n    window.addEventListener("unhandledrejection", (e) => rpc.send({ kind: "error", message: String(e.reason && e.reason.message || e.reason) }));\n    return api;\n  }\n\n  // src/runtime/main.entry.ts\n  installMainApi();\n})();';
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/generated/runtime.js"() {
+    MAIN_RUNTIME = '"use strict";\n(() => {\n  // src/runtime/rpc.ts\n  function createRpcClient() {\n    let port = null;\n    const queue = [];\n    const pending = {};\n    const listeners = {};\n    let nextId = 1;\n    function send(msg) {\n      if (port) port.postMessage(msg);\n      else queue.push(msg);\n    }\n    function call(method, params) {\n      return new Promise((resolve, reject) => {\n        const id = nextId++;\n        pending[id] = { resolve, reject };\n        send({ kind: "rpc", id, method, params });\n      });\n    }\n    function emit(event, data) {\n      for (const cb of (listeners[event] || []).slice()) {\n        try {\n          cb(data);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n    }\n    window.addEventListener("message", (e) => {\n      const data = e.data;\n      if (e.source !== window.parent || !data || data.type !== "popcraft-plugin-port" || port) return;\n      port = e.ports[0];\n      port.onmessage = (ev) => {\n        const m = ev.data || {};\n        if (m.kind === "result" && m.id !== void 0 && pending[m.id]) {\n          const p = pending[m.id];\n          delete pending[m.id];\n          if (m.error) p.reject(new Error(m.error));\n          else p.resolve(m.result);\n        } else if (m.kind === "event" && m.event) {\n          emit(m.event, m.data);\n        }\n      };\n      for (const msg of queue.splice(0)) port.postMessage(msg);\n    });\n    return {\n      call,\n      send,\n      on(event, cb) {\n        (listeners[event] = listeners[event] || []).push(cb);\n      },\n      off(event, cb) {\n        listeners[event] = (listeners[event] || []).filter((x) => x !== cb);\n      }\n    };\n  }\n\n  // src/runtime/main.ts\n  function clone(v) {\n    return v === void 0 ? {} : JSON.parse(JSON.stringify(v));\n  }\n  function createMainApi(rpc = createRpcClient()) {\n    const uiHandlers = [];\n    let uiOnMessage = null;\n    const uiQueue = [];\n    function deliverUI(msg) {\n      for (const cb of uiHandlers) {\n        try {\n          cb(msg);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n      if (typeof uiOnMessage === "function") {\n        try {\n          uiOnMessage(msg);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n    }\n    function flushUI() {\n      if (uiHandlers.length || typeof uiOnMessage === "function") uiQueue.splice(0).forEach(deliverUI);\n    }\n    rpc.on("uimessage", (msg) => {\n      if (!uiHandlers.length && typeof uiOnMessage !== "function") uiQueue.push(msg);\n      else deliverUI(msg);\n    });\n    let widgetDef = null;\n    const widgetQueue = [];\n    function renderWidget(state) {\n      const handlers = {};\n      function walk(el, path) {\n        if (!el || typeof el !== "object") return el;\n        const out = {};\n        for (const k of Object.keys(el)) {\n          const v = el[k];\n          if (k === "children") {\n            out.children = (Array.isArray(v) ? v : [v]).filter((c) => c !== null && c !== void 0 && c !== false).map((c, i) => walk(c, path + "." + i));\n          } else if (k === "onClick" && typeof v === "function") {\n            handlers[path] = v;\n            out.onClick = path;\n          } else {\n            out[k] = v;\n          }\n        }\n        return out;\n      }\n      return { tree: walk(widgetDef.render(state), "root"), handlers };\n    }\n    function initialWidgetState() {\n      const s = widgetDef && widgetDef.initialState;\n      return clone(typeof s === "function" ? s() : s);\n    }\n    function commitWidget(nodeId, state) {\n      return rpc.call("widgetUpdate", { id: nodeId, state, tree: renderWidget(clone(state)).tree });\n    }\n    function handleWidgetClick(e) {\n      Promise.resolve().then(() => {\n        const state = clone(e.state);\n        const rendered = renderWidget(state);\n        const h = rendered.handlers[e.handler] || widgetDef.handlers && widgetDef.handlers[e.handler];\n        if (typeof h !== "function") return;\n        return Promise.resolve(h(state, { nodeId: e.nodeId })).then((ret) => commitWidget(e.nodeId, ret === void 0 ? state : ret));\n      }).catch((err) => rpc.send({ kind: "error", message: String((err == null ? void 0 : err.message) || err) }));\n    }\n    rpc.on("widgetclick", (e) => {\n      if (widgetDef) handleWidgetClick(e);\n      else widgetQueue.push(e);\n    });\n    const popcraft = {\n      /** Which menu command the user picked, or null when the plugin ran some other way. */\n      command: null,\n      /** Host import mode when launched as an importer, else null. */\n      importMode: null,\n      /** Pending import file when the host handed one over, else null. */\n      importFile: null,\n      /** Pending export request (File \u2192 Export \u2192 this plugin\'s format), else null. */\n      exportRequest: null,\n      getSelection: () => rpc.call("getSelection"),\n      setSelection: (ids) => rpc.call("setSelection", { ids }),\n      getNode: (id) => rpc.call("getNode", { id }),\n      findNodes: (query) => rpc.call("findNodes", query || {}),\n      getCurrentPage: () => rpc.call("getCurrentPage"),\n      createNode: (type, props) => rpc.call("createNode", { type, props: props || {} }),\n      updateNode: (id, props) => rpc.call("updateNode", { id, props }),\n      deleteNode: (id) => rpc.call("deleteNode", { id }),\n      setText: (id, characters) => rpc.call("setText", { id, characters }),\n      /** Put TEXT layers on a path (another layer\'s outline, or their own arc, circle or wave), or tune one: brackets, alignment, placement, effect, overflow. */\n      setTextPath: (opts) => rpc.call("setTextPath", opts || {}),\n      /** Area type: flow a TEXT layer inside a closed shape, kept `inset` px in. */\n      flowTextIntoShape: (opts) => rpc.call("flowTextIntoShape", opts || {}),\n      /** Take TEXT layers off their path or out of their shape (or free every text linked to a path / shape). */\n      detachText: (opts) => rpc.call("detachText", opts || {}),\n      /** Auto-size TEXT layers\' type to their box, shape or path. */\n      setTextFit: (opts) => rpc.call("setTextFit", opts || {}),\n      createPage: (name) => rpc.call("createPage", name != null ? { name: String(name) } : {}),\n      setCurrentPage: (pageId) => rpc.call("setCurrentPage", { pageId }),\n      createImage: (opts) => rpc.call("createImage", opts || {}),\n      createDocument: (opts) => rpc.call("createDocument", opts || {}),\n      getImportMode: () => rpc.call("getImportMode"),\n      getImportFile: () => rpc.call("getImportFile"),\n      /**\n      * The open page as a storefront design in a neutral form, for an exporter that writes its own store\'s templates:\n      * each page\'s HTML with the store\'s data marked (`{{page.title}}`, `{{item.price}}`, `<!-- pc:each \u2026 -->` lists,\n      * `data-pc-action` forms), and its collections with their commerce schema and sample records.\n      */\n      getStorefront: () => rpc.call("getStorefront"),\n      /**\n      * A design\'s data (docs: Collections): a collection and its fields (`schema`: what it stands for, e.g.\n      * `commerce.product`, whose fields are made for it), its records, and reading them.\n      */\n      editCollection: (opts) => rpc.call("editCollection", opts || {}),\n      editRecords: (opts) => rpc.call("editRecords", opts || {}),\n      getRecords: (opts) => rpc.call("getRecords", opts || {}),\n      /** A layer as a web page\'s form control (a FORM\'s `formAction`, an INPUT\'s name and value), repeated per record, a page\'s address, its semantics. */\n      setControl: (opts) => rpc.call("setControl", opts || {}),\n      setRepeat: (opts) => rpc.call("setRepeat", opts || {}),\n      setRoute: (opts) => rpc.call("setRoute", opts || {}),\n      setSemantics: (opts) => rpc.call("setSemantics", opts || {}),\n      /** Which record layers are about (one product, picked from a collection), and which of its fields a layer\'s words, picture or an instance\'s properties follow. */\n      setRecord: (opts) => rpc.call("setRecord", opts || {}),\n      bindField: (opts) => rpc.call("bindField", opts || {}),\n      /** The site\'s environment: public settings its host reads by name when it is deployed (never a secret: the file keeps them). */\n      getSiteEnvironment: () => rpc.call("getSiteEnvironment"),\n      setSiteEnvironment: (set) => rpc.call("setSiteEnvironment", { set }),\n      /** What this plugin keeps with the open file (its settings for this design), under its own id; JSON only. */\n      getFileData: (key) => rpc.call("getFileData", { key }),\n      setFileData: (key, value) => rpc.call("setFileData", { key, value }),\n      /** A store\'s project built from the open page, zipped (needs `export`): what an exporter saves with `saveExport`. */\n      getStorefrontFiles: (target) => rpc.call("getStorefrontFiles", { target }),\n      getExportRequest: () => rpc.call("getExportRequest"),\n      /** Save the exporter\'s file (once per export request); the host enforces the contributed extension. */\n      saveExport: (file) => rpc.call("saveExport", file || {}),\n      /**\n      * Presentation audio (docs/plugins/presentation-audio.md): the deck\'s slides, notes, narration and timing; the\n      * soundtrack\'s settings, bed and stinger.\n      */\n      getPresentationAudio: (opts) => rpc.call("getPresentationAudio", opts || {}),\n      /** Change the soundtrack\'s settings (voice, style, mood, loudness, beat alignment, levels) and re-time it. */\n      setPresentationAudioSettings: (opts) => rpc.call("setPresentationAudioSettings", opts || {}),\n      /** Put a sound in (a slide\'s narration, the bed or the stinger): bytes are normalised to the soundtrack\'s target and stored. */\n      setPresentationAudioClip: (opts) => rpc.call("setPresentationAudioClip", opts || {}),\n      removePresentationAudioClip: (opts) => rpc.call("removePresentationAudioClip", opts || {}),\n      /** Re-time: fixed slide lengths (ms, null clears) and beat-aligned changes. */\n      setPresentationTiming: (opts) => rpc.call("setPresentationTiming", opts || {}),\n      /** The mix as the export carries it: loudness, true peak, and (wav: true) the 48 kHz stereo WAV. */\n      getPresentationMix: (opts) => rpc.call("getPresentationMix", opts || {}),\n      /** Ask the user to generate with AI (the panel opens with the request filled in; the user decides). */\n      requestPresentationAudio: (opts) => rpc.call("requestPresentationAudio", opts || {}),\n      /** Editor commands: each takes the arguments documented in docs/plugins/methods.md (the agent tool of the same purpose). */\n      moveNodes: (opts) => rpc.call("moveNodes", opts || {}),\n      resizeNodes: (opts) => rpc.call("resizeNodes", opts || {}),\n      renameNodes: (opts) => rpc.call("renameNodes", opts || {}),\n      reparentNodes: (opts) => rpc.call("reparentNodes", opts || {}),\n      duplicateNodes: (opts) => rpc.call("duplicateNodes", opts || {}),\n      groupNodes: (opts) => rpc.call("groupNodes", opts || {}),\n      ungroupNodes: (opts) => rpc.call("ungroupNodes", opts || {}),\n      alignNodes: (opts) => rpc.call("alignNodes", opts || {}),\n      distributeNodes: (opts) => rpc.call("distributeNodes", opts || {}),\n      flipNodes: (opts) => rpc.call("flipNodes", opts || {}),\n      rotateNodes: (opts) => rpc.call("rotateNodes", opts || {}),\n      reorderNodes: (opts) => rpc.call("reorderNodes", opts || {}),\n      setLocked: (opts) => rpc.call("setLocked", opts || {}),\n      setVisible: (opts) => rpc.call("setVisible", opts || {}),\n      setAutoLayout: (opts) => rpc.call("setAutoLayout", opts || {}),\n      importSvg: (opts) => rpc.call("importSvg", opts || {}),\n      measureNodes: (opts) => rpc.call("measureNodes", opts || {}),\n      setFills: (opts) => rpc.call("setFills", opts || {}),\n      setStrokes: (opts) => rpc.call("setStrokes", opts || {}),\n      setEffects: (opts) => rpc.call("setEffects", opts || {}),\n      replaceColor: (opts) => rpc.call("replaceColor", opts || {}),\n      setTypography: (opts) => rpc.call("setTypography", opts || {}),\n      applyStyle: (opts) => rpc.call("applyStyle", opts || {}),\n      createComponent: (opts) => rpc.call("createComponent", opts || {}),\n      createInstance: (opts) => rpc.call("createInstance", opts || {}),\n      renamePage: (opts) => rpc.call("renamePage", opts || {}),\n      getDocumentOutline: (opts) => rpc.call("getDocumentOutline", opts || {}),\n      setPageSetup: (opts) => rpc.call("setPageSetup", opts || {}),\n      setShowAdvance: (opts) => rpc.call("setShowAdvance", opts || {}),\n      booleanOperation: (opts) => rpc.call("booleanOperation", opts || {}),\n      flattenNodes: (opts) => rpc.call("flattenNodes", opts || {}),\n      outlineStroke: (opts) => rpc.call("outlineStroke", opts || {}),\n      setMask: (opts) => rpc.call("setMask", opts || {}),\n      setMaskType: (opts) => rpc.call("setMaskType", opts || {}),\n      shapeBuilder: (opts) => rpc.call("shapeBuilder", opts || {}),\n      setKeyframes: (opts) => rpc.call("setKeyframes", opts || {}),\n      getAnimation: (opts) => rpc.call("getAnimation", opts || {}),\n      getCompositions: (opts) => rpc.call("getCompositions", opts || {}),\n      editBehaviours: (opts) => rpc.call("editBehaviours", opts || {}),\n      setTimeline: (opts) => rpc.call("setTimeline", opts || {}),\n      setLayerTiming: (opts) => rpc.call("setLayerTiming", opts || {}),\n      editTextAnimation: (opts) => rpc.call("editTextAnimation", opts || {}),\n      edit3DScene: (opts) => rpc.call("edit3DScene", opts || {}),\n      setInstancePlayback: (opts) => rpc.call("setInstancePlayback", opts || {}),\n      editComponentProperty: (opts) => rpc.call("editComponentProperty", opts || {}),\n      setShaderFill: (opts) => rpc.call("setShaderFill", opts || {}),\n      createComposition: (opts) => rpc.call("createComposition", opts || {}),\n      editComposition: (opts) => rpc.call("editComposition", opts || {}),\n      /**\n       * Sequences (Edit mode): a composition as a multi-track timeline \u2014 V1 main scenes, V2\u2026 layered scenes / videos / stills,\n       * A1\u2026 audio. `editSequence({ id, op })` cuts, trims, slips, rolls, slides, places, stretches, blends, mixes and ducks\n       * (docs/plugins/methods.md); `getSequence({ id? })` reads it by track.\n       */\n      editSequence: (opts) => rpc.call("editSequence", opts || {}),\n      getSequence: (opts) => rpc.call("getSequence", opts || {}),\n      /** A title, lower third or subtitle as a clip on a track above V1 (`{ id?, text, style?, track?, start?, length? }`). */\n      addTitle: (opts) => rpc.call("addTitle", opts || {}),\n      /** Clips on V2 and up nested into a new sequence; `multicam: true` makes them camera angles (`{ id?, clips, multicam? }`). */\n      nestClips: (opts) => rpc.call("nestClips", opts || {}),\n      /** A multicam clip\'s angles lined up by their sound (`{ id?, clip }`). */\n      syncAngles: (opts) => rpc.call("syncAngles", opts || {}),\n      /** Audio clips brought to one peak level (`{ id?, clips?, to? }`, dBFS, default \u22121). */\n      normalizeAudio: (opts) => rpc.call("normalizeAudio", opts || {}),\n      editStateMachine: (opts) => rpc.call("editStateMachine", opts || {}),\n      getStateMachine: (opts) => rpc.call("getStateMachine", opts || {}),\n      applyMotionPreset: (opts) => rpc.call("applyMotionPreset", opts || {}),\n      staggerMotion: (opts) => rpc.call("staggerMotion", opts || {}),\n      createMotionComponent: (opts) => rpc.call("createMotionComponent", opts || {}),\n      addAudio: (opts) => rpc.call("addAudio", opts || {}),\n      editFrameAudio: (opts) => rpc.call("editFrameAudio", opts || {}),\n      editVideoClip: (opts) => rpc.call("editVideoClip", opts || {}),\n      detectAudioOnsets: (opts) => rpc.call("detectAudioOnsets", opts || {}),\n      cutToBeat: (opts) => rpc.call("cutToBeat", opts || {}),\n      editPrototype: (opts) => rpc.call("editPrototype", opts || {}),\n      usePresentationFallbackAudio: (opts) => rpc.call("usePresentationFallbackAudio", opts || {}),\n      /** Bring a Lottie, PDF or PopCraft file into the open document (the `importFile` field is the file an importer was handed). */\n      importDocumentFile: (opts) => rpc.call("importDocumentFile", opts || {}),\n      getStyles: () => rpc.call("getStyles"),\n      createPaintStyle: (name, paints) => rpc.call("createPaintStyle", { name, paints }),\n      getVariables: () => rpc.call("getVariables"),\n      setVariableValue: (variableId, modeId, value) => rpc.call("setVariableValue", { variableId, modeId, value }),\n      exportNode: (id, options) => rpc.call("exportNode", { id, options: options || {} }),\n      openExternal: (url) => rpc.call("openExternal", { url }),\n      /**\n       * Send a file to an https URL. PopCraft makes the request, not the sandbox, so it works for files of\n       * any size the server accepts, including straight to a presigned storage URL. Needs `network`.\n       */\n      upload: (url, options) => {\n        const body = options.body instanceof ArrayBuffer ? new Uint8Array(options.body) : options.body;\n        return rpc.call("upload", {\n          url,\n          body,\n          method: options.method,\n          contentType: options.contentType,\n          headers: options.headers\n        });\n      },\n      notify: (message, options) => rpc.call("notify", { message: String(message), error: !!(options && options.error) }),\n      showUI: (options) => rpc.call("showUI", options || {}),\n      hideUI: () => rpc.call("hideUI"),\n      /**\n       * Change the rail icon of one of this plugin\'s panels while it runs, e.g. to show a connection\'s state. Reset when\n       * the plugin stops.\n       */\n      setPanelIcon: (options) => rpc.call("setPanelIcon", options || {}),\n      /** Ends the run. The optional message is shown as a notification. */\n      closePlugin: (message) => rpc.call("closePlugin", { message }),\n      storage: {\n        get: (key) => rpc.call("storageGet", { key }),\n        set: (key, value) => rpc.call("storageSet", { key, value })\n      },\n      ui: {\n        get onmessage() {\n          return uiOnMessage;\n        },\n        set onmessage(cb) {\n          uiOnMessage = cb;\n          flushUI();\n        },\n        postMessage: (msg) => rpc.send({ kind: "toUI", data: msg }),\n        on: (cb) => {\n          uiHandlers.push(cb);\n          flushUI();\n        }\n      },\n      widget: {\n        register(def) {\n          if (!def || typeof def.render !== "function") throw new Error("popcraft.widget.register needs a render(state) function");\n          widgetDef = def;\n          widgetQueue.splice(0).forEach(handleWidgetClick);\n        },\n        insert(options) {\n          if (!widgetDef) return Promise.reject(new Error("Call popcraft.widget.register first"));\n          const o = options || {};\n          const state = o.state !== void 0 ? clone(o.state) : initialWidgetState();\n          return rpc.call("widgetInsert", { state, tree: renderWidget(state).tree, x: o.x, y: o.y });\n        },\n        getState: (nodeId) => rpc.call("widgetGet", { id: nodeId }),\n        setState(nodeId, state) {\n          if (!widgetDef) return Promise.reject(new Error("Call popcraft.widget.register first"));\n          return commitWidget(nodeId, clone(state));\n        }\n      },\n      on: (event, cb) => rpc.on(event, cb),\n      off: (event, cb) => rpc.off(event, cb)\n    };\n    rpc.on("init", (data) => {\n      var _a, _b, _c;\n      popcraft.command = data.command;\n      popcraft.importMode = (_a = data.importMode) != null ? _a : null;\n      popcraft.importFile = (_b = data.importFile) != null ? _b : null;\n      popcraft.exportRequest = (_c = data.exportRequest) != null ? _c : null;\n    });\n    return popcraft;\n  }\n  function installMainApi() {\n    const rpc = createRpcClient();\n    const api = createMainApi(rpc);\n    const w = window;\n    w.__popcraftRpc = rpc;\n    w.popcraft = api;\n    w.vizpops = api;\n    window.addEventListener("error", (e) => rpc.send({ kind: "error", message: String(e.message || e) }));\n    window.addEventListener("unhandledrejection", (e) => rpc.send({ kind: "error", message: String(e.reason && e.reason.message || e.reason) }));\n    return api;\n  }\n\n  // src/runtime/main.entry.ts\n  installMainApi();\n})();';
     UI_RUNTIME = '"use strict";\n(() => {\n  // src/runtime/rpc.ts\n  function createRpcClient() {\n    let port = null;\n    const queue = [];\n    const pending = {};\n    const listeners = {};\n    let nextId = 1;\n    function send(msg) {\n      if (port) port.postMessage(msg);\n      else queue.push(msg);\n    }\n    function call(method, params) {\n      return new Promise((resolve, reject) => {\n        const id = nextId++;\n        pending[id] = { resolve, reject };\n        send({ kind: "rpc", id, method, params });\n      });\n    }\n    function emit(event, data) {\n      for (const cb of (listeners[event] || []).slice()) {\n        try {\n          cb(data);\n        } catch (e) {\n          console.error(e);\n        }\n      }\n    }\n    window.addEventListener("message", (e) => {\n      const data = e.data;\n      if (e.source !== window.parent || !data || data.type !== "popcraft-plugin-port" || port) return;\n      port = e.ports[0];\n      port.onmessage = (ev) => {\n        const m = ev.data || {};\n        if (m.kind === "result" && m.id !== void 0 && pending[m.id]) {\n          const p = pending[m.id];\n          delete pending[m.id];\n          if (m.error) p.reject(new Error(m.error));\n          else p.resolve(m.result);\n        } else if (m.kind === "event" && m.event) {\n          emit(m.event, m.data);\n        }\n      };\n      for (const msg of queue.splice(0)) port.postMessage(msg);\n    });\n    return {\n      call,\n      send,\n      on(event, cb) {\n        (listeners[event] = listeners[event] || []).push(cb);\n      },\n      off(event, cb) {\n        listeners[event] = (listeners[event] || []).filter((x) => x !== cb);\n      }\n    };\n  }\n\n  // src/runtime/ui.ts\n  function createUiApi(rpc = createRpcClient()) {\n    const popcraft = {\n      onmessage: null,\n      postMessage: (msg) => rpc.send({ kind: "fromUI", data: msg }),\n      close: () => rpc.send({ kind: "closeUI" })\n    };\n    rpc.on("message", (msg) => {\n      if (typeof popcraft.onmessage === "function") popcraft.onmessage(msg);\n      window.dispatchEvent(new MessageEvent("message", { data: { pluginMessage: msg } }));\n    });\n    return popcraft;\n  }\n  function installUiApi() {\n    const rpc = createRpcClient();\n    const api = createUiApi(rpc);\n    const w = window;\n    w.__popcraftRpc = rpc;\n    w.popcraft = api;\n    w.vizpops = api;\n    return api;\n  }\n\n  // src/runtime/ui.entry.ts\n  installUiApi();\n})();';
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/host.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/host.js
 function csp(network) {
   const connect2 = network ? "connect-src * data: blob:;" : "connect-src 'none';";
   const img = network ? "img-src * data: blob:;" : "img-src data: blob:;";
@@ -381021,40 +381033,40 @@ function buildUIDocument(uiHtml, network) {
 }
 var escapeScript;
 var init_host2 = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/host.js"() {
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/host.js"() {
     init_runtime6();
     escapeScript = (code) => code.replace(/<\/script/gi, "<\\/script");
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/runtime/rpc.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/runtime/rpc.js
 var init_rpc = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/runtime/rpc.js"() {
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/runtime/rpc.js"() {
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/runtime/main.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/runtime/main.js
 var init_main = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/runtime/main.js"() {
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/runtime/main.js"() {
     init_rpc();
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/types.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/types.js
 var init_types10 = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/types.js"() {
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/types.js"() {
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/widget.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/widget.js
 var init_widget = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/widget.js"() {
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/widget.js"() {
   }
 });
 
-// node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/index.js
+// node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/index.js
 var init_dist = __esm({
-  "node_modules/.pnpm/@popcraft+plugins@1.4.0/node_modules/@popcraft/plugins/dist/index.js"() {
+  "node_modules/.pnpm/@popcraft+plugins@1.6.1/node_modules/@popcraft/plugins/dist/index.js"() {
     init_host2();
     init_main();
     init_runtime6();
@@ -381207,6 +381219,7 @@ function validateManifest(raw) {
         if (typeof pp.title !== "string" || !pp.title.trim()) throw new PluginPackageError(`${at5}.title must be a non-empty string`);
         if (pp.side !== void 0 && pp.side !== "left" && pp.side !== "right") throw new PluginPackageError(`${at5}.side must be "left" or "right"`);
         if (pp.command !== void 0 && typeof pp.command !== "string") throw new PluginPackageError(`${at5}.command must be a string`);
+        if (pp.autostart !== void 0 && typeof pp.autostart !== "boolean") throw new PluginPackageError(`${at5}.autostart must be true or false`);
         if (pp.icon !== void 0 && (typeof pp.icon !== "string" || !(DATA_ICON_RE.test(pp.icon) || ICON_PATH_RE.test(pp.icon)))) {
           throw new PluginPackageError(`${at5}.icon must be a data:image URL or the path of an .svg, .png or .webp file in the package`);
         }
@@ -381215,9 +381228,11 @@ function validateManifest(raw) {
           title: pp.title.trim(),
           ...pp.icon !== void 0 && { icon: pp.icon },
           ...pp.side !== void 0 && { side: pp.side },
-          ...pp.command !== void 0 && { command: pp.command }
+          ...pp.command !== void 0 && { command: pp.command },
+          ...pp.autostart === true && { autostart: true }
         };
       });
+      if (panels.filter((p2) => p2.autostart).length > 1) throw new PluginPackageError("manifest.contributes.panels: at most one panel may autostart");
       contributes = { ...contributes, panels };
     }
     if (c2.importers !== void 0) {
@@ -411140,6 +411155,7 @@ var init_plugin_import = __esm({
 var host_exports2 = {};
 __export(host_exports2, {
   attachPluginUI: () => attachPluginUI,
+  autostartPluginPanels: () => autostartPluginPanels,
   closeSession: () => closeSession,
   dispatchWidgetClick: () => dispatchWidgetClick,
   exportFileName: () => exportFileName2,
@@ -411275,6 +411291,13 @@ async function runPlugin(pluginId, commandId, opts = {}) {
         }
       }),
       hideUI: () => usePluginStore.getState().patchSession(sessionId, { ui: null }),
+      setPanelIcon: (o) => {
+        const panels = plugin.manifest.contributes?.panels ?? [];
+        const panel = o.panel ? panels.find((x2) => x2.id === o.panel) : panels[0];
+        if (!panel) throw new Error(o.panel ? `No panel "${o.panel}" in manifest.contributes.panels` : "This plugin has no panels in manifest.contributes.panels");
+        const tab = pluginPanelTab(pluginId, panel.id);
+        usePluginStore.getState().setPanelIcon(tab, o.icon ? { pluginId, icon: o.icon, color: !!o.color } : null);
+      },
       close: (message) => {
         const sel = message ? [...useEditorStore.getState().selection] : [];
         closeSession(sessionId);
@@ -411463,6 +411486,15 @@ function closeSession(sessionId) {
   s.uiPort?.close();
   s.iframe.remove();
   usePluginStore.getState().removeSession(sessionId);
+  usePluginStore.getState().clearPanelIcons(s.plugin.manifest.id);
+}
+function autostartPluginPanels(installed4) {
+  for (const p2 of installed4) {
+    if (!p2.enabled || p2.granted === null || !p2.manifest.main) continue;
+    const panel = p2.manifest.contributes?.panels?.find((x2) => x2.autostart);
+    if (!panel || runningSessionFor(p2.manifest.id)) continue;
+    void runPlugin(p2.manifest.id, panel.command ?? panel.id, { dock: pluginPanelTab(p2.manifest.id, panel.id) });
+  }
 }
 var running3;
 var init_host3 = __esm({
@@ -411594,7 +411626,7 @@ function pluginContext(env) {
       return out;
     },
     storage: { get: env.effects.storageGet, set: env.effects.storageSet },
-    panel: { showUI: env.effects.showUI, hideUI: env.effects.hideUI, close: env.effects.close }
+    panel: { showUI: env.effects.showUI, hideUI: env.effects.hideUI, close: env.effects.close, setPanelIcon: env.effects.setPanelIcon }
   };
   const st3 = () => env.getState();
   return {
@@ -411642,7 +411674,7 @@ function dispatchPluginCall(env, method, params2 = {}) {
     }
   });
 }
-var PLUGIN_CAPABILITIES, pluginCommandId, empty, MAX_UPLOAD_BYTES, MAX_UPLOAD_REPLY_CHARS, commands, pluginRun, registered;
+var PLUGIN_CAPABILITIES, pluginCommandId, empty, MAX_PANEL_ICON_CHARS, MAX_UPLOAD_BYTES, MAX_UPLOAD_REPLY_CHARS, commands, pluginRun, registered;
 var init_plugin = __esm({
   "lib/commands/plugin.ts"() {
     init_zod();
@@ -411658,6 +411690,7 @@ var init_plugin = __esm({
     PLUGIN_CAPABILITIES = ["render", "storage", "panel"];
     pluginCommandId = (method) => `plugin.${method}`;
     empty = external_exports.object({});
+    MAX_PANEL_ICON_CHARS = 64 * 1024;
     MAX_UPLOAD_BYTES = 500 * 1024 * 1024;
     MAX_UPLOAD_REPLY_CHARS = 1024 * 1024;
     commands = [
@@ -411802,6 +411835,33 @@ var init_plugin = __esm({
           return { summary: "UI shown" };
         }
       }),
+      defineCommand({
+        id: pluginCommandId("setPanelIcon"),
+        title: "Set panel icon",
+        domain: "ui",
+        params: external_exports.object({
+          panel: external_exports.string().optional(),
+          icon: external_exports.string().nullable().optional(),
+          color: external_exports.boolean().optional()
+        }),
+        effect: "none",
+        permission: null,
+        needs: ["panel"],
+        expose: { plugin: { method: "setPanelIcon" } },
+        run: (p2, ctx2) => {
+          const icon = p2.icon ?? null;
+          if (icon !== null && !/^data:image\/(svg\+xml|png|webp)[;,]/.test(icon)) {
+            throw new PluginApiError("icon must be a data:image/svg+xml, png or webp URL", "invalid_params");
+          }
+          if (icon !== null && icon.length > MAX_PANEL_ICON_CHARS) {
+            throw new PluginApiError(`icon is limited to ${MAX_PANEL_ICON_CHARS} characters`, "invalid_params");
+          }
+          const set4 = ctx2.use("panel").setPanelIcon;
+          if (!set4) throw new PluginApiError("Panel icons are not available here");
+          set4({ panel: p2.panel, icon, color: p2.color });
+          return { summary: icon ? "Panel icon set" : "Panel icon reset" };
+        }
+      }),
       defineCommand({
         id: pluginCommandId("hideUI"),
         title: "Hide plugin UI",
@@ -415149,8 +415209,8 @@ function themeCommand(themes) {
   });
 }
 function pluginCommand(plugins) {
-  const variants = plugins.filter((p2) => p2.enabled && (p2.manifest.commands?.length || true)).flatMap((p2) => {
-    const commands2 = p2.manifest.commands?.length ? p2.manifest.commands : [{ id: "run", label: "Run" }];
+  const variants = plugins.filter((p2) => p2.enabled).flatMap((p2) => {
+    const commands2 = p2.manifest.commands?.length ? p2.manifest.commands : p2.manifest.contributes?.panels?.length ? [] : [{ id: "run", label: "Run" }];
     return commands2.map((c2) => ({ id: `${p2.manifest.id}:${c2.id}`, label: `${p2.manifest.name}: ${c2.label}`, params: { pluginId: p2.manifest.id, commandId: c2.id } }));
   });
   return defineCommand({
@@ -426393,6 +426453,9 @@ async function runPluginHeadless(plugin, opts) {
       showUI: () => fail3(app("opens a panel")),
       hideUI: () => {
       },
+      // No rails headless: a panel icon has nowhere to show.
+      setPanelIcon: () => {
+      },
       close: (message) => finish3({ closed: true, message, errors: errors2 }),
       storageGet: async (key5) => storage[key5],
       storageSet: async (key5, value3) => {
@@ -426582,7 +426645,7 @@ init_resources();
 init_desktop();
 init_hypery();
 import { createInterface } from "node:readline";
-var VERSION2 = "0.58.1";
+var VERSION2 = "0.59.0";
 var HELP = `popcraft ${VERSION2} \u2014 the PopCraft command line
 
 Files (headless, on .popcraft files):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popcraft/cli",
-  "version": "0.58.1",
+  "version": "0.59.0",
   "description": "The PopCraft command line: edit .popcraft files headlessly, call the REST API, publish to the marketplace and manage the desktop app's local plugins, themes, fonts, skills and agents.",
   "license": "MIT",
   "homepage": "https://popcraft.app/docs/api/cli",
@@ -34,7 +34,7 @@
     "esbuild": "0.28.2"
   },
   "dependencies": {
-    "@popcraft/kit": "0.58.1"
+    "@popcraft/kit": "0.59.0"
   },
   "scripts": {
     "build": "node build.mjs",