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

package/src/api/design/index.ts

@@ -18,14 +18,7 @@ import { PluginDesignDimensionsApi } from "./dimensions"
 import { PluginDesignTypesApi } from "./types"
 import { PluginDesignFamilyApi } from "./family"
 import { PluginDesignGridsApi } from "./grids"
-import { PluginDesignCatalogApi } from "./catalog"
-import { PluginDesignBimApi } from "./bim"
 import { PluginDesignChangeResult } from "./lock"
-import {
-  PluginElectricalApi,
-  PluginPlumbingApi,
-  PluginMechanicalApi,
-} from "./networks"
 
 /**
  * `snaptrude.design.*` — author, query & edit BIM geometry.
@@ -83,22 +76,10 @@ export abstract class PluginDesignApi {
   public abstract types: PluginDesignTypesApi
   /** Author parametric families from a JSON spec. See {@linkcode PluginDesignFamilyApi}. */
   public abstract family: PluginDesignFamilyApi
-  /** Shared family and asset inventory, including supported placement and update paths. */
-  public abstract catalog: PluginDesignCatalogApi
-
-  /** Agent-driven Sketch-to-BIM with explicit per-edge constructions. */
-  public abstract bim: PluginDesignBimApi
 
   /** Structural edits on a grid's line structure. See {@linkcode PluginDesignGridsApi}. */
   public abstract grids: PluginDesignGridsApi
 
-  /** Persistent electrical equipment, routes and circuit graphs. */
-  public abstract electrical: PluginElectricalApi
-  /** Persistent plumbing equipment and directed pipe graphs. */
-  public abstract plumbing: PluginPlumbingApi
-  /** Persistent family-backed HVAC ducts, fittings and equipment. */
-  public abstract mechanical: PluginMechanicalApi
-
   /**
    * Lock entities so they cannot be edited. Undoable. Cascades to void/door/window
    * children, stacked-wall companions, and terrain neighborhood; skips
@@ -119,9 +100,7 @@ export abstract class PluginDesignApi {
    * // affected is post-cascade: hosted doors/windows are included
    * ```
    */
-  public abstract lock(
-    components: ComponentHandle[],
-  ): PluginApiReturn<PluginDesignChangeResult>
+  public abstract lock(components: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>
 
   /**
    * Unlock previously locked entities so they can be edited again. Undoable.
@@ -141,9 +120,7 @@ export abstract class PluginDesignApi {
    * const { affected } = await snaptrude.design.unlock(locked)
    * ```
    */
-  public abstract unlock(
-    components: ComponentHandle[],
-  ): PluginApiReturn<PluginDesignChangeResult>
+  public abstract unlock(components: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>
 
   /**
    * Test whether an entity is locked (folds group + bucket lock unless `includeInherited: false`).
@@ -211,9 +188,7 @@ export abstract class PluginDesignApi {
    * console.log("area-locked", affected.length, "spaces")
    * ```
    */
-  public abstract lockArea(
-    spaces: ComponentHandle[],
-  ): PluginApiReturn<PluginDesignChangeResult>
+  public abstract lockArea(spaces: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>
 
   /**
    * Unlock the footprint area of previously area-locked spaces so their area can
@@ -234,9 +209,7 @@ export abstract class PluginDesignApi {
    * const { affected } = await snaptrude.design.unlockArea(locked)
    * ```
    */
-  public abstract unlockArea(
-    spaces: ComponentHandle[],
-  ): PluginApiReturn<PluginDesignChangeResult>
+  public abstract unlockArea(spaces: ComponentHandle[]): PluginApiReturn<PluginDesignChangeResult>
 
   /**
    * Test whether a space's footprint area is locked. A read — never throws;
@@ -299,6 +272,3 @@ export * from "./dimensions"
 export * from "./types"
 export * from "./family"
 export * from "./grids"
-export * from "./networks"
-export * from "./catalog"
-export * from "./bim"

package/src/api/design/types/index.ts

@@ -1,25 +1,23 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../../types"
 
-/** An exact saved native wall family. Access is checked on every use; Draw selection is not registration. */
-export const PluginNativeWallType = z.object({
-  id: z.string().min(1),
-  version: z.number().int().positive(),
-})
-export type PluginNativeWallType = z.infer<typeof PluginNativeWallType>
-
-/** Legacy project type name/id, or an exact authorized native wall family pin. */
-export const PluginWallType = z.union([z.string().trim().min(1), PluginNativeWallType])
-export type PluginWallType = z.infer<typeof PluginWallType>
-
 /**
- * Read-only project assemblies and authorized saved native wall families.
- * Legacy ids use `"<kind>:<name>"`. Native wall records carry `nativeFamily`:
- * pass that exact `{ id, version }` pin to get, create.walls, create.wallRuns,
- * or update.wall. Labels and bare definition ids do not select native families.
- * Native lengths use Snaptrude units (1 SU = 254 mm).
- * Missing ids return null; catalog/network failures reject rather than return
- * an incomplete catalog. Author native families with design.family.
+ * `snaptrude.design.types` — READ-ONLY reference over the project's building
+ * **type / assembly** system (the Project Properties layer stacks: External /
+ * Internal walls, slabs, floors, ceilings, roofs). A type bundles a labelled
+ * layer stack — each layer's role, thickness (engine units) and material — plus a
+ * summed total thickness. Both the built-in defaults and any team/user-added types
+ * are surfaced.
+ *
+ * Types are plain value records ({@linkcode PluginBuildingType}) — NOT scene
+ * entities/handles. A type's `id` is a stable `"<kind>:<name>"` token
+ * (e.g. `"wall:brickWithPlasterAndPaint"`) returned by
+ * {@linkcode PluginDesignTypesApi.list} and consumed by
+ * {@linkcode PluginDesignTypesApi.get}. Reads never throw — an unknown id yields
+ * `null`; a kind with no types yields `[]`.
+ *
+ * These are reads only: there is no engine seam to author a type from a plugin
+ * (types are created through the construction/project-properties UI).
  */
 export abstract class PluginDesignTypesApi {
   constructor() {}
@@ -48,10 +46,10 @@ export abstract class PluginDesignTypesApi {
   ): PluginApiReturn<PluginBuildingTypeSummary[]>
 
   /**
-   * Get one building type by its legacy id or exact native wall pin — its labelled layer stack
+   * Get one building type by its `"<kind>:<name>"` id — its labelled layer stack
    * (each layer's role, thickness and material) plus the summed total thickness.
    *
-   * @param typeId The legacy id or nativeFamily pin from {@linkcode PluginDesignTypesApi.list}
+   * @param typeId The type id from {@linkcode PluginDesignTypesApi.list} (e.g. `"wall:exposedConcrete"`)
    * @returns The full type, or `null` if no type matches
    *
    * @examplePrompt What layers make up this wall type?
@@ -62,11 +60,11 @@ export abstract class PluginDesignTypesApi {
    * # Example
    * ```ts
    * const [first] = await snaptrude.design.types.list("wall")
-   * const type = await snaptrude.design.types.get(first.nativeFamily ?? first.id)
+   * const type = await snaptrude.design.types.get(first.id)
    * if (type) for (const layer of type.layers) console.log(layer.name, layer.thickness)
    * ```
    */
-  public abstract get(typeId: PluginWallType): PluginApiReturn<PluginBuildingType | null>
+  public abstract get(typeId: string): PluginApiReturn<PluginBuildingType | null>
 }
 
 /** The building-type families exposed by {@linkcode PluginDesignTypesApi}. */
@@ -87,8 +85,6 @@ export const PluginTypeLayer = z.object({
   name: z.string(),
   role: z.string(),
   thickness: z.number(),
-  /** Native authored core membership. Never inferred from material or layer name. */
-  isCore: z.boolean().optional(),
   material: z
     .object({
       name: z.string(),
@@ -103,7 +99,7 @@ export type PluginTypeLayer = z.infer<typeof PluginTypeLayer>
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `id` | `string` | Legacy `"<kind>:<name>"` token or native definition id; native lookups use `nativeFamily` |
+ * | `id` | `string` | Stable `"<kind>:<name>"` token — pass to `design.types.get` |
  * | `kind` | {@linkcode PluginBuildingTypeKind} | Which family it belongs to |
  * | `label` | `string` | Human-readable label |
  * | `isDefault` | `boolean` | `true` for a built-in type, `false` for a team/user type |
@@ -115,8 +111,6 @@ export const PluginBuildingTypeSummary = z.object({
   label: z.string(),
   isDefault: z.boolean(),
   thickness: z.number(),
-  /** Present for native walls. Pass the whole pin to get/create/update, not its label or bare id. */
-  nativeFamily: PluginNativeWallType.optional(),
 })
 export type PluginBuildingTypeSummary = z.infer<typeof PluginBuildingTypeSummary>
 
@@ -125,7 +119,7 @@ export type PluginBuildingTypeSummary = z.infer<typeof PluginBuildingTypeSummary
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `id` | `string` | Legacy type token or native definition id |
+ * | `id` | `string` | Stable `"<kind>:<name>"` token |
  * | `kind` | {@linkcode PluginBuildingTypeKind} | Which family it belongs to |
  * | `label` | `string` | Human-readable label |
  * | `isDefault` | `boolean` | `true` for a built-in type |
@@ -154,10 +148,9 @@ export type PluginDesignTypesListArgs = z.infer<typeof PluginDesignTypesListArgs
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `typeId` | {@linkcode PluginWallType} | A legacy `"<kind>:<name>"` id or exact `nativeFamily` pin from `design.types.list` |
+ * | `typeId` | `string` | The `"<kind>:<name>"` id from `design.types.list` |
  */
 export const PluginDesignTypesGetArgs = z.object({
-  // Preserve legacy lookup behavior: malformed string ids return null in the host.
-  typeId: z.union([z.string(), PluginNativeWallType]),
+  typeId: z.string(),
 })
 export type PluginDesignTypesGetArgs = z.infer<typeof PluginDesignTypesGetArgs>

package/src/api/design/update/index.ts

@@ -9,10 +9,7 @@ import {
   PluginSpaceUpdateResult,
 } from "../../entity/space"
 import { PluginDesignChangeResult } from "../lock"
-import {
-  MassParametersPatch,
-  type MassParametersRecord,
-} from "../../../massParameters"
+import { MassParametersPatch, type MassParametersRecord } from "../../../massParameters"
 import {
   PluginBuildableEnvelopePolygonVertex,
   PluginBuildableEnvelopeSetbackTier,
@@ -21,12 +18,6 @@ import {
 } from "../../entity/buildableEnvelope"
 import { PluginGridStyleOptions } from "../create/grids"
 import { PluginEntityType } from "../query"
-import { PluginWallType } from "../types"
-import {
-  PluginConstructionType,
-  PluginFamilyValues,
-  type PluginFamilyUpdates,
-} from "../catalog"
 
 /**
  * Sparse property updates for a space. Only provided fields change.
@@ -174,14 +165,13 @@ export type PluginDesignUpdateParametersArgs = z.infer<
  * |---|---|---|
  * | `thickness` | `number`? | Wall thickness, engine units (> 0) |
  * | `height` | `number`? | Wall height, engine units (> 0) |
- * | `type` | {@linkcode PluginWallType}? | Legacy name/id or exact authorized native `{ id, version }` pin from `design.types.list("wall")` |
+ * | `type` | `string`? | Convert the wall to another wall type — a name (or `wall:`-prefixed id) from `design.types.list("wall")` |
  */
 export const PluginWallUpdates = z
   .object({
     thickness: z.number().positive().optional(),
     height: z.number().positive().optional(),
-    type: PluginWallType.optional(),
-    values: PluginFamilyValues.optional(),
+    type: z.string().trim().min(1).optional(),
   })
   .refine((p) => Object.keys(p).length > 0, {
     message: "PluginWallUpdates requires at least one field to change",
@@ -206,8 +196,6 @@ export const PluginSlabUpdates = z
   .object({
     thickness: z.number().positive().optional(),
     overhang: z.number().optional(),
-    type: PluginConstructionType.optional(),
-    values: PluginFamilyValues.optional(),
   })
   .refine((p) => Object.keys(p).length > 0, {
     message: "PluginSlabUpdates requires at least one field to change",
@@ -325,11 +313,6 @@ export type PluginDesignUpdateGridArgs = z.infer<
  *
  * Migrated from the removed `entity.space.{update, updateGeometryFromProfile, bulkUpdate}`.
  * Only provided fields change; each call is undoable. Failures throw (RPC rejects).
- *
- * Native family edits accept `type` and/or sparse `values` from `design.catalog`.
- * Length overrides use mm; dimensional arguments use SU. Contours and axes stay unchanged.
- * Shared/type overrides are refused. A thickness argument must agree with the layer values.
- * Family roof overhang is unsupported; use the native slab path for family overhang edits.
  */
 export abstract class PluginDesignUpdateApi {
   constructor() {}
@@ -583,9 +566,6 @@ export abstract class PluginDesignUpdateApi {
    *   chamfer (the kernel numbers its faces differently): send the twist/taper
    *   keys with `operations: []` first (the message names them), re-select on
    *   the new shape, then send `{ operations }` back.
-   *   Graph-bound spaces accept amount-only extrusion edits. Footprint, twist,
-   *   taper and operation edits require the owning boundary tools, so generated
-   *   walls, junctions and hosted openings remain synchronized.
    * @throws VALIDATION for a key the kind does not have (the message lists the
    *   kind's keys), `kind` or `version` in a partial patch, or a value outside
    *   the constructor's own rules (torus tube ≥ ring, revolution angle ∉
@@ -793,24 +773,6 @@ export abstract class PluginDesignUpdateApi {
     updates: PluginSlabUpdates,
   ): PluginApiReturn<PluginDesignChangeResult>
 
-  /** Replace a native beam family while preserving its authored axis. Values use mm/degrees.
-   * @param component Native beam. @param updates Saved family reference and optional instance values.
-   * @returns Affected component IDs. One undoable operation; unsupported geometry fails before mutation.
-   */
-  public abstract beam(
-    component: ComponentHandle,
-    updates: PluginFamilyUpdates,
-  ): PluginApiReturn<PluginDesignChangeResult>
-
-  /** Replace a native column family while preserving its authored axis. Values use mm/degrees.
-   * @param component Native column. @param updates Saved family reference and optional instance values.
-   * @returns Affected component IDs. One undoable operation; unsupported geometry fails before mutation.
-   */
-  public abstract column(
-    component: ComponentHandle,
-    updates: PluginFamilyUpdates,
-  ): PluginApiReturn<PluginDesignChangeResult>
-
   /**
    * Set a component's **absolute world elevation** — moves it vertically so its
    * base (the bounding-box bottom, world Y) lands at `elevation`. Composed over

package/src/api/design/windows/index.ts

@@ -10,14 +10,13 @@ import { PluginObjectCatalogGroup, PluginObjectCatalogItem } from "../doors"
  * at `design.query.*`. Window targets are {@linkcode ComponentHandle}s.
  *
  * The **catalog** reads (`listCatalogGroups`/`listCatalog`/`getCatalogItem`/`exists`)
- * browse saved hosted window families, keyed by definition ID, and feed design.create.window.
- * They reject if saved definitions cannot be loaded completely. A missing item returns null.
- * The {@linkcode PluginObjectCatalogGroup} / {@linkcode PluginObjectCatalogItem}
+ * browse the placeable window library — plain value records keyed by a library id
+ * (team `_id` or general `fullName`), NOT handles — and feed `design.create.window`.
+ * They are network-backed but carry no `Async` suffix (§6.6) and never throw
+ * (`[]`/`null`). The {@linkcode PluginObjectCatalogGroup} / {@linkcode PluginObjectCatalogItem}
  * DTOs are shared with `design.doors` (defined there, re-exported here).
  *
- * PC-only: dimensions read the evaluated opening and host thickness in SU. Setters
- * write declared width/height parameters, never mesh scale. Missing or derived
- * controls reject. Use design.family.setParameters for sill and other controls.
+ * `getSillHeight` (bounds-derived) and the command-wired `mirror` land in a later pass.
  */
 export abstract class PluginDesignWindowsApi {
   constructor() {}
@@ -41,9 +40,7 @@ export abstract class PluginDesignWindowsApi {
    * if (type) console.log("window type:", type)
    * ```
    */
-  public abstract getType(
-    window: ComponentHandle,
-  ): PluginApiReturn<string | null>
+  public abstract getType(window: ComponentHandle): PluginApiReturn<string | null>
 
   /**
    * Get the width of a window — how wide its opening is along the host wall.
@@ -63,9 +60,7 @@ export abstract class PluginDesignWindowsApi {
    * if (width !== null) console.log("window width:", width)
    * ```
    */
-  public abstract getWidth(
-    window: ComponentHandle,
-  ): PluginApiReturn<number | null>
+  public abstract getWidth(window: ComponentHandle): PluginApiReturn<number | null>
 
   /**
    * Get the height of a window — how tall its opening is on the host wall.
@@ -85,13 +80,12 @@ export abstract class PluginDesignWindowsApi {
    * if (height !== null) console.log("window height:", height)
    * ```
    */
-  public abstract getHeight(
-    window: ComponentHandle,
-  ): PluginApiReturn<number | null>
+  public abstract getHeight(window: ComponentHandle): PluginApiReturn<number | null>
 
   /**
-   * Get evaluated opening width/height and host thickness in Snaptrude units.
-   * The opening can differ from the width/height input parameters.
+   * Get a window's full dimensions in one call — width along the wall, vertical
+   * height, and thickness through the wall — measured in the window's local
+   * oriented space.
    *
    * @param window The window to query
    * @returns The dimensions, or `null`
@@ -110,7 +104,7 @@ export abstract class PluginDesignWindowsApi {
    * ```
    */
   public abstract getDimensions(
-    window: ComponentHandle,
+    window: ComponentHandle
   ): PluginApiReturn<PluginWindowDimensions | null>
 
   /**
@@ -135,7 +129,7 @@ export abstract class PluginDesignWindowsApi {
    */
   public abstract setWidth(
     window: ComponentHandle,
-    width: number,
+    width: number
   ): PluginApiReturn<PluginDesignChangeResult>
 
   /**
@@ -159,7 +153,7 @@ export abstract class PluginDesignWindowsApi {
    */
   public abstract setHeight(
     window: ComponentHandle,
-    height: number,
+    height: number
   ): PluginApiReturn<PluginDesignChangeResult>
 
   /**
@@ -180,9 +174,7 @@ export abstract class PluginDesignWindowsApi {
    * for (const g of groups) console.log(g.dbType, g.label, g.source)
    * ```
    */
-  public abstract listCatalogGroups(): PluginApiReturn<
-    PluginObjectCatalogGroup[]
-  >
+  public abstract listCatalogGroups(): PluginApiReturn<PluginObjectCatalogGroup[]>
 
   /**
    * List the placeable window catalog (team + general libraries), optionally
@@ -204,7 +196,7 @@ export abstract class PluginDesignWindowsApi {
    * ```
    */
   public abstract listCatalog(
-    group?: string,
+    group?: string
   ): PluginApiReturn<PluginObjectCatalogItem[]>
 
   /**
@@ -226,7 +218,7 @@ export abstract class PluginDesignWindowsApi {
    * ```
    */
   public abstract getCatalogItem(
-    id: string,
+    id: string
   ): PluginApiReturn<PluginObjectCatalogItem | null>
 
   /**
@@ -290,9 +282,7 @@ export const PluginDesignWindowSetWidthArgs = z.object({
   window: ComponentHandle,
   width: z.number(),
 })
-export type PluginDesignWindowSetWidthArgs = z.infer<
-  typeof PluginDesignWindowSetWidthArgs
->
+export type PluginDesignWindowSetWidthArgs = z.infer<typeof PluginDesignWindowSetWidthArgs>
 
 /**
  * Arguments for {@linkcode PluginDesignWindowsApi.setHeight}.
@@ -306,9 +296,7 @@ export const PluginDesignWindowSetHeightArgs = z.object({
   window: ComponentHandle,
   height: z.number(),
 })
-export type PluginDesignWindowSetHeightArgs = z.infer<
-  typeof PluginDesignWindowSetHeightArgs
->
+export type PluginDesignWindowSetHeightArgs = z.infer<typeof PluginDesignWindowSetHeightArgs>
 
 // ---------------------------------------------------------------------------
 // catalog (shared DTOs defined in ../doors, re-exported here for symmetry)
@@ -327,9 +315,7 @@ export { PluginObjectCatalogGroup, PluginObjectCatalogItem }
 export const PluginDesignWindowListCatalogArgs = z.object({
   group: z.string().optional(),
 })
-export type PluginDesignWindowListCatalogArgs = z.infer<
-  typeof PluginDesignWindowListCatalogArgs
->
+export type PluginDesignWindowListCatalogArgs = z.infer<typeof PluginDesignWindowListCatalogArgs>
 
 /**
  * Arguments for {@linkcode PluginDesignWindowsApi.getCatalogItem} / {@linkcode PluginDesignWindowsApi.exists}.
@@ -341,11 +327,7 @@ export type PluginDesignWindowListCatalogArgs = z.infer<
 export const PluginDesignWindowGetCatalogItemArgs = z.object({
   id: z.string(),
 })
-export type PluginDesignWindowGetCatalogItemArgs = z.infer<
-  typeof PluginDesignWindowGetCatalogItemArgs
->
+export type PluginDesignWindowGetCatalogItemArgs = z.infer<typeof PluginDesignWindowGetCatalogItemArgs>
 
 export const PluginDesignWindowExistsArgs = PluginDesignWindowGetCatalogItemArgs
-export type PluginDesignWindowExistsArgs = z.infer<
-  typeof PluginDesignWindowExistsArgs
->
+export type PluginDesignWindowExistsArgs = z.infer<typeof PluginDesignWindowExistsArgs>