@snaptrude/plugin-core 0.9.16 → 0.9.18-voids-20261016.1

package/dist/api/design/catalog.d.ts

@@ -0,0 +1,320 @@
+import * as z from "zod";
+import type { PluginApiReturn } from "../../types";
+/** Exact saved family identity. A label or a selected Draw type is not an identity. */
+export declare const PluginSavedFamilyReference: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>;
+export type PluginSavedFamilyReference = z.infer<typeof PluginSavedFamilyReference>;
+/** Public overrides: physical lengths use mm, angles use degrees. Omitted values retain defaults. */
+export declare const PluginFamilyValues: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>;
+export type PluginFamilyValues = z.infer<typeof PluginFamilyValues>;
+/** Native construction uses a saved family or a project assembly token from the catalogue. */
+export declare const PluginConstructionType: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>, z.ZodString]>;
+export type PluginConstructionType = z.infer<typeof PluginConstructionType>;
+/** Family owns its layers/section. Geometry owns the footprint/axis; it is never a values override. */
+export declare const PluginFamilyPlacement: z.ZodObject<{
+    type: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+}, z.core.$strict>;
+export type PluginFamilyPlacement = z.infer<typeof PluginFamilyPlacement>;
+/** Sparse native family edit. Omitted type keeps the component's exact saved reference. */
+export declare const PluginFamilyUpdates: z.ZodObject<{
+    type: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>>;
+    values: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>>;
+}, z.core.$strict>;
+export type PluginFamilyUpdates = z.infer<typeof PluginFamilyUpdates>;
+export declare const PluginFamilyFloorOptions: z.ZodObject<{
+    type: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../..").Handle<"vec3">, string>>>;
+}, z.core.$strict>;
+export type PluginFamilyFloorOptions = z.infer<typeof PluginFamilyFloorOptions>;
+export declare const PluginFamilySlabOptions: z.ZodObject<{
+    type: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        up: "up";
+        down: "down";
+    }>>;
+}, z.core.$strict>;
+export type PluginFamilySlabOptions = z.infer<typeof PluginFamilySlabOptions>;
+export declare const PluginFamilyCeilingOptions: z.ZodObject<{
+    type: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+    heightFromFloor: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type PluginFamilyCeilingOptions = z.infer<typeof PluginFamilyCeilingOptions>;
+export declare const PluginFamilyContourArgs: z.ZodObject<{
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../..").Handle<"contour">, string>>;
+    options: z.ZodObject<{
+        type: z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strict>, z.ZodString]>;
+        values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export declare const PluginFamilyAxisArgs: z.ZodObject<{
+    axis: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../..").Handle<"line">, string>>;
+    options: z.ZodObject<{
+        type: z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strict>, z.ZodString]>;
+        values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+/** Inventory includes architectural recipes, ordinary PCs, and the existing placement libraries. */
+export declare const PluginCatalogKind: z.ZodEnum<{
+    component: "component";
+    floor: "floor";
+    wall: "wall";
+    ceiling: "ceiling";
+    slab: "slab";
+    roof: "roof";
+    furniture: "furniture";
+    door: "door";
+    window: "window";
+    beam: "beam";
+    column: "column";
+}>;
+export type PluginCatalogKind = z.infer<typeof PluginCatalogKind>;
+export declare const PluginCatalogReference: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>, z.ZodString]>;
+export type PluginCatalogReference = z.infer<typeof PluginCatalogReference>;
+/** Read-only capability record. Availability is checked again on every mutation. */
+export declare const PluginCatalogEntry: z.ZodObject<{
+    reference: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+    label: z.ZodString;
+    kind: z.ZodEnum<{
+        component: "component";
+        floor: "floor";
+        wall: "wall";
+        ceiling: "ceiling";
+        slab: "slab";
+        roof: "roof";
+        furniture: "furniture";
+        door: "door";
+        window: "window";
+        beam: "beam";
+        column: "column";
+    }>;
+    source: z.ZodEnum<{
+        native: "native";
+        revit: "revit";
+        project: "project";
+        asset: "asset";
+    }>;
+    createMethods: z.ZodArray<z.ZodString>;
+    updateMethods: z.ZodArray<z.ZodString>;
+    requirements: z.ZodArray<z.ZodString>;
+    unsupportedReason: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            enum: "enum";
+            length: "length";
+            text: "text";
+            integer: "integer";
+        }>;
+        unit: z.ZodOptional<z.ZodEnum<{
+            mm: "mm";
+            degrees: "degrees";
+        }>>;
+        default: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        drivesGeometry: z.ZodBoolean;
+        readOnly: z.ZodBoolean;
+        formulaDriven: z.ZodBoolean;
+        isInstance: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    geometryParameters: z.ZodArray<z.ZodString>;
+    network: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        role: z.ZodEnum<{
+            pipe: "pipe";
+            duct: "duct";
+            wire: "wire";
+            cable: "cable";
+            conduit: "conduit";
+            cableDuct: "cableDuct";
+            cableTray: "cableTray";
+            connector: "connector";
+            equipment: "equipment";
+        }>;
+        lengthParameter: z.ZodOptional<z.ZodString>;
+        ports: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            position: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+            direction: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+            size: z.ZodString;
+            height: z.ZodOptional<z.ZodString>;
+            widthDirection: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
+            systems: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    construction: z.ZodOptional<z.ZodObject<{
+        root: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        deps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        network: z.ZodOptional<z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            role: z.ZodEnum<{
+                pipe: "pipe";
+                duct: "duct";
+                wire: "wire";
+                cable: "cable";
+                conduit: "conduit";
+                cableDuct: "cableDuct";
+                cableTray: "cableTray";
+                connector: "connector";
+                equipment: "equipment";
+            }>;
+            lengthParameter: z.ZodOptional<z.ZodString>;
+            ports: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                position: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+                direction: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+                size: z.ZodString;
+                height: z.ZodOptional<z.ZodString>;
+                widthDirection: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
+                systems: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginCatalogEntry = z.infer<typeof PluginCatalogEntry>;
+export declare const PluginCatalogListArgs: z.ZodObject<{
+    kind: z.ZodOptional<z.ZodEnum<{
+        component: "component";
+        floor: "floor";
+        wall: "wall";
+        ceiling: "ceiling";
+        slab: "slab";
+        roof: "roof";
+        furniture: "furniture";
+        door: "door";
+        window: "window";
+        beam: "beam";
+        column: "column";
+    }>>;
+}, z.core.$strip>;
+export declare const PluginCatalogGetArgs: z.ZodObject<{
+    reference: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+}, z.core.$strip>;
+/** Search metadata is extensible. A slash separates category path segments. */
+export declare const PluginCatalogSearchArgs: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PluginCatalogSearchArgs = z.infer<typeof PluginCatalogSearchArgs>;
+/** Browse one hierarchy level without enumerating families or fetching recipe bodies. */
+export declare const PluginCatalogListCategoriesArgs: z.ZodObject<{
+    parent: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type PluginCatalogListCategoriesArgs = z.infer<typeof PluginCatalogListCategoriesArgs>;
+/** Metadata only: the category does not establish placement capabilities or recipe validity. */
+export declare const PluginCatalogCategory: z.ZodObject<{
+    categoryPath: z.ZodArray<z.ZodString>;
+    hasChildren: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginCatalogCategory = z.infer<typeof PluginCatalogCategory>;
+/** Metadata only. Read get(reference) to validate a selected family and inspect placement methods. */
+export declare const PluginCatalogSummary: z.ZodObject<{
+    reference: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+    label: z.ZodString;
+    categoryPath: z.ZodArray<z.ZodString>;
+    description: z.ZodString;
+    source: z.ZodEnum<{
+        native: "native";
+        revit: "revit";
+        project: "project";
+        asset: "asset";
+    }>;
+}, z.core.$strip>;
+export type PluginCatalogSummary = z.infer<typeof PluginCatalogSummary>;
+export declare const PluginCatalogSearchResult: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        reference: z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strict>, z.ZodString]>;
+        label: z.ZodString;
+        categoryPath: z.ZodArray<z.ZodString>;
+        description: z.ZodString;
+        source: z.ZodEnum<{
+            native: "native";
+            revit: "revit";
+            project: "project";
+            asset: "asset";
+        }>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PluginCatalogSearchResult = z.infer<typeof PluginCatalogSearchResult>;
+/** Shared read surface over existing libraries. Does not publish, register, or place definitions. */
+export declare abstract class PluginDesignCatalogApi {
+    /**
+     * Discover categories from accessible saved families and current project constructions.
+     * Omit parent for roots; pass a slash-separated returned path for its direct children.
+     * This metadata read does not fetch recipes, include unsaved drafts or legacy mesh inventories,
+     * or establish capabilities. Use search then get before placement. Names retain their case.
+     * @param args Parent path, exclusive after-name, and page limit (default 50, maximum 100).
+     * For another page at the same parent, pass the last item's final categoryPath segment as after.
+     * @returns Categories in Unicode code-point order, with descendant flags. Stop when a page has
+     * fewer than limit items. Live pagination is not a snapshot. Metadata-service failures reject.
+     */
+    abstract listCategories(args?: PluginCatalogListCategoriesArgs): PluginApiReturn<PluginCatalogCategory[]>;
+    /**
+     * Search accessible saved-family and project-construction metadata without downloading recipes.
+     * Categories are data, not an SDK enum. Legacy mesh inventories and unsaved drafts are excluded.
+     * Inspect selected references with get before placement; a search match does not prove validity
+     * or supported behavior. Pagination reads live data, not a snapshot. Failures reject.
+     * @param args Text/category filters, page limit (default 20, maximum 50), and opaque cursor.
+     * @returns Compact metadata and continuation. Continue until nextCursor is null or a suitable
+     * family is found. Concurrent changes can leave an empty page with continuation.
+     */
+    abstract search(args?: PluginCatalogSearchArgs): PluginApiReturn<PluginCatalogSearchResult>;
+    /** @param kind Optional element filter. @returns Accessible entries and their supported API paths. */
+    abstract list(kind?: PluginCatalogKind): PluginApiReturn<PluginCatalogEntry[]>;
+    /** @param reference Exact reference from search or list. @returns The current entry, or null when unavailable. */
+    abstract get(reference: PluginCatalogReference): PluginApiReturn<PluginCatalogEntry | null>;
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/api/design/catalog.d.ts.map

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

package/dist/api/design/create/bulk-items.d.ts

@@ -1,4 +1,5 @@
 import * as z from "zod";
+import { ComponentHandle } from "../../../handles";
 /**
  * Maximum items per bulk `design.create.*` call. A bounded request keeps
  * validation, command capture and rollback work finite; split a larger import
@@ -49,7 +50,7 @@ export type PluginWallTopProfile = z.infer<typeof PluginWallTopProfile>;
  * | `profile` | {@linkcode ProfileHandle} | Ordered curve chain (wall centerlines) |
  * | `height` | `number`? | Wall height (Snaptrude units, > 0; default engine default) |
  * | `thickness` | `number`? | Wall thickness (Snaptrude units, > 0; default: `wallType`'s total layer thickness when given, else engine default) |
- * | `wallType` | `string`? | Wall type name from `design.types.list("wall")` — layers/material/thickness defaults (default generic) |
+ * | `wallType` | {@linkcode PluginWallType}? | Legacy name/id or exact native `{ id, version }` pin from `design.types.list("wall")` (default generic) |
  * | `storey` | `number`? (int) | Target storey (must exist) — the run's walls are assigned + lifted to its base in the same undo entry (default: geometry-derived) |
  * | `topProfiles` | ({@linkcode PluginWallTopProfile} \| `null`)[]? | Top edge per curve of `profile`, same order; a `null` or missing entry keeps that wall flat at `height`. Raked / gabled walls (straight curves only) |
  */
@@ -57,12 +58,16 @@ export declare const PluginCreateWallRunItem: z.ZodObject<{
     profile: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
     height: z.ZodOptional<z.ZodNumber>;
     thickness: z.ZodOptional<z.ZodNumber>;
-    wallType: z.ZodOptional<z.ZodString>;
+    wallType: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strip>]>>;
     storey: z.ZodOptional<z.ZodNumber>;
     topProfiles: z.ZodOptional<z.ZodArray<z.ZodNullable<z.ZodArray<z.ZodObject<{
         along: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strip>>>>>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
 }, z.core.$strip>;
 export type PluginCreateWallRunItem = z.infer<typeof PluginCreateWallRunItem>;
 /** The `items` array of {@linkcode PluginDesignCreateApi.wallRuns} (1…1000). */
@@ -70,12 +75,16 @@ export declare const PluginCreateWallRunItems: z.ZodArray<z.ZodObject<{
     profile: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
     height: z.ZodOptional<z.ZodNumber>;
     thickness: z.ZodOptional<z.ZodNumber>;
-    wallType: z.ZodOptional<z.ZodString>;
+    wallType: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strip>]>>;
     storey: z.ZodOptional<z.ZodNumber>;
     topProfiles: z.ZodOptional<z.ZodArray<z.ZodNullable<z.ZodArray<z.ZodObject<{
         along: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strip>>>>>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
 }, z.core.$strip>>;
 export type PluginCreateWallRunItems = z.infer<typeof PluginCreateWallRunItems>;
 /**
@@ -103,26 +112,29 @@ export declare const PluginCreateFloorItems: z.ZodArray<z.ZodObject<{
 export type PluginCreateFloorItems = z.infer<typeof PluginCreateFloorItems>;
 /**
  * One door to place via {@linkcode PluginDesignCreateApi.doors} — the same
- * fields as a `"door"` {@linkcode PluginDesignCreateOpeningOptions}, so the
- * size overrides singular {@linkcode PluginDesignCreateApi.door} lacks are
- * available per item. `facing` and `hinge` are WORLD POINTS, not directions:
- * `facing` on the side of the wall the door swings open to, `hinge` near the
- * jamb it is hinged on. Rejects unknown fields.
+ * fields as a `"door"` {@linkcode PluginDesignCreateOpeningOptions}.
+ * Values are evaluated before cutting. Numeric lengths use SU; unit strings
+ * are accepted in values. `facing` selects local +Z; `hinge` sets the declared
+ * hand enum (left = local -X, right = +X). Both are world points.
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `catalogId` | `string` | Library id: team `_id` or general `fullName` |
+ * | `familyId` | `string` | Hosted door family definition ID |
+ * | `version` | `number`? | Exact version; newest known by default |
+ * | `values` | `Record<string, number \| string>`? | Authored parameter overrides |
  * | `hostWall` | {@linkcode ComponentHandle} | The wall to host the door |
  * | `position` | {@linkcode Vec3Handle} | World point projected onto the wall |
  * | `facing` | {@linkcode Vec3Handle}? | World point on the side the door swings open to (default engine-chosen) |
- * | `hinge` | {@linkcode Vec3Handle}? | World point near the jamb the door is hinged on (default the catalog item's authored side) |
+ * | `hinge` | {@linkcode Vec3Handle}? | World point near the hinged jamb; requires hand control |
  * | `label` | `string`? | Instance name (optional) |
- * | `width` | `number`? | Width override (Snaptrude units, > 0; default the catalog item's) |
- * | `height` | `number`? | Height override (Snaptrude units, > 0; default the catalog item's) |
+ * | `width` | `number`? | Declared width parameter (SU, > 0), not evaluated hole width |
+ * | `height` | `number`? | Declared height parameter (SU, > 0) |
  */
 export declare const PluginCreateDoorItem: z.ZodObject<{
-    catalogId: z.ZodString;
-    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").ComponentHandle, string>>;
+    familyId: z.ZodString;
+    version: z.ZodOptional<z.ZodNumber>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
     position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
@@ -133,8 +145,10 @@ export declare const PluginCreateDoorItem: z.ZodObject<{
 export type PluginCreateDoorItem = z.infer<typeof PluginCreateDoorItem>;
 /** The `items` array of {@linkcode PluginDesignCreateApi.doors} (1…1000). */
 export declare const PluginCreateDoorItems: z.ZodArray<z.ZodObject<{
-    catalogId: z.ZodString;
-    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").ComponentHandle, string>>;
+    familyId: z.ZodString;
+    version: z.ZodOptional<z.ZodNumber>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
     position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
@@ -154,20 +168,24 @@ export type PluginCreateDoorItems = z.infer<typeof PluginCreateDoorItems>;
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `catalogId` | `string` | Library id: team `_id` or general `fullName` |
+ * | `familyId` | `string` | Hosted window family definition ID |
+ * | `version` | `number`? | Exact version; newest known by default |
+ * | `values` | `Record<string, number \| string>`? | Authored parameter overrides; numeric lengths use SU |
  * | `hostWall` | {@linkcode ComponentHandle} | The wall to host the window |
  * | `position` | {@linkcode Vec3Handle} | World point projected onto the wall |
  * | `facing` | {@linkcode Vec3Handle}? | World point on the side the window opens to (default engine-chosen) |
- * | `hinge` | {@linkcode Vec3Handle}? | World point near the jamb the window is hinged on (default the catalog item's authored side) |
+ * | `hinge` | {@linkcode Vec3Handle}? | World point near the hinged jamb; requires hand control |
  * | `label` | `string`? | Instance name (optional) |
- * | `width` | `number`? | Width override (Snaptrude units, > 0; default the catalog item's) |
- * | `height` | `number`? | Height override (Snaptrude units, > 0; default the catalog item's) |
- * | `sillHeight` | `number`? | Wall base to window bottom (Snaptrude units, ≥ 0; default the catalog item's) |
+ * | `width` | `number`? | Declared width parameter (SU, > 0), not evaluated hole width |
+ * | `height` | `number`? | Declared height parameter (SU, > 0) |
+ * | `sillHeight` | `number`? | Declared sill parameter (SU, ≥ 0); position Y is ignored |
  */
 export declare const PluginCreateWindowItem: z.ZodObject<{
     sillHeight: z.ZodOptional<z.ZodNumber>;
-    catalogId: z.ZodString;
-    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").ComponentHandle, string>>;
+    familyId: z.ZodString;
+    version: z.ZodOptional<z.ZodNumber>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
     position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
@@ -179,8 +197,10 @@ export type PluginCreateWindowItem = z.infer<typeof PluginCreateWindowItem>;
 /** The `items` array of {@linkcode PluginDesignCreateApi.windows} (1…1000). */
 export declare const PluginCreateWindowItems: z.ZodArray<z.ZodObject<{
     sillHeight: z.ZodOptional<z.ZodNumber>;
-    catalogId: z.ZodString;
-    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").ComponentHandle, string>>;
+    familyId: z.ZodString;
+    version: z.ZodOptional<z.ZodNumber>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    hostWall: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
     position: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
     facing: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     hinge: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
@@ -226,4 +246,24 @@ export declare const PluginCreateFurnitureItems: z.ZodArray<z.ZodObject<{
     angleInDegrees: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
 export type PluginCreateFurnitureItems = z.infer<typeof PluginCreateFurnitureItems>;
+/**
+ * One void to cut via {@linkcode PluginDesignCreateApi.voids} — the same fields as
+ * {@linkcode PluginDesignCreateApi.void}. Rejects unknown fields.
+ *
+ * | Property | Type | Description |
+ * | --- | --- | --- |
+ * | `host` | {@linkcode ComponentHandle} | The slab, floor, roof or ceiling to cut through. Not a wall. |
+ * | `outline` | {@linkcode ProfileHandle} | Closed, flat plan outline in world SU (all points at one height). That height is ignored: it is dropped straight onto the host's top face. |
+ */
+export declare const PluginCreateVoidItem: z.ZodObject<{
+    host: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+    outline: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
+}, z.core.$strict>;
+export type PluginCreateVoidItem = z.infer<typeof PluginCreateVoidItem>;
+/** The `items` array of {@linkcode PluginDesignCreateApi.voids} (1…1000; the host takes at most 200, 50 per host). */
+export declare const PluginCreateVoidItems: z.ZodArray<z.ZodObject<{
+    host: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+    outline: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"profile">, string>>;
+}, z.core.$strict>>;
+export type PluginCreateVoidItems = z.infer<typeof PluginCreateVoidItems>;
 //# sourceMappingURL=bulk-items.d.ts.map

package/dist/api/design/create/bulk-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-items.d.ts","sourceRoot":"","sources":["../../../../src/api/design/create/bulk-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAIxB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAM7C;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;kBA0B7B,CAAA;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAMvE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAOlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,gFAAgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;;kBAGJ,CAAA;AACjC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAM/E;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB;;;;kBAGF,CAAA;AACjC,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAM3E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;kBAEtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB;;;;;;;;;mBAGD,CAAA;AACjC,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;kBAKxB,CAAA;AACX,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;;;;mBAGH,CAAA;AACjC,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAM7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;kBAGN,CAAA;AACjC,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA"}
+{"version":3,"file":"bulk-items.d.ts","sourceRoot":"","sources":["../../../../src/api/design/create/bulk-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EACL,eAAe,EAIhB,MAAM,kBAAkB,CAAA;AAKzB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAM7C;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;kBA0B7B,CAAA;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAMvE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBASlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,gFAAgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;kBAGJ,CAAA;AACjC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAM/E;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB;;;;kBAGF,CAAA;AACjC,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAM3E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;kBAEtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;mBAGD,CAAA;AACjC,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;kBAKxB,CAAA;AACX,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;mBAGH,CAAA;AACjC,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAM7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;kBAGN,CAAA;AACjC,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;kBAKtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,sHAAsH;AACtH,eAAO,MAAM,qBAAqB;;;mBAGD,CAAA;AACjC,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA"}