@snaptrude/plugin-core 0.9.16-networks-20261012.1 → 0.9.17

package/src/api/presentation/sheets.ts

@@ -1,6 +1,5 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../types"
-import { PluginStandardDrawingScale } from "./drawingContract"
 
 /**
  * Presentation sheets — the layout sheets a presentation is assembled on.
@@ -11,16 +10,9 @@ import { PluginStandardDrawingScale } from "./drawingContract"
  *
  * `list`/`get` are reads; the rest mutate and require Present mode to be open:
  * `create` adds a sheet, `place` drops a saved view onto a sheet as a live
- * linked view shape (fitted to that sheet), `placeDrawing` moves an existing
- * drawing onto a sheet (scaled down to fit by default), `rename` relabels a
- * sheet, `delete` removes one, `reorder` moves one in the sheet order,
- * `setActive` navigates to one, and `updatePlacedView` re-renders placed views
- * to the current model.
- *
- * `presentation.drawings.create` never puts a drawing on a sheet: it makes the
- * drawing beside its source view on the canvas. To put a view on a sheet, call
- * `place(sheetId, viewId)`; to move a drawing you already made, call
- * `placeDrawing(sheetId, drawingId)`.
+ * linked view shape, `rename` relabels a sheet, `delete` removes one, `reorder`
+ * moves one in the sheet order, `setActive` navigates to one, and
+ * `updatePlacedView` re-renders placed views to the current model.
  *
  * Accessed via `snaptrude.presentation.sheets`.
  */
@@ -163,75 +155,37 @@ export abstract class PluginPresentationSheetsApi {
   ): PluginApiReturn<PluginPresentationSheet>
 
   /**
-   * Place a saved view onto a sheet. This is the call that puts a view on a
-   * sheet (`presentation.drawings.create` makes a drawing beside its source
-   * view, not on a sheet). When `scale` is omitted the view is fitted to the
-   * target sheet: a 2D or site-plan view is placed at the largest
-   * standard scale at which it fits inside the target sheet's margin, and
-   * never at a larger scale than the normal view drop would pick; a 3D view
-   * has no scale, so it is shrunk evenly to fit instead. This is the same fit
-   * as `placeDrawing`. Omit `position` unless the user asked for a specific
-   * place.
-   * Without a `position` the drawing goes to the sheet centre when that is
-   * free, otherwise to the nearest free spot to the centre inside the margin,
-   * beside the drawings already there; when there is no free spot it is
-   * centred anyway and the result has `overlaps: true`. With a `position` it
-   * is placed as given, and the result has `overlaps: true` when it covers
-   * another drawing, but it is not moved. In both cases only other drawings
-   * count (placed views and their title blocks and labels): text, images and
-   * other shapes on the sheet are ignored. Each call fits one view to the
-   * whole sheet, so a second fitted view often has no free spot: when several
-   * views should share a sheet, pass a `scale` small enough for all of them;
-   * otherwise use `sheets.create` per view. When the result's `overlaps` is
-   * true, move the drawing or put it on its own sheet.
-   * An explicit `scale` is always kept, even when the drawing (title block
-   * included) does not fit inside the sheet's margin at that scale; the result
-   * then has `overflows: true`. When it is true, pass a smaller scale (larger
-   * denominator), omit `scale` to fit, or use a larger sheet.
-   * `scale` must be a standard architectural scale denominator (100 means 1:100)
-   * in the project's unit system; any other value is rejected. Metric: 10, 20, 50,
-   * 100, 150, 200, 250, 500, 1000. Imperial detail: 12, 16, 24, 32, 48, 64, 96, 128,
-   * 192, 384, 768, 1536 (1" = 1' to 1/128" = 1'; 48 is 1/4" = 1', 96 is 1/8" = 1').
-   * Imperial site: 120, 240, 360, 480, 600, 1200, 2400, 3600, 4800 (1" = 10' to
-   * 1" = 400'). Pick the LARGEST standard scale (smallest denominator) at which the
-   * view still fits its frame or sheet and its room labels stay readable: for a
-   * building floor plan that is usually 1:50 to 1:200 (1/4" = 1' to 1/16" = 1').
-   * Never use a site-sized scale (1:500 and up, 1/64" = 1' (768) and smaller,
-   * 1" = 20' (240) and up) for a single building plan unless the user asked for it.
+   * Place a saved view onto a sheet.
    *
    * Drops the given view onto the sheet through the **native view drop** — the
    * placed shape is a live linked view (the same shape the Present views panel's
    * drag-drop creates), re-rendered from the current model, so
    * {@linkcode PluginPresentationSheetsApi.updatePlacedView} refreshes it later.
-   * 2D and site-plan views are placed at an architectural scale: the fitted
-   * standard scale described above by default, or the explicit `scale` when
-   * given (one of the standard values above). 3D views have no scale; passing
-   * `scale` for one throws. Requires Present mode to be open.
+   * 2D and site-plan views are placed at an architectural scale: the closest
+   * standard scale by default (the native auto-fit), or the explicit `scale`
+   * when given — one of the standard values the placed view's Scale dropdown
+   * offers for the project's unit system (metric `10, 20, 50, 100, 150, 200,
+   * 250, 500, 1000`; imperial e.g. `48` for 1/4″ = 1′, `96` for 1/8″ = 1′,
+   * `120` for 1″ = 10′). 3D views have no scale — passing `scale` for one
+   * throws. Requires Present mode to be open.
    *
    * @param sheetId - The id of the sheet to place onto.
    * @param viewId - The id of the saved view to place.
    * @param options - Optional `position` ({@linkcode PluginSheetPosition}) —
-   *   where to place it (when omitted, the sheet centre or the nearest free
-   *   spot) — and `scale` — a standard scale value for the project's unit system (2D/site-plan views only;
-   *   fitted to the target sheet when omitted).
+   *   where to place it (sheet centre when omitted) — and `scale` — a standard
+   *   scale value for the project's unit system (2D/site-plan views only;
+   *   auto-fit when omitted).
    * @returns A {@linkcode PluginPresentationSheetsPlaceResult} with the created
-   *   `shapeId`, the `scale` used (`null` for a 3D view), whether the fit
-   *   `rescaled` it, whether it `overlaps` another drawing on the sheet, and
-   *   whether it `overflows` the sheet's margin at an explicit `scale`.
-   *   (Hosts older than the fit return only `shapeId`.)
+   *   `shapeId`.
    * @throws If Present mode is not open, the sheet/view id is invalid, `scale`
    *   is not a standard value for the project's unit system, or `scale` is
-   *   passed for a 3D view. `PRECONDITION_FAILED` when the view does not fit
-   *   the sheet even at the smallest standard scale, or the title block alone
-   *   is larger than the sheet's drawable area (use a larger sheet); no
-   *   drawing is left on the sheet.
+   *   passed for a 3D view.
    *
    * @examplePrompt Place the floor plan on Sheet 1
    * @examplePrompt Add this 3D view to the cover sheet
    * @examplePrompt Drop the site plan onto the layout sheet at 100, 200
    * @examplePrompt Put the Ground Floor view on sheet_1 at 1:100 scale
    * @examplePrompt Place the plan on the cover sheet at quarter-inch scale
-   * @examplePrompt Add a floor plan drawing of each storey to this sheet
    *
    * # Example
    * ```ts
@@ -246,72 +200,6 @@ export abstract class PluginPresentationSheetsApi {
     options?: { position?: PluginSheetPosition; scale?: number },
   ): PluginApiReturn<PluginPresentationSheetsPlaceResult>
 
-  /**
-   * Move an existing drawing onto a sheet without copying or regenerating it,
-   * scaled down to fit the sheet when it is too big. `presentation.drawings.create`
-   * leaves a drawing beside its source view, not on a sheet; this is the call
-   * that puts it on one. To place a saved view on a sheet in one call, use
-   * `sheets.place(sheetId, viewId)`, which fits it the same way.
-   * By default (`fit` true or omitted) a drawing larger than the sheet's
-   * drawable area (the sheet inside its margin) is moved to the LARGEST standard
-   * architectural scale at which it fits; a drawing that already fits keeps its
-   * scale, and a drawing is never scaled up. A 3D drawing has no architectural
-   * scale, so it is shrunk uniformly to fit instead. With `fit: false` the scale
-   * is kept and a drawing that does not fit is rejected with an error naming the
-   * drawing, the sheet and the scale, and saying to call `placeDrawing` without
-   * `fit: false` to fit it, or use a larger sheet. When even
-   * the smallest standard scale does not fit, the call is rejected with an error
-   * suggesting a larger sheet size.
-   * Without a `position` the drawing goes to the sheet centre when that is
-   * free, otherwise to the nearest free spot to the centre inside the margin,
-   * beside the drawings already there; when there is no free spot it is
-   * centred anyway and the result has `overlaps: true`. With a `position` it
-   * is placed as given, and the result has `overlaps: true` when it covers
-   * another drawing, but it is not moved. In both cases only other drawings
-   * count (placed views and their title blocks and labels): text, images and
-   * other shapes on the sheet are ignored. Each call fits one drawing to the
-   * whole sheet, so a second fitted drawing often has no free spot: when
-   * several drawings should share a sheet, give them scales small enough for
-   * all of them; otherwise use `sheets.create` per drawing.
-   * The position is sheet-local. The drawing's
-   * stable id remains unchanged; `shapeId` therefore identifies the moved
-   * drawing. The result reports the architectural scale the drawing has on the
-   * sheet and whether this call changed it; a host that reports it also says
-   * whether the drawing `overlaps` another drawing on the sheet (move it or
-   * put it on its own sheet when true).
-   *
-   * @param sheetId - The id of the destination sheet.
-   * @param drawingId - The id of an existing drawing deliverable.
-   * @param options - Optional sheet-local `position` (when omitted, the sheet centre or the nearest free spot)
-   *   and `fit` (default `true`: scale a drawing that does not fit down to fit;
-   *   `false`: keep its scale and reject a drawing that does not fit).
-   * @returns A {@linkcode PluginPresentationSheetsPlaceDrawingResult} with the
-   *   drawing's `shapeId`, the `scale` used (`null` for a 3D drawing),
-   *   `rescaled`, and optionally `overlaps`.
-   * @throws `PRECONDITION_FAILED` if Present mode is closed, the sheet is locked,
-   *   the drawing does not fit with `fit: false`, or it does not fit even at the
-   *   smallest standard scale; `HANDLE_INVALID` if either id is invalid or the
-   *   shape is not a drawing.
-   *
-   * @examplePrompt Move this drawing onto the cover sheet
-   * @examplePrompt Place drawing_1 at the center of sheet_2
-   * @examplePrompt Put the level 2 plan drawing on the Level 2 Plan sheet
-   * @examplePrompt Add the floor plan drawings to this sheet
-   *
-   * # Example
-   * ```ts
-   * const { scale, rescaled } = await snaptrude.presentation.sheets.placeDrawing(
-   *   sheet.id,
-   *   drawing.id,
-   * )
-   * ```
-   */
-  public abstract placeDrawing(
-    sheetId: string,
-    drawingId: string,
-    options?: { position?: PluginSheetPosition; fit?: boolean },
-  ): PluginApiReturn<PluginPresentationSheetsPlaceDrawingResult>
-
   /**
    * Rename a layout sheet.
    *
@@ -579,82 +467,33 @@ export type PluginPresentationSheetsSetMarginArgs = z.infer<
  * |---|---|---|
  * | `sheetId` | `string` | The sheet to place onto |
  * | `viewId` | `string` | The saved view to place |
- * | `position` | {@linkcode PluginSheetPosition}` \| undefined` | Where to place it (when omitted, the sheet centre or the nearest free spot) |
- * | `scale` | `number \| undefined` | Standard scale value for the project's unit system (2D/site-plan views only; when omitted, the largest standard scale that fits inside the target sheet's margin, never larger than the normal view drop's) |
+ * | `position` | {@linkcode PluginSheetPosition}` \| undefined` | Where to place it (sheet centre when omitted) |
+ * | `scale` | `number \| undefined` | Standard scale value for the project's unit system (2D/site-plan views only; auto-fit to the closest standard scale when omitted) |
  */
 export const PluginPresentationSheetsPlaceArgs = z.object({
   sheetId: z.string(),
   viewId: z.string(),
   position: PluginSheetPosition.optional(),
-  scale: PluginStandardDrawingScale.optional(),
+  scale: z.number().positive().optional(),
 })
 export type PluginPresentationSheetsPlaceArgs = z.infer<
   typeof PluginPresentationSheetsPlaceArgs
 >
 
 /**
- * Arguments for {@linkcode PluginPresentationSheetsApi.placeDrawing}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `sheetId` | `string` | The destination sheet |
- * | `drawingId` | `string` | The existing drawing to move |
- * | `position` | {@linkcode PluginSheetPosition}` \| undefined` | Sheet-local position (when omitted, the sheet centre or the nearest free spot) |
- * | `fit` | `boolean \| undefined` | `true` (default) scales a drawing that does not fit down to fit; `false` keeps its scale and rejects a drawing that does not fit |
- */
-export const PluginPresentationSheetsPlaceDrawingArgs = z.object({
-  sheetId: z.string().min(1),
-  drawingId: z.string().min(1),
-  position: PluginSheetPosition.optional(),
-  fit: z.boolean().optional(),
-})
-export type PluginPresentationSheetsPlaceDrawingArgs = z.infer<
-  typeof PluginPresentationSheetsPlaceDrawingArgs
->
-
-/**
- * Result of {@linkcode PluginPresentationSheetsApi.place}. The host returns
- * `scale` and `rescaled` (and `overlaps`, `overflows`); they are optional only
- * because hosts that predate the fit report `shapeId` alone.
+ * Result of {@linkcode PluginPresentationSheetsApi.place}.
  *
  * | Property | Type | Description |
  * |---|---|---|
  * | `shapeId` | `string` | Id of the created canvas shape |
- * | `scale` | `number \| null \| undefined` | Architectural scale denominator the view has on the sheet (`null` for a 3D view) |
- * | `rescaled` | `boolean \| undefined` | Whether the fit changed the view's size from the normal view drop's |
- * | `overlaps` | `boolean \| undefined` | Whether the placed drawing overlaps another drawing on the sheet (only drawings count, not text, images or other shapes) |
- * | `overflows` | `boolean \| undefined` | `true` when the drawing, title block included, does not fit inside the sheet's margin at the explicit `scale` passed (the scale is kept); absent otherwise |
  */
 export const PluginPresentationSheetsPlaceResult = z.object({
   shapeId: z.string(),
-  scale: z.number().finite().nullable().optional(),
-  rescaled: z.boolean().optional(),
-  overlaps: z.boolean().optional(),
-  overflows: z.boolean().optional(),
 })
 export type PluginPresentationSheetsPlaceResult = z.infer<
   typeof PluginPresentationSheetsPlaceResult
 >
 
-/**
- * Result of {@linkcode PluginPresentationSheetsApi.placeDrawing}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `shapeId` | `string` | Id of the moved drawing (the drawing id, unchanged) |
- * | `scale` | `number \| null` | Architectural scale denominator the drawing has on the sheet (`null` for a 3D drawing) |
- * | `rescaled` | `boolean` | Whether this call changed the drawing's size to fit the sheet |
- * | `overlaps` | `boolean \| undefined` | Whether the drawing overlaps another drawing on the sheet (only drawings count, not text, images or other shapes) |
- */
-export const PluginPresentationSheetsPlaceDrawingResult =
-  PluginPresentationSheetsPlaceResult.omit({ overflows: true }).extend({
-    scale: z.number().finite().nullable(),
-    rescaled: z.boolean(),
-  })
-export type PluginPresentationSheetsPlaceDrawingResult = z.infer<
-  typeof PluginPresentationSheetsPlaceDrawingResult
->
-
 /**
  * Arguments for {@linkcode PluginPresentationSheetsApi.rename}.
  *

package/src/api/presentation/views.ts

@@ -2,7 +2,7 @@ import * as z from "zod"
 import { PluginApiReturn } from "../../types"
 
 /**
- * Presentation views — read the saved plan, 3D, and elevation views used to prepare presentations.
+ * Presentation views — read the saved 2D/3D views used to prepare presentations.
  *
  * A **view** is a saved camera/plan: a sheet-ready 2D plan or a saved 3D view.
  * A plugin can list and read views, capture them to images, activate one (move
@@ -24,10 +24,10 @@ export abstract class PluginPresentationViewsApi {
    * List the saved views in the active project.
    *
    * @returns A {@linkcode PluginPresentationViewsListResult} with a `views` array
-   *   of plan, 3D, and elevation views (empty when the project has none).
+   *   of 2D and 3D views (empty when the project has none).
    *
    * @examplePrompt List all the saved views
-   * @examplePrompt What plan, 3D, and elevation views are in this project?
+   * @examplePrompt What 2D and 3D views are in this project?
    * @examplePrompt Which view is currently active?
    * @examplePrompt Get the names of every presentation view
    * @examplePrompt Show me the 3D views I can put on a sheet
@@ -115,10 +115,6 @@ export abstract class PluginPresentationViewsApi {
    * Applies the view's camera, visibility, and storey state to the live scene.
    * Paired with {@linkcode PluginPresentationViewsApi.getActive}.
    *
-   * While Present is open this sets the Design frame a view saved in Present
-   * is taken from; it never moves the Present sheet canvas; use
-   * `presentation.camera` for that.
-   *
    * @param viewId - The id of the view to activate.
    * @returns The id of the now-active view.
    * @throws If no view has the given id.
@@ -142,15 +138,6 @@ export abstract class PluginPresentationViewsApi {
    *
    * Creates a camera bookmark (not geometry) from where the camera is now.
    *
-   * Works while Present mode is open. Present draws its drawings on the same
-   * 3D scene, so a view saved in Present takes its framing (camera, 2D or 3D
-   * mode, projection, storey, building) from the Design frame instead: the one
-   * the user had when Present opened, or one a plugin set since with
-   * `setActive`, `updateSettings({ viewMode })`, `core.camera`, `core.zoom`,
-   * `core.storeys.setActive`, `core.storeys.layers.setActive` or
-   * `core.buildings.setActive`. It never moves the Present sheet canvas; use
-   * `presentation.camera` for that.
-   *
    * @param name - Name for the new view (a default is used when omitted).
    * @param options - Optional `kind` (what kind of view to save, default
    *   `"view"`) and `storey` (save the view on a specific storey — the storey is
@@ -328,36 +315,13 @@ export abstract class PluginPresentationViewsApi {
 }
 
 /**
- * The rendering category of a saved view. Existing plan/3D values are preserved;
- * elevations are identified independently of their orthographic 3D camera.
+ * The kind of a saved view: a 2D plan view or a 3D view.
  */
-export const PluginPresentationViewType = z.enum(["2d", "3d", "elevation"])
+export const PluginPresentationViewType = z.enum(["2d", "3d"])
 export type PluginPresentationViewType = z.infer<
   typeof PluginPresentationViewType
 >
 
-/** The native semantic kind persisted for a saved view. */
-export const PluginPresentationViewKind = z.enum([
-  "plan",
-  "sitePlan",
-  "threeD",
-  "elevation",
-])
-export type PluginPresentationViewKind = z.infer<
-  typeof PluginPresentationViewKind
->
-
-/** Cardinal direction for an elevation; non-elevation views return `null`. */
-export const PluginPresentationElevationDirection = z.enum([
-  "north",
-  "east",
-  "south",
-  "west",
-])
-export type PluginPresentationElevationDirection = z.infer<
-  typeof PluginPresentationElevationDirection
->
-
 /**
  * A saved presentation view.
  *
@@ -365,9 +329,7 @@ export type PluginPresentationElevationDirection = z.infer<
  * |---|---|---|
  * | `id` | `string` | Unique view id |
  * | `name` | `string` | Display name |
- * | `type` | `"2d" \| "3d" \| "elevation"` | Rendering category; elevations are distinct from ordinary 3D views |
- * | `kind` | {@linkcode PluginPresentationViewKind} | Native semantic view kind |
- * | `direction` | {@linkcode PluginPresentationElevationDirection}` \| null` | Cardinal direction for elevations; otherwise `null` |
+ * | `type` | `"2d" \| "3d"` | Whether this is a 2D plan view or a 3D view |
  * | `isActive` | `boolean` | Whether this view is the currently active view |
  * | `storey` | `number \| null` | The storey this view was saved on (`null` on older views saved without one) |
  */
@@ -375,8 +337,6 @@ export const PluginPresentationView = z.object({
   id: z.string(),
   name: z.string(),
   type: PluginPresentationViewType,
-  kind: PluginPresentationViewKind,
-  direction: PluginPresentationElevationDirection.nullable(),
   isActive: z.boolean(),
   storey: z.number().nullable(),
 })

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

@@ -1,209 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}