@snaptrude/plugin-core 0.0.0-bimsvg-20260928124803

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

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

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

@@ -0,0 +1,78 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../../types";
+import { ProfileHandle, ContourHandle } from "../../../../handles";
+/**
+ * Geometry deletion — release transient geometry resource handles (all-handle model, §11).
+ *
+ * Methods here free a handle's backing registry entry and reclaim its share of the
+ * plugin's resource quota. This is purely a handle-lifecycle operation: it does NOT
+ * tear down or delete any engine-side geometry. Once released, the handle is no
+ * longer resolvable and must not be reused.
+ *
+ * Accessed via `snaptrude.core.geom.delete`.
+ */
+export declare abstract class PluginGeomDeleteApi {
+    constructor();
+    /**
+     * Free a transient profile resource handle — releases its registry entry and
+     * 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
+     *
+     * # Example
+     * ```ts
+     * const rect = await snaptrude.core.geom.create.profileRect(4, 3)
+     * const area = await snaptrude.core.geom.query.profile.getArea(rect)
+     * await snaptrude.core.geom.delete.profile(rect) // rect is no longer resolvable
+     * ```
+     */
+    abstract profile(profile: ProfileHandle): PluginApiReturn<void>;
+    /**
+     * Free a transient contour resource handle — releases its registry entry and
+     * 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
+     *
+     * # Example
+     * ```ts
+     * const rect = await snaptrude.core.geom.create.profileRect(4, 3)
+     * const contour = await snaptrude.core.geom.create.contourFromProfile(rect)
+     * const area = await snaptrude.core.geom.query.contour.getArea(contour)
+     * await snaptrude.core.geom.delete.contour(contour) // contour freed; rect still valid
+     * ```
+     */
+    abstract contour(contour: ContourHandle): PluginApiReturn<void>;
+}
+/**
+ * Arguments for {@linkcode PluginGeomDeleteApi.profile}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `profile` | {@linkcode ProfileHandle} | The transient profile handle to release |
+ */
+export declare const PluginGeomDeleteProfileArgs: z.ZodObject<{
+    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>;
+/**
+ * Arguments for {@linkcode PluginGeomDeleteApi.contour}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `contour` | {@linkcode ContourHandle} | The transient contour handle to release |
+ */
+export declare const PluginGeomDeleteContourArgs: z.ZodObject<{
+    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

@@ -0,0 +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;;;;;;;;;;;;;;;;;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/index.d.ts

@@ -0,0 +1,33 @@
+import { PluginGeomCreateApi } from "./create";
+import { PluginGeomQueryApi } from "./query";
+import { PluginGeomUpdateApi } from "./update";
+import { PluginGeomDeleteApi } from "./delete";
+/**
+ * Geometry kernel — domain-free construction, query, editing, and disposal of
+ * curves (lines / arcs) and profiles. No BIM/AEC knowledge lives here; build
+ * geometry bottom-up: points ({@linkcode Vec3Handle}) → curves → profiles → entities.
+ *
+ * - {@linkcode PluginGeomApi.create} — construct lines, arcs, and profiles
+ * - {@linkcode PluginGeomApi.query} — read curve / arc / profile geometry and relationships
+ * - {@linkcode PluginGeomApi.update} — derive new curves / profiles (immutable edits)
+ * - {@linkcode PluginGeomApi.delete} — free a transient profile resource handle
+ *
+ * Profiles can then be used with entity creation methods like
+ * {@linkcode PluginSpaceApi.createFromProfile}.
+ */
+export declare abstract class PluginGeomApi {
+    /** Curve and profile construction. See {@linkcode PluginGeomCreateApi}. */
+    abstract create: PluginGeomCreateApi;
+    /** Curve, arc, and profile queries. See {@linkcode PluginGeomQueryApi}. */
+    abstract query: PluginGeomQueryApi;
+    /** Curve and profile editing (derive-new). See {@linkcode PluginGeomUpdateApi}. */
+    abstract update: PluginGeomUpdateApi;
+    /** Resource-handle disposal (profile). See {@linkcode PluginGeomDeleteApi}. */
+    abstract delete: PluginGeomDeleteApi;
+    constructor();
+}
+export * from "./create";
+export * from "./query";
+export * from "./update";
+export * from "./delete";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/geom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;;;;;;;;;GAYG;AACH,8BAAsB,aAAa;IACjC,2EAA2E;IAC3E,SAAgB,MAAM,EAAE,mBAAmB,CAAA;IAC3C,2EAA2E;IAC3E,SAAgB,KAAK,EAAE,kBAAkB,CAAA;IACzC,mFAAmF;IACnF,SAAgB,MAAM,EAAE,mBAAmB,CAAA;IAC3C,+EAA+E;IAC/E,SAAgB,MAAM,EAAE,mBAAmB,CAAA;;CAG5C;AAED,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}

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

@@ -0,0 +1,169 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../../types";
+import { ArcHandle, Vec3Components } from "../../../../handles";
+/**
+ * Arc-specific geometry queries — read circular-arc properties as plain values.
+ *
+ * Every method takes an opaque {@linkcode ArcHandle} and returns plain values
+ * (numbers or {@linkcode Vec3Components}), never a handle. Use these to inspect
+ * the radius, centre, axis, sweep angle, and validity of an arc handle obtained
+ * from {@linkcode PluginGeomCreateApi.arc} or another query.
+ *
+ * Accessed via `snaptrude.core.geom.query.arc`.
+ */
+export declare abstract class PluginGeomQueryArcApi {
+    constructor();
+    /**
+     * Read the radius of an arc.
+     *
+     * @param arc The arc to query
+     * @returns The arc radius as a `number`
+     *
+     * @examplePrompt What is the radius of this curved wall segment?
+     * @examplePrompt Measure the radius of the selected arc
+     *
+     * # Example
+     * ```ts
+     * const start = await snaptrude.core.math.vec3.new(5, 0, 0)
+     * const end = await snaptrude.core.math.vec3.new(0, 0, 5)
+     * const origin = await snaptrude.core.math.vec3.new(0, 0, 0)
+     * const up = await snaptrude.core.math.vec3.new(0, 1, 0)
+     * const arc = await snaptrude.core.geom.create.arc(start, end, origin, up)
+     * const radius = await snaptrude.core.geom.query.arc.getRadius(arc)
+     * ```
+     */
+    abstract getRadius(arc: ArcHandle): PluginApiReturn<number>;
+    /**
+     * Read the centre point of an arc.
+     *
+     * @param arc The arc to query
+     * @returns The arc centre as {@linkcode Vec3Components}
+     *
+     * @examplePrompt Where is the centre of this arc?
+     * @examplePrompt Find the center point of the curved wall
+     *
+     * # Example
+     * ```ts
+     * const start = await snaptrude.core.math.vec3.new(5, 0, 0)
+     * const end = await snaptrude.core.math.vec3.new(0, 0, 5)
+     * const origin = await snaptrude.core.math.vec3.new(0, 0, 0)
+     * const up = await snaptrude.core.math.vec3.new(0, 1, 0)
+     * const arc = await snaptrude.core.geom.create.arc(start, end, origin, up)
+     * const centre = await snaptrude.core.geom.query.arc.getCentre(arc)
+     * console.log(centre.x, centre.y, centre.z)
+     * ```
+     */
+    abstract getCentre(arc: ArcHandle): PluginApiReturn<Vec3Components>;
+    /**
+     * Read the rotation axis of an arc.
+     *
+     * @param arc The arc to query
+     * @returns The arc axis as {@linkcode Vec3Components}
+     *
+     * # Example
+     * ```ts
+     * const start = await snaptrude.core.math.vec3.new(5, 0, 0)
+     * const end = await snaptrude.core.math.vec3.new(0, 0, 5)
+     * const origin = await snaptrude.core.math.vec3.new(0, 0, 0)
+     * const up = await snaptrude.core.math.vec3.new(0, 1, 0)
+     * const arc = await snaptrude.core.geom.create.arc(start, end, origin, up)
+     * const axis = await snaptrude.core.geom.query.arc.getAxis(arc)
+     * console.log(axis.x, axis.y, axis.z)
+     * ```
+     */
+    abstract getAxis(arc: ArcHandle): PluginApiReturn<Vec3Components>;
+    /**
+     * Read the sweep angle of an arc (the angle subtended at its centre).
+     *
+     * @param arc The arc to query
+     * @returns The sweep angle in radians as a `number`
+     *
+     * @examplePrompt What angle does this arc sweep through?
+     * @examplePrompt How many degrees does this curved wall turn?
+     *
+     * # Example
+     * ```ts
+     * const start = await snaptrude.core.math.vec3.new(5, 0, 0)
+     * const end = await snaptrude.core.math.vec3.new(0, 0, 5)
+     * const origin = await snaptrude.core.math.vec3.new(0, 0, 0)
+     * const up = await snaptrude.core.math.vec3.new(0, 1, 0)
+     * const arc = await snaptrude.core.geom.create.arc(start, end, origin, up)
+     * const sweep = await snaptrude.core.geom.query.arc.getSweepAngle(arc)
+     * console.log("degrees:", (sweep * 180) / Math.PI)
+     * ```
+     */
+    abstract getSweepAngle(arc: ArcHandle): PluginApiReturn<number>;
+    /**
+     * Check whether an arc is geometrically valid.
+     *
+     * @param arc The arc to query
+     * @returns `true` if the arc is valid as a `boolean`
+     *
+     * # Example
+     * ```ts
+     * const start = await snaptrude.core.math.vec3.new(5, 0, 0)
+     * const end = await snaptrude.core.math.vec3.new(0, 0, 5)
+     * const origin = await snaptrude.core.math.vec3.new(0, 0, 0)
+     * const up = await snaptrude.core.math.vec3.new(0, 1, 0)
+     * const arc = await snaptrude.core.geom.create.arc(start, end, origin, up)
+     * const ok = await snaptrude.core.geom.query.arc.isValid(arc)
+     * ```
+     */
+    abstract isValid(arc: ArcHandle): PluginApiReturn<boolean>;
+}
+/**
+ * Arguments for {@linkcode PluginGeomQueryArcApi.getRadius}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `arc` | {@linkcode ArcHandle} | The arc to query |
+ */
+export declare const PluginGeomQueryArcGetRadiusArgs: z.ZodObject<{
+    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>;
+/**
+ * Arguments for {@linkcode PluginGeomQueryArcApi.getCentre}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `arc` | {@linkcode ArcHandle} | The arc to query |
+ */
+export declare const PluginGeomQueryArcGetCentreArgs: z.ZodObject<{
+    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>;
+/**
+ * Arguments for {@linkcode PluginGeomQueryArcApi.getAxis}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `arc` | {@linkcode ArcHandle} | The arc to query |
+ */
+export declare const PluginGeomQueryArcGetAxisArgs: z.ZodObject<{
+    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>;
+/**
+ * Arguments for {@linkcode PluginGeomQueryArcApi.getSweepAngle}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `arc` | {@linkcode ArcHandle} | The arc to query |
+ */
+export declare const PluginGeomQueryArcGetSweepAngleArgs: z.ZodObject<{
+    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>;
+/**
+ * Arguments for {@linkcode PluginGeomQueryArcApi.isValid}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `arc` | {@linkcode ArcHandle} | The arc to query |
+ */
+export declare const PluginGeomQueryArcIsValidArgs: z.ZodObject<{
+    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

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

@@ -0,0 +1 @@
+{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../../../src/api/core/geom/query/arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAE/D;;;;;;;;;GASG;AACH,8BAAsB,qBAAqB;;IAGzC;;;;;;;;;;;;;;;;;;OAkBG;aACa,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC;IAElE;;;;;;;;;;;;;;;;;;;OAmBG;aACa,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAAC,cAAc,CAAC;IAE1E;;;;;;;;;;;;;;;;OAgBG;aACa,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAAC,cAAc,CAAC;IAExE;;;;;;;;;;;;;;;;;;;OAmBG;aACa,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC;IAEtE;;;;;;;;;;;;;;;OAeG;aACa,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC;CAClE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;iBAA+B,CAAA;AAC3E,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;iBAA+B,CAAA;AAC3E,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;iBAA+B,CAAA;AACzE,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEzF;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;;iBAA+B,CAAA;AAC/E,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAErG;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;iBAA+B,CAAA;AACzE,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA"}