kimu-core 0.4.1

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "kimu-core",
+  "version": "0.4.1",
+  "private": false,
+  "type": "module",
+  "license": "MPL-2.0",
+  "description": "KIMU core framework - Keep It Minimal UI Framework",
+  "author": {
+    "name": "Marco Di Pasquale",
+    "email": "info@unicoverso.com",
+    "url": "https://unicoverso.com"
+  },
+  "homepage": "https://unicoverso.com/kimu",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unicoverso/kimu-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/unicoverso/kimu-core/issues"
+  },
+  "keywords": [
+    "web-components",
+    "ui-framework",
+    "modular",
+    "frontend",
+    "minimal",
+    "declarative",
+    "kiosk",
+    "unicoVerso",
+    "KIMU"
+  ],
+  "scripts": {
+    "start": "vite",
+    "dev": "vite",
+    "vite": "vite",
+    "preview": "vite preview",
+    "build": "npm run build:compile && npm run build:bundle && npm run build:post",
+    "build:dev": "npm run generate-config:dev && npm run build:compile && npm run build:bundle && npm run build:post",
+    "build:local": "npm run generate-config:local && npm run build:compile && npm run build:bundle && npm run build:post",
+    "build:prod": "npm run generate-config:prod && npm run build:compile && npm run build:bundle && npm run build:post",
+    "build:compile": "tsc && npm run generate-config:dev",
+    "build:bundle": "vite build && npm run minify:css",
+    "build:post": "npm run build:all-config && npm run build:all-core && npm run build:all-modules && npm run build:all-ext",
+    "generate-config": "node scripts/generate-kimu-build-config.js dev",
+    "generate-config:dev": "node scripts/generate-kimu-build-config.js dev",
+    "generate-config:local": "node scripts/generate-kimu-build-config.js local",
+    "generate-config:prod": "node scripts/generate-kimu-build-config.js prod",
+    "clear:build": "node scripts/clear-kimu-build.js",
+    "minify:css": "node scripts/minify-css-assets.js",
+    "build:ext": "node scripts/build-extension.js",
+    "build:all-ext": "node scripts/build-all-extensions.js",
+    "build:all-config": "node scripts/build-all-config.js",
+    "build:all-core": "node scripts/build-all-core.js",
+    "build:all-modules": "node scripts/build-all-modules.js",
+    "install:module": "node scripts/install-module.js",
+    "remove:module": "node scripts/remove-module.js",
+    "list:modules": "node scripts/list-modules.js",
+    "pack": "npm pack",
+    "pack:dry": "npm pack --dry-run",
+    "prepack": "npm run clear:build",
+    "postpack": "echo 'Package created successfully! Check kimu-core-*.tgz'"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.13.1",
+    "idb": "^8.0.2",
+    "lit": "^3.2.1"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.2",
+    "path": "^0.12.7",
+    "rollup-plugin-copy": "^3.5.0",
+    "typescript": "^5.8.3",
+    "vite": "^6.2.0"
+  }
+}

package/public/favicon.svg

@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   id="Livello_2"
+   viewBox="0 0 128 128"
+   version="1.1"
+   sodipodi:docname="kimu-icon-128x128.svg"
+   width="128"
+   height="128"
+   inkscape:version="1.4 (e7c3feb1, 2024-10-09)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview4"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:zoom="1.5142353"
+     inkscape:cx="124.15507"
+     inkscape:cy="86.182112"
+     inkscape:window-width="1440"
+     inkscape:window-height="872"
+     inkscape:window-x="0"
+     inkscape:window-y="28"
+     inkscape:window-maximized="0"
+     inkscape:current-layer="Livello_2" />
+  <defs
+     id="defs1">
+    <style
+       id="style1">.cls-1{fill:#f45e32;}.cls-2{fill:#fff463;}.cls-3{fill:#88d1e2;}.cls-4{fill:#91d292;}</style>
+  </defs>
+  <g
+     id="g4"
+     transform="translate(0,-0.83295207)">
+    <g
+       id="Girandola"
+       transform="matrix(0.91533181,0,0,0.91533181,-1.552e-7,14)">
+      <g
+         id="Aste">
+        <path
+           class="cls-3"
+           d="m 57.47,111.07 c 18.74,0 33.94,-15.19 33.94,-33.94 0,-9.65 -4.03,-18.36 -10.49,-24.54 L 47.95,109.7 c 3.02,0.88 6.22,1.36 9.53,1.36 z"
+           id="path1" />
+        <path
+           class="cls-1"
+           d="M 82.48,0 C 63.74,0 48.54,15.19 48.54,33.94 c 0,9.65 4.03,18.36 10.49,24.54 L 92.01,1.36 C 88.99,0.48 85.79,0 82.48,0 Z"
+           id="path2" />
+        <path
+           class="cls-2"
+           d="m 3.59,71.31 c 9.37,16.23 30.13,21.79 46.36,12.42 8.36,-4.82 13.88,-12.67 16,-21.36 H 0 c 0.75,3.06 1.93,6.07 3.59,8.94 z"
+           id="path3" />
+        <path
+           class="cls-4"
+           d="M 136.25,39.58 C 126.88,23.35 106.12,17.79 89.89,27.16 c -8.36,4.82 -13.88,12.67 -16,21.36 h 65.95 c -0.75,-3.06 -1.93,-6.07 -3.59,-8.94 z"
+           id="path4" />
+      </g>
+    </g>
+  </g>
+</svg>

package/public/logo_kimu.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" id="Livello_1" width="256" height="256" viewBox="0 0 256 256"><defs id="defs1"><style id="style1">.st4{fill:#d19d29}</style></defs><g id="KIMU" transform="translate(-330.145 -133.58)scale(.48535)"><g id="g4"><path id="path1" d="m705.8 595.5 88.7 133.3h-6.7l-85-127.2v127.2h-5V462.3h5v128l85-128h6.7l-88.7 133.3z" class="st4"/><path id="path2" d="M825.6 462.2v266.5h-5V462.2Z" class="st4"/><path id="path3" d="M1023.7 472.3v254c0 1.4-1.1 2.5-2.5 2.5s-2.5-1.1-2.5-2.5V487.9c0-2.4-3.1-3.4-4.5-1.4l-65.1 92.6c-.5.7-1.2 1-2 1h-2.4c-.8 0-1.6-.4-2-1l-65.4-92.6c-1.4-2-4.5-1-4.5 1.5v238.4c0 1.4-1.1 2.5-2.5 2.5s-2.5-1.1-2.5-2.5v-254c0-1.4 1.1-2.5 2.5-2.5h1.2c.8 0 1.6.4 2.1 1.1l70.3 102.9c1 1.4 3.1 1.4 4.1 0l70-102.9c.5-.7 1.2-1.1 2.1-1.1h1.2c1.4 0 2.5 1.1 2.5 2.5z" class="st4"/><path id="path4" d="M1069.7 462.2v165.5c0 33.8 0 60.1 9.6 75.5 9.7 15.4 27.7 21.5 44.3 21.5s34-6.1 43.4-21.5 9.3-41.6 9.3-75.5V462.2h5v165.5c0 35.3-.2 63.1-10.4 80s-29.2 23.7-47.3 23.7-37.3-6.9-47.9-23.9-11-44.7-11-79.8V462.2Z" class="st4"/></g></g><g id="Girandola" transform="translate(-330.145 -133.58)scale(.48535)"><g id="Aste"><path id="path5" d="M1116.3 430.9c18.7 0 33.9-15.2 33.9-33.9 0-9.6-4-18.4-10.5-24.5l-33 57.1c3 .9 6.2 1.4 9.5 1.4z" style="fill:#88d1e2"/><path id="path6" d="M1141.3 319.9c-18.7 0-33.9 15.2-33.9 33.9s4 18.4 10.5 24.5l33-57.1c-3-.9-6.2-1.4-9.5-1.4z" style="fill:#f45e32"/><path id="path7" d="M1062.4 391.2c9.4 16.2 30.1 21.8 46.4 12.4 8.4-4.8 13.9-12.7 16-21.4h-65.9c.7 3.1 1.9 6.1 3.6 8.9z" style="fill:#fff463"/><path id="path8" d="M1195.1 359.4c-9.4-16.2-30.1-21.8-46.4-12.4-8.4 4.8-13.9 12.7-16 21.4h65.9c-.7-3.1-1.9-6.1-3.6-8.9z" style="fill:#91d292"/></g></g></svg>

package/scripts/build-all-config.js

@@ -0,0 +1,59 @@
+/**
+ * This script compiles all config files located in "src/config" using esbuild.
+ * The compiled output is saved in "dist/config/",
+ * preserving the source folder structure.
+ */
+import { build } from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+import { fixImportsInFiles } from './utils/fix-imports.js';
+
+const SRC_DIR = 'src/config';
+const DIST_DIR = 'dist/config';
+
+// Ensure output directory exists
+if (!fs.existsSync(DIST_DIR)) {
+  fs.mkdirSync(DIST_DIR, { recursive: true });
+}
+
+// Find all TypeScript files in the config directory
+const tsFiles = fs.readdirSync(SRC_DIR)
+  .filter(file => file.endsWith('.ts'))
+  .map(file => path.join(SRC_DIR, file));
+
+if (tsFiles.length === 0) {
+  console.warn(`⚠️  No .ts files found in ${SRC_DIR}`);
+  process.exit(0);
+}
+
+try {
+  // Compile all TypeScript files individually
+  const compiledFiles = [];
+  
+  for (const tsFile of tsFiles) {
+    const fileName = path.basename(tsFile, '.ts');
+    const outFile = path.join(DIST_DIR, `${fileName}.js`);
+    
+    await build({
+      entryPoints: [tsFile],
+      bundle: false, // Don't bundle, keep individual files
+      minify: true,
+      format: 'esm',
+      outfile: outFile,
+      platform: 'browser'
+    });
+    
+    compiledFiles.push(outFile);
+  }
+  
+  // Fix import paths in all compiled files
+  const fixedCount = fixImportsInFiles(compiledFiles);
+  
+  console.log(`✅ Config files compiled: ${tsFiles.length} files → ${DIST_DIR}`);
+  if (fixedCount > 0) {
+    console.log(`🔧 Fixed imports in ${fixedCount} config files`);
+  }
+} catch (err) {
+  console.error(`❌ Error compiling config files:`, err.message);
+  process.exit(1);
+}

package/scripts/build-all-core.js

@@ -0,0 +1,65 @@
+/**
+ * This script compiles all core files located in "src/core" using esbuild.
+ * The compiled output is saved in "dist/core/",
+ * preserving the source folder structure.
+ *
+ * Features:
+ * - Compiles all TypeScript files in "src/core".
+ * - Compiles TypeScript to JavaScript (ESM format) with minification.
+ * - Automatically fixes import paths by adding .js extensions.
+ * - Logs success or failure for each file compilation.
+ */
+import { build } from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+import { fixImportsInFiles } from './utils/fix-imports.js';
+
+const SRC_DIR = 'src/core';
+const DIST_DIR = 'dist/core';
+
+// Ensure output directory exists
+if (!fs.existsSync(DIST_DIR)) {
+  fs.mkdirSync(DIST_DIR, { recursive: true });
+}
+
+// Find all TypeScript files in the core directory
+const tsFiles = fs.readdirSync(SRC_DIR)
+  .filter(file => file.endsWith('.ts'))
+  .map(file => path.join(SRC_DIR, file));
+
+if (tsFiles.length === 0) {
+  console.warn(`⚠️  No .ts files found in ${SRC_DIR}`);
+  process.exit(0);
+}
+
+try {
+  // Compile all TypeScript files individually
+  const compiledFiles = [];
+  
+  for (const tsFile of tsFiles) {
+    const fileName = path.basename(tsFile, '.ts');
+    const outFile = path.join(DIST_DIR, `${fileName}.js`);
+    
+    await build({
+      entryPoints: [tsFile],
+      bundle: false, // Don't bundle, keep individual files
+      minify: true,
+      format: 'esm',
+      outfile: outFile,
+      platform: 'browser'
+    });
+    
+    compiledFiles.push(outFile);
+  }
+  
+  // Fix import paths in all compiled files
+  const fixedCount = fixImportsInFiles(compiledFiles);
+  
+  console.log(`✅ Core files compiled: ${tsFiles.length} files → ${DIST_DIR}`);
+  if (fixedCount > 0) {
+    console.log(`🔧 Fixed imports in ${fixedCount} core files`);
+  }
+} catch (err) {
+  console.error(`❌ Error compiling core files:`, err.message);
+  process.exit(1);
+}

package/scripts/build-all-extensions.js

@@ -0,0 +1,64 @@
+/**
+ * This script compiles all extensions located in the "src/extensions" directory
+ * using esbuild. Each extension is expected to have a "component.ts" entry file.
+ * The compiled output is saved in the "dist/extensions" directory, maintaining
+ * the folder structure of the source directory.
+ *
+ * Key functionalities:
+ * - Reads all subdirectories in "src/extensions".
+ * - Checks for the presence of "component.ts" in each subdirectory.
+ * - Compiles the TypeScript files into JavaScript (ESM format) with minification.
+ * - Automatically fixes import paths by adding .js extensions.
+ * - Logs the success or failure of each compilation process.
+ */
+
+import { build } from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+import { fixImportsInFile } from './utils/fix-imports.js';
+
+// Starting paths
+const SRC_DIR = 'src/extensions';
+const DIST_DIR = 'dist/extensions';
+
+// Read all subfolders inside src/extensions
+const extensions = fs.readdirSync(SRC_DIR, { withFileTypes: true })
+  .filter(dirent => dirent.isDirectory())
+  .map(dirent => dirent.name);
+
+for (const ext of extensions) {
+  const entry = path.join(SRC_DIR, ext, 'component.ts');
+  const outDir = path.join(DIST_DIR, ext);
+  const outFile = path.join(outDir, 'component.js');
+
+  if (!fs.existsSync(entry)) {
+    console.warn(`⚠️  "${ext}" ignorata (component.ts non trovato)`);
+    continue;
+  }
+
+  try {
+    await build({
+      entryPoints: [entry],
+      bundle: true,
+      minify: true,
+      format: 'esm',
+      outfile: outFile,
+      platform: 'browser',
+      external: [
+        '../../core/*',
+        '../../modules/*',
+        '../../utils/*'
+      ]
+    });
+
+    // Fix import paths in the compiled extension file
+    const fixed = fixImportsInFile(outFile);
+
+    console.log(`✅ Extension compiled "${ext}" to ${outFile}`);
+    if (fixed) {
+      console.log(`🔧 Fixed imports for extension "${ext}"`);
+    }
+  } catch (err) {
+    console.error(`❌ Error compiling extension "${ext}":`, err.message);
+  }
+}

package/scripts/build-all-modules.js

@@ -0,0 +1,99 @@
+/**
+ * This script compiles all modules located in "src/modules" using esbuild.
+ * Each module must have a "module.ts" entry file.
+ * The compiled output is saved in "dist/modules/<module-name>/module.js",
+ * preserving the source folder structure.
+ *
+ * Features:
+ * - Scans all subdirectories in "src/modules".
+ * - Checks for the presence of "module.ts" in each subdirectory.
+ * - Compiles TypeScript to JavaScript (ESM format) with minification.
+ * - Automatically fixes import paths by adding .js extensions.
+ * - Logs success or failure for each module compilation.
+ */
+import { build } from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { fixImportsInFile } from './utils/fix-imports.js';
+
+// ES modules don't have __dirname, so we need to derive it
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const SRC_DIR = 'src/modules';
+const DIST_DIR = 'dist/modules';
+
+// Get all module subfolders in src/modules
+const modules = fs.readdirSync(SRC_DIR, { withFileTypes: true })
+  .filter(dirent => dirent.isDirectory())
+  .map(dirent => dirent.name);
+
+// Run pre-build scripts first (before compilation)
+for (const mod of modules) {
+  const moduleDir = path.join(SRC_DIR, mod);
+  const preBuildScript = path.join(moduleDir, 'pre-build.js');
+  
+  if (fs.existsSync(preBuildScript)) {
+    try {
+      const preBuild = await import(pathToFileURL(preBuildScript).href);
+      if (preBuild.default && typeof preBuild.default === 'function') {
+        await preBuild.default({
+          moduleDir,
+          moduleName: mod,
+          rootDir: path.join(__dirname, '..')
+        });
+      }
+    } catch (err) {
+      console.warn(`⚠️  Pre-build script failed for "${mod}":`, err.message);
+    }
+  }
+}
+
+// Now compile all modules
+for (const mod of modules) {
+  const moduleDir = path.join(SRC_DIR, mod);
+  const outDir = path.join(DIST_DIR, mod);
+  
+  // Ensure output directory exists and is clean
+  if (fs.existsSync(outDir)) {
+    fs.rmSync(outDir, { recursive: true });
+  }
+  fs.mkdirSync(outDir, { recursive: true });
+
+  // Look for the main entry point (module.ts)
+  const entryPoint = path.join(moduleDir, 'module.ts');
+  
+  if (!fs.existsSync(entryPoint)) {
+    console.warn(`⚠️  Module "${mod}" skipped (module.ts not found)`);
+    continue;
+  }
+
+  try {
+    // Bundle the entire module into a single file
+    await build({
+      entryPoints: [entryPoint],
+      bundle: true, // Bundle all dependencies into a single file
+      minify: true,
+      format: 'esm',
+      outfile: path.join(outDir, 'module.js'),
+      platform: 'browser',
+      external: [
+        // Keep external references to core framework parts
+        '../../core/*',
+        '../../config/*'
+      ]
+    });
+    
+    // Fix import paths in the bundled module file
+    const outFile = path.join(outDir, 'module.js');
+    const fixed = fixImportsInFile ? fixImportsInFile(outFile) : false;
+    
+    console.log(`✅ Module compiled: "${mod}" → ${outDir} (bundled)`);
+    if (fixed) {
+      console.log(`🔧 Fixed imports for module "${mod}"`);
+    }
+  } catch (err) {
+    console.error(`❌ Error compiling module "${mod}":`, err.message);
+  }
+}

package/scripts/build-extension.js

@@ -0,0 +1,60 @@
+/**
+ * This script compiles a single extension located in the "src/extensions" directory
+ * using esbuild. The extension name must be provided as a command-line argument.
+ * The compiled output is saved in the "dist/extensions" directory.
+ *
+ * Key functionalities:
+ * - Validates the presence of the extension name argument.
+ * - Checks for the existence of the "component.ts" entry file in the specified extension folder.
+ * - Creates the output directory if it does not exist.
+ * - Compiles the TypeScript file into JavaScript (ESM format) with minification.
+ * - Logs the success or failure of the compilation process.
+ *
+ * Usage:
+ *   node build-extension.js <extension-name>
+ * Example:
+ *   node build-extension.js hello
+ */
+
+import { build } from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+
+const ext = process.argv[2]; // e.g. hello
+
+if (!ext) {
+  console.error('❌ You must specify the extension name (e.g., hello)');
+  process.exit(1);
+}
+
+const SRC_DIR = 'src/extensions';
+const DIST_DIR = 'dist/extensions';
+
+const entry = path.join(SRC_DIR, ext, 'component.ts');
+const outDir = path.join(DIST_DIR, ext);
+const outFile = path.join(outDir, 'component.js');
+
+// Check if the entry file exists
+if (!fs.existsSync(entry)) {
+  console.error(`❌ Il file component.ts per "${ext}" non è stato trovato in ${entry}`);
+  process.exit(1);
+}
+
+// Create the output directory if it does not exist
+fs.mkdirSync(outDir, { recursive: true });
+
+// Compilation
+try {
+  await build({
+    entryPoints: [entry],
+    bundle: true,
+    minify: true,
+    format: 'esm',
+    outfile: outFile,
+    platform: 'browser'
+  });
+
+  console.log(`✅ Extension compiled "${ext}" to ${outFile}`);
+} catch (err) {
+  console.error(`❌ Error during the compilation of extension "${ext}":`, err.message);
+}

package/scripts/clear-kimu-build.js

@@ -0,0 +1,31 @@
+/**
+ * This script removes the "kimu-build-config.ts" file located in the "src/config" directory.
+ * It checks if the file exists and deletes it if found.
+ * If the file does not exist, it logs a message indicating that there is nothing to remove.
+ *
+ * Key functionalities:
+ * - Resolves the path to "kimu-build-config.ts" based on the script's location.
+ * - Checks for the existence of the file.
+ * - Deletes the file if it exists.
+ * - Logs the result of the operation.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Get the directory name of the current script file
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Resolve the path to the "kimu-build-config.ts" file
+const buildPath = path.resolve(__dirname, '../src/config/kimu-build-config.ts');
+
+// Check if the file exists
+if (fs.existsSync(buildPath)) {
+  // Delete the file if it exists
+  fs.unlinkSync(buildPath);
+  console.log('[KIMU] 🧹 kimu-build-config.json removed');
+} else {
+  // Log a message if the file does not exist
+  console.log('[KIMU] No file to remove');
+}

package/scripts/generate-kimu-build-config.js

@@ -0,0 +1,79 @@
+/**
+ * This script generates the "kimu-build-config.ts" file based on the base configuration,
+ * environment-specific configuration, and the version from the project's package.json.
+ * The generated file is saved in the "src/config" directory.
+ *
+ * Key functionalities:
+ * - Reads the base configuration from "kimu-base-config.json".
+ * - Reads the environment-specific configuration from "<env>.config.json".
+ * - Extracts the version from "package.json".
+ * - Combines the configurations and version into a single object.
+ * - Generates a TypeScript file with the final configuration.
+ * - Logs the success or failure of the operation.
+ *
+ * Usage:
+ *   node generate-kimu-build-config.js <environment>
+ * Example:
+ *   node generate-kimu-build-config.js production
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Get the directory name of the current script file
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Get the environment argument or default to "dev"
+const env = process.argv[2] || 'dev';
+
+// Import the package.json to retrieve the version
+// Note: Importing package.json this way ensures compatibility with different paths
+const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf-8'));
+const version = pkg.version || '0.0.0';
+
+// Paths to configuration files
+const configPath = path.resolve(__dirname, '../src/config/kimu-base-config.json');
+const envConfigPath = path.resolve(__dirname, `../env/${env}.config.json`);
+const outputPath = path.resolve(__dirname, '../src/config/kimu-build-config.ts');
+
+// Check if the environment-specific configuration file exists
+if (!fs.existsSync(envConfigPath)) {
+  console.error(`[KIMU] ❌ Missing env config: ${envConfigPath}`);
+  process.exit(1);
+}
+
+// Read and parse the base and environment-specific configurations
+const base = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+const build = JSON.parse(fs.readFileSync(envConfigPath, 'utf-8'));
+
+// Override with environment variables if present
+if (process.env.KIMU_BASE_PATH) {
+  build['base-path'] = process.env.KIMU_BASE_PATH;
+  console.log(`[KIMU] 🔧 Base path overridden from env: ${process.env.KIMU_BASE_PATH}`);
+}
+if (process.env.KIMU_API_URL) {
+  build['api-url'] = process.env.KIMU_API_URL;
+  console.log(`[KIMU] 🔧 API URL overridden from env: ${process.env.KIMU_API_URL}`);
+}
+if (process.env.KIMU_WEB_URL) {
+  build['web-url'] = process.env.KIMU_WEB_URL;
+  console.log(`[KIMU] 🔧 Web URL overridden from env: ${process.env.KIMU_WEB_URL}`);
+}
+
+// Combine the configurations, version, and environment into the final object
+const finalConfig = {
+  ...base,
+  version,
+  environment: env,
+  build
+};
+
+// Generate the TypeScript content for the configuration file
+const tsContent = `/** Automatically generated file. Do not modify. */
+export const KimuBuildConfig = ${JSON.stringify(finalConfig, null, 2)} as const;
+`;
+
+// Write the generated content to the output file
+fs.writeFileSync(outputPath, tsContent);
+console.log(`[KIMU] ✅ Generated kimu-build-config.ts for "${env}" → version ${version}`);