create-ifc-lite 1.14.13 → 1.15.0

package/dist/index.js

@@ -2,22 +2,53 @@
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
-import { existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { existsSync, mkdirSync, rmSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
 import { createBasicTemplate } from './templates/basic.js';
 import { createThreejsTemplate } from './templates/threejs.js';
 import { createBabylonjsTemplate } from './templates/babylonjs.js';
 import { createReactTemplate } from './templates/react.js';
 import { createServerTemplate } from './templates/server.js';
 import { createServerNativeTemplate } from './templates/server-native.js';
+/** Every template, mapped to the function that scaffolds it. */
 const TEMPLATES = {
-    basic: 'basic',
-    threejs: 'threejs',
-    babylonjs: 'babylonjs',
-    react: 'react',
-    server: 'server',
-    'server-native': 'server-native',
+    basic: createBasicTemplate,
+    threejs: createThreejsTemplate,
+    babylonjs: createBabylonjsTemplate,
+    react: createReactTemplate,
+    server: createServerTemplate,
+    'server-native': createServerNativeTemplate,
 };
+const TEMPLATE_NAMES = Object.keys(TEMPLATES);
+/**
+ * `name in TEMPLATES` walks the prototype chain, so `--template toString`
+ * passed the guard and then matched no branch, silently scaffolding `basic`.
+ */
+function isTemplate(name) {
+    return Object.hasOwn(TEMPLATES, name);
+}
+/**
+ * Read this package's own version. A failure here is a broken install, not a
+ * normal condition, so report it and return a value that reads as unknown
+ * rather than a plausible number a bug report would then carry — the same
+ * lesson `@ifc-lite/cli`'s `readCliVersion` records.
+ */
+function readOwnVersion() {
+    const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        const version = pkg.version;
+        if (typeof version === 'string' && version.length > 0)
+            return version;
+    }
+    catch (err) {
+        console.error(`Warning: could not read ${pkgPath} (${err instanceof Error ? err.message : String(err)}).`);
+        return '0.0.0-unknown';
+    }
+    console.error(`Warning: ${pkgPath} declares no "version".`);
+    return '0.0.0-unknown';
+}
 function printUsage() {
     console.log(`
   create-ifc-lite - Create IFC-Lite projects instantly
@@ -26,8 +57,9 @@ function printUsage() {
     npx create-ifc-lite [project-name] [options]
 
   Options:
-    --template <type>   Template to use [default: basic]
-    --help              Show this help message
+    -t, --template <type>   Template to use [default: basic]
+    -v, --version           Print the create-ifc-lite version
+    -h, --help              Show this help message
 
   Examples:
     npx create-ifc-lite my-ifc-app
@@ -52,25 +84,38 @@ async function main() {
         printUsage();
         process.exit(0);
     }
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log(readOwnVersion());
+        process.exit(0);
+    }
     // Parse arguments
-    let projectName = 'my-ifc-app';
+    let projectName;
     let template = 'basic';
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (arg === '--template' || arg === '-t') {
-            const t = args[++i];
-            if (t && t in TEMPLATES) {
-                template = t;
-            }
-            else {
-                console.error(`Invalid template: ${t}. Available: basic, threejs, babylonjs, react, server, server-native`);
+            const value = args[++i];
+            if (value === undefined || !isTemplate(value)) {
+                console.error(`Invalid template: ${value ?? '(missing)'}. Available: ${TEMPLATE_NAMES.join(', ')}`);
                 process.exit(1);
             }
+            template = value;
+        }
+        else if (arg.startsWith('-')) {
+            // Previously ignored, which made `--templat react` scaffold a project
+            // literally named "react" instead of reporting the typo.
+            console.error(`Unknown option: ${arg}\nRun \`npx create-ifc-lite --help\` to see the available options.`);
+            process.exit(1);
         }
-        else if (!arg.startsWith('-')) {
+        else if (projectName === undefined) {
             projectName = arg;
         }
+        else {
+            console.error(`Unexpected argument: ${arg}. Only one project name is accepted.`);
+            process.exit(1);
+        }
     }
+    projectName ??= 'my-ifc-app';
     // Reject path separators, '..', and names that would yield an invalid npm
     // `name`, so join(process.cwd(), projectName) stays under cwd and the
     // generated package.json is valid. Mirrors config-fixers.ts VALID_PACKAGE_NAME.
@@ -89,35 +134,22 @@ async function main() {
         process.exit(1);
     }
     console.log(`\n  Creating IFC-Lite project in ${targetDir}...\n`);
-    if (template === 'threejs') {
-        mkdirSync(targetDir, { recursive: true });
-        createThreejsTemplate(targetDir, projectName);
+    mkdirSync(targetDir, { recursive: true });
+    try {
+        TEMPLATES[template](targetDir, projectName);
     }
-    else if (template === 'babylonjs') {
-        mkdirSync(targetDir, { recursive: true });
-        createBabylonjsTemplate(targetDir, projectName);
-    }
-    else if (template === 'react') {
-        mkdirSync(targetDir, { recursive: true });
-        createReactTemplate(targetDir, projectName);
-    }
-    else if (template === 'server') {
-        mkdirSync(targetDir, { recursive: true });
-        createServerTemplate(targetDir, projectName);
-    }
-    else if (template === 'server-native') {
-        mkdirSync(targetDir, { recursive: true });
-        createServerNativeTemplate(targetDir, projectName);
-    }
-    else {
-        mkdirSync(targetDir, { recursive: true });
-        createBasicTemplate(targetDir, projectName);
+    catch (error) {
+        // Templates resolve their dependency versions from the npm registry as
+        // their first act, so an offline run fails AFTER the directory exists.
+        // Leaving it behind made the obvious retry fail with "already exists".
+        rmSync(targetDir, { recursive: true, force: true });
+        throw error;
     }
     console.log(`  Done! Next steps:\n`);
     console.log(`    cd ${projectName}`);
     if (template === 'server') {
         console.log(`    docker compose up -d`);
-        console.log(`    npm install && npm run example`);
+        console.log(`    npm install && npm run example ./your-model.ifc`);
         console.log(`\n  Server will be available at http://localhost:3001`);
     }
     else if (template === 'server-native') {
@@ -137,6 +169,15 @@ async function main() {
     console.log();
 }
 main().catch((error) => {
-    console.error(error instanceof Error ? `\n  ${error.message}\n` : error);
+    if (error instanceof Error) {
+        console.error(`\n  ${error.message}`);
+        const cause = error.cause;
+        if (cause instanceof Error)
+            console.error(`  Caused by: ${cause.message}`);
+        console.error();
+    }
+    else {
+        console.error(error);
+    }
     process.exit(1);
 });

package/dist/templates/babylonjs.js

@@ -4,6 +4,7 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { getPackageVersion } from '../utils/config-fixers.js';
+import { writeGitignore } from '../utils/gitignore.js';
 /**
  * Scaffold a Babylon.js IFC viewer project using @ifc-lite/geometry.
  * No WebGPU required — renders via Babylon.js WebGL Engine.
@@ -20,7 +21,7 @@ export function createBabylonjsTemplate(targetDir, projectName) {
             dev: 'vite',
             build: 'tsc && vite build',
             preview: 'vite preview',
-            postinstall: 'node ./scripts/fix-ifc-lite-geometry-worker.mjs',
+            typecheck: 'tsc --noEmit',
         },
         dependencies: {
             '@ifc-lite/geometry': geometryVersion,
@@ -40,7 +41,7 @@ export function createBabylonjsTemplate(targetDir, projectName) {
             strict: true,
             esModuleInterop: true,
             skipLibCheck: true,
-            outDir: 'dist',
+            noEmit: true,
         },
         include: ['src'],
     }, null, 2));
@@ -83,7 +84,7 @@ export default defineConfig({
     <header>
       <h1>${projectName}</h1>
       <input type="file" id="file-input" accept=".ifc" />
-      <span id="status">Drop an IFC file to view</span>
+      <span id="status">Choose an IFC file to view</span>
     </header>
     <div id="canvas-container">
       <canvas id="viewer"></canvas>
@@ -95,24 +96,6 @@ export default defineConfig({
 `);
     // src/
     mkdirSync(join(targetDir, 'src'));
-    mkdirSync(join(targetDir, 'scripts'));
-    // scripts/fix-ifc-lite-geometry-worker.mjs
-    writeFileSync(join(targetDir, 'scripts', 'fix-ifc-lite-geometry-worker.mjs'), `import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-
-const entryPath = path.join(process.cwd(), 'node_modules', '@ifc-lite', 'geometry', 'dist', 'index.js');
-
-if (!existsSync(entryPath)) {
-  process.exit(0);
-}
-
-const source = readFileSync(entryPath, 'utf8');
-const patched = source.replace(/geometry\\.worker\\.ts/g, 'geometry.worker.js');
-
-if (patched !== source) {
-  writeFileSync(entryPath, patched);
-}
-`);
     // src/ifc-to-babylon.ts
     writeFileSync(join(targetDir, 'src', 'ifc-to-babylon.ts'), `import {
   Mesh, VertexData, StandardMaterial, Color3,
@@ -132,13 +115,23 @@ export function meshDataToBabylon(meshData: MeshData, scene: Scene): Mesh {
   vertexData.indices = meshData.indices;
   vertexData.applyToMesh(mesh);
 
+  // Fold the per-element local frame: \`positions\` are relative to \`origin\`,
+  // so the world position of vertex i is origin + positions[3i..3i+3]. Most
+  // elements carry one (it is what keeps building-scale coordinates inside f32
+  // precision); dropping it scatters every element to its local offset.
+  if (meshData.origin) {
+    mesh.position.set(meshData.origin[0], meshData.origin[1], meshData.origin[2]);
+  }
+
   const [r, g, b, a] = meshData.color;
   const material = new StandardMaterial('mat-' + meshData.expressId, scene);
   material.diffuseColor = new Color3(r, g, b);
   material.specularColor = new Color3(0.15, 0.15, 0.15);
+  // Double-sided even when opaque: IFC triangle winding isn't reliably outward,
+  // so culling back faces punches holes in walls and slabs.
+  material.backFaceCulling = false;
   if (a < 1) {
     material.alpha = a;
-    material.backFaceCulling = false;
   }
 
   mesh.material = material;
@@ -241,12 +234,13 @@ fileInput.addEventListener('change', async () => {
         status.textContent = file.name + ' — ' + event.totalMeshes + ' meshes';
       }
     }
-  } catch (err: any) {
-    status.textContent = 'Error: ' + err.message;
+  } catch (err) {
+    status.textContent = 'Error: ' + (err instanceof Error ? err.message : String(err));
     console.error(err);
   }
 });
 `);
+    writeGitignore(targetDir);
     // README
     writeFileSync(join(targetDir, 'README.md'), `# ${projectName}
 
@@ -259,10 +253,13 @@ npm install
 npm run dev
 \`\`\`
 
-Open http://localhost:3000 and drop an IFC file.
+Open the URL Vite prints (http://localhost:5173 by default) and pick an IFC file.
+
+No IFC file handy? [AC20-FZK-Haus.ifc](https://github.com/LTplus-AG/ifc-lite/releases/download/fixtures-v1/ea6f04eaf92fac4d7ad0038bc3d2dfea4c094dd3f516ecc33c50bf1835ca108d) is a small public test model.
 
 ## Learn More
 
-- [IFC-Lite Documentation](https://ifclite.dev/docs/)
+- [IFClite Documentation](https://ifclite.dev/docs/)
+- [Babylon.js Integration Guide](https://ifclite.dev/docs/tutorials/babylonjs-integration/)
 `);
 }

package/dist/templates/basic.js

@@ -4,21 +4,28 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { getPackageVersion } from '../utils/config-fixers.js';
+import { writeGitignore } from '../utils/gitignore.js';
 /**
  * Scaffold a minimal TypeScript project for parsing IFC files.
  */
 export function createBasicTemplate(targetDir, projectName) {
     const parserVersion = getPackageVersion('@ifc-lite/parser');
+    // `store.entityIndex.byType` is keyed by the raw STEP spelling, and the
+    // PascalCase lookup table for it lives in @ifc-lite/data.
+    const dataVersion = getPackageVersion('@ifc-lite/data');
     // package.json
     writeFileSync(join(targetDir, 'package.json'), JSON.stringify({
         name: projectName,
-        version: parserVersion.replace('^', ''),
+        version: '0.1.0',
+        private: true,
         type: 'module',
         scripts: {
-            parse: 'npx tsx src/index.ts',
+            parse: 'tsx src/index.ts',
             build: 'tsc',
+            typecheck: 'tsc --noEmit',
         },
         dependencies: {
+            '@ifc-lite/data': dataVersion,
             '@ifc-lite/parser': parserVersion,
         },
         devDependencies: {
@@ -44,7 +51,8 @@ export function createBasicTemplate(targetDir, projectName) {
     // src/index.ts
     mkdirSync(join(targetDir, 'src'));
     writeFileSync(join(targetDir, 'src', 'index.ts'), `import { IfcParser } from '@ifc-lite/parser';
-import { readFileSync } from 'fs';
+import { IFC_ENTITY_NAMES } from '@ifc-lite/data';
+import { existsSync, readFileSync } from 'fs';
 
 // Example: Parse an IFC file
 const ifcPath = process.argv[2];
@@ -57,7 +65,13 @@ if (!ifcPath) {
   process.exit(1);
 }
 
-// readFileSync returns a Node Buffer (Uint8Array subclass); extract the underlying ArrayBuffer
+if (!existsSync(ifcPath)) {
+  console.error(\`File not found: \${ifcPath}\`);
+  process.exit(1);
+}
+
+// readFileSync returns a Node Buffer (Uint8Array subclass) that may be a view
+// into a larger pooled allocation, so slice out just this file's bytes.
 const nodeBuffer = readFileSync(ifcPath);
 const buffer = nodeBuffer.buffer.slice(
   nodeBuffer.byteOffset,
@@ -67,14 +81,27 @@ const buffer = nodeBuffer.buffer.slice(
 const parser = new IfcParser();
 
 console.log('Parsing IFC file...');
-parser.parseColumnar(buffer).then(store => {
+
+try {
+  const store = await parser.parseColumnar(buffer);
+
+  // parseColumnar tolerates garbage input rather than throwing, so an empty
+  // store is how "that wasn't an IFC file" actually arrives.
+  if (store.entityCount === 0) {
+    throw new Error(\`No IFC entities found in \${ifcPath} — is it a STEP/IFC file?\`);
+  }
+
   console.log('\\nFile parsed successfully!');
   console.log(\`  Entities: \${store.entityCount}\`);
   console.log(\`  Schema: \${store.schemaVersion}\`);
 
-  // Count by type
+  // Count by type. \`entityIndex.byType\` is keyed by the raw STEP spelling
+  // (IFCWALLSTANDARDCASE); IFC_ENTITY_NAMES maps that to the canonical IFC
+  // EXPRESS name (IfcWallStandardCase), which is what belongs in front of a
+  // user. Geometry resource entities are not in \`store.entities\`, so the
+  // per-entity \`getTypeName\` would answer 'Unknown' for most of this list.
   const typeCounts = [...store.entityIndex.byType.entries()]
-    .map(([type, ids]) => [type, ids.length] as const)
+    .map(([stepName, ids]) => [IFC_ENTITY_NAMES[stepName] ?? stepName, ids.length] as const)
     .sort((a, b) => b[1] - a[1])
     .slice(0, 10);
 
@@ -82,8 +109,12 @@ parser.parseColumnar(buffer).then(store => {
   for (const [type, count] of typeCounts) {
     console.log(\`  \${type}: \${count}\`);
   }
-});
+} catch (error) {
+  console.error(\`\\nFailed to parse \${ifcPath}: \${error instanceof Error ? error.message : String(error)}\`);
+  process.exitCode = 1;
+}
 `);
+    writeGitignore(targetDir);
     // README
     writeFileSync(join(targetDir, 'README.md'), `# ${projectName}
 
@@ -99,6 +130,6 @@ npm run parse ./your-model.ifc
 ## Learn More
 
 - [IFC-Lite Documentation](https://ifclite.dev/docs/)
-- [API Reference](https://ifclite.dev/docs/api/)
+- [TypeScript API Reference](https://ifclite.dev/docs/api/typescript/)
 `);
 }

package/dist/templates/react.js

@@ -4,14 +4,7 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { getPackageVersion } from '../utils/config-fixers.js';
-const LICENSE_HEADER = `/* This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
-
-`;
-function writeSourceFile(targetDir, relativePath, content) {
-    writeFileSync(join(targetDir, relativePath), `${LICENSE_HEADER}${content}`);
-}
+import { writeGitignore } from '../utils/gitignore.js';
 /**
  * Scaffold a standalone React + Vite WebGPU viewer.
  */
@@ -38,9 +31,9 @@ export function createReactTemplate(targetDir, projectName) {
         devDependencies: {
             '@types/react': '^18.2.0',
             '@types/react-dom': '^18.2.0',
-            '@vitejs/plugin-react': '^4.2.0',
+            '@vitejs/plugin-react': '^5.0.0',
             typescript: '^5.3.0',
-            vite: '^5.0.0',
+            vite: '^7.0.0',
         },
     }, null, 2));
     writeFileSync(join(targetDir, 'tsconfig.json'), JSON.stringify({
@@ -61,7 +54,7 @@ export function createReactTemplate(targetDir, projectName) {
         },
         include: ['src'],
     }, null, 2));
-    writeSourceFile(targetDir, 'vite.config.ts', `import { defineConfig } from 'vite';
+    writeFileSync(join(targetDir, 'vite.config.ts'), `import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 
 const isolationHeaders = {
@@ -96,7 +89,7 @@ export default defineConfig({
 </html>
 `);
     mkdirSync(join(targetDir, 'src'));
-    writeSourceFile(targetDir, 'src/main.tsx', `import React from 'react';
+    writeFileSync(join(targetDir, 'src/main.tsx'), `import React from 'react';
 import ReactDOM from 'react-dom/client';
 import App from './App.js';
 import './styles.css';
@@ -107,7 +100,7 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
   </React.StrictMode>,
 );
 `);
-    writeSourceFile(targetDir, 'src/App.tsx', `import { useCallback, useEffect, useRef, useState, type ChangeEvent, type DragEvent } from 'react';
+    writeFileSync(join(targetDir, 'src/App.tsx'), `import { useCallback, useEffect, useRef, useState, type ChangeEvent, type DragEvent } from 'react';
 import { GeometryProcessor } from '@ifc-lite/geometry';
 import { Renderer } from '@ifc-lite/renderer';
 
@@ -402,7 +395,7 @@ export default function App() {
   );
 }
 `);
-    writeSourceFile(targetDir, 'src/styles.css', `:root {
+    writeFileSync(join(targetDir, 'src/styles.css'), `:root {
   color-scheme: dark;
   font-family: Inter, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
   background: #0b1220;
@@ -555,6 +548,7 @@ body {
   }
 }
 `);
+    writeGitignore(targetDir);
     writeFileSync(join(targetDir, 'README.md'), `# ${projectName}
 
 React + Vite IFC viewer using [IFC-Lite](https://github.com/LTplus-AG/ifc-lite).

package/dist/templates/server-native.js

@@ -15,6 +15,7 @@ export function createServerNativeTemplate(targetDir, projectName) {
     writeFileSync(join(targetDir, 'package.json'), JSON.stringify({
         name: projectName,
         version: '0.1.0',
+        private: true,
         type: 'module',
         description: 'IFC processing server (native binary) with TypeScript client',
         scripts: {

package/dist/templates/server.js

@@ -15,7 +15,7 @@ export function createServerTemplate(targetDir, projectName) {
 
 services:
   ifc-server:
-    image: ghcr.io/LTplus-AG/ifc-lite-server:latest
+    image: ghcr.io/ltplus-ag/ifc-lite-server:latest
     container_name: ${projectName}-server
     ports:
       - "\${PORT:-3001}:8080"
@@ -47,7 +47,7 @@ volumes:
 
 services:
   ifc-server:
-    image: ghcr.io/LTplus-AG/ifc-lite-server:latest
+    image: ghcr.io/ltplus-ag/ifc-lite-server:latest
     container_name: ${projectName}-server-dev
     ports:
       - "\${PORT:-3001}:8080"
@@ -167,6 +167,7 @@ cache
     writeFileSync(join(targetDir, 'package.json'), JSON.stringify({
         name: projectName,
         version: '0.1.0',
+        private: true,
         type: 'module',
         description: 'IFC processing server with TypeScript client',
         scripts: {
@@ -585,8 +586,8 @@ The Docker image works on any container platform:
 
 \`\`\`bash
 # Pull and run
-docker pull ghcr.io/LTplus-AG/ifc-lite-server:latest
-docker run -p 8080:8080 -v ifc-cache:/app/cache ghcr.io/LTplus-AG/ifc-lite-server
+docker pull ghcr.io/ltplus-ag/ifc-lite-server:latest
+docker run -p 8080:8080 -v ifc-cache:/app/cache ghcr.io/ltplus-ag/ifc-lite-server
 \`\`\`
 
 ### Environment Variables
@@ -604,7 +605,7 @@ RUST_LOG=info
 ## Learn More
 
 - [IFC-Lite Documentation](https://ifclite.dev/docs/)
-- [Server API Reference](https://ifclite.dev/docs/api/server/)
+- [Server Guide](https://ifclite.dev/docs/guide/server/)
 - [GitHub Repository](https://github.com/LTplus-AG/ifc-lite)
 `);
     console.log('  Created docker-compose.yml');

package/dist/templates/threejs.js

@@ -4,6 +4,7 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { getPackageVersion } from '../utils/config-fixers.js';
+import { writeGitignore } from '../utils/gitignore.js';
 /**
  * Scaffold a Three.js IFC viewer project using @ifc-lite/geometry.
  * No WebGPU required — renders via Three.js WebGLRenderer.
@@ -20,7 +21,7 @@ export function createThreejsTemplate(targetDir, projectName) {
             dev: 'vite',
             build: 'tsc && vite build',
             preview: 'vite preview',
-            postinstall: 'node ./scripts/fix-ifc-lite-geometry-worker.mjs',
+            typecheck: 'tsc --noEmit',
         },
         dependencies: {
             '@ifc-lite/geometry': geometryVersion,
@@ -41,7 +42,7 @@ export function createThreejsTemplate(targetDir, projectName) {
             strict: true,
             esModuleInterop: true,
             skipLibCheck: true,
-            outDir: 'dist',
+            noEmit: true,
         },
         include: ['src'],
     }, null, 2));
@@ -89,7 +90,7 @@ export default defineConfig({
     <header>
       <h1>${projectName}</h1>
       <input type="file" id="file-input" accept=".ifc" />
-      <span id="status">Drop an IFC file to view</span>
+      <span id="status">Choose an IFC file to view</span>
     </header>
     <div id="canvas-container">
       <canvas id="viewer"></canvas>
@@ -101,24 +102,6 @@ export default defineConfig({
 `);
     // src/
     mkdirSync(join(targetDir, 'src'));
-    mkdirSync(join(targetDir, 'scripts'));
-    // scripts/fix-ifc-lite-geometry-worker.mjs
-    writeFileSync(join(targetDir, 'scripts', 'fix-ifc-lite-geometry-worker.mjs'), `import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-
-const entryPath = path.join(process.cwd(), 'node_modules', '@ifc-lite', 'geometry', 'dist', 'index.js');
-
-if (!existsSync(entryPath)) {
-  process.exit(0);
-}
-
-const source = readFileSync(entryPath, 'utf8');
-const patched = source.replace(/geometry\\.worker\\.ts/g, 'geometry.worker.js');
-
-if (patched !== source) {
-  writeFileSync(entryPath, patched);
-}
-`);
     // src/ifc-to-threejs.ts
     writeFileSync(join(targetDir, 'src', 'ifc-to-threejs.ts'), `import * as THREE from 'three';
 import type { MeshData } from '@ifc-lite/geometry';
@@ -145,6 +128,11 @@ export function meshDataToThree(mesh: MeshData): THREE.Mesh {
   });
 
   const threeMesh = new THREE.Mesh(geometry, material);
+  // Fold the per-element local frame: \`positions\` are relative to \`origin\`,
+  // so the world position of vertex i is origin + positions[3i..3i+3]. Most
+  // elements carry one (it is what keeps building-scale coordinates inside f32
+  // precision); dropping it scatters every element to its local offset.
+  if (mesh.origin) threeMesh.position.fromArray(mesh.origin);
   threeMesh.userData.expressId = mesh.expressId;
   return threeMesh;
 }
@@ -260,12 +248,13 @@ fileInput.addEventListener('change', async () => {
         status.textContent = file.name + ' — ' + event.totalMeshes + ' meshes';
       }
     }
-  } catch (err: any) {
-    status.textContent = 'Error: ' + err.message;
+  } catch (err) {
+    status.textContent = 'Error: ' + (err instanceof Error ? err.message : String(err));
     console.error(err);
   }
 });
 `);
+    writeGitignore(targetDir);
     // README
     writeFileSync(join(targetDir, 'README.md'), `# ${projectName}
 
@@ -278,7 +267,9 @@ npm install
 npm run dev
 \`\`\`
 
-Open http://localhost:3000 and drop an IFC file.
+Open the URL Vite prints (http://localhost:5173 by default) and pick an IFC file.
+
+No IFC file handy? [AC20-FZK-Haus.ifc](https://github.com/LTplus-AG/ifc-lite/releases/download/fixtures-v1/ea6f04eaf92fac4d7ad0038bc3d2dfea4c094dd3f516ecc33c50bf1835ca108d) is a small public test model.
 
 ## Learn More
 

package/dist/utils/config-fixers.js

@@ -3,13 +3,15 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
 import { existsSync, readFileSync, writeFileSync, rmSync } from 'fs';
 import { join } from 'path';
-import { execFileSync } from 'child_process';
+import { execFileSync, spawnSync } from 'child_process';
 /** Cache of npm-resolved versions to avoid redundant registry queries. */
 const versionCache = new Map();
 const publishedVersionsCache = new Map();
 const VALID_PACKAGE_NAME = /^(?:@[\w.-]+\/)?[\w.-]+$/;
 const NPM_TIMEOUT_MS = 30000;
 const MAX_VERSION_CANDIDATES = 10;
+/** npm's own codes for "the registry does not have that artifact". */
+const MISSING_ARTIFACT_CODE = /\bE(404|410)\b/;
 function readJsonFromNpm(args) {
     const command = process.platform === 'win32' ? process.env.ComSpec ?? 'cmd.exe' : 'npm';
     const commandArgs = process.platform === 'win32' ? ['/d', '/s', '/c', 'npm', ...args] : args;
@@ -43,6 +45,31 @@ function getVersionDependencies(packageName, version) {
     }
     return json;
 }
+/**
+ * Is the version's own tarball actually downloadable?
+ *
+ * A version can be `dist-tags.latest`, be listed in the packument, and
+ * advertise a `dist.tarball` that 404s -- a publish that registered the
+ * version without storing the artifact. `@ifc-lite/server-client@3.1.0` was
+ * exactly that, so every `--template server` scaffold died at `npm install`
+ * with a 404 on a URL npm itself had handed it (#5570).
+ *
+ * `npm pack --dry-run` is the probe rather than a raw HTTP request because it
+ * resolves through npm's own registry, proxy and auth config, and writes
+ * nothing. Only an explicit "not there" answer rejects a candidate: a network
+ * failure or an auth wall must not silently push the scaffold back onto an
+ * older version, so anything else is treated as "cannot tell, assume fine".
+ */
+function isTarballFetchable(packageName, version) {
+    const args = ['pack', `${packageName}@${version}`, '--dry-run', '--json'];
+    const command = process.platform === 'win32' ? process.env.ComSpec ?? 'cmd.exe' : 'npm';
+    const commandArgs = process.platform === 'win32' ? ['/d', '/s', '/c', 'npm', ...args] : args;
+    const result = spawnSync(command, commandArgs, { encoding: 'utf-8', timeout: NPM_TIMEOUT_MS });
+    if (result.status === 0)
+        return true;
+    const output = `${result.stdout ?? ''}${result.stderr ?? ''}`;
+    return !MISSING_ARTIFACT_CODE.test(output);
+}
 function isInstallablePublishedVersion(packageName, version) {
     const dependencies = getVersionDependencies(packageName, version);
     for (const [dependencyName, dependencyRange] of Object.entries(dependencies)) {
@@ -55,7 +82,7 @@ function isInstallablePublishedVersion(packageName, version) {
             return false;
         }
     }
-    return true;
+    return isTarballFetchable(packageName, version);
 }
 /**
  * Fetch the latest installable published version of a specific npm package.

package/dist/utils/gitignore.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Write the .gitignore every scaffolded project needs. Without one, the first
+ * `git add .` in a fresh project commits `node_modules/` and `dist/` — and the
+ * viewer templates' `dist/` carries an 8 MB wasm bundle.
+ */
+export declare function writeGitignore(targetDir: string): void;

package/dist/utils/gitignore.js

@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+/**
+ * Write the .gitignore every scaffolded project needs. Without one, the first
+ * `git add .` in a fresh project commits `node_modules/` and `dist/` — and the
+ * viewer templates' `dist/` carries an 8 MB wasm bundle.
+ */
+export function writeGitignore(targetDir) {
+    writeFileSync(join(targetDir, '.gitignore'), `# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ifc-lite",
-  "version": "1.14.13",
+  "version": "1.15.0",
   "description": "Create IFC-Lite projects with one command",
   "type": "module",
   "bin": {
@@ -31,9 +31,9 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.6.1",
     "typescript": "^5.3.0",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.1"
   },
   "homepage": "https://ifclite.dev/docs/",
   "bugs": "https://github.com/LTplus-AG/ifc-lite/issues",