@field/cascade 0.2.22

package/dist/runtime/geometry/attributes.js

@@ -0,0 +1,201 @@
+import { attributeArray, attributeArrayFrom, createGeometry, isStringAttribute, levelCount, POSITION_ATTRIBUTE, } 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 function geometryError(code, message) {
+    throw new TypeError(`geometry/${code}: ${message}`);
+}
+/** The attribute set at an element level. */
+export function attributeSet(geometry, level) {
+    return geometry[level];
+}
+export function getAttribute(geometry, level, name) {
+    return geometry[level][name];
+}
+export function hasAttribute(geometry, level, name) {
+    return Object.prototype.hasOwnProperty.call(geometry[level], name);
+}
+/** Names at a level, in insertion order. */
+export function attributeNames(geometry, level) {
+    return Object.keys(geometry[level]);
+}
+export function requireAttribute(geometry, level, name) {
+    const attribute = geometry[level][name];
+    if (attribute === undefined)
+        geometryError("missing-attribute", `${level}.${name} is not present`);
+    return attribute;
+}
+/** A numeric attribute when present, with consumer-specific arity validation. */
+export function numericAttribute(attribute, path, sizes) {
+    if (attribute === undefined)
+        return undefined;
+    if (isStringAttribute(attribute))
+        geometryError("attribute-storage", `${path} must be numeric`);
+    if (sizes !== undefined && !sizes.includes(attribute.size))
+        geometryError("attribute-size", `${path} has size ${attribute.size}; expected ${sizes.join(" or ")}`);
+    return attribute;
+}
+/** One component of one element. */
+export function readComponent(attribute, index, component = 0) {
+    return attribute.data[index * attribute.size + component];
+}
+/** Every component of one element, as a plain array. */
+export function readElement(attribute, index) {
+    const values = new Array(attribute.size);
+    for (let component = 0; component < attribute.size; component += 1)
+        values[component] = attribute.data[index * attribute.size + component];
+    return values;
+}
+/** One element of a string attribute. Out-of-table indices read as empty. */
+export function readString(attribute, index) {
+    const slot = attribute.data[index];
+    return slot < 0 ? "" : (attribute.table[slot] ?? "");
+}
+/** A whole element without knowing which kind of attribute it is. */
+export function readAttribute(attribute, index) {
+    if (isStringAttribute(attribute))
+        return readString(attribute, index);
+    return attribute.size === 1
+        ? readComponent(attribute, index)
+        : readElement(attribute, index);
+}
+/** Declared position width: 2 or 3. */
+export function positionSize(geometry) {
+    return geometry.point[POSITION_ATTRIBUTE].size;
+}
+export function positionAttribute(geometry) {
+    return geometry.point[POSITION_ATTRIBUTE];
+}
+export function getPosition(geometry, index) {
+    return readElement(positionAttribute(geometry), index);
+}
+/** A zeroed numeric attribute for `count` elements. */
+export function createAttribute(count, size, storage = "f64", fill) {
+    const data = attributeArray(storage, size * count);
+    if (fill !== undefined) {
+        const values = typeof fill === "number" ? [fill] : fill;
+        for (let index = 0; index < count; index += 1)
+            for (let component = 0; component < size; component += 1)
+                data[index * size + component] =
+                    values[component % Math.max(values.length, 1)] ?? 0;
+    }
+    return { storage, size, data };
+}
+/** A string attribute from per-element strings, tabled and deduplicated. */
+export function createStringAttribute(values) {
+    const table = [];
+    const slots = new Map();
+    const data = new Int32Array(values.length);
+    for (let index = 0; index < values.length; index += 1) {
+        const value = values[index];
+        let slot = slots.get(value);
+        if (slot === undefined) {
+            slot = table.length;
+            table.push(value);
+            slots.set(value, slot);
+        }
+        data[index] = slot;
+    }
+    return { storage: "string", size: 1, table, data };
+}
+/** Replace one level's attribute set, sharing every other array. */
+export function withAttributeSet(geometry, level, set) {
+    return createGeometry({
+        pointCount: geometry.pointCount,
+        point: level === "point" ? set : geometry.point,
+        vertex: level === "vertex" ? set : geometry.vertex,
+        primitive: level === "primitive" ? set : geometry.primitive,
+        detail: geometry.detail,
+        topology: geometry.topology,
+        pointGroups: geometry.pointGroups,
+        primitiveGroups: geometry.primitiveGroups,
+    });
+}
+/** Add or replace one attribute. Copy-on-write at attribute granularity. */
+export function setAttribute(geometry, level, name, attribute) {
+    return withAttributeSet(geometry, level, {
+        ...geometry[level],
+        [name]: attribute,
+    });
+}
+export function removeAttribute(geometry, level, name) {
+    if (level === "point" && name === POSITION_ATTRIBUTE)
+        geometryError("remove-position", "point.P cannot be removed");
+    if (!hasAttribute(geometry, level, name))
+        return geometry;
+    const set = { ...geometry[level] };
+    delete set[name];
+    return withAttributeSet(geometry, level, set);
+}
+/** Replace the detail record, sharing every array. */
+export function setDetail(geometry, name, value) {
+    return createGeometry({
+        pointCount: geometry.pointCount,
+        point: geometry.point,
+        vertex: geometry.vertex,
+        primitive: geometry.primitive,
+        detail: { ...geometry.detail, [name]: value },
+        topology: geometry.topology,
+        pointGroups: geometry.pointGroups,
+        primitiveGroups: geometry.primitiveGroups,
+    });
+}
+/** Drop one detail value, sharing every array. */
+export function removeDetail(geometry, name) {
+    if (!Object.prototype.hasOwnProperty.call(geometry.detail, name))
+        return geometry;
+    const detail = { ...geometry.detail };
+    delete detail[name];
+    return createGeometry({
+        pointCount: geometry.pointCount,
+        point: geometry.point,
+        vertex: geometry.vertex,
+        primitive: geometry.primitive,
+        detail,
+        topology: geometry.topology,
+        pointGroups: geometry.pointGroups,
+        primitiveGroups: geometry.primitiveGroups,
+    });
+}
+/**
+ * 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 function attributeCreate(geometry, options) {
+    const { level, name, value } = options;
+    if (level === "detail")
+        return setDetail(geometry, name, typeof value === "number" || typeof value === "string"
+            ? value
+            : [...value]);
+    const count = levelCount(geometry, level);
+    if (typeof value === "string")
+        return setAttribute(geometry, level, name, createStringAttribute(new Array(count).fill(value)));
+    const values = typeof value === "number" ? [value] : value;
+    if (values.length === 0)
+        geometryError("attribute-size", `${level}.${name} needs at least one component`);
+    const storage = options.storage ?? "f64";
+    const data = attributeArray(storage, values.length * count);
+    for (let index = 0; index < count; index += 1)
+        for (let component = 0; component < values.length; component += 1)
+            data[index * values.length + component] = values[component];
+    return setAttribute(geometry, level, name, {
+        storage,
+        size: values.length,
+        data,
+    });
+}
+/** A same-storage copy of an attribute's array, for a write-in-place pass. */
+export function copyAttributeArray(attribute) {
+    return attributeArrayFrom(attribute.storage, attribute.data);
+}
+//# sourceMappingURL=attributes.js.map

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

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

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

@@ -0,0 +1,57 @@
+import { emptyGeometry, type AnyAttribute, type AttributeStorage, type DetailValue, type ElementLevel, type Geometry, type PrimitiveKind } from "cascade/contracts";
+export { emptyGeometry };
+export interface GeometryBuilderOptions {
+    /** 2 by default: the reference workloads are two-component. */
+    readonly positionSize?: 2 | 3;
+    readonly positionStorage?: "f32" | "f64";
+}
+export interface AddPrimitiveOptions {
+    readonly closed?: boolean;
+    readonly kind?: PrimitiveKind;
+}
+/**
+ * The accumulating constructor. Points and primitives go in one at a time and
+ * `build` produces the frozen struct-of-arrays form once, so a generator does
+ * not have to know the final counts up front or touch a typed array.
+ *
+ * Attributes are set after the elements exist, by name and level, because the
+ * builder does not know which attributes a generator will invent and should not
+ * have to.
+ */
+export declare class GeometryBuilder {
+    private readonly positions;
+    private readonly size;
+    private readonly storage;
+    private readonly vertexPoints;
+    private readonly offsets;
+    private readonly kinds;
+    private readonly closed;
+    private readonly attributes;
+    private readonly detail;
+    private readonly pointGroups;
+    private readonly primitiveGroups;
+    constructor(options?: GeometryBuilderOptions);
+    get pointCount(): number;
+    get vertexCount(): number;
+    get primitiveCount(): number;
+    /** Append one point and return its index. */
+    addPoint(x: number, y: number, z?: number): number;
+    /** Append points from a flat array of `positionSize`-wide entries. */
+    addPoints(flat: ArrayLike<number>): number;
+    /**
+     * Append one primitive over existing point indices and return its index. A
+     * closed primitive does not repeat its first point: `closed` is topology, not
+     * a duplicated vertex.
+     */
+    addPrimitive(points: readonly number[], options?: AddPrimitiveOptions): number;
+    /** Append points and one primitive over them, the common generator case. */
+    addPolygon(flat: ArrayLike<number>, options?: AddPrimitiveOptions): number;
+    setAttribute(level: ElementLevel, name: string, attribute: AnyAttribute): this;
+    setNumericAttribute(level: ElementLevel, name: string, values: ArrayLike<number>, size?: number, storage?: AttributeStorage): this;
+    setStringAttribute(level: ElementLevel, name: string, values: readonly string[]): this;
+    setDetail(name: string, value: DetailValue): this;
+    addToPointGroup(name: string, index: number): this;
+    addToPrimitiveGroup(name: string, index: number): this;
+    build(): Geometry;
+}
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/geometry/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EAGb,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;gBAEtD,OAAO,GAAE,sBAA2B;IAKhD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,6CAA6C;IAC7C,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,MAAM;IAO7C,sEAAsE;IACtE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAY1C;;;;OAIG;IACH,YAAY,CACV,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,GAAE,mBAAwB,GAChC,MAAM;IAgBT,4EAA4E;IAC5E,UAAU,CACR,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EACvB,OAAO,GAAE,mBAAwB,GAChC,MAAM;IAQT,YAAY,CACV,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,YAAY,GACtB,IAAI;IAUP,mBAAmB,CACjB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,IAAI,SAAI,EACR,OAAO,GAAE,gBAAwB,GAChC,IAAI;IAQP,kBAAkB,CAChB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,IAAI;IAIP,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAKjD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOlD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOtD,KAAK,IAAI,QAAQ;CA+BlB"}

package/dist/runtime/geometry/builder.js

@@ -0,0 +1,153 @@
+import { attributeArrayFrom, createGeometry, emptyGeometry, POSITION_ATTRIBUTE, PRIMITIVE_KINDS, } from "cascade/contracts";
+import { createStringAttribute, geometryError } from "./attributes.js";
+export { emptyGeometry };
+/**
+ * The accumulating constructor. Points and primitives go in one at a time and
+ * `build` produces the frozen struct-of-arrays form once, so a generator does
+ * not have to know the final counts up front or touch a typed array.
+ *
+ * Attributes are set after the elements exist, by name and level, because the
+ * builder does not know which attributes a generator will invent and should not
+ * have to.
+ */
+export class GeometryBuilder {
+    positions = [];
+    size;
+    storage;
+    vertexPoints = [];
+    offsets = [0];
+    kinds = [];
+    closed = [];
+    attributes = { point: {}, vertex: {}, primitive: {} };
+    detail = {};
+    pointGroups = new Map();
+    primitiveGroups = new Map();
+    constructor(options = {}) {
+        this.size = options.positionSize ?? 2;
+        this.storage = options.positionStorage ?? "f64";
+    }
+    get pointCount() {
+        return this.positions.length / this.size;
+    }
+    get vertexCount() {
+        return this.vertexPoints.length;
+    }
+    get primitiveCount() {
+        return this.offsets.length - 1;
+    }
+    /** Append one point and return its index. */
+    addPoint(x, y, z = 0) {
+        const index = this.pointCount;
+        this.positions.push(x, y);
+        if (this.size === 3)
+            this.positions.push(z);
+        return index;
+    }
+    /** Append points from a flat array of `positionSize`-wide entries. */
+    addPoints(flat) {
+        if (flat.length % this.size !== 0)
+            geometryError("point-stride", `${flat.length} values is not a multiple of the position size ${this.size}`);
+        const first = this.pointCount;
+        for (let index = 0; index < flat.length; index += 1)
+            this.positions.push(flat[index]);
+        return first;
+    }
+    /**
+     * Append one primitive over existing point indices and return its index. A
+     * closed primitive does not repeat its first point: `closed` is topology, not
+     * a duplicated vertex.
+     */
+    addPrimitive(points, options = {}) {
+        const index = this.primitiveCount;
+        for (const point of points) {
+            if (!Number.isInteger(point) || point < 0 || point >= this.pointCount)
+                geometryError("vertex-point", `primitive ${index} references point ${point} of ${this.pointCount}`);
+            this.vertexPoints.push(point);
+        }
+        this.offsets.push(this.vertexPoints.length);
+        this.kinds.push(PRIMITIVE_KINDS.indexOf(options.kind ?? "poly"));
+        this.closed.push(options.closed ? 1 : 0);
+        return index;
+    }
+    /** Append points and one primitive over them, the common generator case. */
+    addPolygon(flat, options = {}) {
+        const first = this.addPoints(flat);
+        const points = [];
+        for (let index = first; index < this.pointCount; index += 1)
+            points.push(index);
+        return this.addPrimitive(points, options);
+    }
+    setAttribute(level, name, attribute) {
+        if (level === "point" && name === POSITION_ATTRIBUTE)
+            geometryError("set-position", "point.P is owned by the builder; use addPoint");
+        this.attributes[level][name] = attribute;
+        return this;
+    }
+    setNumericAttribute(level, name, values, size = 1, storage = "f64") {
+        return this.setAttribute(level, name, {
+            storage,
+            size,
+            data: attributeArrayFrom(storage, values),
+        });
+    }
+    setStringAttribute(level, name, values) {
+        return this.setAttribute(level, name, createStringAttribute(values));
+    }
+    setDetail(name, value) {
+        this.detail[name] = value;
+        return this;
+    }
+    addToPointGroup(name, index) {
+        const members = this.pointGroups.get(name) ?? new Set();
+        members.add(index);
+        this.pointGroups.set(name, members);
+        return this;
+    }
+    addToPrimitiveGroup(name, index) {
+        const members = this.primitiveGroups.get(name) ?? new Set();
+        members.add(index);
+        this.primitiveGroups.set(name, members);
+        return this;
+    }
+    build() {
+        const pointCount = this.pointCount;
+        const pointGroups = {};
+        for (const [name, members] of this.pointGroups)
+            pointGroups[name] = mask(members, pointCount);
+        const primitiveGroups = {};
+        for (const [name, members] of this.primitiveGroups)
+            primitiveGroups[name] = mask(members, this.primitiveCount);
+        return createGeometry({
+            pointCount,
+            point: {
+                ...this.attributes.point,
+                [POSITION_ATTRIBUTE]: {
+                    storage: this.storage,
+                    size: this.size,
+                    data: attributeArrayFrom(this.storage, this.positions),
+                },
+            },
+            vertex: this.attributes.vertex,
+            primitive: this.attributes.primitive,
+            detail: this.detail,
+            topology: {
+                vertexPoints: Int32Array.from(this.vertexPoints),
+                offsets: Int32Array.from(this.offsets),
+                kinds: Uint8Array.from(this.kinds),
+                closed: Uint8Array.from(this.closed),
+            },
+            pointGroups,
+            primitiveGroups,
+        });
+    }
+}
+function mask(members, count) {
+    const result = new Uint8Array(count);
+    for (const member of members) {
+        if (!Number.isInteger(member) || member < 0 || member >= count)
+            geometryError("group-indices", `group references element ${member}`);
+        result[member] = 1;
+    }
+    return result;
+}
+//# sourceMappingURL=builder.js.map

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

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

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

@@ -0,0 +1,36 @@
+import { type Geometry } from "cascade/contracts";
+/**
+ * Copy to Points: one geometry instanced onto every point of another.
+ *
+ * This is the node a generative composition actually comes from, and it is the
+ * second half of the argument for a generic attribute table. It is written
+ * entirely as transform-then-merge over the existing operations, which is the
+ * point: it invents no attribute handling of its own, so it composes with any
+ * attribute a later node invents and cannot drop one it has never heard of.
+ * Because a cubic Bézier is affine-invariant, it is also exactly right on a
+ * curve without knowing that a curve is what it is copying.
+ *
+ * Houdini's conventions, followed rather than reinvented: `pscale` scales each
+ * copy, `N` orients it, and the copies carry a `copynum` primitive attribute
+ * recording which target point they came from.
+ */
+export interface CopyToPointsOptions {
+    /** Restrict to a target point group. Houdini's "Target Group". */
+    readonly targetGroup?: string;
+    /**
+     * Read `pscale` and `N` from the target points. Houdini's "Transform Using
+     * Target Point Orientations", and the reason `N` is a direction rather than
+     * an angle: it is the attribute a Scatter or a Resample already writes.
+     */
+    readonly useTargetOrientations?: boolean;
+    /**
+     * Carry the target's point attributes onto the points of each copy, where the
+     * source does not already carry a name of its own. Source wins on a
+     * collision, because the copy's own values describe the copy.
+     */
+    readonly transferTargetAttributes?: boolean;
+    /** Primitive attribute recording the target point index; "" disables it. */
+    readonly copyNumberAttribute?: string;
+}
+export declare function copyToPoints(source: Geometry, target: Geometry, options?: CopyToPointsOptions): Geometry;
+//# sourceMappingURL=copy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/geometry/copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAmB5B;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,OAAO,GAAE,mBAAwB,GAChC,QAAQ,CAuEV"}

package/dist/runtime/geometry/copy.js

@@ -0,0 +1,68 @@
+import { emptyGeometry, isStringAttribute, POSITION_ATTRIBUTE, } from "cascade/contracts";
+import { createAttribute, createStringAttribute, geometryError, getPosition, numericAttribute, positionSize, readComponent, readElement, readString, setAttribute, } from "./attributes.js";
+import { groupIndices, groupMask } from "./groups.js";
+import { transformMatrix } from "./matrix.js";
+import { mergeGeometries } from "./merge.js";
+import { transformGeometry } from "./transform.js";
+export function copyToPoints(source, target, options = {}) {
+    const width = positionSize(source) === 3 ? 3 : 2;
+    const selection = options.targetGroup === undefined || options.targetGroup === ""
+        ? undefined
+        : (groupMask(target, "point", options.targetGroup) ??
+            geometryError("missing-group", `point group ${options.targetGroup} is not present on the target`));
+    const indices = selection === undefined
+        ? range(target.pointCount)
+        : groupIndices(selection);
+    if (indices.length === 0 || source.pointCount === 0)
+        return emptyGeometry(width);
+    const orient = options.useTargetOrientations ?? true;
+    const pscale = orient
+        ? numericAttribute(target.point.pscale, "point.pscale", [1])
+        : undefined;
+    const normal = orient
+        ? numericAttribute(target.point.N, "point.N", [2, 3])
+        : undefined;
+    const copyNumber = options.copyNumberAttribute ?? "copynum";
+    const transfer = (options.transferTargetAttributes ?? true)
+        ? Object.keys(target.point).filter((name) => name !== POSITION_ATTRIBUTE &&
+            !Object.prototype.hasOwnProperty.call(source.point, name))
+        : [];
+    const copies = [];
+    for (const index of indices) {
+        const position = getPosition(target, index);
+        const scale = pscale === undefined ? 1 : readComponent(pscale, index);
+        const rotate = normal === undefined
+            ? 0
+            : (Math.atan2(readComponent(normal, index, 1), readComponent(normal, index, 0)) *
+                180) /
+                Math.PI;
+        let copy = transformGeometry(source, transformMatrix({
+            translate: [position[0], position[1]],
+            rotate,
+            scale: [scale, scale],
+        }));
+        if (copyNumber !== "")
+            copy = setAttribute(copy, "primitive", copyNumber, {
+                storage: "i32",
+                size: 1,
+                data: new Int32Array(copy.primitiveCount).fill(index),
+            });
+        for (const name of transfer)
+            copy = setAttribute(copy, "point", name, spread(target.point[name], index, copy.pointCount));
+        copies.push(copy);
+    }
+    return mergeGeometries(copies);
+}
+function range(count) {
+    const indices = new Array(count);
+    for (let index = 0; index < count; index += 1)
+        indices[index] = index;
+    return indices;
+}
+/** One element of a target attribute, repeated across a copy's points. */
+function spread(attribute, index, count) {
+    if (isStringAttribute(attribute))
+        return createStringAttribute(new Array(count).fill(readString(attribute, index)));
+    return createAttribute(count, attribute.size, attribute.storage, readElement(attribute, index));
+}
+//# sourceMappingURL=copy.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { Geometry } from "cascade/contracts";
+/**
+ * The generators. Each returns one primitive in a geometry of its own, so a
+ * graph composes them with `Merge` rather than with a multi-shape node.
+ *
+ * Geometry is +Y up, so a circle of radius 1 has a point at `(0, 1)` above the
+ * origin and a rectangle's first corner is its bottom-left one. The flip into
+ * SVG's frame lives in `geometryToSvg` and nowhere else.
+ */
+export interface RectangleOptions {
+    /** Width and height, as Houdini's Grid states its size. */
+    readonly size?: readonly [number, number];
+    readonly center?: readonly [number, number];
+}
+/**
+ * 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 declare function rectangleGeometry(options?: RectangleOptions): Geometry;
+export interface CircleOptions {
+    readonly center?: readonly [number, number];
+    /** X and Y radius, as Houdini's Circle states its radius. */
+    readonly radius?: readonly [number, number];
+    /**
+     * Houdini's Circle "Primitive Type". `bezier` is the default because a circle
+     * is a circle: four cubic segments hold it to within 0.02% of the true arc,
+     * where a polygon of any division count is visibly a polygon in print.
+     */
+    readonly type?: "bezier" | "poly";
+    /** Houdini's Circle "Divisions". Used by `poly` only. */
+    readonly divisions?: number;
+}
+/**
+ * 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 declare function circleGeometry(options?: CircleOptions): Geometry;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/geometry/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAKnD;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAOD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,gBAAqB,GAAG,QAAQ,CAc1E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,QAAQ,CA2CpE"}