@faicad/faijs 0.13.0

package/dist/brep/text/text-to-solid.js

@@ -0,0 +1,218 @@
+/**
+ * 文字 → OCCT wire/face 转换
+ *
+ * 适配自 brepjs `src/text/text-to-solid.ts`。
+ * 保留文件名和核心算法，适配本项目的 occt-wasm API。
+ *
+ * 与 brepjs 的差异：
+ * - brepjs 用 BlueprintSketcher 构造 wire → 本项目直接用 kernel.makeLineEdge / makeBezierEdge
+ * - brepjs 用 organiseBlueprints 处理孔洞 → 本项目用 makeFace 直接构建（OCCT 自动处理内孔）
+ * - brepjs 用 sketchOnPlane → 本项目直接在 XY 平面构造然后按需变换
+ *
+ * opentype.js 路径命令 → OCCT edge 映射：
+ * - M (moveTo) → 开始新子路径
+ * - L (lineTo) → kernel.makeLineEdge(prev, curr)
+ * - C (cubicBezier) → kernel.makeBezierEdge([p0, cp1, cp2, p1])
+ * - Q (quadraticBezier) → 转换为三次贝塞尔后用 makeBezierEdge
+ * - Z (closePath) → 闭合 wire
+ */
+import { getFont } from './fontRegistry.js';
+/** 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0） */
+function toPt(x, y) {
+    // 与 mesh 路径一致：不翻转 X 轴，文字从左到右
+    return { x, y, z: 0 };
+}
+/**
+ * 将 opentype.js 二次贝塞尔转换为三次贝塞尔的控制点。
+ *
+ * Q: P0 → P1 (cp) → P2
+ * C: P0 → C1 → C2 → P2
+ * C1 = P0 + 2/3 * (P1 - P0) = (2*P1 + P0) / 3
+ * C2 = P2 + 2/3 * (P1 - P2) = (2*P1 + P2) / 3
+ */
+function quadToCubic(p0, cp, p2) {
+    const c1 = {
+        x: (2 * cp.x + p0.x) / 3,
+        y: (2 * cp.y + p0.y) / 3,
+        z: 0,
+    };
+    const c2 = {
+        x: (2 * cp.x + p2.x) / 3,
+        y: (2 * cp.y + p2.y) / 3,
+        z: 0,
+    };
+    return [c1, c2];
+}
+/**
+ * 用 OCCT 贝塞尔边构造一段三次贝塞尔曲线。
+ *
+ * 三次贝塞尔曲线有 4 个控制点：P0, C1, C2, P1。
+ * occt-wasm 的 makeBezierEdge 接受 Vec3[] 控制点数组。
+ */
+function makeBezierFromPoints(kernel, p0, c1, c2, p1) {
+    return kernel.makeBezierEdge([p0, c1, c2, p1]);
+}
+/**
+ * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire）。
+ *
+ * @param kernel OCCT 内核
+ * @param text 文字字符串
+ * @param options 配置选项
+ * @returns BrepHandle 数组（每个是一个闭合 wire）
+ */
+export function textBlueprints(kernel, text, options = {}) {
+    const { startX = 0, startY = 0, fontSize = 16, fontFamily = 'default' } = options;
+    let font = getFont(fontFamily);
+    if (!font)
+        font = getFont();
+    if (!font) {
+        throw new Error('[textBlueprints] No fonts loaded. Call loadFont() before using text functions.');
+    }
+    // 检查缺字形（CJK 字符在 OpenSans Regular 中没有对应字形）
+    for (const ch of text) {
+        if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r')
+            continue;
+        const glyph = font.charToGlyph(ch);
+        if (glyph.index === 0) {
+            throw new Error(`[textBlueprints] Character "${ch}" (U+${ch.codePointAt(0).toString(16).toUpperCase()}) ` +
+                `not found in font. If it is a CJK character, a CJK font must be loaded.`);
+        }
+    }
+    // 获取文字路径
+    const path = font.getPath(text, startX, startY, fontSize);
+    const commands = path.commands;
+    const wires = [];
+    const allEdges = [];
+    let currentEdges = [];
+    let lastPt = null;
+    let subpathStart = null;
+    for (const cmd of commands) {
+        switch (cmd.type) {
+            case 'M': {
+                // 开始新子路径 — 如果当前有 edges，先构建 wire
+                if (currentEdges.length > 0) {
+                    const wire = kernel.makeWire(currentEdges);
+                    wires.push(wire);
+                    allEdges.push(...currentEdges);
+                    currentEdges = [];
+                }
+                lastPt = toPt(cmd.x, cmd.y);
+                subpathStart = lastPt;
+                break;
+            }
+            case 'L': {
+                if (!lastPt) {
+                    lastPt = toPt(cmd.x, cmd.y);
+                    subpathStart = lastPt;
+                    break;
+                }
+                const curr = toPt(cmd.x, cmd.y);
+                // 跳过零长度边
+                if (Math.abs(curr.x - lastPt.x) > 1e-9 || Math.abs(curr.y - lastPt.y) > 1e-9) {
+                    const edge = kernel.makeLineEdge(lastPt, curr);
+                    currentEdges.push(edge);
+                    allEdges.push(edge);
+                }
+                lastPt = curr;
+                break;
+            }
+            case 'Q': {
+                if (!lastPt)
+                    break;
+                const cp = toPt(cmd.x1, cmd.y1);
+                const endPt = toPt(cmd.x, cmd.y);
+                // 转换为三次贝塞尔
+                const [c1, c2] = quadToCubic(lastPt, cp, endPt);
+                const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt);
+                currentEdges.push(edge);
+                allEdges.push(edge);
+                lastPt = endPt;
+                break;
+            }
+            case 'C': {
+                if (!lastPt)
+                    break;
+                const c1 = toPt(cmd.x1, cmd.y1);
+                const c2 = toPt(cmd.x2, cmd.y2);
+                const endPt = toPt(cmd.x, cmd.y);
+                const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt);
+                currentEdges.push(edge);
+                allEdges.push(edge);
+                lastPt = endPt;
+                break;
+            }
+            case 'Z': {
+                // 闭合 — 如果有起点，添加闭合边
+                if (subpathStart && lastPt &&
+                    (Math.abs(subpathStart.x - lastPt.x) > 1e-9 || Math.abs(subpathStart.y - lastPt.y) > 1e-9)) {
+                    const edge = kernel.makeLineEdge(lastPt, subpathStart);
+                    currentEdges.push(edge);
+                    allEdges.push(edge);
+                }
+                // 构建 wire
+                if (currentEdges.length > 0) {
+                    const wire = kernel.makeWire(currentEdges);
+                    wires.push(wire);
+                    allEdges.push(...currentEdges);
+                    currentEdges = [];
+                }
+                lastPt = null;
+                subpathStart = null;
+                break;
+            }
+        }
+    }
+    // 处理最后一个未闭合的子路径
+    if (currentEdges.length > 0) {
+        const wire = kernel.makeWire(currentEdges);
+        wires.push(wire);
+        allEdges.push(...currentEdges);
+    }
+    // 释放所有边（wire 已共享 TShape）
+    for (const e of allEdges) {
+        kernel.release(e);
+    }
+    return wires;
+}
+/**
+ * 将文字转换为 OCCT 3D solid（face → extrude → fuse）。
+ *
+ * @param kernel OCCT 内核
+ * @param text 文字字符串
+ * @param options 配置选项
+ * @returns BrepHandle（合并后的 solid）
+ */
+export function textToSolid(kernel, text, options) {
+    const { fontSize = 16, fontFamily = 'default', depth } = options;
+    const wires = textBlueprints(kernel, text, { fontSize, fontFamily });
+    if (wires.length === 0) {
+        throw new Error('[textToSolid] no wires generated from text');
+    }
+    // 为每个 wire 创建 face → extrude
+    const solids = [];
+    for (const wire of wires) {
+        try {
+            const face = kernel.makeFace(wire);
+            const solid = kernel.extrude(face, 0, 0, depth);
+            kernel.release(face);
+            solids.push(solid);
+        }
+        catch {
+            // 某些 wire 可能无法构建 face（如开放线框）— 跳过
+        }
+        kernel.release(wire);
+    }
+    if (solids.length === 0) {
+        throw new Error('[textToSolid] no solids generated from wires');
+    }
+    // Fuse 所有 solid
+    let result = solids[0];
+    for (let i = 1; i < solids.length; i++) {
+        const prev = result;
+        result = kernel.fuse(prev, solids[i]);
+        kernel.release(prev);
+        kernel.release(solids[i]);
+    }
+    return result;
+}
+//# sourceMappingURL=text-to-solid.js.map

package/dist/brep/text/text-to-solid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-to-solid.js","sourceRoot":"","sources":["../../../src/brep/text/text-to-solid.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 文字 → OCCT wire/face 转换\n *\n * 适配自 brepjs `src/text/text-to-solid.ts`。\n * 保留文件名和核心算法，适配本项目的 occt-wasm API。\n *\n * 与 brepjs 的差异：\n * - brepjs 用 BlueprintSketcher 构造 wire → 本项目直接用 kernel.makeLineEdge / makeBezierEdge\n * - brepjs 用 organiseBlueprints 处理孔洞 → 本项目用 makeFace 直接构建（OCCT 自动处理内孔）\n * - brepjs 用 sketchOnPlane → 本项目直接在 XY 平面构造然后按需变换\n *\n * opentype.js 路径命令 → OCCT edge 映射：\n * - M (moveTo) → 开始新子路径\n * - L (lineTo) → kernel.makeLineEdge(prev, curr)\n * - C (cubicBezier) → kernel.makeBezierEdge([p0, cp1, cp2, p1])\n * - Q (quadraticBezier) → 转换为三次贝塞尔后用 makeBezierEdge\n * - Z (closePath) → 闭合 wire\n */\n\nimport type { BrepHandle } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport type { Font } from 'opentype.js'\nimport type { PathCommand } from 'opentype.js'\nimport { getFont } from './fontRegistry'\n\n/** 点坐标（OCCT 格式） */\ninterface Pt { x: number; y: number; z: number }\n\n/** 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0） */\nfunction toPt(x: number, y: number): Pt {\n  // 与 mesh 路径一致：不翻转 X 轴，文字从左到右\n  return { x, y, z: 0 }\n}\n\n/**\n * 将 opentype.js 二次贝塞尔转换为三次贝塞尔的控制点。\n *\n * Q: P0 → P1 (cp) → P2\n * C: P0 → C1 → C2 → P2\n * C1 = P0 + 2/3 * (P1 - P0) = (2*P1 + P0) / 3\n * C2 = P2 + 2/3 * (P1 - P2) = (2*P1 + P2) / 3\n */\nfunction quadToCubic(\n  p0: Pt, cp: Pt, p2: Pt,\n): [Pt, Pt] {\n  const c1 = {\n    x: (2 * cp.x + p0.x) / 3,\n    y: (2 * cp.y + p0.y) / 3,\n    z: 0,\n  }\n  const c2 = {\n    x: (2 * cp.x + p2.x) / 3,\n    y: (2 * cp.y + p2.y) / 3,\n    z: 0,\n  }\n  return [c1, c2]\n}\n\n/**\n * 用 OCCT 贝塞尔边构造一段三次贝塞尔曲线。\n *\n * 三次贝塞尔曲线有 4 个控制点：P0, C1, C2, P1。\n * occt-wasm 的 makeBezierEdge 接受 Vec3[] 控制点数组。\n */\nfunction makeBezierFromPoints(\n  kernel: BrepEngineApi,\n  p0: Pt, c1: Pt, c2: Pt, p1: Pt,\n): BrepHandle {\n  return kernel.makeBezierEdge([p0, c1, c2, p1])\n}\n\n/**\n * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle 数组（每个是一个闭合 wire）\n */\nexport function textBlueprints(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    startX?: number\n    startY?: number\n    fontSize?: number\n    fontFamily?: string\n  } = {},\n): BrepHandle[] {\n  const { startX = 0, startY = 0, fontSize = 16, fontFamily = 'default' } = options\n\n  let font: Font | undefined = getFont(fontFamily)\n  if (!font) font = getFont()\n  if (!font) {\n    throw new Error('[textBlueprints] No fonts loaded. Call loadFont() before using text functions.')\n  }\n\n  // 检查缺字形（CJK 字符在 OpenSans Regular 中没有对应字形）\n  for (const ch of text) {\n    if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r') continue\n    const glyph = font.charToGlyph(ch)\n    if (glyph.index === 0) {\n      throw new Error(\n        `[textBlueprints] Character \"${ch}\" (U+${ch.codePointAt(0)!.toString(16).toUpperCase()}) ` +\n        `not found in font. If it is a CJK character, a CJK font must be loaded.`,\n      )\n    }\n  }\n\n  // 获取文字路径\n  const path = font.getPath(text, startX, startY, fontSize)\n  const commands = path.commands as PathCommand[]\n\n  const wires: BrepHandle[] = []\n  const allEdges: BrepHandle[] = []\n\n  let currentEdges: BrepHandle[] = []\n  let lastPt: Pt | null = null\n  let subpathStart: Pt | null = null\n\n  for (const cmd of commands) {\n    switch (cmd.type) {\n      case 'M': {\n        // 开始新子路径 — 如果当前有 edges，先构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push(wire)\n          allEdges.push(...currentEdges)\n          currentEdges = []\n        }\n        lastPt = toPt(cmd.x!, cmd.y!)\n        subpathStart = lastPt\n        break\n      }\n      case 'L': {\n        if (!lastPt) {\n          lastPt = toPt(cmd.x!, cmd.y!)\n          subpathStart = lastPt\n          break\n        }\n        const curr = toPt(cmd.x!, cmd.y!)\n        // 跳过零长度边\n        if (Math.abs(curr.x - lastPt.x) > 1e-9 || Math.abs(curr.y - lastPt.y) > 1e-9) {\n          const edge = kernel.makeLineEdge(lastPt, curr)\n          currentEdges.push(edge)\n          allEdges.push(edge)\n        }\n        lastPt = curr\n        break\n      }\n      case 'Q': {\n        if (!lastPt) break\n        const cp = toPt(cmd.x1!, cmd.y1!)\n        const endPt = toPt(cmd.x!, cmd.y!)\n        // 转换为三次贝塞尔\n        const [c1, c2] = quadToCubic(lastPt, cp, endPt)\n        const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt)\n        currentEdges.push(edge)\n        allEdges.push(edge)\n        lastPt = endPt\n        break\n      }\n      case 'C': {\n        if (!lastPt) break\n        const c1 = toPt(cmd.x1!, cmd.y1!)\n        const c2 = toPt(cmd.x2!, cmd.y2!)\n        const endPt = toPt(cmd.x!, cmd.y!)\n        const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt)\n        currentEdges.push(edge)\n        allEdges.push(edge)\n        lastPt = endPt\n        break\n      }\n      case 'Z': {\n        // 闭合 — 如果有起点，添加闭合边\n        if (subpathStart && lastPt &&\n            (Math.abs(subpathStart.x - lastPt.x) > 1e-9 || Math.abs(subpathStart.y - lastPt.y) > 1e-9)) {\n          const edge = kernel.makeLineEdge(lastPt, subpathStart)\n          currentEdges.push(edge)\n          allEdges.push(edge)\n        }\n        // 构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push(wire)\n          allEdges.push(...currentEdges)\n          currentEdges = []\n        }\n        lastPt = null\n        subpathStart = null\n        break\n      }\n    }\n  }\n\n  // 处理最后一个未闭合的子路径\n  if (currentEdges.length > 0) {\n    const wire = kernel.makeWire(currentEdges)\n    wires.push(wire)\n    allEdges.push(...currentEdges)\n  }\n\n  // 释放所有边（wire 已共享 TShape）\n  for (const e of allEdges) {\n    kernel.release(e)\n  }\n\n  return wires\n}\n\n/**\n * 将文字转换为 OCCT 3D solid（face → extrude → fuse）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle（合并后的 solid）\n */\nexport function textToSolid(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    fontSize?: number\n    fontFamily?: string\n    depth: number\n  },\n): BrepHandle {\n  const { fontSize = 16, fontFamily = 'default', depth } = options\n\n  const wires = textBlueprints(kernel, text, { fontSize, fontFamily })\n\n  if (wires.length === 0) {\n    throw new Error('[textToSolid] no wires generated from text')\n  }\n\n  // 为每个 wire 创建 face → extrude\n  const solids: BrepHandle[] = []\n  for (const wire of wires) {\n    try {\n      const face = kernel.makeFace(wire)\n      const solid = kernel.extrude(face, 0, 0, depth)\n      kernel.release(face)\n      solids.push(solid)\n    } catch {\n      // 某些 wire 可能无法构建 face（如开放线框）— 跳过\n    }\n    kernel.release(wire)\n  }\n\n  if (solids.length === 0) {\n    throw new Error('[textToSolid] no solids generated from wires')\n  }\n\n  // Fuse 所有 solid\n  let result = solids[0]\n  for (let i = 1; i < solids.length; i++) {\n    const prev = result\n    result = kernel.fuse(prev, solids[i])\n    kernel.release(prev)\n    kernel.release(solids[i])\n  }\n\n  return result\n}\n"]}

package/dist/brepjs-compat.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Source-side alias for the public `@faicad/faijs/brepjs-compat` subpath.
+ *
+ * Why this file exists: `packages/core/package.json` exports the compat face as
+ * `./brepjs-compat -> ./dist/api/brepjs-compat/index.js`, while every local
+ * toolchain that consumes live sources resolves `@faicad/faijs` by *prefix*
+ * substitution onto `packages/core/src` (vitest `resolve.alias` in 8 configs,
+ * `tsconfig.json` `paths`, the demo Vite config). A prefix alias rewrites the
+ * subpath to `src/brepjs-compat`; TypeScript then falls back to node_modules
+ * (hitting `dist/`) but Vite does not, so library sources such as
+ * `packages/sheetmetal/src/*.ts` failed with "Cannot find module".
+ *
+ * Keeping the alias inside the source tree makes the src layout mirror the
+ * exports map, so no per-toolchain config has to special-case this subpath.
+ *
+ * Projection only — the compat face keeps its single implementation in
+ * `./api/brepjs-compat/index.ts`.
+ */
+export * from './api/brepjs-compat/index.js';
+//# sourceMappingURL=brepjs-compat.d.ts.map

package/dist/brepjs-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brepjs-compat.d.ts","sourceRoot":"","sources":["../src/brepjs-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,8BAA8B,CAAA"}

package/dist/brepjs-compat.js

@@ -0,0 +1,20 @@
+/**
+ * Source-side alias for the public `@faicad/faijs/brepjs-compat` subpath.
+ *
+ * Why this file exists: `packages/core/package.json` exports the compat face as
+ * `./brepjs-compat -> ./dist/api/brepjs-compat/index.js`, while every local
+ * toolchain that consumes live sources resolves `@faicad/faijs` by *prefix*
+ * substitution onto `packages/core/src` (vitest `resolve.alias` in 8 configs,
+ * `tsconfig.json` `paths`, the demo Vite config). A prefix alias rewrites the
+ * subpath to `src/brepjs-compat`; TypeScript then falls back to node_modules
+ * (hitting `dist/`) but Vite does not, so library sources such as
+ * `packages/sheetmetal/src/*.ts` failed with "Cannot find module".
+ *
+ * Keeping the alias inside the source tree makes the src layout mirror the
+ * exports map, so no per-toolchain config has to special-case this subpath.
+ *
+ * Projection only — the compat face keeps its single implementation in
+ * `./api/brepjs-compat/index.ts`.
+ */
+export * from './api/brepjs-compat/index.js';
+//# sourceMappingURL=brepjs-compat.js.map

package/dist/brepjs-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brepjs-compat.js","sourceRoot":"","sources":["../src/brepjs-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,8BAA8B,CAAA","sourcesContent":["/**\n * Source-side alias for the public `@faicad/faijs/brepjs-compat` subpath.\n *\n * Why this file exists: `packages/core/package.json` exports the compat face as\n * `./brepjs-compat -> ./dist/api/brepjs-compat/index.js`, while every local\n * toolchain that consumes live sources resolves `@faicad/faijs` by *prefix*\n * substitution onto `packages/core/src` (vitest `resolve.alias` in 8 configs,\n * `tsconfig.json` `paths`, the demo Vite config). A prefix alias rewrites the\n * subpath to `src/brepjs-compat`; TypeScript then falls back to node_modules\n * (hitting `dist/`) but Vite does not, so library sources such as\n * `packages/sheetmetal/src/*.ts` failed with \"Cannot find module\".\n *\n * Keeping the alias inside the source tree makes the src layout mirror the\n * exports map, so no per-toolchain config has to special-case this subpath.\n *\n * Projection only — the compat face keeps its single implementation in\n * `./api/brepjs-compat/index.ts`.\n */\nexport * from './api/brepjs-compat/index.js'\n"]}

package/dist/brepkit-kernel/brepkitKernel.d.ts

@@ -0,0 +1,29 @@
+/**
+ * brepkit-kernel/brepkitKernel — brepkit 内核 → faijs BrepEngineApi 适配器（v1 白名单）
+ *
+ * 设计要点（对应 3d_editor/docs/plans/2026-09-18-weapp-voice-ai-modeling-design.md §5）：
+ * - 句柄：brepkit u32 句柄与 faijs BrepHandle(number) 同构，直通零转换；
+ * - 拓扑红线：meshShape 用 tessellateSolidGrouped 输出 faceGroups，与三角化几何同源；
+ * - 面溯源：布尔/倒角走 *WithEvolution，映射为 BrepEvolutionData（hash 编码）；
+ * - 链纪律：kernel.meshFallbackCount 计数差 > 0 → getMeshFallbackCount 暴露给宿主，
+ *   由宿主标记 BREP 链中断（不在此层静默处理）；
+ * - v1 白名单之外的方法：显式抛错（报错好于掩盖，禁止空实现假成功）。
+ */
+import type { BrepEngineApi } from '../brep/engine/primitives.js';
+/** brepkit 适配器返回类型：BrepEngineApi + brepkit 专属诊断。 */
+type BrepkitEngineExtras = BrepEngineApi & {
+    getMeshFallbackCount(): number;
+};
+/**
+ * 创建 brepkit BrepEngineApi 实现（v1 白名单）。
+ * 与 occt 的 initOcctWasm 同位：返回满足引擎契约的原语集合。
+ * @returns a promise resolving to the BrepEngineApi implementation plus brepkit-specific
+ * diagnostics (`getMeshFallbackCount`).
+ */
+export declare function createBrepkitPrimitives(): Promise<BrepkitEngineExtras>;
+/** 释放内核单例（测试收尾用；宿主常驻不需调用）。 */
+export declare function disposeBrepkit(): void;
+/** brepkit 适配器原语集类型（BrepEngineApi + brepkit 专属诊断 getMeshFallbackCount）。 */
+export type BrepkitPrimitives = Awaited<ReturnType<typeof createBrepkitPrimitives>>;
+export {};
+//# sourceMappingURL=brepkitKernel.d.ts.map

package/dist/brepkit-kernel/brepkitKernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brepkitKernel.d.ts","sourceRoot":"","sources":["../../src/brepkit-kernel/brepkitKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAkI9D,oDAAoD;AACpD,KAAK,mBAAmB,GAAG,aAAa,GAAG;IAAE,oBAAoB,IAAI,MAAM,CAAA;CAAE,CAAA;AAE7E;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAgX5E;AAwCD,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAA"}