@field/cascade 0.2.22

package/dist/runtime/geometry/generate.js

@@ -0,0 +1,76 @@
+import { geometryError } from "./attributes.js";
+import { GeometryBuilder } from "./builder.js";
+function finitePair(value, code) {
+    if (!Number.isFinite(value[0]) || !Number.isFinite(value[1]))
+        geometryError(code, "both components must be finite");
+}
+/**
+ * A closed four-point polygon, counter-clockwise from the bottom-left corner.
+ * Houdini has no Rectangle: its Grid with two rows and two columns does the
+ * job, and `size` and `center` are that node's parameter names.
+ */
+export function rectangleGeometry(options = {}) {
+    const [width, height] = options.size ?? [1, 1];
+    const [cx, cy] = options.center ?? [0, 0];
+    finitePair([width, height], "rectangle-size");
+    finitePair([cx, cy], "rectangle-center");
+    if (width < 0 || height < 0)
+        geometryError("rectangle-size", "rectangle size must not be negative");
+    const x0 = cx - width / 2;
+    const x1 = cx + width / 2;
+    const y0 = cy - height / 2;
+    const y1 = cy + height / 2;
+    const builder = new GeometryBuilder();
+    builder.addPolygon([x0, y0, x1, y0, x1, y1, x0, y1], { closed: true });
+    return builder.build();
+}
+/**
+ * A closed circle, either as one cubic Bézier chain or as one polygon.
+ *
+ * The Bézier form is four segments with the classic handle length
+ * `k = 4/3 · tan(π/8)`, which is the standard four-arc approximation and the
+ * one every vector tool uses. Twelve points: four anchors at the axes and two
+ * handles between each pair.
+ */
+export function circleGeometry(options = {}) {
+    const [cx, cy] = options.center ?? [0, 0];
+    const [rx, ry] = options.radius ?? [1, 1];
+    finitePair([cx, cy], "circle-center");
+    finitePair([rx, ry], "circle-radius");
+    if (rx < 0 || ry < 0)
+        geometryError("circle-radius", "circle radius must not be negative");
+    const builder = new GeometryBuilder();
+    if ((options.type ?? "bezier") === "poly") {
+        const divisions = options.divisions ?? 32;
+        if (!Number.isSafeInteger(divisions) || divisions < 3)
+            geometryError("circle-divisions", "a polygonal circle needs an integer division count of at least 3");
+        const flat = [];
+        for (let index = 0; index < divisions; index += 1) {
+            const angle = (2 * Math.PI * index) / divisions;
+            flat.push(cx + rx * Math.cos(angle), cy + ry * Math.sin(angle));
+        }
+        builder.addPolygon(flat, { closed: true });
+        return builder.build();
+    }
+    const k = (4 / 3) * Math.tan(Math.PI / 8);
+    const kx = rx * k;
+    const ky = ry * k;
+    // Anchor, handle, handle, per quarter, counter-clockwise from +X.
+    const flat = [
+        cx + rx, cy,
+        cx + rx, cy + ky,
+        cx + kx, cy + ry,
+        cx, cy + ry,
+        cx - kx, cy + ry,
+        cx - rx, cy + ky,
+        cx - rx, cy,
+        cx - rx, cy - ky,
+        cx - kx, cy - ry,
+        cx, cy - ry,
+        cx + kx, cy - ry,
+        cx + rx, cy - ky,
+    ];
+    builder.addPolygon(flat, { closed: true, kind: "bezier" });
+    return builder.build();
+}
+//# sourceMappingURL=generate.js.map

package/dist/runtime/geometry/generate.js.map

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

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

@@ -0,0 +1,18 @@
+import { type Geometry } from "cascade/contracts";
+/**
+ * Groups are named subsets, stored as one byte per element. A mask is the right
+ * shape because membership is tested far more often than it is enumerated, and
+ * because it is what lets a subset be named without duplicating the geometry:
+ * `cloud-plots` copies 5.8 MB of geometry per cook to express what a 39 KB mask
+ * says, purely because there is no way to say "this subset of primitives".
+ */
+export type GroupLevel = "point" | "primitive";
+export declare function groupMask(geometry: Geometry, level: GroupLevel, name: string): Uint8Array | undefined;
+export declare function inGroup(mask: Uint8Array, index: number): boolean;
+/** The members of a mask, ascending. Enumerate only when you must. */
+export declare function groupIndices(mask: Uint8Array): number[];
+export declare function groupNames(geometry: Geometry, level: GroupLevel): readonly string[];
+/** Add or replace one named subset, from a mask or a list of indices. */
+export declare function setGroup(geometry: Geometry, level: GroupLevel, name: string, members: Uint8Array | readonly number[]): Geometry;
+export declare function removeGroup(geometry: Geometry, level: GroupLevel, name: string): Geometry;
+//# sourceMappingURL=groups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/geometry/groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI/E;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAO/C,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,SAAS,CAExB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAKvD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,GAChB,SAAS,MAAM,EAAE,CAEnB;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,GACtC,QAAQ,CA6BV;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,GACX,QAAQ,CAcV"}

package/dist/runtime/geometry/groups.js

@@ -0,0 +1,69 @@
+import { createGeometry, levelCount } from "cascade/contracts";
+import { geometryError } from "./attributes.js";
+const KEYS = {
+    point: "pointGroups",
+    primitive: "primitiveGroups",
+};
+export function groupMask(geometry, level, name) {
+    return geometry[KEYS[level]][name];
+}
+export function inGroup(mask, index) {
+    return mask[index] === 1;
+}
+/** The members of a mask, ascending. Enumerate only when you must. */
+export function groupIndices(mask) {
+    const indices = [];
+    for (let index = 0; index < mask.length; index += 1)
+        if (mask[index])
+            indices.push(index);
+    return indices;
+}
+export function groupNames(geometry, level) {
+    return Object.keys(geometry[KEYS[level]]);
+}
+/** Add or replace one named subset, from a mask or a list of indices. */
+export function setGroup(geometry, level, name, members) {
+    const count = levelCount(geometry, level);
+    let mask;
+    if (members instanceof Uint8Array) {
+        if (members.length !== count)
+            geometryError("group-length", `${name} covers ${members.length} of ${count} elements`);
+        mask = members;
+    }
+    else {
+        mask = new Uint8Array(count);
+        for (const member of members) {
+            if (!Number.isInteger(member) || member < 0 || member >= count)
+                geometryError("group-indices", `${name} references element ${member}`);
+            mask[member] = 1;
+        }
+    }
+    const groups = { ...geometry[KEYS[level]], [name]: mask };
+    return createGeometry({
+        pointCount: geometry.pointCount,
+        point: geometry.point,
+        vertex: geometry.vertex,
+        primitive: geometry.primitive,
+        detail: geometry.detail,
+        topology: geometry.topology,
+        pointGroups: level === "point" ? groups : geometry.pointGroups,
+        primitiveGroups: level === "primitive" ? groups : geometry.primitiveGroups,
+    });
+}
+export function removeGroup(geometry, level, name) {
+    if (groupMask(geometry, level, name) === undefined)
+        return geometry;
+    const groups = { ...geometry[KEYS[level]] };
+    delete groups[name];
+    return createGeometry({
+        pointCount: geometry.pointCount,
+        point: geometry.point,
+        vertex: geometry.vertex,
+        primitive: geometry.primitive,
+        detail: geometry.detail,
+        topology: geometry.topology,
+        pointGroups: level === "point" ? groups : geometry.pointGroups,
+        primitiveGroups: level === "primitive" ? groups : geometry.primitiveGroups,
+    });
+}
+//# sourceMappingURL=groups.js.map

package/dist/runtime/geometry/groups.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * Geometry operations. Environment-neutral arithmetic over the `geometry`
+ * contract type: no DOM, no Node, no dependencies.
+ *
+ * The types, the interchange form and the codec live in
+ * `packages/contracts/src/geometry.ts`, and its header carries the
+ * copy-on-write rule and the one runtime interaction worth knowing about.
+ * Everything that computes lives here, so that a Studio preview or a
+ * compatibility node adapts these semantics rather than forking them.
+ */
+export * from "./attributes.js";
+export * from "./builder.js";
+export * from "./copy.js";
+export * from "./generate.js";
+export * from "./groups.js";
+export * from "./matrix.js";
+export * from "./merge.js";
+export * from "./primitives.js";
+export * from "./promote.js";
+export * from "./resample.js";
+export * from "./svg.js";
+export * from "./transform.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/runtime/geometry/index.js

@@ -0,0 +1,23 @@
+/**
+ * Geometry operations. Environment-neutral arithmetic over the `geometry`
+ * contract type: no DOM, no Node, no dependencies.
+ *
+ * The types, the interchange form and the codec live in
+ * `packages/contracts/src/geometry.ts`, and its header carries the
+ * copy-on-write rule and the one runtime interaction worth knowing about.
+ * Everything that computes lives here, so that a Studio preview or a
+ * compatibility node adapts these semantics rather than forking them.
+ */
+export * from "./attributes.js";
+export * from "./builder.js";
+export * from "./copy.js";
+export * from "./generate.js";
+export * from "./groups.js";
+export * from "./matrix.js";
+export * from "./merge.js";
+export * from "./primitives.js";
+export * from "./promote.js";
+export * from "./resample.js";
+export * from "./svg.js";
+export * from "./transform.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { Mat3 } from "cascade/contracts";
+/**
+ * The `mat3` a transform node or an instancing operation needs, built from the
+ * four parameters a Houdini user already knows: translate, rotate, scale and
+ * pivot.
+ *
+ * Matrices are column-major, as the `mat3` type is documented to be, so the
+ * translation sits in the third column at indices 6 and 7 and `transformGeometry`
+ * reads it there.
+ *
+ * Rotation is in degrees and counter-clockwise, because geometry is +Y up and a
+ * positive angle turning clockwise would be the first of the small surprises
+ * that make a hand feel wrong.
+ *
+ * The order is Houdini's SRT with a pivot: scale, then rotate, then translate,
+ * all about the pivot. Written out, `M = T(t) · T(p) · R(r) · S(s) · T(-p)`.
+ */
+export interface TransformParameters {
+    readonly translate?: readonly [number, number];
+    /** Degrees, counter-clockwise. */
+    readonly rotate?: number;
+    readonly scale?: readonly [number, number];
+    readonly pivot?: readonly [number, number];
+}
+export declare function transformMatrix(parameters: TransformParameters): Mat3;
+//# sourceMappingURL=matrix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/geometry/matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAyBrE"}

package/dist/runtime/geometry/matrix.js

@@ -0,0 +1,27 @@
+export function transformMatrix(parameters) {
+    const [tx, ty] = parameters.translate ?? [0, 0];
+    const [sx, sy] = parameters.scale ?? [1, 1];
+    const [px, py] = parameters.pivot ?? [0, 0];
+    const rotate = parameters.rotate ?? 0;
+    if (![tx, ty, sx, sy, px, py, rotate].every(Number.isFinite))
+        throw new TypeError("geometry/transform: transform parameters must be finite");
+    const radians = (rotate * Math.PI) / 180;
+    const cos = Math.cos(radians);
+    const sin = Math.sin(radians);
+    const a00 = cos * sx;
+    const a10 = sin * sx;
+    const a01 = -sin * sy;
+    const a11 = cos * sy;
+    return [
+        a00,
+        a10,
+        0,
+        a01,
+        a11,
+        0,
+        tx + px - (a00 * px + a01 * py),
+        ty + py - (a10 * px + a11 * py),
+        1,
+    ];
+}
+//# sourceMappingURL=matrix.js.map

package/dist/runtime/geometry/matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.js","sourceRoot":"","sources":["../../src/geometry/matrix.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,eAAe,CAAC,UAA+B;IAC7D,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACrB,OAAO;QACL,GAAG;QACH,GAAG;QACH,CAAC;QACD,GAAG;QACH,GAAG;QACH,CAAC;QACD,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;QAC/B,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,33 @@
+import { type AttributeStorage, type Geometry } from "cascade/contracts";
+/**
+ * Merge concatenates geometries and renumbers points, vertices and primitives.
+ *
+ * It is the operation that proves the format composes, so the attribute rule is
+ * the interesting part: the result carries the *union* of the attribute names on
+ * its inputs, and an attribute present on one side and absent on the other is
+ * zero-filled over the range that lacked it rather than dropped. That is the
+ * whole argument for a generic attribute table. The two live bugs in
+ * `cloud-plots` are both an operation dropping an attribute it had never heard
+ * of, and an operation that copies the whole set cannot make that mistake.
+ *
+ * Three conflicts have to be resolved rather than avoided:
+ *
+ * A differing component count widens to the largest and zero-fills the missing
+ * components. This is how a 2-component `P` and a 3-component `P` merge into a
+ * 3-component one with z = 0, which is the case that actually occurs.
+ *
+ * A differing storage widens to whichever holds both exactly, so an `i32`
+ * meeting an `f32` becomes `f64` rather than silently losing large integers.
+ *
+ * A name that is a string attribute on one side and numeric on the other is an
+ * error, because either coercion would be a guess.
+ *
+ * Detail is first-wins, so merging into a geometry keeps the document facts of
+ * the first input. Houdini's Merge does the same and the alternative, last-wins,
+ * makes the result depend on wiring order in a way nobody can see.
+ */
+export declare function mergeGeometry(...inputs: readonly Geometry[]): Geometry;
+export declare function mergeGeometries(inputs: readonly Geometry[]): Geometry;
+/** The narrowest storage that holds both operands' values exactly. */
+export declare function widerStorage(a: AttributeStorage, b: AttributeStorage): AttributeStorage;
+//# sourceMappingURL=merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/geometry/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,gBAAgB,EAIrB,KAAK,QAAQ,EAEd,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,GAAG,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,CAEtE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,CA+CrE;AAkBD,sEAAsE;AACtE,wBAAgB,YAAY,CAC1B,CAAC,EAAE,gBAAgB,EACnB,CAAC,EAAE,gBAAgB,GAClB,gBAAgB,CAMlB"}

package/dist/runtime/geometry/merge.js

@@ -0,0 +1,185 @@
+import { attributeArray, createGeometry, emptyGeometry, isStringAttribute, levelCount, } from "cascade/contracts";
+import { createStringAttribute, geometryError, readString } from "./attributes.js";
+/**
+ * Merge concatenates geometries and renumbers points, vertices and primitives.
+ *
+ * It is the operation that proves the format composes, so the attribute rule is
+ * the interesting part: the result carries the *union* of the attribute names on
+ * its inputs, and an attribute present on one side and absent on the other is
+ * zero-filled over the range that lacked it rather than dropped. That is the
+ * whole argument for a generic attribute table. The two live bugs in
+ * `cloud-plots` are both an operation dropping an attribute it had never heard
+ * of, and an operation that copies the whole set cannot make that mistake.
+ *
+ * Three conflicts have to be resolved rather than avoided:
+ *
+ * A differing component count widens to the largest and zero-fills the missing
+ * components. This is how a 2-component `P` and a 3-component `P` merge into a
+ * 3-component one with z = 0, which is the case that actually occurs.
+ *
+ * A differing storage widens to whichever holds both exactly, so an `i32`
+ * meeting an `f32` becomes `f64` rather than silently losing large integers.
+ *
+ * A name that is a string attribute on one side and numeric on the other is an
+ * error, because either coercion would be a guess.
+ *
+ * Detail is first-wins, so merging into a geometry keeps the document facts of
+ * the first input. Houdini's Merge does the same and the alternative, last-wins,
+ * makes the result depend on wiring order in a way nobody can see.
+ */
+export function mergeGeometry(...inputs) {
+    return mergeGeometries(inputs);
+}
+export function mergeGeometries(inputs) {
+    if (inputs.length === 0)
+        return emptyGeometry(2);
+    if (inputs.length === 1)
+        return inputs[0];
+    const pointCount = sum(inputs, (input) => input.pointCount);
+    const vertexCount = sum(inputs, (input) => input.vertexCount);
+    const primitiveCount = sum(inputs, (input) => input.primitiveCount);
+    const vertexPoints = new Int32Array(vertexCount);
+    const offsets = new Int32Array(primitiveCount + 1);
+    const kinds = new Uint8Array(primitiveCount);
+    const closed = new Uint8Array(primitiveCount);
+    let pointBase = 0;
+    let vertexBase = 0;
+    let primitiveBase = 0;
+    for (const input of inputs) {
+        for (let vertex = 0; vertex < input.vertexCount; vertex += 1)
+            vertexPoints[vertexBase + vertex] =
+                input.topology.vertexPoints[vertex] + pointBase;
+        for (let primitive = 0; primitive < input.primitiveCount; primitive += 1) {
+            offsets[primitiveBase + primitive] =
+                input.topology.offsets[primitive] + vertexBase;
+            kinds[primitiveBase + primitive] = input.topology.kinds[primitive];
+            closed[primitiveBase + primitive] = input.topology.closed[primitive];
+        }
+        pointBase += input.pointCount;
+        vertexBase += input.vertexCount;
+        primitiveBase += input.primitiveCount;
+    }
+    offsets[primitiveCount] = vertexCount;
+    const detail = {};
+    for (const input of inputs)
+        for (const [name, value] of Object.entries(input.detail))
+            if (!Object.prototype.hasOwnProperty.call(detail, name))
+                detail[name] = value;
+    return createGeometry({
+        pointCount,
+        point: mergeLevel(inputs, "point"),
+        vertex: mergeLevel(inputs, "vertex"),
+        primitive: mergeLevel(inputs, "primitive"),
+        detail,
+        topology: { vertexPoints, offsets, kinds, closed },
+        pointGroups: mergeGroups(inputs, "point"),
+        primitiveGroups: mergeGroups(inputs, "primitive"),
+    });
+}
+function sum(inputs, read) {
+    let total = 0;
+    for (const input of inputs)
+        total += read(input);
+    return total;
+}
+const STORAGE_RANK = {
+    u8: 0,
+    i32: 1,
+    f32: 2,
+    f64: 3,
+};
+/** The narrowest storage that holds both operands' values exactly. */
+export function widerStorage(a, b) {
+    if (a === b)
+        return a;
+    if (a === "f64" || b === "f64")
+        return "f64";
+    // f32 has 24 bits of mantissa, so it cannot hold every i32 exactly.
+    if ((a === "i32" && b === "f32") || (a === "f32" && b === "i32"))
+        return "f64";
+    return STORAGE_RANK[a] > STORAGE_RANK[b] ? a : b;
+}
+function mergeLevel(inputs, level) {
+    const names = [];
+    for (const input of inputs)
+        for (const name of Object.keys(input[level]))
+            if (!names.includes(name))
+                names.push(name);
+    const total = sum(inputs, (input) => levelCount(input, level));
+    const result = {};
+    for (const name of names) {
+        const present = inputs
+            .map((input) => input[level][name])
+            .filter((attribute) => attribute !== undefined);
+        const strings = present.filter(isStringAttribute).length;
+        if (strings !== 0 && strings !== present.length)
+            geometryError("attribute-conflict", `${level}.${name} is a string attribute on one input and numeric on another`);
+        result[name] =
+            strings === present.length
+                ? mergeStringAttribute(inputs, level, name, total)
+                : mergeNumericAttribute(inputs, level, name, total);
+    }
+    return result;
+}
+function mergeNumericAttribute(inputs, level, name, total) {
+    let size = 1;
+    let storage;
+    for (const input of inputs) {
+        const attribute = input[level][name];
+        if (attribute === undefined || isStringAttribute(attribute))
+            continue;
+        size = Math.max(size, attribute.size);
+        storage = storage === undefined ? attribute.storage : widerStorage(storage, attribute.storage);
+    }
+    const data = attributeArray(storage ?? "f64", size * total);
+    let base = 0;
+    for (const input of inputs) {
+        const count = levelCount(input, level);
+        const attribute = input[level][name];
+        if (attribute !== undefined && !isStringAttribute(attribute))
+            for (let index = 0; index < count; index += 1)
+                for (let component = 0; component < attribute.size; component += 1)
+                    data[(base + index) * size + component] =
+                        attribute.data[index * attribute.size + component];
+        base += count;
+    }
+    return { storage: storage ?? "f64", size, data };
+}
+function mergeStringAttribute(inputs, level, name, total) {
+    const values = new Array(total).fill("");
+    let base = 0;
+    for (const input of inputs) {
+        const count = levelCount(input, level);
+        const attribute = input[level][name];
+        if (attribute !== undefined && isStringAttribute(attribute))
+            for (let index = 0; index < count; index += 1)
+                values[base + index] = readString(attribute, index);
+        base += count;
+    }
+    return createStringAttribute(values);
+}
+function mergeGroups(inputs, level) {
+    const key = level === "point" ? "pointGroups" : "primitiveGroups";
+    const names = [];
+    for (const input of inputs)
+        for (const name of Object.keys(input[key]))
+            if (!names.includes(name))
+                names.push(name);
+    const total = sum(inputs, (input) => levelCount(input, level));
+    const result = {};
+    for (const name of names) {
+        const mask = new Uint8Array(total);
+        let base = 0;
+        for (const input of inputs) {
+            const count = levelCount(input, level);
+            const source = input[key][name];
+            if (source !== undefined)
+                for (let index = 0; index < count; index += 1)
+                    mask[base + index] = source[index];
+            base += count;
+        }
+        result[name] = mask;
+    }
+    return result;
+}
+//# sourceMappingURL=merge.js.map

package/dist/runtime/geometry/merge.js.map

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

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

@@ -0,0 +1,41 @@
+import type { Geometry, PrimitiveKind } from "cascade/contracts";
+/** Topology and measurement reads that the operations share. */
+export declare function primitiveKind(geometry: Geometry, primitive: number): PrimitiveKind;
+export declare function isClosed(geometry: Geometry, primitive: number): boolean;
+/** True when the primitive's vertex run is a cubic Bézier chain. */
+export declare function isBezier(geometry: Geometry, primitive: number): boolean;
+/**
+ * The cubic segments of a `bezier` primitive, each as the four point indices
+ * `[anchor, handle, handle, anchor]`. A closed primitive's last segment wraps
+ * to the first anchor. The arity is guaranteed by `createGeometry`, so this
+ * needs no defensive branch.
+ */
+export declare function bezierSegments(geometry: Geometry, primitive: number): number[][];
+/** Half-open vertex range `[start, end)` of one primitive. */
+export declare function vertexRange(geometry: Geometry, primitive: number): readonly [number, number];
+export declare function vertexCountOf(geometry: Geometry, primitive: number): number;
+/** The point indices a primitive's vertices reference, in vertex order. */
+export declare function primitivePoints(geometry: Geometry, primitive: number): number[];
+/** A mask of the points no primitive references: the loose points, the dots. */
+export declare function loosePointMask(geometry: Geometry): Uint8Array;
+export declare function distance(positions: ArrayLike<number>, size: number, a: number, b: number): number;
+/**
+ * Cumulative arc lengths along one primitive, one entry per segment. A closed
+ * primitive has one more segment than an open one, the one that returns to its
+ * first point.
+ *
+ * Linear only. A `bezier` primitive is refused rather than measured along its
+ * control polygon, because a length that is quietly 10% short is worse than one
+ * that is missing: flatten the curve first, and see the note on the kind
+ * vocabulary in `packages/contracts/src/geometry.ts`.
+ */
+export declare function arcLengths(geometry: Geometry, primitive: number): number[];
+export declare function primitiveLength(geometry: Geometry, primitive: number): number;
+export declare function geometryLength(geometry: Geometry): number;
+export interface Bounds {
+    readonly min: readonly number[];
+    readonly max: readonly number[];
+}
+/** Axis-aligned bounds over every point, or undefined for an empty geometry. */
+export declare function geometryBounds(geometry: Geometry): Bounds | undefined;
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/geometry/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASlE,gEAAgE;AAEhE,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,aAAa,CAEf;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,EAAE,CAiBZ;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAK3B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAMV;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAO7D;AAED,wBAAgB,QAAQ,CACtB,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,CAOR;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB1E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAKzD;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAarE"}