@field/cascade 0.12.0 → 0.13.0

package/dist/cli/{commands-PHYFYA3F.js → commands-M2XLTPTZ.js}

@@ -1,6 +1,6 @@
 import {
   sceneDocument
-} from "./chunk-73S4JZXK.js";
+} from "./chunk-QAGATJGE.js";
 import {
   setEmbeddedCompiler,
   setProjectModuleCompiler
@@ -8,8 +8,8 @@ import {
 import {
   installHeadlessCanvas
 } from "./chunk-EZRWJ4G2.js";
-import "./chunk-3RXL5GHB.js";
-import "./chunk-OM6BEME6.js";
+import "./chunk-JEW5MPGI.js";
+import "./chunk-2L34ERS2.js";
 import {
   composeContactSheet
 } from "./chunk-53LGFPWX.js";
@@ -20,7 +20,7 @@ import {
   installProjectStages,
   moduleId,
   projectModuleFile
-} from "./chunk-MP653A5O.js";
+} from "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -43,7 +43,7 @@ import "./chunk-BZ63XQ3I.js";
 import {
   compileEmbedded,
   compileProjectModule
-} from "./chunk-EU4ZFZ7Y.js";
+} from "./chunk-W7OUAT7J.js";
 import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
@@ -52,7 +52,7 @@ import {
 } from "./chunk-5ORUQ6ES.js";
 import {
   ProjectRoot
-} from "./chunk-2JEU3MGB.js";
+} from "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -1371,4 +1371,4 @@ export {
   LOCK_HELP,
   runLockCommand
 };
-//# sourceMappingURL=commands-PHYFYA3F.js.map
+//# sourceMappingURL=commands-M2XLTPTZ.js.map

package/dist/cli/{doctorCommand-ORWQRNYP.js → doctorCommand-RAEI7GVY.js}

@@ -37,7 +37,7 @@ async function doctor(root, options = {}) {
   }
   if (hasStages(root)) {
     try {
-      const { ProjectRoot } = await import("./project-VYGIA7JX.js");
+      const { ProjectRoot } = await import("./project-SJF5ZF3F.js");
       const { readStageConfig } = await import("./stageRunner-KY2EJP7X.js");
       const { stageSources } = await import("./stageCache-TY2BFZJR.js");
       const project = new ProjectRoot(root);
@@ -103,4 +103,4 @@ export {
   importsModule,
   runDoctorCommand
 };
-//# sourceMappingURL=doctorCommand-ORWQRNYP.js.map
+//# sourceMappingURL=doctorCommand-RAEI7GVY.js.map

package/dist/cli/{editorCommands-NFR32JOY.js → editorCommands-5BBG4S6V.js}

@@ -3,11 +3,11 @@ import {
   EDITOR_HELP,
   runEditorCommand,
   sceneDocument
-} from "./chunk-73S4JZXK.js";
+} from "./chunk-QAGATJGE.js";
 import "./chunk-EZRWJ4G2.js";
-import "./chunk-3RXL5GHB.js";
-import "./chunk-OM6BEME6.js";
-import "./chunk-MP653A5O.js";
+import "./chunk-JEW5MPGI.js";
+import "./chunk-2L34ERS2.js";
+import "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -27,7 +27,7 @@ import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -38,4 +38,4 @@ export {
   runEditorCommand,
   sceneDocument
 };
-//# sourceMappingURL=editorCommands-NFR32JOY.js.map
+//# sourceMappingURL=editorCommands-5BBG4S6V.js.map

package/dist/cli/{graphCommands-EOUOBOIJ.js → graphCommands-MULQ7VD2.js}

@@ -6,7 +6,7 @@ import {
 // src/cli/graphCommands.ts
 import fs from "node:fs/promises";
 import path from "node:path";
-var loadGraphFile = async () => (await import("./graphFile-YTGJB5F5.js")).GraphFile;
+var loadGraphFile = async () => (await import("./graphFile-CITF36ZM.js")).GraphFile;
 async function runGraphCommand(args, options) {
   const parsed = parseArguments(args);
   const [command, ...rest] = parsed.positional;
@@ -181,4 +181,4 @@ export {
   applyEdits,
   runGraphCommand
 };
-//# sourceMappingURL=graphCommands-EOUOBOIJ.js.map
+//# sourceMappingURL=graphCommands-MULQ7VD2.js.map

package/dist/cli/{graphFile-YTGJB5F5.js → graphFile-CITF36ZM.js}

@@ -2,7 +2,7 @@ import {
   builtinModuleIds,
   diagnoseGraph,
   moduleDefinitions
-} from "./chunk-MP653A5O.js";
+} from "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -31,7 +31,7 @@ import "./chunk-WD62JIP6.js";
 import {
   writeFileAtomic
 } from "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -289,4 +289,4 @@ export {
   openGraph,
   serializeGraph
 };
-//# sourceMappingURL=graphFile-YTGJB5F5.js.map
+//# sourceMappingURL=graphFile-CITF36ZM.js.map

package/dist/cli/{helpCommand-PULH6ZYB.js → helpCommand-X2QDANM3.js}

@@ -76,7 +76,7 @@ async function findNode(type, project) {
 }
 async function projectDefinition(project, name) {
   if (!existsSync(path.join(project, "nodes", name, "index.ts"))) return void 0;
-  const { moduleDefinitions } = await import("./projectRuntime-2Q4JKEH3.js");
+  const { moduleDefinitions } = await import("./projectRuntime-NY4XMDFH.js");
   const definitions = await moduleDefinitions(path.join(project, "index.cascade"), [`project.${name}`]);
   return definitions.get(`project.${name}`);
 }
@@ -154,4 +154,4 @@ export {
   formatNode,
   runHelpCommand
 };
-//# sourceMappingURL=helpCommand-PULH6ZYB.js.map
+//# sourceMappingURL=helpCommand-X2QDANM3.js.map

package/dist/cli/index.js

@@ -22,16 +22,16 @@ var reported = (exitCode, run) => async () => {
 };
 var HANDLERS = {
   async studio(args) {
-    const { runStudioCli } = await import("./cliCommands-JJN5Z3ZC.js");
+    const { runStudioCli } = await import("./cliCommands-XVFRD7CF.js");
     await runStudioCli(args);
   },
   async run(args) {
     if (args.includes("--scene") || args.includes("--write")) return HANDLERS.editor(args, false);
-    const { runCommand } = await import("./runCommand-HNPQVZMS.js");
+    const { runCommand } = await import("./runCommand-XOG7AVC5.js");
     await runCommand(args);
   },
   async render(args, help) {
-    const { RENDER_HELP, parseRenderArgs, renderGraph } = await import("./render-PT4MWI6U.js");
+    const { RENDER_HELP, parseRenderArgs, renderGraph } = await import("./render-Y23W6MY6.js");
     if (help) {
       console.log(RENDER_HELP);
       return;
@@ -43,45 +43,45 @@ var HANDLERS = {
     })();
   },
   async renderWorker(args) {
-    const { runRenderWorker } = await import("./render-PT4MWI6U.js");
+    const { runRenderWorker } = await import("./render-Y23W6MY6.js");
     await runRenderWorker(args[1]);
   },
   async build(args) {
-    const { buildCommand } = await import("./runCommand-HNPQVZMS.js");
+    const { buildCommand } = await import("./runCommand-XOG7AVC5.js");
     await buildCommand(args);
   },
   async editor(args) {
-    const { runEditorCommand } = await import("./editorCommands-NFR32JOY.js");
+    const { runEditorCommand } = await import("./editorCommands-5BBG4S6V.js");
     await reported(1, () => runEditorCommand(args))();
   },
   async parity(args) {
     await reported(2, async () => {
-      const { runParityCommand } = await import("./parity-X6DEH2DV.js");
+      const { runParityCommand } = await import("./parity-3N3HTKWX.js");
       process.exitCode = await runParityCommand(args.slice(1));
     })();
   },
   async graph(args) {
-    const { runGraphCommand } = await import("./graphCommands-EOUOBOIJ.js");
+    const { runGraphCommand } = await import("./graphCommands-MULQ7VD2.js");
     await reported(1, async () => {
       await runGraphCommand(args, { json: false });
     })();
   },
   async lock(args, help) {
-    const { runLockCommand, LOCK_HELP } = await import("./commands-PHYFYA3F.js");
+    const { runLockCommand, LOCK_HELP } = await import("./commands-M2XLTPTZ.js");
     if (help) console.log(LOCK_HELP);
     else await runLockCommand(args);
   },
   async mcp(args) {
-    const { runMcpServer } = await import("./mcp-JVZFQOEX.js");
+    const { runMcpServer } = await import("./mcp-YRIGRLYQ.js");
     await runMcpServer(args.slice(1), VERSION);
   },
   async help(args, help) {
-    const { runHelpCommand, HELP_NODE_USAGE } = await import("./helpCommand-PULH6ZYB.js");
+    const { runHelpCommand, HELP_NODE_USAGE } = await import("./helpCommand-X2QDANM3.js");
     if (help) console.log(`Usage: ${HELP_NODE_USAGE}`);
     else await reported(1, () => runHelpCommand(args))();
   },
   async doctor(args, help) {
-    const { runDoctorCommand, DOCTOR_USAGE } = await import("./doctorCommand-ORWQRNYP.js");
+    const { runDoctorCommand, DOCTOR_USAGE } = await import("./doctorCommand-RAEI7GVY.js");
     if (help) console.log(`Usage: ${DOCTOR_USAGE}`);
     else await reported(1, () => runDoctorCommand(args))();
   }
@@ -100,7 +100,7 @@ async function main() {
     await runWithJsonEnvelope(async () => {
       if (opensStudio) throw new Error("This command opens Studio, which has no --json output");
       if (verb?.handler === "graph") {
-        const { runGraphCommand } = await import("./graphCommands-EOUOBOIJ.js");
+        const { runGraphCommand } = await import("./graphCommands-MULQ7VD2.js");
         return runGraphCommand(commandArgs, { json: true });
       }
       await dispatch(commandArgs);

package/dist/cli/{mcp-JVZFQOEX.js → mcp-YRIGRLYQ.js}

@@ -43,12 +43,12 @@ function toolRunner(call) {
   switch (call.kind) {
     case "edit":
       return async (args, server) => {
-        const { applyEdits } = await import("./graphCommands-EOUOBOIJ.js");
+        const { applyEdits } = await import("./graphCommands-MULQ7VD2.js");
         return captureEnvelope(() => applyEdits(server.resolve(args.graph), call.operations(args), { json: true, dryRun: args.dryRun === true }));
       };
     case "graph":
       return async (args, server) => {
-        const { runGraphCommand } = await import("./graphCommands-EOUOBOIJ.js");
+        const { runGraphCommand } = await import("./graphCommands-MULQ7VD2.js");
         return captureEnvelope(() => runGraphCommand(call.argv(args, (file) => server.resolve(file)), { json: true }));
       };
     case "cli":
@@ -161,4 +161,4 @@ export {
   handle,
   runMcpServer
 };
-//# sourceMappingURL=mcp-JVZFQOEX.js.map
+//# sourceMappingURL=mcp-YRIGRLYQ.js.map

package/dist/cli/{parity-X6DEH2DV.js → parity-3N3HTKWX.js}

@@ -10,7 +10,7 @@ import {
   createProjectHost,
   installProjectIo,
   installProjectStages
-} from "./chunk-MP653A5O.js";
+} from "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -33,14 +33,14 @@ import "./chunk-BZ63XQ3I.js";
 import {
   compileEmbedded,
   compileProjectModule
-} from "./chunk-EU4ZFZ7Y.js";
+} from "./chunk-W7OUAT7J.js";
 import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
 import {
   ProjectRoot
-} from "./chunk-2JEU3MGB.js";
+} from "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -331,4 +331,4 @@ export {
   runParityCommand,
   snapshotValue
 };
-//# sourceMappingURL=parity-X6DEH2DV.js.map
+//# sourceMappingURL=parity-3N3HTKWX.js.map

package/dist/cli/{project-VYGIA7JX.js → project-SJF5ZF3F.js}

@@ -1,7 +1,7 @@
 import {
   PathSafetyError,
   ProjectRoot
-} from "./chunk-2JEU3MGB.js";
+} from "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -9,4 +9,4 @@ export {
   PathSafetyError,
   ProjectRoot
 };
-//# sourceMappingURL=project-VYGIA7JX.js.map
+//# sourceMappingURL=project-SJF5ZF3F.js.map

package/dist/cli/{projectRuntime-2Q4JKEH3.js → projectRuntime-NY4XMDFH.js}

@@ -12,7 +12,7 @@ import {
   renderDeterministicProjectFrames,
   runDeterministicProjectGraph,
   validateProjectGraph
-} from "./chunk-MP653A5O.js";
+} from "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -32,7 +32,7 @@ import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -52,4 +52,4 @@ export {
   runDeterministicProjectGraph,
   validateProjectGraph
 };
-//# sourceMappingURL=projectRuntime-2Q4JKEH3.js.map
+//# sourceMappingURL=projectRuntime-NY4XMDFH.js.map

package/dist/cli/{render-PT4MWI6U.js → render-Y23W6MY6.js}

@@ -1,6 +1,6 @@
 import {
   runGraph
-} from "./chunk-ST6LROUG.js";
+} from "./chunk-OBZAP3GG.js";
 import "./chunk-2KXB47FP.js";
 import "./chunk-EZRWJ4G2.js";
 import {
@@ -16,7 +16,7 @@ import {
 import {
   parseEnvArgs
 } from "./chunk-ZL4JTG5Y.js";
-import "./chunk-MP653A5O.js";
+import "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -35,12 +35,12 @@ import {
 } from "./chunk-CO22XHNG.js";
 import "./chunk-LTXWBXOM.js";
 import "./chunk-BZ63XQ3I.js";
-import "./chunk-EU4ZFZ7Y.js";
+import "./chunk-W7OUAT7J.js";
 import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -180,12 +180,17 @@ function parseRenderArgs(args) {
 function sharedOutputPaths(a, b) {
   const shared = [];
   for (const output of a.outputs) {
+    if (isContentNamed(output.source)) continue;
     if (b.outputs.some((other) => other.nodeId === output.nodeId && other.source === output.source)) {
       shared.push({ nodeId: output.nodeId, source: output.source });
     }
   }
   return shared;
 }
+function isContentNamed(source) {
+  const clean = source.split("\\").join("/");
+  return /(?:^|\/)\.cascade-cache\//.test(clean) && /^[^.]*\.[0-9a-f]{12}(?:\.[^/]*)?$/.test(path.posix.basename(clean));
+}
 function fixedPathMessage(shared, a, b) {
   const nodes = shared.map(({ nodeId, source }) => `"${nodeId}" (${source})`).join(", ");
   return `Cannot render in parallel: ${shared.length === 1 ? "node" : "nodes"} ${nodes} wrote frames ${a} and ${b} to the same file, so workers would overwrite each other's frames and the sequence would silently mix them up. Give the output a per-frame path: put the frame in the file name, or save through saveImage(canvas, cachePath(context.nodeId, ".png")) from cascade/io or the assets capability, which name files by their content. Or render with --workers 1.`;
@@ -435,4 +440,4 @@ export {
   runRenderWorker,
   sharedOutputPaths
 };
-//# sourceMappingURL=render-PT4MWI6U.js.map
+//# sourceMappingURL=render-Y23W6MY6.js.map

package/dist/cli/{runCommand-HNPQVZMS.js → runCommand-XOG7AVC5.js}

@@ -155,7 +155,7 @@ async function runCommand(args) {
     process.exitCode = await superviseProcess(process.execPath, [...process.execArgv, process.argv[1], ...childArgs], ms);
     return;
   }
-  const { runGraph } = await import("./runner-5XPXVW7J.js");
+  const { runGraph } = await import("./runner-DNJO5WO2.js");
   try {
     if (options.json) console.log = console.error;
     await runGraph(options);
@@ -168,7 +168,7 @@ async function runCommand(args) {
   }
 }
 async function buildCommand(args) {
-  const { buildPlayer } = await import("./webBuild-WPPMGGW7.js");
+  const { buildPlayer } = await import("./webBuild-2K4COCGY.js");
   if (!args[1] || args[1].startsWith("-")) throw new Error("cascade build requires a graph file");
   let out;
   const assets = [];
@@ -195,4 +195,4 @@ export {
   buildCommand,
   runCommand
 };
-//# sourceMappingURL=runCommand-HNPQVZMS.js.map
+//# sourceMappingURL=runCommand-XOG7AVC5.js.map

package/dist/cli/{runner-5XPXVW7J.js → runner-DNJO5WO2.js}

@@ -2,14 +2,14 @@ import {
   RENDER_SUGGESTION_FRAMES,
   renderSuggestion,
   runGraph
-} from "./chunk-ST6LROUG.js";
+} from "./chunk-OBZAP3GG.js";
 import "./chunk-2KXB47FP.js";
 import "./chunk-EZRWJ4G2.js";
 import "./chunk-BP7UKF36.js";
 import "./chunk-RUU3YWXU.js";
 import "./chunk-7QE2ZNSN.js";
 import "./chunk-ZL4JTG5Y.js";
-import "./chunk-MP653A5O.js";
+import "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -25,12 +25,12 @@ import "./chunk-ICH7N5PN.js";
 import "./chunk-CO22XHNG.js";
 import "./chunk-LTXWBXOM.js";
 import "./chunk-BZ63XQ3I.js";
-import "./chunk-EU4ZFZ7Y.js";
+import "./chunk-W7OUAT7J.js";
 import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -40,4 +40,4 @@ export {
   renderSuggestion,
   runGraph
 };
-//# sourceMappingURL=runner-5XPXVW7J.js.map
+//# sourceMappingURL=runner-DNJO5WO2.js.map

package/dist/cli/{share-MHF6TNRK.js → share-B7HTCOJX.js}

@@ -3,9 +3,9 @@ import {
   exportEditor,
   scanForLeaks,
   vercelConfig
-} from "./chunk-3RXL5GHB.js";
-import "./chunk-OM6BEME6.js";
-import "./chunk-MP653A5O.js";
+} from "./chunk-JEW5MPGI.js";
+import "./chunk-2L34ERS2.js";
+import "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -25,7 +25,7 @@ import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -163,4 +163,4 @@ export {
   share,
   shareSlug
 };
-//# sourceMappingURL=share-MHF6TNRK.js.map
+//# sourceMappingURL=share-B7HTCOJX.js.map

package/dist/cli/{webBuild-WPPMGGW7.js → webBuild-2K4COCGY.js}

@@ -6,8 +6,8 @@ import {
   installRoot,
   playerFile,
   staticRuntimePlugin
-} from "./chunk-OM6BEME6.js";
-import "./chunk-MP653A5O.js";
+} from "./chunk-2L34ERS2.js";
+import "./chunk-QKL7CCRS.js";
 import "./chunk-MI5JLQYA.js";
 import "./chunk-GRIN2DDP.js";
 import "./chunk-X4WKAOQP.js";
@@ -27,7 +27,7 @@ import "./chunk-YH637PDL.js";
 import "./chunk-X566FWBV.js";
 import "./chunk-WD62JIP6.js";
 import "./chunk-5ORUQ6ES.js";
-import "./chunk-2JEU3MGB.js";
+import "./chunk-W5PJ5RMP.js";
 import "./chunk-NJFMDXHR.js";
 import "./chunk-J7VK7MNF.js";
 import "./chunk-FWMSGKEH.js";
@@ -41,4 +41,4 @@ export {
   playerFile,
   staticRuntimePlugin
 };
-//# sourceMappingURL=webBuild-WPPMGGW7.js.map
+//# sourceMappingURL=webBuild-2K4COCGY.js.map

package/dist/contracts/capabilities.d.ts

@@ -18,10 +18,31 @@ export interface ProgressReporter {
         detail?: JsonValue;
     }): void;
 }
+/**
+ * A cache a node finds again by its own key: `put(key, data)` then, on a later
+ * cook or run, `get(key)` returns those bytes (or null). Keys are path-like
+ * (`stage/3fa9c2…`, letters, digits, `.`, `_`, `-`, `/`-separated) and are never
+ * renamed by a content hash. Derive a key from everything the bytes depend on.
+ */
+export interface KeyedCache {
+    get(key: string, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<Uint8Array | null>;
+    put(key: string, data: Uint8Array, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<void>;
+}
+/**
+ * Project files. Reads resolve in the project (and `shared/` and the read-only
+ * roots cascade.json `reads` declares). Writes keep the name given, and go to
+ * `.cascade-cache/` or a folder cascade.json `writes` declares.
+ */
 export interface FileCapability {
     read(path: string, options: {
         signal: CascadeAbortSignal;
     }): Promise<Uint8Array>;
+    /** The keyed cache, under `.cascade-cache/keyed/`. */
+    readonly cache: KeyedCache;
     write(path: string, data: Uint8Array, options: {
         signal: CascadeAbortSignal;
     }): Promise<void>;

package/dist/player/app.js

@@ -308,7 +308,7 @@ async function startPlayer(options) {
   if (!root) throw new Error("Cascade player needs a document body or explicit root");
   const view = hostDocument.defaultView;
   const initial = readInitialState(view?.location.href);
-  const ui = createUi(hostDocument, root);
+  const ui = createUi(hostDocument, root, options.chrome ?? initial.chrome);
   let assets;
   let disposeIo;
   let gpu;
@@ -545,7 +545,7 @@ var BrowserPlayer = class {
     this.assertActive();
     let result;
     try {
-      result = await this.context.graph.run({ frame, fps: this.context.graph.getFps() });
+      result = await this.context.graph.run({ frame, fps: this.context.graph.getFps(), reuse: "strict" });
       this.settledRoots = outputValues(result);
       if (result.status !== "completed") throw resultError(result);
       if (!this.selected) this.selected = preferredOutput(result);
@@ -666,10 +666,11 @@ var BrowserPlayer = class {
     if (this.disposed) throw new Error("Cascade player is disposed");
   }
 };
-function createUi(hostDocument, root) {
+function createUi(hostDocument, root, chrome) {
   root.replaceChildren();
   root.dataset.cascadePlayer = "";
-  Object.assign(root.style, { display: "flex", flexDirection: "column", height: "100%", margin: "0", background: "#141414", color: "#eee", overflow: "hidden" });
+  Object.assign(root.style, { display: "flex", flexDirection: "column", height: "100%", margin: "0", overflow: "hidden" });
+  if (chrome) Object.assign(root.style, { background: "#141414", color: "#eee" });
   const toolbar = hostDocument.createElement("div");
   toolbar.dataset.cascadeControls = "";
   Object.assign(toolbar.style, { display: "flex", gap: "8px", padding: "8px", flex: "none", alignItems: "center" });
@@ -690,7 +691,8 @@ function createUi(hostDocument, root) {
   output.dataset.cascadeOutput = "";
   Object.assign(output.style, { display: "grid", placeItems: "center", flex: "1", minHeight: "0", minWidth: "0", overflow: "auto" });
   toolbar.append(play, frame);
-  root.append(toolbar, error, output);
+  if (chrome) root.append(toolbar);
+  root.append(error, output);
   return { play, frame, error, output };
 }
 function renderSceneCanvas(hostDocument, scene, width, height, stroke = [1, 1, 1, 1]) {
@@ -740,6 +742,7 @@ function readInitialState(href) {
     frame,
     fps,
     autoplay: query.get("autoplay") === "1",
+    chrome: query.get("chrome") !== "0",
     ...nodeId && port ? { output: { nodeId, port } } : {}
   };
 }

package/dist/player/embed.js

@@ -12,6 +12,8 @@ async function mountPlayer(container, options) {
   setQueryOption(url, "frame", options.frame ?? 1);
   setQueryOption(url, "fps", options.fps ?? 30);
   url.searchParams.set("autoplay", options.autoplay ? "1" : "0");
+  if (options.chrome === false) url.searchParams.set("chrome", "0");
+  else url.searchParams.delete("chrome");
   if (options.output) {
     url.searchParams.set("outputNode", options.output.nodeId);
     url.searchParams.set("outputPort", options.output.port);

package/dist/player/types.d.ts

@@ -32,4 +32,10 @@ export interface MountPlayerOptions {
     readonly fps?: number;
     readonly autoplay?: boolean;
     readonly output?: PlayerOutputSelection;
+    /**
+     * `false` shows the output alone on a transparent page: no dark frame, Play
+     * button or frame field. Errors still appear. Default `true`; the URL form
+     * is `?chrome=0`.
+     */
+    readonly chrome?: boolean;
 }