@snaptrude/plugin-core 0.1.3 → 0.3.0

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, material 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, material 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,6FAA6F;IAC7F,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,11 +1,16 @@
 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}. */
@@ -14,8 +19,14 @@ export declare abstract class PluginToolsApi {
     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";

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,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,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;IAC7C,+IAA+I;IAC/I,SAAgB,QAAQ,EAAE,iBAAiB,CAAA;IAE3C,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;AAC3B,cAAc,YAAY,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,
@@ -55,6 +58,8 @@ __export(index_exports, {
   PluginMaterialArgs: () => PluginMaterialArgs,
   PluginMathApi: () => PluginMathApi,
   PluginMoveArgs: () => PluginMoveArgs,
+  PluginOffsetArgs: () => PluginOffsetArgs,
+  PluginOffsetResult: () => PluginOffsetResult,
   PluginProfileApi: () => PluginProfileApi,
   PluginProfileFromLinePointsArgs: () => PluginProfileFromLinePointsArgs,
   PluginQuatApi: () => PluginQuatApi,
@@ -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, z17) {
+    return { x, y, z: z17 };
   }
   /**
    * 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, z17, w) {
+    return { x, y, z: z17, 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, z17) {
     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(z17 / 2);
+    const sz = Math.sin(z17 / 2);
     return {
       x: sx * cy * cz + cx * sy * sz,
       y: cx * sy * cz - sx * cy * sz,
@@ -934,35 +939,60 @@ 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 z15 = __toESM(require("zod"), 1);
 var PluginMaterialApi = class {
   constructor() {
   }
@@ -977,9 +1007,9 @@ var DEFAULT_MATERIALS = /* @__PURE__ */ ((DEFAULT_MATERIALS2) => {
   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())
+var PluginMaterialArgs = z15.object({
+  materialName: z15.enum(Object.values(DEFAULT_MATERIALS)),
+  componentIds: z15.array(z15.string())
 });
 
 // src/api/tools/index.ts
@@ -989,12 +1019,12 @@ var PluginToolsApi = class {
 };
 
 // src/api/units/index.ts
-var z14 = __toESM(require("zod"), 1);
+var z16 = __toESM(require("zod"), 1);
 var PluginUnitsApi = class {
   constructor() {
   }
 };
-var PUnitType = z14.enum([
+var PUnitType = z16.enum([
   "meters",
   "feet-inches",
   "inches",
@@ -1003,21 +1033,21 @@ var PUnitType = z14.enum([
   "kilometers",
   "miles"
 ]);
-var PluginUnitsConvertFromArgs = z14.object({
+var PluginUnitsConvertFromArgs = z16.object({
   unit: PUnitType,
-  value: z14.number(),
-  degree: z14.number().int().min(1).max(3).optional()
+  value: z16.number(),
+  degree: z16.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertFromResult = z14.object({
-  value: z14.number()
+var PluginUnitsConvertFromResult = z16.object({
+  value: z16.number()
 });
-var PluginUnitsConvertToArgs = z14.object({
+var PluginUnitsConvertToArgs = z16.object({
   unit: PUnitType,
-  value: z14.number(),
-  degree: z14.number().int().min(1).max(3).optional()
+  value: z16.number(),
+  degree: z16.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertToResult = z14.object({
-  value: z14.number()
+var PluginUnitsConvertToResult = z16.object({
+  value: z16.number()
 });
 
 // src/api/index.ts
@@ -1036,6 +1066,9 @@ var PluginApi = class {
   PVec3,
   PluginApi,
   PluginArcApi,
+  PluginCopyArgs,
+  PluginCopyMode,
+  PluginCopyResult,
   PluginCoreApi,
   PluginCurveApi,
   PluginDepartmentApi,
@@ -1052,6 +1085,8 @@ var PluginApi = class {
   PluginMaterialArgs,
   PluginMathApi,
   PluginMoveArgs,
+  PluginOffsetArgs,
+  PluginOffsetResult,
   PluginProfileApi,
   PluginProfileFromLinePointsArgs,
   PluginQuatApi,