@faicad/faijs 0.13.0

package/dist/runtime-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.js","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * runtime-state — 全局运行时状态锚点（零依赖层）\n *\n *\n * 本模块位于 L0+（零运行时依赖），是 L3 API 面（core/src/api，原 stdlib）与\n * cad-runtime（L2）之间唯一的共享状态。**放在这一层是为了避免循环依赖**：\n * api/ 不能 import cad-runtime（cad-runtime/api-namespace.ts 已经 import 了 api/）。\n *\n * 承载三类状态：\n * 1. Backends —— 宿主注入的环境资源（内核 / 端口 / 模式 / 标准库命名空间）\n * 2. 当前执行语句 —— keep() 归属用（引擎在语句 fn 之前设置）\n * 3. Shape 身份表 —— 构造器登记（isShape 依据）与 Shape→PartName 反查\n *\n * ⚠️ 依赖方向红线：本文件不得 import 任何 src/ 下的模块（只可 import type）。\n */\n\nimport type { PartName } from './identity'\n\n/**\n * Lightweight execution anchor — carries only the fields consumed by\n * library functions via getCurrentStmt(): `id` (StmtId), `outputs` (PartName[]),\n * `callee`, and `hasAssignment`. The DirectExecutor creates these from\n * line-number + writes.\n */\nexport interface ExecutionAnchor {\n  readonly id: string\n  readonly outputs: PartName[]\n  readonly callee?: string\n  readonly hasAssignment?: boolean\n}\n\n// ── 后端配置（宿主注入的环境资源）──\n\n/**\n * 执行模式（与 src/cad-runtime/ports.ts 的 ExecutionMode 保持一致）。\n * 此处重复定义是为了保持本模块零依赖；由守卫测试保证两者一致。\n */\nexport type RuntimeExecutionMode = 'auto' | 'brep' | 'mesh'\n\n/** 宿主注入的环境资源。字段类型用宽松结构，避免本模块依赖具体实现。 */\nexport interface Backends {\n  /** 契约版本（装配期校验，不兼容即抛错） */\n  readonly contractVersion: number\n  /** 执行配置（可变对象，宿主可在运行期切换） */\n  readonly config: {\n    mode: RuntimeExecutionMode\n    /** 当前 BREP 引擎 id（注册表首个注册者；未注册为 null）。能力路由读（§8.4）。 */\n    brepEngineId?: string | null\n    /** 当前引擎能力声明（宽松结构，零依赖）。能力路由读（§8.4）。 */\n    brepCapabilities?: {\n      evolution?: boolean\n      heal?: boolean\n      directEdit?: boolean\n      advSurface?: boolean\n      assembly?: boolean\n      meshLift?: boolean\n    }\n    partTransform?: { position: [number, number, number]; scale?: [number, number, number] }\n  }\n  /** 几何后端。brep 引擎异步初始化 → 用 getter。 */\n  readonly kernel: {\n    readonly brep: unknown | null\n    readonly csg: unknown | undefined\n    readonly sdf: unknown | undefined\n  }\n  /** 宿主端口（透传 HostPorts） */\n  readonly fonts: unknown\n  readonly texture: unknown\n  readonly assets: unknown\n  readonly events: unknown\n  /** faijs 自带标准库命名空间（引擎不区分它与第三方库——都是库函数；P5 起由宿主注入，core 不默认装配） */\n  readonly cad?: StdlibNamespace\n}\n\n/**\n * 契约版本。破坏性变更 +1。加载第三方库时校验，不兼容即抛错。\n *\n * v3（P23，§5.2 / D11）：`defineOp` 的实现边界统一为 Result 语义——实现可返回\n * `Result`（边界 unwrap，`err` → 抛错）、可抛错（归一为带 op 名的错误），\n * 也可照旧返回裸产物（透传）；并新增 D11 `positional` 位置形态声明。\n * v2 → v3 是破坏性变更：按 v2 契约构建的库必须重新构建。\n */\nexport const CONTRACT_VERSION = 3\n\n/** 库函数签名（引擎视角：任意参数的普通函数，信息均匀化，不按名字分支）。 */\nexport type StdlibFn = (...args: any[]) => unknown\n\n/** 库命名空间：函数名 → 库函数（faijs 自带标准库与第三方库同构）。 */\nexport interface StdlibNamespace {\n  [name: string]: StdlibFn\n}\n\n/**\n * 契约版本校验（P7 第三方库通道）：加载时校验，不兼容即抛错（不静默降级）。\n * 第三方库模块若带 contractVersion 字段（与 CONTRACT_VERSION 对齐），必须匹配。\n *\n * @param lib - the library module whose contractVersion field is validated.\n */\nexport function assertContractVersion(lib: { contractVersion?: unknown }): void {\n  if (lib.contractVersion !== undefined && lib.contractVersion !== CONTRACT_VERSION) {\n    throw new Error(\n      `[faijs] library contract version mismatch: got ${String(lib.contractVersion)}, expected ${CONTRACT_VERSION}`,\n    )\n  }\n}\n\n/**\n * brep 强制模式下的不支持错误（mesh-only 函数 / 输入不在 BREP 链）。\n *\n * 由分派路径抛出，CadRuntime 捕获后转换为 ExecutionResult.failedAt\n * （与旧解释器\"brep 模式立即返回 E_BREP_UNSUPPORTED，不静默回退 mesh\"的语义一致）。\n * P2 起定义在本层（零依赖），L3 API 命名空间与引擎共享同一类（instanceof 判定）。\n */\nexport class BrepUnsupportedError extends Error {\n  /** The statement that triggered the unsupported operation, when available. */\n  readonly stmt?: ExecutionAnchor\n  constructor(message: string, stmt?: ExecutionAnchor) {\n    super(message)\n    this.name = 'BrepUnsupportedError'\n    this.stmt = stmt\n  }\n}\n\n/**\n * Unsupported error for mesh-forced mode (brep-only functions, or auto-mode\n * brep-only functions with a broken input chain).\n *\n * Symmetric to BrepUnsupportedError: thrown statically by the dispatch path,\n * caught by CadRuntime and converted into ExecutionResult.failedAt. A brep-only\n * function being unavailable in mesh mode is expected behavior (mode ×\n * implementation-set mismatch), not a bug fallback — the static-dispatch red\n * line (no try-catch, no runtime fallback) is unchanged.\n */\nexport class MeshUnsupportedError extends Error {\n  /** The statement that triggered the unsupported operation, when available. */\n  readonly stmt?: ExecutionAnchor\n  constructor(message: string, stmt?: ExecutionAnchor) {\n    super(message)\n    this.name = 'MeshUnsupportedError'\n    this.stmt = stmt\n  }\n}\n\n// ── 状态容器 ──\n\n/**\n * The global runtime state singleton: backend configuration, the currently\n * executing statement, and the Shape identity tables (constructor registry,\n * identity slots, and Shape → PartName reverse lookup).\n */\nexport interface FaijsRuntimeState {\n  readonly stateVersion: number\n  /** 后端配置（configureBackends 写入） */\n  backends: Backends | undefined\n  /** 当前执行语句锚点（引擎在语句 fn 之前设置） */\n  currentStmt: ExecutionAnchor | undefined\n  /** Shape 构造器登记（isShape 的唯一依据） */\n  readonly created: WeakSet<object>\n  /** Shape 身份槽 */\n  readonly slots: WeakMap<object, ShapeSlot>\n  /** Shape → PartName 反查（keep 与 dependentsOf 用） */\n  readonly shapeToName: WeakMap<object, PartName>\n}\n\n// ── 函数 BREP 域（控制流放松方案 §5.6 / D13） ──\n// 本机函数体内的瞬态 BREP 句柄：进入函数时开启登记域，op 输出句柄写入时经\n// registerFunctionBrep 登记；函数返回后引擎取走域、释放除返回值可到达句柄外的全部\n// （对齐「调用方负责句柄生命周期」brep-ops.ts 与 meshesToStep 的 finally 模式）。\n// 全局计数与 DirectExecutor.userFunctionDepth 同步（单 runtime 场景，与 setCurrentStmt 同构）。\n\nlet functionBrepDepth = 0\nconst functionBrepDomain: unknown[] = []\n\n/** 进入函数 BREP 域（DirectExecutor 执行 local 语句 fn 之前调用）。 */\nexport function enterFunctionBrep(): void {\n  if (functionBrepDepth === 0) functionBrepDomain.length = 0\n  functionBrepDepth++\n}\n\n/** 退出函数 BREP 域（fn 结束后调用）。 */\nexport function exitFunctionBrep(): void {\n  functionBrepDepth = Math.max(0, functionBrepDepth - 1)\n}\n\n/**\n * 登记函数域内新产生的 BREP 句柄（hook 点在 op 输出 shape 槽位写入处——fromBrep）。\n * 非函数域（depth = 0）时 no-op（零开销，现状路径不变）。\n * @param solid - 新产生的 OCCT 句柄。\n */\nexport function registerFunctionBrep(solid: unknown): void {\n  if (functionBrepDepth > 0) functionBrepDomain.push(solid)\n}\n\n/**\n * 取走当前函数域的句柄登记表并清空（引擎在 fn 结束后调用，随后释放非返回值句柄）。\n * @returns 当前函数域的句柄登记表快照。\n */\nexport function takeFunctionBrepDomain(): unknown[] {\n  const domain = [...functionBrepDomain]\n  functionBrepDomain.length = 0\n  return domain\n}\n\n/** Shape 身份槽（OCCT 句柄 + 面演化 + 拓扑命名 + 装配行为）。 */\nexport interface ShapeSlot {\n  solid?: unknown\n  faceEvolution?: Map<number, number[]>\n  /** 拓扑命名 RoleTable（§2.3 naming 槽：随 Shape 身份槽传播，不序列化）。 */\n  roleTable?: unknown\n  /** mesh/primitive 面 hint 快照（§3.6 setTopology 注入时由 runtime 提炼写入，解析兜底用）。 */\n  faceHints?: unknown\n  behavior?: unknown\n}\n\n/**\n * 装配变换（引擎应用）：求解在库（solveTransforms），应用与下游失效在引擎（P6）。\n * index = 成员下标（compound.children 内）。\n */\nexport interface AssemblyTransform {\n  index: number\n  quaternion: [number, number, number, number]\n  pivot: [number, number, number]\n  translation: [number, number, number]\n  rotationMatrix: number[]\n}\n\n/**\n * do_assemble 的待应用变换登记（P6：求解 ≠ 传播）。\n * 库只把求解结果写到这里；引擎在语句执行后取走并应用 + 失效下游。\n */\nconst pendingAssemblyKeys = new Set<object>()\nconst pendingAssemblyTransforms = new WeakMap<object, AssemblyTransform[]>()\n\n/**\n * Register a compound's pending assembly transforms (called from the\n * do_assemble method body; accumulates across calls).\n *\n * @param c - the compound object that owns the transforms.\n * @param ts - the assembly transforms to append.\n */\nexport function setPendingAssemblyTransforms(c: object, ts: AssemblyTransform[]): void {\n  if (ts.length === 0) return\n  pendingAssemblyKeys.add(c)\n  const existing = pendingAssemblyTransforms.get(c) ?? []\n  pendingAssemblyTransforms.set(c, [...existing, ...ts])\n}\n\n/**\n * Take all pending assembly transforms and clear them (called by the engine's\n * afterStatement hook; consumed exactly once).\n *\n * @returns the list of compounds with their accumulated transforms.\n */\nexport function takePendingAssemblyTransforms(): Array<{ compound: object; transforms: AssemblyTransform[] }> {\n  const out: Array<{ compound: object; transforms: AssemblyTransform[] }> = []\n  for (const c of pendingAssemblyKeys) {\n    const ts = pendingAssemblyTransforms.get(c)\n    if (ts && ts.length > 0) out.push({ compound: c, transforms: ts })\n    pendingAssemblyTransforms.delete(c)\n  }\n  pendingAssemblyKeys.clear()\n  return out\n}\n\n// ── P3：运动副位姿登记（ExecutionResult.kinematics）──\n// 与 pendingAssemblyTransforms 同模式：库只把 solveKinematics 的 per-member 位姿\n// 写到这里，引擎在语句执行后取走并放入 ExecutionResult.kinematics（宿主动画/导出\n// 从 ExecutionResult 读取，不新增返回值消费语义）。\n\n/** 单个成员的位姿（position + faijs [x,y,z,w] rotation；与 api/assembly/joints 的 KinematicsPose 结构一致）。 */\nexport interface AssemblyKinematicsPose {\n  position: [number, number, number]\n  rotation: [number, number, number, number]\n}\n\n/** 位姿键：成员名 → AssemblyKinematicsPose（含恒等链根；键 = PartName）。 */\nexport type AssemblyKinematics = Record<string, AssemblyKinematicsPose>\n\nconst pendingKinematicsKeys = new Set<object>()\nconst pendingAssemblyKinematics = new WeakMap<object, AssemblyKinematics>()\n\n/**\n * Register a compound's pending assembly kinematics (P3; called from the\n * do_assemble/solve method body; accumulates across calls).\n *\n * @param c - the compound object that owns the kinematics.\n * @param kin - per-member poses keyed by member name (all members, incl. identity).\n */\nexport function setPendingAssemblyKinematics(c: object, kin: AssemblyKinematics): void {\n  pendingKinematicsKeys.add(c)\n  pendingAssemblyKinematics.set(c, kin)\n}\n\n/**\n * Take all pending assembly kinematics and clear them (called by the engine after\n * an assembly statement; consumed exactly once).\n *\n * @returns the list of compounds with their per-member kinematics.\n */\nexport function takePendingAssemblyKinematics(): Array<{ compound: object; kinematics: AssemblyKinematics }> {\n  const out: Array<{ compound: object; kinematics: AssemblyKinematics }> = []\n  for (const c of pendingKinematicsKeys) {\n    const kin = pendingAssemblyKinematics.get(c)\n    if (kin) out.push({ compound: c, kinematics: kin })\n    pendingAssemblyKinematics.delete(c)\n  }\n  pendingKinematicsKeys.clear()\n  return out\n}\n\nconst STATE_VERSION = 1\nconst KEY = '__FAICAD_FAIJS_RUNTIME__'\n\n/**\n * 获取全局状态（单例）。\n *\n * 挂在 globalThis 上是为了让\"两份 faijs 代码\"（宿主 bundle 一份、第三方库\n * 打进一份）共享同一份状态——两份 WeakSet 会导致 Shape 身份不通（几何孤岛）。\n * 构建期去重（external）是主手段，这里是兜底。\n *\n * @returns the shared global runtime state singleton.\n */\nexport function getRuntimeState(): FaijsRuntimeState {\n  const g = globalThis as unknown as Record<string, unknown>\n  const existing = g[KEY] as FaijsRuntimeState | undefined\n  if (existing) {\n    if (existing.stateVersion !== STATE_VERSION) {\n      throw new Error(\n        `[faijs] runtime state version mismatch: loaded=${existing.stateVersion}, expected=${STATE_VERSION}`,\n      )\n    }\n    return existing\n  }\n  const created: FaijsRuntimeState = {\n    stateVersion: STATE_VERSION,\n    backends: undefined,\n    currentStmt: undefined,\n    created: new WeakSet<object>(),\n    slots: new WeakMap<object, ShapeSlot>(),\n    shapeToName: new WeakMap<object, PartName>(),\n  }\n  g[KEY] = created\n  return created\n}\n\n// ── 后端配置读写 ──\n\n/**\n * 宿主在启动时调用一次，注入环境资源。\n *\n * @param backends - the host-injected environment resources.\n */\nexport function configureBackends(backends: Backends): void {\n  getRuntimeState().backends = backends\n}\n\n/**\n * 读取后端配置。库函数通过它获取内核与宿主端口。\n *\n * 未配置时抛错——不要返回默认值兜底（配置是宿主的责任，缺失必须暴露）。\n *\n * @returns the configured backend resources.\n */\nexport function getBackends(): Backends {\n  const b = getRuntimeState().backends\n  if (!b) {\n    throw new Error('[faijs] backends not configured: call configureBackends() before executing')\n  }\n  return b\n}\n\n// ── 当前执行语句（引擎内部状态）──\n\n/**\n * 引擎在语句 fn 之前调用（替换现状的 exec.currentStmt = source）。\n *\n * @param stmt - the statement currently being executed.\n */\nexport function setCurrentStmt(stmt: ExecutionAnchor | undefined): void {\n  getRuntimeState().currentStmt = stmt\n}\n\n/**\n * 读取当前执行语句。库函数不应调用它（F1）。\n *\n * @returns the currently executing statement, or undefined if none.\n */\nexport function getCurrentStmt(): ExecutionAnchor | undefined {\n  return getRuntimeState().currentStmt\n}\n\n// ── Shape 身份表 ──\n\n/**\n * Shape → 变量名反查（keep 与 dependentsOf 依赖）。\n *\n * @param shape - the shape to look up.\n * @returns the part name registered for the shape, or undefined.\n */\nexport function nameOf(shape: object): PartName | undefined {\n  return getRuntimeState().shapeToName.get(shape)\n}\n\n/**\n * 登记 Shape → 变量名映射。\n *\n * @param shape - the shape to register.\n * @param name - the part name to associate with the shape.\n */\nexport function setName(shape: object, name: PartName): void {\n  getRuntimeState().shapeToName.set(shape, name)\n}\n\n// ── keep 声明（库函数体调用）──\n\n/**\n * 登记回调类型。由 DirectExecutor 在装配时注入（保持 runtime-state 零依赖）。\n */\nexport type KeepSink = (stmtId: string, names: PartName[], hidden: boolean) => void\n\nlet keepSink: KeepSink | undefined\n\n/**\n * 引擎装配 keep 的落地目标（DirectExecutor.registerKeep）。\n *\n * @param sink - the keep callback registered by the engine, or undefined to clear.\n */\nexport function setKeepSink(sink: KeepSink | undefined): void {\n  keepSink = sink\n}\n\n/**\n * 函数体 keep 声明：声明保留这些 Shape 对应的变量（可见）。\n *\n * 库作者在库函数体内调用：\n * ```ts\n * import { keep } from '@faicad/faijs'\n * export function group(params) {\n *   keep(...params.members)\n *   return compound(params.members)\n * }\n * ```\n *\n * 归属到\"当前正在执行的语句\"（引擎在 fn 之前 setCurrentStmt）。\n * 未登记在 shapeToName 的对象（库内部的自定义对象）被忽略——这是刻意的静默。\n *\n * @param shapes - the shapes whose corresponding variables should be kept.\n */\nexport function keep(...shapes: unknown[]): void {\n  registerKeep(shapes, false)\n}\n\n/**\n * 函数体 keep 声明：保留但 canvas 不渲染（布尔系函数的源）。\n *\n * @param shapes - the shapes whose corresponding variables should be kept hidden.\n */\nexport function keepHidden(...shapes: unknown[]): void {\n  registerKeep(shapes, true)\n}\n\nfunction registerKeep(shapes: unknown[], hidden: boolean): void {\n  const stmt = getRuntimeState().currentStmt\n  if (!stmt || !keepSink) return\n  const names: PartName[] = []\n  for (const s of shapes) {\n    if (s === null || typeof s !== 'object') continue\n    const n = nameOf(s)\n    if (n !== undefined) names.push(n)\n  }\n  if (names.length === 0) return\n  keepSink(String(stmt.id), names, hidden)\n}\n"]}

package/dist/sdf/sdf-core.d.ts

@@ -0,0 +1,67 @@
+/**
+ * sdf-core — SDF 纯计算函数（从 sdf-worker.ts 提取）
+ *
+ *
+ * 这些函数不依赖 Worker 环境（无 self.onmessage / postMessage），
+ * 可被 WorkerSdfBackend（经 sdf-worker.ts）和 InlineSdfBackend（主线程直跑）共用。
+ *
+ * 依赖：manifold-3d 核心模块（Manifold.levelSet）
+ */
+import { manifoldToMeshData } from '../boolean/csg-core.js';
+/** A compiled signed distance field function evaluating at a 3D point. */
+export type SdfFn = (x: number, y: number, z: number) => number;
+/**
+ * Compile user-supplied code by injecting params as function arguments and
+ * returning the `sdf` function it defines.
+ *
+ * @param code - the user code containing the `sdf` function.
+ * @param params - parameter name → value map injected as function arguments.
+ * @returns the compiled sdf function.
+ */
+export declare function compileSdf(code: string, params: Record<string, number>): SdfFn;
+/**
+ * Try to compile and invoke the user-defined `bounds()` function; returns null
+ * if no bounds function is present or it cannot be evaluated.
+ *
+ * @param code - the user code containing the optional `bounds` function.
+ * @param params - parameter name → value map injected as function arguments.
+ * @returns the resolved bounds box, or null if unavailable.
+ */
+export declare function tryCompileBounds(code: string, params: Record<string, number>): {
+    min: [number, number, number];
+    max: [number, number, number];
+} | null;
+/**
+ * Race a promise against a timeout, rejecting if the timeout elapses first.
+ *
+ * @param promise - the promise to guard.
+ * @param ms - the timeout in milliseconds.
+ * @returns the result of the guarded promise.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
+/**
+ * Wrap an sdf function with a per-execution call count limit.
+ *
+ * @param fn - the sdf function to guard.
+ * @param maxCalls - the maximum number of allowed invocations.
+ * @returns a guarded sdf function that throws once the limit is exceeded.
+ */
+export declare function createGuardedSdf(fn: SdfFn, maxCalls: number): (p: [number, number, number]) => number;
+export { manifoldToMeshData };
+/**
+ * 执行 SDF 等值面提取（纯计算，不依赖 Worker）。
+ *
+ * @param Manifold - the manifold-3d Manifold class, used for levelSet extraction.
+ * @param code - the user code containing the `sdf` (and optional `bounds`) function.
+ * @param params - parameter name → value map injected as function arguments.
+ * @param bounds - fallback bounding box as [xmin, ymin, zmin, xmax, ymax, zmax].
+ * @param edgeLength - octree cell edge length; smaller yields finer detail.
+ * @param level - the isosurface value (default 0).
+ * @param tolerance - meshing tolerance (< 0 uses the manifold default).
+ * @returns {positions, indices} mesh 数据
+ */
+export declare function runSdfInline(Manifold: typeof import('manifold-3d/manifold').Manifold, code: string, params: Record<string, number>, bounds: [number, number, number, number, number, number], edgeLength: number, level?: number, tolerance?: number): Promise<{
+    positions: Float32Array;
+    indices: Uint32Array;
+}>;
+//# sourceMappingURL=sdf-core.d.ts.map

package/dist/sdf/sdf-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdf-core.d.ts","sourceRoot":"","sources":["../../src/sdf/sdf-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExD,0EAA0E;AAC1E,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAU9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAoBzE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAO1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAMrG;AAGD,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,sBAAsB,EAAE,QAAQ,EACxD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxD,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,EACjB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC;IAAE,SAAS,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAmC5D"}

package/dist/sdf/sdf-core.js

@@ -0,0 +1,118 @@
+/**
+ * sdf-core — SDF 纯计算函数（从 sdf-worker.ts 提取）
+ *
+ *
+ * 这些函数不依赖 Worker 环境（无 self.onmessage / postMessage），
+ * 可被 WorkerSdfBackend（经 sdf-worker.ts）和 InlineSdfBackend（主线程直跑）共用。
+ *
+ * 依赖：manifold-3d 核心模块（Manifold.levelSet）
+ */
+import { manifoldToMeshData } from '../boolean/csg-core.js';
+/**
+ * Compile user-supplied code by injecting params as function arguments and
+ * returning the `sdf` function it defines.
+ *
+ * @param code - the user code containing the `sdf` function.
+ * @param params - parameter name → value map injected as function arguments.
+ * @returns the compiled sdf function.
+ */
+export function compileSdf(code, params) {
+    const paramNames = Object.keys(params);
+    const paramValues = Object.values(params);
+    const fn = new Function(...paramNames, `${code}
+     if (typeof sdf !== 'function') throw new Error('未找到 sdf 函数，请定义 function sdf(x, y, z) { ... }');
+     return sdf;`);
+    return fn(...paramValues);
+}
+/**
+ * Try to compile and invoke the user-defined `bounds()` function; returns null
+ * if no bounds function is present or it cannot be evaluated.
+ *
+ * @param code - the user code containing the optional `bounds` function.
+ * @param params - parameter name → value map injected as function arguments.
+ * @returns the resolved bounds box, or null if unavailable.
+ */
+export function tryCompileBounds(code, params) {
+    try {
+        const paramNames = Object.keys(params);
+        const paramValues = Object.values(params);
+        const fn = new Function(...paramNames, `${code}
+       return (typeof bounds === 'function') ? bounds : null;`);
+        const boundsFn = fn(...paramValues);
+        if (!boundsFn)
+            return null;
+        const b = boundsFn();
+        if (!b || !Array.isArray(b.min) || !Array.isArray(b.max))
+            return null;
+        return {
+            min: [Number(b.min[0]), Number(b.min[1]), Number(b.min[2])],
+            max: [Number(b.max[0]), Number(b.max[1]), Number(b.max[2])],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Race a promise against a timeout, rejecting if the timeout elapses first.
+ *
+ * @param promise - the promise to guard.
+ * @param ms - the timeout in milliseconds.
+ * @returns the result of the guarded promise.
+ */
+export function withTimeout(promise, ms) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error('SDF 执行超时（超过 ' + ms / 1000 + ' 秒）')), ms)),
+    ]);
+}
+/**
+ * Wrap an sdf function with a per-execution call count limit.
+ *
+ * @param fn - the sdf function to guard.
+ * @param maxCalls - the maximum number of allowed invocations.
+ * @returns a guarded sdf function that throws once the limit is exceeded.
+ */
+export function createGuardedSdf(fn, maxCalls) {
+    let calls = 0;
+    return (p) => {
+        if (++calls > maxCalls)
+            throw new Error('SDF 调用次数超限（' + maxCalls + ' 次）');
+        return fn(p[0], p[1], p[2]);
+    };
+}
+// Re-export manifoldToMeshData for sdf consumers
+export { manifoldToMeshData };
+/**
+ * 执行 SDF 等值面提取（纯计算，不依赖 Worker）。
+ *
+ * @param Manifold - the manifold-3d Manifold class, used for levelSet extraction.
+ * @param code - the user code containing the `sdf` (and optional `bounds`) function.
+ * @param params - parameter name → value map injected as function arguments.
+ * @param bounds - fallback bounding box as [xmin, ymin, zmin, xmax, ymax, zmax].
+ * @param edgeLength - octree cell edge length; smaller yields finer detail.
+ * @param level - the isosurface value (default 0).
+ * @param tolerance - meshing tolerance (< 0 uses the manifold default).
+ * @returns {positions, indices} mesh 数据
+ */
+export async function runSdfInline(Manifold, code, params, bounds, edgeLength, level = 0, tolerance = -1) {
+    // ① 编译 sdf 函数
+    const sdfFn = compileSdf(code, params);
+    // ② 确定包围盒：优先用户 bounds()，否则用传入
+    let box = tryCompileBounds(code, params);
+    if (!box) {
+        box = {
+            min: [bounds[0], bounds[1], bounds[2]],
+            max: [bounds[3], bounds[4], bounds[5]],
+        };
+    }
+    // ③ 桥接：sdf(x,y,z) → (p: Vec3) => number，加调用次数限制
+    const guardedSdf = createGuardedSdf(sdfFn, 10_000_000);
+    // ④ 等值面提取（超时保护）
+    const manifold = await withTimeout(Promise.resolve(Manifold.levelSet(guardedSdf, box, edgeLength, level, tolerance < 0 ? undefined : tolerance)), 60_000);
+    // ⑤ 提取 mesh 数据后立即释放 WASM 内存
+    const mesh = manifoldToMeshData(manifold);
+    manifold.delete();
+    return mesh;
+}
+//# sourceMappingURL=sdf-core.js.map

package/dist/sdf/sdf-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdf-core.js","sourceRoot":"","sources":["../../src/sdf/sdf-core.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * sdf-core — SDF 纯计算函数（从 sdf-worker.ts 提取）\n *\n *\n * 这些函数不依赖 Worker 环境（无 self.onmessage / postMessage），\n * 可被 WorkerSdfBackend（经 sdf-worker.ts）和 InlineSdfBackend（主线程直跑）共用。\n *\n * 依赖：manifold-3d 核心模块（Manifold.levelSet）\n */\n\nimport type { Manifold as ManifoldInstance } from 'manifold-3d/manifold'\nimport { manifoldToMeshData } from '../boolean/csg-core'\n\n/** A compiled signed distance field function evaluating at a 3D point. */\nexport type SdfFn = (x: number, y: number, z: number) => number\n\n/**\n * Compile user-supplied code by injecting params as function arguments and\n * returning the `sdf` function it defines.\n *\n * @param code - the user code containing the `sdf` function.\n * @param params - parameter name → value map injected as function arguments.\n * @returns the compiled sdf function.\n */\nexport function compileSdf(code: string, params: Record<string, number>): SdfFn {\n  const paramNames = Object.keys(params)\n  const paramValues = Object.values(params)\n  const fn = new Function(\n    ...paramNames,\n    `${code}\n     if (typeof sdf !== 'function') throw new Error('未找到 sdf 函数，请定义 function sdf(x, y, z) { ... }');\n     return sdf;`,\n  )\n  return fn(...paramValues) as SdfFn\n}\n\n/**\n * Try to compile and invoke the user-defined `bounds()` function; returns null\n * if no bounds function is present or it cannot be evaluated.\n *\n * @param code - the user code containing the optional `bounds` function.\n * @param params - parameter name → value map injected as function arguments.\n * @returns the resolved bounds box, or null if unavailable.\n */\nexport function tryCompileBounds(\n  code: string,\n  params: Record<string, number>,\n): { min: [number, number, number]; max: [number, number, number] } | null {\n  try {\n    const paramNames = Object.keys(params)\n    const paramValues = Object.values(params)\n    const fn = new Function(\n      ...paramNames,\n      `${code}\n       return (typeof bounds === 'function') ? bounds : null;`,\n    )\n    const boundsFn = fn(...paramValues)\n    if (!boundsFn) return null\n    const b = boundsFn()\n    if (!b || !Array.isArray(b.min) || !Array.isArray(b.max)) return null\n    return {\n      min: [Number(b.min[0]), Number(b.min[1]), Number(b.min[2])],\n      max: [Number(b.max[0]), Number(b.max[1]), Number(b.max[2])],\n    }\n  } catch {\n    return null\n  }\n}\n\n/**\n * Race a promise against a timeout, rejecting if the timeout elapses first.\n *\n * @param promise - the promise to guard.\n * @param ms - the timeout in milliseconds.\n * @returns the result of the guarded promise.\n */\nexport function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n  return Promise.race([\n    promise,\n    new Promise<T>((_, reject) =>\n      setTimeout(() => reject(new Error('SDF 执行超时（超过 ' + ms / 1000 + ' 秒）')), ms),\n    ),\n  ])\n}\n\n/**\n * Wrap an sdf function with a per-execution call count limit.\n *\n * @param fn - the sdf function to guard.\n * @param maxCalls - the maximum number of allowed invocations.\n * @returns a guarded sdf function that throws once the limit is exceeded.\n */\nexport function createGuardedSdf(fn: SdfFn, maxCalls: number): (p: [number, number, number]) => number {\n  let calls = 0\n  return (p: [number, number, number]) => {\n    if (++calls > maxCalls) throw new Error('SDF 调用次数超限（' + maxCalls + ' 次）')\n    return fn(p[0], p[1], p[2])\n  }\n}\n\n// Re-export manifoldToMeshData for sdf consumers\nexport { manifoldToMeshData }\n\n/**\n * 执行 SDF 等值面提取（纯计算，不依赖 Worker）。\n *\n * @param Manifold - the manifold-3d Manifold class, used for levelSet extraction.\n * @param code - the user code containing the `sdf` (and optional `bounds`) function.\n * @param params - parameter name → value map injected as function arguments.\n * @param bounds - fallback bounding box as [xmin, ymin, zmin, xmax, ymax, zmax].\n * @param edgeLength - octree cell edge length; smaller yields finer detail.\n * @param level - the isosurface value (default 0).\n * @param tolerance - meshing tolerance (< 0 uses the manifold default).\n * @returns {positions, indices} mesh 数据\n */\nexport async function runSdfInline(\n  Manifold: typeof import('manifold-3d/manifold').Manifold,\n  code: string,\n  params: Record<string, number>,\n  bounds: [number, number, number, number, number, number],\n  edgeLength: number,\n  level: number = 0,\n  tolerance: number = -1,\n): Promise<{ positions: Float32Array; indices: Uint32Array }> {\n  // ① 编译 sdf 函数\n  const sdfFn = compileSdf(code, params)\n\n  // ② 确定包围盒：优先用户 bounds()，否则用传入\n  let box = tryCompileBounds(code, params)\n  if (!box) {\n    box = {\n      min: [bounds[0], bounds[1], bounds[2]],\n      max: [bounds[3], bounds[4], bounds[5]],\n    }\n  }\n\n  // ③ 桥接：sdf(x,y,z) → (p: Vec3) => number，加调用次数限制\n  const guardedSdf = createGuardedSdf(sdfFn, 10_000_000)\n\n  // ④ 等值面提取（超时保护）\n  const manifold: ManifoldInstance = await withTimeout(\n    Promise.resolve(\n      Manifold.levelSet(\n        guardedSdf,\n        box,\n        edgeLength,\n        level,\n        tolerance < 0 ? undefined : tolerance,\n      ),\n    ),\n    60_000,\n  )\n\n  // ⑤ 提取 mesh 数据后立即释放 WASM 内存\n  const mesh = manifoldToMeshData(manifold)\n  manifold.delete()\n\n  return mesh\n}\n"]}

package/dist/sdf/sdf-runner.d.ts

@@ -0,0 +1,33 @@
+/**
+ * sdf-runner — SDF 执行入口（headless 版本）
+ *
+ * 替代浏览器版的 sdf-runner.ts（使用 Worker）。
+ * 直接使用 InlineSdfBackend 在主线程执行 SDF。
+ *
+ * F2 修复：不静态 import browser-host/inline-sdf-backend（L1 不依赖 L3）。
+ * 改为延迟动态 import，仅在未注入后端时按需加载。
+ */
+import type { SdfBackend } from '../cad-runtime/ports.js';
+/** Mesh data produced by an SDF run: interleaved positions and triangle indices. */
+export interface SdfMeshData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * 浏览器 host 注入 SDF 后端（WorkerSdfBackend）。
+ *
+ * @param backend - the SDF backend to use.
+ */
+export declare function setSdfBackend(backend: SdfBackend): void;
+/**
+ * 执行 SDF 生成。
+ * @param code    用户编写的 JS 代码（含 sdf 函数）
+ * @param params  参数值表
+ * @param bounds  包围盒 6 元组 [xmin,ymin,zmin,xmax,ymax,zmax]
+ * @param edgeLength 八叉树单元边长（越小越精细）
+ * @param level   等值面值（默认 0）
+ * @param tolerance 网格化容差（<0 用 manifold 默认）
+ * @returns mesh data produced by the SDF extraction.
+ */
+export declare function runSdf(code: string, params: Record<string, number>, bounds: [number, number, number, number, number, number], edgeLength: number, level?: number, tolerance?: number): Promise<SdfMeshData>;
+//# sourceMappingURL=sdf-runner.d.ts.map

package/dist/sdf/sdf-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdf-runner.d.ts","sourceRoot":"","sources":["../../src/sdf/sdf-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEvD;AAcD;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxD,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,EACjB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,WAAW,CAAC,CAGtB"}

package/dist/sdf/sdf-runner.js

@@ -0,0 +1,45 @@
+/**
+ * sdf-runner — SDF 执行入口（headless 版本）
+ *
+ * 替代浏览器版的 sdf-runner.ts（使用 Worker）。
+ * 直接使用 InlineSdfBackend 在主线程执行 SDF。
+ *
+ * F2 修复：不静态 import browser-host/inline-sdf-backend（L1 不依赖 L3）。
+ * 改为延迟动态 import，仅在未注入后端时按需加载。
+ */
+let _backend = null;
+/**
+ * 浏览器 host 注入 SDF 后端（WorkerSdfBackend）。
+ *
+ * @param backend - the SDF backend to use.
+ */
+export function setSdfBackend(backend) {
+    _backend = backend;
+}
+/**
+ * 获取当前 SDF 后端。
+ * F2 修复：延迟动态 import InlineSdfBackend，避免 L1 静态依赖 L3。
+ */
+async function getBackend() {
+    if (_backend)
+        return _backend;
+    // 延迟加载——仅在实际需要时才拉入 L3 代码
+    const { InlineSdfBackend } = await import('../browser-host/inline-sdf-backend.js');
+    _backend = new InlineSdfBackend();
+    return _backend;
+}
+/**
+ * 执行 SDF 生成。
+ * @param code    用户编写的 JS 代码（含 sdf 函数）
+ * @param params  参数值表
+ * @param bounds  包围盒 6 元组 [xmin,ymin,zmin,xmax,ymax,zmax]
+ * @param edgeLength 八叉树单元边长（越小越精细）
+ * @param level   等值面值（默认 0）
+ * @param tolerance 网格化容差（<0 用 manifold 默认）
+ * @returns mesh data produced by the SDF extraction.
+ */
+export async function runSdf(code, params, bounds, edgeLength, level = 0, tolerance = -1) {
+    const backend = await getBackend();
+    return backend.runSdf(code, params, bounds, edgeLength, level, tolerance);
+}
+//# sourceMappingURL=sdf-runner.js.map

package/dist/sdf/sdf-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdf-runner.js","sourceRoot":"","sources":["../../src/sdf/sdf-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,IAAI,QAAQ,GAAsB,IAAI,CAAA;AAEtC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB;IAC/C,QAAQ,GAAG,OAAO,CAAA;AACpB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU;IACvB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,yBAAyB;IACzB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAA;IAC/E,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAA;IACjC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,MAA8B,EAC9B,MAAwD,EACxD,UAAkB,EAClB,QAAgB,CAAC,EACjB,YAAoB,CAAC,CAAC;IAEtB,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAA;IAClC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;AAC3E,CAAC","sourcesContent":["/**\n * sdf-runner — SDF 执行入口（headless 版本）\n *\n * 替代浏览器版的 sdf-runner.ts（使用 Worker）。\n * 直接使用 InlineSdfBackend 在主线程执行 SDF。\n *\n * F2 修复：不静态 import browser-host/inline-sdf-backend（L1 不依赖 L3）。\n * 改为延迟动态 import，仅在未注入后端时按需加载。\n */\n\nimport type { SdfBackend } from '../cad-runtime/ports'\n\n/** Mesh data produced by an SDF run: interleaved positions and triangle indices. */\nexport interface SdfMeshData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\nlet _backend: SdfBackend | null = null\n\n/**\n * 浏览器 host 注入 SDF 后端（WorkerSdfBackend）。\n *\n * @param backend - the SDF backend to use.\n */\nexport function setSdfBackend(backend: SdfBackend): void {\n  _backend = backend\n}\n\n/**\n * 获取当前 SDF 后端。\n * F2 修复：延迟动态 import InlineSdfBackend，避免 L1 静态依赖 L3。\n */\nasync function getBackend(): Promise<SdfBackend> {\n  if (_backend) return _backend\n  // 延迟加载——仅在实际需要时才拉入 L3 代码\n  const { InlineSdfBackend } = await import('../browser-host/inline-sdf-backend')\n  _backend = new InlineSdfBackend()\n  return _backend\n}\n\n/**\n * 执行 SDF 生成。\n * @param code    用户编写的 JS 代码（含 sdf 函数）\n * @param params  参数值表\n * @param bounds  包围盒 6 元组 [xmin,ymin,zmin,xmax,ymax,zmax]\n * @param edgeLength 八叉树单元边长（越小越精细）\n * @param level   等值面值（默认 0）\n * @param tolerance 网格化容差（<0 用 manifold 默认）\n * @returns mesh data produced by the SDF extraction.\n */\nexport async function runSdf(\n  code: string,\n  params: Record<string, number>,\n  bounds: [number, number, number, number, number, number],\n  edgeLength: number,\n  level: number = 0,\n  tolerance: number = -1,\n): Promise<SdfMeshData> {\n  const backend = await getBackend()\n  return backend.runSdf(code, params, bounds, edgeLength, level, tolerance)\n}\n"]}

package/dist/sdf/templates.d.ts

@@ -0,0 +1,7 @@
+/** SDF 内置模板库 — 每个模板既是功能也是教学示例 */
+import type { SdfTemplate } from './types.js';
+/** Built-in SDF templates: each template is both a feature and a teaching example. */
+export declare const SDF_TEMPLATES: SdfTemplate[];
+/** 默认模板（球体） */
+export declare const DEFAULT_SDF_TEMPLATE: SdfTemplate;
+//# sourceMappingURL=templates.d.ts.map

package/dist/sdf/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/sdf/templates.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,sFAAsF;AACtF,eAAO,MAAM,aAAa,EAAE,WAAW,EAqRtC,CAAA;AAED,eAAe;AACf,eAAO,MAAM,oBAAoB,aAAmB,CAAA"}

package/dist/sdf/templates.js

@@ -0,0 +1,282 @@
+/** Built-in SDF templates: each template is both a feature and a teaching example. */
+export const SDF_TEMPLATES = [
+    {
+        id: 'sphere',
+        name: '球体',
+        category: 'primitive',
+        description: '最简 SDF：sqrt(x²+y²+z²) - r',
+        defaultBounds: { min: [-12, -12, -12], max: [12, 12, 12] },
+        code: `// 球体 -- 最简 SDF：sqrt(x²+y²+z²) - r
+// @param radius 10 半径
+function sdf(x, y, z) {
+  return radius - Math.sqrt(x*x + y*y + z*z)
+}
+
+function bounds() {
+  const r = radius
+  return { min: [-r, -r, -r], max: [r, r, r] }
+}`,
+    },
+    {
+        id: 'torus',
+        name: '圆环',
+        category: 'primitive',
+        description: '二维到一维的降维技巧',
+        defaultBounds: { min: [-22, -22, -22], max: [22, 22, 22] },
+        code: `// 圆环 -- 二维到一维的降维技巧
+// @param majorRadius 15 大半径
+// @param minorRadius 5 小半径
+function sdf(x, y, z) {
+  const qx = Math.sqrt(x*x + y*y) - majorRadius
+  return Math.sqrt(qx*qx + z*z) - minorRadius
+}
+
+function bounds() {
+  const r = majorRadius + minorRadius
+  return { min: [-r, -r, -r], max: [r, r, r] }
+}`,
+    },
+    {
+        id: 'ripple-sphere',
+        name: '波纹球体',
+        category: 'primitive',
+        description: '用 sin 调制半径',
+        defaultBounds: { min: [-16, -16, -16], max: [16, 16, 16] },
+        code: `// 波纹球体 -- 用 sin 调制半径
+// @param radius 10 半径
+// @param freq 3 波纹频率
+// @param amp 1 波纹幅度
+function sdf(x, y, z) {
+  const r = Math.sqrt(x*x + y*y + z*z)
+  const ripple = amp * Math.sin(freq * r)
+  return (radius + ripple) - r
+}
+
+function bounds() {
+  const r = radius + amp
+  return { min: [-r, -r, -r], max: [r, r, r] }
+}`,
+    },
+    {
+        id: 'gyroid',
+        name: 'Gyroid 极小曲面',
+        category: 'periodic',
+        description: '周期函数组合',
+        defaultBounds: { min: [-7, -7, -7], max: [7, 7, 7] },
+        code: `// Gyroid 极小曲面 -- 周期函数组合
+// @param period 6.28 周期
+// @param thickness 0.5 壁厚
+function sdf(x, y, z) {
+  const k = 2 * Math.PI / period
+  const g = Math.cos(k*x) * Math.sin(k*y)
+           + Math.cos(k*y) * Math.sin(k*z)
+           + Math.cos(k*z) * Math.sin(k*x)
+  return thickness - Math.abs(g)
+}
+
+function bounds() {
+  const p = period
+  return { min: [-p, -p, -p], max: [p, p, p] }
+}`,
+    },
+    {
+        id: 'metaball',
+        name: '球体混合',
+        category: 'blend',
+        description: 'exp-sum-log 平滑混合',
+        defaultBounds: { min: [-18, -18, -18], max: [18, 18, 18] },
+        code: `// 球体混合 -- exp-sum-log 平滑混合
+// @param radius1 7 球1半径
+// @param radius2 6 球2半径
+// @param blend 2 混合系数
+function sdf(x, y, z) {
+  const d1 = Math.sqrt((x+5)*(x+5) + y*y + z*z) - radius1
+  const d2 = Math.sqrt((x-5)*(x-5) + y*y + z*z) - radius2
+  const e = blend
+  return Math.log(Math.exp(-e*d1) + Math.exp(-e*d2)) / e
+}
+
+function bounds() {
+  const r = Math.max(radius1, radius2) + 5
+  return { min: [-r, -r, -r], max: [r, r, r] }
+}`,
+    },
+    {
+        id: 'cube-frame',
+        name: '立方体框架',
+        category: 'primitive',
+        description: 'max 做交集、min 做并集',
+        defaultBounds: { min: [-22, -22, -22], max: [22, 22, 22] },
+        code: `// 立方体框架 -- max 做交集、min 做并集
+// @param size 20 边长
+// @param thickness 1.5 杆径
+function sdf(x, y, z) {
+  const h = size / 2
+  const q = [Math.abs(x) - h, Math.abs(y) - h, Math.abs(z) - h]
+  const d1 = Math.sqrt(q[1]*q[1] + q[2]*q[2]) - thickness
+  const d2 = Math.sqrt(q[0]*q[0] + q[2]*q[2]) - thickness
+  const d3 = Math.sqrt(q[0]*q[0] + q[1]*q[1]) - thickness
+  return Math.min(Math.min(d1, d2), d3)
+}
+
+function bounds() {
+  const h = size / 2 + thickness
+  return { min: [-h, -h, -h], max: [h, h, h] }
+}`,
+    },
+    {
+        id: 'mandelbulb',
+        name: 'Mandelbulb 分形',
+        category: 'fractal',
+        description: '循环迭代 + 球坐标变换',
+        defaultBounds: { min: [-4, -4, -4], max: [4, 4, 4] },
+        code: `// Mandelbulb 分形 -- 循环迭代 + 球坐标变换
+// @param power 8 分形幂次
+// @param radius 3 最大半径
+// @param maxIter 20 迭代次数 int
+function sdf(x, y, z) {
+  let w = [x, y, z]
+  let dr = 1.0
+  let r = 0.0
+  for (let i = 0; i < maxIter; i++) {
+    r = Math.sqrt(w[0]*w[0] + w[1]*w[1] + w[2]*w[2])
+    if (r > radius) break
+    const theta = Math.acos(w[2] / r)
+    const phi = Math.atan2(w[1], w[0])
+    const rn = Math.pow(r, power)
+    dr = Math.pow(r, power - 1.0) * power * dr + 1.0
+    const thetaN = theta * power
+    const phiN = phi * power
+    w = [
+      rn * Math.sin(thetaN) * Math.cos(phiN) + x,
+      rn * Math.sin(thetaN) * Math.sin(phiN) + y,
+      rn * Math.cos(thetaN) + z,
+    ]
+  }
+  return 0.5 * Math.log(r) * r / dr
+}
+
+function bounds() {
+  const r = radius + 1
+  return { min: [-r, -r, -r], max: [r, r, r] }
+}`,
+    },
+    {
+        id: 'cylinder',
+        name: '圆柱 (布尔)',
+        category: 'primitive',
+        description: '无限圆柱 + 平面截断 (交集)',
+        defaultBounds: { min: [-9, -9, -9], max: [9, 9, 9] },
+        code: `// 圆柱 (布尔) -- 无限圆柱 + 平面截断 (交集)
+// @param radius 8 圆柱半径
+// @param height 15 截断高度
+function sdf(x, y, z) {
+  const cyl = Math.sqrt(x*x + y*y) - radius
+  const cap = Math.abs(z) - height / 2
+  return Math.max(cyl, cap)
+}
+
+function bounds() {
+  const h = height / 2
+  return { min: [-radius, -radius, -h], max: [radius, radius, h] }
+}`,
+    },
+    {
+        id: 'gyroid-lattice',
+        name: '晶格填充',
+        category: 'periodic',
+        description: 'Gyroid 与立方体求交',
+        defaultBounds: { min: [-11, -11, -11], max: [11, 11, 11] },
+        code: `// 晶格填充 -- Gyroid 与立方体求交
+// @param period 5 周期
+// @param thickness 0.3 壁厚
+// @param size 20 立方体边长
+function sdf(x, y, z) {
+  const k = 2 * Math.PI / period
+  const g = Math.cos(k*x) * Math.sin(k*y)
+           + Math.cos(k*y) * Math.sin(k*z)
+           + Math.cos(k*z) * Math.sin(k*x)
+  const gyroidShell = thickness - Math.abs(g)
+  const h = size / 2
+  const box = Math.max(Math.abs(x) - h, Math.abs(y) - h, Math.abs(z) - h)
+  return Math.max(gyroidShell, box)
+}
+
+function bounds() {
+  const h = size / 2
+  return { min: [-h, -h, -h], max: [h, h, h] }
+}`,
+    },
+    {
+        id: 'noise-terrain',
+        name: '噪声地形',
+        category: 'utility',
+        description: '多频正弦叠加模拟地形',
+        defaultBounds: { min: [-22, -22, -10], max: [22, 22, 14] },
+        code: `// 噪声地形 -- 多频正弦叠加模拟地形
+// @param scale 20 地形尺度
+// @param rough 0.5 粗糙度
+// @param height 8 最大高度
+function sdf(x, y, z) {
+  const nx = x / scale
+  const ny = y / scale
+  const terrain =
+    Math.sin(nx * 1.0) * Math.cos(ny * 1.3) * 0.5 +
+    Math.sin(nx * 2.1 + 1.3) * Math.cos(ny * 1.7 + 0.7) * 0.25 +
+    Math.sin(nx * 4.3 + 2.1) * Math.cos(ny * 3.7 + 1.3) * 0.125 +
+    Math.sin(nx * 8.7 + 3.4) * Math.cos(ny * 7.3 + 2.1) * 0.0625
+  const ground = height * (0.5 + terrain * rough)
+  return ground - z
+}
+
+function bounds() {
+  return { min: [-scale, -scale, -height], max: [scale, scale, height * 1.5] }
+}`,
+    },
+    {
+        id: 'schwarzP',
+        name: 'Schwarz P 极小曲面',
+        category: 'periodic',
+        description: 'cos 和式 TPMS（§2.6.4 补 lattice 缺口）',
+        defaultBounds: { min: [-7, -7, -7], max: [7, 7, 7] },
+        code: `// Schwarz P 极小曲面 -- cos(kx)+cos(ky)+cos(kz)=0 的等值壳
+// @param period 6.28 周期
+// @param thickness 0.5 壁厚
+function sdf(x, y, z) {
+  const k = 2 * Math.PI / period
+  const p = Math.cos(k*x) + Math.cos(k*y) + Math.cos(k*z)
+  return thickness - Math.abs(p)
+}
+
+function bounds() {
+  const p = period
+  return { min: [-p, -p, -p], max: [p, p, p] }
+}`,
+    },
+    {
+        id: 'diamond',
+        name: 'Diamond 极小曲面',
+        category: 'periodic',
+        description: '四重 sin/cos 和式 TPMS（§2.6.4 补 lattice 缺口）',
+        defaultBounds: { min: [-7, -7, -7], max: [7, 7, 7] },
+        code: `// Diamond 极小曲面 -- 四重和式 TPMS 的等值壳
+// @param period 6.28 周期
+// @param thickness 0.5 壁厚
+function sdf(x, y, z) {
+  const k = 2 * Math.PI / period
+  const sx = Math.sin(k*x), cx = Math.cos(k*x)
+  const sy = Math.sin(k*y), cy = Math.cos(k*y)
+  const sz = Math.sin(k*z), cz = Math.cos(k*z)
+  const d = sx*sy*sz + sx*cy*cz + cx*sy*cz + cx*cy*sz
+  return thickness - Math.abs(d)
+}
+
+function bounds() {
+  const p = period
+  return { min: [-p, -p, -p], max: [p, p, p] }
+}`,
+    },
+];
+/** 默认模板（球体） */
+export const DEFAULT_SDF_TEMPLATE = SDF_TEMPLATES[0];
+//# sourceMappingURL=templates.js.map