@field/cascade 0.2.22

package/dist/runtime/builtins/geo/svgExport.js

@@ -0,0 +1,50 @@
+import { emptyGeometry } from "cascade/contracts";
+import { geometryToSvg, utf8Bytes } from "../../geometry/svg.js";
+import { svgExportDefinition } from "./definitions.js";
+import { geoModuleId } from "./namespace.js";
+/**
+ * The output end: an SVG document, as a string and as a written asset.
+ *
+ * It declares `assets` and nothing else. Writing is not optional and there is
+ * no `write` prop, because an export node whose file is a choice is a node that
+ * silently did nothing. `assets` is available to a `portable` node, so this
+ * stays portable and needs no `files` capability: the host decides where an
+ * asset lands, which is the whole point of the capability.
+ *
+ * The props are the fallbacks for `Cd`, `width` and `opacity`. A per-primitive
+ * attribute wins where it exists; see `geometryToSvg`, which also owns the one
+ * +Y-up-to-+Y-down flip in the system.
+ *
+ * `stroke` and `fill` are both `color`, which is a four-component vector with a
+ * swatch control rather than a second colour representation. `fill` used to be
+ * an SVG paint string so that `"none"` was expressible; Marcus ruled colour to
+ * be a `vec4` everywhere, so the absence of a fill is now the separate
+ * `fillMode` prop and the writer converts to text through `Color.toHex`. The
+ * reason "no fill" is a mode rather than a zero alpha is in `SvgExportOptions`.
+ */
+export async function executeSvgExport(context) {
+    const { props } = context;
+    const svg = geometryToSvg(context.inputs.geometry ?? emptyGeometry(2), {
+        width: props.width,
+        height: props.height,
+        margin: props.margin,
+        stroke: props.stroke,
+        strokeWidth: props.strokeWidth,
+        opacity: props.opacity,
+        fill: props.fill,
+        fillMode: props.fillMode === "solid" ? "solid" : "none",
+        pointRadius: props.pointRadius,
+        precision: props.precision,
+    });
+    context.outputs.svg.set(svg);
+    const asset = await context.capabilities.assets.write(utf8Bytes(svg), { mediaType: "image/svg+xml", suggestedName: props.filename }, { signal: context.signal });
+    context.outputs.asset.set(asset);
+}
+export const svgExportRegistration = {
+    kind: "definition-v1",
+    moduleId: geoModuleId("SvgExport"),
+    definition: svgExportDefinition,
+    loadExecute: async () => executeSvgExport,
+};
+export { svgExportDefinition } from "./definitions.js";
+//# sourceMappingURL=svgExport.js.map

package/dist/runtime/builtins/geo/svgExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgExport.js","sourceRoot":"","sources":["../../../src/builtins/geo/svgExport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAyD;IAEzD,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;QACrE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;QACvD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CACnD,SAAS,CAAC,GAAG,CAAC,EACd,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,EAC7D,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;IACF,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,WAAW,CAAC,WAAW,CAAC;IAClC,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,gBAAgB;CACuB,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/runtime/builtins/geo/transform.d.ts

@@ -0,0 +1,60 @@
+import type { NodeExecutionContext } from "cascade/contracts";
+import { transformDefinition } from "./definitions.js";
+/**
+ * Transform SOP's parameters, by its names: translate, rotate, scale, pivot,
+ * in Houdini's scale-rotate-translate order about the pivot. Rotation is in
+ * degrees and counter-clockwise, because geometry is +Y up.
+ *
+ * The plan described this node as applying a `mat3`. It builds one instead: a
+ * matrix-typed input is the primitive the operation wants and the wrong thing
+ * to put in front of an artist, and the four parameters are what a Houdini user
+ * reaches for.
+ */
+export declare function executeTransform(context: NodeExecutionContext<typeof transformDefinition>): void;
+export declare const transformRegistration: {
+    kind: "definition-v1";
+    moduleId: string;
+    definition: {
+        readonly apiVersion: 1;
+        readonly label: "Transform";
+        readonly description: "Translate, rotate and scale geometry about a pivot.";
+        readonly icon: "Move";
+        readonly runsOn: "portable";
+        readonly inputs: {
+            readonly geometry: {
+                readonly kind: "data";
+                readonly type: "geometry";
+            };
+            readonly translate: {
+                readonly kind: "data";
+                readonly type: "vec2";
+                readonly default: readonly [0, 0];
+            };
+            readonly rotate: {
+                readonly kind: "data";
+                readonly type: "float";
+                readonly default: 0;
+                readonly description: "Degrees, counter-clockwise.";
+            };
+            readonly scale: {
+                readonly kind: "data";
+                readonly type: "vec2";
+                readonly default: readonly [1, 1];
+            };
+            readonly pivot: {
+                readonly kind: "data";
+                readonly type: "vec2";
+                readonly default: readonly [0, 0];
+            };
+        };
+        readonly outputs: {
+            readonly geometry: {
+                readonly kind: "data";
+                readonly type: "geometry";
+            };
+        };
+    };
+    loadExecute: () => Promise<typeof executeTransform>;
+};
+export { transformDefinition } from "./definitions.js";
+//# sourceMappingURL=transform.d.ts.map

package/dist/runtime/builtins/geo/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/builtins/geo/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,CAAC,OAAO,mBAAmB,CAAC,GACxD,IAAI,CAaN;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKgC,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/runtime/builtins/geo/transform.js

@@ -0,0 +1,32 @@
+import { emptyGeometry } from "cascade/contracts";
+import { transformMatrix } from "../../geometry/matrix.js";
+import { transformGeometry } from "../../geometry/transform.js";
+import { transformDefinition } from "./definitions.js";
+import { geoModuleId } from "./namespace.js";
+/**
+ * Transform SOP's parameters, by its names: translate, rotate, scale, pivot,
+ * in Houdini's scale-rotate-translate order about the pivot. Rotation is in
+ * degrees and counter-clockwise, because geometry is +Y up.
+ *
+ * The plan described this node as applying a `mat3`. It builds one instead: a
+ * matrix-typed input is the primitive the operation wants and the wrong thing
+ * to put in front of an artist, and the four parameters are what a Houdini user
+ * reaches for.
+ */
+export function executeTransform(context) {
+    const geometry = context.inputs.geometry ?? emptyGeometry(2);
+    context.outputs.geometry.set(transformGeometry(geometry, transformMatrix({
+        translate: context.inputs.translate,
+        rotate: context.inputs.rotate,
+        scale: context.inputs.scale,
+        pivot: context.inputs.pivot,
+    })));
+}
+export const transformRegistration = {
+    kind: "definition-v1",
+    moduleId: geoModuleId("Transform"),
+    definition: transformDefinition,
+    loadExecute: async () => executeTransform,
+};
+export { transformDefinition } from "./definitions.js";
+//# sourceMappingURL=transform.js.map

package/dist/runtime/builtins/geo/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/builtins/geo/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAyD;IAEzD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAC1B,iBAAiB,CACf,QAAQ,EACR,eAAe,CAAC;QACd,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;QAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;QAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;KAC5B,CAAC,CACH,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,WAAW,CAAC,WAAW,CAAC;IAClC,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,gBAAgB;CACuB,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/runtime/builtins/index.d.ts

@@ -0,0 +1,9 @@
+import type { DefinitionNodeRegistration } from "../types.js";
+/**
+ * Every reserved built-in, in one list, so that a caller does not have to know
+ * how many namespaces there are. `cascade.core.*` is structural and routing;
+ * `cascade.geo.*` is the geometry set.
+ */
+export declare const builtinNodeRegistrations: readonly DefinitionNodeRegistration[];
+export declare function builtinNodeRegistration(moduleId: string): DefinitionNodeRegistration | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/builtins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builtins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAI9D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,0BAA0B,EACN,CAAC;AASrE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,GACf,0BAA0B,GAAG,SAAS,CAExC"}

package/dist/runtime/builtins/index.js

@@ -0,0 +1,16 @@
+import { coreNodeRegistrations } from "./core/index.js";
+import { geoNodeRegistrations } from "./geo/index.js";
+/**
+ * Every reserved built-in, in one list, so that a caller does not have to know
+ * how many namespaces there are. `cascade.core.*` is structural and routing;
+ * `cascade.geo.*` is the geometry set.
+ */
+export const builtinNodeRegistrations = Object.freeze([...coreNodeRegistrations, ...geoNodeRegistrations]);
+const registrationsById = new Map(builtinNodeRegistrations.map((registration) => [
+    registration.moduleId,
+    registration,
+]));
+export function builtinNodeRegistration(moduleId) {
+    return registrationsById.get(moduleId);
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/builtins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builtins/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,qBAAqB,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC;AAErE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,wBAAwB,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC;IAC7C,YAAY,CAAC,QAAQ;IACrB,YAAY;CACb,CAAC,CACH,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,QAAgB;IAEhB,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/runtime/definition/architecture.d.ts

@@ -0,0 +1,8 @@
+import type * as TypeScript from "typescript";
+import type { Diagnostic } from "cascade/contracts";
+/**
+ * Enforces the statically inspectable node-module boundary. This is an
+ * architecture check for trusted project code, not a security sandbox.
+ */
+export declare function validateNodeModuleArchitecture(source: string, fileName: string, ts: typeof TypeScript): readonly Diagnostic[];
+//# sourceMappingURL=architecture.d.ts.map

package/dist/runtime/definition/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/definition/architecture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,UAAU,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAcrD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,OAAO,UAAU,GACpB,SAAS,UAAU,EAAE,CAkHvB"}

package/dist/runtime/definition/architecture.js

@@ -0,0 +1,112 @@
+const AMBIENT_STATE = new Set([
+    "globalThis",
+    "window",
+    "document",
+    "localStorage",
+    "sessionStorage",
+    "indexedDB",
+    "process",
+    "Bun",
+    "Deno",
+]);
+/**
+ * Enforces the statically inspectable node-module boundary. This is an
+ * architecture check for trusted project code, not a security sandbox.
+ */
+export function validateNodeModuleArchitecture(source, fileName, ts) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const diagnostics = [];
+    for (const statement of file.statements) {
+        if (ts.isVariableStatement(statement) && !isDefinition(statement)) {
+            add(statement, "module-state", "Node modules may not declare module-level values; use a pure function or pass state through ports, props, and declared capabilities");
+        }
+        else if (ts.isClassDeclaration(statement) ||
+            ts.isEnumDeclaration(statement) ||
+            ts.isModuleDeclaration(statement)) {
+            add(statement, "module-state", "Node modules may not declare classes, enums, or namespaces because they can retain module-global state");
+        }
+        else if (ts.isExpressionStatement(statement)) {
+            add(statement, "top-level-effect", "Node modules may not run top-level effects");
+        }
+        else if (ts.isImportDeclaration(statement) &&
+            !statement.importClause) {
+            add(statement, "side-effect-import", "Side-effect imports are not allowed in node modules");
+        }
+        else if (ts.isImportDeclaration(statement) &&
+            !statement.importClause?.isTypeOnly &&
+            ts.isStringLiteral(statement.moduleSpecifier) &&
+            importsSiblingNode(fileName, statement.moduleSpecifier.text)) {
+            add(statement.moduleSpecifier, "node-import", "A node may not import another node implementation; connect the nodes with a graph wire");
+        }
+    }
+    visit(file);
+    return diagnostics;
+    function visit(node) {
+        if (ts.isTypeNode(node) || ts.isImportDeclaration(node))
+            return;
+        if (ts.isIdentifier(node) &&
+            AMBIENT_STATE.has(node.text) &&
+            isReference(node)) {
+            add(node, "ambient-state", `${node.text} is ambient state; receive data through ports, props, or a declared capability`);
+        }
+        if (ts.isCallExpression(node) &&
+            node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+            add(node, "dynamic-import", "Dynamic imports are not allowed in deterministic node execution");
+        }
+        ts.forEachChild(node, visit);
+    }
+    function isReference(node) {
+        const parent = node.parent;
+        return !((ts.isPropertyAccessExpression(parent) && parent.name === node) ||
+            (ts.isPropertyAssignment(parent) && parent.name === node) ||
+            (ts.isMethodDeclaration(parent) && parent.name === node) ||
+            (ts.isPropertyDeclaration(parent) && parent.name === node));
+    }
+    function isDefinition(statement) {
+        return Boolean(statement.declarationList.flags & ts.NodeFlags.Const) &&
+            Boolean(statement.modifiers?.some((item) => item.kind === ts.SyntaxKind.ExportKeyword)) &&
+            statement.declarationList.declarations.length === 1 &&
+            ts.isIdentifier(statement.declarationList.declarations[0].name) &&
+            statement.declarationList.declarations[0].name.text === "definition";
+    }
+    function add(node, code, message) {
+        const point = file.getLineAndCharacterOfPosition(node.getStart(file));
+        diagnostics.push({
+            phase: "architecture",
+            code: `architecture/${code}`,
+            message,
+            file: fileName,
+            line: point.line + 1,
+            column: point.character + 1,
+        });
+    }
+}
+function importsSiblingNode(fileName, specifier) {
+    if (!specifier.startsWith("."))
+        return false;
+    const file = normalize(fileName).split("/");
+    const nodesIndex = file.lastIndexOf("nodes");
+    if (nodesIndex < 0 || !file[nodesIndex + 1])
+        return false;
+    const sourceNode = file[nodesIndex + 1];
+    const resolved = normalize([...file.slice(0, -1), ...specifier.split("/")].join("/")).split("/");
+    const resolvedNodesIndex = resolved.lastIndexOf("nodes");
+    return resolvedNodesIndex >= 0 &&
+        Boolean(resolved[resolvedNodesIndex + 1]) &&
+        resolved[resolvedNodesIndex + 1] !== sourceNode;
+}
+function normalize(value) {
+    const output = [];
+    // split/join rather than replaceAll: the root tsconfig targets ES2020, so
+    // svelte-check rejects the ES2021 method even though this package targets ES2022.
+    for (const part of value.split("\\").join("/").split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..")
+            output.pop();
+        else
+            output.push(part);
+    }
+    return output.join("/");
+}
+//# sourceMappingURL=architecture.js.map

package/dist/runtime/definition/architecture.js.map

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

package/dist/runtime/definition/extract.d.ts

@@ -0,0 +1,12 @@
+import type * as TypeScript from "typescript";
+import { type Diagnostic, type NodeDefinition } from "cascade/contracts";
+export type DefinitionExtractionResult = {
+    readonly ok: true;
+    readonly definition: NodeDefinition;
+    readonly diagnostics: readonly [];
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly Diagnostic[];
+};
+export declare function extractNodeDefinition(source: string, fileName: string, ts: typeof TypeScript): DefinitionExtractionResult;
+//# sourceMappingURL=extract.d.ts.map

package/dist/runtime/definition/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/definition/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,UAAU,MAAM,YAAY,CAAC;AAC9C,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,0BAA0B,GAClC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;CACnC,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAAC;AAKxE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,OAAO,UAAU,GACpB,0BAA0B,CA6N5B"}

package/dist/runtime/definition/extract.js

@@ -0,0 +1,151 @@
+import { validateNodeDefinition, } from "cascade/contracts";
+const MAX_DEPTH = 32;
+const MAX_NODES = 10_000;
+export function extractNodeDefinition(source, fileName, ts) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const syntaxDiagnostics = file.parseDiagnostics;
+    if (syntaxDiagnostics?.length) {
+        const syntax = syntaxDiagnostics[0];
+        const start = syntax.start ?? 0;
+        const point = file.getLineAndCharacterOfPosition(start);
+        return {
+            ok: false,
+            diagnostics: [
+                {
+                    phase: "definition",
+                    code: "definition/syntax",
+                    message: ts.flattenDiagnosticMessageText(syntax.messageText, "\n"),
+                    file: fileName,
+                    line: point.line + 1,
+                    column: point.character + 1,
+                },
+            ],
+        };
+    }
+    const declarations = [];
+    for (const statement of file.statements) {
+        if (!ts.isVariableStatement(statement) ||
+            !statement.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword))
+            continue;
+        if (!(statement.declarationList.flags & ts.NodeFlags.Const))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (ts.isIdentifier(declaration.name) &&
+                declaration.name.text === "definition")
+                declarations.push(declaration);
+        }
+    }
+    if (declarations.length !== 1)
+        return failure(declarations[1] ?? declarations[0] ?? file, declarations.length
+            ? "definition/duplicate-export"
+            : "definition/missing-export", declarations.length
+            ? "Exactly one definition export is allowed"
+            : "Missing exported const definition");
+    const declaration = declarations[0];
+    const initializer = declaration.initializer;
+    if (!initializer)
+        return failure(declaration, "definition/non-literal", "definition requires a literal initializer");
+    let visited = 0;
+    try {
+        const definition = read(initializer, "$", 0);
+        const diagnostics = validateNodeDefinition(definition).map((item) => ({
+            ...item,
+            file: fileName,
+            ...location(initializer),
+        }));
+        return diagnostics.length
+            ? { ok: false, diagnostics }
+            : { ok: true, definition: definition, diagnostics: [] };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            diagnostics: [error.diagnostic],
+        };
+    }
+    function read(node, path, depth) {
+        if (++visited > MAX_NODES)
+            throw extraction(node, "definition/size-limit", "Definition exceeds 10,000 syntax nodes", path);
+        if (depth > MAX_DEPTH)
+            throw extraction(node, "definition/depth-limit", "Definition exceeds 32 levels", path);
+        if (ts.isParenthesizedExpression(node) || ts.isSatisfiesExpression(node))
+            return read(node.expression, path, depth + 1);
+        if (ts.isAsExpression(node)) {
+            if (node.type.getText(file) !== "const")
+                throw extraction(node.type, "definition/non-literal", "Only 'as const' assertions are allowed", path);
+            return read(node.expression, path, depth + 1);
+        }
+        if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
+            return node.text;
+        if (ts.isNumericLiteral(node))
+            return Number(node.text);
+        if (node.kind === ts.SyntaxKind.TrueKeyword)
+            return true;
+        if (node.kind === ts.SyntaxKind.FalseKeyword)
+            return false;
+        if (node.kind === ts.SyntaxKind.NullKeyword)
+            return null;
+        if (ts.isPrefixUnaryExpression(node) &&
+            node.operator === ts.SyntaxKind.MinusToken &&
+            ts.isNumericLiteral(node.operand))
+            return -Number(node.operand.text);
+        if (ts.isArrayLiteralExpression(node))
+            return node.elements.map((element, index) => {
+                if (ts.isSpreadElement(element))
+                    throw extraction(element, "definition/spread", "Spreads are not allowed", `${path}.${index}`);
+                return read(element, `${path}.${index}`, depth + 1);
+            });
+        if (ts.isObjectLiteralExpression(node)) {
+            const object = Object.create(null);
+            const keys = new Set();
+            for (const property of node.properties) {
+                if (ts.isSpreadAssignment(property))
+                    throw extraction(property, "definition/spread", "Spreads are not allowed", path);
+                if (!ts.isPropertyAssignment(property) ||
+                    (property.name && ts.isComputedPropertyName(property.name)))
+                    throw extraction(property, "definition/non-literal", "Only explicit properties are allowed", path);
+                const key = ts.isIdentifier(property.name) ||
+                    ts.isStringLiteral(property.name) ||
+                    ts.isNumericLiteral(property.name)
+                    ? property.name.text
+                    : undefined;
+                if (key === undefined)
+                    throw extraction(property, "definition/non-literal", "Property name must be literal", path);
+                if (keys.has(key))
+                    throw extraction(property.name, "definition/duplicate-key", `Duplicate key ${key}`, `${path}.${key}`);
+                keys.add(key);
+                object[key] = read(property.initializer, `${path}.${key}`, depth + 1);
+            }
+            return object;
+        }
+        throw extraction(node, "definition/non-literal", `Unsupported ${ts.SyntaxKind[node.kind]}`, path);
+    }
+    function location(node) {
+        const point = file.getLineAndCharacterOfPosition(node.getStart(file));
+        return { line: point.line + 1, column: point.character + 1 };
+    }
+    function extraction(node, code, message, path) {
+        return new ExtractionFailure({
+            phase: "definition",
+            code,
+            message,
+            path,
+            file: fileName,
+            ...location(node),
+        });
+    }
+    function failure(node, code, message) {
+        return {
+            ok: false,
+            diagnostics: [extraction(node, code, message).diagnostic],
+        };
+    }
+}
+class ExtractionFailure extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.diagnostic = diagnostic;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/runtime/definition/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/definition/extract.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,GAGvB,MAAM,oBAAoB,CAAC;AAU5B,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,SAAS,GAAG,MAAM,CAAC;AAEzB,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,QAAgB,EAChB,EAAqB;IAErB,MAAM,IAAI,GAAG,EAAE,CAAC,gBAAgB,CAC9B,QAAQ,EACR,MAAM,EACN,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;IACF,MAAM,iBAAiB,GACrB,IAGD,CAAC,gBAAgB,CAAC;IACnB,IAAI,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE;gBACX;oBACE,KAAK,EAAE,YAAY;oBACnB,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,EAAE,CAAC,4BAA4B,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC;oBAClE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC;oBACpB,MAAM,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC;iBAC5B;aACF;SACF,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAqC,EAAE,CAAC;IAC1D,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IACE,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC;YAClC,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CACxB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAC5D;YAED,SAAS;QACX,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,SAAS;QACtE,KAAK,MAAM,WAAW,IAAI,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;YACjE,IACE,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC;gBACjC,WAAW,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;gBAEtC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAC3B,OAAO,OAAO,CACZ,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,EAC1C,YAAY,CAAC,MAAM;YACjB,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,2BAA2B,EAC/B,YAAY,CAAC,MAAM;YACjB,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,mCAAmC,CACxC,CAAC;IACJ,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;IAC5C,IAAI,CAAC,WAAW;QACd,OAAO,OAAO,CACZ,WAAW,EACX,wBAAwB,EACxB,2CAA2C,CAC5C,CAAC;IACJ,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,IAAI;YACP,IAAI,EAAE,QAAQ;YACd,GAAG,QAAQ,CAAC,WAAW,CAAC;SACzB,CAAC,CAAC,CAAC;QACJ,OAAO,WAAW,CAAC,MAAM;YACvB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;YAC5B,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,UAA4B,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE,CAAE,KAA2B,CAAC,UAAU,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,SAAS,IAAI,CACX,IAA2B,EAC3B,IAAY,EACZ,KAAa;QAEb,IAAI,EAAE,OAAO,GAAG,SAAS;YACvB,MAAM,UAAU,CACd,IAAI,EACJ,uBAAuB,EACvB,wCAAwC,EACxC,IAAI,CACL,CAAC;QACJ,IAAI,KAAK,GAAG,SAAS;YACnB,MAAM,UAAU,CACd,IAAI,EACJ,wBAAwB,EACxB,8BAA8B,EAC9B,IAAI,CACL,CAAC;QACJ,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;YACtE,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO;gBACrC,MAAM,UAAU,CACd,IAAI,CAAC,IAAI,EACT,wBAAwB,EACxB,wCAAwC,EACxC,IAAI,CACL,CAAC;YACJ,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC;YACtE,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QACzD,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QACzD,IACE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,UAAU;YAC1C,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;YAEjC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC;YACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;gBAC1C,IAAI,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;oBAC7B,MAAM,UAAU,CACd,OAAO,EACP,mBAAmB,EACnB,yBAAyB,EACzB,GAAG,IAAI,IAAI,KAAK,EAAE,CACnB,CAAC;gBACJ,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvC,IAAI,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC;oBACjC,MAAM,UAAU,CACd,QAAQ,EACR,mBAAmB,EACnB,yBAAyB,EACzB,IAAI,CACL,CAAC;gBACJ,IACE,CAAC,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC;oBAClC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAE3D,MAAM,UAAU,CACd,QAAQ,EACR,wBAAwB,EACxB,sCAAsC,EACtC,IAAI,CACL,CAAC;gBACJ,MAAM,GAAG,GACP,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAC9B,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACjC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAChC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI;oBACpB,CAAC,CAAC,SAAS,CAAC;gBAChB,IAAI,GAAG,KAAK,SAAS;oBACnB,MAAM,UAAU,CACd,QAAQ,EACR,wBAAwB,EACxB,+BAA+B,EAC/B,IAAI,CACL,CAAC;gBACJ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBACf,MAAM,UAAU,CACd,QAAQ,CAAC,IAAI,EACb,0BAA0B,EAC1B,iBAAiB,GAAG,EAAE,EACtB,GAAG,IAAI,IAAI,GAAG,EAAE,CACjB,CAAC;gBACJ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,UAAU,CACd,IAAI,EACJ,wBAAwB,EACxB,eAAe,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACzC,IAAI,CACL,CAAC;IACJ,CAAC;IACD,SAAS,QAAQ,CAAC,IAAqB;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;IAC/D,CAAC;IACD,SAAS,UAAU,CACjB,IAAqB,EACrB,IAAY,EACZ,OAAe,EACf,IAAa;QAEb,OAAO,IAAI,iBAAiB,CAAC;YAC3B,KAAK,EAAE,YAAY;YACnB,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,GAAG,QAAQ,CAAC,IAAI,CAAC;SAClB,CAAC,CAAC;IACL,CAAC;IACD,SAAS,OAAO,CACd,IAAqB,EACrB,IAAY,EACZ,OAAe;QAEf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC;SAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,iBAAkB,SAAQ,KAAK;IACd;IAArB,YAAqB,UAAsB;QACzC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QADP,eAAU,GAAV,UAAU,CAAY;IAE3C,CAAC;CACF"}

package/dist/runtime/error.d.ts

@@ -0,0 +1,8 @@
+import type { Diagnostic } from "cascade/contracts";
+export declare class CascadeRuntimeError extends Error {
+    readonly code: string;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly name = "CascadeRuntimeError";
+    constructor(code: string, diagnostics: readonly Diagnostic[], message?: string);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/runtime/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE;IAH7C,QAAQ,CAAC,IAAI,yBAAyB;gBAE3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,SAAS,UAAU,EAAE,EAC3C,OAAO,SAAkC;CAI5C"}

package/dist/runtime/error.js

@@ -0,0 +1,11 @@
+export class CascadeRuntimeError extends Error {
+    code;
+    diagnostics;
+    name = "CascadeRuntimeError";
+    constructor(code, diagnostics, message = diagnostics[0]?.message ?? code) {
+        super(message);
+        this.code = code;
+        this.diagnostics = diagnostics;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/runtime/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAGjC;IACA;IAHF,IAAI,GAAG,qBAAqB,CAAC;IACtC,YACW,IAAY,EACZ,WAAkC,EAC3C,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,IAAI;QAEzC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAuB;IAI7C,CAAC;CACF"}

package/dist/runtime/geometry/attributes.d.ts

@@ -0,0 +1,65 @@
+import { type AnyAttribute, type Attribute, type AttributeLevel, type AttributeSet, type AttributeStorage, type DetailValue, type ElementLevel, type Geometry, type StringAttribute } from "cascade/contracts";
+/**
+ * Attribute reads and writes. Every write returns a new `Geometry` and shares
+ * the arrays it did not touch, which is the whole reason the format is
+ * struct-of-arrays: with array-of-structs there is no granularity to share at.
+ *
+ * Node code should stay on this surface rather than reaching into an
+ * attribute's `data`, because nothing in the language stops a write into a
+ * shared array and everything downstream would then see it. See the immutability
+ * note at the top of `packages/contracts/src/geometry.ts`.
+ */
+export declare function geometryError(code: string, message: string): never;
+/** The attribute set at an element level. */
+export declare function attributeSet(geometry: Geometry, level: ElementLevel): AttributeSet;
+export declare function getAttribute(geometry: Geometry, level: ElementLevel, name: string): AnyAttribute | undefined;
+export declare function hasAttribute(geometry: Geometry, level: ElementLevel, name: string): boolean;
+/** Names at a level, in insertion order. */
+export declare function attributeNames(geometry: Geometry, level: ElementLevel): readonly string[];
+export declare function requireAttribute(geometry: Geometry, level: ElementLevel, name: string): AnyAttribute;
+/** A numeric attribute when present, with consumer-specific arity validation. */
+export declare function numericAttribute(attribute: AnyAttribute | undefined, path: string, sizes?: readonly number[]): Attribute | undefined;
+/** One component of one element. */
+export declare function readComponent(attribute: Attribute, index: number, component?: number): number;
+/** Every component of one element, as a plain array. */
+export declare function readElement(attribute: Attribute, index: number): number[];
+/** One element of a string attribute. Out-of-table indices read as empty. */
+export declare function readString(attribute: StringAttribute, index: number): string;
+/** A whole element without knowing which kind of attribute it is. */
+export declare function readAttribute(attribute: AnyAttribute, index: number): number | number[] | string;
+/** Declared position width: 2 or 3. */
+export declare function positionSize(geometry: Geometry): number;
+export declare function positionAttribute(geometry: Geometry): Attribute;
+export declare function getPosition(geometry: Geometry, index: number): number[];
+/** A zeroed numeric attribute for `count` elements. */
+export declare function createAttribute(count: number, size: number, storage?: AttributeStorage, fill?: readonly number[] | number): Attribute;
+/** A string attribute from per-element strings, tabled and deduplicated. */
+export declare function createStringAttribute(values: readonly string[]): StringAttribute;
+/** Replace one level's attribute set, sharing every other array. */
+export declare function withAttributeSet(geometry: Geometry, level: ElementLevel, set: AttributeSet): Geometry;
+/** Add or replace one attribute. Copy-on-write at attribute granularity. */
+export declare function setAttribute(geometry: Geometry, level: ElementLevel, name: string, attribute: AnyAttribute): Geometry;
+export declare function removeAttribute(geometry: Geometry, level: ElementLevel, name: string): Geometry;
+/** Replace the detail record, sharing every array. */
+export declare function setDetail(geometry: Geometry, name: string, value: DetailValue): Geometry;
+/** Drop one detail value, sharing every array. */
+export declare function removeDetail(geometry: Geometry, name: string): Geometry;
+export interface AttributeCreateOptions {
+    readonly level: AttributeLevel;
+    readonly name: string;
+    /** A constant for every element at the level, or the detail value. */
+    readonly value: number | readonly number[] | string;
+    /** Ignored for a string value; defaults to `f64`. */
+    readonly storage?: AttributeStorage;
+}
+/**
+ * The Attribute Create operation: one named attribute at one level, filled with
+ * a constant. This is the operation that makes the four-level model visible
+ * rather than an implementation detail, and it is the one that stops the
+ * `cloud-plots` class of bug, where every hand-rolled per-primitive value had
+ * to be remembered by name in every operation that touched the geometry.
+ */
+export declare function attributeCreate(geometry: Geometry, options: AttributeCreateOptions): Geometry;
+/** A same-storage copy of an attribute's array, for a write-in-place pass. */
+export declare function copyAttributeArray(attribute: Attribute): import("cascade/contracts").AttributeArray;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/runtime/geometry/attributes.d.ts.map

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