@snaptrude/plugin-core 0.0.0-dev-20260908074328 → 0.0.0-dev-20260911064951

package/src/api/design/query/spaces.ts

@@ -124,41 +124,6 @@ export abstract class PluginDesignQuerySpacesApi {
   public abstract getEnclosure(
     space: ComponentHandle,
   ): PluginApiReturn<PluginSpaceEnclosure | null>
-
-  /**
-   * List the space's **engine-generated BIM components** — the walls, floors
-   * and slabs the parametric engine derived from this space, grouped by kind.
-   *
-   * Unlike {@linkcode getEnclosure} (a geometric best-effort match), this read
-   * reports the engine's own derivation records, so every returned handle is a
-   * component the engine created *for this space*.
-   *
-   * The derived set is NOT stable across writes: a merge/split/rebuild of the
-   * space graph retires members and creates successors — re-query after any
-   * write that touches the space. This is the churn-recovery anchor: when a
-   * cached derived handle goes stale, call this again to pick up the current
-   * set.
-   *
-   * @param space - The space (room mass) to read
-   * @returns the generated component handles, grouped by kind
-   *   ({@linkcode PluginSpaceGeneratedBim}); a group is `[]` when the engine
-   *   derived nothing of that kind
-   * @throws If the space does not exist or the component is not a space/mass
-   *
-   * @examplePrompt Which walls did this room generate?
-   * @examplePrompt List the BIM components derived from the selected space
-   * @examplePrompt Get the floors and slabs that belong to this room
-   *
-   * # Example
-   * ```ts
-   * const [space] = await snaptrude.design.query.listSpaces()
-   * const bim = await snaptrude.design.query.spaces.listGeneratedBim(space)
-   * console.log(`${bim.walls.length} walls, ${bim.floors.length} floors`)
-   * ```
-   */
-  public abstract listGeneratedBim(
-    space: ComponentHandle,
-  ): PluginApiReturn<PluginSpaceGeneratedBim>
 }
 
 /**
@@ -308,36 +273,3 @@ export const PluginSpaceEnclosure = z.object({
   adjacentSpaces: z.array(PluginAdjacentSpace),
 })
 export type PluginSpaceEnclosure = z.infer<typeof PluginSpaceEnclosure>
-
-/**
- * Arguments for {@linkcode PluginDesignQuerySpacesApi.listGeneratedBim}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `space` | {@linkcode ComponentHandle} | The space (room mass) to read |
- */
-export const PluginDesignQuerySpacesListGeneratedBimArgs = z.object({
-  space: ComponentHandle,
-})
-export type PluginDesignQuerySpacesListGeneratedBimArgs = z.infer<
-  typeof PluginDesignQuerySpacesListGeneratedBimArgs
->
-
-/**
- * Result of {@linkcode PluginDesignQuerySpacesApi.listGeneratedBim} — the
- * space's engine-generated BIM component handles, grouped by kind. The set
- * changes whenever a write merges/splits/rebuilds the space graph — re-query
- * after writes rather than caching it.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `walls` | {@linkcode ComponentHandle}`[]` | Walls the engine derived from the space |
- * | `floors` | {@linkcode ComponentHandle}`[]` | Floors the engine derived from the space |
- * | `slabs` | {@linkcode ComponentHandle}`[]` | Slabs the engine derived from the space |
- */
-export const PluginSpaceGeneratedBim = z.object({
-  walls: z.array(ComponentHandle),
-  floors: z.array(ComponentHandle),
-  slabs: z.array(ComponentHandle),
-})
-export type PluginSpaceGeneratedBim = z.infer<typeof PluginSpaceGeneratedBim>

package/src/api/entity/space.ts

@@ -434,7 +434,6 @@ export type PluginSpaceUpdateArgs = z.infer<typeof PluginSpaceUpdateArgs>
  * | `massType` | `string?` | Updated mass type (if changed) |
  * | `spaceType` | `string?` | Updated space type (if changed) |
  * | `departmentId` | `string \| null?` | Updated department ID (if changed) |
- * | `rebuilt` | `boolean?` | `true` when a geometry update rebuilt the space's derived BIM — hosted children were re-created and the previous derived handles are retired (re-query them) |
  */
 export const PluginSpaceUpdateResult = z.object({
   spaceId: z.string(),
@@ -443,7 +442,6 @@ export const PluginSpaceUpdateResult = z.object({
   spaceType: z.string().optional(),
   areaClass: PluginAreaClass.optional(),
   departmentId: z.string().nullable().optional(),
-  rebuilt: z.boolean().optional(),
 })
 
 export type PluginSpaceUpdateResult = z.infer<typeof PluginSpaceUpdateResult>

package/src/api/presentation/placedViews.ts

@@ -1,6 +1,6 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../types"
-import { PluginSheetPosition, PluginViewLod } from "./sheets"
+import { PluginSheetPosition } from "./sheets"
 
 /**
  * Placed views — the view shapes already laid out on the Present canvas.
@@ -613,23 +613,6 @@ export abstract class PluginPresentationPlacedViewsApi {
     shapeId: string,
     enabled: boolean,
   ): PluginApiReturn<void>
-
-  /**
-   * Set the level of detail a placed view renders at — `"design"` (the
-   * Design-mode massing representation) or `"bim"` (the detailed BIM
-   * representation). Views only. Undoable. Requires Present mode to be open.
-   *
-   * @param shapeId - The placed view shape.
-   * @param lod - Target level of detail.
-   * @throws If Present mode is not open or `shapeId` is not a placed view.
-   *
-   * @examplePrompt Switch this placed view to the BIM level of detail
-   * @examplePrompt Show the massing version of the placed plan
-   */
-  public abstract setLod(
-    shapeId: string,
-    lod: PluginViewLod,
-  ): PluginApiReturn<void>
 }
 
 /** A point in crop space — fractions (0–1) of the uncropped view. */
@@ -674,8 +657,6 @@ export type PluginPlacedViewCrop = z.infer<typeof PluginPlacedViewCrop>
  * | `rotation` | `number` | Rotation in radians, `[0, 2π)` (nonzero only for 3D views — 2D views cannot rotate; set with `setRotation`) |
  * | `crop` | {@linkcode PluginPlacedViewCrop}` \| null` | Crop window (`null` when uncropped) |
  * | `isUnlinked` | `boolean` | Whether the source proposal was removed (an unlinked view no longer refreshes) |
- * | `lod` | {@linkcode PluginViewLod}? | Level of detail the view renders at (`"design"` massing / `"bim"` detail); absent on views that predate LOD variants (set with `setLod`) |
- * | `inactiveBuildingMask` | `boolean`? | Whether inactive proposal buildings are masked (the `setMask` toggle); absent when never set (masked by default) |
  */
 export const PluginPlacedView = z.object({
   shapeId: z.string(),
@@ -689,8 +670,6 @@ export const PluginPlacedView = z.object({
   rotation: z.number(),
   crop: PluginPlacedViewCrop.nullable(),
   isUnlinked: z.boolean(),
-  lod: PluginViewLod.optional(),
-  inactiveBuildingMask: z.boolean().optional(),
 })
 export type PluginPlacedView = z.infer<typeof PluginPlacedView>
 
@@ -1139,10 +1118,3 @@ export const PluginPlacedViewsSetMaskArgs = z.object({
   enabled: z.boolean(),
 })
 export type PluginPlacedViewsSetMaskArgs = z.infer<typeof PluginPlacedViewsSetMaskArgs>
-
-/** Arguments for {@link PluginPresentationPlacedViewsApi.setLod}. */
-export const PluginPlacedViewsSetLodArgs = z.object({
-  shapeId: z.string().min(1),
-  lod: PluginViewLod,
-})
-export type PluginPlacedViewsSetLodArgs = z.infer<typeof PluginPlacedViewsSetLodArgs>

package/src/api/presentation/sheets.ts

@@ -172,10 +172,9 @@ export abstract class PluginPresentationSheetsApi {
    * @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 (sheet centre when omitted) — `scale` — a standard
+   *   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) — and `lod` ({@linkcode PluginViewLod}) — the LOD
-   *   of the placed view (default: the product's Design default).
+   *   auto-fit when omitted).
    * @returns A {@linkcode PluginPresentationSheetsPlaceResult} with the created
    *   `shapeId`.
    * @throws If Present mode is not open, the sheet/view id is invalid, `scale`
@@ -198,11 +197,7 @@ export abstract class PluginPresentationSheetsApi {
   public abstract place(
     sheetId: string,
     viewId: string,
-    options?: {
-      position?: PluginSheetPosition
-      scale?: number
-      lod?: PluginViewLod
-    },
+    options?: { position?: PluginSheetPosition; scale?: number },
   ): PluginApiReturn<PluginPresentationSheetsPlaceResult>
 
   /**
@@ -413,15 +408,6 @@ export const PluginSheetPosition = z.object({
 })
 export type PluginSheetPosition = z.infer<typeof PluginSheetPosition>
 
-/**
- * The level of detail a placed view renders at: `"design"` (the Design-mode
- * massing representation) or `"bim"` (the detailed BIM representation).
- * Shared by `sheets.place` and `placedViews.*` (defined here because
- * `placedViews` already imports from this module).
- */
-export const PluginViewLod = z.enum(["design", "bim"])
-export type PluginViewLod = z.infer<typeof PluginViewLod>
-
 /** Result of {@linkcode PluginPresentationSheetsApi.list}. */
 export const PluginPresentationSheetsListResult = z.object({
   sheets: z.array(PluginPresentationSheet),
@@ -483,14 +469,12 @@ export type PluginPresentationSheetsSetMarginArgs = z.infer<
  * | `viewId` | `string` | The saved view to place |
  * | `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) |
- * | `lod` | {@linkcode PluginViewLod}` \| undefined` | LOD of the placed view (default: the product's Design default) |
  */
 export const PluginPresentationSheetsPlaceArgs = z.object({
   sheetId: z.string(),
   viewId: z.string(),
   position: PluginSheetPosition.optional(),
   scale: z.number().positive().optional(),
-  lod: PluginViewLod.optional(),
 })
 export type PluginPresentationSheetsPlaceArgs = z.infer<
   typeof PluginPresentationSheetsPlaceArgs

package/src/errors/codes.ts

@@ -5,13 +5,8 @@
  * APPEND-ONLY: codes are a published contract; never rename or remove one.
  * Handle-resolution failures deliberately collapse to ONE code
  * (`HANDLE_INVALID`) so error responses cannot be used as an existence /
- * ownership oracle (PLUGIN_HANDLE_MIGRATION_HLD §6) — with one deliberate
- * exception: `HANDLE_STALE` marks a handle the caller legitimately held that a
- * parametric resolution (merge / split / rebuild) has since retired — a
- * lifetime fact about the caller's own write-scoped handle, not an oracle
- * (forged / never-issued ids still collapse to `HANDLE_INVALID`).
- * `HANDLE_KIND_MISMATCH` stays distinct because the kind is information the
- * caller already holds.
+ * ownership oracle (PLUGIN_HANDLE_MIGRATION_HLD §6). `HANDLE_KIND_MISMATCH`
+ * stays distinct because the kind is information the caller already holds.
  */
 export const PLUGIN_ERROR_CODES = [
   "VALIDATION",
@@ -37,10 +32,6 @@ export const PLUGIN_ERROR_CODES = [
   "NO_ACTIVE_STRUCTURE",
   "NO_ELIGIBLE_ELEMENTS",
   "PROPOSAL_SWITCH_BLOCKED",
-  "HANDLE_STALE",
-  "KIND_HIDDEN_IN_MODE",
-  "MERGED_INTO_EXISTING",
-  "BLOCKED_IN_BIM",
   "INTERNAL",
   "UNKNOWN",
 ] as const
@@ -132,25 +123,6 @@ export const CODE_META: Record<PluginErrorCode, CodeMeta> = {
     category: "execution",
     hintTemplate: "Wait for the in-canvas agent run to finish, then retry.",
   },
-  HANDLE_STALE: {
-    category: "handle",
-    hintTemplate:
-      "The entity was retired by a parametric resolution (merge/split/rebuild); re-query for its successor.",
-  },
-  KIND_HIDDEN_IN_MODE: {
-    category: "execution",
-    hintTemplate:
-      "This entity kind has no representation in the current mode/LOD; switch mode or target a visible kind.",
-  },
-  MERGED_INTO_EXISTING: {
-    category: "execution",
-    hintTemplate:
-      "The created geometry merged into an existing entity; use the surviving handles from details.",
-  },
-  BLOCKED_IN_BIM: {
-    category: "execution",
-    hintTemplate: "This operation is unavailable in BIM mode; switch to Design and retry.",
-  },
   INTERNAL: {
     category: "internal",
     hintTemplate: "Host-side fault. Report with errorId.",

package/src/handles.ts

@@ -115,6 +115,19 @@ export type UnderlayHandle = EntityId<"underlay">
  */
 export type TerrainHandle = EntityId<"terrain">
 
+/**
+ * A **dimension line** — one measurement annotation left behind by the Measuring
+ * Tape tool (NOT a width/height/depth property; see `design.dimensions`).
+ * Entity-style: the token IS the raw engine dimension id (`dim_…`), resolved live
+ * host-side from the dimension-line registry (`getDimensionLineMap()`) — not via
+ * `ComponentUtility.FindComponentById`, which does not index dimension lines (a
+ * dimension line is not a Component). No arena, no quota, stable across
+ * undo/redo and across reloads (the record persists with the project). Returned
+ * by `design.dimensions.create` and consumed by every other
+ * `design.dimensions.*` method.
+ */
+export type DimensionHandle = EntityId<"dimension">
+
 /**
  * A handle to an **asynchronous import job** (today: a DWG → Forge conversion, which
  * can take minutes). Returned immediately by `core.io.import.dwg`; poll it via
@@ -233,6 +246,17 @@ export const ImportJobHandle = z
   .min(1)
   .transform((s) => s as ImportJobHandle)
 
+/**
+ * {@linkcode DimensionHandle} is an entity-style handle — the raw `dim_…` engine
+ * id, validated only as a non-empty string (no `"<kind>_"` prefix enforcement),
+ * resolved live host-side against the dimension-line registry (existence
+ * enforced there, as `HANDLE_INVALID`).
+ */
+export const DimensionHandle = z
+  .string()
+  .min(1)
+  .transform((s) => s as DimensionHandle)
+
 // Value-kind handle schemas (all-handle model, §11).
 export const Vec3Handle = handleSchema("vec3")
 export const QuatHandle = handleSchema("quat")

package/test/errors.test.mjs

@@ -178,10 +178,6 @@ test("PLUGIN_ERROR_CODES matches the reviewed snapshot (append-only contract)",
     "NO_ACTIVE_STRUCTURE",
     "NO_ELIGIBLE_ELEMENTS",
     "PROPOSAL_SWITCH_BLOCKED",
-    "HANDLE_STALE",
-    "KIND_HIDDEN_IN_MODE",
-    "MERGED_INTO_EXISTING",
-    "BLOCKED_IN_BIM",
     "INTERNAL",
     "UNKNOWN",
   ])