@snaptrude/plugin-core 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @snaptrude/plugin-core
+
+## 0.2.1
+
+### Patch Changes
+
+- 62c32ee: exposed space geometry and get profile api
+
+## 0.2.0
+
+### Minor Changes
+
+- 4d959a4: Exposed new offset and copy APIs for tools

package/dist/api/entity/space.d.ts

@@ -1,7 +1,7 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../types";
 /**
- * Space (room/mass) management — create, query, and delete spaces.
+ * Space (room/mass) management — create, query, update, and delete spaces.
  *
  * A **space** is a 3D volume representing a room or mass in the
  * Snaptrude scene. Spaces live on a particular story and carry
@@ -85,6 +85,56 @@ export declare abstract class PluginSpaceApi {
      * ```
      */
     abstract createFromProfile({ profile, extrudeHeight, position, }: PluginSpaceCreateFromProfileArgs): PluginApiReturn<PluginSpaceCreateFromProfileResult>;
+    /**
+     * Update a space's BRep and mesh geometry by extruding a 2D profile.
+     *
+     * The {@linkcode PluginSpaceUpdateGeometryFromProfileArgs.profile profile} is
+     * extruded upward (along the Y axis) by
+     * {@linkcode PluginSpaceUpdateGeometryFromProfileArgs.extrudeHeight extrudeHeight}
+     * and applied to the existing space. The space keeps the same `spaceId`,
+     * metadata, department, and transform; only its geometry is replaced.
+     *
+     * Profile points are interpreted in scene coordinates. Profiles returned by
+     * {@linkcode PluginSpaceApi.get} with `"profile"` can be passed back directly;
+     * `"planPoints"` can be used to construct line-only profiles in the same X/Z
+     * plan coordinate space.
+     *
+     * Use {@linkcode PluginProfileApi.fromLinePoints} to quickly build a profile
+     * from a list of points.
+     *
+     * @param args - An object containing:
+     *   - {@linkcode PluginSpaceUpdateGeometryFromProfileArgs.spaceId args.spaceId} —
+     *     The unique space ID to update
+     *   - {@linkcode PluginSpaceUpdateGeometryFromProfileArgs.profile args.profile} —
+     *     A closed {@linkcode PProfile} defining the new floor shape
+     *   - {@linkcode PluginSpaceUpdateGeometryFromProfileArgs.extrudeHeight
+     *     args.extrudeHeight} — New extrusion height in Babylon units
+     * @returns A {@linkcode PluginSpaceUpdateGeometryFromProfileResult} with the
+     *   `spaceId` of the updated space
+     * @throws If the space does not exist, the component is not a space/mass, the
+     *   height is not positive, or the profile cannot create valid geometry
+     *
+     * # Example
+     * ```ts
+     * const { vec3 } = snaptrude.core.math
+     *
+     * const profile = await snaptrude.core.geom.profile.fromLinePoints({
+     *   points: [
+     *     vec3.new(0, 0, 0),
+     *     vec3.new(12, 0, 0),
+     *     vec3.new(12, 0, 6),
+     *     vec3.new(0, 0, 6),
+     *   ],
+     * })
+     *
+     * const { spaceId } = await snaptrude.entity.space.updateGeometryFromProfile({
+     *   spaceId: "some-space-id",
+     *   profile,
+     *   extrudeHeight: 4,
+     * })
+     * ```
+     */
+    abstract updateGeometryFromProfile({ spaceId, profile, extrudeHeight, }: PluginSpaceUpdateGeometryFromProfileArgs): PluginApiReturn<PluginSpaceUpdateGeometryFromProfileResult>;
     /**
      * Get the IDs of all spaces in the current project.
      *
@@ -272,6 +322,68 @@ export declare const PluginSpaceCreateFromProfileResult: z.ZodObject<{
     spaceId: z.ZodString;
 }, z.core.$strip>;
 export type PluginSpaceCreateFromProfileResult = z.infer<typeof PluginSpaceCreateFromProfileResult>;
+/**
+ * Arguments for {@linkcode PluginSpaceApi.updateGeometryFromProfile}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceId` | `string` | Space to update |
+ * | `profile` | {@linkcode PProfile} | Closed 2D profile defining the new floor shape |
+ * | `extrudeHeight` | `number` | New extrusion height in Babylon units |
+ */
+export declare const PluginSpaceUpdateGeometryFromProfileArgs: z.ZodObject<{
+    spaceId: z.ZodString;
+    profile: z.ZodObject<{
+        curves: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            curveType: z.ZodLiteral<"Line">;
+            startPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            endPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            curveType: z.ZodLiteral<"Arc">;
+            startPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            endPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            centrePoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            axis: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>], "curveType">>;
+    }, z.core.$strip>;
+    extrudeHeight: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginSpaceUpdateGeometryFromProfileArgs = z.infer<typeof PluginSpaceUpdateGeometryFromProfileArgs>;
+/**
+ * Result of {@linkcode PluginSpaceApi.updateGeometryFromProfile}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `spaceId` | `string` | Unique ID of the updated space |
+ */
+export declare const PluginSpaceUpdateGeometryFromProfileResult: z.ZodObject<{
+    spaceId: z.ZodString;
+}, z.core.$strip>;
+export type PluginSpaceUpdateGeometryFromProfileResult = z.infer<typeof PluginSpaceUpdateGeometryFromProfileResult>;
 /**
  * Available properties that can be queried on a space.
  *
@@ -309,11 +421,13 @@ export type PluginSpaceCreateFromProfileResult = z.infer<typeof PluginSpaceCreat
  * | Value | Return Type | Description |
  * |---|---|---|
  * | `"planPoints"` | {@linkcode PVec3}`[]` | Bottom outer profile points in world space with `y = 0` (2D plan). No closing duplicate point. |
+ * | `"profile"` | {@linkcode PProfile} | Bottom outer profile in world space, preserving line/arc curve data. |
  */
 export declare const PluginSpaceGetProperty: z.ZodEnum<{
     name: "name";
     departmentId: "departmentId";
     id: "id";
+    profile: "profile";
     position: "position";
     height: "height";
     depth: "depth";
@@ -345,6 +459,7 @@ export declare const PluginSpaceGetArgs: z.ZodObject<{
         name: "name";
         departmentId: "departmentId";
         id: "id";
+        profile: "profile";
         position: "position";
         height: "height";
         depth: "depth";
@@ -452,6 +567,43 @@ export declare const PluginSpaceGetResult: z.ZodObject<{
         y: z.ZodNumber;
         z: z.ZodNumber;
     }, z.core.$strip>>>;
+    profile: z.ZodOptional<z.ZodObject<{
+        curves: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            curveType: z.ZodLiteral<"Line">;
+            startPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            endPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            curveType: z.ZodLiteral<"Arc">;
+            startPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            endPoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            centrePoint: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+            axis: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>], "curveType">>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginSpaceGetResult = z.infer<typeof PluginSpaceGetResult>;
 /**

package/dist/api/entity/space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/api/entity/space.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/api/entity/space.ts"],"names":[],"mappings":"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"}

package/dist/api/index.d.ts

@@ -9,13 +9,13 @@ import { PluginUnitsApi } from "./units";
  *
  * - {@linkcode PluginApi.core} — Math and geometry primitives
  * - {@linkcode PluginApi.entity} — CRUD operations on Snaptrude entities (spaces, stories)
- * - {@linkcode PluginApi.tools} — Selection, transform and material tools
+ * - {@linkcode PluginApi.tools} — Copy, offset, selection, and transform tools
  * - {@linkcode PluginApi.units} — Unit conversion utilities
  */
 export declare abstract class PluginApi {
     /** Core math and geometry primitives. See {@linkcode PluginCoreApi}. */
     abstract core: PluginCoreApi;
-    /** Selection, transform and material tools. See {@linkcode PluginToolsApi}. */
+    /** Copy, offset, selection, and transform tools. See {@linkcode PluginToolsApi}. */
     abstract tools: PluginToolsApi;
     /** CRUD operations on Snaptrude entities. See {@linkcode PluginEntityApi}. */
     abstract entity: PluginEntityApi;

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExC;;;;;;;;;GASG;AACH,8BAAsB,SAAS;IAC7B,wEAAwE;IACxE,SAAgB,IAAI,EAAE,aAAa,CAAA;IACnC,+EAA+E;IAC/E,SAAgB,KAAK,EAAE,cAAc,CAAA;IACrC,8EAA8E;IAC9E,SAAgB,MAAM,EAAE,eAAe,CAAA;IACvC,iEAAiE;IACjE,SAAgB,KAAK,EAAE,cAAc,CAAA;;CAGtC;AAED,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExC;;;;;;;;;GASG;AACH,8BAAsB,SAAS;IAC7B,wEAAwE;IACxE,SAAgB,IAAI,EAAE,aAAa,CAAA;IACnC,oFAAoF;IACpF,SAAgB,KAAK,EAAE,cAAc,CAAA;IACrC,8EAA8E;IAC9E,SAAgB,MAAM,EAAE,eAAe,CAAA;IACvC,iEAAiE;IACjE,SAAgB,KAAK,EAAE,cAAc,CAAA;;CAGtC;AAED,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/dist/api/tools/copy.d.ts

@@ -0,0 +1,59 @@
+import * as z from "zod";
+import type { ComponentId } from "../../types";
+/**
+ * Copy mode for `snaptrude.tools.copy`.
+ *
+ * | Value | Description |
+ * |---|---|
+ * | `"instance"` | Create instanced copies where possible |
+ * | `"unique"` | Create independent geometry copies |
+ */
+export declare const PluginCopyMode: z.ZodEnum<{
+    instance: "instance";
+    unique: "unique";
+}>;
+export type PluginCopyMode = z.infer<typeof PluginCopyMode>;
+/**
+ * Arguments for `snaptrude.tools.copy`.
+ *
+ * Creates one or more copies for each component in `componentIds`. Copy `i` is
+ * offset by `displacement * i`, where `i` starts at `1`. Source positions are
+ * preserved. In `"instance"` mode, a unique source mesh can be replaced by an
+ * instance at the same position so the source and copied objects remain in the
+ * same instance family. The created copy stack becomes the active editor
+ * selection, matching the native paste workflow.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `componentIds` | `string[]` | Component IDs to copy |
+ * | `displacement` | {@linkcode PVec3} | Offset applied to each copy in Babylon units |
+ * | `count` | `number` | Number of copies per component. Defaults to `1` |
+ * | `copyMode` | {@linkcode PluginCopyMode} | `"instance"` or `"unique"`. Defaults to `"instance"` |
+ */
+export declare const PluginCopyArgs: z.ZodObject<{
+    componentIds: z.ZodArray<z.ZodString>;
+    displacement: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>;
+    count: z.ZodOptional<z.ZodNumber>;
+    copyMode: z.ZodOptional<z.ZodEnum<{
+        instance: "instance";
+        unique: "unique";
+    }>>;
+}, z.core.$strip>;
+export type PluginCopyArgs = z.infer<typeof PluginCopyArgs>;
+/**
+ * Result of `snaptrude.tools.copy`.
+ *
+ * Returned IDs are Snaptrude component IDs for the newly created copies, not
+ * Babylon mesh IDs.
+ */
+export declare const PluginCopyResult: z.ZodObject<{
+    copiedIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginCopyResult = {
+    copiedIds: ComponentId[];
+};
+//# sourceMappingURL=copy.d.ts.map

package/dist/api/tools/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/api/tools/copy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;EAAiC,CAAA;AAE5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAKzB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;iBAE3B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,WAAW,EAAE,CAAA;CACzB,CAAA"}

package/dist/api/tools/index.d.ts

@@ -1,22 +1,29 @@
-import { PluginMaterialApi } from "./material";
 import { PluginSelectionApi } from "./selection";
 import { PluginTransformApi } from "./transform";
+import type { PluginApiReturn } from "../../types";
+import type { PluginCopyArgs, PluginCopyResult } from "./copy";
+import type { PluginOffsetArgs, PluginOffsetResult } from "./offset";
 /**
  * Snaptrude editor tools for querying and manipulating scene components.
  *
  * - {@linkcode PluginToolsApi.selection} — Query the current user selection
  * - {@linkcode PluginToolsApi.transform} — Move and rotate components
+ * - {@linkcode PluginToolsApi.copy} — Copy components
+ * - {@linkcode PluginToolsApi.offset} — Offset or split component profiles
  */
 export declare abstract class PluginToolsApi {
     /** Query the current selection. See {@linkcode PluginSelectionApi}. */
     abstract selection: PluginSelectionApi;
     /** Move and rotate components. See {@linkcode PluginTransformApi}. */
     abstract transform: PluginTransformApi;
-    /** Apply materials to the current user selection in the Snaptrude editor or passed component ids if any. See {@linkcode PluginMaterialApi}. */
-    abstract material: PluginMaterialApi;
+    /** Copy components by ID. See {@linkcode PluginCopyArgs}. */
+    abstract copy(args: PluginCopyArgs): PluginApiReturn<PluginCopyResult>;
+    /** Offset or split a component profile. See {@linkcode PluginOffsetArgs}. */
+    abstract offset(args: PluginOffsetArgs): PluginApiReturn<PluginOffsetResult>;
     constructor();
 }
+export * from "./copy";
+export * from "./offset";
 export * from "./selection";
 export * from "./transform";
-export * from "./material";
 //# sourceMappingURL=index.d.ts.map

package/dist/api/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;GAKG;AACH,8BAAsB,cAAc;IAClC,uEAAuE;IACvE,SAAgB,SAAS,EAAE,kBAAkB,CAAA;IAC7C,sEAAsE;IACtE,SAAgB,SAAS,EAAE,kBAAkB,CAAA;IAC7C,+IAA+I;IAC/I,SAAgB,QAAQ,EAAE,iBAAiB,CAAA;;CAG5C;AAED,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEpE;;;;;;;GAOG;AACH,8BAAsB,cAAc;IAClC,uEAAuE;IACvE,SAAgB,SAAS,EAAE,kBAAkB,CAAA;IAC7C,sEAAsE;IACtE,SAAgB,SAAS,EAAE,kBAAkB,CAAA;IAE7C,6DAA6D;aAC7C,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,CAAC,gBAAgB,CAAC;IAE7E,6EAA6E;aAC7D,MAAM,CACpB,IAAI,EAAE,gBAAgB,GACrB,eAAe,CAAC,kBAAkB,CAAC;;CAGvC;AAED,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/api/tools/offset.d.ts

@@ -0,0 +1,43 @@
+import * as z from "zod";
+import type { ComponentId } from "../../types";
+/**
+ * Arguments for `snaptrude.tools.offset`.
+ *
+ * Runs Snaptrude's offset/split operation on the top profile of a scene
+ * component. A positive distance offsets outward from the selected profile;
+ * a negative distance offsets inward. If `profilePickPoint` is omitted, the
+ * outer top profile is used. If `profilePickPoint` is provided, the nearest top
+ * contour profile to that point is used, matching the interactive offset tool's
+ * pick behavior.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `componentId` | `string` | Component ID to offset |
+ * | `distance` | `number` | Signed offset distance in Snaptrude units |
+ * | `profilePickPoint` | {@linkcode PVec3} | Optional point used to choose a top contour profile |
+ */
+export declare const PluginOffsetArgs: z.ZodObject<{
+    componentId: z.ZodString;
+    distance: z.ZodNumber;
+    profilePickPoint: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginOffsetArgs = z.infer<typeof PluginOffsetArgs>;
+/**
+ * Result of `snaptrude.tools.offset`.
+ *
+ * `createdIds` are the components created by the offset operation. `deletedIds`
+ * are components removed by split-style offsets.
+ */
+export declare const PluginOffsetResult: z.ZodObject<{
+    createdIds: z.ZodArray<z.ZodString>;
+    deletedIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginOffsetResult = {
+    createdIds: ComponentId[];
+    deletedIds: ComponentId[];
+};
+//# sourceMappingURL=offset.d.ts.map

package/dist/api/tools/offset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset.d.ts","sourceRoot":"","sources":["../../../src/api/tools/offset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;iBAI3B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,WAAW,EAAE,CAAA;IACzB,UAAU,EAAE,WAAW,EAAE,CAAA;CAC1B,CAAA"}

package/dist/index.cjs

@@ -39,6 +39,9 @@ __export(index_exports, {
   PVec3: () => PVec3,
   PluginApi: () => PluginApi,
   PluginArcApi: () => PluginArcApi,
+  PluginCopyArgs: () => PluginCopyArgs,
+  PluginCopyMode: () => PluginCopyMode,
+  PluginCopyResult: () => PluginCopyResult,
   PluginCoreApi: () => PluginCoreApi,
   PluginCurveApi: () => PluginCurveApi,
   PluginDepartmentApi: () => PluginDepartmentApi,
@@ -51,10 +54,10 @@ __export(index_exports, {
   PluginGeomApi: () => PluginGeomApi,
   PluginLineApi: () => PluginLineApi,
   PluginMassType: () => PluginMassType,
-  PluginMaterialApi: () => PluginMaterialApi,
-  PluginMaterialArgs: () => PluginMaterialArgs,
   PluginMathApi: () => PluginMathApi,
   PluginMoveArgs: () => PluginMoveArgs,
+  PluginOffsetArgs: () => PluginOffsetArgs,
+  PluginOffsetResult: () => PluginOffsetResult,
   PluginProfileApi: () => PluginProfileApi,
   PluginProfileFromLinePointsArgs: () => PluginProfileFromLinePointsArgs,
   PluginQuatApi: () => PluginQuatApi,
@@ -81,6 +84,8 @@ __export(index_exports, {
   PluginSpaceGetResult: () => PluginSpaceGetResult,
   PluginSpaceType: () => PluginSpaceType,
   PluginSpaceUpdateArgs: () => PluginSpaceUpdateArgs,
+  PluginSpaceUpdateGeometryFromProfileArgs: () => PluginSpaceUpdateGeometryFromProfileArgs,
+  PluginSpaceUpdateGeometryFromProfileResult: () => PluginSpaceUpdateGeometryFromProfileResult,
   PluginSpaceUpdateResult: () => PluginSpaceUpdateResult,
   PluginStoryApi: () => PluginStoryApi,
   PluginStoryCreateArgs: () => PluginStoryCreateArgs,
@@ -122,8 +127,8 @@ var PluginVec3Api = class {
    * // { x: 1, y: 2, z: 3 }
    * ```
    */
-  new(x, y, z15) {
-    return { x, y, z: z15 };
+  new(x, y, z16) {
+    return { x, y, z: z16 };
   }
   /**
    * Add two vectors component-wise.
@@ -301,8 +306,8 @@ var PluginQuatApi = class {
    * @param w - The W (scalar) component
    * @returns A new {@linkcode PQuat}
    */
-  new(x, y, z15, w) {
-    return { x, y, z: z15, w };
+  new(x, y, z16, w) {
+    return { x, y, z: z16, w };
   }
   /**
    * Create an identity quaternion representing no rotation.
@@ -346,13 +351,13 @@ var PluginQuatApi = class {
    * @param z - Rotation around Z axis in **radians**
    * @returns A new {@linkcode PQuat}
    */
-  fromEuler(x, y, z15) {
+  fromEuler(x, y, z16) {
     const cx = Math.cos(x / 2);
     const sx = Math.sin(x / 2);
     const cy = Math.cos(y / 2);
     const sy = Math.sin(y / 2);
-    const cz = Math.cos(z15 / 2);
-    const sz = Math.sin(z15 / 2);
+    const cz = Math.cos(z16 / 2);
+    const sz = Math.sin(z16 / 2);
     return {
       x: sx * cy * cz + cx * sy * sz,
       y: cx * sy * cz - sx * cy * sz,
@@ -759,6 +764,14 @@ var PluginSpaceCreateFromProfileArgs = z9.object({
 var PluginSpaceCreateFromProfileResult = z9.object({
   spaceId: z9.string()
 });
+var PluginSpaceUpdateGeometryFromProfileArgs = z9.object({
+  spaceId: z9.string(),
+  profile: PProfile,
+  extrudeHeight: z9.number()
+});
+var PluginSpaceUpdateGeometryFromProfileResult = z9.object({
+  spaceId: z9.string()
+});
 var PluginSpaceGetProperty = z9.enum([
   // Basic
   "id",
@@ -782,7 +795,8 @@ var PluginSpaceGetProperty = z9.enum([
   "rotation",
   "rotationQuaternion",
   // Derived from brep
-  "planPoints"
+  "planPoints",
+  "profile"
 ]);
 var PluginSpaceGetArgs = z9.object({
   spaceId: z9.string(),
@@ -823,7 +837,8 @@ var PluginSpaceGetResult = z9.object({
   rotation: PVec3,
   rotationQuaternion: PQuat.nullable(),
   // Derived from brep
-  planPoints: z9.array(PVec3)
+  planPoints: z9.array(PVec3),
+  profile: PProfile
 }).partial();
 var PluginSpaceGetAllResult = z9.object({
   spacesIds: z9.array(z9.string())
@@ -934,54 +949,58 @@ var PluginEntityApi = class {
   }
 };
 
-// src/api/tools/selection.ts
+// src/api/tools/copy.ts
 var z11 = __toESM(require("zod"), 1);
+var PluginCopyMode = z11.enum(["instance", "unique"]);
+var PluginCopyArgs = z11.object({
+  componentIds: z11.array(z11.string()).min(1),
+  displacement: PVec3,
+  count: z11.number().int().positive().optional(),
+  copyMode: PluginCopyMode.optional()
+});
+var PluginCopyResult = z11.object({
+  copiedIds: z11.array(z11.string())
+});
+
+// src/api/tools/offset.ts
+var z12 = __toESM(require("zod"), 1);
+var PluginOffsetArgs = z12.object({
+  componentId: z12.string().min(1),
+  distance: z12.number(),
+  profilePickPoint: PVec3.optional()
+});
+var PluginOffsetResult = z12.object({
+  createdIds: z12.array(z12.string()),
+  deletedIds: z12.array(z12.string())
+});
+
+// src/api/tools/selection.ts
+var z13 = __toESM(require("zod"), 1);
 var PluginSelectionApi = class {
   constructor() {
   }
 };
-var PluginSelectionGetResult = z11.object({
-  selected: z11.array(z11.string())
+var PluginSelectionGetResult = z13.object({
+  selected: z13.array(z13.string())
 });
 
 // src/api/tools/transform.ts
-var z12 = __toESM(require("zod"), 1);
+var z14 = __toESM(require("zod"), 1);
 var PluginTransformApi = class {
   constructor() {
   }
 };
-var PluginMoveArgs = z12.object({
-  componentIds: z12.array(z12.string()),
+var PluginMoveArgs = z14.object({
+  componentIds: z14.array(z14.string()),
   displacement: PVec3
 });
-var PluginRotateArgs = z12.object({
-  componentIds: z12.array(z12.string()),
-  angle: z12.number(),
+var PluginRotateArgs = z14.object({
+  componentIds: z14.array(z14.string()),
+  angle: z14.number(),
   axis: PVec3,
   pivot: PVec3
 });
 
-// src/api/tools/material.ts
-var z13 = __toESM(require("zod"), 1);
-var PluginMaterialApi = class {
-  constructor() {
-  }
-};
-var DEFAULT_MATERIALS = /* @__PURE__ */ ((DEFAULT_MATERIALS2) => {
-  DEFAULT_MATERIALS2["GLASS"] = "glass";
-  DEFAULT_MATERIALS2["WOOD"] = "wood";
-  DEFAULT_MATERIALS2["METAL"] = "metal";
-  DEFAULT_MATERIALS2["STONE"] = "stone";
-  DEFAULT_MATERIALS2["TILES"] = "tiles";
-  DEFAULT_MATERIALS2["CONCRETE"] = "concrete";
-  DEFAULT_MATERIALS2["BRICK"] = "brick";
-  return DEFAULT_MATERIALS2;
-})(DEFAULT_MATERIALS || {});
-var PluginMaterialArgs = z13.object({
-  materialName: z13.enum(Object.values(DEFAULT_MATERIALS)),
-  componentIds: z13.array(z13.string())
-});
-
 // src/api/tools/index.ts
 var PluginToolsApi = class {
   constructor() {
@@ -989,12 +1008,12 @@ var PluginToolsApi = class {
 };
 
 // src/api/units/index.ts
-var z14 = __toESM(require("zod"), 1);
+var z15 = __toESM(require("zod"), 1);
 var PluginUnitsApi = class {
   constructor() {
   }
 };
-var PUnitType = z14.enum([
+var PUnitType = z15.enum([
   "meters",
   "feet-inches",
   "inches",
@@ -1003,21 +1022,21 @@ var PUnitType = z14.enum([
   "kilometers",
   "miles"
 ]);
-var PluginUnitsConvertFromArgs = z14.object({
+var PluginUnitsConvertFromArgs = z15.object({
   unit: PUnitType,
-  value: z14.number(),
-  degree: z14.number().int().min(1).max(3).optional()
+  value: z15.number(),
+  degree: z15.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertFromResult = z14.object({
-  value: z14.number()
+var PluginUnitsConvertFromResult = z15.object({
+  value: z15.number()
 });
-var PluginUnitsConvertToArgs = z14.object({
+var PluginUnitsConvertToArgs = z15.object({
   unit: PUnitType,
-  value: z14.number(),
-  degree: z14.number().int().min(1).max(3).optional()
+  value: z15.number(),
+  degree: z15.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertToResult = z14.object({
-  value: z14.number()
+var PluginUnitsConvertToResult = z15.object({
+  value: z15.number()
 });
 
 // src/api/index.ts
@@ -1036,6 +1055,9 @@ var PluginApi = class {
   PVec3,
   PluginApi,
   PluginArcApi,
+  PluginCopyArgs,
+  PluginCopyMode,
+  PluginCopyResult,
   PluginCoreApi,
   PluginCurveApi,
   PluginDepartmentApi,
@@ -1048,10 +1070,10 @@ var PluginApi = class {
   PluginGeomApi,
   PluginLineApi,
   PluginMassType,
-  PluginMaterialApi,
-  PluginMaterialArgs,
   PluginMathApi,
   PluginMoveArgs,
+  PluginOffsetArgs,
+  PluginOffsetResult,
   PluginProfileApi,
   PluginProfileFromLinePointsArgs,
   PluginQuatApi,
@@ -1078,6 +1100,8 @@ var PluginApi = class {
   PluginSpaceGetResult,
   PluginSpaceType,
   PluginSpaceUpdateArgs,
+  PluginSpaceUpdateGeometryFromProfileArgs,
+  PluginSpaceUpdateGeometryFromProfileResult,
   PluginSpaceUpdateResult,
   PluginStoryApi,
   PluginStoryCreateArgs,