@field/cascade 0.5.2 → 0.7.0

package/dist/index.html

@@ -4,7 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Cascade</title>
-  <script type="module" crossorigin src="/assets/index-CeqTfMbr.js"></script>
+  <script type="module" crossorigin src="/assets/index-C35beBgj.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/legacy-CAj2_7QE.js">
   <link rel="modulepreload" crossorigin href="/assets/index-client-BoJgsN9M.js">
   <link rel="modulepreload" crossorigin href="/assets/nodeTypeUtils-BDJsc2Ks.js">

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

@@ -1,3 +1,4 @@
+import type { NodeExecutionContext } from "@field/cascade/contracts";
 export declare const rectangleDefinition: {
     readonly apiVersion: 1;
     readonly label: "Rectangle";
@@ -387,6 +388,116 @@ export declare const renderDefinition: {
         };
     };
 };
+/**
+ * `cascade.geo.FromRects` — the conversion, as a node.
+ *
+ * Named for what it does rather than for Houdini, which has no equivalent:
+ * `Rects` would read as a node that *produces* them, and `Convert` would be a
+ * general node with one mode in it.
+ *
+ * The whole point is that this is the only place `rects` is understood.
+ * `SvgExport`, `Render` and the viewport keep taking `geometry` and learn
+ * nothing — which is the argument MW-OBSERVATORY-ART made as owner of the
+ * consuming code, against adding a second input to the exporter.
+ *
+ * There is deliberately **no implicit `rects` → `geometry` conversion** in the
+ * type table. It would let a rects output wire straight into a geometry input,
+ * and the flip below would then happen invisibly or not at all — a picture
+ * silently mirrored is exactly the failure this node's `origin` prop exists to
+ * make a decision.
+ */
+export declare const fromRectsDefinition: {
+    readonly apiVersion: 1;
+    readonly label: "From Rects";
+    readonly description: "Convert rects into geometry, one closed polygon each, keeping the tag.";
+    readonly icon: "Frame";
+    readonly runsOn: "portable";
+    readonly inputs: {
+        readonly rects: {
+            readonly kind: "data";
+            readonly type: "rects";
+        };
+        /** The frame the rects were measured against, for the flip. */
+        readonly height: {
+            readonly kind: "data";
+            readonly type: "float";
+            readonly default: 0;
+            readonly min: 0;
+            readonly description: "Image height, for Top Left. Zero means no flip.";
+        };
+    };
+    readonly outputs: {
+        readonly geometry: {
+            readonly kind: "data";
+            readonly type: "geometry";
+        };
+    };
+    readonly props: {
+        readonly origin: {
+            readonly type: "string";
+            readonly default: "top-left";
+            readonly control: "select";
+            readonly options: readonly [{
+                readonly value: "top-left";
+                readonly label: "Top Left - raster, needs a height";
+            }, {
+                readonly value: "bottom-left";
+                readonly label: "Bottom Left - already +Y up";
+            }];
+            readonly label: "Origin";
+            readonly description: "Where y is measured from. Raster rects need flipping or the SVG comes out mirrored.";
+        };
+    };
+};
+export declare function executeFromRects(context: NodeExecutionContext<typeof fromRectsDefinition>): void;
+export declare const fromRectsRegistration: {
+    kind: "definition-v1";
+    moduleId: string;
+    definition: {
+        readonly apiVersion: 1;
+        readonly label: "From Rects";
+        readonly description: "Convert rects into geometry, one closed polygon each, keeping the tag.";
+        readonly icon: "Frame";
+        readonly runsOn: "portable";
+        readonly inputs: {
+            readonly rects: {
+                readonly kind: "data";
+                readonly type: "rects";
+            };
+            /** The frame the rects were measured against, for the flip. */
+            readonly height: {
+                readonly kind: "data";
+                readonly type: "float";
+                readonly default: 0;
+                readonly min: 0;
+                readonly description: "Image height, for Top Left. Zero means no flip.";
+            };
+        };
+        readonly outputs: {
+            readonly geometry: {
+                readonly kind: "data";
+                readonly type: "geometry";
+            };
+        };
+        readonly props: {
+            readonly origin: {
+                readonly type: "string";
+                readonly default: "top-left";
+                readonly control: "select";
+                readonly options: readonly [{
+                    readonly value: "top-left";
+                    readonly label: "Top Left - raster, needs a height";
+                }, {
+                    readonly value: "bottom-left";
+                    readonly label: "Bottom Left - already +Y up";
+                }];
+                readonly label: "Origin";
+                readonly description: "Where y is measured from. Raster rects need flipping or the SVG comes out mirrored.";
+            };
+        };
+    };
+    loadExecute: () => Promise<typeof executeFromRects>;
+};
 export declare const geoNodeDefinitions: readonly [readonly ["cascade.geo.Rectangle", {
     readonly apiVersion: 1;
     readonly label: "Rectangle";
@@ -769,5 +880,47 @@ export declare const geoNodeDefinitions: readonly [readonly ["cascade.geo.Rectan
             readonly step: 0.1;
         };
     };
+}], readonly ["cascade.geo.FromRects", {
+    readonly apiVersion: 1;
+    readonly label: "From Rects";
+    readonly description: "Convert rects into geometry, one closed polygon each, keeping the tag.";
+    readonly icon: "Frame";
+    readonly runsOn: "portable";
+    readonly inputs: {
+        readonly rects: {
+            readonly kind: "data";
+            readonly type: "rects";
+        };
+        /** The frame the rects were measured against, for the flip. */
+        readonly height: {
+            readonly kind: "data";
+            readonly type: "float";
+            readonly default: 0;
+            readonly min: 0;
+            readonly description: "Image height, for Top Left. Zero means no flip.";
+        };
+    };
+    readonly outputs: {
+        readonly geometry: {
+            readonly kind: "data";
+            readonly type: "geometry";
+        };
+    };
+    readonly props: {
+        readonly origin: {
+            readonly type: "string";
+            readonly default: "top-left";
+            readonly control: "select";
+            readonly options: readonly [{
+                readonly value: "top-left";
+                readonly label: "Top Left - raster, needs a height";
+            }, {
+                readonly value: "bottom-left";
+                readonly label: "Bottom Left - already +Y up";
+            }];
+            readonly label: "Origin";
+            readonly description: "Where y is measured from. Raster rects need flipping or the SVG comes out mirrored.";
+        };
+    };
 }]];
 //# sourceMappingURL=definitions.d.ts.map

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

@@ -1,3 +1,4 @@
+import { rectsToGeometry } from "../../geometry/rects.js";
 export const rectangleDefinition = {
     apiVersion: 1,
     label: "Rectangle",
@@ -240,6 +241,79 @@ export const renderDefinition = {
         pointRadius: { type: "float", default: 1.5, min: 0, max: 50, step: 0.1 },
     },
 };
+/**
+ * `cascade.geo.FromRects` — the conversion, as a node.
+ *
+ * Named for what it does rather than for Houdini, which has no equivalent:
+ * `Rects` would read as a node that *produces* them, and `Convert` would be a
+ * general node with one mode in it.
+ *
+ * The whole point is that this is the only place `rects` is understood.
+ * `SvgExport`, `Render` and the viewport keep taking `geometry` and learn
+ * nothing — which is the argument MW-OBSERVATORY-ART made as owner of the
+ * consuming code, against adding a second input to the exporter.
+ *
+ * There is deliberately **no implicit `rects` → `geometry` conversion** in the
+ * type table. It would let a rects output wire straight into a geometry input,
+ * and the flip below would then happen invisibly or not at all — a picture
+ * silently mirrored is exactly the failure this node's `origin` prop exists to
+ * make a decision.
+ */
+export const fromRectsDefinition = {
+    apiVersion: 1,
+    label: "From Rects",
+    description: "Convert rects into geometry, one closed polygon each, keeping the tag.",
+    icon: "Frame",
+    runsOn: "portable",
+    inputs: {
+        rects: { kind: "data", type: "rects" },
+        /** The frame the rects were measured against, for the flip. */
+        height: {
+            kind: "data",
+            type: "float",
+            default: 0,
+            min: 0,
+            description: "Image height, for Top Left. Zero means no flip.",
+        },
+    },
+    outputs: { geometry: { kind: "data", type: "geometry" } },
+    props: {
+        origin: {
+            type: "string",
+            default: "top-left",
+            control: "select",
+            options: [
+                { value: "top-left", label: "Top Left - raster, needs a height" },
+                { value: "bottom-left", label: "Bottom Left - already +Y up" },
+            ],
+            label: "Origin",
+            description: "Where y is measured from. Raster rects need flipping or the SVG comes out mirrored.",
+        },
+    },
+};
+export function executeFromRects(context) {
+    const incoming = context.inputs.rects;
+    const origin = context.props.origin === "bottom-left" ? "bottom-left" : "top-left";
+    const height = context.inputs.height ?? 0;
+    // A raster conversion with no height is the one mistake worth refusing: it
+    // produces a mirrored picture that looks plausible, and a silently upside
+    // down poster is harder to notice than a red node.
+    if (origin === "top-left" && height <= 0 && rectCount(incoming) > 0)
+        throw new Error("cascade.geo.FromRects needs the image height to flip raster rects — wire it, or set Origin to Bottom Left if the rects are already +Y up");
+    context.outputs.geometry.set(rectsToGeometry(incoming, { origin, height }));
+}
+function rectCount(value) {
+    if (Array.isArray(value))
+        return value.length;
+    const rects = value?.rects;
+    return Array.isArray(rects) ? rects.length : 0;
+}
+export const fromRectsRegistration = {
+    kind: "definition-v1",
+    moduleId: "cascade.geo.FromRects",
+    definition: fromRectsDefinition,
+    loadExecute: async () => executeFromRects,
+};
 export const geoNodeDefinitions = Object.freeze([
     ["cascade.geo.Rectangle", rectangleDefinition],
     ["cascade.geo.Circle", circleDefinition],
@@ -248,5 +322,6 @@ export const geoNodeDefinitions = Object.freeze([
     ["cascade.geo.CopyToPoints", copyToPointsDefinition],
     ["cascade.geo.SvgExport", svgExportDefinition],
     ["cascade.geo.Render", renderDefinition],
+    ["cascade.geo.FromRects", fromRectsDefinition],
 ]);
 //# sourceMappingURL=definitions.js.map

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

@@ -1,5 +1,7 @@
 import type { DefinitionNodeRegistration } from "../../types.js";
 import { copyToPointsRegistration } from "./copyToPoints.js";
+import { fromRectsRegistration } from "./definitions.js";
+export { executeFromRects, fromRectsDefinition } from "./definitions.js";
 import { circleRegistration, rectangleRegistration } from "./generators.js";
 import { mergeRegistration } from "./merge.js";
 import { renderRegistration } from "./render.js";
@@ -17,7 +19,7 @@ import { transformRegistration } from "./transform.js";
  *
  * The namespace lives in `namespace.ts`, once.
  */
-export { circleRegistration, copyToPointsRegistration, mergeRegistration, rectangleRegistration, renderRegistration, svgExportRegistration, transformRegistration, };
+export { circleRegistration, fromRectsRegistration, copyToPointsRegistration, mergeRegistration, rectangleRegistration, renderRegistration, svgExportRegistration, transformRegistration, };
 export { GEO_NAMESPACE, geoModuleId } from "./namespace.js";
 export declare const geoNodeRegistrations: readonly DefinitionNodeRegistration[];
 export declare function geoNodeRegistration(moduleId: string): DefinitionNodeRegistration | undefined;

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

@@ -1,4 +1,6 @@
 import { copyToPointsRegistration } from "./copyToPoints.js";
+import { fromRectsRegistration } from "./definitions.js";
+export { executeFromRects, fromRectsDefinition } from "./definitions.js";
 import { circleRegistration, rectangleRegistration } from "./generators.js";
 import { mergeRegistration } from "./merge.js";
 import { renderRegistration } from "./render.js";
@@ -16,7 +18,7 @@ import { transformRegistration } from "./transform.js";
  *
  * The namespace lives in `namespace.ts`, once.
  */
-export { circleRegistration, copyToPointsRegistration, mergeRegistration, rectangleRegistration, renderRegistration, svgExportRegistration, transformRegistration, };
+export { circleRegistration, fromRectsRegistration, copyToPointsRegistration, mergeRegistration, rectangleRegistration, renderRegistration, svgExportRegistration, transformRegistration, };
 export { GEO_NAMESPACE, geoModuleId } from "./namespace.js";
 export const geoNodeRegistrations = Object.freeze([
     rectangleRegistration,
@@ -26,6 +28,7 @@ export const geoNodeRegistrations = Object.freeze([
     copyToPointsRegistration,
     renderRegistration,
     svgExportRegistration,
+    fromRectsRegistration,
 ]);
 const registrationsById = new Map(geoNodeRegistrations.map((registration) => [
     registration.moduleId,

package/dist/runtime/builtins/index.js

@@ -1,5 +1,6 @@
 import { coreNodeRegistrations } from "./core/index.js";
 import { geoNodeRegistrations } from "./geo/index.js";
+import { mathNodeRegistrations } from "./math/index.js";
 import { popNodeRegistrations } from "./pop/index.js";
 import { sceneNodeRegistrations } from "./scene/index.js";
 /**
@@ -13,6 +14,7 @@ import { sceneNodeRegistrations } from "./scene/index.js";
 export const builtinNodeRegistrations = Object.freeze([
     ...coreNodeRegistrations,
     ...geoNodeRegistrations,
+    ...mathNodeRegistrations,
     ...popNodeRegistrations,
     ...sceneNodeRegistrations,
 ]);