@t8n/ui 1.0.0 → 1.2.0

package/index.js

@@ -7,18 +7,19 @@
  *   t.ui.clearCache()
  */
 
+import { registerExtension } from "./utils/registerExtension.js";
+
 if (typeof Titan === "undefined") globalThis.Titan = t;
 
-const EXT_KEY = "ui";
 const { fs, ls } = t.core;
 
 // --------------------------------------------------
-// Internal cache (per isolate)
+// Internal cache
 // --------------------------------------------------
 const memoryCache = Object.create(null);
 
 // --------------------------------------------------
-// Resolve paths relative to app/
+// Resolve paths relative to app/  ✅ FIXED
 // --------------------------------------------------
 function resolvePath(path) {
     const root = "../app" || "."
@@ -60,63 +61,42 @@ function renderTemplate(template, data = {}) {
 function injectCSS(data, opts = {}) {
     if (!opts.css) return data;
 
-    const cssFiles = Array.isArray(opts.css) ? opts.css : [opts.css];
+    const files = Array.isArray(opts.css) ? opts.css : [opts.css];
 
-    const styles = cssFiles
+    const styles = files
         .map(p => {
             const css = loadFile(resolvePath(p), "css");
             return `<style>\n${css}\n</style>`;
         })
         .join("\n");
 
-    return {
-        ...data,
-        css: styles
-    };
+    return { ...data, css: styles };
 }
 
 // --------------------------------------------------
-// EXTENSION CONTRACT (MANDATORY FOR TITANPL)
+// UI SERVICE (SAFE TO EXPORT)
 // --------------------------------------------------
-t[EXT_KEY] = {
-    /**
-     * Load HTML template once and return a reusable responder
-     */
+export const ui = {
     load(htmlPath) {
-        const fullPath = resolvePath(htmlPath);
-        const tpl = loadFile(fullPath, "html");
+        const tpl = loadFile(resolvePath(htmlPath), "html");
 
         return (data = {}, opts = {}) => {
-            const finalData = injectCSS(data, opts);
-            const html = renderTemplate(tpl, finalData);
+            const html = renderTemplate(tpl, injectCSS(data, opts));
             return t.response.html(html);
         };
     },
 
-    /**
-     * One-shot render with optional CSS
-     */
     render(htmlPath, data = {}, opts = {}) {
-        const fullPath = resolvePath(htmlPath);
-        const tpl = loadFile(fullPath, "html");
-
-        const finalData = injectCSS(data, opts);
-        const html = renderTemplate(tpl, finalData);
-
+        const tpl = loadFile(resolvePath(htmlPath), "html");
+        const html = renderTemplate(tpl, injectCSS(data, opts));
         return t.response.html(html);
     },
 
-    /**
-     * Load CSS only (manual usage if needed)
-     */
     css(cssPath) {
         const css = loadFile(resolvePath(cssPath), "css");
         return `<style>\n${css}\n</style>`;
     },
 
-    /**
-     * Clear all cached UI files
-     */
     clearCache() {
         for (const k in memoryCache) delete memoryCache[k];
 
@@ -129,3 +109,11 @@ t[EXT_KEY] = {
         return true;
     }
 };
+
+// --------------------------------------------------
+// REGISTER INTO TITAN (SuperLS-style) ✅ FIXED
+// --------------------------------------------------
+registerExtension("ui", ui);
+
+// Optional default export (same pattern as SuperLocalStorage)
+export default ui;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@t8n/ui",
-    "version": "1.0.0",
+    "version": "1.2.0",
     "description": "A lightweight HTML templating engine for TitanPL with file caching and variable interpolation.",
     "main": "index.js",
     "types": "index.d.ts",

package/titan.json

@@ -1,6 +1,6 @@
 {
     "name": "@t8n/ui",
-    "version": "1.0.0",
+    "version": "1.2.0",
     "main": "index.js",
     "description": "A lightweight HTML templating engine for TitanPL with file caching and variable interpolation.",
     "keywords": [

package/utils/registerExtension.js

@@ -0,0 +1,44 @@
+// utils/registerExtension.js
+
+/**
+ * Safely registers an extension in the global t object
+ * @param {string} extensionName - Unique name for the extension
+ * @param {any} extensionModule - The extension module/object to register
+ * @returns {boolean} True if registration was successful
+ */
+export function registerExtension(extensionName, extensionModule) {
+    // Check for global t object
+    if (typeof t === 'undefined') {
+        console.warn(`[registerExtension] Global 't' object not available. Cannot register: ${extensionName}`);
+        return false;
+    }
+
+    // Input validation
+    if (!extensionName || typeof extensionName !== 'string') {
+        console.error('[registerExtension] Invalid extension name provided');
+        return false;
+    }
+
+    // Check for naming conflicts
+    if (t[extensionName]) {
+        console.warn(`[registerExtension] '${extensionName}' already exists in global t object, overwriting`);
+    }
+
+    try {
+        // Register the extension
+        t[extensionName] = extensionModule;
+        
+        console.log(`[registerExtension] Successfully registered '${extensionName}'`);
+
+        return true;
+    } catch (error) {
+        // Structured error reporting
+        console.error(`[registerExtension] Failed to register '${extensionName}':`, {
+            error: error.message,
+            extensionName,
+            moduleType: typeof extensionModule
+        });
+
+        return false;
+    }
+}