@snaptrude/plugin-core 0.0.0-dev-20260911064951 → 0.0.0-surfaces-20260921090636

package/dist/massParameters.d.ts

@@ -0,0 +1,280 @@
+import * as z from "zod";
+import { OperationRecord, ParameterPatchValue } from "./massParameters.ops";
+export * from "./massParameters.ops";
+/**
+ * Mass **creation-parameter records** — the recipe a parametric mass was built
+ * from, shared verbatim by plugin-core, the Snaptrude host, and the agent
+ * runtime (one schema, three repos — no hand-mirrored DTOs).
+ *
+ * A record is present on a mass committed from a `core.geom.create` brep
+ * constructor that carries a recipe (the four primitives, extrusion,
+ * revolution, loft, sweep). A fillet, chamfer, shell or offset of a **recorded**
+ * solid keeps the record: `kind` stays the base constructor and the step is
+ * appended to the record's `operations` list (see {@linkcode OperationRecord}).
+ * The record is absent — `null` — for everything
+ * else: drawn masses, imported geometry, booleans, split parts,
+ * `brepFromFaces`/`brepFromMesh`, and any operation on a solid that carried no
+ * record. Geometry there is not a pure function of a legible parameter set, and
+ * a record must never be a lie.
+ *
+ * Read one with `design.query.getParameters`.
+ *
+ * Everything here is **pure JSON** by construction — plain objects, numbers and
+ * arrays only, one `{x, y, z}` point shape everywhere (no tuples, no class
+ * instances): records are persisted by enumerable-field reflection, cloned with
+ * `structuredClone`, and round-tripped through the collaboration wire.
+ */
+/** A point in space. The single point shape used across every record. */
+export type XYZ = {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * One boundary curve of a profile record.
+ *
+ * The two spline forms are either/or, never both: a curve authored through
+ * points carries `splineThrough` (patch the points and the fit re-runs), and a
+ * curve with no through-point provenance — read back off an edge, or authored
+ * from control vertices — carries `splinePoles` and is re-minted verbatim.
+ * There is no variant holding both, so a `throughPoints` edit can never leave
+ * stale poles behind.
+ */
+export type CurveRecord = {
+    type: "line";
+    start: XYZ;
+    end: XYZ;
+} | {
+    type: "arc";
+    start: XYZ;
+    end: XYZ;
+    centre: XYZ;
+    axis: XYZ;
+} | {
+    type: "circle";
+    centre: XYZ;
+    axis: XYZ;
+    radius: number;
+}
+/** Authored via splineFromPoints / profileFromSplinePoints. The through-points
+ *  ARE the recipe; regeneration re-runs the versioned fit (fitVersion).
+ *  Chained runs in one contour re-fit as ONE loop; use splinePoles to keep tangents. */
+ | {
+    type: "splineThrough";
+    fitVersion: 1;
+    throughPoints: XYZ[];
+}
+/** No through-point provenance (authored from CVs, or read back off an edge).
+ *  Regenerable verbatim — re-mint the curve from these exact data. */
+ | {
+    type: "splinePoles";
+    degree: number;
+    knots: number[];
+    mults: number[];
+    poles: XYZ[];
+};
+/** A closed boundary loop, as an ordered list of curves. */
+export type ProfileRecord = {
+    curves: CurveRecord[];
+};
+/** An outer loop plus its holes — the cross-section shape of a recipe. */
+export type ContourRecord = {
+    outer: ProfileRecord;
+    holes: ProfileRecord[];
+};
+/** Optional loft behaviour switches, mirroring `core.geom.create.brepFromLoft`. */
+export type LoftOptions = {
+    compatibility?: "strict" | "auto";
+    seamAlignment?: "authored" | "auto";
+    /** `"ruled"` (default) keeps the straight-sided lane: every pair of sections
+     *  joined by flat sides. `"smooth"` lofts every section in ONE pass, so the
+     *  sides curve continuously through the intermediates. */
+    smoothing?: "ruled" | "smooth";
+};
+/**
+ * How a swept profile turns along its path, mirroring
+ * `core.geom.create.brepFromSweepAlongCurve`. `"upright"` keeps the profile's up
+ * aligned with world up, `"frenet"` lets it roll with the path's curvature, and
+ * `"fixed"` carries the authored frame along unchanged.
+ */
+export type SweepOrientation = "frenet" | "fixed" | "upright";
+/** Optional sweep-along-a-curve switches. Pure JSON: the creator's own bag also
+ *  takes a `rail` curve, which is a live handle and never reaches a record. */
+export type SweepAlongCurveRecordOptions = {
+    orientation?: SweepOrientation;
+};
+/** Optional sweep scale law and corner transition, mirroring `core.geom.create.brepFromSweep`. */
+export type SweepOptions = {
+    startScale?: number;
+    endScale?: number;
+    scales?: number[];
+    transition?: "miter" | "round" | {
+        bevel: number;
+    };
+};
+/** A face's surface kind — the vocabulary of `core.geom.query.face.getSurfaceKind`. */
+export type SurfaceKind = "plane" | "cylinder" | "cone" | "sphere" | "torus" | "spline";
+/** An edge's curve kind. Both spline forms of {@linkcode CurveRecord} report `"spline"`. */
+export type CurveKind = "line" | "arc" | "circle" | "spline";
+/**
+ * A mass's creation recipe: the constructor `kind`, a schema `version`, the
+ * `values` that constructor was called with, and the kernel `operations`
+ * (fillet / chamfer / shell / offset) applied on top, in order. Points and axes
+ * are in the mass's own local frame when stored; `design.query.getParameters`
+ * returns them in world coordinates. `operations` is frame-free. One variant
+ * per constructor `kind`; its `values` are that constructor's own arguments.
+ *
+ * `kind` stays the base constructor even after operations: a shelled, filleted
+ * sphere is still `{ kind: "sphere", operations: [shell, fillet] }`.
+ */
+export type MassParametersRecord = {
+    kind: "sphere";
+    version: 1;
+    values: {
+        centre: XYZ;
+        radius: number;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "cylinder";
+    version: 1;
+    values: {
+        base: XYZ;
+        axis: XYZ;
+        radius: number;
+        height: number;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "cone";
+    version: 1;
+    values: {
+        base: XYZ;
+        axis: XYZ;
+        baseRadius: number;
+        topRadius: number;
+        height: number;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "torus";
+    version: 1;
+    values: {
+        centre: XYZ;
+        axis: XYZ;
+        majorRadius: number;
+        minorRadius: number;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "extrusion";
+    version: 1;
+    values: {
+        contour: ContourRecord;
+        direction: XYZ;
+        amount: number;
+        /** Total rotation base → top about `direction`, through the base
+         *  contour's centroid, in DEGREES — an angle, never converted. Absent
+         *  or 0 is a straight extrusion. */
+        twistInDegrees?: number;
+        /** Top outline scale about the same axis, a ratio — never converted.
+         *  Absent or 1 is a straight extrusion. */
+        topScale?: number;
+        /** How many sections the twist/taper was built from, a count (2..64).
+         *  Resolved and stamped at create time, so an existing mass regenerates
+         *  from the record and never from a heuristic that may change. Absent
+         *  exactly when the mass is neither twisted nor tapered. */
+        levels?: number;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "revolution";
+    version: 1;
+    values: {
+        contour: ContourRecord;
+        axisOrigin: XYZ;
+        axisDirection: XYZ;
+        angleInDegrees: number;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "loft";
+    version: 1;
+    values: {
+        sections: ContourRecord[];
+        options?: LoftOptions;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "sweep";
+    version: 1;
+    values: {
+        profile: ContourRecord;
+        path: XYZ[];
+        options?: SweepOptions;
+    };
+    operations?: OperationRecord[];
+} | {
+    kind: "sweepAlongCurve";
+    version: 1;
+    values: {
+        profile: ContourRecord;
+        path: CurveRecord[];
+        options?: SweepAlongCurveRecordOptions;
+    };
+    operations?: OperationRecord[];
+};
+/**
+ * The argument of `design.update.parameters`: either a **partial** of a
+ * record's `values` (plus an optional `operations` list) — keys you leave out
+ * stay as they are — or the **whole record** you read from
+ * `design.query.getParameters`, edited. `kind` and `version` are immutable.
+ */
+export type MassParametersPatch = MassParametersRecord | Record<string, ParameterPatchValue>;
+/** Maximum through-points in one authored spline curve record. */
+export declare const MAX_SPLINE_THROUGH_POINTS = 256;
+/** Maximum control points in one exact-NURBS spline curve record. */
+export declare const MAX_SPLINE_POLES = 512;
+/** Maximum path points in a sweep record. */
+export declare const MAX_SWEEP_PATH_POINTS = 512;
+/** Maximum path curves in a sweep-along-a-curve record. */
+export declare const MAX_PATH_CURVES = 64;
+/** Maximum cross-sections in a loft record. */
+export declare const MAX_LOFT_SECTIONS = 32;
+/** Maximum sections a twisted or tapered extrusion record is built from. */
+export declare const MAX_TWIST_LEVELS = 64;
+/** Maximum boundary curves in one profile loop record. */
+export declare const MAX_PROFILE_CURVES = 256;
+/** Maximum hole loops in one contour record. */
+export declare const MAX_CONTOUR_HOLES = 64;
+/** A point in space — `{ x, y, z }`, all finite. */
+export declare const XYZ: z.ZodType<XYZ, XYZ>;
+/** One boundary curve of a profile record. See {@linkcode CurveRecord}. */
+export declare const CurveRecord: z.ZodType<CurveRecord, CurveRecord>;
+/** A closed boundary loop. See {@linkcode ProfileRecord}. */
+export declare const ProfileRecord: z.ZodType<ProfileRecord, ProfileRecord>;
+/** An outer loop plus its holes. See {@linkcode ContourRecord}. */
+export declare const ContourRecord: z.ZodType<ContourRecord, ContourRecord>;
+/** Optional loft behaviour switches. See {@linkcode LoftOptions}. */
+export declare const LoftOptions: z.ZodType<LoftOptions, LoftOptions>;
+/** See {@linkcode SweepAlongCurveRecordOptions}. */
+export declare const SweepAlongCurveRecordOptions: z.ZodType<SweepAlongCurveRecordOptions, SweepAlongCurveRecordOptions>;
+/** Optional sweep scale law and corner transition. See {@linkcode SweepOptions}. */
+export declare const SweepOptions: z.ZodType<SweepOptions, SweepOptions>;
+/**
+ * A mass's creation recipe. See {@linkcode MassParametersRecord}.
+ *
+ * `version` is a literal `1`: a restore that reads an unknown version fails
+ * `safeParse` and the mass degrades to non-parametric — editability is lost,
+ * geometry never is, and load is never blocked. Future versions add a migration
+ * at the restore site.
+ */
+export declare const MassParametersRecord: z.ZodType<MassParametersRecord, MassParametersRecord>;
+/**
+ * The argument of `design.update.parameters`. See {@linkcode MassParametersPatch}.
+ * The full-record form is recognised by carrying both `kind` and `values`;
+ * which keys a kind actually has is checked host-side, where the error can name
+ * them.
+ */
+export declare const MassParametersPatch: z.ZodType<MassParametersPatch, MassParametersPatch>;
+//# sourceMappingURL=massParameters.d.ts.map

package/dist/massParameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"massParameters.d.ts","sourceRoot":"","sources":["../src/massParameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAkB,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAK3F,cAAc,sBAAsB,CAAA;AAEpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,yEAAyE;AACzE,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC5D;;wFAEwF;GACtF;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,CAAC,CAAC;IAAC,aAAa,EAAE,GAAG,EAAE,CAAA;CAAE;AAChE;sEACsE;GACpE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,GAAG,EAAE,CAAA;CAAE,CAAA;AAE3F,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAErD,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAE5E,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IACjC,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IACnC;;8DAE0D;IAC1D,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC/B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AAE7D;+EAC+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG;IAAE,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAA;AAE7E,kGAAkG;AAClG,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACnD,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEvF,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACvF,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5E,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QACN,OAAO,EAAE,aAAa,CAAA;QACtB,SAAS,EAAE,GAAG,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd;;4CAEoC;QACpC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB;mDAC2C;QAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB;;;oEAG4D;QAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QACN,OAAO,EAAE,aAAa,CAAA;QACtB,UAAU,EAAE,GAAG,CAAA;QACf,aAAa,EAAE,GAAG,CAAA;QAClB,cAAc,EAAE,MAAM,CAAA;KACvB,CAAA;IACD,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE,CAAA;IAC5D,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE,CAAA;IACvE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE;QACN,OAAO,EAAE,aAAa,CAAA;QACtB,IAAI,EAAE,WAAW,EAAE,CAAA;QACnB,OAAO,CAAC,EAAE,4BAA4B,CAAA;KACvC,CAAA;IACD,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B,CAAA;AAEL;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;AAU5F,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAC5C,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,MAAM,CAAA;AACxC,2DAA2D;AAC3D,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,KAAK,CAAA;AACnC,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,oDAAoD;AACpD,eAAO,MAAM,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAIlC,CAAA;AAEF,2EAA2E;AAC3E,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAqB1D,CAAA;AAEF,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAEhE,CAAA;AAEF,mEAAmE;AACnE,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAGhE,CAAA;AAEF,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAI1D,CAAA;AAEF,oDAAoD;AACpD,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAClD,4BAA4B,EAC5B,4BAA4B,CAG5B,CAAA;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAW7D,CAAA;AAWF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,oBAAoB,CA8FrF,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,mBAAmB,CAGlF,CAAA"}

package/dist/massParameters.ops.d.ts

@@ -0,0 +1,135 @@
+import * as z from "zod";
+import { ContourRecord, CurveRecord, LoftOptions, SweepAlongCurveRecordOptions, SweepOptions, XYZ } from "./massParameters";
+import type { CurveKind, SurfaceKind } from "./massParameters";
+/**
+ * The **operation half** of a mass creation-parameter record: which edge or
+ * face of the recipe's solid a kernel step used, the step itself, and the
+ * values a `design.update.parameters` patch may carry.
+ *
+ * Split out of `massParameters.ts` — same contract, same repos, one module each
+ * so either can be read whole — and re-exported from it and from the package
+ * root, so every import path keeps working.
+ *
+ * Everything here is **pure JSON** by construction, exactly as in
+ * {@linkcode MassParametersRecord}: plain objects, numbers and arrays only, one
+ * `{x, y, z}` point shape, no class instances.
+ */
+/** Maximum kernel operations chained onto one recipe. */
+export declare const MAX_OPERATIONS = 8;
+/** Maximum edges one fillet/chamfer operation may select. */
+export declare const MAX_OPERATION_EDGES = 64;
+/** Maximum faces one shell operation may open. */
+export declare const MAX_OPERATION_FACES = 32;
+/** Maximum rows in a variable-fillet radius law. */
+export declare const MAX_FILLET_LAW_SAMPLES = 32;
+/**
+ * Which EDGE of the input solid an operation used: its index in
+ * `core.geom.query.brep.listEdges` order at authoring time, the indices of the
+ * two faces it lies between, and its curve kind. This is topology, not
+ * coordinates — it survives a scalar edit of the base recipe (which moves every
+ * edge) and trips on a reorder or a topology change. Read-only: to blend a
+ * different edge, re-select it on the new shape and re-apply the operation.
+ */
+export type EdgeSelector = {
+    index: number;
+    faces: [number, number];
+    curve: CurveKind;
+    /** Where the edge sits INSIDE its solid: its midpoint in the record's own
+     *  frame, divided by the solid's bounding-box extent — a ratio per axis,
+     *  never a length, so it survives a scalar edit that scales the whole shape.
+     *  Written only when the discriminators above cannot tell two edges apart. A
+     *  tiebreak, never a coordinate fingerprint: a replay checks it within 0.02 of
+     *  the solid's own box and refuses on a miss — it never searches for a better
+     *  candidate. */
+    at?: XYZ;
+};
+/**
+ * Which FACE of the input solid an operation used: its index in
+ * `core.geom.query.brep.listFaces` order, its surface kind, and the number of
+ * edges in its outer loop. Read-only, like {@linkcode EdgeSelector}.
+ */
+export type FaceSelector = {
+    index: number;
+    kind: SurfaceKind;
+    edgeCount: number;
+    /** The face's centroid under the same normalisation and the same tiebreak
+     *  rule as {@linkcode EdgeSelector}'s `at` — written only where the
+     *  discriminators above cannot separate two faces, which on a freeform solid
+     *  (every face answers `"spline"`) is the common case. */
+    at?: XYZ;
+};
+/** The input solid's topology at authoring time — the counts a replay checks first. */
+export type TopologyCounts = {
+    faceCount: number;
+    edgeCount: number;
+};
+/**
+ * One kernel operation applied to the base recipe's solid, in order. `input`
+ * pins the topology the operation was authored against, so a base edit that
+ * changes the topology is refused rather than mis-applied.
+ *
+ * Edit one by patching the whole list back:
+ * `design.update.parameters(mass, { operations })`.
+ */
+export type OperationRecord = {
+    op: "fillet";
+    edges: EdgeSelector[];
+    radius: number;
+    /** Radius at the far end of the blend contour, internal length units — a
+     *  linear variable blend from `radius`. One edge, and never with `radii`. */
+    endRadius?: number;
+    /** The blend's radius law instead: `position` is normalised arc length
+     *  along the blend contour (a ratio 0..1, never converted), `radius` is
+     *  internal length units. 2..32 rows, strictly increasing `position`.
+     *  One edge, and never with `endRadius`. */
+    radii?: {
+        position: number;
+        radius: number;
+    }[];
+    input: TopologyCounts;
+} | {
+    op: "chamfer";
+    edges: EdgeSelector[];
+    distance: number;
+    input: TopologyCounts;
+} | {
+    op: "shell";
+    openFaces: FaceSelector[];
+    thickness: number;
+    input: TopologyCounts;
+} | {
+    op: "offset";
+    distance: number;
+    input: TopologyCounts;
+};
+/**
+ * One value of a `MassParametersPatch` — whatever a record's `values` key (or
+ * `operations`) may hold. Scalars and points merge by key; every array form
+ * replaces the list whole.
+ */
+export type ParameterPatchValue = number | XYZ | XYZ[] | ContourRecord | ContourRecord[] | CurveRecord[] | LoftOptions | SweepOptions | SweepAlongCurveRecordOptions | OperationRecord[];
+/** See {@linkcode EdgeSelector}. */
+export declare const EdgeSelector: z.ZodType<EdgeSelector, EdgeSelector>;
+/** See {@linkcode FaceSelector}. */
+export declare const FaceSelector: z.ZodType<FaceSelector, FaceSelector>;
+/** See {@linkcode TopologyCounts}. */
+export declare const TopologyCounts: z.ZodType<TopologyCounts, TopologyCounts>;
+/**
+ * See {@linkcode OperationRecord}.
+ *
+ * A variable fillet — `endRadius` or `radii` — names ONE edge: the law is a
+ * property of the blend contour that edge belongs to, and `position` is measured
+ * from that edge's start, so a second edge would have no origin. The two forms
+ * are mutually exclusive and `radii` rows run strictly forward.
+ */
+export declare const OperationRecord: z.ZodType<OperationRecord, OperationRecord>;
+/**
+ * One value of a parameter patch. See {@linkcode ParameterPatchValue}.
+ *
+ * Deliberately a CLOSED union of the shapes a record's `values` actually hold —
+ * no `z.unknown()`, nothing recursive: an unrecognised value is a VALIDATION at
+ * the wire, not a silent write of nonsense onto a mass. It only ever widens, so
+ * every value it accepted before it still accepts.
+ */
+export declare const ParameterPatchValue: z.ZodType<ParameterPatchValue, ParameterPatchValue>;
+//# sourceMappingURL=massParameters.ops.d.ts.map

package/dist/massParameters.ops.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snaptrude/plugin-core",
-  "version": "0.0.0-dev-20260911064951",
+  "version": "0.0.0-surfaces-20260921090636",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",