@faicad/faijs 0.22.2 → 0.29.3

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @faicad/faijs �?Faicad CAD execution engine\n *\n * 公开 API 统一入口。所有导出按层组织：\n * - L0 文本层：parser / codegen / symbol-table / types\n * - L1 几何执行层：BREP ops / Shape / 导出\n * - L1 Mesh 执行层：cad API\n * - L1 Boolean/CSG 辅助：cross-section / deriveNormals / extrude-helpers / joinery-shapes\n * - L1 Primitives：geometry / screw / svg-extrude / text / types\n * - L1 SDF：sdf-runner / templates / types\n * - L1 Knurl：KnurlGenerator / subdivision / textureLoader\n * - L1 Topology：build-face-ids / build-selector-runtime / types\n * - L2 编排层：CadRuntime / HostPorts\n * - L3 Node Host：createNodePorts / CLI\n * - OCCT Kernel：initOcctWasm / getKernel / setOcctWasmInitFn / ...\n * - CSG Backend：setCsgBackend / geoToManifoldMesh / ...\n */\n\n// ── 共享面（env-agnostic：identity + runtime-state + lang/*）──\n// 手写清单已收敛：三处 umbrella（index/browser/weapp）统一 re-export，防漂移。\nexport * from './env-agnostic'\n\n// ── L1 几何执行 ──\nexport type { Shape } from './mesh/types'\nexport type { BrepChainState } from './brep/brep-chain'\nexport {\n  createBrepChainState, initBrepChainState, releaseBrepChainState,\n  isCadFormat,\n} from './brep/brep-chain'\nexport {\n  solidToShape, getSolidBoundingBox,\n  translateBrep, rotateBrep, scaleBrep,\n  fuseBrep, cutBrep, commonBrep,\n  drillBrep, splitBrep, extrudeBrep,\n  loadBrep, matrixToArray,\n} from './brep'\nexport type { DrillBrepParams, SplitBrepParams, SplitBrepResult, ExtrudeBrepParams } from './brep'\nexport { buildStlBufferFromMesh } from './brep/export/stl'\nexport { exportStepFromSolid, exportStepFromSolids } from './brep/export/step'\nexport type { StepExportEntry } from './brep/export/step'\n\n// ── L1 Mesh ──\nexport { cad } from './mesh'\n// 宿主注入的 mesh 装饰几何（cad.engrave 的文字/SVG 几何链在 @faicad/faijs-extra）\nexport { setEngraveDecorationProvider, getEngraveDecorationProvider } from './mesh/decoration-provider'\nexport type { EngraveDecorationProvider, EngraveDecorationParams } from './mesh/decoration-provider'\nexport { setManifoldWasmUrl, getManifoldWasmUrl, getManifoldModule } from './mesh/manifold-loader'\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'\nexport { faceAt } from './mesh/query'\n\n// ── L1 Boolean/CSG 辅助 ──\nexport { computeSection, buildExtrudedProfile } from './boolean/cross-section'\nexport { manifoldToMeshData, weldPositionsWorker, dovetailBooleanSplit, dowelOrTenonBooleanSplit } from './boolean/csg-core'\nexport { deriveNormals } from './boolean/deriveNormals'\nexport { buildExtrudeParts, makeWorldPlane } from './boolean/extrude-helpers'\nexport type { ExtrudeParts, ExtrudeOffsetMode } from './boolean/extrude-helpers'\nexport {\n  buildWedgeGeometry, buildDowelGeometry, buildStraightTenonGeometry,\n} from './boolean/joinery-shapes'\nexport type { JoineryMeshData } from './boolean/joinery-shapes'\n\n// ── CSG Backend ──\nexport { setCsgBackend } from './boolean/csg-backend'\nexport { geoToManifoldMesh, manifoldMeshToGeo } from './boolean/geo-convert'\nexport type {\n  ManifoldMeshData, BooleanOperation,\n  DovetailGrooveParams, DowelSplitParams, StraightTenonSplitParams,\n} from './boolean/geo-convert'\n\n// ── L1 Primitives ──\nexport { mergeBufferGeometries, makePrimitiveGeo, DEFAULT_SIZE, applyPrimitiveOffset } from './primitives/mesh-primitives'\nexport { makeScrew } from './primitives/screw/screw'\nexport { getScrewSpec, getScrewSpecs, threadToPitchMm, SCREW_HEAD_DIMS } from './primitives/screw/screw-db'\nexport type { ScrewParams, ScrewSpec, ScrewSystem } from './primitives/screw/screw-db'\nexport { parseSvgNaturalSize } from './primitives/parse-svg-size'\nexport {\n  extractMeshData, primitiveToBrepSolid, geometryToBrepSolid,\n  brepSolidToStep, primitiveToBrepStep,\n} from './primitives/brep-primitives'\nexport type { PrimitiveToBrepResult, PrimitiveParams } from './primitives/brep-primitives'\n// B 组（svg 挤出 / 3D 文字几何链）已随 @faicad/faijs-extra 迁出；\n// 留 core 的是零 three 的 CJK 字符判定与系统字体装载。\nexport { loadSystemCjkFont, containsCjk, isCjkChar } from './primitives/text/cjk-font'\nexport type { CjkFontResult } from './primitives/text/cjk-font'\nexport type {\n  PrimitiveType, PrimitiveParamsRecord, PrimitiveArgsRecord, PrimitiveMeta,\n} from './primitives/types'\nexport { nextPrimitiveColor } from './primitives/types'\n\n// ── L1 SDF ──\nexport { runSdf } from './sdf/sdf-runner'\nexport type { SdfMeshData } from './sdf/sdf-runner'\nexport { runSdfInline } from './sdf/sdf-core'\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// ── L1 Knurl ──\nexport { applyKnurlDisplacement, KNURL_DEFAULTS } from './mesh/knurl/KnurlGenerator'\nexport type { KnurlBounds } from './mesh/knurl/KnurlGenerator'\nexport { subdivide } from './mesh/knurl/subdivision'\nexport { loadKnurlingTexture, setKnurlTextureLoader } from './mesh/knurl/textureLoader'\nexport type { TextureData } 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// ── L1 Topology ──\nexport { TOPOLOGY_FACE_ID_NONE, buildFaceIdsForPart } from './topology/build-face-ids'\nexport {\n  buildSelectorRuntime, buildSelectorRuntimeData, buildSelectorRuntimeMaps,\n} from './topology/build-selector-runtime'\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\nexport * from './topology/naming'\n\n// ── L2 编排�?──\n// D1（2026-09-19）：createRuntime 自注册 cad 默认命名空间（引擎 + 标准库定位）。\n// 需要纯引擎（不带 cad）的宿主可直接 import { createRuntime } from './cad-runtime/runtime'。\nexport { CadRuntime, createRuntime, computeContentKey, 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, CadRuntimeOptions } from './cad-runtime/runtime'\nexport type {\n  HostPorts, CsgBackend, SdfBackend, FontProvider, TextureSampler,\n  AssetResolver, EventSink, ExecutionMode,\n  MeshData, PlaneParams, SplitResult as CsgSplitResult,\n  DovetailGrooveParams as PortDovetailGrooveParams,\n  DowelSplitParams as PortDowelSplitParams,\n  StraightTenonSplitParams as PortStraightTenonSplitParams,\n  LibLoader, ProjectLoader,\n} from './cad-runtime/ports'\n\n// ── OCCT Kernel ──\nexport {\n  initOcctWasm, getKernel, disposeOcctWasm, setOcctWasmInitFn,\n  computeEffectiveDeflection, importStepToMesh, importBrepToMesh,\n  meshesToStep, releaseShape,\n  importAssemblyFromStep, releaseAssemblyTree, collectLeafParts,\n} from './occt-kernel/occtKernel'\nexport type {\n  WasmTessellatedMesh, WasmImportResult, AssemblyPartNode,\n  MeshDeflectionOptions, ShapeHandle, OcctKernel,\n  Mesh, EdgeData, SurfaceKind, CurveKind,\n} from './occt-kernel/occtKernel'\n\n// ── OCCT Mesh Reconstruct ──\nexport { reconstructSolidFromMesh, meshToAsciiStl, cadShapeIsValid, meshToStepBrep } from './occt-kernel/meshReconstruct'\n\n// ── OCCT 高层导出（多实体、零 fuse） ──\nexport { exportStepFromSolidsHighLevel } from './occt-kernel/highLevelApi'\n\n// ── OCCT Topology Extension ──\nexport { buildSelectorManifest, buildAssemblySelectorManifest, buildTopologyAdjacency } from './occt-kernel/topologyExt'\nexport type { SelectorManifestInput, PartTopologyInput, AssemblyTopologyResult, TopologyAdjacency } from './occt-kernel/topologyExt'\n\n// ── BREP 引擎注册（宿主装配；引擎可切换——occt 只是默认实现） ──\nexport { registerOcctBrepEngine, OCCT_BREP_ENGINE_ID } from './brep/engine/adapters/occt'\nexport { registerBrepMockEngine, BREP_MOCK_ENGINE_ID, createBrepMockApi } from './brep/engine/adapters/brep-mock'\n// brepkit 端侧 BREP 引擎（微信小程序等无 OCCT 环境）：由宿主注入 wasm init 并抢先注册，\n// 使 ensureBrepChain 不回退 OCCT。setBrepkitWasmInitFn 注入自定义初始化（如 WXWebAssembly 实例化）。\nexport { registerBrepkitBrepEngine, BREPKIT_BREP_ENGINE_ID, ensureBrepkitDefaultEngine } from './brep/engine/adapters/brepkit'\nexport { setBrepkitWasmInitFn, initBrepkitWasm, isBrepkitInitialized } from './brepkit-kernel/brepkitWasm'\nexport {\n  registerBrepEngine, getBrepEngine, hasBrepEngine, getActiveBrepEngineId,\n  registerMeshEngine, getMeshEngine, getActiveMeshEngineId, freezeEngineRegistries,\n} from './brep/engine/registry'\nexport type { BrepEngine, BrepEngineProvider, MeshEngine } 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'\n\n// ── BREP Topology ──\nexport { buildSolidTopologyRuntime } from './brep/brep-topology'\nexport type { SolidTopologyResult } from './brep/brep-topology'\n\n// ── Font Registry (for browser host injection) ──\nexport { setFontLoader, getFontLoader, loadFont, ensureDefaultFont, getFont, clearFonts } from './brep/text/fontRegistry'\nexport type { FontLoader } from './brep/text/fontRegistry'\n\n// ── L3 Node Host ──\n// node-host 模块已移�?@faicad/faijs/node 入口，避免浏览器环境静�?import\n// node-host 模块（含 Node.js 专用代码�?fs/path）导致生产构�?404�?\n// �?Node.js 环境中：import { createNodePorts } from '@faicad/faijs/node'\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'\n\n// ── L3 API 面（原 packages/stdlib 迁入，P6/D1）──\n// P23 主导出切换（§4.2 / Q1）：`export * from './api'` 现在同时带来\n// ① faijs 特有 dual op（mesh+brep 双路径，D11 双形态归一）；\n// ② 生成脚本面 op（`api/generated/script-face.ts`，compatOp(projectBrepOp(…)) 包装的\n//    brep-only 语句级 op——`cad.*` 脚本面与此同源，B1 三源一致）；\n// ③ 2026-09-25 core-decouple：brepjsCompat 命名空间与 op 投影随 vendored 树删除\n//    （裁决 9）；`api/brepjs-compat` 仅保留 core 内联的 Result / 向量 / 平面 / 错误 /\n//    常量组合器（§5.2），顶层平铺不变。\nexport * from './api'\nexport { createApiNamespace } from './api/api-namespace'\n// Vec3 双源消歧：env-agnostic（lang/types）与 api（mesh/types）均有 Vec3，\n// 显式 re-export 定为 lang 版（与收敛前 index.ts 的具名导出一致）。\nexport type { Vec3 } from './lang/types'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @faicad/faijs �?Faicad CAD execution engine\n *\n * 公开 API 统一入口。所有导出按层组织：\n * - L0 文本层：parser / codegen / symbol-table / types\n * - L1 几何执行层：BREP ops / Shape / 导出\n * - L1 Mesh 执行层：cad API\n * - L1 Boolean/CSG 辅助：cross-section / deriveNormals / extrude-helpers / joinery-shapes\n * - L1 Primitives：geometry / screw / svg-extrude / text / types\n * - L1 SDF：sdf-runner / templates / types\n * - L1 Knurl：KnurlGenerator / subdivision / textureLoader\n * - L1 Topology：build-face-ids / build-selector-runtime / types\n * - L2 编排层：CadRuntime / HostPorts\n * - L3 Node Host：createNodePorts / CLI\n * - OCCT Kernel：initOcctWasm / getKernel / setOcctWasmInitFn / ...\n * - CSG Backend：setCsgBackend / geoToManifoldMesh / ...\n */\n\n// ── 共享面（env-agnostic：identity + runtime-state + lang/*）──\n// 手写清单已收敛：三处 umbrella（index/browser/weapp）统一 re-export，防漂移。\nexport * from './env-agnostic'\n\n// ── L1 几何执行 ──\nexport type { Shape } from './mesh/types'\nexport type { BrepChainState } from './brep/brep-chain'\nexport {\n  createBrepChainState, initBrepChainState, releaseBrepChainState,\n  isCadFormat,\n} from './brep/brep-chain'\nexport {\n  solidToShape, getSolidBoundingBox,\n  translateBrep, rotateBrep, scaleBrep,\n  fuseBrep, cutBrep, commonBrep,\n  drillBrep, splitBrep, extrudeBrep,\n  loadBrep, matrixToArray,\n} from './brep'\nexport type { DrillBrepParams, SplitBrepParams, SplitBrepResult, ExtrudeBrepParams } from './brep'\nexport { buildStlBufferFromMesh } from './brep/export/stl'\nexport { exportStepFromSolid, exportStepFromSolids } from './brep/export/step'\nexport type { StepExportEntry } from './brep/export/step'\n\n// ── L1 Mesh ──\nexport { cad } from './mesh'\n// 宿主注入的 mesh 装饰几何（cad.engrave 的文字/SVG 几何链在 @faicad/faijs-extra）\nexport { setEngraveDecorationProvider, getEngraveDecorationProvider } from './mesh/decoration-provider'\nexport type { EngraveDecorationProvider, EngraveDecorationParams } from './mesh/decoration-provider'\nexport { setManifoldWasmUrl, getManifoldWasmUrl, getManifoldModule } from './mesh/manifold-loader'\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'\nexport { faceAt } from './mesh/query'\n\n// ── L1 Boolean/CSG 辅助 ──\nexport { computeSection, buildExtrudedProfile } from './boolean/cross-section'\nexport { manifoldToMeshData, weldPositionsWorker, dovetailBooleanSplit, dowelOrTenonBooleanSplit } from './boolean/csg-core'\nexport { deriveNormals } from './boolean/deriveNormals'\nexport { buildExtrudeParts, makeWorldPlane } from './boolean/extrude-helpers'\nexport type { ExtrudeParts, ExtrudeOffsetMode } from './boolean/extrude-helpers'\nexport {\n  buildWedgeGeometry, buildDowelGeometry, buildStraightTenonGeometry,\n} from './boolean/joinery-shapes'\nexport type { JoineryMeshData } from './boolean/joinery-shapes'\n\n// ── CSG Backend ──\nexport { setCsgBackend } from './boolean/csg-backend'\nexport { geoToManifoldMesh, manifoldMeshToGeo } from './boolean/geo-convert'\nexport type {\n  ManifoldMeshData, BooleanOperation,\n  DovetailGrooveParams, DowelSplitParams, StraightTenonSplitParams,\n} from './boolean/geo-convert'\n\n// ── L1 Primitives ──\nexport { mergeBufferGeometries, makePrimitiveGeo, DEFAULT_SIZE, applyPrimitiveOffset } from './primitives/mesh-primitives'\nexport { makeScrew } from './primitives/screw/screw'\nexport { getScrewSpec, getScrewSpecs, threadToPitchMm, SCREW_HEAD_DIMS } from './primitives/screw/screw-db'\nexport type { ScrewParams, ScrewSpec, ScrewSystem } from './primitives/screw/screw-db'\nexport { parseSvgNaturalSize } from './primitives/parse-svg-size'\nexport {\n  extractMeshData, primitiveToBrepSolid, geometryToBrepSolid,\n  brepSolidToStep, primitiveToBrepStep,\n} from './primitives/brep-primitives'\nexport type { PrimitiveToBrepResult, PrimitiveParams } from './primitives/brep-primitives'\n// B 组（svg 挤出 / 3D 文字几何链）已随 @faicad/faijs-extra 迁出；\n// 留 core 的是零 three 的 CJK 字符判定与系统字体装载。\nexport { loadSystemCjkFont, containsCjk, isCjkChar } from './primitives/text/cjk-font'\nexport type { CjkFontResult } from './primitives/text/cjk-font'\nexport type {\n  PrimitiveType, PrimitiveParamsRecord, PrimitiveArgsRecord, PrimitiveMeta,\n} from './primitives/types'\nexport { nextPrimitiveColor } from './primitives/types'\n\n// ── L1 SDF ──\nexport { runSdf } from './sdf/sdf-runner'\nexport type { SdfMeshData } from './sdf/sdf-runner'\nexport { runSdfInline } from './sdf/sdf-core'\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// ── L1 Knurl ──\nexport { applyKnurlDisplacement, KNURL_DEFAULTS } from './mesh/knurl/KnurlGenerator'\nexport type { KnurlBounds } from './mesh/knurl/KnurlGenerator'\nexport { subdivide } from './mesh/knurl/subdivision'\nexport { loadKnurlingTexture, setKnurlTextureLoader } from './mesh/knurl/textureLoader'\nexport type { TextureData } 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// ── L1 Topology ──\nexport { TOPOLOGY_FACE_ID_NONE, buildFaceIdsForPart } from './topology/build-face-ids'\nexport {\n  buildSelectorRuntime, buildSelectorRuntimeData, buildSelectorRuntimeMaps,\n} from './topology/build-selector-runtime'\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\nexport * from './topology/naming'\n\n// ── L2 编排�?──\n// D1（2026-09-19）：createRuntime 自注册 cad 默认命名空间（引擎 + 标准库定位）。\n// 需要纯引擎（不带 cad）的宿主可直接 import { createRuntime } from './cad-runtime/runtime'。\nexport { CadRuntime, createRuntime, computeContentKey, 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, CadRuntimeOptions } from './cad-runtime/runtime'\nexport type {\n  HostPorts, CsgBackend, SdfBackend, FontProvider, TextureSampler,\n  AssetResolver, EventSink, ExecutionMode,\n  MeshData, PlaneParams, SplitResult as CsgSplitResult,\n  DovetailGrooveParams as PortDovetailGrooveParams,\n  DowelSplitParams as PortDowelSplitParams,\n  StraightTenonSplitParams as PortStraightTenonSplitParams,\n  LibLoader, ProjectLoader,\n} from './cad-runtime/ports'\n\n// ── OCCT Kernel ──\nexport {\n  initOcctWasm, getKernel, disposeOcctWasm, setOcctWasmInitFn,\n  computeEffectiveDeflection, importStepToMesh, importBrepToMesh,\n  meshesToStep, releaseShape,\n  importAssemblyFromStep, releaseAssemblyTree, collectLeafParts,\n} from './occt-kernel/occtKernel'\nexport type {\n  WasmTessellatedMesh, WasmImportResult, AssemblyPartNode,\n  MeshDeflectionOptions, ShapeHandle, OcctKernel,\n  Mesh, EdgeData, SurfaceKind, CurveKind,\n} from './occt-kernel/occtKernel'\n\n// ── OCCT Mesh Reconstruct ──\nexport { reconstructSolidFromMesh, meshToAsciiStl, cadShapeIsValid, meshToStepBrep } from './occt-kernel/meshReconstruct'\n\n// ── OCCT 高层导出（多实体、零 fuse） ──\nexport { exportStepFromSolidsHighLevel } from './occt-kernel/highLevelApi'\n\n// ── OCCT Topology Extension ──\nexport { buildSelectorManifest, buildAssemblySelectorManifest, buildTopologyAdjacency } from './occt-kernel/topologyExt'\nexport type { SelectorManifestInput, PartTopologyInput, AssemblyTopologyResult, TopologyAdjacency } from './occt-kernel/topologyExt'\n\n// ── BREP 引擎注册（宿主装配；引擎可切换——occt 只是默认实现） ──\nexport { registerOcctBrepEngine, OCCT_BREP_ENGINE_ID } from './brep/engine/adapters/occt'\nexport { registerBrepMockEngine, BREP_MOCK_ENGINE_ID, createBrepMockApi } from './brep/engine/adapters/brep-mock'\n// brepkit 端侧 BREP 引擎（微信小程序等无 OCCT 环境）：由宿主注入 wasm init 并抢先注册，\n// 使 ensureBrepChain 不回退 OCCT。setBrepkitWasmInitFn 注入自定义初始化（如 WXWebAssembly 实例化）。\nexport { registerBrepkitBrepEngine, BREPKIT_BREP_ENGINE_ID, ensureBrepkitDefaultEngine } from './brep/engine/adapters/brepkit'\n// brepkit 网格实体后端（网格语义路径；与 BREP 槽独立注册）。装了它，`cad.load`\n// 的 STL/3MF 路径才产出「网格实体 + 近似拓扑」；不装则维持裸网格的历史行为。\nexport { registerBrepkitMeshEngine, BREPKIT_MESH_ENGINE_ID, ensureBrepkitMeshBackend } from './brep/engine/adapters/brepkit'\nexport { setBrepkitWasmInitFn, initBrepkitWasm, isBrepkitInitialized } from './brepkit-kernel/brepkitWasm'\nexport {\n  registerBrepEngine, getBrepEngine, hasBrepEngine, getActiveBrepEngineId,\n  registerMeshEngine, getMeshEngine, getActiveMeshEngineId, freezeEngineRegistries,\n  isMeshEngineRegistered, getMeshSolidBackend,\n} from './brep/engine/registry'\nexport type { BrepEngine, BrepEngineProvider, MeshEngine } from './brep/engine/registry'\n// 网格实体（近似拓扑的载体）：端口 + 注册表 + 驱动。\nexport { MeshSolidRegistry, normalizeMeshSolid, describeMeshSolid, buildMeshSolidTopology, weldToleranceFor } from './brep/mesh-solid'\nexport type {\n  MeshSolidBackend, MeshSolidResult, MeshSolidKernelOps, MeshSolidInput, MeshSolidNormalizeOptions,\n} from './brep/mesh-solid'\n// 槽位互斥不变量（分派前置校验；缺陷即报错）\nexport { assertShapeSlotExclusive } from './cad-runtime/backend-dispatch'\nexport type { BrepEngineApi } from './brep/engine/primitives'\nexport type {\n  BrepHandle, BrepMeshResult, BrepBoundingBox, BrepVec3, BrepCapabilities,\n  BrepEvolutionData, BrepXcafDocument,\n} from './brep/engine/types'\n\n// ── BREP Topology ──\nexport { buildSolidTopologyRuntime } from './brep/brep-topology'\nexport type { SolidTopologyResult } from './brep/brep-topology'\n\n// ── Font Registry (for browser host injection) ──\nexport { setFontLoader, getFontLoader, loadFont, ensureDefaultFont, ensureFont, getFont, clearFonts } from './brep/text/fontRegistry'\nexport type { FontLoader } from './brep/text/fontRegistry'\n\n// ── L3 Node Host ──\n// node-host 模块已移�?@faicad/faijs/node 入口，避免浏览器环境静�?import\n// node-host 模块（含 Node.js 专用代码�?fs/path）导致生产构�?404�?\n// �?Node.js 环境中：import { createNodePorts } from '@faicad/faijs/node'\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'\n\n// ── L3 API 面（api/ 层）──\n// P23 主导出切换（§4.2 / Q1）：`export * from './api'` 现在同时带来\n// ① faijs 特有 dual op（mesh+brep 双路径，D11 双形态归一）；\n// ② 生成脚本面 op（`api/generated/script-face.ts`，compatOp(projectBrepOp(…)) 包装的\n//    brep-only 语句级 op——`cad.*` 脚本面与此同源，B1 三源一致）；\n// ③ 2026-09-25 core-decouple：brepjsCompat 命名空间与 op 投影随 vendored 树删除\n//    （裁决 9）；`api/brepjs-compat` 仅保留 core 内联的 Result / 向量 / 平面 / 错误 /\n//    常量组合器（§5.2），顶层平铺不变。\nexport * from './api'\nexport { createApiNamespace } from './api/api-namespace'\n// Vec3 双源消歧：env-agnostic（lang/types）与 api（mesh/types）均有 Vec3，\n// 显式 re-export 定为 lang 版（与收敛前 index.ts 的具名导出一致）。\nexport type { Vec3 } from './lang/types'\n"]}

package/dist/io/bytes-node.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Read a file into a standalone ArrayBuffer sized exactly to the file.
+ *
+ * Equivalent to `toArrayBuffer(readFileSync(path))`; provided so filesystem
+ * callers do not have to remember why the `.buffer` shorthand is unsafe.
+ *
+ * @param path - filesystem path to read, as a string or a `file:` URL.
+ * @returns a new ArrayBuffer owned solely by the caller.
+ */
+export declare function readFileArrayBuffer(path: string | URL): ArrayBuffer;
+//# sourceMappingURL=bytes-node.d.ts.map

package/dist/io/bytes-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes-node.d.ts","sourceRoot":"","sources":["../../src/io/bytes-node.ts"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,WAAW,CAEnE"}

package/dist/io/bytes-node.js

@@ -0,0 +1,28 @@
+/**
+ * Node-only file reader companion to `io/bytes.ts`.
+ *
+ * `Buffer.prototype.buffer` is the Buffer's *backing store*, not the file
+ * bytes: on Node 24 pooled buffers come from a shared store larger than the
+ * file and at a non-zero byteOffset. Handing that store to a kernel that
+ * decodes the whole ArrayBuffer also feeds it pool residue — seen as
+ * "Line 2: unexpected QUID, expecting STEP" in occt-wasm importStep.
+ *
+ * Node-only by design (top-level node: imports): exported from
+ * `@faicad/faijs/node`, never from `io/index.ts` / the browser entries.
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { toArrayBuffer } from './bytes.js';
+/**
+ * Read a file into a standalone ArrayBuffer sized exactly to the file.
+ *
+ * Equivalent to `toArrayBuffer(readFileSync(path))`; provided so filesystem
+ * callers do not have to remember why the `.buffer` shorthand is unsafe.
+ *
+ * @param path - filesystem path to read, as a string or a `file:` URL.
+ * @returns a new ArrayBuffer owned solely by the caller.
+ */
+export function readFileArrayBuffer(path) {
+    return toArrayBuffer(readFileSync(fileURLToPath(path)));
+}
+//# sourceMappingURL=bytes-node.js.map

package/dist/io/bytes-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes-node.js","sourceRoot":"","sources":["../../src/io/bytes-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvC;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,OAAO,aAAa,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACzD,CAAC","sourcesContent":["/**\n * Node-only file reader companion to `io/bytes.ts`.\n *\n * `Buffer.prototype.buffer` is the Buffer's *backing store*, not the file\n * bytes: on Node 24 pooled buffers come from a shared store larger than the\n * file and at a non-zero byteOffset. Handing that store to a kernel that\n * decodes the whole ArrayBuffer also feeds it pool residue — seen as\n * \"Line 2: unexpected QUID, expecting STEP\" in occt-wasm importStep.\n *\n * Node-only by design (top-level node: imports): exported from\n * `@faicad/faijs/node`, never from `io/index.ts` / the browser entries.\n */\nimport { readFileSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { toArrayBuffer } from './bytes'\n\n/**\n * Read a file into a standalone ArrayBuffer sized exactly to the file.\n *\n * Equivalent to `toArrayBuffer(readFileSync(path))`; provided so filesystem\n * callers do not have to remember why the `.buffer` shorthand is unsafe.\n *\n * @param path - filesystem path to read, as a string or a `file:` URL.\n * @returns a new ArrayBuffer owned solely by the caller.\n */\nexport function readFileArrayBuffer(path: string | URL): ArrayBuffer {\n  return toArrayBuffer(readFileSync(fileURLToPath(path)))\n}\n"]}

package/dist/io/bytes.d.ts

@@ -0,0 +1,33 @@
+/**
+ * io/bytes — normalise a BufferSource into an exactly-owned ArrayBuffer.
+ *
+ * faijs hands geometry kernels plain `ArrayBuffer`s (see the `assets.resolveFile`
+ * contract in `cad-runtime/ports`). That contract has no notion of a view
+ * offset, so a *pooled* or *offset* backing store must never cross it: a
+ * consumer that decodes the whole ArrayBuffer would also read whatever else
+ * shares that store.
+ *
+ * This is the single place that conversion is spelled out, because the failure
+ * it prevents is invisible: the kernel does not report a short read, it reports
+ * a corrupt-parse error far away from the call that caused it.
+ *
+ * Contract:
+ * - Always returns a fresh ArrayBuffer whose `byteLength` equals the source's
+ *   `byteLength`; never aliases the input.
+ * - Accepts any BufferSource (ArrayBuffer or any ArrayBufferView), so a caller
+ *   holding a `Buffer`/subarray does not have to slice it by hand.
+ * - Zero-copy is deliberately not attempted: the sources are whole-file reads,
+ *   where one copy is cheaper than reasoning about who else owns the store.
+ *
+ * Browser-safe: this module must stay free of node: imports — it is
+ * re-exported from `io/index.ts`, which is imported by browser bundles. The
+ * Node-only file reader lives in `io/bytes-node.ts` (`@faicad/faijs/node`).
+ */
+/**
+ * Copy a BufferSource into a standalone ArrayBuffer sized exactly to its bytes.
+ *
+ * @param source - the bytes to normalise (ArrayBuffer or any ArrayBufferView).
+ * @returns a new ArrayBuffer owned solely by the caller.
+ */
+export declare function toArrayBuffer(source: BufferSource): ArrayBuffer;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/io/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/io/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAY/D"}

package/dist/io/bytes.js

@@ -0,0 +1,41 @@
+/**
+ * io/bytes — normalise a BufferSource into an exactly-owned ArrayBuffer.
+ *
+ * faijs hands geometry kernels plain `ArrayBuffer`s (see the `assets.resolveFile`
+ * contract in `cad-runtime/ports`). That contract has no notion of a view
+ * offset, so a *pooled* or *offset* backing store must never cross it: a
+ * consumer that decodes the whole ArrayBuffer would also read whatever else
+ * shares that store.
+ *
+ * This is the single place that conversion is spelled out, because the failure
+ * it prevents is invisible: the kernel does not report a short read, it reports
+ * a corrupt-parse error far away from the call that caused it.
+ *
+ * Contract:
+ * - Always returns a fresh ArrayBuffer whose `byteLength` equals the source's
+ *   `byteLength`; never aliases the input.
+ * - Accepts any BufferSource (ArrayBuffer or any ArrayBufferView), so a caller
+ *   holding a `Buffer`/subarray does not have to slice it by hand.
+ * - Zero-copy is deliberately not attempted: the sources are whole-file reads,
+ *   where one copy is cheaper than reasoning about who else owns the store.
+ *
+ * Browser-safe: this module must stay free of node: imports — it is
+ * re-exported from `io/index.ts`, which is imported by browser bundles. The
+ * Node-only file reader lives in `io/bytes-node.ts` (`@faicad/faijs/node`).
+ */
+/**
+ * Copy a BufferSource into a standalone ArrayBuffer sized exactly to its bytes.
+ *
+ * @param source - the bytes to normalise (ArrayBuffer or any ArrayBufferView).
+ * @returns a new ArrayBuffer owned solely by the caller.
+ */
+export function toArrayBuffer(source) {
+    if (source instanceof ArrayBuffer) {
+        // Already standalone in size, but callers may still hold another view onto
+        // it; copy so the result can never be mutated through another reference.
+        return source.slice(0);
+    }
+    const view = new Uint8Array(source.buffer, source.byteOffset, source.byteLength);
+    return view.slice().buffer;
+}
+//# sourceMappingURL=bytes.js.map

package/dist/io/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../src/io/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;QAClC,2EAA2E;QAC3E,yEAAyE;QACzE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,CACxB,MAA0B,CAAC,MAAqB,EAChD,MAA0B,CAAC,UAAU,EACrC,MAA0B,CAAC,UAAU,CACvC,CAAA;IACD,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,MAAqB,CAAA;AAC3C,CAAC","sourcesContent":["/**\n * io/bytes — normalise a BufferSource into an exactly-owned ArrayBuffer.\n *\n * faijs hands geometry kernels plain `ArrayBuffer`s (see the `assets.resolveFile`\n * contract in `cad-runtime/ports`). That contract has no notion of a view\n * offset, so a *pooled* or *offset* backing store must never cross it: a\n * consumer that decodes the whole ArrayBuffer would also read whatever else\n * shares that store.\n *\n * This is the single place that conversion is spelled out, because the failure\n * it prevents is invisible: the kernel does not report a short read, it reports\n * a corrupt-parse error far away from the call that caused it.\n *\n * Contract:\n * - Always returns a fresh ArrayBuffer whose `byteLength` equals the source's\n *   `byteLength`; never aliases the input.\n * - Accepts any BufferSource (ArrayBuffer or any ArrayBufferView), so a caller\n *   holding a `Buffer`/subarray does not have to slice it by hand.\n * - Zero-copy is deliberately not attempted: the sources are whole-file reads,\n *   where one copy is cheaper than reasoning about who else owns the store.\n *\n * Browser-safe: this module must stay free of node: imports — it is\n * re-exported from `io/index.ts`, which is imported by browser bundles. The\n * Node-only file reader lives in `io/bytes-node.ts` (`@faicad/faijs/node`).\n */\n\n/**\n * Copy a BufferSource into a standalone ArrayBuffer sized exactly to its bytes.\n *\n * @param source - the bytes to normalise (ArrayBuffer or any ArrayBufferView).\n * @returns a new ArrayBuffer owned solely by the caller.\n */\nexport function toArrayBuffer(source: BufferSource): ArrayBuffer {\n  if (source instanceof ArrayBuffer) {\n    // Already standalone in size, but callers may still hold another view onto\n    // it; copy so the result can never be mutated through another reference.\n    return source.slice(0)\n  }\n  const view = new Uint8Array(\n    (source as ArrayBufferView).buffer as ArrayBuffer,\n    (source as ArrayBufferView).byteOffset,\n    (source as ArrayBufferView).byteLength,\n  )\n  return view.slice().buffer as ArrayBuffer\n}\n"]}

package/dist/io/fai-zip/container-read.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Unified `.fai.zip` read API (docs/fai-zip-format.md §4–§9).
+ *
+ * Environment-independent by constraint: reading goes through `io/zip.ts`
+ * (`readZipEntries`) plus JSON parsing — no `node:*`, no DOM, no fs, and no
+ * direct ZIP library. Web workers, the weapp worker and node share this code.
+ *
+ * Contract highlights (spec §9 Reader obligations):
+ * - a missing/malformed manifest, `format !== 3`, a malformed `models` array,
+ *   a missing entry, a missing named data member and a duplicate asset key are
+ *   all errors carrying the offending value;
+ * - entry selection is `active` or `models[0]` — never a file-name heuristic;
+ * - members outside the table (§3), unknown manifest fields and unknown
+ *   data-member keys are ignored, never errors, never decision inputs.
+ */
+import { type ZipReadOptions } from '../zip.js';
+import type { ProjectLoader } from '../../cad-runtime/ports.js';
+import { type ContainerAssetEntries, type ContainerManifest, type ContainerModel } from './container.js';
+/** openContainer options. */
+export interface OpenContainerOptions {
+    /** override `manifest.active`; default = `manifest.active`, else `models[0]` */
+    modelId?: string;
+    /** override the `io/zip.ts` read caps (maxEntries / maxTotalBytes) */
+    caps?: ZipReadOptions;
+}
+/** openContainer result: manifest, active model, loader and payloads. */
+export interface OpenContainerResult {
+    manifest: ContainerManifest;
+    activeModel: ContainerModel;
+    /** project loader over the container's module graph (listModules/readSource) */
+    loader: ProjectLoader;
+    files: Record<string, Uint8Array>;
+    assets: Record<string, Uint8Array>;
+}
+/**
+ * Read and validate the container manifest (spec §4).
+ * @param bytes the .fai.zip archive bytes
+ * @returns the validated manifest
+ * @throws when the archive is not a ZIP, the manifest is missing/malformed,
+ *   `format !== 3`, `units !== "mm"`, `models` is empty/malformed, ids/entries
+ *   are duplicated, an entry is not under `model/` or does not exist, `active`
+ *   is not in `models[].id`, or a named `data` member does not exist.
+ */
+export declare function readManifest(bytes: Uint8Array): ContainerManifest;
+/**
+ * List the container models (validated). Same validation as readManifest.
+ * @param bytes the .fai.zip archive bytes
+ * @returns the validated model list
+ */
+export declare function listModels(bytes: Uint8Array): ContainerModel[];
+/**
+ * List every module under `model/` (keys relative to `model/`, sorted).
+ * Members outside the table are ignored (§3), never an error.
+ * @param bytes the .fai.zip archive bytes
+ * @returns module keys relative to `model/`, sorted
+ */
+export declare function listModules(bytes: Uint8Array): string[];
+/**
+ * Read one module's source text by module key (relative to `model/`).
+ * @param bytes the .fai.zip archive bytes
+ * @param key the module key relative to `model/` (e.g. `main.fai.js`)
+ * @returns the module source text
+ * @throws for a key outside `model/` or that does not exist
+ */
+export declare function readModule(bytes: Uint8Array, key: string): string;
+/**
+ * Read one model data member's JSON text by member path (e.g. `data/main.json`).
+ *
+ * The path must be exactly what `models[].data` declares (spec §4): a safe,
+ * relative member under `data/` ending with `.json`. Content is validated to
+ * parse as JSON — the editor keeps data members pure JSON (§6.1), so a
+ * non-JSON member is a format violation and an error, never a silent skip.
+ *
+ * @param bytes the .fai.zip archive bytes
+ * @param memberPath the member path named by `models[].data`
+ * @returns the raw JSON text
+ * @throws for a non-string/unsafe path, a path outside `data/`, a missing
+ *   member, or content that does not parse as JSON
+ */
+export declare function readDataMember(bytes: Uint8Array, memberPath: string): string;
+/**
+ * Collect the payload bytes of a container.
+ * Keys are unique across `files/**` and `assets/**` together (spec §7.1);
+ * a duplicate key is an error rather than a pick.
+ * @param bytes the .fai.zip archive bytes
+ * @returns the payload entries keyed by asset key
+ */
+export declare function readAssetEntries(bytes: Uint8Array): ContainerAssetEntries;
+/**
+ * Host entry point: open a container and return the manifest, the active
+ * model and a ProjectLoader over its module graph, plus the payloads.
+ *
+ * The archive is unpacked exactly once for the whole call.
+ *
+ * @param bytes the .fai.zip archive bytes
+ * @param opts optional active-model override and `io/zip.ts` read caps
+ * @returns manifest, active model, project loader and payload entries
+ * @throws when the container is invalid, the requested model id is unknown, or
+ *   the read caps are exceeded
+ */
+export declare function openContainer(bytes: Uint8Array, opts?: OpenContainerOptions): OpenContainerResult;
+//# sourceMappingURL=container-read.d.ts.map

package/dist/io/fai-zip/container-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-read.d.ts","sourceRoot":"","sources":["../../../src/io/fai-zip/container-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAML,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AAEpB,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,cAAc,CAAA;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,WAAW,EAAE,cAAc,CAAA;IAC3B,gFAAgF;IAChF,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACnC;AAsJD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,EAAE,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAEvD;AAaD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAajE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgB5E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CAEzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,oBAAyB,GAAG,mBAAmB,CA+BrG"}

package/dist/io/fai-zip/container-read.js

@@ -0,0 +1,305 @@
+/**
+ * Unified `.fai.zip` read API (docs/fai-zip-format.md §4–§9).
+ *
+ * Environment-independent by constraint: reading goes through `io/zip.ts`
+ * (`readZipEntries`) plus JSON parsing — no `node:*`, no DOM, no fs, and no
+ * direct ZIP library. Web workers, the weapp worker and node share this code.
+ *
+ * Contract highlights (spec §9 Reader obligations):
+ * - a missing/malformed manifest, `format !== 3`, a malformed `models` array,
+ *   a missing entry, a missing named data member and a duplicate asset key are
+ *   all errors carrying the offending value;
+ * - entry selection is `active` or `models[0]` — never a file-name heuristic;
+ * - members outside the table (§3), unknown manifest fields and unknown
+ *   data-member keys are ignored, never errors, never decision inputs.
+ */
+import { readZipEntries } from '../zip.js';
+import { assetKeyOf, assertDataMemberPath, assertModelMemberPath, assertSafeMemberPath, decodeMemberText, } from './container.js';
+/** Path prefix of every model script member. */
+const MODEL_PREFIX = 'model/';
+/** Path prefix of the imported-file payloads. */
+const FILES_PREFIX = 'files/';
+/** Path prefix of the script-consumed payloads. */
+const ASSETS_PREFIX = 'assets/';
+/**
+ * Unpack the archive; a non-ZIP input is a hard error carrying the original
+ * failure as `cause`. Caps violations keep `io/zip.ts`'s wording.
+ */
+function unzipMembers(bytes, caps) {
+    try {
+        return readZipEntries(bytes, caps);
+    }
+    catch (e) {
+        const inner = (e instanceof Error ? e.message : String(e)).replace(/^zip read failed: /, '');
+        const err = new Error(`[fai-zip] cannot open container as ZIP: ${inner}`);
+        err.cause = e;
+        throw err;
+    }
+}
+/** Normalize a manifest field error into one message naming the offending value. */
+function manifestError(reason, value) {
+    const shown = value === undefined ? '' : ` (observed: ${JSON.stringify(value)})`;
+    return new Error(`[fai-zip] invalid manifest: ${reason}${shown}`);
+}
+/**
+ * Read and validate the container manifest from already-unpacked members.
+ * @param members the unpacked container members
+ * @returns the validated manifest
+ */
+function readManifestFrom(members) {
+    const raw = members.get('manifest.json');
+    if (raw === undefined)
+        throw new Error('[fai-zip] invalid manifest: missing manifest.json — not a .fai.zip container');
+    let parsed;
+    try {
+        parsed = JSON.parse(decodeMemberText(raw));
+    }
+    catch (e) {
+        throw new Error(`[fai-zip] invalid manifest: manifest.json is not valid JSON: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw manifestError('manifest.json must be a JSON object');
+    }
+    const manifest = parsed;
+    if (manifest.format !== 3) {
+        throw manifestError('format must be the integer 3 (this revision); no other value is interpretable', manifest.format);
+    }
+    if (manifest.units !== 'mm') {
+        throw manifestError('units must be "mm"', manifest.units);
+    }
+    if (!Array.isArray(manifest.models) || manifest.models.length === 0) {
+        throw manifestError('models must be a non-empty array', manifest.models);
+    }
+    const models = manifest.models;
+    const seenIds = new Set();
+    const seenEntries = new Set();
+    const normalized = [];
+    for (let i = 0; i < models.length; i++) {
+        const m = models[i];
+        if (typeof m !== 'object' || m === null || Array.isArray(m)) {
+            throw manifestError(`models[${i}] must be an object`, m);
+        }
+        const rec = m;
+        const id = typeof rec.id === 'string' ? rec.id : '';
+        if (id === '')
+            throw manifestError(`models[${i}].id must be a non-empty string`, rec.id);
+        if (id.includes('/') || id.includes('\\'))
+            throw manifestError(`models[${i}].id must not contain "/" or "\\"`, id);
+        if (seenIds.has(id))
+            throw manifestError('models[].id must be unique', id);
+        seenIds.add(id);
+        const entry = typeof rec.entry === 'string' ? rec.entry : '';
+        if (entry === '')
+            throw manifestError(`models[${i}].entry must be a non-empty string`, rec.entry);
+        assertModelMemberPath(entry, `models[${i}].entry`);
+        if (seenEntries.has(entry))
+            throw manifestError('models[].entry must be unique', entry);
+        seenEntries.add(entry);
+        if (!members.has(entry)) {
+            throw manifestError(`models[${i}].entry does not exist in the container`, entry);
+        }
+        const data = typeof rec.data === 'string' ? rec.data : undefined;
+        if (data !== undefined) {
+            assertSafeMemberPath(data, `models[${i}].data`);
+            if (!members.has(data)) {
+                throw manifestError(`models[${i}].data names a member that does not exist`, data);
+            }
+        }
+        normalized.push({
+            id,
+            entry,
+            ...(typeof rec.label === 'string' ? { label: rec.label } : {}),
+            ...(data !== undefined ? { data } : {}),
+        });
+    }
+    let active;
+    if (manifest.active !== undefined) {
+        if (typeof manifest.active !== 'string' || !seenIds.has(manifest.active)) {
+            throw manifestError('active must equal some models[].id', manifest.active);
+        }
+        active = manifest.active;
+    }
+    return {
+        format: 3,
+        units: 'mm',
+        models: normalized,
+        ...(active !== undefined ? { active } : {}),
+        ...(typeof manifest.createdAt === 'string' ? { createdAt: manifest.createdAt } : {}),
+        ...(typeof manifest.appVersion === 'string' ? { appVersion: manifest.appVersion } : {}),
+        ...(typeof manifest.label === 'string' ? { label: manifest.label } : {}),
+        ...(typeof manifest.source === 'object' && manifest.source !== null ? { source: manifest.source } : {}),
+    };
+}
+/**
+ * Collect the payload bytes of already-unpacked members.
+ * Keys are unique across `files/**` and `assets/**` together (spec §7.1);
+ * a duplicate key is an error rather than a pick.
+ * @param members the unpacked container members
+ * @returns the payload entries keyed by asset key
+ */
+function readAssetEntriesFrom(members) {
+    const files = {};
+    const assets = {};
+    const claimed = new Set();
+    for (const [path, body] of members) {
+        const prefix = path.startsWith(FILES_PREFIX)
+            ? FILES_PREFIX
+            : path.startsWith(ASSETS_PREFIX)
+                ? ASSETS_PREFIX
+                : undefined;
+        if (prefix === undefined)
+            continue;
+        const key = assetKeyOf(path, prefix);
+        if (claimed.has(key))
+            throw new Error(`[fai-zip] duplicate asset key across files//assets/: "${key}"`);
+        claimed.add(key);
+        if (prefix === FILES_PREFIX)
+            files[key] = body;
+        else
+            assets[key] = body;
+    }
+    return { files, assets };
+}
+/**
+ * Read and validate the container manifest (spec §4).
+ * @param bytes the .fai.zip archive bytes
+ * @returns the validated manifest
+ * @throws when the archive is not a ZIP, the manifest is missing/malformed,
+ *   `format !== 3`, `units !== "mm"`, `models` is empty/malformed, ids/entries
+ *   are duplicated, an entry is not under `model/` or does not exist, `active`
+ *   is not in `models[].id`, or a named `data` member does not exist.
+ */
+export function readManifest(bytes) {
+    return readManifestFrom(unzipMembers(bytes));
+}
+/**
+ * List the container models (validated). Same validation as readManifest.
+ * @param bytes the .fai.zip archive bytes
+ * @returns the validated model list
+ */
+export function listModels(bytes) {
+    return readManifest(bytes).models;
+}
+/**
+ * List every module under `model/` (keys relative to `model/`, sorted).
+ * Members outside the table are ignored (§3), never an error.
+ * @param bytes the .fai.zip archive bytes
+ * @returns module keys relative to `model/`, sorted
+ */
+export function listModules(bytes) {
+    return listModulesFrom(unzipMembers(bytes));
+}
+/** Module keys (relative to `model/`, sorted) of already-unpacked members. */
+function listModulesFrom(members) {
+    const keys = [];
+    for (const path of members.keys()) {
+        if (path.startsWith(MODEL_PREFIX) && path.endsWith('.fai.js') && path.length > MODEL_PREFIX.length) {
+            keys.push(path.slice(MODEL_PREFIX.length));
+        }
+    }
+    return keys.sort();
+}
+/**
+ * Read one module's source text by module key (relative to `model/`).
+ * @param bytes the .fai.zip archive bytes
+ * @param key the module key relative to `model/` (e.g. `main.fai.js`)
+ * @returns the module source text
+ * @throws for a key outside `model/` or that does not exist
+ */
+export function readModule(bytes, key) {
+    if (typeof key !== 'string' || key === '') {
+        throw new Error('[fai-zip] readModule: key must be a non-empty string');
+    }
+    assertSafeMemberPath(key, 'readModule key');
+    if (!key.endsWith('.fai.js')) {
+        throw new Error(`[fai-zip] readModule: key must name a module under model/ (ends with .fai.js): "${key}"`);
+    }
+    const member = unzipMembers(bytes).get(MODEL_PREFIX + key);
+    if (member === undefined) {
+        throw new Error(`[fai-zip] readModule: module "${key}" does not exist under model/`);
+    }
+    return decodeMemberText(member);
+}
+/**
+ * Read one model data member's JSON text by member path (e.g. `data/main.json`).
+ *
+ * The path must be exactly what `models[].data` declares (spec §4): a safe,
+ * relative member under `data/` ending with `.json`. Content is validated to
+ * parse as JSON — the editor keeps data members pure JSON (§6.1), so a
+ * non-JSON member is a format violation and an error, never a silent skip.
+ *
+ * @param bytes the .fai.zip archive bytes
+ * @param memberPath the member path named by `models[].data`
+ * @returns the raw JSON text
+ * @throws for a non-string/unsafe path, a path outside `data/`, a missing
+ *   member, or content that does not parse as JSON
+ */
+export function readDataMember(bytes, memberPath) {
+    if (typeof memberPath !== 'string' || memberPath === '') {
+        throw new Error('[fai-zip] readDataMember: memberPath must be a non-empty string');
+    }
+    assertDataMemberPath(memberPath, 'readDataMember path');
+    const member = unzipMembers(bytes).get(memberPath);
+    if (member === undefined) {
+        throw new Error(`[fai-zip] readDataMember: member "${memberPath}" does not exist in the container`);
+    }
+    const text = decodeMemberText(member);
+    try {
+        JSON.parse(text);
+    }
+    catch (e) {
+        throw new Error(`[fai-zip] readDataMember: "${memberPath}" is not valid JSON: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+    }
+    return text;
+}
+/**
+ * Collect the payload bytes of a container.
+ * Keys are unique across `files/**` and `assets/**` together (spec §7.1);
+ * a duplicate key is an error rather than a pick.
+ * @param bytes the .fai.zip archive bytes
+ * @returns the payload entries keyed by asset key
+ */
+export function readAssetEntries(bytes) {
+    return readAssetEntriesFrom(unzipMembers(bytes));
+}
+/**
+ * Host entry point: open a container and return the manifest, the active
+ * model and a ProjectLoader over its module graph, plus the payloads.
+ *
+ * The archive is unpacked exactly once for the whole call.
+ *
+ * @param bytes the .fai.zip archive bytes
+ * @param opts optional active-model override and `io/zip.ts` read caps
+ * @returns manifest, active model, project loader and payload entries
+ * @throws when the container is invalid, the requested model id is unknown, or
+ *   the read caps are exceeded
+ */
+export function openContainer(bytes, opts = {}) {
+    const members = unzipMembers(bytes, opts.caps);
+    const manifest = readManifestFrom(members);
+    const activeModel = (() => {
+        if (opts.modelId === undefined) {
+            const byActive = manifest.models.find((m) => m.id === manifest.active);
+            return byActive ?? manifest.models[0];
+        }
+        const byParam = manifest.models.find((m) => m.id === opts.modelId);
+        if (byParam === undefined) {
+            throw new Error(`[fai-zip] openContainer: model "${opts.modelId}" is not in models[]`);
+        }
+        return byParam;
+    })();
+    const keys = listModulesFrom(members);
+    const loader = {
+        listModules: () => [...keys],
+        readSource: async (moduleKey) => {
+            const member = members.get(MODEL_PREFIX + moduleKey);
+            if (member === undefined) {
+                throw new Error(`[fai-zip] loader: module "${moduleKey}" does not exist under model/`);
+            }
+            return decodeMemberText(member);
+        },
+    };
+    const { files, assets } = readAssetEntriesFrom(members);
+    return { manifest, activeModel, loader, files, assets };
+}
+//# sourceMappingURL=container-read.js.map