forgecad 0.9.4 → 0.9.5

package/dist/docs-raw/generated/curves.md

@@ -10,7 +10,7 @@ Smooth curves, lofted surfaces, swept solids, splines, and high-level product sk
 ## Contents
 
 - [Curves & Surfacing](#curves-surfacing) — `hermiteTransitionG2`, `nurbs3d`, `spline2d`, `spline3d`, `loft`, `loftAlongSpine`, `sweep`, `variableSweep`, `nurbsSurface`, `surfacePatch`, `transitionCurve`, `transitionSurface`, `connectEdges`
-- [Surface Members](#surface-members) — `surfaceBand`, `compileSurfaceMember`, `SurfaceBody`
+- [Surface Members](#surface-members) — `surfaceBand`, `SurfaceBody`
 - [Curve3D](#curve3d)
 - [NurbsCurve3D](#nurbscurve3d)
 - [NurbsSurface](#nurbssurface)
@@ -27,7 +27,6 @@ Smooth curves, lofted surfaces, swept solids, splines, and high-level product sk
 - [ProductSpoutBuilder](#productspoutbuilder)
 - [ProductHandleBuilder](#producthandlebuilder)
 - [ProductHandleFeature](#producthandlefeature)
-- [ProductRibbonBuilder](#productribbonbuilder)
 - [CylinderCarrier](#cylindercarrier)
 - [PlaneCarrier](#planecarrier)
 - [ProductSkinCarrier](#productskincarrier)
@@ -375,11 +374,8 @@ connectEdges(edgeA: EdgeSegment, edgeB: EdgeSegment, options?: ConnectEdgesOptio
 | `normalA` | `Vec3` | Normal of first adjacent face. |
 | `normalB` | `Vec3` | Normal of second adjacent face (same as normalA for boundary edges). |
 | `boundary` | `boolean` | true if this is a boundary (unmatched) edge — unusual for closed solids. |
-| `nativeTopology?` | `EdgeNativeTopologyRef` | Native kernel topology identity when the active backend can provide one. |
 | `start`, `end`, `midpoint`, `length` | | — |
 
-`EdgeNativeTopologyRef`: `{ backend: "truck", edge: number }`
-
 
 **`ConnectEdgesOptions`** extends TransitionSurfaceOptions
 
@@ -402,63 +398,6 @@ connectEdges(edgeA: EdgeSegment, edgeB: EdgeSegment, options?: ConnectEdgesOptio
 surfaceBand<C extends SurfaceCoordinate>(path: SurfacePath<C> | SurfacePathBuilder<C>, width: WidthProfile, cap?: SurfaceBandCap): SurfaceBand<C>
 ```
 
-#### `compileSurfaceMember()`
-
-```ts
-compileSurfaceMember<C extends SurfaceCoordinate>(input: Omit<SurfaceMemberSpec<C>, "section"> & { section: MemberSection | MemberSectionInput; }): CompiledSurfaceMember
-```
-
-**`SurfaceMemberSpec`**: `name: string`, `kind: SurfaceMemberKind`, `path?: SurfacePath<C> | SurfacePathBuilder<C>`, `anchor?: SurfaceAnchor<C>`, `size?: { width: number; height: number; }`, `section: MemberSection`, `features: MemberFeature[]`, `capStyle?: SurfaceBandCap`, `explicitAnchors?: SurfaceMemberExplicitAnchor<C>[]`
-
-`SurfaceAnchor`: `{ carrier: CarrierSurface<C>, coordinate: C }`
-
-`CarrierSurface`: `{ name: string, kind: SurfaceCarrierKind }`
-
-**`MemberSection`**: `width?: number`, `thickness: number`, `edgeRadius: number`, `direction: MemberOutwardDirection`, `material?: ProductMaterial`, `stations: MemberSectionStation[]`
-
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
-`MemberSectionStation`: `{ t: number, width?: number, thickness?: number }`
-
-**`MemberFeature`**: `type: MemberFeatureType`, `name?: string`, `length?: number`, `width?: number`, `diameter?: number`, `counterboreDiameter?: number`, `clearanceDiameter?: number`, `height?: number`, `depth?: number`, `count?: number`, `along?: number`, `across?: number`, `verticalTravel?: number`
-
-`SurfaceMemberExplicitAnchor`: `{ name: string, coordinate: C, carrierName?: string }`
-
-**`MemberSectionInput`**: `width?: number`, `thickness: number`, `edgeRadius?: number`, `direction?: MemberOutwardDirection`, `material?: ProductMaterial`, `stations?: MemberSectionStation[]`
-
-**`CompiledSurfaceMember`**: `name: string`, `shape: Shape`, `mesh: MemberMesh`, `diagnostics: SurfaceDiagnostic[]`, `anchors: { start?: CompiledSurfaceMemberAnchor; end?: CompiledSurfaceMemberAnchor; center: CompiledSurfaceMemberAnchor; landings?: CompiledSurfaceMemberAnchor[]; boundaries?: CompiledSurfaceMemberAnchor[]; features?: CompiledSurfaceMemberAnchor[]; explicit?: CompiledSurfaceMemberAnchor[]; }`
-
-`MemberMesh`: `{ vertices: Vec3[], triangles: Array<[ number, number, number ]> }`
-
-**`SurfaceDiagnostic`**
-- `code?: SurfaceDiagnosticCode` — Stable machine-readable repair hook. Messages may change; codes should not.
-- Also: `category: "carrier" | "path" | "region" | "member" | "feature" | "join" | "compiler", level: "info" | "warning" | "error", message: string, subject?: string`
-
-**`SurfaceMemberAnchorIR`**: `role: SurfaceMemberAnchorRole`, `kind: "member-end" | "member-center" | "member-landing" | "member-boundary" | "plate-edge" | "plate-center" | "plate-landing" | "feature-center" | "surface-coordinate"`, `name?: string`, `point: Vec3`, `normal?: Vec3`
-
-`CompiledSurfaceMemberAnchor`: `{ frame?: SurfaceFrame }`
-
-**`SurfaceFrame`**: `point: Vec3`, `normal: Vec3`, `tangentAlong: Vec3`, `tangentAcross: Vec3`, `matrix: Mat4`, `carrier: string`, `representation: SurfaceCarrierKind | string`, `coordinate: SurfaceCoordinate`
-
 #### `SurfaceBody()` — Start a surface-member body builder for straps, inlays, guards, braces, cuffs, and similar physical members that live on a carrier surface.
 
 ```js
@@ -1034,18 +973,6 @@ with(...children: GroupInput[]): ShapeGroup
 integrate(...details: Shape[]): Shape
 ```
 
-#### `diagnostics()` — Return lowering representation, station names, rail names, and warnings.
-
-```ts
-diagnostics(): ProductSkinDiagnostics
-```
-
-**`ProductSkinDiagnostics`**: `representation: ProductSkinRepresentation`, `lowering: string[]`, `warnings: string[]`, `stationNames: string[]`, `railNames: string[]`
-
-**`ProductSkinRepresentation`** — Reported lowering mode for ProductSkin and conformal feature diagnostics.
-
-`"exact" | "sampled" | "mixed" | "fallback"`
-
 #### `uv()` — Create a side/u/v surface-ref query on this skin.
 
 ```ts
@@ -1101,7 +1028,7 @@ stationAt(vOrAxis: number): { ... }
 frame(query: ProductSkinRefQuery): ProductSurfaceFrame
 ```
 
-**`ProductSurfaceFrame`**: `point: Vec3`, `normal: Vec3`, `tangentU: Vec3`, `tangentV: Vec3`, `matrix: Mat4`, `skin: string`, `representation: ProductSkinRepresentation`
+`ProductSurfaceFrame`: `{ point: Vec3, normal: Vec3, tangentU: Vec3, tangentV: Vec3, matrix: Mat4, skin: string }`
 
 ### `ProductSurfaceRef`
 
@@ -1119,25 +1046,6 @@ frame(query: ProductSkinRefQuery): ProductSurfaceFrame
 frame(overrides?: Partial<ProductSkinRefQuery>): ProductSurfaceFrame
 ```
 
-**`ProductSkinRefQuery`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `side` | `ProductSkinSide` | Side of the product skin. `front` is the minimum axis cap, `rear`/`back` is the maximum axis cap. |
-| `u?` | `number` | Across-side parameter for side refs. Defaults to 0.5. |
-| `v?` | `number` | Along-axis parameter, 0 at the first cap and 1 at the rear/back cap. Defaults to 0.5. |
-| `offset?` | `number` | Positive distance away from the surface along the resolved normal. |
-
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
-**`ProductSurfaceFrame`**: `point: Vec3`, `normal: Vec3`, `tangentU: Vec3`, `tangentV: Vec3`, `matrix: Mat4`, `skin: string`, `representation: ProductSkinRepresentation`
-
-**`ProductSkinRepresentation`** — Reported lowering mode for ProductSkin and conformal feature diagnostics.
-
-`"exact" | "sampled" | "mixed" | "fallback"`
-
 #### `with()` — Return a copy of this ref with side/u/v/offset overrides.
 
 ```ts
@@ -1182,31 +1090,12 @@ ref(u?: number, v?: number, offset?: number): ProductSurfaceRef
 uv(u?: number, v?: number, offset?: number): ProductSkinRefQuery
 ```
 
-**`ProductSkinRefQuery`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `side` | `ProductSkinSide` | Side of the product skin. `front` is the minimum axis cap, `rear`/`back` is the maximum axis cap. |
-| `u?` | `number` | Across-side parameter for side refs. Defaults to 0.5. |
-| `v?` | `number` | Along-axis parameter, 0 at the first cap and 1 at the rear/back cap. Defaults to 0.5. |
-| `offset?` | `number` | Positive distance away from the surface along the resolved normal. |
-
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
 #### `frame()` — Resolve a point/frame on this surface using the builder's side.
 
 ```ts
 frame(query?: Partial<ProductSkinRefQuery>): ProductSurfaceFrame
 ```
 
-**`ProductSurfaceFrame`**: `point: Vec3`, `normal: Vec3`, `tangentU: Vec3`, `tangentV: Vec3`, `matrix: Mat4`, `skin: string`, `representation: ProductSkinRepresentation`
-
-**`ProductSkinRepresentation`** — Reported lowering mode for ProductSkin and conformal feature diagnostics.
-
-`"exact" | "sampled" | "mixed" | "fallback"`
-
 #### `ribbon()` — Start a conformal ribbon on this skin side.
 
 Path points use side-local `u`/`v` coordinates; this builder supplies the side. The returned ProductRibbonBuilder is already bound to the source skin and can be further configured before build(). Use `widthSamples` >= 3 when the ribbon must visibly wrap over curved product sections instead of behaving like a flat strip.
@@ -1284,11 +1173,7 @@ stations(stations: Array<ProductStationBuilder | ProductStationSpec>): this
 
 `ProductStationProfile`: `{ sketch: Sketch, width: number, depth: number, kind: ProductProfileKind, radius?: number, exponent?: number }`
 
-**`ProductProfileKind`**
-
-`"oval" | "roundedRect" | "circle" | "superEllipse" | "custom"`
-
-#### `rails()` — Attach guide rails as ProductSkin IR metadata and diagnostics.
+#### `rails()` — Attach named guide rails for product-skin construction and downstream surface references.
 
 ```ts
 rails(rails: Record<string, ProductRailSpec>): this
@@ -1306,19 +1191,6 @@ rails(rails: Record<string, ProductRailSpec>): this
 ref(name: string, query: ProductSkinRefQuery): this
 ```
 
-**`ProductSkinRefQuery`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `side` | `ProductSkinSide` | Side of the product skin. `front` is the minimum axis cap, `rear`/`back` is the maximum axis cap. |
-| `u?` | `number` | Across-side parameter for side refs. Defaults to 0.5. |
-| `v?` | `number` | Along-axis parameter, 0 at the first cap and 1 at the rear/back cap. Defaults to 0.5. |
-| `offset?` | `number` | Positive distance away from the surface along the resolved normal. |
-
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
 #### `refs()` — Publish multiple named semantic surface refs on the skin.
 
 ```ts
@@ -1337,27 +1209,6 @@ uv(side: ProductSkinSide, u?: number, v?: number): ProductSkinRefQuery
 material(material: ProductMaterial): this
 ```
 
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
 #### `color()` — Apply a simple color override to the lowered skin.
 
 ```ts
@@ -1370,7 +1221,7 @@ color(color: string): this
 edgeLength(value: number): this
 ```
 
-#### `wall()` — Records a target wall thickness; v1 keeps exterior skin lowering sampled and reports wall as a diagnostic.
+#### `wall()` — Record intended wall thickness for product design metadata. Use explicit shelling when the model needs real inner-wall geometry.
 
 ```ts
 wall(thickness: number): this
@@ -1448,7 +1299,7 @@ circle(diameter: number, options?: { segments?: number; }): this
 custom(sketch: Sketch, width: number, depth: number): this
 ```
 
-#### `crown()` — Stores a semantic crown amount for diagnostics and future rail solving.
+#### `crown()` — Set the station crown amount for soft product-section intent.
 
 ```ts
 crown(amount: number): this
@@ -1460,14 +1311,6 @@ crown(amount: number): this
 toSpec(): ProductStationSpec
 ```
 
-`ProductStationSpec`: `{ name: string, center: Vec3, profile: ProductStationProfile, crown?: number }`
-
-`ProductStationProfile`: `{ sketch: Sketch, width: number, depth: number, kind: ProductProfileKind, radius?: number, exponent?: number }`
-
-**`ProductProfileKind`**
-
-`"oval" | "roundedRect" | "circle" | "superEllipse" | "custom"`
-
 ### `ProductPanelBuilder`
 
 **Properties:**
@@ -1508,27 +1351,6 @@ thickness(thickness: number): this
 material(material: ProductMaterial): this
 ```
 
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
 #### `color()` — Apply a simple color override to the panel.
 
 ```ts
@@ -1551,23 +1373,9 @@ attachTo(ref: ProductRefInput, options?: ProductPanelAttachOptions): Shape
 
 `ProductSurfaceRef`
 
-`ProductAttachOptions`: `{ offset?: number, inset?: number }`
 
 `ProductPanelAttachOptions`: `{ at?: Partial<ProductSkinRefQuery>, thickness?: number, material?: ProductMaterial, color?: string }`
 
-**`ProductSkinRefQuery`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `side` | `ProductSkinSide` | Side of the product skin. `front` is the minimum axis cap, `rear`/`back` is the maximum axis cap. |
-| `u?` | `number` | Across-side parameter for side refs. Defaults to 0.5. |
-| `v?` | `number` | Along-axis parameter, 0 at the first cap and 1 at the rear/back cap. Defaults to 0.5. |
-| `offset?` | `number` | Positive distance away from the surface along the resolved normal. |
-
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
 ### `ProductRibbonBuilder`
 
 Builder for thin trim, label, grip, and split-line features that bend with a ProductSkin surface.
@@ -1592,53 +1400,6 @@ on(skin: ProductSkin, points: ProductRibbonPathPoint[], options?: ProductRibbonB
 
 `ProductSkinRefQuery | ProductSurfaceRef`
 
-**`ProductSkinRefQuery`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `side` | `ProductSkinSide` | Side of the product skin. `front` is the minimum axis cap, `rear`/`back` is the maximum axis cap. |
-| `u?` | `number` | Across-side parameter for side refs. Defaults to 0.5. |
-| `v?` | `number` | Along-axis parameter, 0 at the first cap and 1 at the rear/back cap. Defaults to 0.5. |
-| `offset?` | `number` | Positive distance away from the surface along the resolved normal. |
-
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
-**`ProductRibbonBuildOptions`** — Options shared by Product.ribbon() builders and Product.surface(...).ribbon(...).
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `width?` | `number` | Width across the surface in millimeters. |
-| `thickness?` | `number` | Solid thickness outward from the source surface in millimeters. |
-| `offset?` | `number` | Positive clearance between the source surface and the ribbon's inner face. |
-| `samples?` | `number` | Samples along the ribbon path. Higher values bend more smoothly. |
-| `widthSamples?` | `number` | Samples across the ribbon width. Use 3+ to visibly wrap over curved cross-sections. |
-| `resolution?` | `number` | Tessellation resolution passed to the lowered NURBS surface. |
-| `material?` | `ProductMaterial` | Apply a product material preset to the ribbon. |
-| `color?` | `string` | Apply a simple color override. |
-
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
 #### `fromRefs()` — Follow explicit surface refs.
 
 Useful for named refs or paths assembled elsewhere. The builder resolves each ref frame and interpolates between those frames; use on(skin, points) when you need full skin-side sampling between sparse control points.
@@ -1701,48 +1462,6 @@ color(color: string): this
 build(options?: ProductRibbonBuildOptions): Shape
 ```
 
-#### `buildWithDiagnostics()` — Build a conformal ribbon and return surface-feature diagnostics.
-
-Use this while validating API usage or model fidelity; diagnostics report sampling counts, side-span clamping, lowering mode, and warnings that should be visible in reviews.
-
-```ts
-buildWithDiagnostics(options?: ProductRibbonBuildOptions): ProductRibbonResult
-```
-
-**`ProductRibbonResult`** — Shape plus diagnostics returned by ProductRibbonBuilder.buildWithDiagnostics().
-- `shape: Shape` — Lowered conformal ribbon shape.
-- `diagnostics: ProductRibbonDiagnostics` — Sampling and lowering diagnostics for the returned shape.
-
-**`ProductRibbonDiagnostics`** — Diagnostics describing how a conformal ribbon was sampled and lowered.
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `name` | `string` | Ribbon shape name. |
-| `skin?` | `string` | Source skin name when the ribbon follows a ProductSkin directly. |
-| `side?` | `ProductSkinSide` | Source skin side when all path points are on one semantic side. |
-| `pathPointCount` | `number` | Number of control path points supplied before interpolation. |
-| `width` | `number` | Final ribbon width in millimeters. |
-| `thickness` | `number` | Final ribbon solid thickness in millimeters. |
-| `offset` | `number` | Final normal offset from the source surface in millimeters. |
-| `samples` | `number` | Final sample count along the ribbon path. |
-| `widthSamples` | `number` | Final sample count across the ribbon width. |
-| `resolution` | `number` | NURBS tessellation resolution used for the lowered surface. |
-| `lowering` | `"nurbsSurface"` | Lowering primitive used for the ribbon shape. |
-| `expectedFidelity` | `ProductSkinRepresentation` | Expected fidelity inherited from the source skin/ref sampling mode. |
-| `clampedUCount` | `number` | Number of generated width samples clamped to the valid side span. |
-| `maxUClampDistance` | `number` | Largest absolute u-distance lost to side-span clamping. |
-| `warnings` | `string[]` | Non-fatal sampling and lowering warnings. |
-
-**`ProductSkinRepresentation`** — Reported lowering mode for ProductSkin and conformal feature diagnostics.
-
-`"exact" | "sampled" | "mixed" | "fallback"`
-
-#### `diagnostics()` — Return diagnostics from the most recent build, if this builder has been built.
-
-```ts
-diagnostics(): ProductRibbonDiagnostics | undefined
-```
-
 ### `ProductSpoutBuilder`
 
 **Properties:**
@@ -1765,14 +1484,6 @@ from(ref: ProductSurfaceRef): this
 sections(sections: Array<Sketch | ProductStationBuilder | ProductStationSpec>): this
 ```
 
-`ProductStationSpec`: `{ name: string, center: Vec3, profile: ProductStationProfile, crown?: number }`
-
-`ProductStationProfile`: `{ sketch: Sketch, width: number, depth: number, kind: ProductProfileKind, radius?: number, exponent?: number }`
-
-**`ProductProfileKind`**
-
-`"oval" | "roundedRect" | "circle" | "superEllipse" | "custom"`
-
 #### `projection()` — Set the projection length along the source ref normal.
 
 ```ts
@@ -1791,27 +1502,6 @@ edgeLength(value: number): this
 material(material: ProductMaterial): this
 ```
 
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
 #### `color()` — Apply a simple color override to the spout.
 
 ```ts
@@ -1830,8 +1520,6 @@ build(): Shape
 attach(options?: ProductAttachOptions): Shape
 ```
 
-`ProductAttachOptions`: `{ offset?: number, inset?: number }`
-
 ### `ProductHandleBuilder`
 
 **Properties:**
@@ -1854,12 +1542,6 @@ between(upper: ProductSurfaceRef, lower: Vec3): this
 spine(points: Vec3[] | ProductRailSpec): this
 ```
 
-`ProductRailSpec`: `{ kind: ProductRailKind, points: Vec3[], degree?: number, name?: string }`
-
-**`ProductRailKind`**
-
-`"bezier" | "nurbs" | "polyline"`
-
 #### `grip()` — Set the grip cross-section profile.
 
 ```ts
@@ -1872,27 +1554,6 @@ grip(profile: Sketch): this
 material(material: ProductMaterial): this
 ```
 
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
 #### `padMaterial()` — Apply a product material preset to handle landing pads.
 
 ```ts
@@ -1941,181 +1602,6 @@ toShape(): Shape
 toGroup(): ShapeGroup
 ```
 
-### `ProductRibbonBuilder`
-
-Builder for thin trim, label, grip, and split-line features that bend with a ProductSkin surface.
-
-**Properties:**
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `name` | `string` | — |
-
-**Methods:**
-
-#### `on()` — Follow a ProductSkin with side/u/v path queries or refs.
-
-This is the highest-fidelity mode because every interpolated sample is resolved through ProductSkin.frame(), so the ribbon bends along the selected side as station width/depth changes. All query path points must stay on one side; split side transitions into separate ribbons.
-
-```ts
-on(skin: ProductSkin, points: ProductRibbonPathPoint[], options?: ProductRibbonBuildOptions): this
-```
-
-**`ProductRibbonPathPoint`** — Path point for Product.ribbon().on(...): either a side/u/v query or a resolved surface ref.
-
-`ProductSkinRefQuery | ProductSurfaceRef`
-
-**`ProductSkinRefQuery`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `side` | `ProductSkinSide` | Side of the product skin. `front` is the minimum axis cap, `rear`/`back` is the maximum axis cap. |
-| `u?` | `number` | Across-side parameter for side refs. Defaults to 0.5. |
-| `v?` | `number` | Along-axis parameter, 0 at the first cap and 1 at the rear/back cap. Defaults to 0.5. |
-| `offset?` | `number` | Positive distance away from the surface along the resolved normal. |
-
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
-**`ProductRibbonBuildOptions`** — Options shared by Product.ribbon() builders and Product.surface(...).ribbon(...).
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `width?` | `number` | Width across the surface in millimeters. |
-| `thickness?` | `number` | Solid thickness outward from the source surface in millimeters. |
-| `offset?` | `number` | Positive clearance between the source surface and the ribbon's inner face. |
-| `samples?` | `number` | Samples along the ribbon path. Higher values bend more smoothly. |
-| `widthSamples?` | `number` | Samples across the ribbon width. Use 3+ to visibly wrap over curved cross-sections. |
-| `resolution?` | `number` | Tessellation resolution passed to the lowered NURBS surface. |
-| `material?` | `ProductMaterial` | Apply a product material preset to the ribbon. |
-| `color?` | `string` | Apply a simple color override. |
-
-`ProductMaterial`: `{ color?: string, material?: ShapeMaterialProps }`
-
-**`ShapeMaterialProps`**
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `metalness?` | `number` | Metalness factor (0 = dielectric, 1 = metal). Default: 0.05 |
-| `roughness?` | `number` | Roughness factor (0 = mirror, 1 = fully diffuse). Default: 0.35 |
-| `emissive?` | `string` | Emissive glow color (hex string, e.g. "#ff6b35"). |
-| `emissiveIntensity?` | `number` | Emissive intensity multiplier. Default: 1 |
-| `opacity?` | `number` | Opacity (0 = fully transparent, 1 = fully opaque). Default: 1 |
-| `wireframe?` | `boolean` | Render as wireframe. Default: false |
-| `clearcoat?` | `number` | Clearcoat intensity (0–1). Default: 0.1 |
-| `clearcoatRoughness?` | `number` | Clearcoat roughness (0–1). Default: 0.4 |
-| `transmission?` | `number` | Glass/translucency transmission factor (0–1). Renderer support depends on target. |
-| `ior?` | `number` | Index of refraction for transmissive materials. Typical glass is ~1.45. |
-| `thickness?` | `number` | Approximate transmissive volume thickness in model units. |
-| `specularIntensity?` | `number` | Specular highlight intensity (0–1). |
-| `specularColor?` | `string` | Specular highlight tint. |
-| `reflectivity?` | `number` | Reflection strength for supported renderers (0–1). |
-
-#### `fromRefs()` — Follow explicit surface refs.
-
-Useful for named refs or paths assembled elsewhere. The builder resolves each ref frame and interpolates between those frames; use on(skin, points) when you need full skin-side sampling between sparse control points.
-
-```ts
-fromRefs(points: ProductSurfaceRef[], options?: ProductRibbonBuildOptions): this
-```
-
-#### `width()` — Set ribbon width in millimeters.
-
-```ts
-width(width: number): this
-```
-
-#### `thickness()` — Set solid thickness outward from the source surface in millimeters.
-
-```ts
-thickness(thickness: number): this
-```
-
-#### `offset()` — Set positive clearance between the source surface and the ribbon's inner face.
-
-```ts
-offset(offset: number): this
-```
-
-#### `samples()` — Set samples along the path.
-
-```ts
-samples(samples: number): this
-```
-
-#### `widthSamples()` — Set samples across the width. Use 3+ to bend over curved cross-sections.
-
-```ts
-widthSamples(samples: number): this
-```
-
-#### `resolution()` — Set NURBS tessellation resolution.
-
-```ts
-resolution(resolution: number): this
-```
-
-#### `material()` — Apply a product material preset.
-
-```ts
-material(material: ProductMaterial): this
-```
-
-#### `color()` — Apply a simple color override.
-
-```ts
-color(color: string): this
-```
-
-#### `build()` — Build a conformal ribbon as a thin NURBS surface solid.
-
-```ts
-build(options?: ProductRibbonBuildOptions): Shape
-```
-
-#### `buildWithDiagnostics()` — Build a conformal ribbon and return surface-feature diagnostics.
-
-Use this while validating API usage or model fidelity; diagnostics report sampling counts, side-span clamping, lowering mode, and warnings that should be visible in reviews.
-
-```ts
-buildWithDiagnostics(options?: ProductRibbonBuildOptions): ProductRibbonResult
-```
-
-**`ProductRibbonResult`** — Shape plus diagnostics returned by ProductRibbonBuilder.buildWithDiagnostics().
-- `shape: Shape` — Lowered conformal ribbon shape.
-- `diagnostics: ProductRibbonDiagnostics` — Sampling and lowering diagnostics for the returned shape.
-
-**`ProductRibbonDiagnostics`** — Diagnostics describing how a conformal ribbon was sampled and lowered.
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `name` | `string` | Ribbon shape name. |
-| `skin?` | `string` | Source skin name when the ribbon follows a ProductSkin directly. |
-| `side?` | `ProductSkinSide` | Source skin side when all path points are on one semantic side. |
-| `pathPointCount` | `number` | Number of control path points supplied before interpolation. |
-| `width` | `number` | Final ribbon width in millimeters. |
-| `thickness` | `number` | Final ribbon solid thickness in millimeters. |
-| `offset` | `number` | Final normal offset from the source surface in millimeters. |
-| `samples` | `number` | Final sample count along the ribbon path. |
-| `widthSamples` | `number` | Final sample count across the ribbon width. |
-| `resolution` | `number` | NURBS tessellation resolution used for the lowered surface. |
-| `lowering` | `"nurbsSurface"` | Lowering primitive used for the ribbon shape. |
-| `expectedFidelity` | `ProductSkinRepresentation` | Expected fidelity inherited from the source skin/ref sampling mode. |
-| `clampedUCount` | `number` | Number of generated width samples clamped to the valid side span. |
-| `maxUClampDistance` | `number` | Largest absolute u-distance lost to side-span clamping. |
-| `warnings` | `string[]` | Non-fatal sampling and lowering warnings. |
-
-**`ProductSkinRepresentation`** — Reported lowering mode for ProductSkin and conformal feature diagnostics.
-
-`"exact" | "sampled" | "mixed" | "fallback"`
-
-#### `diagnostics()` — Return diagnostics from the most recent build, if this builder has been built.
-
-```ts
-diagnostics(): ProductRibbonDiagnostics | undefined
-```
-
 ### `CylinderCarrier`
 
 **Properties:**
@@ -2247,12 +1733,6 @@ bounds(): SurfaceBounds
 offset(distance: number): CylinderCarrier
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(): SurfaceDiagnostic[]
-```
-
 #### `mirrorCoordinate()`
 
 ```ts
@@ -2372,12 +1852,6 @@ bounds(): SurfaceBounds
 offset(distance: number): PlaneCarrier
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(): SurfaceDiagnostic[]
-```
-
 #### `mirrorCoordinate()`
 
 ```ts
@@ -2402,10 +1876,6 @@ mirrorCoordinate(coordinate: PlaneSurfaceCoordinate): PlaneSurfaceCoordinate
 surface(side: ProductSkinSide): ProductSkinCarrier
 ```
 
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
-
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
-
 #### [`path()`](/docs/sketch#path)
 
 ```ts
@@ -2494,16 +1964,6 @@ bounds(): SurfaceBounds
 offset(distance: number): ProductSkinCarrier
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(): SurfaceDiagnostic[]
-```
-
-**`SurfaceDiagnostic`**
-- `code?: SurfaceDiagnosticCode` — Stable machine-readable repair hook. Messages may change; codes should not.
-- Also: `category: "carrier" | "path" | "region" | "member" | "feature" | "join" | "compiler", level: "info" | "warning" | "error", message: string, subject?: string`
-
 #### `mirrorCoordinate()`
 
 ```ts
@@ -2646,12 +2106,6 @@ withHole(name: string, input: SurfaceBandHoleInput): SurfaceBand<C>
 holes(): SurfaceBandHoleRegion[]
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(samples?: number): SurfaceDiagnostic[]
-```
-
 ### `SurfaceBodyBuilder`
 
 **Properties:**
@@ -2692,18 +2146,6 @@ autoJoinAtSharedAnchors(): this
 build(): Shape | ShapeGroup
 ```
 
-#### `buildWithDiagnostics()`
-
-```ts
-buildWithDiagnostics(): SurfaceBodyBuildResult
-```
-
-#### `buildDebug()`
-
-```ts
-buildDebug(): SurfaceBodyBuildResult
-```
-
 ### `SurfaceMemberBuilder`
 
 #### `plate()`
@@ -2766,7 +2208,7 @@ cutout(name: string, feature: MemberFeature | RoundedSlotBuilder): this
 counterbore(name: string, feature: MemberFeature | CounterboreBuilder): this
 ```
 
-#### `anchorAt()` — Add a named anchor at a carrier surface coordinate for diagnostics, debug views, and future named-anchor joins.
+#### `anchorAt()` — Add a named anchor at a carrier surface coordinate for explicit member joins.
 
 ```ts
 anchorAt(name: string, coordinate: C | SurfaceAnchor<C>): this
@@ -2814,18 +2256,6 @@ autoJoinAtSharedAnchors(): SurfaceBodyBuilder
 build(): Shape | ShapeGroup
 ```
 
-#### `buildWithDiagnostics()`
-
-```ts
-buildWithDiagnostics(): SurfaceBodyBuildResult
-```
-
-#### `buildDebug()`
-
-```ts
-buildDebug(): SurfaceBodyBuildResult
-```
-
 ### `SurfaceJoinBuilder`
 
 #### `betweenAnchors()` — Select named anchors on the source and target members before lowering this join.
@@ -2908,7 +2338,6 @@ toFeature(name?: string): MemberFeature
 
 - `Edge(options: BlendEdgeOptions): Shape`
 - `Surface(options: BlendSurfaceOptions): Shape`
-- `CornerY(options: BlendCornerYOptions): Shape` — Current implementation uses continuity-controlled edge fillets on solid edges. It does not yet provide a dedicated open-sheet or multi-patch Y-corner solver. Follow progress: https://github.com/KoStard/forgecad-private/issues/162
 
 ### `Analysis`
 
@@ -2947,15 +2376,12 @@ toFeature(name?: string): MemberFeature
 - `cylinder(name: string): CylinderCarrier` — Create an analytic cylinder carrier for bottles, limbs, tubes, guards, and cuffs.
 - `plane(name: string): PlaneCarrier` — Create an analytic plane carrier for plates and local flat construction surfaces.
 - `productSkin(skin: ProductSkin): ProductSkinCarrier` — Adapt an existing ProductSkin into the general surface-member carrier protocol.
-- `mesh(name: string): never` — Reserved stub for future parameterized mesh carriers; arbitrary mesh parameterization is not implemented yet.
-- `scan(name: string): never` — Reserved stub for future scan/body-fit carriers; arbitrary scan parameterization is not implemented yet.
 
 ### `SurfaceMembers`
 
 - `Body(name: string): SurfaceBodyBuilder` — Start a surface-member body builder for straps, inlays, guards, braces, cuffs, and similar physical members that live on a carrier surface.
 - `Band: typeof SurfaceBand`
 - `band<C extends SurfaceCoordinate>(path: SurfacePath<C> | SurfacePathBuilder<C>, width: WidthProfile, cap?: SurfaceBandCap): SurfaceBand<C>`
-- `compileMember<C extends SurfaceCoordinate>(input: Omit<SurfaceMemberSpec<C>, "section"> & { section: MemberSection | MemberSectionInput; }): CompiledSurfaceMember`
 
 ### `Slot`