@field/cascade 0.2.22

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/contracts/schema.d.ts

@@ -0,0 +1,6 @@
+export declare const nodeDefinitionSchema: {
+    readonly allOf: readonly [Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>];
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://cascade.dev/schema/node-definition-v1.json";
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/contracts/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAqEA,eAAO,MAAM,oBAAoB;;;;CAiCvB,CAAC"}

package/dist/contracts/schema.js

@@ -0,0 +1,85 @@
+import { CORE_TYPES } from "./values.js";
+function object(properties, required = []) {
+    return {
+        type: "object",
+        ...(required.length ? { required } : {}),
+        properties,
+        additionalProperties: false,
+    };
+}
+function record(value) {
+    return {
+        type: "object",
+        propertyNames: { pattern: "^[A-Za-z][A-Za-z0-9_]*$" },
+        additionalProperties: value,
+    };
+}
+const description = { type: "string" };
+const cascadeType = {
+    anyOf: [
+        { enum: CORE_TYPES },
+        { type: "string", pattern: "^[a-z][a-z0-9-]*(?:\\.[A-Za-z][A-Za-z0-9_]*)+$" },
+    ],
+};
+const control = {
+    enum: ["number", "slider", "range", "int", "boolean", "text", "textarea", "select", "vector", "matrix", "color", "image", "asset"],
+};
+const trigger = object({ kind: { const: "trigger" }, description }, ["kind"]);
+const dataProperties = {
+    kind: { const: "data" },
+    type: cascadeType,
+    default: {},
+    description,
+    variadic: { type: "boolean" },
+    min: { type: "number" },
+    max: { type: "number" },
+    step: { type: "number", exclusiveMinimum: 0 },
+    accept: { type: "array", items: { type: "string", minLength: 1 } },
+    control,
+    options: { type: "array" },
+};
+const data = object(dataProperties, ["kind", "type"]);
+const output = object({ kind: dataProperties.kind, type: dataProperties.type, description }, ["kind", "type"]);
+const { kind: _kind, variadic: _variadic, ...propProperties } = dataProperties;
+const prop = object({ ...propProperties, label: { type: "string" } }, [
+    "type",
+    "default",
+]);
+function environmentCapabilities(runsOn, capabilities) {
+    return {
+        if: { properties: { runsOn: { const: runsOn } } },
+        then: { properties: { capabilities: { items: { enum: capabilities } } } },
+    };
+}
+export const nodeDefinitionSchema = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://cascade.dev/schema/node-definition-v1.json",
+    ...object({
+        apiVersion: { const: 1 },
+        runsOn: { enum: ["portable", "browser", "server"] },
+        container: { const: "subnet" },
+        capabilities: {
+            type: "array",
+            items: { type: "string" },
+            uniqueItems: true,
+        },
+        label: description,
+        description,
+        icon: description,
+        inputs: record({ anyOf: [trigger, data] }),
+        outputs: record({ anyOf: [trigger, output] }),
+        props: record(prop),
+    }, ["apiVersion", "runsOn"]),
+    allOf: [
+        environmentCapabilities("portable", ["assets", "media"]),
+        environmentCapabilities("browser", ["assets", "media", "webgl"]),
+        environmentCapabilities("server", [
+            "files",
+            "assets",
+            "media",
+            "python",
+            "shell",
+        ]),
+    ],
+};
+//# sourceMappingURL=schema.js.map

package/dist/contracts/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/contracts/validate.d.ts

@@ -0,0 +1,13 @@
+import type { NodeDefinition } from "./definition.js";
+export interface Diagnostic {
+    readonly phase: string;
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string;
+    readonly file?: string;
+    readonly line?: number;
+    readonly column?: number;
+}
+export declare function validateNodeDefinition(value: unknown): readonly Diagnostic[];
+export declare function assertNodeDefinition(value: unknown): asserts value is NodeDefinition;
+//# sourceMappingURL=validate.d.ts.map

package/dist/contracts/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuFD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,UAAU,EAAE,CA4L5E;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,cAAc,CAMjC"}

package/dist/contracts/validate.js

@@ -0,0 +1,202 @@
+import { isGeometrySerialized } from "./geometry.js";
+import { CORE_TYPES } from "./values.js";
+const IDENTIFIER = /^[A-Za-z][A-Za-z0-9_]*$/;
+const NAMESPACED = /^[a-z][a-z0-9-]*(?:\.[A-Za-z][A-Za-z0-9_]*)+$/;
+const RESERVED = new Set(["__proto__", "prototype", "constructor"]);
+const CORE = new Set(CORE_TYPES);
+const CONTROLS = new Set(["number", "slider", "range", "int", "boolean", "text", "textarea", "select", "vector", "matrix", "color", "image", "asset"]);
+const ALLOWED = {
+    portable: ["assets", "media"],
+    browser: ["assets", "media", "webgl"],
+    server: ["files", "assets", "media", "python", "shell"],
+};
+const fields = (names) => new Set(names.split(" "));
+const TOP_FIELDS = fields("apiVersion runsOn container capabilities label description icon inputs outputs props");
+const DATA_FIELDS = fields("kind type default description variadic min max step accept control options");
+const OUTPUT_FIELDS = fields("kind type description");
+const PROP_FIELDS = fields("type default label description min max step accept control options");
+function diagnostic(code, message, path) {
+    return { phase: "definition", code: `definition/${code}`, message, path };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validType(type) {
+    return typeof type === "string" && (CORE.has(type) || NAMESPACED.test(type));
+}
+function finiteJson(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(finiteJson);
+    return isRecord(value) && Object.values(value).every(finiteJson);
+}
+function unknownFields(value, allowed, path) {
+    return Object.keys(value)
+        .filter((key) => !allowed.has(key))
+        .map((key) => diagnostic("unknown-field", `${path}.${key} is not allowed`, `${path}.${key}`));
+}
+function defaultMatches(type, value) {
+    if (!finiteJson(value))
+        return false;
+    // Without this case a geometry default falls through the length table below
+    // and any JSON value at all passes, which is the hole the four scalar cases
+    // exist to close. A default that cannot be validated is not a default.
+    if (type === "geometry")
+        return isGeometrySerialized(value);
+    if (type === "float")
+        return typeof value === "number";
+    if (type === "int")
+        return typeof value === "number";
+    if (type === "bool")
+        return typeof value === "boolean";
+    if (type === "string")
+        return typeof value === "string";
+    const lengths = {
+        vec2: 2,
+        vec3: 3,
+        vec4: 4,
+        vec2i: 2,
+        vec3i: 3,
+        vec4i: 4,
+        mat2: 4,
+        mat3: 9,
+        mat4: 16,
+        color: 4,
+    };
+    const length = lengths[type];
+    return (length === undefined ||
+        (Array.isArray(value) &&
+            value.length === length &&
+            value.every((item) => type.endsWith("i") ? Number.isInteger(item) : typeof item === "number")));
+}
+export function validateNodeDefinition(value) {
+    if (!isRecord(value))
+        return [diagnostic("not-object", "Definition must be an object")];
+    const result = unknownFields(value, TOP_FIELDS, "definition");
+    const add = (code, message, path) => result.push(diagnostic(code, message, path));
+    const environment = value.runsOn;
+    if (value.apiVersion !== 1)
+        add("api-version", "apiVersion must be 1", "apiVersion");
+    if (!Object.prototype.hasOwnProperty.call(ALLOWED, String(environment)))
+        add("environment", "runsOn must be portable, browser, or server", "runsOn");
+    if (value.container !== undefined && value.container !== "subnet")
+        add("invalid-container", "container must be subnet", "container");
+    const allowed = ALLOWED[environment] ?? [];
+    if (value.capabilities !== undefined && !Array.isArray(value.capabilities))
+        add("invalid-capabilities", "capabilities must be an array", "capabilities");
+    const seen = new Set();
+    for (const [index, capability] of (Array.isArray(value.capabilities)
+        ? value.capabilities
+        : []).entries()) {
+        const path = `capabilities.${index}`;
+        if (!seen.has(capability) &&
+            !allowed.includes(capability))
+            add("capability-not-allowed", `${String(capability)} is not available on ${String(environment)}`, path);
+        if (seen.has(capability))
+            add("duplicate-capability", `${String(capability)} is duplicated`, path);
+        seen.add(capability);
+    }
+    // Two namespaces, not one. An output is addressed in the other direction from
+    // an input, so `geometry` in and `geometry` out is not ambiguous anywhere: the
+    // document format names the two endpoints of a connection separately, the
+    // runtime keys them as `source.outputName` and `target.inputName`, and
+    // `NodeExecutionContext` hands a node `context.inputs` and `context.outputs`
+    // as separate records. One shared namespace made "geometry in, geometry out"
+    // inexpressible and forced every geometry operator to call its input `input`,
+    // which Marcus overruled 2026-09-04: *"sounds weird, we need to allow this
+    // case."*
+    //
+    // Inputs and props still share one namespace. Both feed a value *into* the
+    // node from the same side, an unconnected input with a default is the same
+    // control as a prop to whoever is looking at the node, and there is no
+    // direction to tell them apart by. That one stays a collision.
+    const inward = new Map();
+    const outward = new Map();
+    for (const section of ["inputs", "outputs", "props"]) {
+        const entries = value[section];
+        if (entries === undefined)
+            continue;
+        if (!isRecord(entries)) {
+            add("invalid-section", `${section} must be an object`, section);
+            continue;
+        }
+        for (const [name, raw] of Object.entries(entries)) {
+            const path = `${section}.${name}`;
+            if (!IDENTIFIER.test(name))
+                add("invalid-name", `${name} is not a valid identifier`, path);
+            if (RESERVED.has(name))
+                add("reserved-name", `${name} is reserved`, path);
+            const names = section === "outputs" ? outward : inward;
+            const previous = names.get(name);
+            if (previous)
+                add("name-collision", `${name} is declared in ${previous} and ${section}`, path);
+            else
+                names.set(name, section);
+            if (!isRecord(raw)) {
+                add("invalid-entry", `${path} must be an object`, path);
+                continue;
+            }
+            const fields = section === "props"
+                ? PROP_FIELDS
+                : section === "outputs"
+                    ? OUTPUT_FIELDS
+                    : DATA_FIELDS;
+            if (section !== "props" &&
+                raw.kind !== "data" &&
+                raw.kind !== "trigger") {
+                add("invalid-kind", `${path}.kind must be data or trigger`, `${path}.kind`);
+                result.push(...unknownFields(raw, fields, path));
+                continue;
+            }
+            if (section !== "props" && raw.kind === "trigger") {
+                if (Object.keys(raw).some((key) => key !== "kind" && key !== "description"))
+                    add("trigger-extra", "Trigger ports allow only kind and description", path);
+                continue;
+            }
+            result.push(...unknownFields(raw, fields, path));
+            if ("control" in raw &&
+                (typeof raw.control !== "string" || !CONTROLS.has(raw.control)))
+                add("invalid-control", `${String(raw.control)} is not a Cascade control`, `${path}.control`);
+            if ("options" in raw && raw.control !== "select")
+                add("options-without-select", "options require the select control", `${path}.options`);
+            const type = raw.type;
+            if (!validType(type)) {
+                add("invalid-type", `${String(type)} is not a Cascade type`, `${path}.type`);
+                continue;
+            }
+            if (type === "texture" && environment !== "browser")
+                add("texture-not-portable", "texture is browser-only", `${path}.type`);
+            if (type === "texture" && "default" in raw)
+                add("texture-default", "texture cannot have a default", `${path}.default`);
+            if (section === "props" && !("default" in raw))
+                add("missing-default", "Props require defaults", `${path}.default`);
+            if ("default" in raw && !finiteJson(raw.default))
+                add("invalid-default", "Default must be finite JSON", `${path}.default`);
+            else if ("default" in raw && !defaultMatches(type, raw.default))
+                add("default-type", `Default does not match ${type}`, `${path}.default`);
+            if (type === "int" &&
+                "default" in raw &&
+                (!Number.isFinite(raw.default) || !Number.isInteger(raw.default)))
+                add("non-integer", "Integer defaults must be finite integers", `${path}.default`);
+            if ("step" in raw &&
+                (typeof raw.step !== "number" ||
+                    !Number.isFinite(raw.step) ||
+                    raw.step <= 0))
+                add("invalid-step", "step must be greater than zero", `${path}.step`);
+            if (typeof raw.min === "number" &&
+                typeof raw.max === "number" &&
+                raw.min > raw.max)
+                add("invalid-range", "min must not exceed max", path);
+        }
+    }
+    return result;
+}
+export function assertNodeDefinition(value) {
+    const diagnostics = validateNodeDefinition(value);
+    if (diagnostics.length)
+        throw new TypeError(diagnostics.map((item) => `${item.code}: ${item.message}`).join("\n"));
+}
+//# sourceMappingURL=validate.js.map

package/dist/contracts/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}

package/dist/contracts/values.d.ts

@@ -0,0 +1,100 @@
+import type { Color } from "./color.js";
+import type { Geometry, GeometryFileRef, GeometryJson, GeometrySerialized } from "./geometry.js";
+export declare const CORE_TYPES: readonly ["float", "int", "bool", "string", "vec2", "vec3", "vec4", "vec2i", "vec3i", "vec4i", "mat2", "mat3", "mat4", "image", "texture", "geometry", "points", "lines", "polyline", "mesh", "rects", "color", "asset", "array", "object", "any"];
+export type CoreType = (typeof CORE_TYPES)[number];
+export type NamespacedType = `${string}.${string}`;
+export type CascadeType = CoreType | NamespacedType;
+export declare const IMPLICIT_TYPE_CONVERSIONS: Readonly<Record<string, readonly string[]>>;
+/** Canonicalize compatibility spellings before validation or connection checks. */
+export declare function normalizeCascadeType(type: string | undefined): string;
+/** Shared widening rules for Studio, headless runtimes, and graph tooling. */
+export declare function canConnectTypes(source: string, target: string): boolean;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | {
+    readonly [key: string]: JsonValue;
+} | readonly JsonValue[];
+export type Vec2 = readonly [number, number];
+export type Vec3 = readonly [number, number, number];
+export type Vec4 = readonly [number, number, number, number];
+export type Vec2i = Vec2;
+export type Vec3i = Vec3;
+export type Vec4i = Vec4;
+export type Mat2 = readonly [number, number, number, number];
+export type Mat3 = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+export type Mat4 = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+export interface ImageRef {
+    readonly path: string;
+    readonly size: Vec2i;
+    readonly channels: "r" | "a" | "rg" | "rgb" | "rgba";
+    readonly depth: "u8" | "u16" | "f16" | "f32";
+    readonly space: "srgb" | "linear";
+}
+declare const textureHandleBrand: unique symbol;
+export interface TextureHandle {
+    readonly [textureHandleBrand]: true;
+}
+export type Point = readonly [number, number] | readonly [number, number, number];
+export interface PointSet {
+    readonly points: readonly Point[];
+}
+export type LineSegment = readonly [Point, Point];
+export interface LineSegments {
+    readonly segments: readonly LineSegment[];
+}
+export interface Polyline {
+    readonly points: readonly Point[];
+    readonly closed?: boolean;
+    readonly weight?: number;
+}
+export interface Mesh {
+    readonly positions: readonly number[];
+    readonly indices: readonly number[];
+    readonly normals?: readonly number[];
+    readonly uvs?: readonly number[];
+}
+export interface Rect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly tag?: string;
+}
+export interface Rects {
+    readonly rects: readonly Rect[];
+}
+export interface AssetRef {
+    readonly path: string;
+    readonly mediaType?: string;
+}
+export type SerializableValue = JsonValue | AssetRef | ImageRef | GeometryJson | GeometryFileRef;
+export type ValueForType<T extends CascadeType> = T extends "float" | "int" ? number : T extends "bool" ? boolean : T extends "string" ? string : T extends "vec2" ? Vec2 : T extends "vec3" ? Vec3 : T extends "vec4" ? Vec4 : T extends "vec2i" ? Vec2i : T extends "vec3i" ? Vec3i : T extends "vec4i" ? Vec4i : T extends "mat2" ? Mat2 : T extends "mat3" ? Mat3 : T extends "mat4" ? Mat4 : T extends "color" ? Color : T extends "image" ? ImageRef : T extends "texture" ? TextureHandle : T extends "geometry" ? Geometry : T extends "points" ? PointSet : T extends "lines" ? LineSegments : T extends "polyline" ? Polyline : T extends "mesh" ? Mesh : T extends "rects" ? Rects : T extends "asset" ? AssetRef : T extends "array" ? readonly unknown[] : T extends "object" ? Readonly<Record<string, unknown>> : unknown;
+export type SerializableValueForType<T extends CascadeType> = T extends "texture" ? never : T extends "geometry" ? GeometrySerialized : T extends "array" ? readonly JsonValue[] : T extends "object" ? Readonly<Record<string, JsonValue>> : T extends "any" | NamespacedType ? JsonValue : ValueForType<T>;
+export {};
+//# sourceMappingURL=values.d.ts.map

package/dist/contracts/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"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"}

package/dist/contracts/values.js

@@ -0,0 +1,59 @@
+export const CORE_TYPES = [
+    "float",
+    "int",
+    "bool",
+    "string",
+    "vec2",
+    "vec3",
+    "vec4",
+    "vec2i",
+    "vec3i",
+    "vec4i",
+    "mat2",
+    "mat3",
+    "mat4",
+    "image",
+    "texture",
+    "geometry",
+    "points",
+    "lines",
+    "polyline",
+    "mesh",
+    "rects",
+    "color",
+    "asset",
+    "array",
+    "object",
+    "any",
+];
+const TYPE_ALIASES = {
+    number: "float",
+    boolean: "bool",
+    curves: "polyline",
+};
+export const IMPLICIT_TYPE_CONVERSIONS = {
+    int: ["float", "string"],
+    float: ["string"],
+    bool: ["int", "float", "string"],
+    vec2i: ["vec2"],
+    vec3i: ["vec3"],
+    vec4i: ["vec4"],
+    vec4: ["color"],
+    color: ["vec4"],
+};
+/** Canonicalize compatibility spellings before validation or connection checks. */
+export function normalizeCascadeType(type) {
+    if (!type)
+        return "any";
+    return TYPE_ALIASES[type] ?? type;
+}
+/** Shared widening rules for Studio, headless runtimes, and graph tooling. */
+export function canConnectTypes(source, target) {
+    const from = normalizeCascadeType(source);
+    const to = normalizeCascadeType(target);
+    return (from === to ||
+        from === "any" ||
+        to === "any" ||
+        (IMPLICIT_TYPE_CONVERSIONS[from]?.includes(to) ?? false));
+}
+//# sourceMappingURL=values.js.map

package/dist/contracts/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO;IACP,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,UAAU;IACV,QAAQ;IACR,OAAO;IACP,UAAU;IACV,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;CACG,CAAC;AAMX,MAAM,YAAY,GAAuC;IACvD,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAgD;IACpF,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;IACxB,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;IAChC,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,KAAK,EAAE,CAAC,MAAM,CAAC;CAChB,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc;IAC5D,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CACL,IAAI,KAAK,EAAE;QACX,IAAI,KAAK,KAAK;QACd,EAAE,KAAK,KAAK;QACZ,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,CACzD,CAAC;AACJ,CAAC"}

package/dist/graphs/default-orig.cascade

@@ -0,0 +1,128 @@
+{
+  "version": "0.1",
+  "metadata": {
+    "name": "Cascade Graph",
+    "created": "2025-11-30T18:08:34.327Z",
+    "modified": "2025-11-30T18:08:34.327Z"
+  },
+  "annotations": [
+    {
+      "id": "ann_headline_default",
+      "type": "text",
+      "position": [0, 0],
+      "content": "Hello World - Connections Test",
+      "size": {
+        "width": 500,
+        "height": 40
+      },
+      "style": {
+        "fontSize": 32,
+        "fontWeight": "700",
+        "fontStyle": "normal",
+        "textAlign": "left",
+        "color": "rgb(255,255,255)",
+        "padding": 0,
+        "borderRadius": 0
+      }
+    },
+    {
+      "id": "ann_copy_default",
+      "type": "text",
+      "position": [0, 120],
+      "content": "Cascade is a visual programming framework designed for creative coders who want to build interactive experiences without sacrificing the power of code. Every node is just a TypeScript function, fully inspectable and editable. The visual graph and code are equal partners, not abstractions of each other. This allows you to work visually when it makes sense, and dive into code when you need precision and control.",
+      "size": {
+        "width": 500,
+        "height": 200
+      },
+      "style": {
+        "fontSize": 14,
+        "fontWeight": "normal",
+        "fontStyle": "normal",
+        "textAlign": "left",
+        "color": "rgb(255,255,255)",
+        "padding": 0,
+        "borderRadius": 0
+      }
+    },
+    {
+      "id": "ann_image_cascade",
+      "type": "image",
+      "position": [-445.93601032083075, 254.9487664542571],
+      "src": "public/assets/cascade.jpg",
+      "size": {
+        "width": 200,
+        "height": 150
+      }
+    }
+  ],
+  "nodes": [
+    {
+      "id": "Color1",
+      "type": "cascade.lens.Color",
+      "position": [200, 250],
+      "props": {
+        "color": [1, 1, 1, 1],
+        "resolution": [512, 512]
+      }
+    },
+    {
+      "id": "Checkers1",
+      "type": "cascade.lens.Checkers",
+      "position": [-200, 400],
+      "props": {
+        "color1": [1, 1, 1, 1],
+        "color2": [0, 0, 0, 1],
+        "mode": "size",
+        "size": 32,
+        "divisions": 16,
+        "resolution": [512, 512]
+      }
+    },
+    {
+      "id": "Composite1",
+      "type": "cascade.lens.Composite",
+      "position": [0, 550],
+      "props": {
+        "blendMode": "multiply",
+        "opacity": 1
+      }
+    },
+    {
+      "id": "Blur1",
+      "type": "cascade.lens.Blur",
+      "position": [0, 650],
+      "props": {
+        "radius": 5,
+        "wrapEdges": false
+      }
+    },
+    {
+      "id": "NormalMap1",
+      "type": "cascade.lens.NormalMap",
+      "position": [0, 748.1100174187586],
+      "props": {
+        "scale": 1,
+        "flipX": false,
+        "flipY": false
+      }
+    },
+    {
+      "id": "Composite2",
+      "type": "cascade.lens.Composite",
+      "position": [-136.19497734900557, 874.2393621153204],
+      "props": {
+        "blendMode": "multiply",
+        "opacity": 1
+      },
+      "cook": true
+    }
+  ],
+  "connections": [
+     [["Checkers1", 0], ["Composite1", 0]],
+     [["Color1", 0], ["Composite1", 1]],
+     [["Composite1", 0], ["Blur1", 0]],
+     [["Blur1", 0], ["NormalMap1", 0]],
+     [["ann_image_cascade", 0], ["Composite2", 0]],
+     [["NormalMap1", 0], ["Composite2", 1]]
+  ]
+}