@steambrew/ttc 3.2.3 → 3.2.5

package/dist/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin / env node
 import chalk from 'chalk';
 import fs, { readFileSync, existsSync, readFile as readFile$1 } from 'fs';
 import path, { dirname } from 'path';
@@ -28,6 +28,35 @@ import * as glob from 'glob';
 import MagicString from 'magic-string';
 import _traverse from '@babel/traverse';
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 const version = JSON.parse(readFileSync(path.resolve(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8')).version;
 const Logger = {
     warn(message, loc) {
@@ -52,14 +81,14 @@ const Logger = {
     },
     done({ elapsedMs, buildType, sysfsCount, envCount }) {
         const elapsed = `${(elapsedMs / 1000).toFixed(2)}s`;
-        const meta = [`ttc v${version}`];
+        const meta = [`ttc v${version} (${"17fd3c99"})`];
         if (buildType === 'dev')
             meta.push('no type checking');
         if (sysfsCount)
             meta.push(`${sysfsCount} bundled file${sysfsCount > 1 ? 's' : ''}`);
         if (envCount)
             meta.push(`${envCount} env var${envCount > 1 ? 's' : ''}`);
-        console.log(`${chalk.green('Finished')} ${buildType} in ${elapsed} ` + chalk.dim('(' + meta.join(', ') + ')'));
+        console.log(`${chalk.green('Finished')} ${buildType} in ${elapsed} ` + chalk.dim(meta.join(', ')));
     },
     failed({ elapsedMs, buildType }) {
         const elapsed = `${(elapsedMs / 1000).toFixed(2)}s`;
@@ -67,6 +96,35 @@ const Logger = {
     },
 };
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 const PrintParamHelp = () => {
     console.log([
         '',
@@ -135,6 +193,35 @@ const ValidateParameters = (args) => {
     };
 };
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 async function fileExists(filePath) {
     return access(filePath).then(() => true).catch(() => false);
 }
@@ -182,6 +269,35 @@ const CheckForUpdates = async () => {
     return false;
 };
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 const ValidatePlugin = (bIsMillennium, target) => {
     return new Promise((resolve, reject) => {
         if (!existsSync(target)) {
@@ -229,6 +345,35 @@ const ValidatePlugin = (bIsMillennium, target) => {
     });
 };
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 /**
  * @description Append the active plugin to the global plugin
  * list and notify that the frontend Loaded.
@@ -263,11 +408,41 @@ function InitializePlugins() {
     window.MILLENNIUM_SIDEBAR_NAVIGATION_PANELS || (window.MILLENNIUM_SIDEBAR_NAVIGATION_PANELS = {});
 }
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 const traverse = _traverse.default;
 function constSysfsExpr(options = {}) {
     const filter = createFilter(options.include, options.exclude);
     const pluginName = 'millennium-const-sysfs-expr';
     let count = 0;
+    const globCache = new Map();
     const plugin = {
         name: pluginName,
         transform(code, id) {
@@ -311,8 +486,6 @@ function constSysfsExpr(options = {}) {
                             }
                         }
                     },
-                });
-                traverse(ast, {
                     CallExpression: (nodePath) => {
                         const node = nodePath.node;
                         if (node.callee.type === 'Identifier' && node.callee.name === 'constSysfsExpr') {
@@ -432,53 +605,60 @@ function constSysfsExpr(options = {}) {
                                         ? path.dirname(pathOrPattern)
                                         : path.resolve(path.dirname(id), path.dirname(pathOrPattern));
                                 let embeddedContent;
-                                const isPotentialPattern = /[?*+!@()[\]{}]/.test(pathOrPattern);
-                                if (!isPotentialPattern &&
-                                    fs.existsSync(path.resolve(searchBasePath, pathOrPattern)) &&
-                                    fs.statSync(path.resolve(searchBasePath, pathOrPattern)).isFile()) {
-                                    const singleFilePath = path.resolve(searchBasePath, pathOrPattern);
-                                    try {
-                                        const rawContent = fs.readFileSync(singleFilePath, callOptions.encoding);
-                                        const contentString = rawContent.toString();
-                                        const fileInfo = {
-                                            content: contentString,
-                                            filePath: singleFilePath,
-                                            fileName: path.relative(searchBasePath, singleFilePath),
-                                        };
-                                        embeddedContent = JSON.stringify(fileInfo);
-                                        this.addWatchFile(singleFilePath);
-                                    }
-                                    catch (fileError) {
-                                        let message = String(fileError instanceof Error ? fileError.message : (fileError ?? 'Unknown file read error'));
-                                        this.error(`Error reading file ${singleFilePath}: ${message}`, node.loc?.start.index);
-                                        return;
-                                    }
+                                const cacheKey = `${searchBasePath}\0${pathOrPattern}\0${callOptions.encoding}`;
+                                if (globCache.has(cacheKey)) {
+                                    embeddedContent = globCache.get(cacheKey);
                                 }
                                 else {
-                                    const matchingFiles = glob.sync(pathOrPattern, {
-                                        cwd: searchBasePath,
-                                        nodir: true,
-                                        absolute: true,
-                                    });
-                                    const fileInfoArray = [];
-                                    for (const fullPath of matchingFiles) {
+                                    const isPotentialPattern = /[?*+!@()[\]{}]/.test(pathOrPattern);
+                                    if (!isPotentialPattern &&
+                                        fs.existsSync(path.resolve(searchBasePath, pathOrPattern)) &&
+                                        fs.statSync(path.resolve(searchBasePath, pathOrPattern)).isFile()) {
+                                        const singleFilePath = path.resolve(searchBasePath, pathOrPattern);
                                         try {
-                                            const rawContent = fs.readFileSync(fullPath, callOptions.encoding);
+                                            const rawContent = fs.readFileSync(singleFilePath, callOptions.encoding);
                                             const contentString = rawContent.toString();
-                                            fileInfoArray.push({
+                                            const fileInfo = {
                                                 content: contentString,
-                                                filePath: fullPath,
-                                                fileName: path.relative(searchBasePath, fullPath),
-                                            });
-                                            this.addWatchFile(fullPath);
+                                                filePath: singleFilePath,
+                                                fileName: path.relative(searchBasePath, singleFilePath),
+                                            };
+                                            embeddedContent = JSON.stringify(fileInfo);
+                                            this.addWatchFile(singleFilePath);
                                         }
                                         catch (fileError) {
                                             let message = String(fileError instanceof Error ? fileError.message : (fileError ?? 'Unknown file read error'));
-                                            this.warn(`Error reading file ${fullPath}: ${message}`);
+                                            this.error(`Error reading file ${singleFilePath}: ${message}`, node.loc?.start.index);
+                                            return;
                                         }
                                     }
-                                    embeddedContent = JSON.stringify(fileInfoArray);
-                                }
+                                    else {
+                                        const matchingFiles = glob.sync(pathOrPattern, {
+                                            cwd: searchBasePath,
+                                            nodir: true,
+                                            absolute: true,
+                                        });
+                                        const fileInfoArray = [];
+                                        for (const fullPath of matchingFiles) {
+                                            try {
+                                                const rawContent = fs.readFileSync(fullPath, callOptions.encoding);
+                                                const contentString = rawContent.toString();
+                                                fileInfoArray.push({
+                                                    content: contentString,
+                                                    filePath: fullPath,
+                                                    fileName: path.relative(searchBasePath, fullPath),
+                                                });
+                                                this.addWatchFile(fullPath);
+                                            }
+                                            catch (fileError) {
+                                                let message = String(fileError instanceof Error ? fileError.message : (fileError ?? 'Unknown file read error'));
+                                                this.warn(`Error reading file ${fullPath}: ${message}`);
+                                            }
+                                        }
+                                        embeddedContent = JSON.stringify(fileInfoArray);
+                                    }
+                                    globCache.set(cacheKey, embeddedContent);
+                                } // end cache miss
                                 // Replace the call expression with the generated content string
                                 magicString.overwrite(node.start, node.end, embeddedContent);
                                 hasReplaced = true;
@@ -530,6 +710,35 @@ function constSysfsExpr(options = {}) {
     return { plugin, getCount: () => count };
 }
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 const env = dotenv.config().parsed ?? {};
 var BuildTarget;
 (function (BuildTarget) {
@@ -618,7 +827,7 @@ function tsconfigPathsPlugin(tsconfigPath) {
     const paths = options.paths ?? {};
     function resolveWithExtensions(base) {
         for (const ext of ['', '.ts', '.tsx', '.js', '.jsx', '/index.ts', '/index.tsx']) {
-            if (fs.existsSync(base + ext))
+            if (fs.existsSync(base + ext) && fs.statSync(base + ext).isFile())
                 return base + ext;
         }
         return null;
@@ -877,6 +1086,35 @@ const TranspilerPluginComponent = async (pluginJson, props) => {
     }
 };
 
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 /**
  * this component serves as:
  * - typescript transpiler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steambrew/ttc",
-  "version": "3.2.3",
+  "version": "3.2.5",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -10,7 +10,7 @@
   "scripts": {
     "build": "rollup -c",
     "dev": "rollup -c -w",
-    "prepare": "bun run build"
+    "prepublishOnly": "bun run build"
   },
   "publishConfig": {
     "access": "public"

package/rollup.config.js

@@ -2,17 +2,22 @@ import commonjs from '@rollup/plugin-commonjs';
 import typescript from '@rollup/plugin-typescript';
 import json from '@rollup/plugin-json';
 import nodeResolve from '@rollup/plugin-node-resolve';
+import replace from '@rollup/plugin-replace';
 import { readFileSync } from 'fs';
+import { execSync } from 'child_process';
 
 const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
 
+let gitCommit = 'unknown';
+try { gitCommit = execSync('git rev-parse --short HEAD', { encoding: 'utf8' }).trim(); } catch {}
+
 export default {
 	input: 'src/index.ts',
 	context: 'window',
 	output: {
 		file: 'dist/index.js',
 	},
-	plugins: [commonjs(), typescript(), json(), nodeResolve()],
+	plugins: [replace({ __GIT_COMMIT__: JSON.stringify(gitCommit), preventAssignment: true }), commonjs(), typescript(), json(), nodeResolve()],
 	external: [
 		...Object.keys(pkg.dependencies || {}),
 		...Object.keys(pkg.peerDependencies || {}),

package/src/check-health.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 import path from 'path';
 import { existsSync, readFile } from 'fs';
 import { Logger } from './logger';

package/src/index.ts

@@ -1,4 +1,34 @@
-#!/usr/bin/env node
+#!/usr/bin / env node
+
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
 
 /**
  * this component serves as:

package/src/logger.ts

@@ -1,8 +1,40 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 import chalk from 'chalk';
 import { readFileSync } from 'fs';
 import path, { dirname } from 'path';
 import { fileURLToPath } from 'url';
 
+declare const __GIT_COMMIT__: string;
+
 const version: string = JSON.parse(readFileSync(path.resolve(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8')).version;
 
 interface DoneOptions {
@@ -36,11 +68,11 @@ const Logger = {
 
 	done({ elapsedMs, buildType, sysfsCount, envCount }: DoneOptions) {
 		const elapsed = `${(elapsedMs / 1000).toFixed(2)}s`;
-		const meta: string[] = [`ttc v${version}`];
+		const meta: string[] = [`ttc v${version} (${__GIT_COMMIT__})`];
 		if (buildType === 'dev') meta.push('no type checking');
 		if (sysfsCount) meta.push(`${sysfsCount} bundled file${sysfsCount > 1 ? 's' : ''}`);
 		if (envCount) meta.push(`${envCount} env var${envCount > 1 ? 's' : ''}`);
-		console.log(`${chalk.green('Finished')} ${buildType} in ${elapsed} ` + chalk.dim('(' + meta.join(', ') + ')'));
+		console.log(`${chalk.green('Finished')} ${buildType} in ${elapsed} ` + chalk.dim(meta.join(', ')));
 	},
 
 	failed({ elapsedMs, buildType }: Pick<DoneOptions, 'elapsedMs' | 'buildType'>) {

package/src/plugin-api.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 declare global {
 	interface Window {
 		/**

package/src/plugin-json.d.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 /**
  * generated from https://raw.githubusercontent.com/SteamClientHomebrew/Millennium/main/src/sys/plugin-schema.json
  */

package/src/query-parser.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 import { Logger } from './logger';
 
 export const PrintParamHelp = () => {

package/src/static-embed.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 import * as parser from '@babel/parser';
 import { createFilter } from '@rollup/pluginutils';
 import fs from 'fs';
@@ -47,6 +77,7 @@ export default function constSysfsExpr(options: EmbedPluginOptions = {}): SysfsP
 	const filter = createFilter(options.include, options.exclude);
 	const pluginName = 'millennium-const-sysfs-expr';
 	let count = 0;
+	const globCache = new Map<string, string>();
 
 	const plugin: Plugin = {
 		name: pluginName,
@@ -97,9 +128,6 @@ export default function constSysfsExpr(options: EmbedPluginOptions = {}): SysfsP
 							}
 						}
 					},
-				});
-
-				traverse(ast, {
 					CallExpression: (nodePath) => {
 						const node = nodePath.node;
 						if (node.callee.type === 'Identifier' && node.callee.name === 'constSysfsExpr') {
@@ -220,55 +248,61 @@ export default function constSysfsExpr(options: EmbedPluginOptions = {}): SysfsP
 
 								let embeddedContent: string;
 
-								const isPotentialPattern = /[?*+!@()[\]{}]/.test(pathOrPattern);
-
-								if (
-									!isPotentialPattern &&
-									fs.existsSync(path.resolve(searchBasePath, pathOrPattern)) &&
-									fs.statSync(path.resolve(searchBasePath, pathOrPattern)).isFile()
-								) {
-									const singleFilePath = path.resolve(searchBasePath, pathOrPattern);
-
-									try {
-										const rawContent: string | Buffer = fs.readFileSync(singleFilePath, callOptions.encoding);
-										const contentString = rawContent.toString();
-										const fileInfo: FileInfo = {
-											content: contentString,
-											filePath: singleFilePath,
-											fileName: path.relative(searchBasePath, singleFilePath),
-										};
-										embeddedContent = JSON.stringify(fileInfo);
-										this.addWatchFile(singleFilePath);
-									} catch (fileError: unknown) {
-										let message = String(fileError instanceof Error ? fileError.message : (fileError ?? 'Unknown file read error'));
-										this.error(`Error reading file ${singleFilePath}: ${message}`, node.loc?.start.index);
-										return;
-									}
+								const cacheKey = `${searchBasePath}\0${pathOrPattern}\0${callOptions.encoding}`;
+								if (globCache.has(cacheKey)) {
+									embeddedContent = globCache.get(cacheKey)!;
 								} else {
-									const matchingFiles = glob.sync(pathOrPattern, {
-										cwd: searchBasePath,
-										nodir: true,
-										absolute: true,
-									});
-
-									const fileInfoArray: FileInfo[] = [];
-									for (const fullPath of matchingFiles) {
+									const isPotentialPattern = /[?*+!@()[\]{}]/.test(pathOrPattern);
+
+									if (
+										!isPotentialPattern &&
+										fs.existsSync(path.resolve(searchBasePath, pathOrPattern)) &&
+										fs.statSync(path.resolve(searchBasePath, pathOrPattern)).isFile()
+									) {
+										const singleFilePath = path.resolve(searchBasePath, pathOrPattern);
+
 										try {
-											const rawContent: string | Buffer = fs.readFileSync(fullPath, callOptions.encoding);
+											const rawContent: string | Buffer = fs.readFileSync(singleFilePath, callOptions.encoding);
 											const contentString = rawContent.toString();
-											fileInfoArray.push({
+											const fileInfo: FileInfo = {
 												content: contentString,
-												filePath: fullPath,
-												fileName: path.relative(searchBasePath, fullPath),
-											});
-											this.addWatchFile(fullPath);
+												filePath: singleFilePath,
+												fileName: path.relative(searchBasePath, singleFilePath),
+											};
+											embeddedContent = JSON.stringify(fileInfo);
+											this.addWatchFile(singleFilePath);
 										} catch (fileError: unknown) {
 											let message = String(fileError instanceof Error ? fileError.message : (fileError ?? 'Unknown file read error'));
-											this.warn(`Error reading file ${fullPath}: ${message}`);
+											this.error(`Error reading file ${singleFilePath}: ${message}`, node.loc?.start.index);
+											return;
 										}
+									} else {
+										const matchingFiles = glob.sync(pathOrPattern, {
+											cwd: searchBasePath,
+											nodir: true,
+											absolute: true,
+										});
+
+										const fileInfoArray: FileInfo[] = [];
+										for (const fullPath of matchingFiles) {
+											try {
+												const rawContent: string | Buffer = fs.readFileSync(fullPath, callOptions.encoding);
+												const contentString = rawContent.toString();
+												fileInfoArray.push({
+													content: contentString,
+													filePath: fullPath,
+													fileName: path.relative(searchBasePath, fullPath),
+												});
+												this.addWatchFile(fullPath);
+											} catch (fileError: unknown) {
+												let message = String(fileError instanceof Error ? fileError.message : (fileError ?? 'Unknown file read error'));
+												this.warn(`Error reading file ${fullPath}: ${message}`);
+											}
+										}
+										embeddedContent = JSON.stringify(fileInfoArray);
 									}
-									embeddedContent = JSON.stringify(fileInfoArray);
-								}
+									globCache.set(cacheKey, embeddedContent);
+								} // end cache miss
 
 								// Replace the call expression with the generated content string
 								magicString.overwrite(node.start, node.end, embeddedContent);

package/src/transpiler.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 import babel from '@rollup/plugin-babel';
 import commonjs from '@rollup/plugin-commonjs';
 import json from '@rollup/plugin-json';
@@ -152,7 +182,7 @@ function tsconfigPathsPlugin(tsconfigPath: string): InputPluginOption {
 
 	function resolveWithExtensions(base: string): string | null {
 		for (const ext of ['', '.ts', '.tsx', '.js', '.jsx', '/index.ts', '/index.tsx']) {
-			if (fs.existsSync(base + ext)) return base + ext;
+		    if (fs.existsSync(base + ext) && fs.statSync(base + ext).isFile()) return base + ext;
 		}
 		return null;
 	}

package/src/version-control.ts

@@ -1,3 +1,33 @@
+/**
+ * ==================================================
+ *   _____ _ _ _             _
+ *  |     |_| | |___ ___ ___|_|_ _ _____
+ *  | | | | | | | -_|   |   | | | |     |
+ *  |_|_|_|_|_|_|___|_|_|_|_|_|___|_|_|_|
+ *
+ * ==================================================
+ *
+ * Copyright (c) 2026 Project Millennium
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { readFile, access } from 'fs/promises';

package/.claude/settings.local.json

@@ -1,10 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm show:*)",
-      "Bash(bun remove:*)",
-      "Bash(bun run:*)",
-      "Bash(node:*)"
-    ]
-  }
-}