@snaptrude/plugin-core 0.9.15 → 0.9.16-networks-20261008.1

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

@@ -0,0 +1,209 @@
+import * as z from "zod";
+import { ComponentHandle } from "../../handles";
+import type { PluginApiReturn } from "../../types";
+/** Read scope. Omit spaces to inspect the active proposal's sketch spaces. */
+export declare const PluginBimContextArgs: z.ZodObject<{
+    spaces: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>>;
+}, z.core.$strict>;
+export type PluginBimContextArgs = z.infer<typeof PluginBimContextArgs>;
+/** Directed graph edge. Side A lies along world-up × curve-direction; side B is opposite.
+ * Region IDs are snapshot identifiers, not component handles. Null means no adjacent region.
+ */
+export declare const PluginBimEdge: z.ZodObject<{
+    id: z.ZodString;
+    startMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    endMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    lengthMm: z.ZodNumber;
+    heightMm: z.ZodNumber;
+    sideA: z.ZodNullable<z.ZodString>;
+    sideB: z.ZodNullable<z.ZodString>;
+    wall: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    supported: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginBimEdge = z.infer<typeof PluginBimEdge>;
+/** Construction context is detached. Revision covers geometry, room metadata and construction state. */
+export declare const PluginBimContext: z.ZodObject<{
+    revision: z.ZodString;
+    proposalId: z.ZodString;
+    units: z.ZodLiteral<"mm">;
+    spaces: z.ZodArray<z.ZodObject<{
+        component: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+        label: z.ZodString;
+        storey: z.ZodNumber;
+        eligible: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    regions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        spaces: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        startMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        endMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        lengthMm: z.ZodNumber;
+        heightMm: z.ZodNumber;
+        sideA: z.ZodNullable<z.ZodString>;
+        sideB: z.ZodNullable<z.ZodString>;
+        wall: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+        supported: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginBimContext = z.infer<typeof PluginBimContext>;
+/** Plan-local key selects either an existing construction or a new project-only native recipe.
+ * Bundles use the native DSL's SU/unit-expression rules; values overrides use mm/degrees.
+ */
+export declare const PluginBimConstruction: z.ZodUnion<readonly [z.ZodObject<{
+    key: z.ZodString;
+    reference: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strict>, z.ZodString]>;
+}, z.core.$strict>, z.ZodObject<{
+    key: z.ZodString;
+    bundle: 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.$strict>]>;
+export type PluginBimConstruction = z.infer<typeof PluginBimConstruction>;
+/** Every unwalled edge in the selected scope needs exactly one assignment.
+ * The first authored layer faces sideA unless reversed. Alignment sets the initial core-centre offset.
+ * Later parameter edits preserve the offset and reject invalid core alignment.
+ */
+export declare const PluginBimWallAssignment: z.ZodObject<{
+    edgeId: z.ZodString;
+    construction: z.ZodString;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+    reversed: z.ZodBoolean;
+    alignment: z.ZodLiteral<"coreCentre">;
+}, z.core.$strict>;
+export type PluginBimWallAssignment = z.infer<typeof PluginBimWallAssignment>;
+export declare const PluginBimPrepareArgs: z.ZodObject<{
+    revision: z.ZodString;
+    spaces: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    constructions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        key: z.ZodString;
+        reference: z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNumber;
+        }, z.core.$strict>, z.ZodString]>;
+    }, z.core.$strict>, z.ZodObject<{
+        key: z.ZodString;
+        bundle: 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.$strict>]>>;
+    walls: z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodString;
+        construction: z.ZodString;
+        values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
+        reversed: z.ZodBoolean;
+        alignment: z.ZodLiteral<"coreCentre">;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PluginBimPrepareArgs = z.infer<typeof PluginBimPrepareArgs>;
+/** Expected recipe/plan failures are diagnostics. No scene or library change occurs during prepare. */
+export declare const PluginBimPreparation: z.ZodObject<{
+    ok: z.ZodBoolean;
+    preparationId: z.ZodOptional<z.ZodString>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginBimPreparation = z.infer<typeof PluginBimPreparation>;
+export declare const PluginBimCreateArgs: z.ZodObject<{
+    preparationId: z.ZodString;
+}, z.core.$strict>;
+/** Source IDs identify removed sketch spaces, not live handles. Successful storeys share one undo step.
+ * Failed storeys remain spaces. Cancellation rolls back the whole conversion. Persistence is queued
+ * through normal model commands; this result is not a durable server-save acknowledgement.
+ */
+export declare const PluginBimResult: z.ZodObject<{
+    status: z.ZodEnum<{
+        created: "created";
+        cancelled: "cancelled";
+        partial: "partial";
+        unchanged: "unchanged";
+    }>;
+    convertedSpaceIds: z.ZodArray<z.ZodString>;
+    created: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    kept: z.ZodArray<z.ZodObject<{
+        space: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginBimResult = z.infer<typeof PluginBimResult>;
+/** Agent-driven Sketch-to-BIM. Uses PG2 topology; never redraws routes or publishes library families. */
+export declare abstract class PluginDesignBimApi {
+    /** Read room adjacency and native conversion eligibility in the active proposal.
+     * @param options Optional explicit spaces; filters edges but keeps adjacent room metadata.
+     * @returns Rooms, directed boundaries in mm, eligibility and revision.
+     * @examplePrompt Inspect the rooms on each side of these sketch wall boundaries
+     */
+    abstract getContext(options?: PluginBimContextArgs): PluginApiReturn<PluginBimContext>;
+    /** Stage a complete wall-construction assignment. A new prepare replaces this plugin's prior plan.
+     * @param plan Exact context revision, selected spaces, constructions and edge assignments.
+     * @returns Diagnostics or an opaque preparation ID, scoped to the caller and current project.
+     * @examplePrompt Validate wall layer assignments before converting sketch rooms to BIM
+     */
+    abstract prepare(plan: PluginBimPrepareArgs): PluginApiReturn<PluginBimPreparation>;
+    /** Execute native Sketch-to-BIM. Revalidates scope, catalogue access and construction before mutation.
+     * Uses native progress/cancel controls and worker cancellation. Floors/roofs retain project defaults.
+     * @param preparationId ID returned by prepare. Consumed once; stale or foreign IDs throw PRECONDITION_FAILED.
+     * @returns Created component handles and explicit converted/kept outcomes, including partial success.
+     * @examplePrompt Convert these sketch rooms to BIM with wall layers chosen for each room boundary
+     */
+    abstract create(preparationId: string): PluginApiReturn<PluginBimResult>;
+}
+//# sourceMappingURL=bim.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bim.d.ts","sourceRoot":"","sources":["../../../src/api/design/bim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB;;kBAAmD,CAAA;AACpF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;iBAUxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wGAAwG;AACxG,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAGhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;kBAMzB,CAAA;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,uGAAuG;AACvG,eAAO,MAAM,oBAAoB;;;;;;;iBAI/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACvE,eAAO,MAAM,mBAAmB;;kBAA2C,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAK1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,yGAAyG;AACzG,8BAAsB,kBAAkB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,eAAe,CAAC,gBAAgB,CAAC;IAEtF;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,eAAe,CAAC,oBAAoB,CAAC;IAEnF;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAAC,eAAe,CAAC;CACzE"}

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

@@ -0,0 +1,242 @@
+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";
+    beam: "beam";
+    column: "column";
+    door: "door";
+    window: "window";
+}>;
+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";
+        beam: "beam";
+        column: "column";
+        door: "door";
+        window: "window";
+    }>;
+    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";
+        beam: "beam";
+        column: "column";
+        door: "door";
+        window: "window";
+    }>>;
+}, 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>;
+/** Shared read surface over existing libraries. Does not publish, register, or place definitions. */
+export declare abstract class PluginDesignCatalogApi {
+    /** @param kind Optional element filter. @returns Accessible entries and their supported API paths. */
+    abstract list(kind?: PluginCatalogKind): PluginApiReturn<PluginCatalogEntry[]>;
+    /** @param reference Exact reference from 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":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAIlD,uFAAuF;AACvF,eAAO,MAAM,0BAA0B;;;kBAK5B,CAAA;AACX,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,yFAG9B,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB;;;iCAGjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,uGAAuG;AACvG,eAAO,MAAM,qBAAqB;;;;;;kBAKvB,CAAA;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB;;;;;;kBAG/B,CAAA;AACD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,eAAO,MAAM,wBAAwB;;;;;;;kBAEnC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;;;;kBAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAC7E,eAAO,MAAM,0BAA0B;;;;;;;kBAErC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AACD,eAAO,MAAM,uBAAuB;;;;;;;;;iBAGlC,CAAA;AACF,eAAO,MAAM,oBAAoB;;;;;;;;;iBAG/B,CAAA;AAEF,oGAAoG;AACpG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAY5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AACjE,eAAO,MAAM,sBAAsB;;;iCAIjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,oFAAoF;AACpF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AACnE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAEhC,CAAA;AACF,eAAO,MAAM,oBAAoB;;;;;iBAE/B,CAAA;AAEF,qGAAqG;AACrG,8BAAsB,sBAAsB;IAC1C,sGAAsG;IACtG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC,kBAAkB,EAAE,CAAC;IAC9E,wGAAwG;IACxG,QAAQ,CAAC,GAAG,CACV,SAAS,EAAE,sBAAsB,GAChC,eAAe,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAC9C"}

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

@@ -49,7 +49,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 +57,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 +74,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>;
 /**

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;AAMxB;;;;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;;;;;;;;;;;;;;;;;;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"}