@snaptrude/plugin-core 0.7.0 → 0.8.0

package/dist/api/core/camera/index.d.ts

@@ -0,0 +1,208 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { Vec3Handle } from "../../../handles";
+/**
+ * Camera controls.
+ *
+ * Position the viewport camera, snap it to a standard orthographic/isometric
+ * view, and toggle between the 2D (plan) and 3D modelling modes — mirrors the
+ * canvas view menu and the 2D/3D toggle. Like {@linkcode PluginZoomApi}, these
+ * are transient VIEW-STATE changes: they are not model edits, so they are not
+ * write-gated and are not undoable. Accessed via `snaptrude.core.camera`.
+ */
+export declare abstract class PluginCameraApi {
+    constructor();
+    /**
+     * Point the camera: place its eye at `eye` looking toward `target` (world
+     * coordinates, internal `babylon` units). View-state only — not undoable.
+     *
+     * @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.
+     *
+     * @examplePrompt Look at the model from above the north-east corner
+     * @examplePrompt Position the camera at (50, 30, 50) looking at the origin
+     * @examplePrompt Point the camera at the centre of the building from the side
+     * @examplePrompt Set the eye to this point and aim it at that point
+     *
+     * # Example
+     * ```ts
+     * const { vec3 } = snaptrude.core.math
+     * await snaptrude.core.camera.lookFrom(vec3.new(50, 30, 50), vec3.new(0, 0, 0))
+     * ```
+     */
+    abstract lookFrom(eye: Vec3Handle, target: Vec3Handle): PluginApiReturn<boolean>;
+    /**
+     * Snap the camera to a standard view — the five orthographic elevations
+     * (`top` / `front` / `back` / `left` / `right`) or the 3D `iso` (isometric
+     * perspective) view. Mirrors the canvas view menu. View-state only — not
+     * undoable. The orthographic presets exit 2D mode first if needed.
+     *
+     * @param view - The standard view to snap to ({@linkcode PluginStandardView})
+     * @returns `true` once the view has been applied.
+     *
+     * @examplePrompt Switch to the top view
+     * @examplePrompt Show me the front elevation
+     * @examplePrompt Go to the isometric view
+     * @examplePrompt Look at the model from the left
+     * @examplePrompt Give me a plan view from the top
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.core.camera.setStandardView("top")
+     * ```
+     */
+    abstract setStandardView(view: PluginStandardView): PluginApiReturn<boolean>;
+    /**
+     * Toggle the modelling mode between `2d` (plan) and `3d`. Mirrors the canvas
+     * 2D/3D toggle: `3d` enters the isometric perspective view, `2d` drops to the
+     * orthographic plan of the active storey. View-state only — not undoable.
+     *
+     * @param mode - `"2d"` or `"3d"` ({@linkcode PluginCameraMode})
+     * @returns `true` once the mode switch has been requested.
+     *
+     * @examplePrompt Switch to 3D view
+     * @examplePrompt Drop into 2D plan mode
+     * @examplePrompt Go back to 3D
+     * @examplePrompt Show the floor plan in 2D
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.core.camera.setMode("3d")
+     * ```
+     */
+    abstract setMode(mode: PluginCameraMode): PluginApiReturn<boolean>;
+    /**
+     * Read the camera's current projection: `"perspective"` (the default 3D
+     * view) or `"orthographic"`. In 2D (plan) mode this always reports
+     * `"orthographic"` — a plan is an orthographic projection.
+     *
+     * @returns The current {@linkcode PluginCameraProjection}.
+     *
+     * @examplePrompt Is the camera in perspective or orthographic?
+     * @examplePrompt What projection is the 3D view using?
+     * @examplePrompt Check whether perspective is on
+     *
+     * # Example
+     * ```ts
+     * const projection = await snaptrude.core.camera.getProjection()
+     * console.log(projection) // "perspective" | "orthographic"
+     * ```
+     */
+    abstract getProjection(): PluginApiReturn<PluginCameraProjection>;
+    /**
+     * Switch the 3D camera between `"perspective"` and `"orthographic"`
+     * projection — the Perspective/Orthographic control in the Design tab's
+     * View Settings panel. Like {@linkcode PluginCameraApi.setMode}, this is a
+     * transient view-state change: not write-gated, not undoable.
+     *
+     * In 2D (plan) mode the canvas is always an orthographic plan:
+     * `"orthographic"` is accepted as a no-op, while `"perspective"` is
+     * rejected — switch to 3D first via `setMode("3d")`.
+     *
+     * @param projection - `"perspective"` or `"orthographic"` ({@linkcode PluginCameraProjection})
+     * @returns `true` once the projection has been applied.
+     *
+     * @examplePrompt Switch the camera to orthographic
+     * @examplePrompt Turn perspective off
+     * @examplePrompt Give me a perspective view of the model
+     * @examplePrompt Make the 3D view orthographic like an axonometric drawing
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.core.camera.setProjection("orthographic")
+     * const projection = await snaptrude.core.camera.getProjection() // "orthographic"
+     * ```
+     */
+    abstract setProjection(projection: PluginCameraProjection): PluginApiReturn<boolean>;
+}
+/**
+ * A standard camera view: the five orthographic elevations (`top`/`front`/
+ * `back`/`left`/`right`) or the 3D isometric perspective (`iso`).
+ */
+export declare const PluginStandardView: z.ZodEnum<{
+    top: "top";
+    front: "front";
+    back: "back";
+    left: "left";
+    right: "right";
+    iso: "iso";
+}>;
+export type PluginStandardView = z.infer<typeof PluginStandardView>;
+/**
+ * The modelling mode: `2d` (orthographic plan) or `3d` (isometric perspective).
+ */
+export declare const PluginCameraMode: z.ZodEnum<{
+    "2d": "2d";
+    "3d": "3d";
+}>;
+export type PluginCameraMode = z.infer<typeof PluginCameraMode>;
+/**
+ * The 3D camera projection: `perspective` (the default) or `orthographic` —
+ * the Perspective/Orthographic control in the Design tab's View Settings panel.
+ */
+export declare const PluginCameraProjection: z.ZodEnum<{
+    perspective: "perspective";
+    orthographic: "orthographic";
+}>;
+export type PluginCameraProjection = z.infer<typeof PluginCameraProjection>;
+/**
+ * Arguments for {@linkcode PluginCameraApi.lookFrom}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `eye` | {@linkcode Vec3Handle} | Camera position (world, `babylon` units) |
+ * | `target` | {@linkcode Vec3Handle} | Point the camera looks at |
+ */
+export declare const PluginCameraLookFromArgs: z.ZodObject<{
+    eye: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+    target: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>;
+}, z.core.$strip>;
+export type PluginCameraLookFromArgs = z.infer<typeof PluginCameraLookFromArgs>;
+/**
+ * Arguments for {@linkcode PluginCameraApi.setStandardView}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `view` | {@linkcode PluginStandardView} | The standard view to snap to |
+ */
+export declare const PluginCameraSetStandardViewArgs: z.ZodObject<{
+    view: z.ZodEnum<{
+        top: "top";
+        front: "front";
+        back: "back";
+        left: "left";
+        right: "right";
+        iso: "iso";
+    }>;
+}, z.core.$strip>;
+export type PluginCameraSetStandardViewArgs = z.infer<typeof PluginCameraSetStandardViewArgs>;
+/**
+ * Arguments for {@linkcode PluginCameraApi.setMode}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `mode` | {@linkcode PluginCameraMode} | `"2d"` or `"3d"` |
+ */
+export declare const PluginCameraSetModeArgs: z.ZodObject<{
+    mode: z.ZodEnum<{
+        "2d": "2d";
+        "3d": "3d";
+    }>;
+}, z.core.$strip>;
+export type PluginCameraSetModeArgs = z.infer<typeof PluginCameraSetModeArgs>;
+/**
+ * Arguments for {@linkcode PluginCameraApi.setProjection}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `projection` | {@linkcode PluginCameraProjection} | `"perspective"` or `"orthographic"` |
+ */
+export declare const PluginCameraSetProjectionArgs: z.ZodObject<{
+    projection: z.ZodEnum<{
+        perspective: "perspective";
+        orthographic: "orthographic";
+    }>;
+}, z.core.$strip>;
+export type PluginCameraSetProjectionArgs = z.infer<typeof PluginCameraSetProjectionArgs>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/camera/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;;;GAQG;AACH,8BAAsB,eAAe;;IAGnC;;;;;;;;;;;;;;;;;;OAkBG;aACa,QAAQ,CACtB,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,UAAU,GACjB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;aACa,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;OAiBG;aACa,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAC,OAAO,CAAC;IAEzE;;;;;;;;;;;;;;;;OAgBG;aACa,aAAa,IAAI,eAAe,CAAC,sBAAsB,CAAC;IAExE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,aAAa,CAC3B,UAAU,EAAE,sBAAsB,GACjC,eAAe,CAAC,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAAuB,CAAA;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;EAA0C,CAAA;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;iBAE1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;iBAExC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,6BAA6B,CACrC,CAAA"}

package/dist/api/core/comment/index.d.ts

@@ -1,6 +1,6 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../../types";
-import { Vec3Handle, ComponentHandle } from "../../../handles";
+import { Vec3Handle, ComponentHandle, Vec3Components } from "../../../handles";
 /**
  * Comments — create, edit, resolve, tag, and list scene/project comments.
  *
@@ -158,6 +158,50 @@ export declare abstract class PluginCommentApi {
      * ```
      */
     abstract list(): PluginApiReturn<CommentHandle[]>;
+    /**
+     * Read a comment's full detail — its text, author, pin location, resolved
+     * state, and reply thread. Comments are otherwise write-only; this is the read
+     * side. Pass a top-level comment handle or a reply handle (a reply has an empty
+     * `thread`). Returns `null` if the handle doesn't match a live comment.
+     *
+     * @param comment - The comment (or reply) to read.
+     * @returns the {@link PluginCommentDetails}, or `null` if not found.
+     *
+     * @examplePrompt Read the comment on this wall and tell me what it says
+     * @examplePrompt Who left this comment and where is it pinned?
+     * @examplePrompt Show me the full thread for this comment
+     * @examplePrompt Get the text and author of the selected comment
+     *
+     * # Example
+     * ```ts
+     * const [first] = await snaptrude.core.comment.list()
+     * const details = await snaptrude.core.comment.get(first)
+     * console.log(details?.content, "by", details?.author?.name)
+     * console.log(`${details?.thread.length ?? 0} replies`)
+     * ```
+     */
+    abstract get(comment: CommentHandle): PluginApiReturn<PluginCommentDetails | null>;
+    /**
+     * Reply to a comment — posts a new comment threaded under `comment` (which must
+     * be a top-level comment, not itself a reply). Notifies the thread's
+     * participants, mirroring the sidebar Reply action.
+     *
+     * @param comment - The top-level comment to reply to.
+     * @param text - The reply text (emojis = plain unicode).
+     * @returns the new reply's {@link CommentHandle}.
+     *
+     * @examplePrompt Reply to this comment saying I fixed the wall height
+     * @examplePrompt Add a reply to the review note confirming it's done
+     * @examplePrompt Respond to the comment about the door with "looks good now"
+     * @examplePrompt Post a follow-up on the selected comment thread
+     *
+     * # Example
+     * ```ts
+     * const [thread] = await snaptrude.core.comment.list()
+     * const reply = await snaptrude.core.comment.reply(thread, "Fixed 👍")
+     * ```
+     */
+    abstract reply(comment: CommentHandle, text: string): PluginApiReturn<CommentHandle>;
 }
 /**
  * Opaque handle to a comment — its server-assigned id (entity-style: a raw,
@@ -182,7 +226,7 @@ export declare const CommentHandle: z.ZodPipe<z.ZodString, z.ZodTransform<Commen
  */
 export declare const PluginCommentCreateArgs: z.ZodObject<{
     component: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
-    position: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
+    position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../..").Handle<"vec3">, string>>>;
     message: z.ZodString;
     mentions: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
@@ -227,4 +271,63 @@ export declare const PluginCommentTagArgs: z.ZodObject<{
     email: z.ZodString;
 }, z.core.$strip>;
 export type PluginCommentTagArgs = z.infer<typeof PluginCommentTagArgs>;
+/**
+ * Arguments for {@link PluginCommentApi.reply}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `comment` | {@link CommentHandle} | The top-level comment to reply to |
+ * | `text` | `string` | The reply text (emojis = unicode) |
+ */
+export declare const PluginCommentReplyArgs: z.ZodObject<{
+    comment: z.ZodPipe<z.ZodString, z.ZodTransform<CommentHandle, string>>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type PluginCommentReplyArgs = z.infer<typeof PluginCommentReplyArgs>;
+/**
+ * The author of a comment or reply — the display name and email of the teammate
+ * who posted it. `null` on the rare comment with no recorded author.
+ */
+export interface PluginCommentAuthor {
+    /** The author's display name (falls back to their email). */
+    name: string;
+    /** The author's email. */
+    email: string;
+}
+/**
+ * One reply in a comment's thread (returned by {@link PluginCommentApi.get}).
+ */
+export interface PluginCommentReply {
+    /** The reply's own {@link CommentHandle}. */
+    id: CommentHandle;
+    /** The reply text. */
+    content: string;
+    /** Who posted the reply. */
+    author: PluginCommentAuthor | null;
+    /** ISO-8601 timestamp of when the reply was posted (empty if unknown). */
+    createdAt: string;
+}
+/**
+ * The read model of a comment — returned by {@link PluginCommentApi.get}. The
+ * inverse of {@link PluginCommentApi.create}: `content`/`component`/`position`
+ * echo what was posted, plus the resolved state and reply `thread`.
+ */
+export interface PluginCommentDetails {
+    /** The comment's {@link CommentHandle}. */
+    id: CommentHandle;
+    /** The comment text. */
+    content: string;
+    /** Who posted the comment. */
+    author: PluginCommentAuthor | null;
+    /** The pin point (engine world coordinates), or `null` if un-anchored. */
+    position: Vec3Components | null;
+    /** The component the comment is anchored to, or `null` if un-anchored. */
+    component: ComponentHandle | null;
+    /** Whether the comment has been marked resolved. */
+    isResolved: boolean;
+    /** ISO-8601 timestamp of when the comment was posted (empty if unknown). */
+    createdAt: string;
+    /** The reply thread, oldest first. Empty for a comment with no replies. */
+    thread: PluginCommentReply[];
+}
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/comment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE9D;;;;;;GAMG;AACH,8BAAsB,gBAAgB;;IAGpC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,MAAM,CACpB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,UAAU,EACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,eAAe,CAAC,aAAa,CAAC;IAEjC;;;;;;;;;;;;;;;;;OAiBG;aACa,MAAM,CACpB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;OAeG;aACa,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC;IAEzE;;;;;;;;;;;;;;;OAeG;aACa,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC;IAExE;;;;;;;;;;;;;;;;OAgBG;aACa,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC;IAE5E;;;;;;;;;;;;;;;;OAgBG;aACa,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC;IAEpF;;;;;;;;;;;;;;;OAeG;aACa,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC;IAExE;;;;;;;;;;;;;;OAcG;aACa,IAAI,IAAI,eAAe,CAAC,aAAa,EAAE,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAA;AACrE,eAAO,MAAM,aAAa,+DAGa,CAAA;AAEvC;;iDAEiD;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/comment/index.ts"],"names":[],"mappings":"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"}

package/dist/api/core/geom/create/index.d.ts

@@ -162,8 +162,8 @@ export declare abstract class PluginGeomCreateApi {
  * | `endPoint` | {@linkcode Vec3Handle} | End point of the line segment |
  */
 export declare const PluginGeomCreateLineArgs: z.ZodObject<{
-    startPoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
-    endPoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    startPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    endPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
 }, z.core.$strip>;
 export type PluginGeomCreateLineArgs = z.infer<typeof PluginGeomCreateLineArgs>;
 /**
@@ -177,10 +177,10 @@ export type PluginGeomCreateLineArgs = z.infer<typeof PluginGeomCreateLineArgs>;
  * | `axis` | {@linkcode Vec3Handle} | Axis direction of the arc |
  */
 export declare const PluginGeomCreateArcArgs: z.ZodObject<{
-    startPoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
-    endPoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
-    centrePoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
-    axis: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    startPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    endPoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    centrePoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    axis: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
 }, z.core.$strip>;
 export type PluginGeomCreateArcArgs = z.infer<typeof PluginGeomCreateArcArgs>;
 /**
@@ -193,8 +193,8 @@ export type PluginGeomCreateArcArgs = z.infer<typeof PluginGeomCreateArcArgs>;
  * | `radius` | `number` | Radius of the circle |
  */
 export declare const PluginGeomCreateCircleArgs: z.ZodObject<{
-    centrePoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
-    axis: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    centrePoint: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
+    axis: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>;
     radius: z.ZodNumber;
 }, z.core.$strip>;
 export type PluginGeomCreateCircleArgs = z.infer<typeof PluginGeomCreateCircleArgs>;
@@ -206,7 +206,7 @@ export type PluginGeomCreateCircleArgs = z.infer<typeof PluginGeomCreateCircleAr
  * | `points` | {@linkcode Vec3Handle}`[]` | Ordered vertex handles of the profile |
  */
 export declare const PluginGeomCreateProfileFromLinePointsArgs: z.ZodObject<{
-    points: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>>;
+    points: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"vec3">, string>>>;
 }, z.core.$strip>;
 export type PluginGeomCreateProfileFromLinePointsArgs = z.infer<typeof PluginGeomCreateProfileFromLinePointsArgs>;
 /**
@@ -217,7 +217,7 @@ export type PluginGeomCreateProfileFromLinePointsArgs = z.infer<typeof PluginGeo
  * | `curves` | {@linkcode CurveHandle}`[]` | Ordered curve handles forming a closed loop |
  */
 export declare const PluginGeomCreateProfileFromCurvesArgs: z.ZodObject<{
-    curves: z.ZodArray<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"line">, string>>, z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"arc">, string>>]>>;
+    curves: z.ZodArray<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"line">, string>>, z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"arc">, string>>]>>;
 }, z.core.$strip>;
 export type PluginGeomCreateProfileFromCurvesArgs = z.infer<typeof PluginGeomCreateProfileFromCurvesArgs>;
 /**
@@ -228,7 +228,7 @@ export type PluginGeomCreateProfileFromCurvesArgs = z.infer<typeof PluginGeomCre
  * | `outer` | {@linkcode ProfileHandle} | The outer boundary loop |
  */
 export declare const PluginGeomCreateContourFromProfileArgs: z.ZodObject<{
-    outer: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"profile">, string>>;
+    outer: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"profile">, string>>;
 }, z.core.$strip>;
 export type PluginGeomCreateContourFromProfileArgs = z.infer<typeof PluginGeomCreateContourFromProfileArgs>;
 /**
@@ -240,8 +240,8 @@ export type PluginGeomCreateContourFromProfileArgs = z.infer<typeof PluginGeomCr
  * | `holes` | {@linkcode ProfileHandle}`[]` | Optional inner hole loops |
  */
 export declare const PluginGeomCreateContourFromProfilesArgs: z.ZodObject<{
-    outer: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"profile">, string>>;
-    holes: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"profile">, string>>>>;
+    outer: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"profile">, string>>;
+    holes: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"profile">, string>>>>;
 }, z.core.$strip>;
 export type PluginGeomCreateContourFromProfilesArgs = z.infer<typeof PluginGeomCreateContourFromProfilesArgs>;
 //# sourceMappingURL=index.d.ts.map

package/dist/api/core/geom/delete/index.d.ts

@@ -18,6 +18,9 @@ export declare abstract class PluginGeomDeleteApi {
      * reclaims its share of the plugin's resource quota. This is a handle-lifecycle
      * operation only and does NOT tear down any engine-side geometry.
      *
+     * @deprecated Use `core.handles.release([profile])` — the universal, batched
+     * release API for every arena handle kind.
+     *
      * @param profile The transient profile handle to release
      * @returns Nothing
      *
@@ -34,6 +37,9 @@ export declare abstract class PluginGeomDeleteApi {
      * reclaims its share of the plugin's resource quota. Handle-lifecycle only; does
      * NOT tear down engine-side geometry, nor the contour's child profile handles.
      *
+     * @deprecated Use `core.handles.release([contour])` — the universal, batched
+     * release API for every arena handle kind.
+     *
      * @param contour The transient contour handle to release
      * @returns Nothing
      *
@@ -55,7 +61,7 @@ export declare abstract class PluginGeomDeleteApi {
  * | `profile` | {@linkcode ProfileHandle} | The transient profile handle to release |
  */
 export declare const PluginGeomDeleteProfileArgs: z.ZodObject<{
-    profile: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"profile">, string>>;
+    profile: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"profile">, string>>;
 }, z.core.$strip>;
 export type PluginGeomDeleteProfileArgs = z.infer<typeof PluginGeomDeleteProfileArgs>;
 /**
@@ -66,7 +72,7 @@ export type PluginGeomDeleteProfileArgs = z.infer<typeof PluginGeomDeleteProfile
  * | `contour` | {@linkcode ContourHandle} | The transient contour handle to release |
  */
 export declare const PluginGeomDeleteContourArgs: z.ZodObject<{
-    contour: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"contour">, string>>;
+    contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"contour">, string>>;
 }, z.core.$strip>;
 export type PluginGeomDeleteContourArgs = z.infer<typeof PluginGeomDeleteContourArgs>;
 //# sourceMappingURL=index.d.ts.map

package/dist/api/core/geom/delete/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/core/geom/delete/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAElE;;;;;;;;;GASG;AACH,8BAAsB,mBAAmB;;IAGvC;;;;;;;;;;;;;;OAcG;aACa,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC;IAEtE;;;;;;;;;;;;;;;OAeG;aACa,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC;CACvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAErF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/core/geom/delete/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAElE;;;;;;;;;GASG;AACH,8BAAsB,mBAAmB;;IAGvC;;;;;;;;;;;;;;;;;OAiBG;aACa,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC;IAEtE;;;;;;;;;;;;;;;;;;OAkBG;aACa,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC;CACvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAErF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;iBAEtC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/api/core/geom/query/arc.d.ts

@@ -119,7 +119,7 @@ export declare abstract class PluginGeomQueryArcApi {
  * | `arc` | {@linkcode ArcHandle} | The arc to query |
  */
 export declare const PluginGeomQueryArcGetRadiusArgs: z.ZodObject<{
-    arc: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
+    arc: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
 }, z.core.$strip>;
 export type PluginGeomQueryArcGetRadiusArgs = z.infer<typeof PluginGeomQueryArcGetRadiusArgs>;
 /**
@@ -130,7 +130,7 @@ export type PluginGeomQueryArcGetRadiusArgs = z.infer<typeof PluginGeomQueryArcG
  * | `arc` | {@linkcode ArcHandle} | The arc to query |
  */
 export declare const PluginGeomQueryArcGetCentreArgs: z.ZodObject<{
-    arc: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
+    arc: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
 }, z.core.$strip>;
 export type PluginGeomQueryArcGetCentreArgs = z.infer<typeof PluginGeomQueryArcGetCentreArgs>;
 /**
@@ -141,7 +141,7 @@ export type PluginGeomQueryArcGetCentreArgs = z.infer<typeof PluginGeomQueryArcG
  * | `arc` | {@linkcode ArcHandle} | The arc to query |
  */
 export declare const PluginGeomQueryArcGetAxisArgs: z.ZodObject<{
-    arc: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
+    arc: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
 }, z.core.$strip>;
 export type PluginGeomQueryArcGetAxisArgs = z.infer<typeof PluginGeomQueryArcGetAxisArgs>;
 /**
@@ -152,7 +152,7 @@ export type PluginGeomQueryArcGetAxisArgs = z.infer<typeof PluginGeomQueryArcGet
  * | `arc` | {@linkcode ArcHandle} | The arc to query |
  */
 export declare const PluginGeomQueryArcGetSweepAngleArgs: z.ZodObject<{
-    arc: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
+    arc: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
 }, z.core.$strip>;
 export type PluginGeomQueryArcGetSweepAngleArgs = z.infer<typeof PluginGeomQueryArcGetSweepAngleArgs>;
 /**
@@ -163,7 +163,7 @@ export type PluginGeomQueryArcGetSweepAngleArgs = z.infer<typeof PluginGeomQuery
  * | `arc` | {@linkcode ArcHandle} | The arc to query |
  */
 export declare const PluginGeomQueryArcIsValidArgs: z.ZodObject<{
-    arc: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
+    arc: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../../../..").Handle<"arc">, string>>;
 }, z.core.$strip>;
 export type PluginGeomQueryArcIsValidArgs = z.infer<typeof PluginGeomQueryArcIsValidArgs>;
 //# sourceMappingURL=arc.d.ts.map