@field/cascade 0.11.0 → 0.12.0

package/doc/NODE_REFERENCE.md

@@ -589,6 +589,104 @@ Runs on `portable`.
 | --- | --- | --- | --- |
 | `geometry` | `geometry` |  |  |
 
+### `cascade.image.Blur`
+
+Blur — Box (three passes, fast) or true Gaussian blur.
+
+Runs on `portable`.
+
+**Inputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `method` | `string` | `"box"` |  |
+| `radius` | `float` | `5` | 0…100 |
+| `wrapEdges` | `bool` | `false` |  |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Checkers`
+
+Checkers — A checkerboard.
+
+Runs on `portable`.
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `color1` | `color` | `[1,1,1,1]` |  |
+| `color2` | `color` | `[0,0,0,1]` |  |
+| `mode` | `string` | `"size"` |  |
+| `size` | `float` | `32` | 1…512 |
+| `divisions` | `int` | `16` | 1…512 |
+| `centered` | `bool` | `false` |  |
+| `resolution` | `vec2i` | `[512,512]` | 1…4096 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Color`
+
+Color — A solid colour.
+
+Runs on `portable`.
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `color` | `color` | `[1,1,1,1]` |  |
+| `resolution` | `vec2i` | `[512,512]` | 1…4096 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Composite`
+
+Composite — Blend image2 over image1.
+
+Runs on `portable`.
+
+**Inputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image1` | `image` |  |  |
+| `image2` | `image` |  |  |
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `blendMode` | `string` | `"multiply"` |  |
+| `opacity` | `float` | `1` | 0…1 |
+| `outputResolution` | `string` | `"input1"` |  |
+| `customResolution` | `vec2i` | `[512,512]` | 1…4096 |
+| `fitMode` | `string` | `"fill"` |  |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
 ### `cascade.image.ContactSheet`
 
 Contact Sheet — Lay images out as one labelled grid.
@@ -622,6 +720,190 @@ Runs on `portable`.
 | `image` | `image` |  |  |
 | `asset` | `asset` |  |  |
 
+### `cascade.image.Image`
+
+File — An image file from the project, or an image input, optionally resized.
+
+Runs on `portable`.
+
+**Inputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `file` | `string` | `""` |  |
+| `resolutionMode` | `string` | `"original"` |  |
+| `maxResolution` | `vec2i` | `[2048,2048]` | 1…4096 |
+| `fixedResolution` | `vec2i` | `[512,512]` | 1…4096 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Noise`
+
+Noise — Fractal simplex noise, grey.
+
+Runs on `portable`.
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `seed` | `int` | `0` | 0…10000 |
+| `scale` | `float` | `0.01` | 0.001…1 |
+| `iterations` | `int` | `4` | 1…8 |
+| `resolution` | `vec2i` | `[512,512]` | 1…4096 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.NormalMap`
+
+Normal Map — A normal map from the red (or grey) channel as height.
+
+Runs on `portable`.
+
+**Inputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `scale` | `float` | `1` | 0…10 |
+| `flipX` | `bool` | `false` |  |
+| `flipY` | `bool` | `false` |  |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Ramp`
+
+Ramp — A colour ramp: horizontal, vertical, radial or concentric.
+
+Runs on `portable`.
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `type` | `string` | `"horizontal"` |  |
+| `points` | `array` | `[{"position":0,"color":{"r":0,"g":0,"b":0},"interpolation":"linear"},{"position":1,"color":{"r":1,"g":1,"b":1},"interpolation":"linear"}]` |  |
+| `resolution` | `vec2i` | `[512,512]` | 1…4096 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Resize`
+
+Resize — Scale an image, or resize it to a fixed size, bilinear.
+
+Runs on `portable`.
+
+**Inputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `mode` | `string` | `"scale"` |  |
+| `scale` | `float` | `1` | 0.1…10 |
+| `width` | `int` | `512` | 1…4096 |
+| `height` | `int` | `512` | 1…4096 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Text`
+
+Text — Text drawn with a CSS font family, or a font file from the project.
+
+Runs on `portable`.
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `text` | `string` | `"Hello, World!"` |  |
+| `font` | `string` | `"Inter, system-ui, sans-serif"` |  |
+| `fontSize` | `float` | `48` | 1…500 |
+| `fontWeight` | `string` | `"normal"` |  |
+| `fontStyle` | `string` | `"normal"` |  |
+| `alignH` | `string` | `"center"` |  |
+| `alignV` | `string` | `"middle"` |  |
+| `color` | `color` | `[1,1,1,1]` |  |
+| `backgroundColor` | `color` | `[0,0,0,0]` |  |
+| `resolution` | `vec2i` | `[512,512]` | 1…4096 |
+| `offset` | `vec2` | `[0,0]` | -2048…2048 |
+| `rotation` | `float` | `0` | -180…180 |
+| `letterSpacing` | `float` | `0` | -50…100 |
+| `lineHeight` | `float` | `1.2` | 0.5…3 |
+| `opacity` | `float` | `1` | 0…1 |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+### `cascade.image.Transform`
+
+Transform — Rotate, translate and scale an image about a pivot.
+
+Runs on `portable`.
+
+**Inputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
+**Props**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `translate` | `vec2` | `[0,0]` | -2048…2048 |
+| `rotation` | `float` | `0` | -180…180 |
+| `scale` | `vec2` | `[1,1]` | 0.01…10 |
+| `uniformScale` | `bool` | `true` |  |
+| `pivot` | `string` | `"center"` |  |
+| `customPivot` | `vec2` | `[0.5,0.5]` | 0…1 |
+| `filter` | `string` | `"bilinear"` |  |
+| `wrap` | `string` | `"clamp"` |  |
+
+**Outputs**
+
+| name | type | default | range |
+| --- | --- | --- | --- |
+| `image` | `image` |  |  |
+
 ### `cascade.math.Binary`
 
 Binary Math — Two values, one operation. Component-wise, and a scalar broadcasts against a vector.
@@ -1006,13 +1288,13 @@ Runs on `portable`.
 | --- | --- | --- | --- |
 | `scene` | `scene` |  |  |
 
-## Assertions, headless only
+## Assertions
 
 `cascade.assert.*` fail a `cascade run` (non-zero exit, the message in
 `run --json`'s `error.message`) when their check does not hold, and pass
-their input through. The CLI registers them; Studio does not yet, and shows
-them as unresolved. An image wired only into assertions still counts as the
-graph's final image for `run --out`.
+their input through. In Studio a failed assertion is the node's error. An image
+wired only into assertions still counts as the graph's final image for
+`run --out`.
 
 ### `cascade.assert.Equals`
 
@@ -1133,16 +1415,6 @@ under `src/nodes/<library>/nodes/`.
 ### Geometry — `cascade.geo.*`
 
 **Geometry.** `cascade.geo.Rectangle` (A closed four-point polygon, counter-clockwise from bottom-left.), `cascade.geo.Circle` (A closed circle, as one cubic Bezier chain or as a polygon of divisions segments.), `cascade.geo.Transform` (Translate, rotate and scale geometry about a pivot.), `cascade.geo.Merge` (Concatenate geometries, taking the union of their attributes.), `cascade.geo.CopyToPoints` (Instance one geometry onto every point of another.), `cascade.geo.SvgExport` (Write geometry as an SVG document, one group element per group.), `cascade.geo.Render` (Draw a scene through a camera, as a raster.), `cascade.geo.FromRects` (Convert rects into geometry, one closed polygon each, keeping the tag.)
-
-### Image — `cascade.image.*`
-
-**Create.** `Image` (Load images from files), `Color` (Create a solid color canvas), `Checkers` (Generate a checkerboard pattern), `Noise` (Generate procedural noise patterns), `Ramp` (Generate color ramps), `Text` (Render text with customizable font and style)
-
-**Filter.** `Blur` (Gaussian blur), `NormalMap` (Compute normal map from height map)
-
-**Transform.** `Transform` (2D rotation, translation, and scaling), `Resize` (Scale or resize an image)
-
-**Composite.** `Composite` (Blend two images together)
 ## A project's own nodes
 
 Not listed here, because they belong to the project rather than to Cascade. Ask

package/doc/PROJECT_AUTHORING.md

@@ -61,6 +61,40 @@ difference. Use a deliberate local package override
 for framework development rather than committing a machine-specific
 `file:../../Dev/cascade` dependency to a shared project.
 
+### Pin the core
+
+A sketch pins one published Cascade, exactly, rather than linking the live
+checkout, so a change on Cascade main cannot move its pixels until it opts in:
+
+```json
+"devDependencies": {
+  "cascade": "npm:@field/cascade@0.11.0",
+  "@field/cascade-kit": "file:../../Dev/cascade/packages/kit"
+}
+```
+
+Keep the dependency name `cascade`: imports stay `cascade/io`,
+`cascade/stage` and so on, which is what Studio's compiler resolves. Only the
+core is pinned; the kit is not on npm and stays a `file:` dependency. Commit
+the lockfile, since it holds the core's own dependencies (a newer
+`@napi-rs/canvas` shifts antialiasing by a few levels). To move from a link:
+
+```bash
+npm install --save-dev --save-exact cascade@npm:@field/cascade@0.11.0
+```
+
+If `node_modules/cascade` is still a link afterwards, or npm fails with
+`Cannot destructure property 'package' of 'node.target'`, the kit link is the
+cause: its target sits inside the checkout, whose own package is
+`@field/cascade`, so npm reuses the checkout. Move `node_modules` and
+`package-lock.json` aside, install with the kit removed from `package.json`,
+then add it back with `npm install --save-dev ../../Dev/cascade/packages/kit`.
+
+To bump: change the version, `npm install`, `npx cascade check <graph>`, and
+render a frame to compare. A sketch that needs something only on main (for
+example `cascade share` before it ships) keeps the `file:` link and says why in
+its README until the next release.
+
 `index.cascade` is the default graph name. A project may contain several `.cascade` files; pass one explicitly when there is no unambiguous default:
 
 ```bash
@@ -209,7 +243,7 @@ Clean graph design is clean code design:
 - **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.
+Split a node when it does two of load, generate, style, render and export, or when its `execute` grows past about 150 lines. `cascade check` warns on both (`shape/long-execute`, `shape/mixed-jobs`); the warnings are advice and never fail the check. Drawing with noise and colour is one job's worth of calls, so it only flags a module doing four of the five, or loading and exporting in the same node.
 
 ## Add a custom node
 
@@ -423,8 +457,8 @@ export async function execute(context: NodeExecutionContext<typeof definition>)
 | | 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` |
+| `decodeImage`, `readImage` | `createImageBitmap` | the pixels from memory while the run holds them, else Skia's decoder |
+| `writeImage` | an in-memory generated asset | `.cascade-cache/<name>.<hash>.png`, pixels held in memory and the file written behind |
 | `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 |
 
@@ -445,6 +479,38 @@ export async function execute(context: NodeExecutionContext<typeof definition>)
   its output in an editor, freeze it (`cascade freeze <graph> <node> --fields
   path,size,channels,depth,space` ships the image file with the snapshot).
 
+#### How an image travels between nodes
+
+An `image` port carries an `ImageRef` (a path plus size, channels, depth and
+space), never the pixels, so a value stays cheap to snapshot, hash, trace and
+send to Python. What sits behind the path is the host's business, and the
+headless host keeps it in memory:
+
+- `writeImage` (and `saveImage` in `cascade/io`) hands the canvas to the host
+  as `ImagePixels` (8-bit RGBA, sRGB, unpremultiplied, top row first: what
+  `getImageData` returns and what a PNG decodes to) through the optional
+  `assets.keepImage`. Under `cascade run`/`render` the host holds those pixels,
+  names the file by their hash, and writes a lossless PNG at zlib level 1
+  behind the run, off the main thread.
+- `readImage` (and `loadBitmap`/`loadImage`) asks `assets.imagePixels` first
+  and gets a canvas holding the pixels: no file read and no decode. The next
+  node sees the same numbers a PNG round trip would give it.
+- Anything that reads the path as a file gets a whole file: a Python stage
+  call, `assets.read`, a run's end, `freeze`, `lock` and `ladder` all wait for
+  the write behind, and so does every `runsOn: 'server'` node before it
+  starts, since it may read an input with `node:fs`. A run's saved outputs
+  (`--out`, `run --frames`, `render`) are encoded from the pixels at full
+  compression, never copied from the level-1 intermediate.
+- Hosts without `keepImage` (an exported editor, the web player, and Studio
+  for project nodes) encode and store as before, so a node written against
+  `readImage`/`writeImage` works unchanged in each. Studio gives `keepImage`
+  to the built-in image library only: its images stay in the page under
+  `.cascade-studio/…` paths, which `readImage`, `assets.read` and the Viewer
+  all resolve, but which name no file a server stage could open.
+
+On field-logo (12 canvas nodes at 1024²) this took a frame from 1,791 ms to
+about 860 ms; most of what remains is the nodes' own pixel loops.
+
 ### GPU nodes today
 
 A definition-v1 node may declare `capabilities: ['gpu']`. Studio and the optional
@@ -453,6 +519,26 @@ a cache scoped to each node instance for pipelines, samplers, and other
 resources that outlive one cook. The host clears cached resources on host
 disposal or device loss and requests a fresh device on a later cook.
 
+The device is asked for with every limit the adapter allows, not WebGPU's
+defaults: on an M3 Max that is 4 GiB per storage binding (default 128 MiB),
+1,024 invocations per workgroup (256), 32 KiB of workgroup storage (16 KiB) and
+10 storage buffers per stage (8). Read what you got from
+`context.capabilities.gpu.limits` and size buffers and workgroups from it. A
+node that cannot run below some limit declares it, and a smaller GPU then fails
+before the cook with a sentence naming the limit:
+
+```ts
+export const definition = {
+  apiVersion: 1,
+  runsOn: 'portable',
+  capabilities: ['gpu'],
+  gpuLimits: { maxStorageBufferBindingSize: 512 * 2 ** 20 },
+  // ...
+} as const;
+```
+
+`max*` limits are floors; `min*Alignment` limits are ceilings.
+
 Use `runsOn: 'portable'` for shared WebGPU code without browser APIs. Render into
 a texture and use `readTexture` from `cascade/gpu` for explicit RGBA8 pixels,
 then encode through the image/IO host. See [headless GPU rendering](HEADLESS_GPU.md)
@@ -684,6 +770,15 @@ 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.
+- `workers` (headless runs only) is how many warm workers `cascade run` keeps
+  for the project, and so how many independent nodes it cooks at once: sibling
+  stage calls in one frame (the morph's four renders) run side by side. Default
+  2–4, one per four cores and per 8 GB of memory; `CASCADE_STAGE_WORKERS`
+  overrides it, and `cascade render` workers keep one each. A second worker
+  starts only when a call finds the first busy. Nodes still start in the
+  graph's order, so the run trace lists them the same way every run; a stage
+  that writes a fixed path shared with another node is the one thing this can
+  break, and `"workers": 1` turns it off.
 - `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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@field/cascade",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Visual programming for generative art",
   "license": "MIT",
   "author": "FIELD.IO <marcus@field.io>",
@@ -147,6 +147,8 @@
     "check": "svelte-check --tsconfig ./tsconfig.json",
     "verify": "node scripts/verify.mjs",
     "verify:fast": "node scripts/verify.mjs --fast",
+    "verify:push": "node scripts/verify.mjs --push",
+    "prepare": "node scripts/install-hooks.mjs",
     "check:architecture": "vitest run tests/architecture-",
     "check:bundle": "node scripts/bundle-budget.mjs",
     "check:node-reference": "tsx scripts/build-node-reference.mjs --check",
@@ -183,6 +185,7 @@
     "svelte": "^5.0.0",
     "svelte-check": "^4.7.6",
     "tsx": "^4.23.12",
+    "typescript7": "npm:typescript@^7.0.2",
     "vite": "^8.2.2",
     "vitest": "^4.1.11"
   },

package/dist/assets/CodePanel-BU-autmq.js

@@ -1,2 +0,0 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/CodeEditor-4O7FQ__R.js","assets/legacy-CTEeXeqF.js","assets/nodeTypeUtils-BDJsc2Ks.js","assets/index-5ZtDAuy2.js","assets/index-client-DqYmKstU.js","assets/index-7vae6YFC.css","assets/editor.api-BNFb25CX.js","assets/editor-1FQrmyyI.css","assets/CodeEditor-DR7u0q7p.css"])))=>i.map(i=>d[i]);
-import{Dt as e,G as t,M as n,Ot as r,Q as i,U as a,V as o,W as s,Z as c,ct as l,dt as u,et as d,ht as f,i as p,it as m,jt as h,l as g,nt as _,ot as v,pt as y,r as b,rt as x,st as S,vt as C,yt as w,z as T}from"./legacy-CTEeXeqF.js";import{P as E,et as D}from"./index-5ZtDAuy2.js";var O=t(`<div class="loading svelte-1pkj8m">Loading editor...</div>`),k=t(`<div class="error svelte-1pkj8m">Loading...</div>`),A=t(`<div class="error svelte-1pkj8m"> </div>`),j=t(`<div class="panel-wrapper svelte-1pkj8m"><!></div>`);function M(t,M){r(M,!1);let N=()=>w(D,`$sharedContextStore`,P),[P,F]=C(),I=u(null);b(async()=>{let e=await E(()=>import(`./CodeEditor-4O7FQ__R.js`).then(e=>e.t),__vite__mapDeps([0,1,2,3,4,5,6,7,8]));y(I,e.default)});let L=p(M,`panelParams`,8),R=p(M,`panelApi`,8),z=p(M,`graph`,12,void 0),B=p(M,`onRecordHistory`,12,void 0),V=u(null),H=L()?.nodeId;function U(){R()?.close&&R().close()}_(()=>N(),()=>{N()&&(z(N().graph),B(N().onRecordHistory))}),_(()=>c(z()),()=>{z()&&H?y(V,z().getNode(H)||null):y(V,null)}),_(()=>(c(R()),i(V)),()=>{R()?.setTitle&&i(V)&&R().setTitle(`Code: ${i(V).id}`)}),x(),g();var W=j(),G=v(W),K=e=>{var t=s(),r=S(t);{let e=f(()=>(c(z()),d(()=>z().packageManager||null)));n(r,()=>i(I),(t,n)=>{n(t,{get node(){return i(V)},get graph(){return z()},get packageManager(){return i(e)},onClose:U,showCloseButton:!1,get onRecordHistory(){return B()}})})}a(e,t)},q=e=>{var t=O();a(e,t)},J=e=>{var t=k();a(e,t)},Y=e=>{var t=A(),n=l(t);m(()=>o(n,`Node not found: ${H??``}`)),a(e,t)};T(G,e=>{i(V)&&z()&&i(I)?e(K):i(I)?z()?e(Y,-1):e(J,2):e(q,1)}),h(W),a(t,W),e(),F()}export{M as default};

package/dist/assets/CustomNodeDialog-BRpDfOV5.js

@@ -1 +0,0 @@
-import{At as e,Dt as t,G as n,I as r,L as i,O as ee,Ot as a,Q as o,U as s,V as c,W as l,X as u,Z as d,_ as te,at as f,b as p,ct as m,d as h,dt as g,et as _,f as ne,i as v,it as y,jt as b,l as x,lt as S,nt as C,ot as w,p as re,pt as T,rt as E,s as ie,st as D,t as O,u as ae,v as k,z as A}from"./legacy-CTEeXeqF.js";import{H as j,U as M}from"./index-5ZtDAuy2.js";var N=n(`<span class="auto-badge svelte-1c1mvak">auto</span>`),P=n(`<span class="radio-path svelte-1c1mvak"> </span>`),F=n(`<input type="text" class="custom-base-input svelte-1c1mvak" placeholder="e.g., cascade.mylib.MyBaseNode" autocomplete="off"/>`),I=n(`<label><input type="radio" name="baseClass" class="svelte-1c1mvak"/> <div class="radio-content svelte-1c1mvak"><div class="radio-header svelte-1c1mvak"><span class="radio-label svelte-1c1mvak"> </span> <!></div> <!></div></label>`),oe=n(`<div class="dialog-overlay svelte-1c1mvak"><div class="dialog svelte-1c1mvak" role="dialog" aria-modal="true" aria-labelledby="custom-node-title"><div class="dialog-header svelte-1c1mvak"><h2 id="custom-node-title" class="svelte-1c1mvak">Create Custom Node</h2> <button class="close-button svelte-1c1mvak" aria-label="Close"><!></button></div> <form class="svelte-1c1mvak"><div class="form-group svelte-1c1mvak"><label for="node-name" class="svelte-1c1mvak">Node Name</label> <input id="node-name" type="text" placeholder="e.g., ParticleField" autocomplete="off" class="svelte-1c1mvak"/> <span class="hint svelte-1c1mvak">The display name for your node</span></div> <div class="form-group svelte-1c1mvak"><label for="module-path" class="svelte-1c1mvak">Module Path</label> <input id="module-path" type="text" placeholder="e.g., project.particle-field" autocomplete="off" class="svelte-1c1mvak"/> <span class="hint svelte-1c1mvak">Unique identifier for the node module <!></span></div> <div class="form-group svelte-1c1mvak"><span class="field-label svelte-1c1mvak">Base Class</span> <div class="base-class-options svelte-1c1mvak"></div></div> <div class="dialog-footer svelte-1c1mvak"><button type="button" class="cancel-button svelte-1c1mvak">Cancel</button> <button type="submit" class="create-button svelte-1c1mvak"><!> Create Node</button></div></form></div></div>`);function L(n,L){a(L,!1);let R=g(),se=[],z=v(L,`open`,12,!1),B=O(),V=g(``),H=g(``),U=g(`cascade.Node`),W=g(``),G=g(!0),K=[{id:`cascade.Node`,label:`Node`,description:`Base class for all nodes - use for general purpose computation`,template:`node`},{id:`cascade.image.ImageNodeBase`,label:`ImageNodeBase`,description:`Image processing base class with canvas/image utilities`,template:`image`},{id:`custom`,label:`Other`,description:`Specify a custom base class path`,template:`node`}];function ce(){T(G,!1)}function le(){let e=`local.${o(V).toLowerCase().replace(/[^a-z0-9]/g,``)}`;(o(H)===e||o(H)===``)&&T(G,!0)}function q(){if(!o(V).trim()||o(U)===`custom`&&!o(W).trim())return;let e=K.find(e=>e.id===o(U));B(`create`,{name:o(V).trim(),modulePath:o(H)||`local.${o(V).toLowerCase().replace(/[^a-z0-9]/g,``)}`,baseClass:o(R),template:e?.template||`node`}),Y()}function J(){Y(),B(`close`)}function Y(){T(V,``),T(H,``),T(U,`cascade.Node`),T(W,``),T(G,!0),z(!1)}function X(e){e.key===`Escape`?J():e.key===`Enter`&&!e.shiftKey&&(e.preventDefault(),q())}let Z=g();C(()=>(o(U),o(W)),()=>{T(R,o(U)===`custom`?o(W):o(U))}),C(()=>(o(G),o(V)),()=>{if(o(G)&&o(V)){let e=o(V).toLowerCase().replace(/[^a-z0-9]/g,``);T(H,`local.${e}`)}}),C(()=>(d(z()),o(Z)),()=>{z()&&o(Z)&&setTimeout(()=>o(Z)?.focus(),50)}),E(),x();var Q=l();u(`keydown`,f,X);var $=D(Q),ue=t=>{var n=oe(),a=w(n),l=w(a),d=S(w(l),2),f=w(d);M(f,{size:18}),b(d),b(l);var g=S(l,2),v=w(g),x=S(w(v),2);p(x),re(x,e=>T(Z,e),()=>o(Z)),e(2),b(v);var C=S(v,2),E=S(w(C),2);p(E);var D=S(E,2),O=S(w(D)),R=e=>{var t=N();s(e,t)};A(O,e=>{o(G)&&e(R)}),b(D),b(C);var z=S(C,2),B=S(w(z),2);r(B,5,()=>K,i,(e,t)=>{var n=I();let r;var i=w(n);p(i);var a,l=S(i,2),d=w(l),f=w(d),h=m(f,!0),g=S(f,2),v=e=>{var n=P(),r=m(n,!0);y(()=>c(r,(o(t),_(()=>o(t).id)))),s(e,n)};A(g,e=>{o(t),_(()=>o(t).id!==`custom`)&&e(v)}),b(d);var x=S(d,2),C=e=>{var t=F();p(t),k(t,()=>o(W),e=>T(W,e)),u(`click`,t,ne(function(e){ie.call(this,L,e)})),s(e,t)};A(x,e=>{o(t),o(U),_(()=>o(t).id===`custom`&&o(U)===`custom`)&&e(C)}),b(l),b(n),y(()=>{r=ee(n,1,`radio-option svelte-1c1mvak`,null,r,{selected:o(U)===o(t).id}),a!==(a=(o(t),_(()=>o(t).id)))&&(i.value=(i.__value=a)??``),c(h,(o(t),_(()=>o(t).label)))}),te(se,[],i,()=>(o(t),_(()=>o(t).id),o(U)),e=>T(U,e)),s(e,n)}),b(B),b(z);var Y=S(z,2),X=w(Y),Q=S(X,2),$=w(Q);j($,{name:`Zap`,size:14}),e(),b(Q),b(Y),b(g),b(a),b(n),y(e=>Q.disabled=e,[()=>(o(V),o(U),o(W),_(()=>!o(V).trim()||o(U)===`custom`&&!o(W).trim()))]),u(`click`,d,J),k(x,()=>o(V),e=>T(V,e)),u(`input`,x,le),k(E,()=>o(H),e=>T(H,e)),u(`input`,E,ce),u(`click`,X,J),u(`submit`,g,ae(q)),u(`click`,n,h(J)),s(t,n)};A($,e=>{z()&&e(ue)}),s(n,Q),t()}export{L as default};

package/dist/assets/OpenGraphDialog-BwbRlC0X.js

@@ -1 +0,0 @@
-import{Dt as e,G as t,I as n,O as r,Ot as i,Q as a,U as o,V as s,W as c,X as l,Z as u,at as d,ct as f,d as p,dt as m,et as h,i as g,it as _,jt as v,l as y,lt as b,nt as x,ot as S,pt as C,rt as w,st as T,t as E,x as D,z as O}from"./legacy-CTEeXeqF.js";import{U as k}from"./index-5ZtDAuy2.js";var A=t(`<p class="root svelte-1j8ra8p"> </p>`),j=t(`<p class="note svelte-1j8ra8p">Loading…</p>`),M=t(`<p class="note error svelte-1j8ra8p"> </p>`),N=t(`<p class="note svelte-1j8ra8p">No <code>.cascade</code> files at the project root.</p>`),P=t(`<span class="tag svelte-1j8ra8p">open</span>`),F=t(`<li><button><span class="name"> </span> <!></button></li>`),I=t(`<ul class="graphs svelte-1j8ra8p"></ul>`),L=t(`<div class="dialog-overlay svelte-1j8ra8p"><div class="dialog svelte-1j8ra8p" role="dialog" aria-modal="true" aria-labelledby="open-graph-title"><div class="dialog-header svelte-1j8ra8p"><h2 id="open-graph-title" class="svelte-1j8ra8p">Open graph</h2> <button class="close-button svelte-1j8ra8p" aria-label="Close"><!></button></div> <!> <div class="body svelte-1j8ra8p"><!></div> <div class="dialog-footer svelte-1j8ra8p"><button class="secondary svelte-1j8ra8p">Open from this computer…</button></div></div></div>`);function R(t,R){i(R,!1);let z=g(R,`open`,8,!1),B=g(R,`current`,8,null),V=E(),H=m([]),U=m(``),W=m(!1),G=m(null);async function K(){C(W,!0),C(G,null);try{let e=await fetch(`/api/graph`);if(!e.ok)throw Error(await e.text());let t=await e.json();C(H,Array.isArray(t.graphs)?t.graphs:[]),C(U,typeof t.root==`string`?t.root:``)}catch(e){C(G,e instanceof Error?e.message:String(e)),C(H,[])}finally{C(W,!1)}}function q(e){V(`choose`,{filename:e})}function J(){V(`close`)}function Y(e){e.key===`Escape`&&J()}x(()=>u(z()),()=>{z()&&K()}),w(),y();var X=c();l(`keydown`,d,Y);var Z=T(X),Q=e=>{var t=L(),i=S(t),c=S(i),u=b(S(c),2),d=S(u);k(d,{size:16}),v(u),v(c);var m=b(c,2),g=e=>{var t=A(),n=f(t,!0);_(()=>{D(t,`title`,a(U)),s(n,a(U))}),o(e,t)};O(m,e=>{a(U)&&e(g)});var y=b(m,2),x=S(y),C=e=>{var t=j();o(e,t)},w=e=>{var t=M(),n=f(t);_(()=>s(n,`No project on this server — ${a(G)??``}`)),o(e,t)},T=e=>{var t=N();o(e,t)},E=e=>{var t=I();n(t,5,()=>a(H),e=>e,(e,t)=>{var n=F(),i=S(n);let c;var u=S(i),d=f(u,!0),p=b(u,2),m=e=>{var t=P();o(e,t)};O(p,e=>{a(t)===B()&&e(m)}),v(i),v(n),_(()=>{c=r(i,1,`graph svelte-1j8ra8p`,null,c,{current:a(t)===B()}),s(d,a(t))}),l(`click`,i,()=>q(a(t))),o(e,n)}),v(t),o(e,t)};O(x,e=>{a(W)?e(C):a(G)?e(w,1):(a(H),h(()=>a(H).length===0)?e(T,2):e(E,-1))}),v(y);var R=b(y,2),z=f(R);v(i),v(t),l(`click`,u,J),l(`click`,z,()=>V(`local`)),l(`click`,t,p(J)),o(e,t)};O(Z,e=>{z()&&e(Q)}),o(t,X),e()}export{R as default};

package/dist/assets/ProjectSettings-DLOXLxcA.js

@@ -1,2 +0,0 @@
-import{At as e,C as t,Dt as n,G as r,I as i,L as a,O as o,Ot as s,Q as c,U as l,V as u,W as d,X as f,Z as p,_t as m,a as h,at as g,b as _,ct as v,d as ee,dt as y,et as b,i as te,it as x,jt as S,l as C,lt as w,nt as T,o as E,ot as D,pt as O,rt as ne,st as re,t as k,v as A,z as j}from"./legacy-CTEeXeqF.js";import{$ as M,G as ie,K as ae,U as oe,W as se,Z as ce,b as N,x as P}from"./index-5ZtDAuy2.js";var F=new Set([`$$slots`,`$$events`,`$$legacy`]);function le(e,t){let n=h(t,F),r=[[`path`,{d:`M10 11v6`}],[`path`,{d:`M14 11v6`}],[`path`,{d:`M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6`}],[`path`,{d:`M3 6h18`}],[`path`,{d:`M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2`}]];M(e,E({name:`trash-2`},()=>n,{get iconNode(){return r}}))}var ue=r(`<span> </span>`),de=r(`<div class="credentials-status svelte-9d4ggp"><!> <small class="svelte-9d4ggp">Add missing values to <code>~/.cascade/credentials.yaml</code> or the file named by <code>CASCADE_CREDENTIALS</code>. Values are never shown here.</small></div>`),fe=r(`<div class="empty-state svelte-9d4ggp"><!> <p class="svelte-9d4ggp">No project packages configured</p> <button class="add-button svelte-9d4ggp"><!> Add Package</button></div>`),pe=r(`<div class="package-item svelte-9d4ggp"><div class="package-info svelte-9d4ggp"><span class="package-alias svelte-9d4ggp"> </span> <span class="package-path svelte-9d4ggp"> </span></div> <button class="remove-button svelte-9d4ggp" aria-label="Remove package"><!></button></div>`),me=r(`<button class="add-button secondary svelte-9d4ggp"><!> Add Package</button>`),he=r(`<div class="packages-list svelte-9d4ggp"></div> <!>`,1),ge=r(`<div class="error-message svelte-9d4ggp"><!> </div>`),_e=r(`<div class="add-form svelte-9d4ggp"><div class="form-row svelte-9d4ggp"><label for="package-path" class="svelte-9d4ggp">Path</label> <div class="input-with-button svelte-9d4ggp"><input id="package-path" type="text" placeholder="./src or ../shared-lib" class="svelte-9d4ggp"/> <button class="browse-button svelte-9d4ggp" title="Browse folder"><!></button></div></div> <div class="form-row svelte-9d4ggp"><label for="package-alias" class="svelte-9d4ggp">Alias</label> <input id="package-alias" type="text" placeholder="myproject" class="svelte-9d4ggp"/></div> <!> <div class="form-actions svelte-9d4ggp"><button class="cancel-button svelte-9d4ggp">Cancel</button> <button class="confirm-button svelte-9d4ggp">Add Package</button></div></div>`),ve=r(`<div class="modal-overlay svelte-9d4ggp"><div class="modal svelte-9d4ggp" role="dialog" aria-modal="true" aria-labelledby="modal-title"><div class="modal-header svelte-9d4ggp"><h2 id="modal-title" class="svelte-9d4ggp"><!> Project Settings</h2> <button class="close-button svelte-9d4ggp" aria-label="Close"><!></button></div> <div class="modal-body svelte-9d4ggp"><section class="section svelte-9d4ggp"><h3 class="svelte-9d4ggp">Graph Metadata <small class="svelte-9d4ggp">(current .cascade file)</small></h3> <div class="form-row svelte-9d4ggp"><label for="graph-name" class="svelte-9d4ggp">Name</label><input id="graph-name" class="svelte-9d4ggp"/></div> <div class="form-row svelte-9d4ggp"><label for="graph-description" class="svelte-9d4ggp">Description</label><input id="graph-description" class="svelte-9d4ggp"/></div> <div class="form-row svelte-9d4ggp"><label for="graph-author" class="svelte-9d4ggp">Author</label><input id="graph-author" class="svelte-9d4ggp"/></div> <div class="form-row svelte-9d4ggp"><label for="graph-created" class="svelte-9d4ggp">Created</label><input id="graph-created" readonly="" class="svelte-9d4ggp"/></div></section> <section class="section svelte-9d4ggp"><h3 class="svelte-9d4ggp">Project Manifest <small class="svelte-9d4ggp">(cascade.json, shared by every graph)</small></h3> <div class="form-row svelte-9d4ggp"><label for="project-name" class="svelte-9d4ggp">Project name</label><input id="project-name" class="svelte-9d4ggp"/></div> <div class="form-row svelte-9d4ggp"><label for="commands-json" class="svelte-9d4ggp">Allowed commands</label><textarea id="commands-json" rows="4" class="svelte-9d4ggp"></textarea></div> <div class="form-row svelte-9d4ggp"><label for="settings-json" class="svelte-9d4ggp">Node settings</label><textarea id="settings-json" rows="5" class="svelte-9d4ggp"></textarea></div> <div class="form-row svelte-9d4ggp"><label for="credentials-list" class="svelte-9d4ggp">Required credentials</label><textarea id="credentials-list" rows="3" placeholder="one credential name per line" class="svelte-9d4ggp"></textarea></div> <!></section> <section class="section svelte-9d4ggp"><h3 class="svelte-9d4ggp">Project Packages</h3> <p class="section-description svelte-9d4ggp">Add local folders as packages. Each package gets an alias that you can use to import modules. <br/> Example: <code class="svelte-9d4ggp">myproject.filters.Blur</code> for file <code class="svelte-9d4ggp">./src/filters/Blur.ts</code></p> <!> <!></section> <section class="section svelte-9d4ggp"><h3 class="svelte-9d4ggp">Project Info</h3> <div class="info-grid svelte-9d4ggp"><div class="info-item svelte-9d4ggp"><span class="info-label svelte-9d4ggp">Embedded Modules</span> <span class="info-value svelte-9d4ggp"> </span></div> <div class="info-item svelte-9d4ggp"><span class="info-label svelte-9d4ggp">External Modules</span> <span class="info-value svelte-9d4ggp"> </span></div></div></section></div> <div class="modal-footer svelte-9d4ggp"><button class="cancel-button svelte-9d4ggp">Cancel</button> <button class="save-button svelte-9d4ggp">Save Changes</button></div></div></div>`);function I(r,h){s(h,!1);let E=te(h,`open`,12,!1),M=te(h,`graph`,12,void 0),F=k(),I=y([]),L=y(``),R=y(``),z=y(!1),B=y(``),V=y(``),H=y(``),U=y(``),W=y(``),G=y(`{}`),K=y(`{}`),q=y(``),J=y([]),Y=y(!1),X=y(!1);function Z(){E(!1),F(`close`)}async function ye(){O(B,``);let e,t;try{if(e=JSON.parse(c(G)||`{}`),t=JSON.parse(c(K)||`{}`),c(X)){let n=await P({name:c(W).trim(),commands:e,settings:t,credentials:c(q).split(/\r?\n|,/).map(e=>e.trim()).filter(Boolean)});O(J,n.requiredCredentials)}}catch(e){O(B,e instanceof Error?e.message:String(e));return}M()&&(M(M().project.name=c(V).trim(),!0),M(M().project.description=c(H).trim(),!0),M(M().project.author=c(U).trim(),!0),M(M().project.packages=[...c(I)],!0),c(I).forEach(e=>{M().moduleResolver.addProjectPackage(e)})),F(`save`,{packages:[...c(I)],graphName:c(V).trim(),projectName:c(W).trim(),missingCredentials:c(J).filter(e=>!e.set).map(e=>e.name)}),Z()}function be(){if(O(B,``),!c(L).trim()){O(B,`Path is required`);return}if(!c(R).trim()){O(B,`Alias is required`);return}if(!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(c(R))){O(B,`Alias must start with a letter and contain only letters, numbers, and underscores`);return}if(c(I).some(e=>e.alias===c(R))){O(B,`Alias "${c(R)}" already exists`);return}O(I,[...c(I),{path:c(L).trim(),alias:c(R).trim()}]),O(L,``),O(R,``),O(z,!1)}function xe(e){O(I,c(I).filter((t,n)=>n!==e))}function Q(e){e.key===`Escape`&&(c(z)?O(z,!1):Z())}function $(e){let t=e.replace(/\\/g,`/`).split(`/`).filter(Boolean);return(t[t.length-1]||`mypackage`).replace(/[^a-zA-Z0-9]/g,``).toLowerCase()||`mypackage`}T(()=>(p(E()),p(M())),()=>{E()&&M()&&(O(I,[...M().project.packages]),O(z,!1),O(B,``),O(L,``),O(R,``))}),T(()=>p(E()),()=>{E()||O(Y,!1)}),T(()=>(p(E()),p(M()),c(Y),N),()=>{E()&&M()&&!c(Y)&&(O(Y,!0),O(V,M().project.name??``),O(H,M().project.description??``),O(U,M().project.author??``),N().then(e=>{O(X,!0),O(W,e.manifest.name),O(G,JSON.stringify(e.manifest.commands,null,2)),O(K,JSON.stringify(e.manifest.settings,null,2)),O(q,e.manifest.credentials.join(`
-`)),O(J,e.requiredCredentials)}).catch(()=>{O(X,!1)}))}),T(()=>(c(L),c(R)),()=>{c(L)&&!c(R)&&O(R,$(c(L)))}),ne(),C();var Se=d();f(`keydown`,g,Q);var Ce=re(Se),we=n=>{var r=ve(),s=D(r),d=D(s),h=D(d),g=D(h);ie(g,{size:20}),e(),S(h);var y=w(h,2),te=D(y);oe(te,{size:20}),S(y),S(d);var C=w(d,2),T=D(C),E=w(D(T),2),ne=w(D(E));_(ne),S(E);var k=w(E,2),N=w(D(k));_(N),S(k);var P=w(k,2),F=w(D(P));_(F),S(P);var Y=w(P,2),X=w(D(Y));_(X),S(Y),S(T);var Q=w(T,2),$=w(D(Q),2),Se=w(D($));_(Se),S($);var Ce=w($,2),we=w(D(Ce));m(we),S(Ce);var Te=w(Ce,2),Ee=w(D(Te));m(Ee),S(Te);var De=w(Te,2),Oe=w(D(De));m(Oe),S(De);var ke=w(De,2),Ae=t=>{var n=de(),r=D(n);i(r,1,()=>c(J),a,(e,t)=>{var n=ue();let r;var i=v(n);x(()=>{r=o(n,1,`svelte-9d4ggp`,null,r,{set:c(t).set}),u(i,`${c(t),b(()=>c(t).name)??``}: ${c(t),b(()=>c(t).set?`set`:`not set`)??``}`)}),l(e,n)}),e(2),S(n),l(t,n)};j(ke,e=>{c(J),b(()=>c(J).length)&&e(Ae)}),S(Q);var je=w(Q,2),Me=w(D(je),4),Ne=t=>{var n=fe(),r=D(n);ae(r,{size:32});var i=w(r,4),a=D(i);se(a,{size:16}),e(),S(i),S(n),f(`click`,i,()=>O(z,!0)),l(t,n)},Pe=t=>{var n=he(),r=re(n);i(r,5,()=>c(I),a,(e,t,n)=>{var r=pe(),i=D(r),a=D(i),o=v(a,!0),s=w(a,2),d=v(s,!0);S(i);var p=w(i,2);le(D(p),{size:16}),S(p),S(r),x(()=>{u(o,(c(t),b(()=>c(t).alias))),u(d,(c(t),b(()=>c(t).path)))}),f(`click`,p,()=>xe(n)),l(e,r)}),S(r);var o=w(r,2),s=t=>{var n=me(),r=D(n);se(r,{size:16}),e(),S(n),f(`click`,n,()=>O(z,!0)),l(t,n)};j(o,e=>{c(z)||e(s)}),l(t,n)};j(Me,e=>{c(I),c(z),b(()=>c(I).length===0&&!c(z))?e(Ne):e(Pe,-1)});var Fe=w(Me,2),Ie=e=>{var t=_e(),n=D(t),r=w(D(n),2),i=D(r);_(i);var a=w(i,2),o=D(a);ae(o,{size:16}),S(a),S(r),S(n);var s=w(n,2),d=w(D(s),2);_(d),S(s);var p=w(s,2),m=e=>{var t=ge(),n=D(t);ce(n,{size:14});var r=w(n);S(t),x(()=>u(r,` ${c(B)??``}`)),l(e,t)};j(p,e=>{c(B)&&e(m)});var h=w(p,2),g=D(h),v=w(g,2);S(h),S(t),A(i,()=>c(L),e=>O(L,e)),A(d,()=>c(R),e=>O(R,e)),f(`click`,g,()=>O(z,!1)),f(`click`,v,be),l(e,t)};j(Fe,e=>{c(z)&&e(Ie)}),S(je);var Le=w(je,2),Re=w(D(Le),2),ze=D(Re),Be=w(D(ze),2),Ve=v(Be,!0);S(ze);var He=w(ze,2),Ue=w(D(He),2),We=v(Ue,!0);S(He),S(Re),S(Le),S(C);var Ge=w(C,2),Ke=D(Ge),qe=w(Ke,2);S(Ge),S(s),S(r),x((e,n)=>{t(X,(p(M()),b(()=>M()?.created??``))),u(Ve,e),u(We,n)},[()=>(p(M()),b(()=>M()?Object.keys(M().moduleResolver.exportConfig().embeddedModules).length:0)),()=>(p(M()),b(()=>M()?Object.keys(M().moduleResolver.exportConfig().externalModules).length:0))]),f(`click`,y,Z),A(ne,()=>c(V),e=>O(V,e)),A(N,()=>c(H),e=>O(H,e)),A(F,()=>c(U),e=>O(U,e)),A(Se,()=>c(W),e=>O(W,e)),A(we,()=>c(G),e=>O(G,e)),A(Ee,()=>c(K),e=>O(K,e)),A(Oe,()=>c(q),e=>O(q,e)),f(`click`,Ke,Z),f(`click`,qe,ye),f(`click`,r,ee(Z)),l(n,r)};j(Ce,e=>{E()&&e(we)}),l(r,Se),n()}export{I as default};

package/dist/assets/definitions-GreEMXLV.js

@@ -1 +0,0 @@
-import{N as e,_ as t,d as n,f as r,g as i,h as a,l as o,u as s}from"./index-5ZtDAuy2.js";e([a,o,s,n,t,i,r]);

package/dist/assets/geo-u0n_jOsD.js

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