@snaptrude/plugin-core 0.2.0 → 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} — Copy, offset, selection, and transform 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;
-    /** Copy, offset, selection, and transform 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,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"}
+{"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/index.d.ts

@@ -1,3 +1,4 @@
+import { PluginMaterialApi } from "./material";
 import { PluginSelectionApi } from "./selection";
 import { PluginTransformApi } from "./transform";
 import type { PluginApiReturn } from "../../types";
@@ -16,6 +17,8 @@ export declare abstract class PluginToolsApi {
     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}. */
@@ -26,4 +29,5 @@ 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,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"}
+{"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/material.d.ts

@@ -0,0 +1,51 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+/**
+ * Apply materials to the current user selection in the Snaptrude editor or passed component ids if any.
+ *
+ * Accessed via `snaptrude.tools.material`.
+ */
+export declare abstract class PluginMaterialApi {
+    constructor();
+    /**
+     * Apply materials to the current user selection in the Snaptrude editor or passed component ids if any.
+     *
+     * @param args - An object containing:
+     *   - {@linkcode PluginMaterialArgs.materialName args.materialName} — Material to apply
+     *   - {@linkcode PluginMaterialArgs.componentIds args.componentIds} — Array of component
+     *     ID strings to apply materials to if provided, if not provided, the current user selection will be used
+     */
+    abstract apply({ materialName, componentIds, }: PluginMaterialArgs): PluginApiReturn<void>;
+}
+declare enum DEFAULT_MATERIALS {
+    GLASS = "glass",
+    WOOD = "wood",
+    METAL = "metal",
+    STONE = "stone",
+    TILES = "tiles",
+    CONCRETE = "concrete",
+    BRICK = "brick"
+}
+/**
+ * Arguments for {@linkcode PluginMaterialApi.apply}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `materialName` | `DEFAULT_MATERIALS` | Material to apply |
+ * | `componentIds` | `string[]` | Component IDs to apply materials to if provided |
+ */
+export declare const PluginMaterialArgs: z.ZodObject<{
+    materialName: z.ZodEnum<{
+        glass: DEFAULT_MATERIALS.GLASS;
+        wood: DEFAULT_MATERIALS.WOOD;
+        metal: DEFAULT_MATERIALS.METAL;
+        stone: DEFAULT_MATERIALS.STONE;
+        tiles: DEFAULT_MATERIALS.TILES;
+        concrete: DEFAULT_MATERIALS.CONCRETE;
+        brick: DEFAULT_MATERIALS.BRICK;
+    }>;
+    componentIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginMaterialArgs = z.infer<typeof PluginMaterialArgs>;
+export {};
+//# sourceMappingURL=material.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../../src/api/tools/material.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;GAIG;AACH,8BAAsB,iBAAiB;;IAGrC;;;;;;;OAOG;aACa,KAAK,CAAC,EACpB,YAAY,EACZ,YAAY,GACb,EAAE,kBAAkB,GAAG,eAAe,CAAC,IAAI,CAAC;CAC9C;AAED,aAAK,iBAAiB;IACpB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,KAAK,UAAU;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAG7B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/index.cjs

@@ -54,6 +54,8 @@ __export(index_exports, {
   PluginGeomApi: () => PluginGeomApi,
   PluginLineApi: () => PluginLineApi,
   PluginMassType: () => PluginMassType,
+  PluginMaterialApi: () => PluginMaterialApi,
+  PluginMaterialArgs: () => PluginMaterialArgs,
   PluginMathApi: () => PluginMathApi,
   PluginMoveArgs: () => PluginMoveArgs,
   PluginOffsetArgs: () => PluginOffsetArgs,
@@ -125,8 +127,8 @@ var PluginVec3Api = class {
    * // { x: 1, y: 2, z: 3 }
    * ```
    */
-  new(x, y, z16) {
-    return { x, y, z: z16 };
+  new(x, y, z17) {
+    return { x, y, z: z17 };
   }
   /**
    * Add two vectors component-wise.
@@ -304,8 +306,8 @@ var PluginQuatApi = class {
    * @param w - The W (scalar) component
    * @returns A new {@linkcode PQuat}
    */
-  new(x, y, z16, w) {
-    return { x, y, z: z16, w };
+  new(x, y, z17, w) {
+    return { x, y, z: z17, w };
   }
   /**
    * Create an identity quaternion representing no rotation.
@@ -349,13 +351,13 @@ var PluginQuatApi = class {
    * @param z - Rotation around Z axis in **radians**
    * @returns A new {@linkcode PQuat}
    */
-  fromEuler(x, y, z16) {
+  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(z16 / 2);
-    const sz = Math.sin(z16 / 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,
@@ -989,6 +991,27 @@ var PluginRotateArgs = z14.object({
   pivot: PVec3
 });
 
+// src/api/tools/material.ts
+var z15 = __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 = z15.object({
+  materialName: z15.enum(Object.values(DEFAULT_MATERIALS)),
+  componentIds: z15.array(z15.string())
+});
+
 // src/api/tools/index.ts
 var PluginToolsApi = class {
   constructor() {
@@ -996,12 +1019,12 @@ var PluginToolsApi = class {
 };
 
 // src/api/units/index.ts
-var z15 = __toESM(require("zod"), 1);
+var z16 = __toESM(require("zod"), 1);
 var PluginUnitsApi = class {
   constructor() {
   }
 };
-var PUnitType = z15.enum([
+var PUnitType = z16.enum([
   "meters",
   "feet-inches",
   "inches",
@@ -1010,21 +1033,21 @@ var PUnitType = z15.enum([
   "kilometers",
   "miles"
 ]);
-var PluginUnitsConvertFromArgs = z15.object({
+var PluginUnitsConvertFromArgs = z16.object({
   unit: PUnitType,
-  value: z15.number(),
-  degree: z15.number().int().min(1).max(3).optional()
+  value: z16.number(),
+  degree: z16.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertFromResult = z15.object({
-  value: z15.number()
+var PluginUnitsConvertFromResult = z16.object({
+  value: z16.number()
 });
-var PluginUnitsConvertToArgs = z15.object({
+var PluginUnitsConvertToArgs = z16.object({
   unit: PUnitType,
-  value: z15.number(),
-  degree: z15.number().int().min(1).max(3).optional()
+  value: z16.number(),
+  degree: z16.number().int().min(1).max(3).optional()
 });
-var PluginUnitsConvertToResult = z15.object({
-  value: z15.number()
+var PluginUnitsConvertToResult = z16.object({
+  value: z16.number()
 });
 
 // src/api/index.ts
@@ -1058,6 +1081,8 @@ var PluginApi = class {
   PluginGeomApi,
   PluginLineApi,
   PluginMassType,
+  PluginMaterialApi,
+  PluginMaterialArgs,
   PluginMathApi,
   PluginMoveArgs,
   PluginOffsetArgs,