@constructorfleet/sketchforge-engine 1.13.0 → 1.14.0

package/dist/stepImportCommon.js

@@ -0,0 +1,121 @@
+import { createLocalId } from "./localIds.js";
+import { LocalizedError } from "./support/i18n/LocalizedError.js";
+import { importedShapeFromTriangleSoup } from "./stlImport.js";
+import { stepComponentMetadata, stepShapeKey } from "./stepComponentMetadata.js";
+const IMPORT_TESSELLATION = { linearDeflection: 0.1, angularDeflection: 0.5 };
+const EXACT_GEOMETRY_LIMITS = { solids: 200, sourceBytes: 8 * 1024 * 1024 };
+function messageOf(error) {
+    if (error instanceof Error && error.message)
+        return error.message;
+    const described = String(error);
+    return described === "[object WebAssembly.Exception]" ? "the CAD kernel refused the file" : described;
+}
+function meshBounds(positions) {
+    if (positions.length < 9)
+        return null;
+    let minX = Infinity, minY = Infinity, minZ = Infinity, maxX = -Infinity, maxZ = -Infinity;
+    for (let index = 0; index < positions.length; index += 3) {
+        minX = Math.min(minX, positions[index]);
+        maxX = Math.max(maxX, positions[index]);
+        minY = Math.min(minY, positions[index + 1]);
+        minZ = Math.min(minZ, positions[index + 2]);
+        maxZ = Math.max(maxZ, positions[index + 2]);
+    }
+    return { minX, minY, minZ, maxX, maxZ };
+}
+function componentColorsByFace(cad, stepText, solids, faces) {
+    // XCAF import and its GLB fallback are intentionally bounded. The regular
+    // mesh import still accepts larger files, where building a second colored
+    // representation can multiply the tessellation cost substantially.
+    if (solids.length > EXACT_GEOMETRY_LIMITS.solids || new TextEncoder().encode(stepText).byteLength > EXACT_GEOMETRY_LIMITS.sourceBytes) {
+        return new Map();
+    }
+    const metadataBySolid = stepComponentMetadata(cad, stepText);
+    const colorsBySolid = new Map();
+    for (const [key, candidates] of metadataBySolid) {
+        const colors = [...new Set(candidates.map(({ color }) => color).filter((color) => Boolean(color)))];
+        // Identical solids with conflicting labels cannot be associated by bounds
+        // and volume alone, so leave those faces at the ordinary shape color.
+        if (colors.length === 1 && candidates.every(({ color }) => color === colors[0]))
+            colorsBySolid.set(key, colors[0]);
+    }
+    const faceIndexByHash = new Map(faces.map((face, index) => [cad.hashCode(face, 2_147_483_647), index]));
+    const colorsByFace = new Map();
+    for (const solid of solids) {
+        const color = colorsBySolid.get(stepShapeKey(cad, solid));
+        if (!color)
+            continue;
+        for (const face of cad.getSubShapes(solid, "face")) {
+            const faceIndex = faceIndexByHash.get(cad.hashCode(face, 2_147_483_647));
+            if (faceIndex !== undefined)
+                colorsByFace.set(faceIndex, color);
+        }
+    }
+    return colorsByFace;
+}
+/** Import STEP geometry and available XCAF component colors through one kernel seam. */
+export async function importedShapeFromStepWithKernel(cad, fileName, stepText) {
+    if (!stepText.trim())
+        throw new LocalizedError("errors.step.readFailed", { detail: "the file was empty" });
+    let imported;
+    try {
+        imported = cad.importStep(stepText);
+    }
+    catch (error) {
+        throw new LocalizedError("errors.step.readFailed", { detail: messageOf(error) });
+    }
+    const solids = cad.getSubShapes(imported, "solid");
+    let mesh;
+    try {
+        mesh = cad.meshShape(imported, IMPORT_TESSELLATION);
+    }
+    catch (error) {
+        throw new LocalizedError("errors.step.meshFailed", { detail: messageOf(error) });
+    }
+    if (mesh.triangleCount < 1)
+        throw new LocalizedError("errors.step.noSolidGeometry");
+    const positions = [];
+    const normals = [];
+    const faceGroups = [];
+    const faces = cad.getSubShapes(imported, "face");
+    const faceIndexByHash = new Map(faces.map((face, index) => [cad.hashCode(face, 2_147_483_647), index]));
+    for (let group = 0; group + 2 < (mesh.faceGroups?.length ?? 0); group += 3) {
+        const start = mesh.faceGroups[group];
+        const count = mesh.faceGroups[group + 1];
+        const index = faceIndexByHash.get(mesh.faceGroups[group + 2]);
+        // `meshShape` reports triangle ranges in index units, while the stored
+        // non-indexed mesh and viewport face groups count triangles.
+        if (index !== undefined)
+            faceGroups.push(start / 3, count / 3, index);
+    }
+    const hasNormals = mesh.normals.length === mesh.positions.length;
+    for (let index = 0; index < mesh.indices.length; index += 1) {
+        const vertex = mesh.indices[index] * 3;
+        positions.push(mesh.positions[vertex], mesh.positions[vertex + 2], -mesh.positions[vertex + 1]);
+        if (hasNormals)
+            normals.push(mesh.normals[vertex], mesh.normals[vertex + 2], -mesh.normals[vertex + 1]);
+    }
+    const shape = importedShapeFromTriangleSoup(fileName, positions, hasNormals ? normals : undefined, "step");
+    if (shape.importedMesh && faceGroups.length)
+        shape.importedMesh.faceGroups = faceGroups;
+    const colorsByFace = componentColorsByFace(cad, stepText, solids, faces);
+    if (colorsByFace.size) {
+        shape.faceIds = faces.map((_, index) => `face_${createLocalId(`${shape.id}-face-${index}`)}`);
+        shape.faceColors = Object.fromEntries([...colorsByFace].map(([index, color]) => [shape.faceIds[index], color]));
+    }
+    const bounds = meshBounds(positions);
+    const worthKeepingExact = solids.length <= EXACT_GEOMETRY_LIMITS.solids
+        && new TextEncoder().encode(stepText).byteLength <= EXACT_GEOMETRY_LIMITS.sourceBytes;
+    if (shape.importedMesh && bounds && worthKeepingExact) {
+        try {
+            const turned = cad.rotate(imported, { point: { x: 0, y: 0, z: 0 }, direction: { x: 1, y: 0, z: 0 } }, -Math.PI / 2);
+            const centred = cad.translate(turned, -(bounds.minX + bounds.maxX) / 2, -bounds.minY, -(bounds.minZ + bounds.maxZ) / 2);
+            shape.importedMesh.brepStep = cad.exportStep(centred);
+        }
+        catch {
+            // Exact geometry is optional; the correctly framed mesh remains importable.
+        }
+    }
+    return { shape, solids: solids.length, triangles: mesh.triangleCount, exactGeometry: Boolean(shape.importedMesh?.brepStep) };
+}
+//# sourceMappingURL=stepImportCommon.js.map

package/dist/stepImportCommon.js.map

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

package/dist/stepImportKernel.d.ts

@@ -1,15 +1,4 @@
-import type { WorkplaneShape } from "./domain/sketchforge.js";
-export type StepImportSummary = {
-    shape: WorkplaneShape;
-    /** How many separate solids the file held, which is what makes it an assembly. */
-    solids: number;
-    triangles: number;
-    /**
-     * Whether the exact B-rep was kept alongside the mesh. False for an assembly
-     * past `EXACT_GEOMETRY_LIMITS`, so a caller can say why a later fillet or
-     * STEP export of this shape works from triangles.
-     */
-    exactGeometry: boolean;
-};
+import type { StepImportSummary } from "./stepImportCommon.js";
+export type { StepImportSummary } from "./stepImportCommon.js";
 export declare function importedShapeFromStepOnKernel(fileName: string, stepText: string): Promise<StepImportSummary>;
 //# sourceMappingURL=stepImportKernel.d.ts.map

package/dist/stepImportKernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stepImportKernel.d.ts","sourceRoot":"","sources":["../src/stepImportKernel.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAsB9D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAsB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuFlH"}
+{"version":3,"file":"stepImportKernel.d.ts","sourceRoot":"","sources":["../src/stepImportKernel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE5G"}

package/dist/stepImportKernel.js

@@ -1,145 +1,7 @@
-/**
- * STEP import on the OCCT kernel directly, rather than through brepjs.
- *
- * `stepImport.ts` reads a STEP file with brepjs: `importSTEP`, `rotate`, then
- * `mesh`. That works for the files anyone had tried, and fails on a real
- * assembly. Measured on a 74 MB FreeCAD AP214 export of a Raspberry Pi 5 board
- * (45,689 faces, 2,689 solids):
- *
- * | step                               | brepjs                        | this kernel path |
- * | ---------------------------------- | ----------------------------- | ---------------- |
- * | read the file                      | ok, 20.5s                     | ok, 20.5s        |
- * | rotate Z-up to Y-up                | ok, 1.6s                      | ok               |
- * | tessellate                         | **memory access out of bounds** | ok, 5.0s, 674,520 triangles |
- *
- * It is not a memory ceiling: the module grows to 4 GB, the failure is the same
- * under Node as in a browser, and coarsening `linearDeflection` from 0.1 to 1.0
- * does not move it -- a heap that was merely full would have. The kernel's own
- * `tessellate` meshes the identical shape, whole or per solid. So the mesher
- * above the kernel is the thing that cannot do it, and this module skips it.
- *
- * Node-only, because it uses the server kernel. The browser keeps the brepjs
- * path, which is all a static export has.
- */
-import { LocalizedError } from "./support/i18n/LocalizedError.js";
+/** STEP import on the OCCT kernel directly, rather than through brepjs. */
 import { withCadKernel } from "./serverCadKernel.js";
-import { importedShapeFromTriangleSoup } from "./stlImport.js";
-/** Tessellation fine enough for a board, coarse enough for an assembly. */
-const IMPORT_TESSELLATION = { linearDeflection: 0.1, angularDeflection: 0.5 };
-/**
- * Above this, the exact geometry is left out and only the mesh is kept.
- *
- * Re-exporting the model to STEP text is what fills `importedMesh.brepStep`,
- * and the text is far larger than the file it came from: the 74 MB Raspberry Pi
- * assembly comes back as **202.7 MB**. That string would be stored in the
- * project, which autosave writes on every edit -- a measured 48 ms for a small
- * project, and that is before adding 200 MB of text to it. An assembly this
- * size is imported as a mesh, and keeping the exact geometry for one is a
- * separate piece of work: the right answer is to store the *source* text with
- * the frame it was placed into, rather than a fresh export, and that changes
- * what the consumers of `brepStep` have to understand.
- */
-const EXACT_GEOMETRY_LIMITS = { solids: 200, sourceBytes: 8 * 1024 * 1024 };
-const X_AXIS = { point: { x: 0, y: 0, z: 0 }, direction: { x: 1, y: 0, z: 0 } };
-export async function importedShapeFromStepOnKernel(fileName, stepText) {
-    if (!stepText.trim())
-        throw new LocalizedError("errors.step.readFailed", { detail: "the file was empty" });
-    return withCadKernel(async (cad) => {
-        let imported;
-        try {
-            imported = cad.importStep(stepText);
-        }
-        catch (error) {
-            throw new LocalizedError("errors.step.readFailed", { detail: messageOf(error) });
-        }
-        const solids = cad.getSubShapes(imported, "solid");
-        // Tessellated *before* any kernel transform, and deliberately. `rotate`
-        // copies the whole B-rep, so rotating first means two 74 MB models in the
-        // kernel at once -- and that is what exhausts it: the same file tessellates
-        // in 5s when nothing has been copied, and dies with "memory access out of
-        // bounds" when the rotation went first. Both the old brepjs path and my own
-        // first attempt rotated first, and both failed here.
-        let mesh;
-        try {
-            mesh = cad.meshShape(imported, IMPORT_TESSELLATION);
-        }
-        catch (error) {
-            throw new LocalizedError("errors.step.meshFailed", { detail: messageOf(error) });
-        }
-        if (mesh.triangleCount < 1)
-            throw new LocalizedError("errors.step.noSolidGeometry");
-        // The kernel hands back indexed triangles; the shape builder takes a soup.
-        // STEP/CAD space is Z-up and SketchForge is Y-up, so the triangles are
-        // turned here rather than the solid: (x, y, z) -> (x, z, -y) is exactly the
-        // -90 degrees about X that the solid would have been given, and it costs a
-        // multiply-free swap per vertex instead of a copy of the model.
-        const positions = [];
-        const normals = [];
-        const faceGroups = [];
-        const hasNormals = mesh.normals.length === mesh.positions.length;
-        const faceIndexByHash = new Map(cad.getSubShapes(imported, "face").map((face, index) => [cad.hashCode(face, 2_147_483_647), index]));
-        for (let group = 0; group + 2 < (mesh.faceGroups?.length ?? 0); group += 3) {
-            const start = mesh.faceGroups[group];
-            const count = mesh.faceGroups[group + 1];
-            const index = faceIndexByHash.get(mesh.faceGroups[group + 2]);
-            if (index !== undefined)
-                faceGroups.push(start, count, index);
-        }
-        for (let index = 0; index < mesh.indices.length; index += 1) {
-            const vertex = mesh.indices[index] * 3;
-            positions.push(mesh.positions[vertex], mesh.positions[vertex + 2], -mesh.positions[vertex + 1]);
-            if (hasNormals)
-                normals.push(mesh.normals[vertex], mesh.normals[vertex + 2], -mesh.normals[vertex + 1]);
-        }
-        const shape = importedShapeFromTriangleSoup(fileName, positions, hasNormals ? normals : undefined, "step");
-        if (shape.importedMesh && faceGroups.length)
-            shape.importedMesh.faceGroups = faceGroups;
-        // `importedShapeFromTriangleSoup` recentres the mesh on x/z and rests it on
-        // y = 0, so the stored exact geometry has to move by the same offset or the
-        // two frames disagree -- the mismatch #53 found and fixed for treatments.
-        const bounds = meshBounds(positions);
-        const worthKeepingExact = solids.length <= EXACT_GEOMETRY_LIMITS.solids
-            && stepText.length <= EXACT_GEOMETRY_LIMITS.sourceBytes;
-        if (shape.importedMesh && bounds && worthKeepingExact) {
-            try {
-                // Only now is the solid turned and moved, to match the frame the mesh
-                // was recentred into. This is the step that can exhaust the kernel on a
-                // large assembly, so it comes last and its failure costs only the exact
-                // geometry: a project that cannot be imported at all is worse than one
-                // whose imported mesh has no B-rep behind it.
-                const turned = cad.rotate(imported, X_AXIS, -Math.PI / 2);
-                const centred = cad.translate(turned, -(bounds.minX + bounds.maxX) / 2, -bounds.minY, -(bounds.minZ + bounds.maxZ) / 2);
-                shape.importedMesh.brepStep = cad.exportStep(centred);
-            }
-            catch {
-                // Left without exact geometry on purpose. The mesh is still correct.
-            }
-        }
-        return {
-            shape,
-            solids: solids.length,
-            triangles: mesh.triangleCount,
-            exactGeometry: Boolean(shape.importedMesh?.brepStep),
-        };
-    });
-}
-function messageOf(error) {
-    if (error instanceof Error && error.message)
-        return error.message;
-    const described = String(error);
-    return described === "[object WebAssembly.Exception]" ? "the CAD kernel refused the file" : described;
-}
-function meshBounds(positions) {
-    if (positions.length < 9)
-        return null;
-    let minX = Infinity, minY = Infinity, minZ = Infinity, maxX = -Infinity, maxZ = -Infinity;
-    for (let index = 0; index < positions.length; index += 3) {
-        minX = Math.min(minX, positions[index]);
-        maxX = Math.max(maxX, positions[index]);
-        minY = Math.min(minY, positions[index + 1]);
-        minZ = Math.min(minZ, positions[index + 2]);
-        maxZ = Math.max(maxZ, positions[index + 2]);
-    }
-    return { minX, minY, minZ, maxX, maxZ };
+import { importedShapeFromStepWithKernel } from "./stepImportCommon.js";
+export function importedShapeFromStepOnKernel(fileName, stepText) {
+    return withCadKernel((cad) => importedShapeFromStepWithKernel(cad, fileName, stepText));
 }
 //# sourceMappingURL=stepImportKernel.js.map

package/dist/stepImportKernel.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepImportKernel.js","sourceRoot":"","sources":["../src/stepImportKernel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stepImportKernel.js","sourceRoot":"","sources":["../src/stepImportKernel.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAKxE,MAAM,UAAU,6BAA6B,CAAC,QAAgB,EAAE,QAAgB;IAC9E,OAAO,aAAa,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,+BAA+B,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/support/cadModifierTypes.d.ts

@@ -77,6 +77,15 @@ export type CadModifierWorkerRequest = {
     profile: SketchProfile;
     height: number;
     angle: number;
+} | {
+    type: "draft-face";
+    requestId: number;
+    brep: string;
+    faceIds: string[];
+    faceId: string;
+    angle: number;
+    pullDirection: "x" | "y" | "z";
+    brepTransform?: number[];
 } | {
     type: "dispose";
     requestId: number;
@@ -115,6 +124,16 @@ export type CadModifierWorkerResponse = {
     indices: Uint32Array;
     triangleCount: number;
     brep: string;
+} | {
+    type: "draft-face";
+    requestId: number;
+    positions: Float32Array;
+    normals: Float32Array;
+    indices: Uint32Array;
+    triangleCount: number;
+    faceCount: number;
+    volume: number;
+    brep: string;
 } | {
     type: "disposed";
     requestId: number;

package/dist/support/cadModifierTypes.d.ts.map

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

package/dist/support/i18n/locales/en/messages.json

@@ -1268,6 +1268,9 @@
             "notPrepared": "Prepare an object before previewing the modifier",
             "noEdgesSelected": "Select at least one highlighted edge",
             "invalidResult": "The chosen size creates invalid or overlapping edge geometry",
+            "draftFaceInvalid": "The face draft could not produce a valid solid. Check the face index and draft angle.",
+            "draftFaceNotFound": "The selected face is no longer available on this solid. Choose another face index.",
+            "draftFaceIncompatible": "The selected face cannot be drafted along that local CAD axis at this angle. Try another axis, face, or angle.",
             "filletTooLarge": "The selected edges cannot be filleted together at this size. Reduce the size or select fewer connected edges.",
             "chamferTooLarge": "The selected edges cannot be chamfered together at this size. Reduce the size or select fewer connected edges.",
             "edgeTreatmentFailed": "The CAD kernel could not complete this edge treatment",

package/dist/support/lib/brepKernel.d.ts

@@ -1,4 +1,8 @@
 export type Brep = typeof import("brepjs");
 export type BrepSolid = ReturnType<Brep["box"]>;
+type OcctKernel = import("occt-wasm").OcctKernel;
+/** Load the registered OCCT instance for operations that need its XCAF API. */
+export declare function loadOcctKernel(): Promise<OcctKernel>;
 export declare function loadBrepWithOcct(): Promise<Brep>;
+export {};
 //# sourceMappingURL=brepKernel.d.ts.map

package/dist/support/lib/brepKernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brepKernel.d.ts","sourceRoot":"","sources":["../../../src/support/lib/brepKernel.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,IAAI,GAAG,cAAc,QAAQ,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAKhD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBtD"}
+{"version":3,"file":"brepKernel.d.ts","sourceRoot":"","sources":["../../../src/support/lib/brepKernel.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,IAAI,GAAG,cAAc,QAAQ,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAEhD,KAAK,UAAU,GAAG,OAAO,WAAW,EAAE,UAAU,CAAC;AAKjD,+EAA+E;AAC/E,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAoB1D;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAatD"}

package/dist/support/lib/brepKernel.js

@@ -12,17 +12,13 @@ const OCCT_NODE_INDEX_URL = "occt-wasm/dist/occt-wasm.js";
 const OCCT_PACKAGE_URL = "occt-wasm";
 const OCCT_WASM_URL = "/occt/occt-wasm.wasm";
 let brepReady = null;
-export async function loadBrepWithOcct() {
-    // Cache the in-flight/resolved load, but drop a rejected attempt so a transient
-    // failure (e.g. a blip fetching the 22 MB wasm) can be retried on the next call
-    // instead of poisoning STEP for the rest of the session.
-    brepReady ??= (async () => {
-        const brep = await import("brepjs");
+let kernelReady = null;
+/** Load the registered OCCT instance for operations that need its XCAF API. */
+export async function loadOcctKernel() {
+    kernelReady ??= (async () => {
         if (typeof window !== "undefined") {
             const occt = (await import(/* webpackIgnore: true */ OCCT_INDEX_URL));
-            const kernel = await occt.OcctKernel.init({ wasm: OCCT_WASM_URL });
-            brep.registerKernel("occt-wasm", brep.OcctWasmAdapter.fromKernel(kernel));
-            return brep;
+            return occt.OcctKernel.init({ wasm: OCCT_WASM_URL });
         }
         const [{ OcctKernel: KernelConstructor }, { default: createModule }] = await Promise.all([
             import(/* webpackIgnore: true */ OCCT_PACKAGE_URL),
@@ -30,7 +26,23 @@ export async function loadBrepWithOcct() {
         ]);
         const module = await createModule();
         const Kernel = KernelConstructor;
-        brep.registerKernel("occt-wasm", brep.OcctWasmAdapter.fromKernel(new Kernel(module)));
+        return new Kernel(module);
+    })();
+    try {
+        return await kernelReady;
+    }
+    catch (error) {
+        kernelReady = null;
+        throw error;
+    }
+}
+export async function loadBrepWithOcct() {
+    // Cache the in-flight/resolved load, but drop a rejected attempt so a transient
+    // failure (e.g. a blip fetching the 22 MB wasm) can be retried on the next call
+    // instead of poisoning STEP for the rest of the session.
+    brepReady ??= (async () => {
+        const [brep, kernel] = await Promise.all([import("brepjs"), loadOcctKernel()]);
+        brep.registerKernel("occt-wasm", brep.OcctWasmAdapter.fromKernel(kernel));
         return brep;
     })().catch((error) => {
         brepReady = null;

package/dist/support/lib/brepKernel.js.map

@@ -1 +1 @@
-{"version":3,"file":"brepKernel.js","sourceRoot":"","sources":["../../../src/support/lib/brepKernel.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,cAAc,GAAW,gBAAgB,CAAC;AAChD,MAAM,mBAAmB,GAAW,6BAA6B,CAAC;AAClE,MAAM,gBAAgB,GAAW,WAAW,CAAC;AAC7C,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAM7C,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,gFAAgF;IAChF,gFAAgF;IAChF,yDAAyD;IACzD,SAAS,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAA8B,CAAC;YACnG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACvF,MAAM,CAAC,yBAAyB,CAAC,gBAAgB,CAAC;YAClD,MAAM,CAAC,yBAAyB,CAAC,mBAAmB,CAAC;SACtD,CAAsE,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,iBAA0F,CAAC;QAC1G,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACnB,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"brepKernel.js","sourceRoot":"","sources":["../../../src/support/lib/brepKernel.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,cAAc,GAAW,gBAAgB,CAAC;AAChD,MAAM,mBAAmB,GAAW,6BAA6B,CAAC;AAClE,MAAM,gBAAgB,GAAW,WAAW,CAAC;AAC7C,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAO7C,IAAI,SAAS,GAAyB,IAAI,CAAC;AAC3C,IAAI,WAAW,GAA+B,IAAI,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,WAAW,KAAK,CAAC,KAAK,IAAI,EAAE;QAC1B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAA8B,CAAC;YACnG,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACvF,MAAM,CAAC,yBAAyB,CAAC,gBAAgB,CAAC;YAClD,MAAM,CAAC,yBAAyB,CAAC,mBAAmB,CAAC;SACtD,CAAsE,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,iBAAsE,CAAC;QACtF,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,EAAE,CAAC;IACL,IAAI,CAAC;QACH,OAAO,MAAM,WAAW,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,gFAAgF;IAChF,gFAAgF;IAChF,yDAAyD;IACzD,SAAS,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QAC/E,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACnB,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/support/lib/operator-configuration.json

@@ -0,0 +1,124 @@
+{
+    "settings": [
+        {
+            "name": "SKETCHFORGE_PORT",
+            "default": "3000",
+            "required": false,
+            "validation": "Compose host port published to container port 3000; configure this when host port 3000 is already occupied.",
+            "sensitive": false,
+            "subsystem": "Docker port publishing"
+        },
+        {
+            "name": "SKETCHFORGE_SHARED_PROJECTS_VOLUME",
+            "default": "sketchforge-shared-projects",
+            "required": false,
+            "validation": "Docker named volume or bind mount source for /data/projects, where shared project files are stored.",
+            "sensitive": false,
+            "subsystem": "Docker shared project persistence"
+        },
+        {
+            "name": "SKETCHFORGE_PROJECTS_VOLUME",
+            "default": "sketchforge-projects",
+            "required": false,
+            "validation": "Docker named volume or bind mount source for /data/my-projects. Used when SKETCHFORGE_PROJECTS_DIR points to that path.",
+            "sensitive": false,
+            "subsystem": "Docker server project persistence"
+        },
+        {
+            "name": "PORT",
+            "default": "3000",
+            "required": false,
+            "validation": "Integer from 1 through 65535; invalid values fall back to 3000.",
+            "sensitive": false,
+            "subsystem": "Docker server listener"
+        },
+        {
+            "name": "HOSTNAME",
+            "default": "0.0.0.0 in the Docker launcher; otherwise supplied by the hosting runtime.",
+            "required": false,
+            "validation": "Passed to the Next.js server as its bind host.",
+            "sensitive": false,
+            "subsystem": "Docker server listener"
+        },
+        {
+            "name": "SKETCHFORGE_LEGACY_PORT",
+            "default": "80",
+            "required": false,
+            "validation": "Integer from 1 through 65535; invalid values fall back to 80. Set equal to PORT to disable the compatibility proxy.",
+            "sensitive": false,
+            "subsystem": "Docker compatibility proxy"
+        },
+        {
+            "name": "SKETCHFORGE_PROJECTS_DIR",
+            "default": "Unset; browser-local storage is used.",
+            "required": false,
+            "validation": "Filesystem path writable by the server. Enables server-backed project storage and must be paired with SKETCHFORGE_API_TOKEN to enable the scripting REST API.",
+            "sensitive": false,
+            "subsystem": "Server project storage and REST API"
+        },
+        {
+            "name": "SKETCHFORGE_API_TOKEN",
+            "default": "Unset; REST API authorization is disabled.",
+            "required": false,
+            "validation": "Non-empty bearer token. Configure a high-entropy secret; never expose it to browsers or logs. Used with SKETCHFORGE_PROJECTS_DIR.",
+            "sensitive": true,
+            "subsystem": "REST API authentication"
+        },
+        {
+            "name": "SKETCHFORGE_SHARED_PROJECTS_DIR",
+            "default": "/data/projects in the Docker image and compose examples.",
+            "required": false,
+            "validation": "Filesystem path writable by the server; mount persistent storage at this path to retain shared projects across container replacement.",
+            "sensitive": false,
+            "subsystem": "Shared project files"
+        },
+        {
+            "name": "SKETCHFORGE_APP_VERSION",
+            "default": "Detected from the installed package or project metadata.",
+            "required": false,
+            "validation": "Semantic version; invalid values are ignored.",
+            "sensitive": false,
+            "subsystem": "Update status"
+        },
+        {
+            "name": "SKETCHFORGE_UPDATE_MANIFEST_URL",
+            "default": "Official SketchForge release manifest URL.",
+            "required": false,
+            "validation": "HTTP or HTTPS URL returning JSON with a semantic-version `version` field.",
+            "sensitive": false,
+            "subsystem": "Update status"
+        },
+        {
+            "name": "SKETCHFORGE_UPDATE_GUIDE_URL",
+            "default": "Official SketchForge update guide URL.",
+            "required": false,
+            "validation": "URL shown to users as the update guide.",
+            "sensitive": false,
+            "subsystem": "Update status"
+        },
+        {
+            "name": "SKETCHFORGE_UPDATE_TRIGGER_URL",
+            "default": "Unset; server-triggered updates are unavailable.",
+            "required": false,
+            "validation": "HTTP or HTTPS URL for the configured update trigger endpoint.",
+            "sensitive": false,
+            "subsystem": "Server-triggered updates"
+        },
+        {
+            "name": "SKETCHFORGE_UPDATE_ADMIN_KEY",
+            "default": "Unset; server-triggered updates are unavailable.",
+            "required": false,
+            "validation": "Secret expected by the update trigger service. Required with SKETCHFORGE_UPDATE_TRIGGER_URL.",
+            "sensitive": true,
+            "subsystem": "Server-triggered updates"
+        },
+        {
+            "name": "SKETCHFORGE_UPDATE_TRIGGER_TOKEN",
+            "default": "Unset; trigger requests are unauthorized.",
+            "required": false,
+            "validation": "Secret bearer token sent to the configured trigger endpoint. Required when that endpoint enforces a trigger token.",
+            "sensitive": true,
+            "subsystem": "Server-triggered updates"
+        }
+    ]
+}

package/dist/support/lib/operatorConfiguration.d.ts

@@ -0,0 +1,14 @@
+import configuration from "./operator-configuration.json";
+export declare const OPERATOR_CONFIGURATION: {
+    settings: {
+        name: string;
+        default: string;
+        required: boolean;
+        validation: string;
+        sensitive: boolean;
+        subsystem: string;
+    }[];
+};
+export type OperatorSettingName = (typeof configuration.settings)[number]["name"];
+export declare function operatorSettingName(name: OperatorSettingName): string;
+//# sourceMappingURL=operatorConfiguration.d.ts.map

package/dist/support/lib/operatorConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorConfiguration.d.ts","sourceRoot":"","sources":["../../../src/support/lib/operatorConfiguration.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,+BAA+B,CAAuB;AAEhF,eAAO,MAAM,sBAAsB;;;;;;;;;CAAgB,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,UAE5D"}

package/dist/support/lib/operatorConfiguration.js

@@ -0,0 +1,6 @@
+import configuration from "./operator-configuration.json" with { type: "json" };
+export const OPERATOR_CONFIGURATION = configuration;
+export function operatorSettingName(name) {
+    return name;
+}
+//# sourceMappingURL=operatorConfiguration.js.map

package/dist/support/lib/operatorConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorConfiguration.js","sourceRoot":"","sources":["../../../src/support/lib/operatorConfiguration.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEhF,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAGpD,MAAM,UAAU,mBAAmB,CAAC,IAAyB;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/support/lib/serverProjectStore.d.ts

@@ -11,7 +11,7 @@
  * the dashboard agree on names, limits, and staleness) or a `fetch` against
  * `/api/projects`.
  */
-export declare const SERVER_PROJECTS_ENV = "SKETCHFORGE_PROJECTS_DIR";
+export declare const SERVER_PROJECTS_ENV: string;
 export declare const SERVER_PROJECTS_ENDPOINT = "/api/projects";
 /** A project id as the server will spell it on disk, or null when it cannot be one. */
 export declare function safeServerProjectId(projectId: string): string | null;