partforge 0.150.0 → 0.151.0

package/types/geometry.d.ts

@@ -315,7 +315,13 @@ export interface SheetPartSpec<P = ResolvedParams, D = Derived> {
   engrave?: ((k: GeometryKernel, p: P, d: D) => Shape2D | ProfileInput | null) | null;
   /** Where the piece sits, for display AND export. Omitted: flat, no transform. */
   pose?: SheetPose | ((p: P, d: D) => SheetPose | null) | null;
-  process?: "laser";
+  process?: "laser" | "cnc-router";
+  /** `process: "cnc-router"` only: flat-floored pockets at a depth (as `routedPart`). */
+  pockets?: ((k: GeometryKernel, p: P, d: D) => (RoutedPocket | null)[] | null) | null;
+  /** `process: "cnc-router"` only: drilled holes at a depth (as `routedPart`). */
+  drills?: ((p: P, d: D) => (RoutedDrill | null)[] | null) | null;
+  /** `process: "cnc-router"` only: operations done with another tool (as `routedPart`). */
+  extra?: ((k: GeometryKernel, p: P, d: D) => (RoutedExtra | null)[] | null) | null;
   label?: string;
   views: string[] | Record<string, true | ((s: Solid, p: P, d: D) => Solid)>;
   display?: SubPartDefinition<P, D>["display"];
@@ -330,6 +336,43 @@ export interface SheetPartSpec<P = ResolvedParams, D = Derived> {
 /** A sub-part cut from flat stock: an ordinary sub-part with `build`, `place` and `sheet` filled in. */
 export function sheetPart<P = ResolvedParams, D = Derived>(spec: SheetPartSpec<P, D>): SubPartDefinition<P, D>;
 
+// --- routed parts (docs/AUTHORING-PARTS.md "Routed parts") --------------------
+
+/** A flat-floored pocket machined `depth` mm down from the machined face. */
+export interface RoutedPocket { region: Shape2D | ProfileInput; depth: number; label?: string }
+/** A drilled hole; `depth` equal to the stock thickness drills through — deeper is a `routed-drill-depth` lint error. */
+export interface RoutedDrill { at: Point2; d: number; depth: number; label?: string }
+/** An operation done with another tool after the flat milling: the solid is cut in the preview and the STEP, the footprint is drawn, label and method go in the README. */
+export interface RoutedExtra { solid: Solid; footprint: Shape2D | ProfileInput; label: string; method: string }
+
+/**
+ * What `routedPart` accepts: `sheetPart`'s stock, profile and pose, plus pockets,
+ * drills and extra ops at depth. `score`/`engrave`/`process` are refused at load.
+ */
+export interface RoutedPartSpec<P = ResolvedParams, D = Derived> {
+  material: string | ((p: P, d: D) => string);
+  /** The MEASURED stock thickness in mm. */
+  thickness: number | ((p: P, d: D) => number);
+  /** The THROUGH cut: outline plus through holes, seen from the machined face. */
+  profile: (k: GeometryKernel, p: P, d: D) => Shape2D | ProfileInput;
+  pockets?: ((k: GeometryKernel, p: P, d: D) => (RoutedPocket | null)[] | null) | null;
+  drills?: ((p: P, d: D) => (RoutedDrill | null)[] | null) | null;
+  extra?: ((k: GeometryKernel, p: P, d: D) => (RoutedExtra | null)[] | null) | null;
+  /** Centerlines and layout marks: drawn on REFERENCE, cut nothing. Same entries as `score`. */
+  reference?: ((k: GeometryKernel, p: P, d: D) => SheetScoreEntry[] | null) | null;
+  pose?: SheetPose | ((p: P, d: D) => SheetPose | null) | null;
+  label?: string;
+  views: string[] | Record<string, true | ((s: Solid, p: P, d: D) => Solid)>;
+  display?: SubPartDefinition<P, D>["display"];
+  export?: { name: string };
+  enabled?: (p: P) => unknown;
+  exportable?: boolean;
+  place?: (solid: Solid, ctx: PlaceContext<P, D>) => Solid;
+}
+
+/** A sub-part CNC-routed from flat stock: an ordinary sub-part with `build`, `place` and a `sheet` record of process `"cnc-router"`. */
+export function routedPart<P = ResolvedParams, D = Derived>(spec: RoutedPartSpec<P, D>): SubPartDefinition<P, D>;
+
 /** A metric screw size `tSlots` knows. */
 export type ScrewSize = "M2.5" | "M3" | "M4";
 

package/types/index.d.ts

@@ -51,8 +51,8 @@ export interface ExportableSheetInfo {
  * starting `"cut kit options:"` for anything it cannot honour.
  */
 export interface KitOptions {
-  /** `"own-laser"` (default): SVG, laid out on sheets. `"service"`: DXF, one cut-only file per piece. */
-  destination?: "own-laser" | "service";
+  /** `"own-laser"` (default): SVG, laid out on sheets. `"service"`: DXF, one cut-only file per piece. `"cnc-router"`: DXF, one layered file per routed piece; kerf must be 0. */
+  destination?: "own-laser" | "service" | "cnc-router";
   /** Derived from `destination`; when given it must match. */
   cutFormat?: "svg" | "dxf";
   /** mm, 0–0.5: the cut lines move out by half of it. Default 0 (nominal geometry). */

package/types/part.d.ts

@@ -556,6 +556,12 @@ export interface SubPartExpectations {
   sheetPieces?: Expectation;
   /** Sheet parts with a custom `build` only: % volume drift from profile area × thickness minus the marks (volunteered check: `<=2`). */
   sheetSolidMatch?: Expectation;
+  /** Routed parts only: pocket, drill or extra-op footprint regions outside the profile (volunteered check: `0`). */
+  routedOutside?: Expectation;
+  /** Routed parts only: pockets whose region resolved empty (volunteered check: `0`). */
+  routedEmpty?: Expectation;
+  /** Routed parts only: separate regions in the cut profile (volunteered check: `1`). */
+  routedPieces?: Expectation;
 }
 
 /**

package/types/testing.d.ts

@@ -340,14 +340,33 @@ export interface SheetFacts {
   marksOutside: number | null;
   /** Custom builds only: `100·|volume − (area·thickness − 0.2·marksArea)| / (area·thickness − 0.2·marksArea)`. */
   solidMatchPct: number | null;
-  at2d: { bridge: [number, number] | null; gap: [number, number] | null; marks: [number, number] | null };
-  at: { bridge: number[] | null; gap: number[] | null; marks: number[] | null };
+  /** `outside` is a routed part's (the 2-D spot of the first op found outside the profile); a laser part's facts leave it out. */
+  at2d: { bridge: [number, number] | null; gap: [number, number] | null; marks: [number, number] | null; outside?: [number, number] | null };
+  /** `outside`: the 3-D place of `at2d.outside` when the part's pose is trusted, else `null`. */
+  at: { bridge: number[] | null; gap: number[] | null; marks: number[] | null; outside: [number, number, number] | null };
   /**
    * Why a reading is `null` although `evaluated` is true — the geometry engine refused
    * the profile, or the reading threw — or `null` for each one that was taken.
    */
   readErrors: { bridge: string | null; gap: string | null; marks: string | null; marksArea: string | null };
   evaluated: boolean;
+  /** A routed part's (`process: "cnc-router"`) operations table; absent on a laser part. */
+  routed?: RoutedFacts;
+}
+
+/** A routed part's operations table, as the README's ROUTER OPERATIONS block prints it. Sizes in mm to two decimals. */
+export interface RoutedFacts {
+  profile: { w: number; h: number };
+  /** One row per non-empty pocket. */
+  pockets: Array<{ label: string | null; depth: number; w: number; h: number; area: number }>;
+  /** One row per tool setting (d, depth, through), labels joined with ", ". */
+  drills: Array<{ label: string | null; d: number; depth: number; through: boolean; count: number }>;
+  /** One row per extra op with a non-empty footprint; `maxDepth` is how far its solid reaches below the machined face, within the stock. */
+  extra: Array<{ label: string; method: string; w: number; h: number; maxDepth: number }>;
+  /** How many pockets, drills and extra footprints leave the profile. */
+  outside: number;
+  /** How many pockets and extra footprints resolved to an empty region. */
+  empty: number;
 }
 
 export interface SubPartFacts {