@field/cascade 0.10.0 → 0.11.0

package/doc/PROJECT_AUTHORING.md

@@ -83,6 +83,13 @@ my-artwork/
 
 Keep generated output in a project-specific directory such as `renders/`. Keep reusable algorithms in `nodes/` or a normal TypeScript package rather than in Studio components.
 
+Before writing OKLCH conversions, a seeded generator, noise, paper, a pen plot,
+an ffmpeg call, a Cairn or Observatory loader or a disk cache, use the sketch
+kit, `@field/cascade-kit` (`packages/kit`, a `file:` dependency). It also
+generates the stubs for using another project's nodes without a symlink
+(`npx cascade-kit nodes <provider>`). Read [KIT.md](KIT.md). The kit is
+outside the core: Cascade never imports it.
+
 ## Add a project panel
 
 A project can provide an optional dockable Studio panel without adding UI code to Cascade. Create `panels/asset-browser/index.ts`:
@@ -191,6 +198,19 @@ image-api:
 
 The proxy accepts HTTPS only, refuses undeclared hosts, strips caller-supplied authorization headers, and never returns the credential value to the page. Studio defers its initial cook when a required credential is missing and links to File → Project Settings.
 
+## Design the graph, not one big node
+
+A piece is several nodes, each doing one job: load the data, lay it out, colour it, draw it, export it. The usage survey of November 2026 found the opposite in most projects (1 to 5 nodes of 300+ lines each over `lib/`), which leaves the graph as a parameter panel around opaque code. The graph is the record Marcus inspects, so each node boundary should be a place worth looking at, with the parameters that matter on it.
+
+Clean graph design is clean code design:
+
+- **One responsibility per node**, named for what it does (`layout_rings`, not `main`).
+- **Data flows through typed ports**, never through module-level state or files one node writes and another reads behind the graph's back.
+- **What varies is a parameter**; seeds, counts and colours are on the node, not constants in the code.
+- **Shared helpers go in `lib/` or the kit** (`KIT.md`); the node is the unit you compose and reuse.
+
+Split a node when it does two of load, generate, style, render and export, or when its `execute` grows past about 150 lines.
+
 ## Add a custom node
 
 Before writing one, check whether you need one. A parameter can hold an expression, so anything time-based is usually a parameter rather than a node. See [Animate a parameter](#animate-a-parameter). A node earns its place when it produces geometry or pixels, or when several parameters share a computation. The built-in library is listed in `NODE_REFERENCE.md`, generated from the definitions themselves; read that before searching for what a node does.
@@ -345,7 +365,7 @@ export async function execute(node: any) {
 
 `param()` is a method on the node the engine hands to `execute`, not an import. It is re-declared on every cook, so it never resets a value, an expression, or a keyframe someone set: reading `.value` gives the *resolved* value for the current frame, whichever of the three bindings is in force. The loader imports the module as real JavaScript, so top-level code does run at import time. Keep dynamic modules free of top-level effects and put interface declaration and cooking inside `execute`.
 
-Prefer `new OffscreenCanvas(width, height)` to `document.createElement('canvas')` when both hosts can run the node. A portable declaration still requires output parity checks; installing Skia does not override a browser-only declaration. Use Python for libraries or tools that require a server. Measure transport, serialization, and cold-start costs; persistent workers can avoid repeated process/model startup.
+Prefer `new OffscreenCanvas(width, height)` to `document.createElement('canvas')` when both hosts can run the node; a definition-v1 node uses `cascade/image` (see "Draw an image in any host"). A portable declaration still requires output parity checks; installing Skia does not override a browser-only declaration. Use Python for libraries or tools that require a server. Measure transport, serialization, and cold-start costs; persistent workers can avoid repeated process/model startup.
 
 Choose the narrowest execution locus:
 
@@ -367,6 +387,64 @@ export const definition = {
 
 The runtime refuses unsupported host/capability combinations before executing the graph.
 
+### Draw an image in any host
+
+A node that draws, reads or writes an image uses `cascade/image`, and then one
+body cooks in Studio, under `cascade run`/`render`/MCP, and in an exported
+editor's worker. Declare `runsOn: 'portable'` and `capabilities: ['assets']`,
+and import nothing host-specific: no `node:*`, no `@napi-rs/canvas`, no
+`document`.
+
+```ts
+import type { NodeDefinition, NodeExecutionContext } from 'cascade/contracts';
+import { readBytes, readImage, registerFont, surface, writeImage } from 'cascade/image';
+
+export const definition = {
+  apiVersion: 1,
+  label: 'Poster',
+  runsOn: 'portable',
+  capabilities: ['assets'],
+  inputs: { photo: { kind: 'data', type: 'image' } },
+  outputs: { image: { kind: 'data', type: 'image' } },
+  props: { title: { type: 'string', default: 'Hello' }, font: { type: 'string', default: 'assets/fonts/Display.otf' } },
+} as const satisfies NodeDefinition;
+
+export async function execute(context: NodeExecutionContext<typeof definition>) {
+  const photo = await readImage(context, context.inputs.photo);          // an image input, asset or project path
+  await registerFont('Display', await readBytes(context, context.props.font));
+  const { canvas, context: g } = surface(photo.width, photo.height);     // OffscreenCanvas, CPU-backed 2D
+  g.drawImage(photo, 0, 0);
+  g.font = '96px Display';
+  g.fillText(context.props.title, 40, 140);
+  context.outputs.image.set(await writeImage(context, canvas, `${context.nodeId}.png`));
+}
+```
+
+| | Browser (Studio, exported editor) | Headless (CLI, MCP) |
+| --- | --- | --- |
+| `createCanvas`, `surface` | the realm's `OffscreenCanvas` | Skia's, from `@napi-rs/canvas` |
+| `decodeImage`, `readImage` | `createImageBitmap` | Skia's decoder |
+| `writeImage` | an in-memory generated asset | `.cascade-cache/<name>.<hash>.png` |
+| `registerFont` | `FontFace` added to the page's or worker's font set | Skia's `GlobalFonts` |
+| `readBytes` | shipped files only (`editor.assets`, literal asset props, frozen files) | any project file |
+
+- The host chooses where a written image lands; never name a path or read an
+  output file back by a path you built. `cachePath` and `saveImage` from
+  `cascade/io` remain for dynamic nodes.
+- `surface(w, h)` asks for a `willReadFrequently` context, which keeps Chrome
+  on the same software Skia rasteriser the headless host uses. Expect the same
+  image, not the same bytes: on commons `plotter-social` the paper, foil and
+  wordmark match exactly and scanline marks differ at stroke edges (mean
+  channel delta under 0.5 of 255 with the same fonts).
+- A font only matches across hosts when both register the same bytes. A file
+  that is not there (a licensed face the export never ships) should fall back
+  to a named system face, not fail; read it with `readBytes` in a `try`.
+- What has no browser form is refused, not imitated: no canvas in the realm,
+  or `assets` not declared, throws a sentence saying which. A node that needs
+  the filesystem, a network fetch or ffmpeg stays `runsOn: 'server'`; to put
+  its output in an editor, freeze it (`cascade freeze <graph> <node> --fields
+  path,size,channels,depth,space` ships the image file with the snapshot).
+
 ### GPU nodes today
 
 A definition-v1 node may declare `capabilities: ['gpu']`. Studio and the optional
@@ -606,12 +684,54 @@ in `cascade run --json` under `stages`, and in the run trace.
   keeps running its old code in a live Studio. Its bytecode cache is keyed by
   the code hash, because Python accepts a `.pyc` whose source kept its size
   within the same second.
-- `cache` turns on Cascade's own result cache: `true`, or an object with
-  `exclude` (stages whose answer changes under an identical call) and
-  `outputs` (arguments naming files a stage writes, which are not inputs). Off
-  by default. A stored result is served only while every file it names still
-  has the bytes it had, so a stage that writes a fixed path and was re-run with
-  other inputs misses rather than serving the overwritten file.
+- `cache` controls Cascade's own result cache. A stored result is served only
+  while every file it names still has the bytes it had, so a stage that writes
+  a fixed path and was re-run with other inputs misses rather than serving the
+  overwritten file. See "The stage cache default" below.
+
+#### The stage cache default
+
+Since 6 Nov 2026 the cache is **on by default for the calls a node's cook
+makes**, and off for everything else. A node is a pure function of its inputs,
+so a stage it calls through `runStage` from `cascade/stage` is treated as pure:
+same stage code, same arguments, same input file bytes, same answer. A second
+identical cook is served from `.cascade/cache/stages/` without starting Python
+at all; on `cloud-plots/relief.cascade` that takes a re-cook from about 4.2 s
+to 0.45 s. A call from a panel (`api.runStage`) or a hand-rolled
+`fetch('/api/exec')` is an action — `plot-start`, `plot-status` — and is not
+cached unless you say so.
+
+What is not pure, and must be opted out:
+
+- a stage whose answer changes under an identical call: it reads the clock,
+  draws fresh randomness, queries a device or a job's progress, or calls a
+  network service whose answer you want fresh each time;
+- a stage that reads a file its arguments do not name (a config file, a folder
+  it scans, a model downloaded on the side). Only files named in the arguments
+  are hashed into the key, so an edit to an unnamed file is invisible;
+- a stage whose purpose is a side effect (copying to a named place, posting
+  somewhere). A result whose named files still have their bytes is served, so
+  a copy that already happened is not repeated; when the effect must happen
+  every time, opt the stage out.
+
+How to opt out:
+
+```json
+"cache": { "exclude": ["plot-status", "camera-grab"], "outputs": ["out", "svg_out"] }
+```
+
+| Declaration | What is cached |
+|---|---|
+| absent | calls from node cooks, except `exclude` (none) |
+| `{ "exclude": [...], "outputs": [...] }` | calls from node cooks, except the named stages |
+| `{ "scope": "all", ... }` or `true` | every call, panel actions included, except `exclude` |
+| `false` or `{ "enabled": false }` | nothing |
+
+`CASCADE_STAGE_CACHE=off` in the environment still turns it off for one
+process (`cascade parity` sets it). Every call's trace says what happened and
+why: `hit`, `miss (no entry)`, `off (excluded)`, `off (not a cook call)`,
+`off (not enabled)`. A project that keeps its own Python-side cache can keep
+it; Cascade's sits in front, and on a hit the project's code is not called.
 - A request carries `"cascade": {"key", "code", "cache"}` beside `args` (the
   worker), or `CASCADE_STAGE_ENVELOPE` in the environment (one-shot). A
   project that keeps its own cache should stand aside when `cache` is `"off"`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@field/cascade",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Visual programming for generative art",
   "license": "MIT",
   "author": "FIELD.IO <marcus@field.io>",
@@ -43,7 +43,8 @@
   ],
   "workspaces": [
     "packages/contracts",
-    "packages/runtime"
+    "packages/runtime",
+    "packages/kit"
   ],
   "bin": {
     "cascade": "./dist/cli/index.js"
@@ -105,6 +106,10 @@
       "types": "./dist/io.d.ts",
       "default": "./dist/io.js"
     },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "default": "./dist/image.js"
+    },
     "./gpu": {
       "types": "./dist/gpu.d.ts",
       "default": "./dist/gpu.js"
@@ -129,15 +134,22 @@
     "dev": "vite",
     "dev:client": "vite",
     "build": "node scripts/build.mjs",
-    "build:workspaces": "npm run build --workspace @cascade/contracts && npm run build --workspace @cascade/runtime",
+    "build:workspaces": "npm run build --workspace @cascade/contracts && npm run build --workspace @cascade/runtime && npm run build --workspace @field/cascade-kit",
+    "build:kit": "npm run build --workspace @field/cascade-kit",
+    "test:kit": "npm run test --workspace @field/cascade-kit",
     "build:packages": "npm run build:workspaces && node scripts/copy-package-builds.mjs",
     "check:packages": "npm run check --workspace @cascade/contracts && npm run build --workspace @cascade/contracts && npm run check --workspace @cascade/runtime",
-    "test:packages": "npm run test --workspace @cascade/contracts && npm run test --workspace @cascade/runtime",
+    "test:packages": "npm run test --workspace @cascade/contracts && npm run test --workspace @cascade/runtime && npm run test --workspace @field/cascade-kit",
     "build:cli": "node scripts/build.mjs --cli",
     "build:server": "npm --prefix server run build",
     "prepack": "npm run build",
     "preview": "vite preview",
     "check": "svelte-check --tsconfig ./tsconfig.json",
+    "verify": "node scripts/verify.mjs",
+    "verify:fast": "node scripts/verify.mjs --fast",
+    "check:architecture": "vitest run tests/architecture-",
+    "check:bundle": "node scripts/bundle-budget.mjs",
+    "check:node-reference": "tsx scripts/build-node-reference.mjs --check",
     "test": "vitest",
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",

package/dist/assets/ExportDialog-C7dVGua4.js

@@ -1,358 +0,0 @@
-import{At as e,Dt as t,G as n,Ot as r,Q as i,T as a,U as o,V as s,W as c,X as l,at as u,b as d,ct as f,d as p,dt as m,i as h,it as g,jt as _,l as v,lt as y,ot as b,pt as x,q as S,st as C,t as w,v as T,w as E,z as D}from"./legacy-CTEeXeqF.js";function O(e){let t=e.elements.filter(e=>!e.isAnnotation).map(e=>{let t=e;return{id:t.id,type:t.type,code:t.code,position:t.position,inputs:t.inputs.map(e=>({id:e.id,name:e.name,portType:e.portType,dataType:e.dataType,value:e.value,defaultValue:e.defaultValue})),outputs:t.outputs.map(e=>({id:e.id,name:e.name,portType:e.portType,dataType:e.dataType,value:e.value}))}}),n=e.connections.map(e=>({id:e.id,from:e.from,to:e.to,type:e.type})),r=e.elements.filter(e=>!e.isAnnotation).map(e=>e).filter(e=>e.inputs.every(e=>e.connections.length===0)).map(e=>e.id);return`
-const graphData = {
-  version: '1.0.0',
-  nodes: ${JSON.stringify(t,null,2)},
-  connections: ${JSON.stringify(n,null,2)},
-  entryPoints: ${JSON.stringify(r)}
-};
-  `.trim()}async function k(e){return new Promise((t,n)=>{let r=new FileReader;r.onloadend=()=>{let e=r.result.split(`,`)[1];t(e)},r.onerror=n,r.readAsDataURL(e)})}async function A(e){let t=[];for(let n of e)try{let e;if(n.type===`image`&&n.data instanceof HTMLImageElement){let t=document.createElement(`canvas`);t.width=n.data.width,t.height=n.data.height;let r=t.getContext(`2d`);r?(r.drawImage(n.data,0,0),e=t.toDataURL(`image/png`)):e=n.data.src}else if(n.type===`json`)e=`data:application/json;base64,${btoa(JSON.stringify(n.data))}`;else if(n.type===`text`)e=`data:text/plain;base64,${btoa(n.data)}`;else{let t=await(await fetch(n.path)).blob(),r=await k(t);e=`data:${t.type};base64,${r}`}t.push({id:n.id,path:n.path,dataUrl:e,type:n.type})}catch(e){console.warn(`Failed to embed asset ${n.path}:`,e)}return t}async function j(e,t=`Cascade Project`){let n=await A(e.assetManager.list()),r=O(e);return`<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${t}</title>
-  <style>
-    * {
-      margin: 0;
-      padding: 0;
-      box-sizing: border-box;
-    }
-    body {
-      width: 100vw;
-      height: 100vh;
-      overflow: hidden;
-      background: #0a0a0a;
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-    }
-    #cascade-root {
-      width: 100%;
-      height: 100%;
-    }
-  </style>
-</head>
-<body>
-  <div id="cascade-root"></div>
-  
-  <script>
-    // Minimal Cascade Runtime
-    ${M()}
-    
-    // Embedded assets
-    const ASSETS = ${JSON.stringify(n,null,2)};
-    
-    // Override fetch for asset loading
-    const originalFetch = window.fetch;
-    window.fetch = function(url) {
-      const asset = ASSETS.find(a => url.includes(a.path) || url.includes(a.id));
-      if (asset) {
-        return Promise.resolve(new Response(
-          dataUrlToBlob(asset.dataUrl)
-        ));
-      }
-      return originalFetch.apply(this, arguments);
-    };
-    
-    // Helper function
-    function dataUrlToBlob(dataUrl) {
-      const arr = dataUrl.split(',');
-      const mime = arr[0].match(/:(.*?);/)?.[1] || 'application/octet-stream';
-      const bstr = atob(arr[1]);
-      let n = bstr.length;
-      const u8arr = new Uint8Array(n);
-      while (n--) {
-        u8arr[n] = bstr.charCodeAt(n);
-      }
-      return new Blob([u8arr], { type: mime });
-    }
-    
-    // Compiled graph
-    ${r}
-    
-    // Start execution
-    Cascade.run(graphData, document.getElementById('cascade-root'));
-  <\/script>
-</body>
-</html>`}function M(){return`(function() {
-  'use strict';
-  
-  class CascadeRuntime {
-    static run(graphData, container) {
-      const graph = this.buildGraph(graphData);
-      
-      // Find entry points and start execution
-      const entryNodes = graphData.entryPoints
-        .map(id => graph.nodes.find(e => e.id === id))
-        .filter(Boolean);
-      
-      entryNodes.forEach(node => {
-        graph.execute(node);
-      });
-      
-      // Mount scene container
-      if (container && graph.sceneContainer) {
-        container.appendChild(graph.sceneContainer);
-      }
-    }
-    
-    static buildGraph(graphData) {
-      // Minimal Node class
-      class Node {
-        constructor(id, type) {
-          this.id = id;
-          this.type = type;
-          this.inputs = [];
-          this.outputs = [];
-          this.position = { x: 0, y: 0 };
-          this.code = '';
-        }
-        
-        in(name, defaultValue, options = {}) {
-          const port = {
-            id: this.id + '_in_' + name,
-            name,
-            portType: name === 'trigger' ? 'trigger' : 'param',
-            dataType: options.type || 'any',
-            value: defaultValue,
-            defaultValue,
-            options,
-            connections: []
-          };
-          this.inputs.push(port);
-          return port;
-        }
-        
-        out(name, portType = 'param') {
-          const port = {
-            id: this.id + '_out_' + name,
-            name,
-            portType,
-            dataType: 'any',
-            value: undefined,
-            connections: [],
-            setValue: (value) => {
-              port.value = value;
-              port.connections.forEach(conn => {
-                const targetNode = graph.nodes.find(e => e.id === conn.to.nodeId);
-                if (targetNode) {
-                  const targetPort = targetNode.inputs.find(p => p.id === conn.to.portId);
-                  if (targetPort) {
-                    targetPort.value = value;
-                    if (targetPort.onChange) targetPort.onChange(value);
-                  }
-                }
-              });
-            },
-            trigger: (props) => {
-              port.connections.forEach(conn => {
-                const targetNode = graph.nodes.find(e => e.id === conn.to.nodeId);
-                if (targetNode) {
-                  const targetPort = targetNode.inputs.find(p => p.id === conn.to.portId);
-                  if (targetPort && targetPort.onTrigger) {
-                    targetPort.onTrigger(props);
-                  }
-                }
-              });
-            }
-          };
-          this.outputs.push(port);
-          return port;
-        }
-        
-        setFunction(fn) {
-          this.nodeFunction = fn;
-        }
-        
-        async execute() {
-          if (this.nodeFunction) {
-            try {
-              await this.nodeFunction(this, graph);
-            } catch (err) {
-              console.error('Node execution error:', err);
-            }
-          }
-        }
-        
-        log(...args) {
-          console.log('[' + this.id + ']', ...args);
-        }
-        
-        async require(packageName, version) {
-          return graph.packageManager.load(packageName, version);
-        }
-      }
-      
-      // Minimal PackageManager for runtime
-      class PackageManager {
-        constructor() {
-          this.cache = new Map();
-        }
-        
-        async load(packageName, version = 'latest') {
-          const key = packageName + '@' + version;
-          if (this.cache.has(key)) {
-            return this.cache.get(key);
-          }
-          
-          const versionPart = version === 'latest' ? '' : '@' + version;
-          const url = 'https://esm.sh/' + packageName + versionPart;
-          
-          try {
-            const module = await import(url);
-            const result = module.default || module;
-            this.cache.set(key, result);
-            return result;
-          } catch (error) {
-            throw new Error('Failed to load package ' + key + ': ' + error.message);
-          }
-        }
-      }
-      
-      // Minimal Graph class
-      class Graph {
-        constructor() {
-          this.nodes = [];
-          this.connections = [];
-          this.sceneContainer = document.createElement('div');
-          this.sceneContainer.id = 'cascade-scene';
-          this.sceneContainer.style.width = '100%';
-          this.sceneContainer.style.height = '100%';
-          this.packageManager = new PackageManager();
-        }
-        
-        addNode(type, position) {
-          const id = 'node_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
-          const node = new Node(id, type);
-          node.position = position;
-          this.nodes.push(node);
-          return node;
-        }
-        
-        getNode(nodeId) {
-          return this.nodes.find(n => n.id === nodeId) || null;
-        }
-        
-        connect(fromPort, toPort) {
-          // Parse port IDs to extract element IDs and indices
-          const fromParts = fromPort.id.split('_');
-          const toParts = toPort.id.split('_');
-          const fromElementId = fromParts.slice(0, -2).join('_');
-          const toElementId = toParts.slice(0, -2).join('_');
-          
-          const connection = {
-            id: 'conn_' + Date.now(),
-            from: { nodeId: fromElementId, portId: fromPort.id },
-            to: { nodeId: toElementId, portId: toPort.id },
-            type: fromPort.portType
-          };
-          this.connections.push(connection);
-          fromPort.connections.push(connection);
-          toPort.connections.push(connection);
-          return connection;
-        }
-        
-        execute(entryNode) {
-          if (entryNode) {
-            entryNode.execute();
-          } else {
-            this.nodes.forEach(node => {
-              if (node.inputs.every(p => p.connections.length === 0)) {
-                node.execute();
-              }
-            });
-          }
-        }
-      }
-      
-      const graph = new Graph();
-      
-      // Create nodes
-      graphData.nodes.forEach(nodeData => {
-        const node = graph.addNode(nodeData.type, nodeData.position);
-        node.id = nodeData.id;
-        node.code = nodeData.code || '';
-        
-        // Restore ports
-        nodeData.inputs.forEach(portData => {
-          const port = node.in(portData.name, portData.defaultValue, { type: portData.dataType });
-          port.id = portData.id;
-          port.value = portData.value;
-        });
-        
-        nodeData.outputs.forEach(portData => {
-          const port = node.out(portData.name, portData.portType);
-          port.id = portData.id;
-          port.value = portData.value;
-        });
-        
-        // Compile and set function if code exists
-        if (node.code) {
-          try {
-            // Wrap code in async function to support top-level await
-            const wrappedCode = 'return (async function(node, graph) {
-' + node.code + '
-})(node, graph);';
-            const nodeFunction = new Function('node', 'graph', wrappedCode);
-            node.setFunction(nodeFunction);
-          } catch (err) {
-            console.warn('Failed to compile node ' + node.id + ':', err);
-          }
-        }
-      });
-      
-      // Restore connections
-      graphData.connections.forEach(connData => {
-        const fromNode = graph.getNode(connData.from.nodeId);
-        const toNode = graph.getNode(connData.to.nodeId);
-        if (fromNode && toNode) {
-          const fromPort = fromNode.outputs.find(p => p.id === connData.from.portId);
-          const toPort = toNode.inputs.find(p => p.id === connData.to.portId);
-          if (fromPort && toPort) {
-            graph.connect(fromPort, toPort);
-          }
-        }
-      });
-      
-      return graph;
-    }
-  }
-  
-  // Export to global
-  window.Cascade = CascadeRuntime;
-})();`}function N(e,t,n=`text/html`){let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,document.body.appendChild(a),a.click(),document.body.removeChild(a),URL.revokeObjectURL(i)}async function P(e,t=`Cascade Project`){let n=e.assetManager.list(),r=O(e),i=M(),a=`<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${t}</title>
-  <style>
-    * {
-      margin: 0;
-      padding: 0;
-      box-sizing: border-box;
-    }
-    body {
-      width: 100vw;
-      height: 100vh;
-      overflow: hidden;
-      background: #0a0a0a;
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-    }
-    #cascade-root {
-      width: 100%;
-      height: 100%;
-    }
-  </style>
-</head>
-<body>
-  <div id="cascade-root"></div>
-  
-  <script src="./runtime.js"><\/script>
-  <script src="./graph.js"><\/script>
-  <script>
-    // Start execution
-    Cascade.run(graphData, document.getElementById('cascade-root'));
-  <\/script>
-</body>
-</html>`,o=`// Minimal Cascade Runtime
-${i}`,s=`// Compiled graph
-${r}`,c=JSON.stringify(n.map(e=>({id:e.id,path:e.path,type:e.type,size:e.size})),null,2);N(a,`index.html`,`text/html`),setTimeout(()=>{N(o,`runtime.js`,`application/javascript`)},100),setTimeout(()=>{N(s,`graph.js`,`application/javascript`)},200),setTimeout(()=>{N(c,`assets.json`,`application/json`)},300),console.log(`Folder export initiated. Download the files and organize them in a folder structure:`),console.log(`- index.html`),console.log(`- runtime.js`),console.log(`- graph.js`),console.log(`- assets.json`),console.log(`- assets/ (create this folder and add your asset files)`)}var F=n(`<p class="svelte-12jesfv">This will export your project as a standalone HTML file with all assets embedded.</p> <ul class="svelte-12jesfv"><li class="svelte-12jesfv">✅ All nodes and connections</li> <li class="svelte-12jesfv">✅ All node code</li> <li class="svelte-12jesfv">✅ All assets (embedded as base64)</li> <li class="svelte-12jesfv">✅ Minimal runtime (~50KB)</li> <li class="svelte-12jesfv">✅ Single file - easy to share</li></ul>`,1),I=n(`<p class="svelte-12jesfv">This will export your project as a folder structure with separate files.</p> <ul class="svelte-12jesfv"><li class="svelte-12jesfv">✅ index.html - Main HTML file</li> <li class="svelte-12jesfv">✅ runtime.js - Cascade runtime</li> <li class="svelte-12jesfv">✅ graph.js - Compiled graph</li> <li class="svelte-12jesfv">✅ assets.json - Asset manifest</li> <li class="svelte-12jesfv">✅ assets/ - Asset files folder</li> <li class="svelte-12jesfv">⚠️ You'll need to manually organize asset files</li></ul>`,1),L=n(`<div class="error svelte-12jesfv"> </div>`),R=n(`<div class="overlay svelte-12jesfv"><div class="dialog svelte-12jesfv" role="dialog" aria-modal="true" aria-labelledby="export-title"><div class="header svelte-12jesfv"><h2 id="export-title" class="svelte-12jesfv">Export Project</h2> <button class="close-button svelte-12jesfv" aria-label="Close">×</button></div> <div class="content svelte-12jesfv"><div class="form-group svelte-12jesfv"><label for="project-name" class="svelte-12jesfv">Project Name</label> <input id="project-name" type="text" placeholder="My Project" class="svelte-12jesfv"/></div> <div class="form-group svelte-12jesfv"><label for="export-format" class="svelte-12jesfv">Export Format</label> <select id="export-format" class="svelte-12jesfv"><option>Single HTML File (all assets embedded)</option><option>Folder Structure (separate files)</option></select></div> <div class="info svelte-12jesfv"><!></div> <!></div> <div class="footer svelte-12jesfv"><button class="cancel-button svelte-12jesfv">Cancel</button> <button class="export-button svelte-12jesfv"><!></button></div></div></div>`);function z(n,O){r(O,!1);let k=h(O,`graph`,8),A=h(O,`open`,12,!1),M=w(),z=m(`Cascade Project`),B=m(!1),V=m(null),H=m(`html`);async function U(){if(!(!k()||i(B))){x(B,!0),x(V,null);try{i(H)===`html`?N(await j(k(),i(z)),`${i(z).replace(/[^a-z0-9]/gi,`_`).toLowerCase()}.html`,`text/html`):await P(k(),i(z)),setTimeout(()=>{A(!1),M(`close`)},500)}catch(e){x(V,e.message||`Failed to export project`),console.error(`Export error:`,e)}finally{x(B,!1)}}}function W(){A(!1),M(`close`)}function G(e){e.key===`Escape`&&W()}v();var K=c();l(`keydown`,u,G);var q=C(K),J=t=>{var n=R(),r=b(n),c=b(r),u=y(b(c),2);_(c);var m=y(c,2),h=b(m),v=y(b(h),2);d(v),_(h);var C=y(h,2),w=y(b(C),2),O=b(w);O.value=O.__value=`html`;var k=y(O);k.value=k.__value=`folder`,_(w),a(w),_(C);var A=y(C,2),j=b(A),M=t=>{var n=F();e(2),o(t,n)},N=t=>{var n=I();e(2),o(t,n)};D(j,e=>{i(H)===`html`?e(M):e(N,-1)}),_(A);var P=y(A,2),G=e=>{var t=L(),n=f(t,!0);g(()=>s(n,i(V))),o(e,t)};D(P,e=>{i(V)&&e(G)}),_(m);var K=y(m,2),q=b(K),J=y(q,2),Y=b(J),X=e=>{var t=S(`Exporting...`);o(e,t)},Z=e=>{var t=S();g(()=>s(t,`Export ${i(H)===`html`?`HTML`:`Folder`}`)),o(e,t)};D(Y,e=>{i(B)?e(X):e(Z,-1)}),_(J),_(K),_(r),_(n),g(()=>{v.disabled=i(B),w.disabled=i(B),q.disabled=i(B),J.disabled=i(B)}),l(`click`,u,W),T(v,()=>i(z),e=>x(z,e)),E(w,()=>i(H),e=>x(H,e)),l(`click`,q,W),l(`click`,J,U),l(`click`,n,p(W)),o(t,n)};D(q,e=>{A()&&e(J)}),o(n,K),t()}export{z as default};

package/dist/assets/ExportDialog-DOq0flMV.css

@@ -1 +0,0 @@
-.overlay.svelte-12jesfv{background:var(--shade-stronger);backdrop-filter:blur(4px);z-index:1000;justify-content:center;align-items:center;animation:.2s ease-out svelte-12jesfv-fadeIn;display:flex;position:fixed;inset:0}@keyframes svelte-12jesfv-fadeIn{0%{opacity:0}to{opacity:1}}.dialog.svelte-12jesfv{background:var(--surface-panel-alt);box-shadow:0 10px 40px var(--shadow);border-radius:8px;flex-direction:column;width:90%;max-width:500px;max-height:90vh;animation:.2s ease-out svelte-12jesfv-slideUp;display:flex}@keyframes svelte-12jesfv-slideUp{0%{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}}.header.svelte-12jesfv{border-bottom:1px solid var(--tint);justify-content:space-between;align-items:center;padding:20px;display:flex}.header.svelte-12jesfv h2:where(.svelte-12jesfv){color:var(--text-bright);margin:0;font-size:20px;font-weight:600}.close-button.svelte-12jesfv{color:var(--text-muted);cursor:pointer;background:0 0;border:none;border-radius:4px;justify-content:center;align-items:center;width:32px;height:32px;padding:0;font-size:24px;transition:all .15s;display:flex}.close-button.svelte-12jesfv:hover{background:var(--tint);color:var(--text-bright)}.content.svelte-12jesfv{flex:1;padding:20px;overflow-y:auto}.form-group.svelte-12jesfv{margin-bottom:20px}.form-group.svelte-12jesfv label:where(.svelte-12jesfv){color:var(--text-muted);margin-bottom:8px;font-size:12px;font-weight:500;display:block}.form-group.svelte-12jesfv input:where(.svelte-12jesfv){background:var(--shade-weak);border:1px solid var(--tint);width:100%;color:var(--text-bright);box-sizing:border-box;border-radius:4px;padding:10px;font-size:14px}.form-group.svelte-12jesfv input:where(.svelte-12jesfv):focus{border-color:var(--accent);outline:none}.form-group.svelte-12jesfv input:where(.svelte-12jesfv):disabled,.form-group.svelte-12jesfv select:where(.svelte-12jesfv):disabled{opacity:.5;cursor:not-allowed}.form-group.svelte-12jesfv select:where(.svelte-12jesfv){background:var(--shade-weak);border:1px solid var(--tint);width:100%;color:var(--text-bright);box-sizing:border-box;cursor:pointer;border-radius:4px;padding:10px;font-size:14px}.form-group.svelte-12jesfv select:where(.svelte-12jesfv):focus{border-color:var(--accent);outline:none}.info.svelte-12jesfv{background:var(--accent-tint-weak);border:1px solid var(--accent-tint-medium);border-radius:4px;margin-top:20px;padding:16px}.info.svelte-12jesfv p:where(.svelte-12jesfv){color:var(--text-bright);margin:0 0 12px;font-size:14px}.info.svelte-12jesfv ul:where(.svelte-12jesfv){color:var(--text-muted);margin:0;padding-left:20px;font-size:13px}.info.svelte-12jesfv li:where(.svelte-12jesfv){margin:4px 0}.error.svelte-12jesfv{background:var(--status-error-tint-weak);border:1px solid var(--status-error-tint-strong);color:var(--status-error);border-radius:4px;margin-top:16px;padding:12px;font-size:13px}.footer.svelte-12jesfv{border-top:1px solid var(--tint);justify-content:flex-end;gap:12px;padding:20px;display:flex}.cancel-button.svelte-12jesfv,.export-button.svelte-12jesfv{cursor:pointer;border:none;border-radius:4px;padding:10px 20px;font-size:14px;font-weight:500;transition:all .15s}.cancel-button.svelte-12jesfv{color:var(--text-muted);background:0 0}.cancel-button.svelte-12jesfv:hover:not(:disabled){background:var(--tint);color:var(--text-bright)}.export-button.svelte-12jesfv{background:var(--accent);color:var(--text-on-accent)}.export-button.svelte-12jesfv:hover:not(:disabled){background:var(--accent-strong)}.export-button.svelte-12jesfv:disabled,.cancel-button.svelte-12jesfv:disabled{opacity:.5;cursor:not-allowed}

package/dist/assets/geo-C2RHOVHC.js

@@ -1 +0,0 @@
-import{M as e,N as t,c as n,w as r}from"./index-DyvDC6pS.js";t(n,{assets:e});export{r as geoLibrary};

package/dist/assets/math-DaDEgWKt.js

@@ -1 +0,0 @@
-import{N as e,s as t}from"./index-DyvDC6pS.js";e(t,{});

package/dist/assets/pop-pLH7L0PW.js

@@ -1 +0,0 @@
-import{C as e,N as t,S as n}from"./index-DyvDC6pS.js";t(e,{});export{n as popLibrary};