@metamesh/generator-sdk 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @metamesh/generator-sdk
 
+## 0.10.0
+
+### Minor Changes
+
+- 0eea1b4: Add one optional static `ui.hint` string per parameter with strict metadata validation. Short, essential instructions appear inline; descriptions provide supplementary help from the question-mark button. Control visibility remains conditional. Hints are part of the format 3/runtime 3 baseline.
+- 9d7052c: Separate parameter values from local UI metadata, add strict parameter-document diagnostics and a generated JSON Schema, and rename the side-profile and contour APIs. Generator packages and modules now require format 3 and runtime 3.0.0.
+- cf597bd: Add optional `ui.row` metadata for two adjacent number inputs, choice dropdowns, or text controls within a parameter group. Shared rows are part of the format 3/runtime 3 baseline.
+
+## 0.9.0
+
+### Minor Changes
+
+- e405876: Add a bounded closed XY cross-section parameter with immutable values, strict validation,
+  normalization, presets, and runtime compatibility checks. Add `sampleCrossSection` for physical
+  curve sampling and validated closed-loop geometry. Existing side-profile values remain compatible.
+
 ## 0.8.0
 
 ### Minor Changes

package/README.md

@@ -1,43 +1,30 @@
 # `@metamesh/generator-sdk`
 
-Runtime-neutral contracts and helpers for Generators, hosts, and workers.
+Turn a parametric model into a MetaMesh Generator. Define its controls once, infer parameter
+types, and use the same validation contract for forms, saved values, and execution.
 
 > **Preview:** `0.x` minor releases may break compatibility. Patches remain compatible within the
 > same minor line. Stable support requires an explicit `1.0.0` review.
 
-Install a published release from npm:
-
 ```bash
 pnpm add @metamesh/generator-sdk
 ```
 
-The root provides lightweight authoring contracts and helpers with explicit TypeScript interfaces.
-It has no Zod, modeling, renderer, browser, or Worker dependencies.
-Use the supported subpaths for host responsibilities:
-
-| Entry         | Responsibility                                                                  |
-| ------------- | ------------------------------------------------------------------------------- |
-| Root          | Definitions, presets, preparation/module authoring, parameter and service types |
-| `/parameters` | Defaults, normalization, strict codecs, schema issues                           |
-| `/runtime`    | Evaluated module parsing, execution, mesh DTO parsing, Worker envelopes         |
-| `/packages`   | Package, catalog and installation trust parsing                                 |
-| `/fonts`      | Standalone font selection contract                                              |
-
-Definitions remain callback-free and serializable. Preparation/build state is local to execution;
-Studio owns persistence and the Modeling engine owns modeling and manufacturing finalization.
+| Import        | Use it for                                                 |
+| ------------- | ---------------------------------------------------------- |
+| Package root  | Definitions, presets, and preparation/module authoring     |
+| `/parameters` | Defaults, recovering saved values, and strict codecs       |
+| `/runtime`    | Module execution, generated mesh data, and Worker messages |
+| `/packages`   | Package, catalog, and installation parsing                 |
+| `/fonts`      | Font selection values                                      |
 
-## Parameter definitions
+## Define controls
 
-Parameters use a `type` discriminant: `number`, `slider`, `boolean`, `select`, `choice-set`, `color`,
-`text`, `font`, `svg`, `profile`, or homogeneous `array`. Sliders require `min`, `max`, and `step`;
-numbers may omit them. Visibility uses serializable `ConditionExpression` values with `all`, `any`,
-`not`, equality/inequality, numeric comparisons, and choice-set membership (`contains`).
-
-Define controls once, then normalize saved values or strictly parse boundary values:
+A definition is serializable metadata. Capture its literal IDs and options to derive exact
+parameter types:
 
 ```ts
 import { defineGenerator, type GeneratorParams } from "@metamesh/generator-sdk";
-import { createParamCodec, prepareParameters } from "@metamesh/generator-sdk/parameters";
 
 const definition = defineGenerator({
   id: "sleeve",
@@ -50,192 +37,28 @@ const definition = defineGenerator({
   ],
 });
 type Parameters = GeneratorParams<typeof definition>;
-
-const persistedValues: Readonly<Record<string, unknown>> = { outerDiameter: 24 };
-const { parameters, validation } = prepareParameters(definition, persistedValues);
-const workerValues: unknown = { outerDiameter: 24, boreDiameter: 10 };
-const strictParameters = createParamCodec(definition).parse(workerValues);
-```
-
-Normalization drops unknown keys, restores missing or invalid values from declared defaults,
-clamps numbers, and returns a fresh frozen map. Strict codecs reject missing, unknown, invalid, or
-noncanonical values and return cloned frozen structured values. `prepareParameters()` normalizes
-once and returns the map with schema issues. Execution aggregates Generator preparation issues
-separately. Definitions accept only
-canonical types. SVG values are strings limited to 256 KiB each and 512 KiB per normalized Project.
-The same byte limits apply to defaults and presets. Definition parsing rejects defaults that exceed
-the aggregate Project budget; preset parsing uses each declared control's limits, so an SVG value
-may exceed the separate 64 Ki-character text limit.
-
-```ts
-import { EMPTY_SVG_PARAMETER_DEFAULT } from "@metamesh/generator-sdk/parameters";
-
-const profile = {
-  id: "profile",
-  label: "Profile",
-  type: "svg",
-  default: EMPTY_SVG_PARAMETER_DEFAULT,
-} as const;
-```
-
-### Choice sets and arrays
-
-Choice sets have uniquely valued options and a default selection array. `minSelections` and
-`maxSelections` optionally bound its size. Normalization orders valid selections by option
-declaration; duplicate or invalid selections recover to the canonical default. `{ param: "outputs", contains: "nut" }`
-must reference a choice set and one of its declared options.
-
-Array definitions declare `items.type` as `number` or `string`. They may constrain `minItems` and
-`maxItems`; number items may also declare `min`, `max`, `step`, and `unit`. Array-valued controls are
-cloned at normalization and persistence boundaries. Conditions may compare scalar controls or test
-`choice-set` membership; arbitrary arrays cannot be condition operands.
-
-```ts
-const points = {
-  id: "points",
-  label: "Point sizes",
-  type: "array",
-  default: [4, 8],
-  minItems: 1,
-  items: { type: "number", min: 0, unit: "mm" },
-} as const;
-```
-
-Groups are ordered sections with stable IDs, user-facing labels, optional descriptions, and an
-optional `collapsed` default. Parameters without a group render in Studio's General section.
-
-### Fonts and text
-
-Font parameters use a `FontSelection` default with immutable `faceId`, SHA-256 `revision`, and
-integer `weight`. Structural validation does not require the font to be available locally. Valid
-unavailable references survive codecs, presets, and persistence. Studio prepares declared fonts before the Generator's `prepare(parameters, services)` callback.
-`services.text.layout(text, { font, fontSize })` returns exact vector paths and measurements in
-millimetres. Keep that layout in the preparation value when checks and construction both need it.
-Imported `textSection(layout)` consumes it during build. No ambient font provider is bound.
-
-Text layout can use `baseline: { kind: "arc", radius, centerAngleDegrees, direction }` for a single circular line. Radius is in millimetres, the angle is counterclockwise from +X (default 90°), and direction defaults to clockwise. Alignment defaults to center for arcs; use clockwise at 90° for upright top text or counterclockwise at 270° for upright bottom text. Glyphs and attached marks rotate without distortion. Arc layout requires baseline vertical alignment and less than one full revolution; Generator preparation owns lettering size and face-fit checks. Packages using circular text require runtime `2.1.0` or newer.
-
-### Validation and bounds
-
-`GeneratorDefinition` is callback-free, JSON-safe metadata for forms, manifests, persistence, and
-normalization. `defineGenerator()` preserves literal IDs/options; `GeneratorParams` and
-`GeneratorIssue` derive exact parameter types and issue IDs from that definition. Use
-`definePresets(definition, presets)` to require complete definition-derived preset values.
-
-Per-field constraints belong in the definition. Cross-parameter, warning, manufacturing and geometry
-constraints belong in `prepare`, alongside the dimensions and samples that `build` will consume.
-A successful result is `{ ok: true, value, issues }`; an invalid result is `{ ok: false, issues }`.
-Successful preparation may contain warnings but no errors. Invalid preparation requires an error,
-and prevents build and native shape construction.
-
-Numeric parameters and numeric array items may declare `integer: true`. Their defaults and supplied
-bounds must be integers. Strict codecs reject fractions; saved fractions recover to the declared
-default. Numeric array recovery replaces the invalid array with its default. `step` only describes
-the control increment and does not imply integer values.
-
-Schema editors receive only the definition and never rewrite validators. Manifests remain
-callback-free. Preparation receives normalized, frozen parameters; malformed issue output is a
-runtime error. Combined validation retains at most 100 issues, prioritizing errors over warnings
-and preserving retained order. The reporting limit cannot hide a blocking error.
-
-Issues may include an optional stable `code` and `path` relative to the parameter value, such as
-`{ code: "minimum", path: [2] }` for an array item or
-`{ code: "invalid", path: ["segments", 0, "control1", "height"] }` for a profile control.
-`ParameterIssueCode` defines the supported categories: `invalid`, `missing`, `type`, `unknown`,
-`minimum`, `maximum`, `integer`, `choice`, `duplicate`, `length`, `bytes`, and `structure`.
-Schema validation supplies codes and nested locations; strict decoder paths start with the
-parameter ID. Authored issues retain their optional metadata through preparation and transfer.
-Issue parsing clones and freezes paths, bounds them to 32 segments, accepts non-negative safe
-integer indices and non-empty field names of at most 120 characters, and never evaluates accessors.
-Both fields are optional; issues always retain their required severity and message.
-
-Use `getDefaultParameters(definition)` for a fresh frozen defaults map. IDs are bounded safe keys.
-Package manifests, definitions, descriptors, conditions, and nested parameter objects reject unknown fields.
-Definitions are bounded to 64 groups and 256 parameters, arrays to 1,024 items, options to 512,
-presets to 256, and condition composition to 8 levels with 32 children per node.
-`validateGeneratorPresets()` from `/packages` applies the same strict metadata and list bounds as
-manifest parsing before checking complete canonical parameter maps. Testkit and bundled registries
-use that shared validator.
-
-### Editable side profiles
-
-A `profile` declares an open side outline as a versioned `ProfileValue`. Start/end anchors carry
-normalized `radius` and upward `height` coordinates, plus editing `mode` (`auto`, `smooth`, or
-`corner`). Segments are `line` or `cubic`, with cubic `control1` and `control2` points. Coordinates
-define the shape; hosts must resolve automatic tangents into those control points.
-
-```ts
-const sideProfile = {
-  id: "sideProfile",
-  label: "Side profile",
-  type: "profile",
-  radiusScale: { parameterId: "diameter", factor: 0.5 },
-  heightScale: { parameterId: "height", factor: 1 },
-  default: {
-    version: 1,
-    start: { radius: 0.4, height: 0, mode: "corner" },
-    segments: [
-      {
-        type: "cubic",
-        control1: { radius: 0.4, height: 0.35 },
-        control2: { radius: 1, height: 0.75 },
-        end: { radius: 0.6, height: 1, mode: "auto" },
-      },
-    ],
-  },
-} as const;
 ```
 
-Every coordinate is finite and lies in `[0, 1]`. The start height is `0`, the last height is `1`,
-and anchor heights increase strictly. Cubic control heights satisfy
-`start.height <= control1.height <= control2.height <= end.height`, keeping the curve upward.
-A profile has 1–31 segments. It has no SVG markup, sampled polygon, arbitrary closed paths, or
-holes; the Generator owns physical scaling, mounting features, closure, and manufacturing checks.
-
-Optional `radiusScale` and `heightScale` bindings describe physical measurements for host controls:
-each references a declared `number` or `slider` in millimetres with a positive default and explicit
-positive minimum, multiplied by a positive finite `factor`. Bindings do not transform saved profile
-values; Generators consume the same normalized outline when resolving their dimensions. Omitting
-bindings leaves the editor in normalized coordinates.
-
-`isProfileValue()` strictly checks the complete bounded shape without evaluating getters.
-`cloneProfileValue()` returns a fresh deeply frozen value, and `profileValuesEqual()` compares both
-shape and editing intent. Normalization, strict codecs, defaults, and presets clone every nested
-profile object. Invalid saved profiles recover to the declared default; strict boundaries reject
-them. Profiles cannot be condition operands. All executable packages use format `2` and runtime major `2`.
-
-### Curve resolution
-
-A `number` or `slider` may declare `role: "curve-resolution"` to identify the model's maximum
-sampled curve deviation in millimetres. Hosts may present this input in a dedicated curve fidelity
-control. It remains an ordinary Generator parameter with the same saved values, presets,
-normalization, validation, and manufacturing exports.
+For saved values, `/parameters` provides `normalizeParameters`: it drops unknown keys, restores
+missing or invalid values from defaults, and clamps numbers. At a trust boundary,
+`createParamCodec(definition)` rejects missing, unknown, invalid, or noncanonical values instead.
+Both return fresh frozen parameter maps.
 
-```ts
-const curveDeviation = {
-  id: "curveDeviation",
-  label: "Curve deviation",
-  type: "number",
-  role: "curve-resolution",
-  unit: "mm",
-  default: 0.05,
-  min: 0.01,
-  max: 0.2,
-  step: 0.005,
-} as const;
-```
+Parameter types describe saved values. Optional local `ui` metadata owns group/row membership,
+hints, visibility, editing increments, and physical editor scale bindings. Number inputs and
+sliders both use `type: "number"`; sliders declare `ui.control: "slider"`, bounds, and `ui.step`.
+Fixed choices use `choice`; geometric values use `side-profile` and `contour`.
 
-Multiple controls may have this role. Each requires `unit: "mm"`, a positive `default`, and an
-explicit positive `min`; numeric bounds and step rules still apply. Lower values request closer
-approximation through the Generator's `GeometryResolution` policy; exact counts remain available
-for matched topology. Hosts show authored labels in definition order and edit the saved parameters
-used by both preview and manufacturing. Generators determine affected curves and parts; Studio
-does not infer overrides from mesh IDs. Requests beyond complexity limits must fail explicitly.
+The `/packages` entry point validates the editable `{ groups, parameters }` document with
+`safeParseParameterDefinitionDocument`, returning structured issue paths and codes. Complete
+Generator and package parsing uses the same rules. The package also ships
+`@metamesh/generator-sdk/parameters.schema.json` for offline editor completion and structural
+validation; the SDK additionally checks references, defaults, and cross-field invariants.
 
-## Compiled module and output boundary
+## Prepare and build
 
-`defineGeneratorModule()` creates the five-field format-2 surface. Preparation resolves the model
-once; build receives that exact value. Imported modeling helpers bind to the host's synchronous build:
+With [Modeling](https://github.com/JasonKoolman/metamesh/blob/main/packages/modeling/README.md)
+installed, validate related dimensions and pass the prepared result into construction:
 
 ```ts
 import { defineGeneratorModule, definePreparation, prepared } from "@metamesh/generator-sdk";
@@ -258,83 +81,29 @@ const runtime = defineGeneratorModule({
 export const { formatVersion, generatorId, version, prepare, build } = runtime;
 ```
 
-`definePreparation(definition, callback)` infers readonly parameter values, prepared data and
-`PreparationServices<typeof definition>`. Its second callback argument retains `services.text`
-and adds `invalid(parameterId, message)` and `invalid(issue)`, with allowed IDs checked directly at
-each argument. Destructure `{ invalid }` or call `services.invalid(...)`. A warning alone cannot
-produce failed preparation.
-
-The helper returns a preparation wrapper that accepts parameters and optional host `GeneratorServices`.
-Omitting services uses `UNPREPARED_GENERATOR_SERVICES` for parameter-only probes; requesting
-text through that provider fails explicitly. Hosts pass their prepared services.
-It adds the scoped helper for each callback invocation, preserving the exact callback result and
-prepared value without traversal or freezing. The callback itself is not returned unchanged.
-`prepared(value)` remains the successful-value helper. Standalone global `invalid` accepts literal
-IDs or existing error issues; the host checks their IDs against the definition at the runtime
-boundary.
-
-The root helper has no decoder or Modeling runtime dependency. Modeling owns `ModelingContext`
-and `BuildOutput`; SDK context/output generics preserve author typing without importing them.
-Prepared values are opaque local data: the SDK does not traverse, clone, serialize or freeze them.
-Preparation must not acquire live modeling resources. Prepared values are never persisted,
-transferred to the UI, or reused between requests.
-
-Hosts import `parseGeneratorModule`, `prepareGenerator` and `executeGenerator` from `/runtime`.
-The parser requires exactly the five exports above and matching manifest identity. Evaluated
-preparation captures an opaque value in a one-use build closure; there is no raw prepared-value
-invocation lane. Callback results must be synchronous. The host checks the own-data preparation
-wrapper and bounded structured issues while leaving the value opaque.
-
-Studio's authored source surface accepts `build` and optional `prepare`. Its compiler supplies
-identity and `prepareIdentity(definition)` when preparation is omitted, then passes the resulting
-five-field module through this same parser and executor. Compiled packages always include `prepare`.
-
-`prepareGenerator` normalizes once and either returns `invalid` or a prepared result containing
-`build(context)`. Use that closure inside `engine.build()` so one engine owns modeling, mesh
-validation, limits, measurements and cleanup. `executeGenerator` accepts a context directly and
-returns abstract build output; it does not finalize geometry. Hosts preparing asynchronous services
-first may supply their `/parameters` `PreparedParameters` result as `parameterState` to reuse it.
-
-`parseGeneratedParts(parts, limits)` strictly checks the final transferable DTO. The host supplies
-its complete limits; the SDK does not own a duplicate default resource policy. Canonical parts have
-unique IDs, Float32 positions, Uint32 indices and optional six-digit colors. Normals belong to
-viewport presentation. Geometric/manufacturing validation belongs to the shared engine.
-
-Package format `1`, runtime major `1`, retired `validate/generate` module exports and extra exports
-reject explicitly. No compatibility adapter or preparation cache remains.
-
-Packages using the current modeling operations and Section overloads, `holeCutter()`, or optional
-issue `code`/`path` metadata must declare minimum runtime `2.1.0`. Package format and execution
-protocol major remain `2`. The manifest minimum must cover the host capabilities the package uses.
-
-## Worker boundary
-
-Worker requests/responses are `/runtime` contracts containing structured data and transferable
-arrays, never live modeling handles. Validation issues are normal outcomes; callback, Worker and
-exporter exceptions use error envelopes. Finalized previews carry revision identity, bounds,
-warnings and optional statistics. Manufacturing exports serialize the requested finalized revision,
-including appearance overrides, without running preparation/build again.
+Both callbacks are synchronous. Load assets beforehand; preparation computes ordinary data, and
+build runs inside the host's Modeling engine. Prepared values stay local to one execution and
+are never persisted or transferred. Studio owns persistence and Worker lifecycle; Modeling owns
+geometry, finalization, and resource cleanup.
 
-Successful generation envelopes include `sentAt`, the sender's high-resolution epoch milliseconds
-captured immediately before transfer. Hosts use `/runtime` `parseGenerationSentAt()` to reject
-missing, inherited, accessor, or nonfinite timestamps before measuring transfer latency. Worker
-clock construction and receiver timings belong to the host.
+## Documentation
 
-`ModelTimings.prepareMs` measures Generator preparation; `viewportPrepareMs` measures host viewport
-preparation. `firstDrawMs` starts when viewport preparation ends and measures elapsed time through
-every part's first draw submission, including render scheduling and buffer upload. Viewport fields
-are optional until the host records completion. First draw does not measure GPU completion.
-`totalMs` is request-to-completion elapsed time, including scheduling between stages, rather than
-the sum of stage timings. Studio reports request-to-delivery time until viewport completion.
+Read the [parameters guide](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/content/docs/develop/parameters-and-validation.mdx)
+for controls and validation, or [local authoring](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/content/docs/create/author-locally.mdx)
+for the current Generator workflow. The public documentation site is planned for `metamesh.studio/docs`.
 
-`MeshTopologyMode` is host policy rather than a Generator parameter. Both compiled and authored
-models use the same engine finalization and limits. Studio's runtime contract owns request lifecycle,
-revision retention and export recovery.
+Exact SDK contracts live with their code:
 
-## Development
+- [Parameter definitions](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/src/parameter-contracts.ts),
+  [side profiles](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/src/side-profiles.ts), and
+  [contours](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/src/contours.ts).
+- [Authoring helpers](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/src/authoring.ts),
+  [module contract](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/src/generator-module.ts), and
+  [runtime execution](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/src/execute-generator.ts).
 
-Keep this package independent of React, Zustand, Three.js, Manifold, DOM, and Web Worker APIs.
-The [workspace instructions](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/AGENTS.md) own contract review and required checks.
+For maintainers, the [package contract](https://github.com/JasonKoolman/metamesh/blob/main/docs/generator-packages.md)
+owns compatibility and trust; [workspace instructions](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/AGENTS.md)
+own contract review and required checks.
 
 ## License
 

package/dist/contours.d.ts

@@ -0,0 +1,36 @@
+import { type CurveValueProblem } from "./curve-data.js";
+/** Maximum number of straight or cubic segments in an editable closed cross section. */
+export declare const MAX_CONTOUR_SEGMENTS = 32;
+/** Normalized planar coordinates, with X rightward and Y upward, in the unit square. */
+export interface ContourPoint {
+    readonly x: number;
+    readonly y: number;
+}
+/** Editing intent accompanies the explicit curve controls; no tangent is inferred at runtime. */
+export interface ContourAnchor extends ContourPoint {
+    readonly mode: "smooth" | "corner";
+}
+export type ContourSegment = {
+    readonly type: "line";
+    readonly end: ContourAnchor;
+} | {
+    readonly type: "cubic";
+    readonly control1: ContourPoint;
+    readonly control2: ContourPoint;
+    readonly end: ContourAnchor;
+};
+/** One explicitly closed planar contour. Generators own physical scaling and topology checks. */
+export interface ContourValue {
+    readonly version: 1;
+    readonly start: ContourAnchor;
+    readonly segments: readonly ContourSegment[];
+}
+/** Internal diagnostics share the accessor-safe reader used by predicates and cloning. */
+export declare function contourValueProblem(value: unknown): CurveValueProblem | undefined;
+/** Checks portable data and explicit closure without evaluating getters or inspecting topology. */
+export declare function isContourValue(value: unknown): value is ContourValue;
+/** Returns a fresh, deeply frozen closed contour, including its editing intent. */
+export declare function cloneContourValue(value: ContourValue): ContourValue;
+/** Compares the serialized shape and editing intent rather than object identity. */
+export declare function contourValuesEqual(previous: ContourValue, next: ContourValue): boolean;
+//# sourceMappingURL=contours.d.ts.map

package/dist/contours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contours.d.ts","sourceRoot":"","sources":["../src/contours.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAC;AAEzB,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iGAAiG;AACjG,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;CAAE,GACtD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEN,iGAAiG;AACjG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AAmGD,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAMjF;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CA0BnE;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CA4BtF"}

package/dist/contours.js

@@ -0,0 +1,150 @@
+import { curveDataObject, curveSegmentCount, } from "./curve-data.js";
+/** Maximum number of straight or cubic segments in an editable closed cross section. */
+export const MAX_CONTOUR_SEGMENTS = 32;
+function point(value, anchor, path, fail) {
+    const fields = curveDataObject(value, anchor ? ["x", "y", "mode"] : ["x", "y"], path, fail);
+    if (fields === undefined)
+        return undefined;
+    for (const coordinate of ["x", "y"]) {
+        const entry = fields[coordinate];
+        if (typeof entry !== "number" || !Number.isFinite(entry))
+            return fail([...path, coordinate], "type");
+        if (entry < 0)
+            return fail([...path, coordinate], "minimum");
+        if (entry > 1)
+            return fail([...path, coordinate], "maximum");
+    }
+    const coordinates = { x: fields.x, y: fields.y };
+    if (!anchor)
+        return coordinates;
+    if (fields.mode !== "smooth" && fields.mode !== "corner")
+        return fail([...path, "mode"], "choice");
+    return { ...coordinates, mode: fields.mode };
+}
+function readContourValue(value, report) {
+    const fail = (path, code) => {
+        report?.({ path, code });
+        return undefined;
+    };
+    try {
+        const fields = curveDataObject(value, ["version", "start", "segments"], [], fail);
+        if (fields === undefined)
+            return undefined;
+        if (fields.version !== 1)
+            return fail(["version"], "invalid");
+        const start = point(fields.start, true, ["start"], fail);
+        if (start === undefined)
+            return undefined;
+        if (!Array.isArray(fields.segments))
+            return fail(["segments"], "type");
+        const segments = fields.segments;
+        const length = curveSegmentCount(segments, 2, MAX_CONTOUR_SEGMENTS, fail);
+        if (length === undefined)
+            return undefined;
+        const parsedSegments = [];
+        for (let index = 0; index < length; index += 1) {
+            const segmentPath = ["segments", index];
+            const descriptor = Object.getOwnPropertyDescriptor(segments, String(index));
+            if (descriptor === undefined || !("value" in descriptor) || !descriptor.enumerable)
+                return fail(segmentPath, "structure");
+            const segment = descriptor.value;
+            if (typeof segment !== "object" || segment === null || Array.isArray(segment))
+                return fail(segmentPath, "type");
+            const typeDescriptor = Object.getOwnPropertyDescriptor(segment, "type");
+            if (typeDescriptor === undefined)
+                return fail([...segmentPath, "type"], "missing");
+            if (!("value" in typeDescriptor))
+                return fail([...segmentPath, "type"], "structure");
+            const type = typeDescriptor.value;
+            if (type !== "line" && type !== "cubic")
+                return fail([...segmentPath, "type"], "choice");
+            const segmentFields = curveDataObject(segment, type === "line" ? ["type", "end"] : ["type", "end", "control1", "control2"], segmentPath, fail);
+            if (segmentFields === undefined)
+                return undefined;
+            if (segmentFields.type !== type)
+                return fail([...segmentPath, "type"], "invalid");
+            const end = point(segmentFields.end, true, [...segmentPath, "end"], fail);
+            if (end === undefined)
+                return undefined;
+            if (index === length - 1) {
+                for (const key of ["x", "y", "mode"]) {
+                    if (end[key] !== start[key])
+                        return fail([...segmentPath, "end", key], "invalid");
+                }
+            }
+            if (type === "cubic") {
+                const control1 = point(segmentFields.control1, false, [...segmentPath, "control1"], fail);
+                if (control1 === undefined)
+                    return undefined;
+                const control2 = point(segmentFields.control2, false, [...segmentPath, "control2"], fail);
+                if (control2 === undefined)
+                    return undefined;
+                parsedSegments.push({ type, control1, control2, end });
+            }
+            else {
+                parsedSegments.push({ type, end });
+            }
+        }
+        return { version: 1, start, segments: parsedSegments };
+    }
+    catch {
+        return fail([], "structure");
+    }
+}
+/** Internal diagnostics share the accessor-safe reader used by predicates and cloning. */
+export function contourValueProblem(value) {
+    let problem;
+    const parsed = readContourValue(value, (entry) => {
+        problem = entry;
+    });
+    return parsed === undefined ? (problem ?? { code: "structure", path: [] }) : undefined;
+}
+/** Checks portable data and explicit closure without evaluating getters or inspecting topology. */
+export function isContourValue(value) {
+    return readContourValue(value) !== undefined;
+}
+/** Returns a fresh, deeply frozen closed contour, including its editing intent. */
+export function cloneContourValue(value) {
+    const canonical = readContourValue(value);
+    if (canonical === undefined)
+        throw new TypeError("Cross section must be a bounded, normalized closed contour.");
+    const clonePoint = (entry) => Object.freeze({ x: entry.x, y: entry.y });
+    const cloneAnchor = (entry) => Object.freeze({ x: entry.x, y: entry.y, mode: entry.mode });
+    return Object.freeze({
+        version: 1,
+        start: cloneAnchor(canonical.start),
+        segments: Object.freeze(canonical.segments.map((segment) => Object.freeze(segment.type === "line"
+            ? { type: "line", end: cloneAnchor(segment.end) }
+            : {
+                type: "cubic",
+                control1: clonePoint(segment.control1),
+                control2: clonePoint(segment.control2),
+                end: cloneAnchor(segment.end),
+            }))),
+    });
+}
+/** Compares the serialized shape and editing intent rather than object identity. */
+export function contourValuesEqual(previous, next) {
+    if (Object.is(previous, next))
+        return true;
+    const previousData = readContourValue(previous);
+    const nextData = readContourValue(next);
+    if (previousData === undefined || nextData === undefined)
+        return false;
+    const pointsEqual = (left, right) => Object.is(left.x, right.x) && Object.is(left.y, right.y);
+    const anchorsEqual = (left, right) => pointsEqual(left, right) && left.mode === right.mode;
+    return (anchorsEqual(previousData.start, nextData.start) &&
+        previousData.segments.length === nextData.segments.length &&
+        previousData.segments.every((segment, index) => {
+            const other = nextData.segments[index];
+            if (other === undefined ||
+                segment.type !== other.type ||
+                !anchorsEqual(segment.end, other.end))
+                return false;
+            return (segment.type === "line" ||
+                (other.type === "cubic" &&
+                    pointsEqual(segment.control1, other.control1) &&
+                    pointsEqual(segment.control2, other.control2)));
+        }));
+}
+//# sourceMappingURL=contours.js.map

package/dist/contours.js.map

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