brep-io-kernel 1.0.26 → 1.0.28

package/src/UI/toolbarButtons/registerDefaultButtons.js

@@ -1,6 +1,7 @@
 // Registers the default toolbar buttons using the viewer's addToolbarButton API.
 // Each button's logic is implemented in its own module.
 
+import { createNewButton } from './newButton.js';
 import { createSaveButton } from './saveButton.js';
 import { createUndoButton, createRedoButton } from './undoRedoButtons.js';
 import { createZoomToFitButton } from './zoomToFitButton.js';
@@ -17,6 +18,7 @@ export function registerDefaultToolbarButtons(viewer) {
   if (!viewer || typeof viewer.addToolbarButton !== 'function') return;
 
   const creators = [
+    createNewButton,
     createSaveButton,
     createZoomToFitButton,
     createWireframeToggleButton,

package/src/UI/toolbarButtons/saveButton.js

@@ -87,7 +87,7 @@ export function createSaveButton(viewer) {
       const b64 = _uint8ToBase64(bytes);
       // Do not persist a separate thumbnail; it's embedded in the 3MF
       const payload = { savedAt: new Date().toISOString(), data3mf: b64 };
-      LS.setItem('__BREP_MODEL__:autosave', JSON.stringify(payload));
+      LS.setItem('__BREP_DATA__:autosave', JSON.stringify(payload));
       LS.setItem('__BREP_MODELS_LASTNAME__', 'autosave');
       alert('Saved as "autosave"');
     } catch {

package/src/UI/viewer.js

@@ -37,6 +37,7 @@ import { PMIMode } from './pmi/PMIMode.js';
 import { annotationRegistry } from './pmi/AnnotationRegistry.js';
 import { SchemaForm } from './featureDialogs.js';
 import './dialogs.js';
+import { maybeStartStartupTour } from './startupTour.js';
 import { BREP } from '../BREP/BREP.js';
 import { createAxisHelperGroup, DEFAULT_AXIS_HELPER_PX } from '../utils/axisHelpers.js';
 
@@ -1220,6 +1221,9 @@ export class Viewer {
 
         // Ensure toolbar sits above the canvas and doesn't block controls when not hovered
         try { this.renderer.domElement.style.marginTop = '0px'; } catch { }
+
+        // Start the startup tour once the core UI is mounted, if not already completed.
+        try { await maybeStartStartupTour(this); } catch { }
     }
 
     // Public: allow plugins to add toolbar buttons even before MainToolbar is constructed

package/src/fs.proxy.js

@@ -78,12 +78,48 @@ async function idbGet(db, key) {
   return promisifyRequest(store.get(key));
 }
 
-async function idbPut(db, key, value) {
+async function idbDelete(db, key) {
   const tx = db.transaction([VFS_STORE_NAME], 'readwrite');
-  tx.objectStore(VFS_STORE_NAME).put(value, key);
+  tx.objectStore(VFS_STORE_NAME).delete(key);
   return new Promise((resolve, reject) => {
     tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error || new Error('IDB put failed'));
+    tx.onerror = () => reject(tx.error || new Error('IDB delete failed'));
+  });
+}
+
+async function idbGetAllEntries(db) {
+  const tx = db.transaction([VFS_STORE_NAME], 'readonly');
+  const store = tx.objectStore(VFS_STORE_NAME);
+  if (store.getAll && store.getAllKeys) {
+    const [items, keys] = await Promise.all([promisifyRequest(store.getAll()), promisifyRequest(store.getAllKeys())]);
+    const out = new Map();
+    for (let i = 0; i < keys.length; i++) out.set(String(keys[i]), items[i]);
+    return out;
+  }
+  return new Promise((resolve, reject) => {
+    const out = new Map();
+    const req = store.openCursor();
+    req.onsuccess = (e) => {
+      const cursor = e.target.result;
+      if (cursor) {
+        out.set(String(cursor.key), cursor.value);
+        cursor.continue();
+      } else {
+        resolve(out);
+      }
+    };
+    req.onerror = () => reject(req.error || new Error('Cursor failed'));
+  });
+}
+
+async function idbPutDeleteEntries(db, puts, deletes) {
+  const tx = db.transaction([VFS_STORE_NAME], 'readwrite');
+  const store = tx.objectStore(VFS_STORE_NAME);
+  for (const key of deletes || []) store.delete(key);
+  for (const [key, value] of puts || []) store.put(value, key);
+  return new Promise((resolve, reject) => {
+    tx.oncomplete = () => resolve();
+    tx.onerror = () => reject(tx.error || new Error('IDB batch failed'));
   });
 }
 
@@ -198,9 +234,27 @@ class IndexedDbFS {
     this._dbPromise = openVfsDB();
     try {
       const db = await this._dbPromise;
-      const stored = coerceIndex(await idbGet(db, VFS_KEY));
-      if (stored) {
-        this.index = stored;
+      const legacyRaw = await idbGet(db, VFS_KEY);
+      const legacyIndex = coerceIndex(legacyRaw);
+      if (legacyIndex) {
+        this.index = legacyIndex;
+        const puts = Object.entries(this.index.entries);
+        await idbPutDeleteEntries(db, puts, [VFS_KEY]);
+      } else {
+        if (legacyRaw !== undefined && legacyRaw !== null) {
+          await idbDelete(db, VFS_KEY);
+        }
+        const map = await idbGetAllEntries(db);
+        if (map.size) {
+          const entries = {};
+          for (const [key, value] of map.entries()) {
+            if (key === VFS_KEY) continue;
+            if (value && typeof value === 'object' && typeof value.type === 'string') {
+              entries[key] = value;
+            }
+          }
+          if (Object.keys(entries).length) this.index = { entries };
+        }
       }
     } catch (err) {
       console.warn('[vfs] IndexedDB unavailable; using in-memory storage only.', err);
@@ -225,17 +279,25 @@ class IndexedDbFS {
     }
     if (!this.index.entries['/']) {
       this.index.entries['/'] = { type: 'dir', children: [], mtimeMs: nowMs(), mode: 0o777 };
-      this._save();
+      this._save(['/']);
     }
   }
 
-  _save() {
+  _save(puts = [], deletes = []) {
     if (!this._idbEnabled) return;
     if (!this._dbPromise) this._dbPromise = openVfsDB();
-    const snapshot = this.index;
+    const entries = this.index.entries;
+    const putList = Array.isArray(puts) ? puts : [];
+    const deleteList = Array.isArray(deletes) ? deletes : [];
+    if (!putList.length && !deleteList.length) return;
+    const putPairs = [];
+    for (const key of putList) {
+      const entry = entries[key];
+      if (entry) putPairs.push([key, entry]);
+    }
     this._persistChain = this._persistChain
       .then(() => this._dbPromise)
-      .then((db) => idbPut(db, VFS_KEY, snapshot))
+      .then((db) => idbPutDeleteEntries(db, putPairs, deleteList))
       .catch((err) => {
         console.warn('[vfs] Persist failed:', err);
       });
@@ -250,8 +312,10 @@ class IndexedDbFS {
       if (!eParent.children.includes(name)) {
         eParent.children.push(name);
         eParent.mtimeMs = nowMs();
+        return parent;
       }
     }
+    return null;
   }
   _unlinkFromParent(p) {
     const parent = dirname(p);
@@ -262,8 +326,10 @@ class IndexedDbFS {
       if (i >= 0) {
         eParent.children.splice(i, 1);
         eParent.mtimeMs = nowMs();
+        return parent;
       }
     }
+    return null;
   }
   _resolveEncoding(options) {
     if (!options) return null;
@@ -303,8 +369,12 @@ class IndexedDbFS {
       mtimeMs: nowMs(),
       mode: (options.mode ?? 0o666)
     };
-    if (!exists) this._linkIntoParent(path);
-    this._save();
+    const touched = new Set([path]);
+    if (!exists) {
+      const p = this._linkIntoParent(path);
+      if (p) touched.add(p);
+    }
+    this._save([...touched]);
   }
 
   appendFileSync(path, data, options = {}) {
@@ -337,7 +407,7 @@ class IndexedDbFS {
     existing.data = uint8ToBase64(merged);
     existing.size = merged.length;
     existing.mtimeMs = nowMs();
-    this._save();
+    this._save([path]);
   }
 
   readFileSync(path, options = {}) {
@@ -368,21 +438,28 @@ class IndexedDbFS {
       const eParent = this.index.entries[parent];
       if (!eParent || eParent.type !== 'dir') throw this._enoent('ENOENT', parent);
       this.index.entries[path] = { type: 'dir', children: [], mtimeMs: nowMs(), mode: options.mode ?? 0o777 };
-      this._linkIntoParent(path); this._save(); return;
+      const touched = new Set([path]);
+      const p = this._linkIntoParent(path);
+      if (p) touched.add(p);
+      this._save([...touched]);
+      return;
     }
     const parts = normalizePath(path).split('/').filter(Boolean);
     let cur = '/';
+    const touched = new Set();
     for (const part of parts) {
       const next = normalizePath(cur + '/' + part);
       if (!this.index.entries[next]) {
         this.index.entries[next] = { type: 'dir', children: [], mtimeMs: nowMs(), mode: 0o777 };
-        this._linkIntoParent(next);
+        touched.add(next);
+        const p = this._linkIntoParent(next);
+        if (p) touched.add(p);
       } else if (this.index.entries[next].type !== 'dir') {
         throw this._eexist('EEXIST', next);
       }
       cur = next;
     }
-    this._save();
+    if (touched.size) this._save([...touched]);
   }
 
   readdirSync(path, options = {}) {
@@ -411,8 +488,9 @@ class IndexedDbFS {
     if (!entry) throw this._enoent('ENOENT', path);
     if (entry.type !== 'file') throw this._enoent('EISDIR', path);
     delete this.index.entries[path];
-    this._unlinkFromParent(path);
-    this._save();
+    const p = this._unlinkFromParent(path);
+    const puts = p ? [p] : [];
+    this._save(puts, [path]);
   }
 
   rmdirSync(path, options = {}) {
@@ -425,6 +503,7 @@ class IndexedDbFS {
     if (entry.children.length && !recursive) {
       const err = new Error(`ENOTEMPTY: directory not empty, ${path}`); err.code = 'ENOTEMPTY'; throw err;
     }
+    const toDelete = [];
     if (recursive) {
       const stack = [path];
       while (stack.length) {
@@ -434,12 +513,16 @@ class IndexedDbFS {
         if (e.type === 'dir') {
           for (const name of e.children) stack.push(normalizePath(cur + '/' + name));
         }
-        if (cur !== path) delete this.index.entries[cur];
+        delete this.index.entries[cur];
+        toDelete.push(cur);
       }
+    } else {
+      delete this.index.entries[path];
+      toDelete.push(path);
     }
-    delete this.index.entries[path];
-    this._unlinkFromParent(path);
-    this._save();
+    const p = this._unlinkFromParent(path);
+    const puts = p ? [p] : [];
+    this._save(puts, toDelete);
   }
 
   renameSync(oldPath, newPath) {
@@ -453,18 +536,26 @@ class IndexedDbFS {
     const pEntry = this.index.entries[newParent];
     if (!pEntry || pEntry.type !== 'dir') throw this._enoent('ENOENT', newParent);
 
+    const toPut = new Set();
+    const toDelete = new Set();
     if (this.index.entries[newPath]) {
       if (this.index.entries[newPath].type === 'dir') {
         const err = new Error(`EISDIR: illegal operation on a directory, ${newPath}`); err.code = 'EISDIR'; throw err;
       }
+      toDelete.add(newPath);
       delete this.index.entries[newPath];
     }
 
     this.index.entries[newPath] = entry;
     delete this.index.entries[oldPath];
 
-    this._unlinkFromParent(oldPath);
-    this._linkIntoParent(newPath);
+    toDelete.add(oldPath);
+    toPut.add(newPath);
+
+    const oldParent = this._unlinkFromParent(oldPath);
+    const newParent2 = this._linkIntoParent(newPath);
+    if (oldParent) toPut.add(oldParent);
+    if (newParent2) toPut.add(newParent2);
 
     if (entry.type === 'dir') {
       const toFix = [];
@@ -476,11 +567,14 @@ class IndexedDbFS {
         const target = normalizePath(newPath + rel);
         this.index.entries[target] = this.index.entries[oldChild];
         delete this.index.entries[oldChild];
+        toDelete.add(oldChild);
+        toPut.add(target);
       }
     }
 
     entry.mtimeMs = nowMs();
-    this._save();
+    toPut.add(newPath);
+    this._save([...toPut], [...toDelete]);
   }
 
   statSync(path) {

package/src/generated/licenseBundle.js

@@ -0,0 +1,2 @@
+// Auto-generated by scripts/generateLicenseBundle.js
+export const LICENSE_BUNDLE_TEXT = "brep-io-kernel License\nLicense: SEE LICENSE IN LICENSE.md\n\nCopyright 2025 Autodrop3d LLC\nhttps://autodrop3d.com\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and \nassociated documentation files (the \"Software\"), to deal in the Software without restriction, \nincluding without limitation the rights to use, copy, modify, merge, publish, distribute, \nsublicense, and/or sell copies of the Software, and to permit persons to whom the Software is \nfurnished to do so, subject to the following conditions:\n\n1. Any modifications made to the Software must be submitted to Autodrop3d LLC with an irrevocable \n   assignment of the copyright via git pull request. This is intended to allow Autodrop3d LLC to \n   sell commercial licenses of the Software for use in proprietary products under a \n   dual-licensing strategy. Failure to contribute back modifications without a commercial \n   license purchased from Autodrop3d LLC voids all permissions granted by this license.\n\n2. If Autodrop3d LLC is sold, merged, transferred, or otherwise succeeded by any entity or \n   individual, all rights and obligations described in this license shall transfer automatically \n   to that successor entity or individual.\n\n3. If Autodrop3d LLC ceases operations or dissolves, and no successor entity or individual \n   continues to publicly host the Software in a manner that allows the public to obtain the source \n   code and submit contributions for a period of at least eighteen (18) consecutive months, then \n   Clauses 1 and 2 of this license shall be automatically and irrevocably canceled.\n\nThe above copyright notice and these permission notices shall be included in all copies or \nsubstantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING \nBUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND \nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, \nDAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, \nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\nThird-party licenses (production dependencies)\n55 packages • 9 license types\nGenerated from: pnpm licenses list --prod --long --json\n\n(MIT AND Zlib) (1 package)\n- pako@1.0.11 — zlib port to javascript - fast, modularized, with browser support — https://github.com/nodeca/pako\n\n(MIT OR GPL-3.0-or-later) (1 package)\n- jszip@3.10.1 — Create, read and edit .zip files with JavaScript http://stuartk.com/jszip — Author: Stuart Knightley — https://github.com/Stuk/jszip#readme\n\n(MPL-2.0 OR Apache-2.0) (1 package)\n- dompurify@3.2.7 — DOMPurify is a DOM-only, super-fast, uber-tolerant XSS sanitizer for HTML, MathML and SVG. It's written in JavaScript and works in all modern browsers (Safari, Opera (15+), Internet Explorer (10+), Firefox and Chrome - as well as almost anything else using Blink or WebKit). DOMPurify is written by security people who have vast background in web attacks and XSS. Fear not. — Author: Dr.-Ing. Mario Heiderich, Cure53 — https://github.com/cure53/DOMPurify\n\nApache-2.0 (5 packages)\n- @img/sharp-linux-x64@0.34.5 — Prebuilt sharp for use with Linux (glibc) x64 — Author: Lovell Fuller — https://sharp.pixelplumbing.com\n- @img/sharp-linuxmusl-x64@0.34.5 — Prebuilt sharp for use with Linux (musl) x64 — Author: Lovell Fuller — https://sharp.pixelplumbing.com\n- detect-libc@2.1.2 — Node.js module to detect the C standard library (libc) implementation family and version — Author: Lovell Fuller — https://github.com/lovell/detect-libc#readme\n- manifold-3d@3.3.2 — Geometry library for topological robustness — https://github.com/elalish/manifold#readme\n- sharp@0.34.5 — High performance Node.js image processing, the fastest module to resize JPEG, PNG, WebP, GIF, AVIF and TIFF images — Author: Lovell Fuller — https://sharp.pixelplumbing.com\n\nbsd-2-clause (1 package)\n- esbuild-plugin-text-replace@1.3.0 — Replace Text with Regex in files before bundling. — Author: Andreas Heissenberger — https://github.com/aheissenberger/esbuild-plugin-text-replace\n\nISC (2 packages)\n- inherits@2.0.4 — Browser-friendly inheritance fully compatible with standard node.js inherits() — https://github.com/isaacs/inherits#readme\n- semver@7.7.3 — The semantic version parser used by npm. — Author: GitHub Inc. — https://github.com/npm/node-semver#readme\n\nLGPL-3.0-or-later (2 packages)\n- @img/sharp-libvips-linux-x64@1.2.4 — Prebuilt libvips and dependencies for use with sharp on Linux (glibc) x64 — Author: Lovell Fuller — https://sharp.pixelplumbing.com\n- @img/sharp-libvips-linuxmusl-x64@1.2.4 — Prebuilt libvips and dependencies for use with sharp on Linux (musl) x64 — Author: Lovell Fuller — https://sharp.pixelplumbing.com\n\nMIT (41 packages)\n- @gltf-transform/core@4.3.0 — glTF 2.0 SDK for JavaScript and TypeScript, on Web and Node.js. — Author: Don McCurdy — https://gltf-transform.dev/\n- @gltf-transform/extensions@4.3.0 — Adds extension support to @gltf-transform/core — Author: Don McCurdy — https://gltf-transform.dev/extensions.html\n- @gltf-transform/functions@4.3.0 — Functions for common glTF modifications, written using the core API — Author: Don McCurdy — https://gltf-transform.dev/functions.html\n- @img/colour@1.0.0 — The ESM-only 'color' package made compatible for use with CommonJS runtimes — https://github.com/lovell/colour#readme\n- @jridgewell/resolve-uri@3.1.2 — Resolve a URI relative to an optional base URI — Author: Justin Ridgewell — https://github.com/jridgewell/resolve-uri#readme\n- @jridgewell/sourcemap-codec@1.5.5 — Encode/decode sourcemap mappings — Author: Justin Ridgewell — https://github.com/jridgewell/sourcemaps/tree/main/packages/sourcemap-codec\n- @jridgewell/trace-mapping@0.3.31 — Trace the original position through a source map — Author: Justin Ridgewell — https://github.com/jridgewell/sourcemaps/tree/main/packages/trace-mapping\n- @jscadui/3mf-export@0.5.0 — 3mf export\n- @tarikjabiri/dxf@2.8.9 — A JavaScript interface to Dxf written in TypeScript. — Author: Tarik EL JABIRI — https://dxf.vercel.app\n- @types/ndarray@1.0.14 — TypeScript definitions for ndarray — https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/ndarray\n- @types/trusted-types@2.0.7 — TypeScript definitions for trusted-types — https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/trusted-types\n- commander@13.1.0 — the complete solution for node.js command-line programs — Author: TJ Holowaychuk — https://github.com/tj/commander.js#readme\n- convert-source-map@2.0.0 — Converts a source-map from/to  different formats and allows adding/changing properties. — Author: Thorsten Lorenz — https://github.com/thlorenz/convert-source-map\n- core-js@3.48.0 — Standard library — Author: Denis Pushkarev — https://core-js.io\n- core-util-is@1.0.3 — The `util.is*` functions introduced in Node v0.12. — Author: Isaac Z. Schlueter — https://github.com/isaacs/core-util-is#readme\n- cwise-compiler@1.1.3 — cwise's internal compiler — Author: Mikola Lysenko — https://github.com/scijs/cwise-compiler#readme\n- esbuild-wasm@0.25.12 — The cross-platform WebAssembly binary for esbuild, a JavaScript bundler. — https://github.com/evanw/esbuild#readme\n- fflate@0.8.2 — High performance (de)compression in an 8kB package — Author: Arjun Barrett — https://101arrowz.github.io/fflate\n- immediate@3.0.6 — A cross browser microtask library — https://github.com/calvinmetcalf/immediate#readme\n- iota-array@1.0.0 — Generates an array of consecutive integers starting at 0 — Author: Mikola Lysenko — https://github.com/mikolalysenko/iota-array#readme\n- is-buffer@1.1.6 — Determine if an object is a Buffer — Author: Feross Aboukhadijeh — https://github.com/feross/is-buffer#readme\n- isarray@1.0.0 — Array#isArray for older browsers — Author: Julian Gruber — https://github.com/juliangruber/isarray\n- ktx-parse@1.1.0 — KTX 2.0 (.ktx2) parser and serializer. — Author: Don McCurdy — https://github.com/donmccurdy/ktx-parse#readme\n- lie@3.3.0 — A basic but performant promise implementation — https://github.com/calvinmetcalf/lie#readme\n- marked@14.0.0 — A markdown parser built for speed — Author: Christopher Jeffrey — https://marked.js.org\n- monaco-editor@0.55.1 — A browser based code editor — Author: Microsoft Corporation — https://github.com/microsoft/monaco-editor\n- ndarray@1.0.19 — Multidimensional Arrays — Author: Mikola Lysenko — https://github.com/mikolalysenko/ndarray#readme\n- ndarray-lanczos@0.3.0 — Resize an ndarray with Lanczos resampling — Author: Don McCurdy — https://github.com/donmccurdy/ndarray-lanczos#readme\n- ndarray-ops@1.2.2 — Common operations for ndarray arrays — Author: Mikola Lysenko — https://github.com/mikolalysenko/ndarray-ops#readme\n- ndarray-pixels@5.0.1 — ndarray-pixels — Author: Don McCurdy — https://github.com/donmccurdy/ndarray-pixels#readme\n- process-nextick-args@2.0.1 — process.nextTick but always with args — https://github.com/calvinmetcalf/process-nextick-args\n- property-graph@4.0.0 — Base for creating objects that behave like a Property Graph. — Author: Don McCurdy — https://github.com/donmccurdy/property-graph#readme\n- readable-stream@2.3.8 — Streams3, a user-land copy of the stream library from Node.js — https://github.com/nodejs/readable-stream#readme\n- safe-buffer@5.1.2 — Safer Node.js Buffer API — Author: Feross Aboukhadijeh — https://github.com/feross/safe-buffer\n- setimmediate@1.0.5 — A shim for the setImmediate efficient script yielding API — Author: YuzuJS — https://github.com/YuzuJS/setImmediate#readme\n- string_decoder@1.1.1 — The string_decoder module from Node core — https://github.com/nodejs/string_decoder\n- three@0.182.0 — JavaScript 3D library — Author: mrdoob — https://threejs.org/\n- three-mesh-bvh@0.9.8 — A BVH implementation to speed up raycasting against three.js meshes. — Author: Garrett Johnson — https://github.com/gkjohnson/three-mesh-bvh#readme\n- ts-replace-all@1.0.0 — https://github.com/LinusU/ts-replace-all#readme\n- uniq@1.0.1 — Removes duplicates from a sorted array in place — Author: Mikola Lysenko — https://github.com/mikolalysenko/uniq#readme\n- util-deprecate@1.0.2 — The Node.js `util.deprecate()` function with browser support — Author: Nathan Rajlich — https://github.com/TooTallNate/util-deprecate\n\nSGI-B-2.0 (1 package)\n- tess2@1.0.0 — GLU tesselator ported to Javascript, performs polygon boolean operations and triangulation — Author: Matt DesLauriers — https://github.com/memononen/tess2.js";