@faicad/faijs 0.13.0

package/dist/vendored/brepjs/core/shapeTypes.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Branded shape types — type-safe shape discrimination without class hierarchies.
+ * Each shape type is a branded ShapeHandle to prevent incorrect assignments.
+ *
+ * Shapes carry a phantom dimension parameter `D extends Dimension` that tracks
+ * whether the shape is embedded in 2D or 3D space. This enables compile-time
+ * rejection of dimension mismatches (e.g., fusing a 2D wire with a 3D solid).
+ *
+ * - Dimension-parameterized types: Vertex, Edge, Wire, Face, Compound (default '3D')
+ * - Fixed 3D types: Shell, Solid, CompSolid (always '3D', no parameter)
+ *
+ * Dimension types (ADR-0004) live in dimensionTypes.ts;
+ * validity brands (ADR-0005) live in validityTypes.ts;
+ * both are re-exported here for backward compatibility.
+ */
+import type { KernelShape, KernelType, ShapeType } from '../kernel/types.js';
+import type { ShapeHandle } from './disposal.js';
+import type { Dimension } from './dimensionTypes.js';
+export { getShapeKind } from './typeDiscriminants.js';
+export type { Dimension, DimensionError, RequireDimension, SameDimension, } from './dimensionTypes.js';
+export { is2D, is3D, as2D, as3D } from './dimensionTypes.js';
+export type { ClosedWire, OrientedFace, ManifoldShell, ValidSolid, PlanarFace, PlanarWire, } from './validityTypes.js';
+export { closedWire, orientedFace, manifoldShell, validSolid, isClosedWire, isOrientedFace, isManifoldShell, isValidSolid, isPlanarFace, isPlanarWire, planarFace, planarWire, } from './validityTypes.js';
+/** Interface for kernel curve adaptors (BRepAdaptor_Curve / CompCurve). */
+export interface CurveLike {
+    delete(): void;
+    Value(v: number): KernelType;
+    IsPeriodic(): boolean;
+    Period(): number;
+    IsClosed(): boolean;
+    FirstParameter(): number;
+    LastParameter(): number;
+    GetType?(): any;
+    D1(v: number, p: KernelType, vPrime: KernelType): void;
+}
+/** String discriminant identifying the topological type of a shape. */
+export type ShapeKind = 'vertex' | 'edge' | 'wire' | 'face' | 'shell' | 'solid' | 'compsolid' | 'compound';
+/** Phantom brand key for dimension tracking (never exists at runtime). */
+declare const __dim: unique symbol;
+declare const __brand: unique symbol;
+/** A topological vertex (0D point). */
+export type Vertex<D extends Dimension = '3D'> = ShapeHandle & {
+    readonly [__brand]: 'vertex';
+    readonly [__dim]: D;
+};
+/** A topological edge (1D curve segment). */
+export type Edge<D extends Dimension = '3D'> = ShapeHandle & {
+    readonly [__brand]: 'edge';
+    readonly [__dim]: D;
+};
+/** An ordered sequence of connected edges forming a path or loop. */
+export type Wire<D extends Dimension = '3D'> = ShapeHandle & {
+    readonly [__brand]: 'wire';
+    readonly [__dim]: D;
+};
+/** A bounded portion of a surface. */
+export type Face<D extends Dimension = '3D'> = ShapeHandle & {
+    readonly [__brand]: 'face';
+    readonly [__dim]: D;
+};
+/** A connected set of faces sharing edges. Always 3D. */
+export type Shell = ShapeHandle & {
+    readonly [__brand]: 'shell';
+    readonly [__dim]: '3D';
+};
+/** A closed volume bounded by shells. Always 3D. */
+export type Solid = ShapeHandle & {
+    readonly [__brand]: 'solid';
+    readonly [__dim]: '3D';
+};
+/** A set of solids connected by faces. Always 3D. */
+export type CompSolid = ShapeHandle & {
+    readonly [__brand]: 'compsolid';
+    readonly [__dim]: '3D';
+};
+/** A heterogeneous collection of shapes. */
+export type Compound<D extends Dimension = '3D'> = ShapeHandle & {
+    readonly [__brand]: 'compound';
+    readonly [__dim]: D;
+};
+/** Any branded shape type in a given dimension. Defaults to 3D. */
+export type AnyShape<D extends Dimension = '3D'> = Vertex<D> | Edge<D> | Wire<D> | Face<D> | Compound<D> | (D extends '3D' ? Shell | Solid | CompSolid : never);
+/** 1D shapes (edges and wires) in a given dimension. */
+export type Shape1D<D extends Dimension = '3D'> = Edge<D> | Wire<D>;
+/** 3D shapes (solid-like). Always 3D by definition. */
+export type Shape3D = Shell | Solid | CompSolid | Compound<'3D'>;
+/** Any shape whose dimension is unknown (e.g., from file import). Requires narrowing. */
+export type UnknownDimShape = AnyShape<'2D'> | AnyShape<'3D'>;
+/** Wrap a raw kernel shape as a branded {@link Vertex} handle. */
+export declare function createVertex<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Vertex<D>;
+/** Wrap a raw kernel shape as a branded {@link Edge} handle. */
+export declare function createEdge<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Edge<D>;
+/** Wrap a raw kernel shape as a branded {@link Wire} handle. */
+export declare function createWire<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Wire<D>;
+/** Wrap a raw kernel shape as a branded {@link Face} handle. */
+export declare function createFace<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Face<D>;
+/** Wrap a raw kernel shape as a branded {@link Shell} handle. */
+export declare function createShell(ocShape: KernelShape): Shell;
+/** Wrap a raw kernel shape as a branded {@link Solid} handle. */
+export declare function createSolid(ocShape: KernelShape): Solid;
+/** Wrap a raw kernel shape as a branded {@link CompSolid} handle. */
+export declare function createCompSolid(ocShape: KernelShape): CompSolid;
+/** Wrap a raw kernel shape as a branded {@link Compound} handle. */
+export declare function createCompound<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Compound<D>;
+/** Type guard — check if a shape is a {@link Vertex}. */
+export declare function isVertex<D extends Dimension>(s: AnyShape<D>): s is Vertex<D>;
+/** Type guard — check if a shape is an {@link Edge}. */
+export declare function isEdge<D extends Dimension>(s: AnyShape<D>): s is Edge<D>;
+/** Type guard — check if a shape is a {@link Wire}. */
+export declare function isWire<D extends Dimension>(s: AnyShape<D>): s is Wire<D>;
+/** Type guard — check if a shape is a {@link Face}. */
+export declare function isFace<D extends Dimension>(s: AnyShape<D>): s is Face<D>;
+/** Type guard — check if a shape is a {@link Shell}. */
+export declare function isShell(s: AnyShape<Dimension>): s is Shell;
+/** Type guard — check if a shape is a {@link Solid}. */
+export declare function isSolid(s: AnyShape<Dimension>): s is Solid;
+/** Type guard — check if a shape is a {@link Compound}. */
+export declare function isCompound<D extends Dimension>(s: AnyShape<D>): s is Compound<D>;
+/** Type guard — check if a shape is a 3D shape (shell, solid, compsolid, or 3D compound). */
+export declare function isShape3D(s: AnyShape<Dimension>): s is Shape3D;
+/** Type guard — check if a shape is a 1D shape (edge or wire). */
+export declare function isShape1D<D extends Dimension>(s: AnyShape<D>): s is Shape1D<D>;
+/**
+ * Wrap a raw kernel shape into a properly branded type.
+ * Performs a downcast and wraps in a disposable handle.
+ *
+ * **Note**: When `D` is `'2D'`, Shell/Solid/CompSolid are not valid members
+ * of `AnyShape<'2D'>`. If the kernel shape happens to be one of these types,
+ * they will be cast unsoundly. Prefer {@link castShape3D} for shapes known
+ * to be 3D, and use the default `castShape()` (which defaults to `'3D'`)
+ * for normal usage.
+ */
+export declare function castShape<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): AnyShape<D>;
+/** Type-safe cast for shapes known to be 3D. */
+export declare function castShape3D(ocShape: KernelShape): AnyShape;
+/**
+ * Release the pre-downcast handle of a freshly-produced kernel result after it
+ * has been cast to `cast`.
+ *
+ * On occt-wasm `downcast` allocates a new arena slot and orphans the input; a
+ * handle's own `delete()` is a no-op there, so the input must be released via
+ * `getKernel().dispose()` to reclaim the slot. Kernels whose `downcast` is
+ * identity (manifold, brepkit) return the same handle as `cast`, so nothing is
+ * released — doing so would delete the shape being returned.
+ *
+ * Use only for a kernel result the caller owns outright — never for a shape
+ * received from elsewhere.
+ */
+export declare function disposeDowncastSource(source: KernelShape, cast: ShapeHandle): void;
+/**
+ * Cast a freshly-produced kernel result to its branded type and release the
+ * orphaned pre-downcast handle. The result-owning counterpart to {@link castShape};
+ * see {@link disposeDowncastSource} for the arena semantics.
+ */
+export declare function castResultShape<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): AnyShape<D>;
+/**
+ * Fully release a transiently-branded sub-shape and the raw handle it was cast
+ * from — for a face/edge iterated only to read a property, then discarded.
+ *
+ * `handle`'s dispose updates stats and, on kernels that own their native object
+ * (Embind, manifold, brepkit), frees it. occt-wasm handles are arena-backed
+ * (their delete is a no-op), so when the downcast produced a distinct handle
+ * (`handle.wrapped !== rawSource`) both arena slots are released explicitly. The
+ * identity guard also skips manifold/brepkit — there `handle` *is* `rawSource`,
+ * already freed above, and their `dispose()` has no double-free guard.
+ */
+export declare function disposeTransientSubShape(handle: ShapeHandle, rawSource: KernelShape): void;
+/**
+ * Release a branded shape on an error path — when a cast result is rejected and
+ * discarded. Releases the arena slot (occt-wasm's own `delete` is a no-op) then
+ * runs the handle's disposer for stats/registry. Safe on every kernel: the
+ * disposer's `delete()` runs inside createHandle's try/catch, so the repeated
+ * free after `getKernel().dispose()` is swallowed.
+ */
+export declare function disposeResultShape(handle: ShapeHandle): void;
+/**
+ * Fast-path cast when the shape type is already known (e.g., from iterShapes).
+ * Skips the shapeType() WASM call — only performs downcast + branded handle creation.
+ * Used internally by topology extractors for bulk sub-shape iteration.
+ */
+export declare function castShapeWithKnownType<D extends Dimension = '3D'>(ocShape: KernelShape, knownType: ShapeType, dim?: D): AnyShape<D>;
+/**
+ * The result-owning counterpart to {@link castShapeWithKnownType}: casts a
+ * freshly-iterated sub-shape and releases the orphaned pre-downcast handle.
+ * Use for a raw sub-shape the caller owns outright — e.g. each element of
+ * `iterShapes` — where only the branded downcast result is retained. Identity
+ * downcast kernels (manifold/brepkit) skip the release via the guard in
+ * {@link disposeDowncastSource}.
+ */
+export declare function castResultShapeWithKnownType<D extends Dimension = '3D'>(ocShape: KernelShape, knownType: ShapeType, dim?: D): AnyShape<D>;
+/**
+ * Brand a slot owned by someone else (e.g. the topology cache) as a **borrowed**
+ * handle of a known type — no `downcast` (it would alias the source on occt-wasm
+ * >= 3.7.0), no ownership, no-op disposal. The returned handle shares the source
+ * slot's identity, so `isSame`/`hashCode` still match it; it is valid only while
+ * the owner lives. See {@link createBorrowedHandle}.
+ */
+export declare function borrowShapeWithKnownType<D extends Dimension = '3D'>(ocShape: KernelShape, knownType: ShapeType, dim?: D): AnyShape<D>;
+//# sourceMappingURL=shapeTypes.d.ts.map

package/dist/vendored/brepjs/core/shapeTypes.d.ts.map

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

package/dist/vendored/brepjs/core/shapeTypes.js

@@ -0,0 +1,267 @@
+/**
+ * Branded shape types — type-safe shape discrimination without class hierarchies.
+ * Each shape type is a branded ShapeHandle to prevent incorrect assignments.
+ *
+ * Shapes carry a phantom dimension parameter `D extends Dimension` that tracks
+ * whether the shape is embedded in 2D or 3D space. This enables compile-time
+ * rejection of dimension mismatches (e.g., fusing a 2D wire with a 3D solid).
+ *
+ * - Dimension-parameterized types: Vertex, Edge, Wire, Face, Compound (default '3D')
+ * - Fixed 3D types: Shell, Solid, CompSolid (always '3D', no parameter)
+ *
+ * Dimension types (ADR-0004) live in dimensionTypes.ts;
+ * validity brands (ADR-0005) live in validityTypes.ts;
+ * both are re-exported here for backward compatibility.
+ */
+import { getKernel } from '../kernel/index.js';
+import { createHandle, createBorrowedHandle } from './disposal.js';
+import { is3D } from './dimensionTypes.js';
+import { getShapeKind as _getShapeKind } from './typeDiscriminants.js';
+import { getOrQueryType, setCachedType } from './shapeTypeCache.js';
+// ---------------------------------------------------------------------------
+// Re-exports — dimensionTypes.ts (ADR-0004), validityTypes.ts (ADR-0005),
+//              typeDiscriminants.ts (ADR-0008)
+// ---------------------------------------------------------------------------
+export { getShapeKind } from './typeDiscriminants.js';
+export { is2D, is3D, as2D, as3D } from './dimensionTypes.js';
+export { closedWire, orientedFace, manifoldShell, validSolid, isClosedWire, isOrientedFace, isManifoldShell, isValidSolid, isPlanarFace, isPlanarWire, planarFace, planarWire, } from './validityTypes.js';
+// ---------------------------------------------------------------------------
+// Shape factories (brand a handle)
+// ---------------------------------------------------------------------------
+function brandHandle(handle, dim) {
+    // brepjs-patterns-disable: no-double-cast
+    if (dim === '2D')
+        handle['__is2D'] = true;
+    return handle;
+}
+/** Wrap a raw kernel shape as a branded {@link Vertex} handle. */
+export function createVertex(ocShape, dim) {
+    return brandHandle(createHandle(ocShape), dim);
+}
+/** Wrap a raw kernel shape as a branded {@link Edge} handle. */
+export function createEdge(ocShape, dim) {
+    return brandHandle(createHandle(ocShape), dim);
+}
+/** Wrap a raw kernel shape as a branded {@link Wire} handle. */
+export function createWire(ocShape, dim) {
+    return brandHandle(createHandle(ocShape), dim);
+}
+/** Wrap a raw kernel shape as a branded {@link Face} handle. */
+export function createFace(ocShape, dim) {
+    return brandHandle(createHandle(ocShape), dim);
+}
+/** Wrap a raw kernel shape as a branded {@link Shell} handle. */
+export function createShell(ocShape) {
+    return brandHandle(createHandle(ocShape));
+}
+/** Wrap a raw kernel shape as a branded {@link Solid} handle. */
+export function createSolid(ocShape) {
+    return brandHandle(createHandle(ocShape));
+}
+/** Wrap a raw kernel shape as a branded {@link CompSolid} handle. */
+export function createCompSolid(ocShape) {
+    return brandHandle(createHandle(ocShape));
+}
+/** Wrap a raw kernel shape as a branded {@link Compound} handle. */
+export function createCompound(ocShape, dim) {
+    return brandHandle(createHandle(ocShape), dim);
+}
+// ---------------------------------------------------------------------------
+// Type guards (runtime checks via kernel ShapeType)
+// ---------------------------------------------------------------------------
+/** Type guard — check if a shape is a {@link Vertex}. */
+export function isVertex(s) {
+    return _getShapeKind(s) === 'vertex';
+}
+/** Type guard — check if a shape is an {@link Edge}. */
+export function isEdge(s) {
+    return _getShapeKind(s) === 'edge';
+}
+/** Type guard — check if a shape is a {@link Wire}. */
+export function isWire(s) {
+    return _getShapeKind(s) === 'wire';
+}
+/** Type guard — check if a shape is a {@link Face}. */
+export function isFace(s) {
+    return _getShapeKind(s) === 'face';
+}
+/** Type guard — check if a shape is a {@link Shell}. */
+export function isShell(s) {
+    return _getShapeKind(s) === 'shell';
+}
+/** Type guard — check if a shape is a {@link Solid}. */
+export function isSolid(s) {
+    return _getShapeKind(s) === 'solid';
+}
+/** Type guard — check if a shape is a {@link Compound}. */
+export function isCompound(s) {
+    return _getShapeKind(s) === 'compound';
+}
+/** Type guard — check if a shape is a 3D shape (shell, solid, compsolid, or 3D compound). */
+export function isShape3D(s) {
+    const kind = _getShapeKind(s);
+    if (kind === 'shell' || kind === 'solid' || kind === 'compsolid')
+        return true;
+    // Compounds can be 2D or 3D — check the runtime dimension marker
+    if (kind === 'compound')
+        return is3D(s);
+    return false;
+}
+/** Type guard — check if a shape is a 1D shape (edge or wire). */
+export function isShape1D(s) {
+    const kind = _getShapeKind(s);
+    return kind === 'edge' || kind === 'wire';
+}
+// ---------------------------------------------------------------------------
+// Cast utility — wraps an kernel shape into the correct branded type
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a raw kernel shape into a properly branded type.
+ * Performs a downcast and wraps in a disposable handle.
+ *
+ * **Note**: When `D` is `'2D'`, Shell/Solid/CompSolid are not valid members
+ * of `AnyShape<'2D'>`. If the kernel shape happens to be one of these types,
+ * they will be cast unsoundly. Prefer {@link castShape3D} for shapes known
+ * to be 3D, and use the default `castShape()` (which defaults to `'3D'`)
+ * for normal usage.
+ */
+export function castShape(ocShape, dim) {
+    const kernel = getKernel();
+    const st = getOrQueryType(kernel, ocShape);
+    // Pass type to downcast to avoid recomputing ShapeType() in WASM
+    const dc = kernel.downcast(ocShape, st);
+    if (st === 'vertex')
+        return createVertex(dc, dim);
+    if (st === 'edge')
+        return createEdge(dc, dim);
+    if (st === 'wire')
+        return createWire(dc, dim);
+    if (st === 'face')
+        return createFace(dc, dim);
+    if (st === 'shell')
+        return createShell(dc);
+    if (st === 'solid')
+        return createSolid(dc);
+    if (st === 'compsolid')
+        return createCompSolid(dc);
+    return createCompound(dc, dim);
+}
+/** Type-safe cast for shapes known to be 3D. */
+export function castShape3D(ocShape) {
+    return castShape(ocShape);
+}
+/**
+ * Release the pre-downcast handle of a freshly-produced kernel result after it
+ * has been cast to `cast`.
+ *
+ * On occt-wasm `downcast` allocates a new arena slot and orphans the input; a
+ * handle's own `delete()` is a no-op there, so the input must be released via
+ * `getKernel().dispose()` to reclaim the slot. Kernels whose `downcast` is
+ * identity (manifold, brepkit) return the same handle as `cast`, so nothing is
+ * released — doing so would delete the shape being returned.
+ *
+ * Use only for a kernel result the caller owns outright — never for a shape
+ * received from elsewhere.
+ */
+export function disposeDowncastSource(source, cast) {
+    // On arena kernels (occt-wasm) a handle carries a slot `id`. An identity
+    // downcast (occt-wasm >= 3.7.0) returns the SAME id wrapped in a fresh object,
+    // so compare by id: a plain `!==` on the wrappers would dispose the slot the
+    // returned shape still points to (use-after-free). Kernels whose shapes carry
+    // no `id` fall back to object identity (the original behavior).
+    const srcId = source.id;
+    const dstId = cast.wrapped.id;
+    const sameSlot = srcId !== undefined && dstId !== undefined ? srcId === dstId : cast.wrapped === source;
+    if (!sameSlot)
+        getKernel().dispose(source);
+}
+/**
+ * Cast a freshly-produced kernel result to its branded type and release the
+ * orphaned pre-downcast handle. The result-owning counterpart to {@link castShape};
+ * see {@link disposeDowncastSource} for the arena semantics.
+ */
+export function castResultShape(ocShape, dim) {
+    const cast = castShape(ocShape, dim);
+    disposeDowncastSource(ocShape, cast);
+    return cast;
+}
+/**
+ * Fully release a transiently-branded sub-shape and the raw handle it was cast
+ * from — for a face/edge iterated only to read a property, then discarded.
+ *
+ * `handle`'s dispose updates stats and, on kernels that own their native object
+ * (Embind, manifold, brepkit), frees it. occt-wasm handles are arena-backed
+ * (their delete is a no-op), so when the downcast produced a distinct handle
+ * (`handle.wrapped !== rawSource`) both arena slots are released explicitly. The
+ * identity guard also skips manifold/brepkit — there `handle` *is* `rawSource`,
+ * already freed above, and their `dispose()` has no double-free guard.
+ */
+export function disposeTransientSubShape(handle, rawSource) {
+    const downcast = handle.wrapped;
+    handle[Symbol.dispose]();
+    if (downcast !== rawSource) {
+        const kernel = getKernel();
+        kernel.dispose(downcast);
+        kernel.dispose(rawSource);
+    }
+}
+/**
+ * Release a branded shape on an error path — when a cast result is rejected and
+ * discarded. Releases the arena slot (occt-wasm's own `delete` is a no-op) then
+ * runs the handle's disposer for stats/registry. Safe on every kernel: the
+ * disposer's `delete()` runs inside createHandle's try/catch, so the repeated
+ * free after `getKernel().dispose()` is swallowed.
+ */
+export function disposeResultShape(handle) {
+    getKernel().dispose(handle.wrapped);
+    handle[Symbol.dispose]();
+}
+/**
+ * Fast-path cast when the shape type is already known (e.g., from iterShapes).
+ * Skips the shapeType() WASM call — only performs downcast + branded handle creation.
+ * Used internally by topology extractors for bulk sub-shape iteration.
+ */
+export function castShapeWithKnownType(ocShape, knownType, dim) {
+    setCachedType(ocShape, knownType);
+    const dc = getKernel().downcast(ocShape, knownType);
+    if (knownType === 'vertex')
+        return createVertex(dc, dim);
+    if (knownType === 'edge')
+        return createEdge(dc, dim);
+    if (knownType === 'wire')
+        return createWire(dc, dim);
+    if (knownType === 'face')
+        return createFace(dc, dim);
+    if (knownType === 'shell')
+        return createShell(dc);
+    if (knownType === 'solid')
+        return createSolid(dc);
+    if (knownType === 'compsolid')
+        return createCompSolid(dc);
+    return createCompound(dc, dim);
+}
+/**
+ * The result-owning counterpart to {@link castShapeWithKnownType}: casts a
+ * freshly-iterated sub-shape and releases the orphaned pre-downcast handle.
+ * Use for a raw sub-shape the caller owns outright — e.g. each element of
+ * `iterShapes` — where only the branded downcast result is retained. Identity
+ * downcast kernels (manifold/brepkit) skip the release via the guard in
+ * {@link disposeDowncastSource}.
+ */
+export function castResultShapeWithKnownType(ocShape, knownType, dim) {
+    const cast = castShapeWithKnownType(ocShape, knownType, dim);
+    disposeDowncastSource(ocShape, cast);
+    return cast;
+}
+/**
+ * Brand a slot owned by someone else (e.g. the topology cache) as a **borrowed**
+ * handle of a known type — no `downcast` (it would alias the source on occt-wasm
+ * >= 3.7.0), no ownership, no-op disposal. The returned handle shares the source
+ * slot's identity, so `isSame`/`hashCode` still match it; it is valid only while
+ * the owner lives. See {@link createBorrowedHandle}.
+ */
+export function borrowShapeWithKnownType(ocShape, knownType, dim) {
+    setCachedType(ocShape, knownType);
+    return brandHandle(createBorrowedHandle(ocShape), dim);
+}
+//# sourceMappingURL=shapeTypes.js.map

package/dist/vendored/brepjs/core/shapeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeTypes.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/shapeTypes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Branded shape types — type-safe shape discrimination without class hierarchies.\n * Each shape type is a branded ShapeHandle to prevent incorrect assignments.\n *\n * Shapes carry a phantom dimension parameter `D extends Dimension` that tracks\n * whether the shape is embedded in 2D or 3D space. This enables compile-time\n * rejection of dimension mismatches (e.g., fusing a 2D wire with a 3D solid).\n *\n * - Dimension-parameterized types: Vertex, Edge, Wire, Face, Compound (default '3D')\n * - Fixed 3D types: Shell, Solid, CompSolid (always '3D', no parameter)\n *\n * Dimension types (ADR-0004) live in dimensionTypes.ts;\n * validity brands (ADR-0005) live in validityTypes.ts;\n * both are re-exported here for backward compatibility.\n */\n\nimport type { KernelShape, KernelType, ShapeType } from '../kernel/types.js';\nimport { getKernel } from '../kernel/index.js';\nimport type { ShapeHandle } from './disposal.js';\nimport { createHandle, createBorrowedHandle } from './disposal.js';\nimport { is3D } from './dimensionTypes.js';\nimport type { Dimension } from './dimensionTypes.js';\nimport { getShapeKind as _getShapeKind } from './typeDiscriminants.js';\nimport { getOrQueryType, setCachedType } from './shapeTypeCache.js';\n\n// ---------------------------------------------------------------------------\n// Re-exports — dimensionTypes.ts (ADR-0004), validityTypes.ts (ADR-0005),\n//              typeDiscriminants.ts (ADR-0008)\n// ---------------------------------------------------------------------------\n\nexport { getShapeKind } from './typeDiscriminants.js';\n\nexport type {\n  Dimension,\n  DimensionError,\n  RequireDimension,\n  SameDimension,\n} from './dimensionTypes.js';\nexport { is2D, is3D, as2D, as3D } from './dimensionTypes.js';\nexport type {\n  ClosedWire,\n  OrientedFace,\n  ManifoldShell,\n  ValidSolid,\n  PlanarFace,\n  PlanarWire,\n} from './validityTypes.js';\nexport {\n  closedWire,\n  orientedFace,\n  manifoldShell,\n  validSolid,\n  isClosedWire,\n  isOrientedFace,\n  isManifoldShell,\n  isValidSolid,\n  isPlanarFace,\n  isPlanarWire,\n  planarFace,\n  planarWire,\n} from './validityTypes.js';\n\n// ---------------------------------------------------------------------------\n// CurveLike — kernel curve adaptor interface\n// ---------------------------------------------------------------------------\n\n/** Interface for kernel curve adaptors (BRepAdaptor_Curve / CompCurve). */\nexport interface CurveLike {\n  delete(): void;\n  Value(v: number): KernelType;\n  IsPeriodic(): boolean;\n  Period(): number;\n  IsClosed(): boolean;\n  FirstParameter(): number;\n  LastParameter(): number;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- kernel enum return type\n  GetType?(): any;\n  D1(v: number, p: KernelType, vPrime: KernelType): void;\n}\n\n// ---------------------------------------------------------------------------\n// Shape kind discriminant\n// ---------------------------------------------------------------------------\n\n/** String discriminant identifying the topological type of a shape. */\nexport type ShapeKind =\n  'vertex' | 'edge' | 'wire' | 'face' | 'shell' | 'solid' | 'compsolid' | 'compound';\n\n// ---------------------------------------------------------------------------\n// Branded shape types\n// ---------------------------------------------------------------------------\n\n/** Phantom brand key for dimension tracking (never exists at runtime). */\ndeclare const __dim: unique symbol;\ndeclare const __brand: unique symbol;\n\n// Dimension-parameterized types (can be 2D or 3D, default '3D')\n\n/** A topological vertex (0D point). */\nexport type Vertex<D extends Dimension = '3D'> = ShapeHandle & {\n  readonly [__brand]: 'vertex';\n  readonly [__dim]: D;\n};\n/** A topological edge (1D curve segment). */\nexport type Edge<D extends Dimension = '3D'> = ShapeHandle & {\n  readonly [__brand]: 'edge';\n  readonly [__dim]: D;\n};\n/** An ordered sequence of connected edges forming a path or loop. */\nexport type Wire<D extends Dimension = '3D'> = ShapeHandle & {\n  readonly [__brand]: 'wire';\n  readonly [__dim]: D;\n};\n/** A bounded portion of a surface. */\nexport type Face<D extends Dimension = '3D'> = ShapeHandle & {\n  readonly [__brand]: 'face';\n  readonly [__dim]: D;\n};\n\n// Fixed-dimension types (always 3D — no type parameter)\n\n/** A connected set of faces sharing edges. Always 3D. */\nexport type Shell = ShapeHandle & { readonly [__brand]: 'shell'; readonly [__dim]: '3D' };\n/** A closed volume bounded by shells. Always 3D. */\nexport type Solid = ShapeHandle & { readonly [__brand]: 'solid'; readonly [__dim]: '3D' };\n/** A set of solids connected by faces. Always 3D. */\nexport type CompSolid = ShapeHandle & { readonly [__brand]: 'compsolid'; readonly [__dim]: '3D' };\n/** A heterogeneous collection of shapes. */\nexport type Compound<D extends Dimension = '3D'> = ShapeHandle & {\n  readonly [__brand]: 'compound';\n  readonly [__dim]: D;\n};\n\n// ---------------------------------------------------------------------------\n// Union types\n// ---------------------------------------------------------------------------\n\n/** Any branded shape type in a given dimension. Defaults to 3D. */\nexport type AnyShape<D extends Dimension = '3D'> =\n  | Vertex<D>\n  | Edge<D>\n  | Wire<D>\n  | Face<D>\n  | Compound<D>\n  | (D extends '3D' ? Shell | Solid | CompSolid : never);\n\n/** 1D shapes (edges and wires) in a given dimension. */\nexport type Shape1D<D extends Dimension = '3D'> = Edge<D> | Wire<D>;\n\n/** 3D shapes (solid-like). Always 3D by definition. */\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-arguments -- explicit '3D' for documentation clarity\nexport type Shape3D = Shell | Solid | CompSolid | Compound<'3D'>;\n\n/** Any shape whose dimension is unknown (e.g., from file import). Requires narrowing. */\n// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-arguments -- explicit dimensions for documentation clarity\nexport type UnknownDimShape = AnyShape<'2D'> | AnyShape<'3D'>;\n\n// ---------------------------------------------------------------------------\n// Shape factories (brand a handle)\n// ---------------------------------------------------------------------------\n\nfunction brandHandle<D extends Dimension>(handle: ShapeHandle, dim?: D): AnyShape<D> {\n  // brepjs-patterns-disable: no-double-cast\n  if (dim === '2D') (handle as unknown as Record<string, unknown>)['__is2D'] = true;\n  return handle as AnyShape<D>;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Vertex} handle. */\nexport function createVertex<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Vertex<D> {\n  return brandHandle<D>(createHandle(ocShape), dim) as Vertex<D>;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Edge} handle. */\nexport function createEdge<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Edge<D> {\n  return brandHandle<D>(createHandle(ocShape), dim) as Edge<D>;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Wire} handle. */\nexport function createWire<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Wire<D> {\n  return brandHandle<D>(createHandle(ocShape), dim) as Wire<D>;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Face} handle. */\nexport function createFace<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): Face<D> {\n  return brandHandle<D>(createHandle(ocShape), dim) as Face<D>;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Shell} handle. */\nexport function createShell(ocShape: KernelShape): Shell {\n  return brandHandle(createHandle(ocShape)) as Shell;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Solid} handle. */\nexport function createSolid(ocShape: KernelShape): Solid {\n  return brandHandle(createHandle(ocShape)) as Solid;\n}\n\n/** Wrap a raw kernel shape as a branded {@link CompSolid} handle. */\nexport function createCompSolid(ocShape: KernelShape): CompSolid {\n  return brandHandle(createHandle(ocShape)) as CompSolid;\n}\n\n/** Wrap a raw kernel shape as a branded {@link Compound} handle. */\nexport function createCompound<D extends Dimension = '3D'>(\n  ocShape: KernelShape,\n  dim?: D\n): Compound<D> {\n  return brandHandle<D>(createHandle(ocShape), dim) as Compound<D>;\n}\n\n// ---------------------------------------------------------------------------\n// Type guards (runtime checks via kernel ShapeType)\n// ---------------------------------------------------------------------------\n\n/** Type guard — check if a shape is a {@link Vertex}. */\nexport function isVertex<D extends Dimension>(s: AnyShape<D>): s is Vertex<D> {\n  return _getShapeKind(s) === 'vertex';\n}\n\n/** Type guard — check if a shape is an {@link Edge}. */\nexport function isEdge<D extends Dimension>(s: AnyShape<D>): s is Edge<D> {\n  return _getShapeKind(s) === 'edge';\n}\n\n/** Type guard — check if a shape is a {@link Wire}. */\nexport function isWire<D extends Dimension>(s: AnyShape<D>): s is Wire<D> {\n  return _getShapeKind(s) === 'wire';\n}\n\n/** Type guard — check if a shape is a {@link Face}. */\nexport function isFace<D extends Dimension>(s: AnyShape<D>): s is Face<D> {\n  return _getShapeKind(s) === 'face';\n}\n\n/** Type guard — check if a shape is a {@link Shell}. */\nexport function isShell(s: AnyShape<Dimension>): s is Shell {\n  return _getShapeKind(s) === 'shell';\n}\n\n/** Type guard — check if a shape is a {@link Solid}. */\nexport function isSolid(s: AnyShape<Dimension>): s is Solid {\n  return _getShapeKind(s) === 'solid';\n}\n\n/** Type guard — check if a shape is a {@link Compound}. */\nexport function isCompound<D extends Dimension>(s: AnyShape<D>): s is Compound<D> {\n  return _getShapeKind(s) === 'compound';\n}\n\n/** Type guard — check if a shape is a 3D shape (shell, solid, compsolid, or 3D compound). */\nexport function isShape3D(s: AnyShape<Dimension>): s is Shape3D {\n  const kind = _getShapeKind(s);\n  if (kind === 'shell' || kind === 'solid' || kind === 'compsolid') return true;\n  // Compounds can be 2D or 3D — check the runtime dimension marker\n  if (kind === 'compound') return is3D(s);\n  return false;\n}\n\n/** Type guard — check if a shape is a 1D shape (edge or wire). */\nexport function isShape1D<D extends Dimension>(s: AnyShape<D>): s is Shape1D<D> {\n  const kind = _getShapeKind(s);\n  return kind === 'edge' || kind === 'wire';\n}\n\n// ---------------------------------------------------------------------------\n// Cast utility — wraps an kernel shape into the correct branded type\n// ---------------------------------------------------------------------------\n\n/**\n * Wrap a raw kernel shape into a properly branded type.\n * Performs a downcast and wraps in a disposable handle.\n *\n * **Note**: When `D` is `'2D'`, Shell/Solid/CompSolid are not valid members\n * of `AnyShape<'2D'>`. If the kernel shape happens to be one of these types,\n * they will be cast unsoundly. Prefer {@link castShape3D} for shapes known\n * to be 3D, and use the default `castShape()` (which defaults to `'3D'`)\n * for normal usage.\n */\nexport function castShape<D extends Dimension = '3D'>(ocShape: KernelShape, dim?: D): AnyShape<D> {\n  const kernel = getKernel();\n  const st = getOrQueryType(kernel, ocShape);\n  // Pass type to downcast to avoid recomputing ShapeType() in WASM\n  const dc = kernel.downcast(ocShape, st);\n\n  if (st === 'vertex') return createVertex<D>(dc, dim);\n  if (st === 'edge') return createEdge<D>(dc, dim);\n  if (st === 'wire') return createWire<D>(dc, dim);\n  if (st === 'face') return createFace<D>(dc, dim);\n  if (st === 'shell') return createShell(dc) as AnyShape<D>;\n  if (st === 'solid') return createSolid(dc) as AnyShape<D>;\n  if (st === 'compsolid') return createCompSolid(dc) as AnyShape<D>;\n  return createCompound<D>(dc, dim);\n}\n\n/** Type-safe cast for shapes known to be 3D. */\nexport function castShape3D(ocShape: KernelShape): AnyShape {\n  return castShape(ocShape);\n}\n\n/**\n * Release the pre-downcast handle of a freshly-produced kernel result after it\n * has been cast to `cast`.\n *\n * On occt-wasm `downcast` allocates a new arena slot and orphans the input; a\n * handle's own `delete()` is a no-op there, so the input must be released via\n * `getKernel().dispose()` to reclaim the slot. Kernels whose `downcast` is\n * identity (manifold, brepkit) return the same handle as `cast`, so nothing is\n * released — doing so would delete the shape being returned.\n *\n * Use only for a kernel result the caller owns outright — never for a shape\n * received from elsewhere.\n */\nexport function disposeDowncastSource(source: KernelShape, cast: ShapeHandle): void {\n  // On arena kernels (occt-wasm) a handle carries a slot `id`. An identity\n  // downcast (occt-wasm >= 3.7.0) returns the SAME id wrapped in a fresh object,\n  // so compare by id: a plain `!==` on the wrappers would dispose the slot the\n  // returned shape still points to (use-after-free). Kernels whose shapes carry\n  // no `id` fall back to object identity (the original behavior).\n  const srcId = (source as { id?: unknown }).id;\n  const dstId = (cast.wrapped as { id?: unknown }).id;\n  const sameSlot =\n    srcId !== undefined && dstId !== undefined ? srcId === dstId : cast.wrapped === source;\n  if (!sameSlot) getKernel().dispose(source);\n}\n\n/**\n * Cast a freshly-produced kernel result to its branded type and release the\n * orphaned pre-downcast handle. The result-owning counterpart to {@link castShape};\n * see {@link disposeDowncastSource} for the arena semantics.\n */\nexport function castResultShape<D extends Dimension = '3D'>(\n  ocShape: KernelShape,\n  dim?: D\n): AnyShape<D> {\n  const cast = castShape<D>(ocShape, dim);\n  disposeDowncastSource(ocShape, cast);\n  return cast;\n}\n\n/**\n * Fully release a transiently-branded sub-shape and the raw handle it was cast\n * from — for a face/edge iterated only to read a property, then discarded.\n *\n * `handle`'s dispose updates stats and, on kernels that own their native object\n * (Embind, manifold, brepkit), frees it. occt-wasm handles are arena-backed\n * (their delete is a no-op), so when the downcast produced a distinct handle\n * (`handle.wrapped !== rawSource`) both arena slots are released explicitly. The\n * identity guard also skips manifold/brepkit — there `handle` *is* `rawSource`,\n * already freed above, and their `dispose()` has no double-free guard.\n */\nexport function disposeTransientSubShape(handle: ShapeHandle, rawSource: KernelShape): void {\n  const downcast = handle.wrapped;\n  handle[Symbol.dispose]();\n  if (downcast !== rawSource) {\n    const kernel = getKernel();\n    kernel.dispose(downcast);\n    kernel.dispose(rawSource);\n  }\n}\n\n/**\n * Release a branded shape on an error path — when a cast result is rejected and\n * discarded. Releases the arena slot (occt-wasm's own `delete` is a no-op) then\n * runs the handle's disposer for stats/registry. Safe on every kernel: the\n * disposer's `delete()` runs inside createHandle's try/catch, so the repeated\n * free after `getKernel().dispose()` is swallowed.\n */\nexport function disposeResultShape(handle: ShapeHandle): void {\n  getKernel().dispose(handle.wrapped);\n  handle[Symbol.dispose]();\n}\n\n/**\n * Fast-path cast when the shape type is already known (e.g., from iterShapes).\n * Skips the shapeType() WASM call — only performs downcast + branded handle creation.\n * Used internally by topology extractors for bulk sub-shape iteration.\n */\nexport function castShapeWithKnownType<D extends Dimension = '3D'>(\n  ocShape: KernelShape,\n  knownType: ShapeType,\n  dim?: D\n): AnyShape<D> {\n  setCachedType(ocShape, knownType);\n  const dc = getKernel().downcast(ocShape, knownType);\n  if (knownType === 'vertex') return createVertex<D>(dc, dim);\n  if (knownType === 'edge') return createEdge<D>(dc, dim);\n  if (knownType === 'wire') return createWire<D>(dc, dim);\n  if (knownType === 'face') return createFace<D>(dc, dim);\n  if (knownType === 'shell') return createShell(dc) as AnyShape<D>;\n  if (knownType === 'solid') return createSolid(dc) as AnyShape<D>;\n  if (knownType === 'compsolid') return createCompSolid(dc) as AnyShape<D>;\n  return createCompound<D>(dc, dim);\n}\n\n/**\n * The result-owning counterpart to {@link castShapeWithKnownType}: casts a\n * freshly-iterated sub-shape and releases the orphaned pre-downcast handle.\n * Use for a raw sub-shape the caller owns outright — e.g. each element of\n * `iterShapes` — where only the branded downcast result is retained. Identity\n * downcast kernels (manifold/brepkit) skip the release via the guard in\n * {@link disposeDowncastSource}.\n */\nexport function castResultShapeWithKnownType<D extends Dimension = '3D'>(\n  ocShape: KernelShape,\n  knownType: ShapeType,\n  dim?: D\n): AnyShape<D> {\n  const cast = castShapeWithKnownType<D>(ocShape, knownType, dim);\n  disposeDowncastSource(ocShape, cast);\n  return cast;\n}\n\n/**\n * Brand a slot owned by someone else (e.g. the topology cache) as a **borrowed**\n * handle of a known type — no `downcast` (it would alias the source on occt-wasm\n * >= 3.7.0), no ownership, no-op disposal. The returned handle shares the source\n * slot's identity, so `isSame`/`hashCode` still match it; it is valid only while\n * the owner lives. See {@link createBorrowedHandle}.\n */\nexport function borrowShapeWithKnownType<D extends Dimension = '3D'>(\n  ocShape: KernelShape,\n  knownType: ShapeType,\n  dim?: D\n): AnyShape<D> {\n  setCachedType(ocShape, knownType);\n  return brandHandle<D>(createBorrowedHandle(ocShape), dim);\n}\n"]}

package/dist/vendored/brepjs/core/typeDiscriminants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Type discriminants — maps kernel enum values to string discriminants.
+ *
+ * Consolidates all kernel-enum-to-string mapping in one file:
+ * - `findCurveType()` — GeomAbs_CurveType → CurveType string
+ * - `getShapeKind()` — TopAbs_ShapeEnum → ShapeKind string
+ *
+ * Renamed from definitionMaps.ts (ADR-0008).
+ */
+import { type Result } from './result.js';
+import type { AnyShape, ShapeKind } from './shapeTypes.js';
+import type { Dimension } from './dimensionTypes.js';
+/** Discriminant for the geometric type of a 3D curve. */
+export type CurveType = 'LINE' | 'CIRCLE' | 'ELLIPSE' | 'HYPERBOLA' | 'PARABOLA' | 'BEZIER_CURVE' | 'BSPLINE_CURVE' | 'OFFSET_CURVE' | 'OTHER_CURVE';
+/**
+ * Map a kernel curve type enum value to its string discriminant.
+ *
+ * @returns `Ok<CurveType>` on success, or `Err` if the enum value is unrecognised.
+ */
+export declare const findCurveType: (type: number | {
+    value: number;
+}) => Result<CurveType>;
+/** Query the kernel for the topological type of a shape. */
+export declare function getShapeKind(shape: AnyShape<Dimension>): ShapeKind;
+//# sourceMappingURL=typeDiscriminants.d.ts.map

package/dist/vendored/brepjs/core/typeDiscriminants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeDiscriminants.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/typeDiscriminants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,aAAa,CAAC;AAGnD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAOrD,yDAAyD;AACzD,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,GACV,cAAc,GACd,eAAe,GACf,cAAc,GACd,aAAa,CAAC;AAmBlB;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,CAAC,SAAS,CAMhF,CAAC;AAMF,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAElE"}

package/dist/vendored/brepjs/core/typeDiscriminants.js

@@ -0,0 +1,50 @@
+/**
+ * Type discriminants — maps kernel enum values to string discriminants.
+ *
+ * Consolidates all kernel-enum-to-string mapping in one file:
+ * - `findCurveType()` — GeomAbs_CurveType → CurveType string
+ * - `getShapeKind()` — TopAbs_ShapeEnum → ShapeKind string
+ *
+ * Renamed from definitionMaps.ts (ADR-0008).
+ */
+import { ok, err } from './result.js';
+import { typeCastError } from './errors.js';
+import { getKernel } from '../kernel/index.js';
+import { getOrQueryType } from './shapeTypeCache.js';
+/**
+ * GeomAbs_CurveType integer constants (stable across kernel versions).
+ * Line=0, Circle=1, Ellipse=2, Hyperbola=3, Parabola=4,
+ * BezierCurve=5, BSplineCurve=6, OffsetCurve=7, OtherCurve=8.
+ */
+const CURVE_TYPE_BY_INT = [
+    'LINE', // 0
+    'CIRCLE', // 1
+    'ELLIPSE', // 2
+    'HYPERBOLA', // 3
+    'PARABOLA', // 4
+    'BEZIER_CURVE', // 5
+    'BSPLINE_CURVE', // 6
+    'OFFSET_CURVE', // 7
+    'OTHER_CURVE', // 8
+];
+/**
+ * Map a kernel curve type enum value to its string discriminant.
+ *
+ * @returns `Ok<CurveType>` on success, or `Err` if the enum value is unrecognised.
+ */
+export const findCurveType = (type) => {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-conversion -- WASM enum .value may be boxed; Number() ensures plain number
+    const idx = typeof type === 'number' ? type : Number(type.value);
+    const curveType = CURVE_TYPE_BY_INT[idx];
+    if (!curveType)
+        return err(typeCastError('UNKNOWN_CURVE_TYPE', 'Unknown curve type'));
+    return ok(curveType);
+};
+// ---------------------------------------------------------------------------
+// ShapeKind discriminant
+// ---------------------------------------------------------------------------
+/** Query the kernel for the topological type of a shape. */
+export function getShapeKind(shape) {
+    return getOrQueryType(getKernel(), shape.wrapped);
+}
+//# sourceMappingURL=typeDiscriminants.js.map

package/dist/vendored/brepjs/core/typeDiscriminants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeDiscriminants.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/typeDiscriminants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrD;;;;GAIG;AACH,MAAM,iBAAiB,GAAgB;IACrC,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAgC,EAAqB,EAAE;IACnF,6IAA6I;IAC7I,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC,aAAa,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACtF,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,OAAO,cAAc,CAAC,SAAS,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Type discriminants — maps kernel enum values to string discriminants.\n *\n * Consolidates all kernel-enum-to-string mapping in one file:\n * - `findCurveType()` — GeomAbs_CurveType → CurveType string\n * - `getShapeKind()` — TopAbs_ShapeEnum → ShapeKind string\n *\n * Renamed from definitionMaps.ts (ADR-0008).\n */\n\nimport { type Result, ok, err } from './result.js';\nimport { typeCastError } from './errors.js';\nimport { getKernel } from '../kernel/index.js';\nimport type { AnyShape, ShapeKind } from './shapeTypes.js';\nimport type { Dimension } from './dimensionTypes.js';\nimport { getOrQueryType } from './shapeTypeCache.js';\n\n// ---------------------------------------------------------------------------\n// CurveType discriminant\n// ---------------------------------------------------------------------------\n\n/** Discriminant for the geometric type of a 3D curve. */\nexport type CurveType =\n  | 'LINE'\n  | 'CIRCLE'\n  | 'ELLIPSE'\n  | 'HYPERBOLA'\n  | 'PARABOLA'\n  | 'BEZIER_CURVE'\n  | 'BSPLINE_CURVE'\n  | 'OFFSET_CURVE'\n  | 'OTHER_CURVE';\n\n/**\n * GeomAbs_CurveType integer constants (stable across kernel versions).\n * Line=0, Circle=1, Ellipse=2, Hyperbola=3, Parabola=4,\n * BezierCurve=5, BSplineCurve=6, OffsetCurve=7, OtherCurve=8.\n */\nconst CURVE_TYPE_BY_INT: CurveType[] = [\n  'LINE', // 0\n  'CIRCLE', // 1\n  'ELLIPSE', // 2\n  'HYPERBOLA', // 3\n  'PARABOLA', // 4\n  'BEZIER_CURVE', // 5\n  'BSPLINE_CURVE', // 6\n  'OFFSET_CURVE', // 7\n  'OTHER_CURVE', // 8\n];\n\n/**\n * Map a kernel curve type enum value to its string discriminant.\n *\n * @returns `Ok<CurveType>` on success, or `Err` if the enum value is unrecognised.\n */\nexport const findCurveType = (type: number | { value: number }): Result<CurveType> => {\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-conversion -- WASM enum .value may be boxed; Number() ensures plain number\n  const idx = typeof type === 'number' ? type : Number(type.value);\n  const curveType = CURVE_TYPE_BY_INT[idx];\n  if (!curveType) return err(typeCastError('UNKNOWN_CURVE_TYPE', 'Unknown curve type'));\n  return ok(curveType);\n};\n\n// ---------------------------------------------------------------------------\n// ShapeKind discriminant\n// ---------------------------------------------------------------------------\n\n/** Query the kernel for the topological type of a shape. */\nexport function getShapeKind(shape: AnyShape<Dimension>): ShapeKind {\n  return getOrQueryType(getKernel(), shape.wrapped);\n}\n"]}