@metamesh/generator-sdk 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @metamesh/generator-sdk
 
+## 0.20.0
+
+### Minor Changes
+
+- fe33c89: Give modeling operations, pure geometry values, numerical kernels, and mechanical calculations distinct public entry points. Import fluent values from `/geometry`, tuple and matrix kernels from `/geometry/math`, and mechanical calculations from `/geometry/mechanical`. Remove root geometry factory re-exports and ambient `matchProfiles` and thread-preflight wrappers; pure preparation accepts explicit resolution and limits exposed by the generation context.
+
+  Bounds extrema and pattern/attachment placements return fluent values. Construct anchors with one options object, project fluent vectors onto planes, and multiply raw matrices with `multiplyTransform3(left, right)`. Remove retired exports and update the SDK, CLI, Studio authoring environment, and consumers without compatibility aliases.
+
+- 5654590: Give every public declaration exactly one import path. Shared types remain available from their owning module; consuming entries reference those types without re-exporting them. Import all export writers from `@metamesh/modeling/export`; remove the format subpaths. Import SDK font selections from `/fonts` and Generator presets from the SDK root. Remove alternate import metadata and enforce unique source and published declaration ownership without compatibility aliases.
+- 6455ccf: Support chamfered ends on twisted extrusions, measuring normal-section setbacks on the finished
+  helical walls and preserving corner and hole correspondence. Ordinary extrusions retain their
+  native fast path. Enabled twisted end treatments support chamfers; other treatments and taper
+  with ends remain unsupported.
+
+  Breaking: replace extrusion `scaleTop` with `scale` and `divisions` with positive `slices`, counting
+  longitudinal intervals. Loft `slices` also counts intervals per supplied gap. End treatments add
+  required rings to the extrusion's requested grid. Open sweep scalar and XY `scale` now taper from
+  one to the final scale by path length; station arrays retain explicit scale control. Scale in the
+  profile's local axes before twisting, and refine untwisted sweep deformation by physical resolution.
+
+  Compiled Generators require execution protocol and runtime major 13. Rebuild packages for the new
+  binding; package format 5 is unchanged.
+
+### Patch Changes
+
+- Updated dependencies [fe33c89]
+- Updated dependencies [d5dd213]
+- Updated dependencies [ae34a4f]
+- Updated dependencies [d5dd213]
+- Updated dependencies [52e4e07]
+- Updated dependencies [5654590]
+- Updated dependencies [382d312]
+- Updated dependencies [6455ccf]
+  - @metamesh/modeling@0.20.0
+
 ## 0.19.0
 
 ### Minor Changes

package/README.md

@@ -128,6 +128,9 @@ shared buffers once; it doesn't measure the local buffers transferred by a Worke
 
 ## API entry points
 
+Each public type and function has one import path. Import `FontSelection` and `isFontSelection`
+from `/fonts`, and `GeneratorPreset` from the package root.
+
 | Import                               | Responsibility                                                      |
 | ------------------------------------ | ------------------------------------------------------------------- |
 | `@metamesh/generator-sdk`            | Definitions, presets, inferred types, and module authoring.         |

package/dist/authoring.d.ts

@@ -3,11 +3,20 @@ import type { GeneratorDefinition, ParameterDefinition } from "./parameters/defi
 type DefinitionParameters<P extends readonly ParameterDefinition[]> = readonly ParameterDefinition[] | {
     readonly [Index in keyof P]: ParameterDefinition;
 };
-/** Validates metadata while preserving its identity and literal control types. Invalid definitions throw. */
+/**
+ * Validates Generator metadata while preserving literal control types; invalid definitions throw.
+ *
+ * @param definition - Serializable controls and metadata; returned unchanged after validation.
+ */
 export declare function defineGenerator<const D extends GeneratorDefinition>(definition: D & Omit<GeneratorDefinition, "parameters"> & {
     readonly parameters: DefinitionParameters<NoInfer<D["parameters"]>>;
 }): D;
-/** Validates complete, canonical preset values and metadata while preserving the supplied array and literal types. */
+/**
+ * Validates preset metadata and complete canonical values while preserving literal types.
+ *
+ * @param definition - Definition whose complete parameter map each preset must supply.
+ * @param presets - Preset values and metadata; returned without copying.
+ */
 export declare function definePresets<const D extends GeneratorDefinition, const Presets extends readonly GeneratorPreset<NoInfer<D>>[]>(definition: D, presets: Presets & readonly GeneratorPreset<NoInfer<D>>[]): Presets;
 export {};
 //# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAK5F,KAAK,oBAAoB,CAAC,CAAC,SAAS,SAAS,mBAAmB,EAAE,IAChE,SAAS,mBAAmB,EAAE,GAAG;IAAE,QAAQ,EAAE,KAAK,IAAI,MAAM,CAAC,GAAG,mBAAmB;CAAE,CAAC;AAExF,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACjE,UAAU,EAAE,CAAC,GACX,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,GAAG;IACxC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CACrE,GACF,CAAC,CAGH;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAC3B,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACnC,KAAK,CAAC,OAAO,SAAS,SAAS,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC5D,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAGnF"}
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAK5F,KAAK,oBAAoB,CAAC,CAAC,SAAS,SAAS,mBAAmB,EAAE,IAChE,SAAS,mBAAmB,EAAE,GAAG;IAAE,QAAQ,EAAE,KAAK,IAAI,MAAM,CAAC,GAAG,mBAAmB;CAAE,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACjE,UAAU,EAAE,CAAC,GACX,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,GAAG;IACxC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CACrE,GACF,CAAC,CAGH;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACnC,KAAK,CAAC,OAAO,SAAS,SAAS,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC5D,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAGnF"}

package/dist/authoring.js

@@ -1,11 +1,20 @@
 import { validateGeneratorPresets } from "./generator-package/validate-manifest.js";
 import { parseGeneratorDefinition } from "./validation/parse-definition.js";
-/** Validates metadata while preserving its identity and literal control types. Invalid definitions throw. */
+/**
+ * Validates Generator metadata while preserving literal control types; invalid definitions throw.
+ *
+ * @param definition - Serializable controls and metadata; returned unchanged after validation.
+ */
 export function defineGenerator(definition) {
     parseGeneratorDefinition(definition);
     return definition;
 }
-/** Validates complete, canonical preset values and metadata while preserving the supplied array and literal types. */
+/**
+ * Validates preset metadata and complete canonical values while preserving literal types.
+ *
+ * @param definition - Definition whose complete parameter map each preset must supply.
+ * @param presets - Preset values and metadata; returned without copying.
+ */
 export function definePresets(definition, presets) {
     validateGeneratorPresets(definition, presets);
     return presets;

package/dist/authoring.js.map

@@ -1 +1 @@
-{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAO5E,6GAA6G;AAC7G,MAAM,UAAU,eAAe,CAC7B,UAGG;IAEH,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,aAAa,CAG3B,UAAa,EAAE,OAAyD;IACxE,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAO5E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,UAGG;IAEH,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAG3B,UAAa,EAAE,OAAyD;IACxE,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/docs/guides/authoring.md

@@ -10,10 +10,10 @@ If you need a working model first, follow [Build your first code Project](https:
 ```ts
 const { width, depth, height, holeDiameter, addHole } = params;
   const body = box({ size: [width, depth, height] });
-  if (!addHole) return [part("body", body)];
+  if (!addHole) return part("body", body);
   // Two extra millimetres clear the centered body's top and bottom faces.
   const bore = cylinder({ height: height + 2, diameter: holeDiameter, sizing: "face" });
-  return [part("body", body.subtract(bore))];
+  return part("body", body.subtract(bore));
 ```
 
 A plate is a useful starting example: its controls describe the finished size and an optional hole, while the source handles construction.
@@ -103,9 +103,9 @@ Use `@metamesh/generator-sdk` to define its controls and Generator module, and
 `@metamesh/modeling` for generation. Studio's virtual `@metamesh/project` import is specific to
 Studio and can't be copied into a local Node module.
 
-Follow [local authoring](https://metamesh.studio/docs/develop/agent-authoring#generator-entries) to check and run the
+Follow [local authoring](https://metamesh.studio/docs/develop/cli#generator-entries) to check and run the
 module with the CLI, inspect dimensions and named parts, and render the captured result. Add
-[Testkit checks](https://metamesh.studio/docs/develop/agent-authoring#test-models) when you need repeatable assertions for
+[Testkit checks](https://metamesh.studio/docs/develop/cli#test-models) when you need repeatable assertions for
 defaults, presets, supported bounds, or validation recovery. Keep those tests in your project's
 test runner; the CLI owns compilation and capture tools.
 

package/dist/docs/guides/package.md

@@ -128,6 +128,9 @@ shared buffers once; it doesn't measure the local buffers transferred by a Worke
 
 ## API entry points
 
+Each public type and function has one import path. Import `FontSelection` and `isFontSelection`
+from `/fonts`, and `GeneratorPreset` from the package root.
+
 | Import                               | Responsibility                                                      |
 | ------------------------------------ | ------------------------------------------------------------------- |
 | `@metamesh/generator-sdk`            | Definitions, presets, inferred types, and module authoring.         |

package/dist/docs/guides/parameters.md

@@ -410,11 +410,10 @@ values with `model.ts`; check the workspace for source or cross-field errors bef
 
 
 
-**Keep executable rules in model.ts**
+**Controls describe; TypeScript decides**
 
-JSON mode defines serializable controls and visibility. Derived calculations, geometry checks, and
-  cross-field messages belong in `generate`; do not invent a second executable rules language inside
-  the Project definition.
+The definition declares inputs and visibility. Put derived values, geometry checks, and rules
+  between parameters in `generate`. Use `assert` or `warn` to identify the control to fix.