@faicad/faijs 0.13.0

package/dist/browser.d.ts.map

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

package/dist/browser.js

@@ -0,0 +1,119 @@
+/**
+ * @faicad/faijs/browser — Browser-safe exports (F6: A/B/C/D 四类收敛)
+ *
+ * Excludes L3 Node Host modules (node-host/*) that depend on node:fs/node:path.
+ * Use this entry point in browser/worker contexts to avoid pulling in Node.js code.
+ *
+ * For full exports (including Node.js), use @faicad/faijs instead.
+ *
+ * 导出分类（契约 §11 白名单四类）：
+ * - A 类 = lang/ 全部导出（脚本类型 + 构建辅助 + 接口约定类型 + 常量）
+ * - B 类 = cad-runtime/ + createBrowserPorts + 外部资源注入点 + 执行位置选项
+ * - C 类 = 执行产物类型（Shape + 拓扑数据类型 + buildSelectorRuntimeMaps）
+ * - D 类 = 辅助函数 + 预览 API（明确导出后使用）
+ *
+ * Phase 2 收尾完成：deprecated 区已删除。宿主如需执行/读取几何，一律走
+ * CadRuntime.execute / 高层 API（importStep/exportStep/ensureOcctKernel）；
+ * 主线程 CSG/SDF 预览走 previewMeshIntersect / runSdfMain。
+ */
+export { configureBackends, getBackends, setCurrentStmt, getCurrentStmt, keep, keepHidden, getRuntimeState, nameOf, setName, setKeepSink, setPendingAssemblyTransforms, takePendingAssemblyTransforms, assertContractVersion, CONTRACT_VERSION, } from './runtime-state.js';
+export { asFileId, asInnerId, asScopedId, asStmtId, asPartName, asGroupName, asRefId, asReferenceId, asSelectorKey, asOccurrenceId, asShapeId, asFaceId, asEdgeId, asNodeId, toScopedId, splitScopedId, isScopedId, toInnerId, } from './identity.js';
+export { derivePartName, getMaxModelNum, } from './lang/allocate-id.js';
+export { fmtNum, formatCodeLine } from './lang/codegen.js';
+export { analyzeCode } from './lang/statement-summary.js';
+export { codeToArgs } from './lang/code-to-args.js';
+// MetadataExtractor — 无 IR 元数据提取器（UI 通道语义源；UiMetadata 全量）
+export { extractMetadata } from './lang/metadata-extractor.js';
+// 参数表达式编辑（P0-C/P0-D）：实时校验层 + 编辑面板纯函数
+export { validateExpression } from './lang/expr-validate.js';
+export { editArgSource } from './lang/source-edit.js';
+export { isHostVarRef, isHostParamRef, isHostCallRef, isHostExprRef, isHostRef, hostArgToDisplay, hostArgToLiteral, HOST_REF_KINDS, } from './lang/host-arg.js';
+// ═══════════════════════════════════════════════════════════
+// B 类：cad-runtime/ + createBrowserPorts + 外部资源注入点
+// ═══════════════════════════════════════════════════════════
+// D1（2026-09-19）：浏览器入口同样自注册 cad（与 index.ts 同源包装，避免门面注入）。
+export { CadRuntime, createRuntime, AppendPrefixError } from './cad-runtime/createRuntimeWithCad.js';
+export { createPreviewExec } from './cad-runtime/preview-exec.js';
+// 外部资源注入点
+export { setManifoldWasmUrl, getManifoldWasmUrl } from './mesh/manifold-loader.js';
+export { setOcctWasmInitFn } from './occt-kernel/occtKernel.js';
+export { setBrepkitWasmInitFn, initBrepkitWasm, isBrepkitInitialized } from './brepkit-kernel/brepkitWasm.js';
+export { setFontLoader, getFontLoader, loadFont, ensureDefaultFont, getFont, clearFonts } from './brep/text/fontRegistry.js';
+export { setKnurlTextureLoader } from './mesh/knurl/textureLoader.js';
+// L3 Browser Host 工厂
+export { createBrowserPorts } from './browser-host/index.js';
+// D3-Browser（§9.4）：CDN 通用 libLoader 工厂（a/b 混合）。**不**被 createBrowserPorts
+// 默认装配——demo 的源码 alias HMR 路径必须零网络；CDN 装载由主机显式注入。
+export { createBrowserLibLoader, DEFAULT_CDN_BASE } from './cad-runtime/browser-lib-loader.js';
+export { BrowserEventSink } from './browser-host/browser-event-sink.js';
+export { BrowserFontProvider } from './browser-host/browser-font-provider.js';
+export { FetchAssetResolver } from './browser-host/fetch-asset-resolver.js';
+export { WorkerCsgBackend } from './browser-host/worker-csg-backend.js';
+export { WorkerSdfBackend } from './browser-host/worker-sdf-backend.js';
+// E12.2: OCCT 高层 API（B 类——宿主用这些替代底层 kernel 函数）
+export { importStep, importStepMultiPart, exportStep, releaseSolid, ensureOcctKernel, disposeOcct, exportStepFromSolidsHighLevel } from './occt-kernel/highLevelApi.js';
+// ── BREP 引擎注册（宿主装配；引擎可切换——occt 只是默认实现） ──
+export { registerOcctBrepEngine, OCCT_BREP_ENGINE_ID } from './brep/engine/adapters/occt.js';
+export { registerBrepkitBrepEngine, BREPKIT_BREP_ENGINE_ID, ensureBrepkitDefaultEngine } from './brep/engine/adapters/brepkit.js';
+export { registerBrepEngine, getBrepEngine, hasBrepEngine, getActiveBrepEngineId, freezeEngineRegistries, } from './brep/engine/registry.js';
+export { buildTopologyAdjacency } from './occt-kernel/topologyExt.js';
+// keep-syntax（P7）：宿主守卫——outputs 现含 compound，消费端须区分
+export { isCompoundLike } from './shape.js';
+export { isMeshShape } from './mesh/types.js';
+// buildSelectorRuntimeMaps: C 类（从 SelectorRuntimeData 构建 SelectorRuntime Maps）
+export { buildSelectorRuntimeMaps } from './topology/build-selector-runtime.js';
+// 拓扑常量
+export { TOPOLOGY_FACE_ID_NONE } from './topology/build-face-ids.js';
+// ── TopoRef 命名层（§3.7/§3.8：命名属于核心公共能力，随 browser/node 走）──
+export * from './topology/naming/index.js';
+// D 类辅助：拓扑构建函数（宿主在加载时刻调用，构建 mesh/primitive 近似拓扑）
+// 注意：这些只在加载/创建时刻合法，变更后不重新生成
+// BREP 真拓扑通过 CadRuntime.buildBrepTopology() 获取，不再直接导出 buildSolidTopologyRuntime
+export { buildSelectorRuntime, buildSelectorRuntimeData } from './topology/build-selector-runtime.js';
+export { buildFaceIdsForPart } from './topology/build-face-ids.js';
+// C 类辅助：面查询
+export { faceAt } from './mesh/query.js';
+export { NRAD_DEFAULT, NRAD_MIN, NRAD_MAX, clampNRad } from './mesh/types.js';
+export { SDF_TEMPLATES, DEFAULT_SDF_TEMPLATE } from './sdf/templates.js';
+export { boxToTuple, parseParamDefs, defaultParamValues } from './sdf/types.js';
+export { nextPrimitiveColor } from './primitives/types.js';
+export { getScrewSpec, getScrewSpecs, threadToPitchMm, SCREW_HEAD_DIMS } from './primitives/screw/screw-db.js';
+export { loadSystemCjkFont, containsCjk, isCjkChar } from './primitives/text/cjk.js';
+export { getOpentypeFont } from './primitives/text-geometry.js';
+// ═══════════════════════════════════════════════════════════
+// D 类：辅助函数 + 预览 API
+// ═══════════════════════════════════════════════════════════
+// 预览 API（D 类——宿主用这些做交互预览，不提交几何）
+export { cad } from './mesh/index.js';
+export { deriveNormals } from './boolean/deriveNormals.js';
+export { computeSection, buildExtrudedProfile } from './boolean/cross-section.js';
+export { buildExtrudeParts, makeWorldPlane } from './boolean/extrude-helpers.js';
+export { buildWedgeGeometry, buildDowelGeometry, buildStraightTenonGeometry, } from './boolean/joinery-shapes.js';
+export { geoToManifoldMesh, manifoldMeshToGeo } from './boolean/geo-convert.js';
+export { manifoldToMeshData, weldPositionsWorker, dovetailBooleanSplit, dowelOrTenonBooleanSplit, chainBoolean, meshToManifold } from './boolean/csg-core.js';
+export { previewMeshIntersect } from './boolean/manifold-preview.js';
+export { svgToExtrudedGeometry, parseSvgShapes } from './primitives/svg-extrude.js';
+export { createTextGeometry, opentypePathToGeometry } from './primitives/text-geometry.js';
+export { runSdfInline } from './sdf/sdf-core.js';
+export { runSdf as runSdfMain } from './sdf/sdf-runner.js';
+export { createMixedTextGeometry } from './primitives/text/cjk.js';
+// Knurl D 类
+export { applyKnurlDisplacement, KNURL_DEFAULTS } from './mesh/knurl/KnurlGenerator.js';
+export { subdivide } from './mesh/knurl/subdivision.js';
+export { loadKnurlingTexture } from './mesh/knurl/textureLoader.js';
+export { QuantizedPointMap, weldVertices } from './mesh/knurl/meshIndex.js';
+export { computeUV, MODE_TRIPLANAR, getCubicBlendWeights } from './mesh/knurl/mapping.js';
+export { applyDisplacement } from './mesh/knurl/displacement.js';
+// Primitive D 类（预览用）
+export { mergeBufferGeometries, makePrimitiveGeo, DEFAULT_SIZE, applyPrimitiveOffset } from './primitives/mesh-primitives.js';
+export { makeScrew } from './primitives/screw/screw.js';
+export { extractMeshData, primitiveToBrepSolid, geometryToBrepSolid, brepSolidToStep, primitiveToBrepStep, } from './primitives/brep-primitives.js';
+// BREP 辅助（D 类）
+export { solidToShape, translateBrep, rotateBrep, scaleBrep, applyTransformBrep, fuseBrep, cutBrep, commonBrep, drillBrep, splitBrep, extrudeBrep, loadBrep, matrixToArray, } from './brep/brep-ops.js';
+export { getSolidBoundingBox } from './brep/brep-utils.js';
+export { buildStlBufferFromMesh } from './brep/export/stl.js';
+export { exportStepFromSolid, exportStepFromSolids } from './brep/export/step.js';
+export { reconstructSolidFromMesh, meshToAsciiStl, cadShapeIsValid, meshToStepBrep } from './occt-kernel/meshReconstruct.js';
+// ── L3 API 面（P6/D1：原 packages/stdlib 迁入 core）──
+export * from './api/index.js';
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @faicad/faijs/browser — Browser-safe exports (F6: A/B/C/D 四类收敛)\n *\n * Excludes L3 Node Host modules (node-host/*) that depend on node:fs/node:path.\n * Use this entry point in browser/worker contexts to avoid pulling in Node.js code.\n *\n * For full exports (including Node.js), use @faicad/faijs instead.\n *\n * 导出分类（契约 §11 白名单四类）：\n * - A 类 = lang/ 全部导出（脚本类型 + 构建辅助 + 接口约定类型 + 常量）\n * - B 类 = cad-runtime/ + createBrowserPorts + 外部资源注入点 + 执行位置选项\n * - C 类 = 执行产物类型（Shape + 拓扑数据类型 + buildSelectorRuntimeMaps）\n * - D 类 = 辅助函数 + 预览 API（明确导出后使用）\n *\n * Phase 2 收尾完成：deprecated 区已删除。宿主如需执行/读取几何，一律走\n * CadRuntime.execute / 高层 API（importStep/exportStep/ensureOcctKernel）；\n * 主线程 CSG/SDF 预览走 previewMeshIntersect / runSdfMain。\n */\n\nexport {\n  configureBackends, getBackends, setCurrentStmt, getCurrentStmt,\n  keep, keepHidden, getRuntimeState, nameOf, setName, setKeepSink,\n  setPendingAssemblyTransforms, takePendingAssemblyTransforms, assertContractVersion,\n  CONTRACT_VERSION,\n} from './runtime-state'\nexport type {\n  Backends, FaijsRuntimeState, ShapeSlot, KeepSink, RuntimeExecutionMode,\n  AssemblyTransform, StdlibFn, StdlibNamespace,\n} from './runtime-state'\n\n// ═══════════════════════════════════════════════════════════\n// identity：品牌类型 + 信任点（f0，零依赖）\n// ═══════════════════════════════════════════════════════════\n\nexport type {\n  FileId, InnerId, ScopedId, StmtId, PartName, GroupName,\n  RefId, ReferenceId, SelectorKey, OccurrenceId, ShapeId,\n  FaceId, EdgeId, NodeId, StatementId, FaceSelector,\n} from './identity'\nexport {\n  asFileId, asInnerId, asScopedId, asStmtId, asPartName, asGroupName,\n  asRefId, asReferenceId, asSelectorKey, asOccurrenceId, asShapeId,\n  asFaceId, asEdgeId, asNodeId,\n  toScopedId, splitScopedId, isScopedId, toInnerId,\n} from './identity'\n\n// ═══════════════════════════════════════════════════════════\n// A 类：lang/ 文本面导出（IR 是引擎内部实现细节，不导出；公开面只有代码文本工具与结果类型）\n// ═══════════════════════════════════════════════════════════\n\nexport type {\n  Vec3, JsonValue,\n  TerminalShape, ParamDef,\n} from './lang/types'\nexport {\n  derivePartName, getMaxModelNum,\n} from './lang/allocate-id'\nexport type { DerivePartNameInput, DerivePartNameResult } from './lang/allocate-id'\nexport { fmtNum, formatCodeLine } from './lang/codegen'\nexport type { FormatCodeLineInput } from './lang/codegen'\nexport { analyzeCode } from './lang/statement-summary'\nexport type { StatementSummary } from './lang/statement-summary'\nexport { codeToArgs } from './lang/code-to-args'\nexport type { CodeToArgsResult } from './lang/code-to-args'\n// MetadataExtractor — 无 IR 元数据提取器（UI 通道语义源；UiMetadata 全量）\nexport { extractMetadata } from './lang/metadata-extractor'\nexport type {\n  UiMetadata, ArgSource, ParamEntry, ImportEntry, FunctionEntry, BlockEntry, KeepEntry,\n  ExtractMetadataOptions,\n} from './lang/metadata-extractor'\n// 参数表达式编辑（P0-C/P0-D）：实时校验层 + 编辑面板纯函数\nexport { validateExpression } from './lang/expr-validate'\nexport type { ExprValidateInput, ExprValidateResult } from './lang/expr-validate'\nexport { editArgSource } from './lang/source-edit'\nexport type { EditSourceError } from './lang/source-edit'\n// HostArg — 宿主友好位置参数类型（IR 屏蔽层）\nexport type {\n  HostArg, HostRef, HostVarRef, HostParamRef, HostCallRef, HostExprRef, HostRefKind,\n} from './lang/host-arg'\nexport {\n  isHostVarRef, isHostParamRef, isHostCallRef, isHostExprRef, isHostRef,\n  hostArgToDisplay, hostArgToLiteral, HOST_REF_KINDS,\n} from './lang/host-arg'\n\n// ═══════════════════════════════════════════════════════════\n// B 类：cad-runtime/ + createBrowserPorts + 外部资源注入点\n// ═══════════════════════════════════════════════════════════\n\n// D1（2026-09-19）：浏览器入口同样自注册 cad（与 index.ts 同源包装，避免门面注入）。\nexport { CadRuntime, createRuntime, AppendPrefixError } from './cad-runtime/createRuntimeWithCad'\nexport { createPreviewExec } from './cad-runtime/preview-exec'\nexport type { PreviewExec } from './cad-runtime/preview-exec'\nexport type { ExecutionResult, ExecuteOptions, CheckResult, CheckError, PartTopology, TopologySource } from './cad-runtime/runtime'\nexport type {\n  HostPorts,\n  CsgBackend, SdfBackend, FontProvider, TextureSampler,\n  AssetResolver, EventSink, ExecutionMode, LibLoader,\n  MeshData, PlaneParams, SplitResult as CsgSplitResult,\n  DovetailGrooveParams as PortDovetailGrooveParams,\n  DowelSplitParams as PortDowelSplitParams,\n  StraightTenonSplitParams as PortStraightTenonSplitParams,\n} from './cad-runtime/ports'\n\n// 外部资源注入点\nexport { setManifoldWasmUrl, getManifoldWasmUrl } from './mesh/manifold-loader'\nexport { setOcctWasmInitFn } from './occt-kernel/occtKernel'\nexport { setBrepkitWasmInitFn, initBrepkitWasm, isBrepkitInitialized } from './brepkit-kernel/brepkitWasm'\nexport { setFontLoader, getFontLoader, loadFont, ensureDefaultFont, getFont, clearFonts } from './brep/text/fontRegistry'\nexport type { FontLoader } from './brep/text/fontRegistry'\nexport { setKnurlTextureLoader } from './mesh/knurl/textureLoader'\n\n// L3 Browser Host 工厂\nexport { createBrowserPorts } from './browser-host'\nexport type { CreateBrowserPortsOptions } from './browser-host'\n// D3-Browser（§9.4）：CDN 通用 libLoader 工厂（a/b 混合）。**不**被 createBrowserPorts\n// 默认装配——demo 的源码 alias HMR 路径必须零网络；CDN 装载由主机显式注入。\nexport { createBrowserLibLoader, DEFAULT_CDN_BASE } from './cad-runtime/browser-lib-loader'\nexport type {\n  BrowserLibLoader, BrowserLibMeta, CreateBrowserLibLoaderOptions,\n} from './cad-runtime/browser-lib-loader'\nexport { BrowserEventSink } from './browser-host/browser-event-sink'\nexport { BrowserFontProvider } from './browser-host/browser-font-provider'\nexport type { BrowserFontProviderOptions } from './browser-host/browser-font-provider'\nexport { FetchAssetResolver } from './browser-host/fetch-asset-resolver'\nexport type { FetchAssetResolverOptions } from './browser-host/fetch-asset-resolver'\nexport { WorkerCsgBackend } from './browser-host/worker-csg-backend'\nexport { WorkerSdfBackend } from './browser-host/worker-sdf-backend'\n\n// E12.2: OCCT 高层 API（B 类——宿主用这些替代底层 kernel 函数）\nexport { importStep, importStepMultiPart, exportStep, releaseSolid, ensureOcctKernel, disposeOcct, exportStepFromSolidsHighLevel } from './occt-kernel/highLevelApi'\nexport type { ImportStepResult, ImportStepPartResult, ExportStepOptions } from './occt-kernel/highLevelApi'\n// 高层 API 的类型签名依赖的 OCCT 句柄/内核类型（D 类，公共契约）\nexport type { OcctKernel, ShapeHandle, WasmTessellatedMesh, Mesh, MeshDeflectionOptions } from './occt-kernel/highLevelApi'\n\n// ── BREP 引擎注册（宿主装配；引擎可切换——occt 只是默认实现） ──\nexport { registerOcctBrepEngine, OCCT_BREP_ENGINE_ID } from './brep/engine/adapters/occt'\nexport { registerBrepkitBrepEngine, BREPKIT_BREP_ENGINE_ID, ensureBrepkitDefaultEngine } from './brep/engine/adapters/brepkit'\nexport {\n  registerBrepEngine, getBrepEngine, hasBrepEngine, getActiveBrepEngineId, freezeEngineRegistries,\n} from './brep/engine/registry'\nexport type { BrepEngine, BrepEngineProvider } from './brep/engine/registry'\nexport type { BrepEngineApi } from './brep/engine/primitives'\nexport type {\n  BrepHandle, BrepMeshResult, BrepBoundingBox, BrepVec3, BrepCapabilities,\n  BrepEvolutionData, BrepXcafDocument,\n} from './brep/engine/types'\nexport { buildTopologyAdjacency, type TopologyAdjacency } from './occt-kernel/topologyExt'\n\n// keep-syntax（P7）：宿主守卫——outputs 现含 compound，消费端须区分\nexport { isCompoundLike } from './shape'\nexport { isMeshShape } from './mesh/types'\n\n// ═══════════════════════════════════════════════════════════\n// C 类：执行产物类型（Shape + 拓扑数据类型 + buildSelectorRuntimeMaps）\n// ═══════════════════════════════════════════════════════════\n\nexport type { Shape } from './mesh/types'\n\n// 拓扑数据类型\nexport type { SelectorRuntimeData } from './topology/build-selector-runtime'\nexport type {\n  SelectorRuntime, SelectorBundle, SelectorManifest, SelectorBuffers,\n  FaceRow, EdgeRow, Reference,\n  BufferViewDescriptor, SelectorProxy,\n} from './topology/types'\n\n// buildSelectorRuntimeMaps: C 类（从 SelectorRuntimeData 构建 SelectorRuntime Maps）\nexport { buildSelectorRuntimeMaps } from './topology/build-selector-runtime'\n\n// 拓扑常量\nexport { TOPOLOGY_FACE_ID_NONE } from './topology/build-face-ids'\n\n// ── TopoRef 命名层（§3.7/§3.8：命名属于核心公共能力，随 browser/node 走）──\nexport * from './topology/naming'\n\n// D 类辅助：拓扑构建函数（宿主在加载时刻调用，构建 mesh/primitive 近似拓扑）\n// 注意：这些只在加载/创建时刻合法，变更后不重新生成\n// BREP 真拓扑通过 CadRuntime.buildBrepTopology() 获取，不再直接导出 buildSolidTopologyRuntime\nexport { buildSelectorRuntime, buildSelectorRuntimeData } from './topology/build-selector-runtime'\nexport { buildFaceIdsForPart } from './topology/build-face-ids'\nexport type { SolidTopologyResult } from './brep/brep-topology'\n\n// C 类辅助：面查询\nexport { faceAt } from './mesh/query'\nexport type {\n  BoundingBox, FaceDescriptor,\n  BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams,\n  TextParams, SvgExtrudeParams, SdfParams,\n  DrillParams, ExtrudeParams, EngraveParams, KnurlParams,\n  SplitPlane, SplitResult,\n} from './mesh/types'\nexport { NRAD_DEFAULT, NRAD_MIN, NRAD_MAX, clampNRad } from './mesh/types'\n\n// SDF 类型\nexport type { SdfMeshData } from './sdf/sdf-runner'\nexport { SDF_TEMPLATES, DEFAULT_SDF_TEMPLATE } from './sdf/templates'\nexport type {\n  SdfMeta, SdfBox, SdfParamDef, SdfTemplateCategory,\n  SdfWorkerInput, SdfWorkerMessage,\n} from './sdf/types'\nexport { boxToTuple, parseParamDefs, defaultParamValues } from './sdf/types'\n\n// Primitive 类型\nexport type {\n  PrimitiveType, PrimitiveParamsRecord, PrimitiveArgsRecord, PrimitiveMeta,\n} from './primitives/types'\nexport { nextPrimitiveColor } from './primitives/types'\nexport type { ScrewParams, ScrewSpec, ScrewSystem } from './primitives/screw/screw-db'\nexport { getScrewSpec, getScrewSpecs, threadToPitchMm, SCREW_HEAD_DIMS } from './primitives/screw/screw-db'\nexport type { CjkFontResult } from './primitives/text/cjk'\nexport { loadSystemCjkFont, containsCjk, isCjkChar } from './primitives/text/cjk'\nexport { getOpentypeFont } from './primitives/text-geometry'\n\n// Boolean/CSG 辅助类型\nexport type { ExtrudeParts, ExtrudeOffsetMode } from './boolean/extrude-helpers'\nexport type { JoineryMeshData } from './boolean/joinery-shapes'\nexport type {\n  ManifoldMeshData, BooleanOperation,\n  DovetailGrooveParams, DowelSplitParams, StraightTenonSplitParams,\n} from './boolean/geo-convert'\nexport type { TextureData } from './mesh/knurl/textureLoader'\nexport type { KnurlBounds } from './mesh/knurl/KnurlGenerator'\nexport type { DrillBrepParams, SplitBrepParams, SplitBrepResult, ExtrudeBrepParams } from './brep/brep-ops'\nexport type { PrimitiveToBrepResult, PrimitiveParams } from './primitives/brep-primitives'\n\n// ═══════════════════════════════════════════════════════════\n// D 类：辅助函数 + 预览 API\n// ═══════════════════════════════════════════════════════════\n\n// 预览 API（D 类——宿主用这些做交互预览，不提交几何）\nexport { cad } from './mesh'\nexport { deriveNormals } from './boolean/deriveNormals'\nexport { computeSection, buildExtrudedProfile } from './boolean/cross-section'\nexport { buildExtrudeParts, makeWorldPlane } from './boolean/extrude-helpers'\nexport {\n  buildWedgeGeometry, buildDowelGeometry, buildStraightTenonGeometry,\n} from './boolean/joinery-shapes'\nexport { geoToManifoldMesh, manifoldMeshToGeo } from './boolean/geo-convert'\nexport { manifoldToMeshData, weldPositionsWorker, dovetailBooleanSplit, dowelOrTenonBooleanSplit, chainBoolean, meshToManifold } from './boolean/csg-core'\nexport { previewMeshIntersect } from './boolean/manifold-preview'\nexport type { ManifoldMeshData as PreviewManifoldMeshData } from './boolean/manifold-preview'\nexport { svgToExtrudedGeometry, parseSvgShapes } from './primitives/svg-extrude'\nexport type { SvgExtrudeOptions } from './primitives/svg-extrude'\nexport { createTextGeometry, opentypePathToGeometry } from './primitives/text-geometry'\nexport { runSdfInline } from './sdf/sdf-core'\nexport { runSdf as runSdfMain } from './sdf/sdf-runner'\nexport type { SdfMeshData as PreviewSdfMesh } from './sdf/sdf-runner'\nexport { createMixedTextGeometry } from './primitives/text/cjk'\n\n// Knurl D 类\nexport { applyKnurlDisplacement, KNURL_DEFAULTS } from './mesh/knurl/KnurlGenerator'\nexport { subdivide } from './mesh/knurl/subdivision'\nexport { loadKnurlingTexture } from './mesh/knurl/textureLoader'\nexport { QuantizedPointMap, weldVertices } from './mesh/knurl/meshIndex'\nexport { computeUV, MODE_TRIPLANAR, getCubicBlendWeights, type MappingSettings } from './mesh/knurl/mapping'\nexport { applyDisplacement, type DisplacementSettings } from './mesh/knurl/displacement'\n\n// Primitive D 类（预览用）\nexport { mergeBufferGeometries, makePrimitiveGeo, DEFAULT_SIZE, applyPrimitiveOffset } from './primitives/mesh-primitives'\nexport { makeScrew } from './primitives/screw/screw'\nexport {\n  extractMeshData, primitiveToBrepSolid, geometryToBrepSolid,\n  brepSolidToStep, primitiveToBrepStep,\n} from './primitives/brep-primitives'\n\n// BREP 辅助（D 类）\nexport {\n  solidToShape,\n  translateBrep, rotateBrep, scaleBrep, applyTransformBrep,\n  fuseBrep, cutBrep, commonBrep,\n  drillBrep, splitBrep, extrudeBrep,\n  loadBrep, matrixToArray,\n} from './brep/brep-ops'\nexport { getSolidBoundingBox } from './brep/brep-utils'\nexport { buildStlBufferFromMesh } from './brep/export/stl'\nexport { exportStepFromSolid, exportStepFromSolids } from './brep/export/step'\nexport type { StepExportEntry } from './brep/export/step'\nexport { reconstructSolidFromMesh, meshToAsciiStl, cadShapeIsValid, meshToStepBrep } from './occt-kernel/meshReconstruct'\n\n// ── L3 API 面（P6/D1：原 packages/stdlib 迁入 core）──\nexport * from './api'\n"]}

package/dist/cad-runtime/admit-compat-lib.d.ts

@@ -0,0 +1,29 @@
+/**
+ * admit-compat-lib — registerLib's admission-stage enhancement (B4 fix).
+ *
+ * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §4.3.3
+ *
+ * Hard ordering constraint: assertLibConforms runs BEFORE wrapping — DUAL_OP_META
+ * hangs on the function object with enumerable:false (define-op.ts) and
+ * assertLibConforms iterates values via Object.values to judge metadata; a
+ * wrap-first admission would let bare functions silently skip the whole strict
+ * validation pass (verified in practice, R8).
+ *
+ * Multi-output annotation: the only contract name is `fn.outputs` (the
+ * `outputs` defineOp option); the legacy name is deleted repo-wide.
+ *
+ * @module
+ */
+/**
+ * Establish an admission-stage wrapper namespace for registerLib.
+ *
+ * Non-functions (contractVersion / resource objects) and native dual-ops
+ * (already carrying DUAL_OP_META) pass through just as they are; any bare
+ * function is lifted through compatOp so it cannot silently bypass the
+ * statement-level boundary contract (B4).
+ *
+ * @param ns the library namespace object being registered.
+ * @returns the admitted namespace (bare functions replaced by compatOp facades).
+ */
+export declare function admitCompatLib(ns: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=admit-compat-lib.d.ts.map

package/dist/cad-runtime/admit-compat-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admit-compat-lib.d.ts","sourceRoot":"","sources":["../../src/cad-runtime/admit-compat-lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYnF"}

package/dist/cad-runtime/admit-compat-lib.js

@@ -0,0 +1,49 @@
+/**
+ * admit-compat-lib — registerLib's admission-stage enhancement (B4 fix).
+ *
+ * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §4.3.3
+ *
+ * Hard ordering constraint: assertLibConforms runs BEFORE wrapping — DUAL_OP_META
+ * hangs on the function object with enumerable:false (define-op.ts) and
+ * assertLibConforms iterates values via Object.values to judge metadata; a
+ * wrap-first admission would let bare functions silently skip the whole strict
+ * validation pass (verified in practice, R8).
+ *
+ * Multi-output annotation: the only contract name is `fn.outputs` (the
+ * `outputs` defineOp option); the legacy name is deleted repo-wide.
+ *
+ * @module
+ */
+import { assertLibConforms, DUAL_OP_META } from '../define-op.js';
+import { compatOp } from '../api/internal/compat-op.js';
+/**
+ * Establish an admission-stage wrapper namespace for registerLib.
+ *
+ * Non-functions (contractVersion / resource objects) and native dual-ops
+ * (already carrying DUAL_OP_META) pass through just as they are; any bare
+ * function is lifted through compatOp so it cannot silently bypass the
+ * statement-level boundary contract (B4).
+ *
+ * @param ns the library namespace object being registered.
+ * @returns the admitted namespace (bare functions replaced by compatOp facades).
+ */
+export function admitCompatLib(ns) {
+    assertLibConforms(ns);
+    const out = {};
+    for (const [name, v] of Object.entries(ns)) {
+        if (typeof v !== 'function') {
+            out[name] = v;
+            continue;
+        }
+        if (v[DUAL_OP_META]) {
+            out[name] = v;
+            continue;
+        }
+        out[name] = compatOp(v, {
+            name,
+            outputs: v.outputs, // only fn.outputs; no other annotation name is recognized (§3.6)
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=admit-compat-lib.js.map

package/dist/cad-runtime/admit-compat-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admit-compat-lib.js","sourceRoot":"","sources":["../../src/cad-runtime/admit-compat-lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAIpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,EAA2B;IACxD,iBAAiB,CAAC,EAAE,CAAC,CAAA;IACrB,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,KAAK,UAAU,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxD,IAAK,CAAwC,CAAC,YAAY,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxF,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAiC,EAAE;YACtD,IAAI;YACJ,OAAO,EAAG,CAAoB,CAAC,OAAO,EAAE,iEAAiE;SAC1G,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/**\n * admit-compat-lib — registerLib's admission-stage enhancement (B4 fix).\n *\n * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §4.3.3\n *\n * Hard ordering constraint: assertLibConforms runs BEFORE wrapping — DUAL_OP_META\n * hangs on the function object with enumerable:false (define-op.ts) and\n * assertLibConforms iterates values via Object.values to judge metadata; a\n * wrap-first admission would let bare functions silently skip the whole strict\n * validation pass (verified in practice, R8).\n *\n * Multi-output annotation: the only contract name is `fn.outputs` (the\n * `outputs` defineOp option); the legacy name is deleted repo-wide.\n *\n * @module\n */\n\nimport { assertLibConforms, DUAL_OP_META } from '../define-op'\nimport { compatOp } from '../api/internal/compat-op'\n\ntype OutputsCarrier = { outputs?: string[] }\n\n/**\n * Establish an admission-stage wrapper namespace for registerLib.\n *\n * Non-functions (contractVersion / resource objects) and native dual-ops\n * (already carrying DUAL_OP_META) pass through just as they are; any bare\n * function is lifted through compatOp so it cannot silently bypass the\n * statement-level boundary contract (B4).\n *\n * @param ns the library namespace object being registered.\n * @returns the admitted namespace (bare functions replaced by compatOp facades).\n */\nexport function admitCompatLib(ns: Record<string, unknown>): Record<string, unknown> {\n  assertLibConforms(ns)\n  const out: Record<string, unknown> = {}\n  for (const [name, v] of Object.entries(ns)) {\n    if (typeof v !== 'function') { out[name] = v; continue }\n    if ((v as unknown as Record<string, unknown>)[DUAL_OP_META]) { out[name] = v; continue }\n    out[name] = compatOp(v as (...a: unknown[]) => unknown, {\n      name,\n      outputs: (v as OutputsCarrier).outputs, // only fn.outputs; no other annotation name is recognized (§3.6)\n    })\n  }\n  return out\n}"]}

package/dist/cad-runtime/backend-dispatch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * backend-dispatch — BREP/mesh 路径静态判定（引擎侧）
+ *
+ *
+ * 红线（AGENTS.md）：BREP 链是否可用，由静态规则在执行前判定，
+ * **禁止运行时 try-catch 回退**。BREP 路径抛异常 = 设计缺陷或 bug，必须直接报错暴露。
+ *
+ * 本文件从 src/stdlib/internal/resolve-path.ts 迁移而来：判定是引擎的职责，
+ * 不该由每个库函数各自调用。
+ *
+ * ⚠️ 分层例外：本文件位于 cad-runtime/ 但被 stdlib/ import。
+ * 这是安全的——它只依赖 runtime-state / stdlib/shape / mesh/types，
+ * 不依赖 cad-runtime 的任何其他模块，因此不构成循环。
+ * P4b（可选）把函数拆成 brep/mesh 双实现后，此依赖会自然消失。
+ */
+import type { Shape } from '../mesh/types.js';
+/** 静态判定的两个可能结果：走 BREP 链或 mesh 链。 */
+export type BrepPath = 'brep' | 'mesh';
+/** 能力名（对应 §7.5 BrepCapabilities 的布尔字段；能力路由 §8.4 用）。 */
+export type BrepCapabilityName = 'evolution' | 'heal' | 'directEdit' | 'advSurface' | 'assembly' | 'meshLift';
+/**
+ * Decide whether this invocation takes the BREP or the mesh backend path.
+ *
+ * Bidirectional dispatch (defineOp contract, D1/D1b/D2):
+ * - `impls` carries mesh/brep implementation presence (function reference or
+ *   undefined, fixed at defineOp construction — static).
+ * - `mode='mesh'` → always mesh; missing mesh implementation (brep-only)
+ *   throws `MeshUnsupportedError`.
+ * - `mode='brep'` → missing brep / input off chain / missing capability throws
+ *   `BrepUnsupportedError`.
+ * - `mode='auto'` → brep when brep exists and all inputs are on the chain;
+ *   otherwise mesh when mesh exists; brep-only with a broken input chain (or
+ *   missing capability) throws `MeshUnsupportedError` — no mesh to fall back to.
+ *
+ * Capability routing (requiredCapability): when the current engine (registry)
+ * lacks a declared capability, brep mode throws a BrepUnsupportedError (an
+ * explicit error, never a silent fallback) while auto mode statically degrades
+ * to mesh (never fabricating a missing capability).
+ *
+ * Red line unchanged: static dispatch, no runtime try-catch fallback. The
+ * decision happens before the implementation runs and is never revised after a
+ * failed execution.
+ *
+ * Third-party library authors never call this directly — `defineOp` (SDK)
+ * invokes it inside its wrapper; authors only declare the implementation set.
+ * @param inputs - the shapes feeding the operation, used to test whether all
+ * lie on the BREP chain.
+ * @param impls - the operation's implementation set: `mesh`/`brep` presence
+ * (function reference or undefined; fixed at defineOp construction).
+ * @param requiredCapability - an optional capability the operation declares;
+ * a missing capability routes the dispatch.
+ * @returns the selected backend path: 'brep' or 'mesh'.
+ */
+export declare function dispatchPath(inputs: Shape[], impls: {
+    mesh?: unknown;
+    brep?: unknown;
+}, requiredCapability?: BrepCapabilityName): BrepPath;
+//# sourceMappingURL=backend-dispatch.d.ts.map

package/dist/cad-runtime/backend-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-dispatch.d.ts","sourceRoot":"","sources":["../../src/cad-runtime/backend-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,oCAAoC;AACpC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAEtC,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,UAAU,CAAA;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACzC,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,QAAQ,CA+CV"}

package/dist/cad-runtime/backend-dispatch.js

@@ -0,0 +1,87 @@
+/**
+ * backend-dispatch — BREP/mesh 路径静态判定（引擎侧）
+ *
+ *
+ * 红线（AGENTS.md）：BREP 链是否可用，由静态规则在执行前判定，
+ * **禁止运行时 try-catch 回退**。BREP 路径抛异常 = 设计缺陷或 bug，必须直接报错暴露。
+ *
+ * 本文件从 src/stdlib/internal/resolve-path.ts 迁移而来：判定是引擎的职责，
+ * 不该由每个库函数各自调用。
+ *
+ * ⚠️ 分层例外：本文件位于 cad-runtime/ 但被 stdlib/ import。
+ * 这是安全的——它只依赖 runtime-state / stdlib/shape / mesh/types，
+ * 不依赖 cad-runtime 的任何其他模块，因此不构成循环。
+ * P4b（可选）把函数拆成 brep/mesh 双实现后，此依赖会自然消失。
+ */
+import { getBackends, getCurrentStmt, BrepUnsupportedError, MeshUnsupportedError } from '../runtime-state.js';
+import { hasBrep } from '../shape.js';
+/**
+ * Decide whether this invocation takes the BREP or the mesh backend path.
+ *
+ * Bidirectional dispatch (defineOp contract, D1/D1b/D2):
+ * - `impls` carries mesh/brep implementation presence (function reference or
+ *   undefined, fixed at defineOp construction — static).
+ * - `mode='mesh'` → always mesh; missing mesh implementation (brep-only)
+ *   throws `MeshUnsupportedError`.
+ * - `mode='brep'` → missing brep / input off chain / missing capability throws
+ *   `BrepUnsupportedError`.
+ * - `mode='auto'` → brep when brep exists and all inputs are on the chain;
+ *   otherwise mesh when mesh exists; brep-only with a broken input chain (or
+ *   missing capability) throws `MeshUnsupportedError` — no mesh to fall back to.
+ *
+ * Capability routing (requiredCapability): when the current engine (registry)
+ * lacks a declared capability, brep mode throws a BrepUnsupportedError (an
+ * explicit error, never a silent fallback) while auto mode statically degrades
+ * to mesh (never fabricating a missing capability).
+ *
+ * Red line unchanged: static dispatch, no runtime try-catch fallback. The
+ * decision happens before the implementation runs and is never revised after a
+ * failed execution.
+ *
+ * Third-party library authors never call this directly — `defineOp` (SDK)
+ * invokes it inside its wrapper; authors only declare the implementation set.
+ * @param inputs - the shapes feeding the operation, used to test whether all
+ * lie on the BREP chain.
+ * @param impls - the operation's implementation set: `mesh`/`brep` presence
+ * (function reference or undefined; fixed at defineOp construction).
+ * @param requiredCapability - an optional capability the operation declares;
+ * a missing capability routes the dispatch.
+ * @returns the selected backend path: 'brep' or 'mesh'.
+ */
+export function dispatchPath(inputs, impls, requiredCapability) {
+    const { config } = getBackends();
+    if (config.mode === 'mesh') {
+        if (!impls.mesh) {
+            throw new MeshUnsupportedError('E_MESH_UNSUPPORTED: function has no mesh implementation', getCurrentStmt());
+        }
+        return 'mesh';
+    }
+    const currentStmt = getCurrentStmt();
+    if (config.mode === 'brep') {
+        if (!impls.brep) {
+            throw new BrepUnsupportedError('E_BREP_UNSUPPORTED: function has no BREP implementation', currentStmt);
+        }
+        if (!inputs.every(hasBrep)) {
+            throw new BrepUnsupportedError('E_BREP_UNSUPPORTED: input is not BREP', currentStmt);
+        }
+        // 能力路由：brep 模式缺能力 → 明确报错，不静默回退
+        if (requiredCapability && !config.brepCapabilities?.[requiredCapability]) {
+            throw new BrepUnsupportedError(`E_BREP_UNSUPPORTED: current engine lacks capability '${requiredCapability}' (brepEngineId=${config.brepEngineId ?? '<none>'})`, currentStmt);
+        }
+        return 'brep';
+    }
+    // auto 模式：能力路由（缺能力 → 静态降级走 mesh；brep-only 无 mesh 可降 → 明确报错）
+    if (requiredCapability && !config.brepCapabilities?.[requiredCapability]) {
+        if (!impls.mesh) {
+            throw new MeshUnsupportedError(`E_MESH_UNSUPPORTED: current engine lacks capability '${requiredCapability}' and function has no mesh implementation`, currentStmt);
+        }
+        return 'mesh';
+    }
+    if (impls.brep && inputs.every(hasBrep))
+        return 'brep';
+    if (!impls.mesh) {
+        throw new MeshUnsupportedError('E_MESH_UNSUPPORTED: input is not BREP and function has no mesh implementation', currentStmt);
+    }
+    return 'mesh';
+}
+//# sourceMappingURL=backend-dispatch.js.map

package/dist/cad-runtime/backend-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-dispatch.js","sourceRoot":"","sources":["../../src/cad-runtime/backend-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC1G,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAelC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAe,EACf,KAAyC,EACzC,kBAAuC;IAEvC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;IAEhC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,oBAAoB,CAAC,yDAAyD,EAAE,cAAc,EAAE,CAAC,CAAA;QAC7G,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,oBAAoB,CAAC,yDAAyD,EAAE,WAAW,CAAC,CAAA;QACxG,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,oBAAoB,CAAC,uCAAuC,EAAE,WAAW,CAAC,CAAA;QACtF,CAAC;QACD,+BAA+B;QAC/B,IAAI,kBAAkB,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,oBAAoB,CAC5B,wDAAwD,kBAAkB,mBAAmB,MAAM,CAAC,YAAY,IAAI,QAAQ,GAAG,EAC/H,WAAW,CACZ,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,4DAA4D;IAC5D,IAAI,kBAAkB,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,oBAAoB,CAC5B,wDAAwD,kBAAkB,2CAA2C,EACrH,WAAW,CACZ,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAA;IACtD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,oBAAoB,CAC5B,+EAA+E,EAC/E,WAAW,CACZ,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/**\n * backend-dispatch — BREP/mesh 路径静态判定（引擎侧）\n *\n *\n * 红线（AGENTS.md）：BREP 链是否可用，由静态规则在执行前判定，\n * **禁止运行时 try-catch 回退**。BREP 路径抛异常 = 设计缺陷或 bug，必须直接报错暴露。\n *\n * 本文件从 src/stdlib/internal/resolve-path.ts 迁移而来：判定是引擎的职责，\n * 不该由每个库函数各自调用。\n *\n * ⚠️ 分层例外：本文件位于 cad-runtime/ 但被 stdlib/ import。\n * 这是安全的——它只依赖 runtime-state / stdlib/shape / mesh/types，\n * 不依赖 cad-runtime 的任何其他模块，因此不构成循环。\n * P4b（可选）把函数拆成 brep/mesh 双实现后，此依赖会自然消失。\n */\n\nimport { getBackends, getCurrentStmt, BrepUnsupportedError, MeshUnsupportedError } from '../runtime-state'\nimport { hasBrep } from '../shape'\nimport type { Shape } from '../mesh/types'\n\n/** 静态判定的两个可能结果：走 BREP 链或 mesh 链。 */\nexport type BrepPath = 'brep' | 'mesh'\n\n/** 能力名（对应 §7.5 BrepCapabilities 的布尔字段；能力路由 §8.4 用）。 */\nexport type BrepCapabilityName =\n  | 'evolution'\n  | 'heal'\n  | 'directEdit'\n  | 'advSurface'\n  | 'assembly'\n  | 'meshLift'\n\n/**\n * Decide whether this invocation takes the BREP or the mesh backend path.\n *\n * Bidirectional dispatch (defineOp contract, D1/D1b/D2):\n * - `impls` carries mesh/brep implementation presence (function reference or\n *   undefined, fixed at defineOp construction — static).\n * - `mode='mesh'` → always mesh; missing mesh implementation (brep-only)\n *   throws `MeshUnsupportedError`.\n * - `mode='brep'` → missing brep / input off chain / missing capability throws\n *   `BrepUnsupportedError`.\n * - `mode='auto'` → brep when brep exists and all inputs are on the chain;\n *   otherwise mesh when mesh exists; brep-only with a broken input chain (or\n *   missing capability) throws `MeshUnsupportedError` — no mesh to fall back to.\n *\n * Capability routing (requiredCapability): when the current engine (registry)\n * lacks a declared capability, brep mode throws a BrepUnsupportedError (an\n * explicit error, never a silent fallback) while auto mode statically degrades\n * to mesh (never fabricating a missing capability).\n *\n * Red line unchanged: static dispatch, no runtime try-catch fallback. The\n * decision happens before the implementation runs and is never revised after a\n * failed execution.\n *\n * Third-party library authors never call this directly — `defineOp` (SDK)\n * invokes it inside its wrapper; authors only declare the implementation set.\n * @param inputs - the shapes feeding the operation, used to test whether all\n * lie on the BREP chain.\n * @param impls - the operation's implementation set: `mesh`/`brep` presence\n * (function reference or undefined; fixed at defineOp construction).\n * @param requiredCapability - an optional capability the operation declares;\n * a missing capability routes the dispatch.\n * @returns the selected backend path: 'brep' or 'mesh'.\n */\nexport function dispatchPath(\n  inputs: Shape[],\n  impls: { mesh?: unknown; brep?: unknown },\n  requiredCapability?: BrepCapabilityName,\n): BrepPath {\n  const { config } = getBackends()\n\n  if (config.mode === 'mesh') {\n    if (!impls.mesh) {\n      throw new MeshUnsupportedError('E_MESH_UNSUPPORTED: function has no mesh implementation', getCurrentStmt())\n    }\n    return 'mesh'\n  }\n  const currentStmt = getCurrentStmt()\n\n  if (config.mode === 'brep') {\n    if (!impls.brep) {\n      throw new BrepUnsupportedError('E_BREP_UNSUPPORTED: function has no BREP implementation', currentStmt)\n    }\n    if (!inputs.every(hasBrep)) {\n      throw new BrepUnsupportedError('E_BREP_UNSUPPORTED: input is not BREP', currentStmt)\n    }\n    // 能力路由：brep 模式缺能力 → 明确报错，不静默回退\n    if (requiredCapability && !config.brepCapabilities?.[requiredCapability]) {\n      throw new BrepUnsupportedError(\n        `E_BREP_UNSUPPORTED: current engine lacks capability '${requiredCapability}' (brepEngineId=${config.brepEngineId ?? '<none>'})`,\n        currentStmt,\n      )\n    }\n    return 'brep'\n  }\n\n  // auto 模式：能力路由（缺能力 → 静态降级走 mesh；brep-only 无 mesh 可降 → 明确报错）\n  if (requiredCapability && !config.brepCapabilities?.[requiredCapability]) {\n    if (!impls.mesh) {\n      throw new MeshUnsupportedError(\n        `E_MESH_UNSUPPORTED: current engine lacks capability '${requiredCapability}' and function has no mesh implementation`,\n        currentStmt,\n      )\n    }\n    return 'mesh'\n  }\n\n  if (impls.brep && inputs.every(hasBrep)) return 'brep'\n  if (!impls.mesh) {\n    throw new MeshUnsupportedError(\n      'E_MESH_UNSUPPORTED: input is not BREP and function has no mesh implementation',\n      currentStmt,\n    )\n  }\n  return 'mesh'\n}\n"]}

package/dist/cad-runtime/browser-lib-loader.d.ts

@@ -0,0 +1,76 @@
+/**
+ * browser-lib-loader — 浏览器通用 `LibLoader` 工厂（D3-Browser，§9.4）
+ *
+ * 与 node 侧 `cliPortsLibLoader`（`node-host/cli.ts`）对称：都实现 `LibLoader`
+ * 契约（`loadLib` / `listLibs` / `options.autoLiftFor`），差别只在装载通道——
+ * node 用 `import(pkg)` 从 `node_modules` 解析，浏览器用**动态 `import()`** 取 CDN。
+ *
+ * 两条通路（Q8 定稿的 a/b 混合，共用同一 `CDN_BASE`）：
+ * - **方案 a（importmap）**：不提供 `versions` 时，用**已解析的包名**做裸 specifier
+ *   动态 `import(pkg)`，由页面 `<script type="importmap">` 的 scope
+ *   （`"@faicad/": "CDN_BASE/*@faicad/"`）在后端按依赖图取版。零版本表，dev / playground 用。
+ * - **方案 b（精确 pin）**：提供 `versions`（`versions.json`）时拼
+ *   `` `${cdnBase}${pkg}@${version}/+esm` `` 直链，版本精确 pin 到已发布版本，保证
+ *   可复现与缓存命中；release 产物用。
+ *
+ * 别名归一：脚本 specifier 常是短名（demo 的 `.fai.js` 写 `gear-lib-demo` /
+ * `sheetmetal`），而 CDN 上是 npm 全名（`@faicad/gear-lib-demo`）。`aliases` 把
+ * specifier 映到包名后再装载，与 node 侧 `CLI_LIB_ALIASES` 同一职责。
+ *
+ * `autoLiftFor` 是**同步**回调（`runtime.ts` 在装载后立即取值），所以逐库
+ * `faijs.autoLift` 必须**预先**可用：主机从构建期产物 `lib-meta.json`
+ * （`scripts/gen-importmap.mjs` 生成）经 `meta` 传入；也可调 `prefetchMeta()`
+ * 在网络可达时抓各库 `package.json` 预热（失败静默回落推断式）。
+ *
+ * 本工厂**不**被 `createBrowserPorts` 默认装配——demo 走源码 alias 的 HMR 路径
+ * 必须保持零网络；CDN 装载仅服务「从 npm 消费已发布包」的场景，由主机显式注入。
+ */
+import type { LibLoader } from './ports.js';
+/** 默认 CDN base（Q8 定稿：jsDelivr npm 镜像；ESM 取 `+esm`）。 */
+export declare const DEFAULT_CDN_BASE = "https://cdn.jsdelivr.net/npm/";
+/** 逐库元数据（与 `lib-meta.json` 键形一致）。 */
+export interface BrowserLibMeta {
+    /** `package.json` 的 `faijs.autoLift` 外置字段（D3-autoLift）。 */
+    autoLift?: boolean;
+}
+/** `createBrowserLibLoader` 的选项。 */
+export interface CreateBrowserLibLoaderOptions {
+    /** CDN base，须以 `/` 结尾（缺省 `DEFAULT_CDN_BASE`）。 */
+    cdnBase?: string;
+    /** 方案 b：精确 pin 的 `packageName → version`（`versions.json`）；提供即走直链。 */
+    versions?: Record<string, string>;
+    /** 别名表：脚本 import specifier → npm 包名（如 `gear-lib-demo` → `@faicad/gear-lib-demo`）。 */
+    aliases?: Record<string, string>;
+    /** 允许装载的 **npm 包名**白名单；缺省不限制（生产建议显式给）。 */
+    libs?: string[];
+    /** 逐库元数据（`lib-meta.json`），喂 `options.autoLiftFor`。 */
+    meta?: Record<string, BrowserLibMeta>;
+    /** 全局 autoLift 缺省（喂 `options.autoLift`）；缺省交由 runtime 推断式决定。 */
+    autoLift?: boolean;
+    /** 强制方案 a（即使提供了 `versions` 也用裸 specifier，依赖 importmap）。 */
+    forceImportMap?: boolean;
+    /** 注入的动态 import 实现（测试用）；缺省为原生动态 `import()`。 */
+    importModule?: (url: string) => Promise<unknown>;
+    /** 注入的 fetch（`prefetchMeta` 用）；缺省全局 `fetch`，无则 `prefetchMeta` 为空操作。 */
+    fetchImpl?: typeof fetch;
+}
+/** 浏览器 `LibLoader`（在契约上附加元数据预热）。 */
+export interface BrowserLibLoader extends LibLoader {
+    /**
+     * 抓取已知各库的 `package.json`，把 `faijs.autoLift` 填进内部 meta 缓存。
+     * 网络失败静默跳过（保持未声明 → 回落推断式）。在 `execute` 前 await 一次即可。
+     * @returns promise resolving when all known libs have been probed.
+     */
+    prefetchMeta(): Promise<void>;
+}
+/**
+ * 创建浏览器通用 `LibLoader`。
+ *
+ * 装载顺序：`name` → `aliases` 归一为 npm 包名 → 白名单校验 → 方案 b 直链（有
+ * `versions[pkg]` 且未 `forceImportMap`）或方案 a 裸 specifier → 动态 `import()`；
+ * 同一包名并发/重复装载共享同一 in-flight promise（CDN 只取一次）。
+ * @param opts - CDN base、版本表 / 别名 / 元数据，以及测试用注入点。
+ * @returns 满足 `LibLoader` 契约、并附加 `prefetchMeta()` 的浏览器装载器。
+ */
+export declare function createBrowserLibLoader(opts?: CreateBrowserLibLoaderOptions): BrowserLibLoader;
+//# sourceMappingURL=browser-lib-loader.d.ts.map

package/dist/cad-runtime/browser-lib-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-lib-loader.d.ts","sourceRoot":"","sources":["../../src/cad-runtime/browser-lib-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGxC,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,kCAAkC,CAAA;AAE/D,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,oCAAoC;AACpC,MAAM,WAAW,6BAA6B;IAC5C,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAOD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,6BAAkC,GAAG,gBAAgB,CA2EjG"}