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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snaptrude/plugin-core",
-  "version": "0.9.16-networks-20261012.1",
+  "version": "0.9.17",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/scripts/generate-manifest.mjs

@@ -115,11 +115,6 @@ export function buildManifest({ includeOptional = false } = {}) {
     const cls = classes.get(className)
     if (!cls) return
 
-    // Domain network namespaces inherit their transport methods. Include these
-    // leaves so discovery exposes the same API as the generic worker proxy.
-    const base = cls.getExtends()?.getExpression().getText()
-    if (base && classes.has(base)) walk(base, pathPrefix)
-
     // Leaf methods on this namespace.
     for (const method of cls.getMethods()) {
       const name = method.getName()

package/src/api/core/camera/index.ts

@@ -17,11 +17,6 @@ import { Vec3Components, Vec3Handle } from "../../../handles"
  * Positions are world coordinates in internal `babylon` units (1 unit =
  * 0.254 m, Y up); yaw is degrees clockwise from +z seen from above, pitch is
  * degrees above level.
- *
- * While Present mode is open these calls set the Design frame a view saved in
- * Present (`presentation.views.create`) is taken from; they never move the
- * Present sheet canvas. To pan, zoom or screenshot the Present canvas, use
- * {@linkcode PluginPresentationCameraApi} (`presentation.camera`).
  */
 export abstract class PluginCameraApi {
   constructor() {}
@@ -30,10 +25,6 @@ export abstract class PluginCameraApi {
    * Point the camera: place its eye at `eye` looking toward `target` (world
    * coordinates, internal `babylon` units). View-state only — not undoable.
    *
-   * 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 eye - Camera position as a {@linkcode Vec3Handle}
    * @param target - Point the camera looks at as a {@linkcode Vec3Handle}
    * @returns `true` once the camera has been positioned.
@@ -60,10 +51,6 @@ export abstract class PluginCameraApi {
    * perspective) view. Mirrors the canvas view menu. View-state only — not
    * undoable. The orthographic presets exit 2D mode first if needed.
    *
-   * 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 view - The standard view to snap to ({@linkcode PluginStandardView})
    * @returns `true` once the view has been applied.
    *
@@ -104,10 +91,6 @@ export abstract class PluginCameraApi {
    * 2D/3D toggle: `3d` enters the isometric perspective view, `2d` drops to the
    * orthographic plan of the active storey. View-state only — not undoable.
    *
-   * 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 mode - `"2d"` or `"3d"` ({@linkcode PluginCameraMode})
    * @returns `true` once the mode switch has been requested.
    *
@@ -152,10 +135,6 @@ export abstract class PluginCameraApi {
    * `"orthographic"` is accepted as a no-op, while `"perspective"` is
    * rejected — switch to 3D first via `setMode("3d")`.
    *
-   * 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 projection - `"perspective"` or `"orthographic"` ({@linkcode PluginCameraProjection})
    * @returns `true` once the projection has been applied.
    *
@@ -179,10 +158,6 @@ export abstract class PluginCameraApi {
    * action. View-state only — not undoable. Canonical home of the zoom-extents
    * read (the deprecated `core.zoom.extents`).
    *
-   * 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.
-   *
    * @returns `true` once the camera has been framed to the scene.
    *
    * @examplePrompt Zoom out so I can see the whole model
@@ -202,10 +177,6 @@ export abstract class PluginCameraApi {
    * undoable. Canonical home of the zoom-to-selection read (the deprecated
    * `core.zoom.selection`).
    *
-   * 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.
-   *
    * @returns `true` if there was a selection to frame; `false` if nothing is
    *   selected (no-op).
    *

package/src/api/core/zoom/index.ts

@@ -5,11 +5,6 @@ import { PluginApiReturn } from "../../../types"
  *
  * Frame the viewport camera onto scene geometry — mirrors the canvas zoom menu
  * ("Zoom extents" / "Zoom to selection"). Accessed via `snaptrude.core.zoom`.
- *
- * While Present mode is open these calls set the Design frame a view saved in
- * Present (`presentation.views.create`) is taken from; they never move the
- * Present sheet canvas. To pan, zoom or screenshot the Present canvas, use
- * {@linkcode PluginPresentationCameraApi} (`presentation.camera`).
  */
 export abstract class PluginZoomApi {
   constructor() {}
@@ -17,10 +12,6 @@ export abstract class PluginZoomApi {
   /**
    * Zoom (fit) the camera to all geometry in the scene — the "zoom extents" action.
    *
-   * 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.
-   *
    * @returns `true` once the camera has been framed to the scene.
    *
    * @examplePrompt Zoom out so I can see the whole model
@@ -41,10 +32,6 @@ export abstract class PluginZoomApi {
   /**
    * Zoom (fit) the camera to the current selection.
    *
-   * 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.
-   *
    * @returns `true` if there was a selection to frame; `false` if nothing is
    *   selected (no-op).
    *

package/src/api/design/create/bulk-items.ts

@@ -1,8 +1,6 @@
 import * as z from "zod"
 import { ContourHandle, ProfileHandle, Vec3Handle } from "../../../handles"
 import { PluginOpeningBaseOptions } from "./opening-fields"
-import { PluginWallType } from "../types"
-import { PluginFamilyValues } from "../catalog"
 
 /**
  * Maximum items per bulk `design.create.*` call. A bounded request keeps
@@ -90,7 +88,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` | {@linkcode PluginWallType}? | Legacy name/id or exact native `{ id, version }` pin from `design.types.list("wall")` (default generic) |
+ * | `wallType` | `string`? | Wall type name from `design.types.list("wall")` — layers/material/thickness defaults (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) |
  */
@@ -98,11 +96,9 @@ export const PluginCreateWallRunItem = z.object({
   profile: ProfileHandle,
   height: z.number().optional(),
   thickness: z.number().optional(),
-  wallType: PluginWallType.optional(),
+  wallType: z.string().min(1).optional(),
   storey: z.number().int().optional(),
   topProfiles: z.array(PluginWallTopProfile.nullable()).optional(),
-  /** Optional family overrides in mm/degrees. Host length/height stay geometry inputs. */
-  values: PluginFamilyValues.optional(),
 })
 export type PluginCreateWallRunItem = z.infer<typeof PluginCreateWallRunItem>
 
@@ -147,23 +143,22 @@ export type PluginCreateFloorItems = z.infer<typeof PluginCreateFloorItems>
 
 /**
  * One door to place via {@linkcode PluginDesignCreateApi.doors} — the same
- * fields as a `"door"` {@linkcode PluginDesignCreateOpeningOptions}.
- * Values are evaluated before cutting. Numeric lengths use SU; unit strings
- * are accepted in values. `facing` selects local +Z; `hinge` sets the declared
- * hand enum (left = local -X, right = +X). Both are world points.
+ * fields as a `"door"` {@linkcode PluginDesignCreateOpeningOptions}, so the
+ * size overrides singular {@linkcode PluginDesignCreateApi.door} lacks are
+ * available per item. `facing` and `hinge` are WORLD POINTS, not directions:
+ * `facing` on the side of the wall the door swings open to, `hinge` near the
+ * jamb it is hinged on. Rejects unknown fields.
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `familyId` | `string` | Hosted door family definition ID |
- * | `version` | `number`? | Exact version; newest known by default |
- * | `values` | `Record<string, number \| string>`? | Authored parameter overrides |
+ * | `catalogId` | `string` | Library id: team `_id` or general `fullName` |
  * | `hostWall` | {@linkcode ComponentHandle} | The wall to host the door |
  * | `position` | {@linkcode Vec3Handle} | World point projected onto the wall |
  * | `facing` | {@linkcode Vec3Handle}? | World point on the side the door swings open to (default engine-chosen) |
- * | `hinge` | {@linkcode Vec3Handle}? | World point near the hinged jamb; requires hand control |
+ * | `hinge` | {@linkcode Vec3Handle}? | World point near the jamb the door is hinged on (default the catalog item's authored side) |
  * | `label` | `string`? | Instance name (optional) |
- * | `width` | `number`? | Declared width parameter (SU, > 0), not evaluated hole width |
- * | `height` | `number`? | Declared height parameter (SU, > 0) |
+ * | `width` | `number`? | Width override (Snaptrude units, > 0; default the catalog item's) |
+ * | `height` | `number`? | Height override (Snaptrude units, > 0; default the catalog item's) |
  */
 export const PluginCreateDoorItem = z
   .object({ ...PluginOpeningBaseOptions })
@@ -188,17 +183,15 @@ export type PluginCreateDoorItems = z.infer<typeof PluginCreateDoorItems>
  *
  * | Property | Type | Description |
  * |---|---|---|
- * | `familyId` | `string` | Hosted window family definition ID |
- * | `version` | `number`? | Exact version; newest known by default |
- * | `values` | `Record<string, number \| string>`? | Authored parameter overrides; numeric lengths use SU |
+ * | `catalogId` | `string` | Library id: team `_id` or general `fullName` |
  * | `hostWall` | {@linkcode ComponentHandle} | The wall to host the window |
  * | `position` | {@linkcode Vec3Handle} | World point projected onto the wall |
  * | `facing` | {@linkcode Vec3Handle}? | World point on the side the window opens to (default engine-chosen) |
- * | `hinge` | {@linkcode Vec3Handle}? | World point near the hinged jamb; requires hand control |
+ * | `hinge` | {@linkcode Vec3Handle}? | World point near the jamb the window is hinged on (default the catalog item's authored side) |
  * | `label` | `string`? | Instance name (optional) |
- * | `width` | `number`? | Declared width parameter (SU, > 0), not evaluated hole width |
- * | `height` | `number`? | Declared height parameter (SU, > 0) |
- * | `sillHeight` | `number`? | Declared sill parameter (SU, ≥ 0); position Y is ignored |
+ * | `width` | `number`? | Width override (Snaptrude units, > 0; default the catalog item's) |
+ * | `height` | `number`? | Height override (Snaptrude units, > 0; default the catalog item's) |
+ * | `sillHeight` | `number`? | Wall base to window bottom (Snaptrude units, ≥ 0; default the catalog item's) |
  */
 export const PluginCreateWindowItem = z
   .object({