forgecad 0.9.4 → 0.9.6

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

@@ -9,8 +9,8 @@ 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`
+- [Curves & Surfacing](#curves-surfacing) — `Loft.station`, `Loft.leftRail`, `Loft.rightRail`, `Loft.frontRail`, `Loft.backRail`, `Loft.centerRail`, `Loft.pathOnXz`, `Loft.pathOnYz`, `Loft.pathOnXy`, `Loft.withGuideRails`, `hermiteTransitionG2`, `nurbs3d`, `spline2d`, `spline3d`, `loft`, `loftAlongSpine`, `sweep`, `variableSweep`, `nurbsSurface`, `surfacePatch`, `transitionCurve`, `transitionSurface`, `connectEdges`
+- [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)
@@ -53,6 +52,87 @@ Smooth curves, lofted surfaces, swept solids, splines, and high-level product sk
 
 ### Curves & Surfacing
 
+#### `Loft.station()` — Create a loft station from a 2D profile and an axis position.
+
+```ts
+Loft.station(profile: Sketch, position: number): LoftStation
+```
+
+`LoftStation`: `{ profile: Sketch, position: number }`
+
+#### `Loft.leftRail()` — Create a guide rail that constrains the section-local negative-X side.
+
+```ts
+Loft.leftRail(path: LoftGuideRailPath): LoftGuideRail
+```
+
+`LoftGuideRail`: `{ side: LoftGuideRailSide, path: LoftGuideRailPath }`
+
+#### `Loft.rightRail()` — Create a guide rail that constrains the section-local positive-X side.
+
+```ts
+Loft.rightRail(path: LoftGuideRailPath): LoftGuideRail
+```
+
+#### `Loft.frontRail()` — Create a guide rail that constrains the section-local positive-Y side.
+
+```ts
+Loft.frontRail(path: LoftGuideRailPath): LoftGuideRail
+```
+
+#### `Loft.backRail()` — Create a guide rail that constrains the section-local negative-Y side.
+
+```ts
+Loft.backRail(path: LoftGuideRailPath): LoftGuideRail
+```
+
+#### `Loft.centerRail()` — Create a guide rail that moves section centers along the loft.
+
+```ts
+Loft.centerRail(path: LoftGuideRailPath): LoftGuideRail
+```
+
+#### `Loft.pathOnXz()` — Place a 2D guide path onto the XZ plane.
+
+The path's first coordinate becomes X and its second coordinate becomes Z. Use this for left/right silhouette rails authored with [`path()`](/docs/sketch#path) or [`constrainedSketch()`](/docs/sketch#constrainedsketch).
+
+```ts
+Loft.pathOnXz(path: LoftPath2D, y?: number): Vec3[]
+```
+
+#### `Loft.pathOnYz()` — Place a 2D guide path onto the YZ plane.
+
+The path's first coordinate becomes Y and its second coordinate becomes Z. Use this for front/back crown rails authored with [`path()`](/docs/sketch#path) or [`constrainedSketch()`](/docs/sketch#constrainedsketch).
+
+```ts
+Loft.pathOnYz(path: LoftPath2D, x?: number): Vec3[]
+```
+
+#### `Loft.pathOnXy()` — Place a 2D guide path onto the XY plane.
+
+The path's first coordinate becomes X and its second coordinate becomes Y. Use this when lofting along X or Y and a rail lives in a horizontal sketch plane.
+
+```ts
+Loft.pathOnXy(path: LoftPath2D, z?: number): Vec3[]
+```
+
+#### `Loft.withGuideRails()` — Loft through profile stations while forcing generated sections to follow guide rails.
+
+Stations define the cross-section family. Guide rails define the side or center paths the loft must pass through. With opposite side rails, the section is scaled to touch both rails. With one side rail, the section keeps its interpolated size unless a center rail is also present.
+
+```ts
+Loft.withGuideRails(stations: LoftStation[], rails: LoftGuideRail[], options?: LoftWithGuideRailsOptions): Shape
+```
+
+**`LoftOptions`**
+- `edgeLength?: number` — Marching-grid edge length for level-set meshing. Smaller = finer.
+- `boundsPadding?: number` — Optional extra bounds padding.
+
+**`LoftWithGuideRailsOptions`** extends LoftOptions
+- `axis?: LoftAxis` — Primary station axis. Default Z.
+- `samples?: number` — Number of generated loft stations including ends. Default scales with station count.
+- `railSamples?: number` — Number of points sampled from curve-backed rails before axis interpolation. Default 64.
+
 #### `hermiteTransitionG2()` — Create a quintic Hermite transition curve between two edge endpoints (G2 continuity).
 
 The curve starts at `a.point` tangent to `a.tangent` with curvature `a.curvature`, and ends at `b.point` tangent to `b.tangent` with curvature `b.curvature`, with smooth G2-continuous interpolation matching position, tangent, and curvature.
@@ -141,10 +221,6 @@ Performance note: loft is significantly heavier than primitive/extrude/revolve.
 loft(profiles: Sketch[], heights: number[], options?: LoftOptions): Shape
 ```
 
-**`LoftOptions`**
-- `edgeLength?: number` — Marching-grid edge length for level-set meshing. Smaller = finer.
-- `boundsPadding?: number` — Optional extra bounds padding.
-
 #### `loftAlongSpine()` — Loft between multiple profiles positioned along an arbitrary 3D spine curve.
 
 Unlike loft() which only supports Z heights, loftAlongSpine() places each profile at a position along a 3D spine, oriented perpendicular to the spine tangent. This enables lofting along curved paths — e.g., a wing root-to-tip transition that follows a swept-back leading edge.
@@ -375,11 +451,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 +475,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
@@ -882,6 +898,21 @@ path().moveTo(0,0).lineTo(10,0).lineTo(10,5).mirror('x').close()
 mirror(axis: "x" | "y" | [ number, number ]): this
 ```
 
+#### `toPolyline()` — Return the open path as a sampled 2D polyline.
+
+This is for construction geometry such as guide rails, measured centerlines, and curve-driven helpers where the authored path should stay open instead of becoming a filled sketch or stroked profile.
+
+```ts
+const rail = path()
+  .moveTo(24, 0)
+  .bezierTo(32, 44, 28, 92, 18, 120)
+  .toPolyline();
+```
+
+```ts
+toPolyline(): [ number, number ][]
+```
+
 #### `closeOffset()` — Close the path and return an offset version of the filled Sketch. Positive delta expands outward, negative shrinks inward.
 
 ```ts
@@ -1034,18 +1065,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 +1120,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 +1138,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 +1182,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 +1265,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 +1283,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 +1301,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 +1313,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 +1391,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 +1403,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 +1443,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 +1465,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,68 +1492,21 @@ on(skin: ProductSkin, points: ProductRibbonPathPoint[], options?: ProductRibbonB
 
 `ProductSkinRefQuery | ProductSurfaceRef`
 
-**`ProductSkinRefQuery`**
+#### `fromRefs()` — Follow explicit surface refs.
 
-| 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. |
+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.
 
-**`ProductSkinSide`** — Semantic side of a ProductSkin. `back` is accepted as an alias for `rear`.
+```ts
+fromRefs(points: ProductSurfaceRef[], options?: ProductRibbonBuildOptions): this
+```
 
-`"left" | "right" | "top" | "bottom" | "front" | "rear" | "back"`
+#### `width()` — Set ribbon width in millimeters.
 
-**`ProductRibbonBuildOptions`** — Options shared by Product.ribbon() builders and Product.surface(...).ribbon(...).
+```ts
+width(width: number): this
+```
 
-| 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.
+#### `thickness()` — Set solid thickness outward from the source surface in millimeters.
 
 ```ts
 thickness(thickness: number): this
@@ -1701,48 +1554,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 +1576,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 +1594,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 +1612,6 @@ build(): Shape
 attach(options?: ProductAttachOptions): Shape
 ```
 
-`ProductAttachOptions`: `{ offset?: number, inset?: number }`
-
 ### `ProductHandleBuilder`
 
 **Properties:**
@@ -1854,12 +1634,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 +1646,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 +1694,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 +1825,6 @@ bounds(): SurfaceBounds
 offset(distance: number): CylinderCarrier
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(): SurfaceDiagnostic[]
-```
-
 #### `mirrorCoordinate()`
 
 ```ts
@@ -2372,12 +1944,6 @@ bounds(): SurfaceBounds
 offset(distance: number): PlaneCarrier
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(): SurfaceDiagnostic[]
-```
-
 #### `mirrorCoordinate()`
 
 ```ts
@@ -2402,10 +1968,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 +2056,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 +2198,6 @@ withHole(name: string, input: SurfaceBandHoleInput): SurfaceBand<C>
 holes(): SurfaceBandHoleRegion[]
 ```
 
-#### `diagnostics()`
-
-```ts
-diagnostics(samples?: number): SurfaceDiagnostic[]
-```
-
 ### `SurfaceBodyBuilder`
 
 **Properties:**
@@ -2692,18 +2238,6 @@ autoJoinAtSharedAnchors(): this
 build(): Shape | ShapeGroup
 ```
 
-#### `buildWithDiagnostics()`
-
-```ts
-buildWithDiagnostics(): SurfaceBodyBuildResult
-```
-
-#### `buildDebug()`
-
-```ts
-buildDebug(): SurfaceBodyBuildResult
-```
-
 ### `SurfaceMemberBuilder`
 
 #### `plate()`
@@ -2766,7 +2300,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 +2348,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 +2430,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 +2468,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`