@aaqu/fromcubes-portal-react 0.1.0-alpha.1 → 0.1.0-alpha.10

package/nodes/portal-react.html

@@ -26,7 +26,10 @@
     // Idempotent — safe to call multiple times, only runs setup once.
     function ensureJsxSetup() {
       if (jsxSetupDone) {
-        console.log(PREFIX, "ensureJsxSetup: already done, re-applying compiler+diag only");
+        console.log(
+          PREFIX,
+          "ensureJsxSetup: already done, re-applying compiler+diag only",
+        );
         // Always re-apply compiler/diag in case Node-RED reset them
         applyCompilerAndDiag();
         return;
@@ -36,8 +39,16 @@
       var jsDef = monaco.typescript.javascriptDefaults;
 
       // Log initial state
-      console.log(PREFIX, "INITIAL compilerOptions:", JSON.stringify(jsDef.getCompilerOptions()));
-      console.log(PREFIX, "INITIAL diagnosticsOptions:", JSON.stringify(jsDef.getDiagnosticsOptions()));
+      console.log(
+        PREFIX,
+        "INITIAL compilerOptions:",
+        JSON.stringify(jsDef.getCompilerOptions()),
+      );
+      console.log(
+        PREFIX,
+        "INITIAL diagnosticsOptions:",
+        JSON.stringify(jsDef.getDiagnosticsOptions()),
+      );
 
       applyCompilerAndDiag();
 
@@ -45,7 +56,7 @@
       var libContent = [
         "declare var React: any;",
         "declare var ReactDOM: any;",
-        "declare function useNodeRed(): { data: any; send: (payload: any, topic?: string) => void };",
+        "declare function useNodeRed(): { data: any; send: (payload: any, topic?: string) => void; user: { userId?: string; userName?: string; username?: string; email?: string; role?: string; groups?: any[] } | null };",
       ].join("\n");
       console.log(PREFIX, "addExtraLib globals.d.ts");
       jsDef.addExtraLib(libContent, "file:///globals.d.ts");
@@ -134,7 +145,17 @@
               });
             }
           }
-          console.log(PREFIX, "TW completion: ctx=" + (isClassName ? "className" : "string") + " word='" + word + "', matched=" + suggestions.length + "/" + classes.length);
+          console.log(
+            PREFIX,
+            "TW completion: ctx=" +
+              (isClassName ? "className" : "string") +
+              " word='" +
+              word +
+              "', matched=" +
+              suggestions.length +
+              "/" +
+              classes.length,
+          );
           return { suggestions: suggestions };
         },
       });
@@ -142,19 +163,82 @@
       // JSX/HTML tag completion — type tag name, Tab → <tag>|</tag>
       console.log(PREFIX, "registering JSX tag completion provider");
       var HTML_TAGS = [
-        "div","span","p","a","button","input","img","form","label",
-        "h1","h2","h3","h4","h5","h6",
-        "ul","ol","li","dl","dt","dd",
-        "table","thead","tbody","tfoot","tr","th","td",
-        "section","article","aside","header","footer","nav","main",
-        "strong","em","b","i","u","s","small","mark","code","pre","blockquote",
-        "br","hr","wbr",
-        "select","option","optgroup","textarea",
-        "fieldset","legend","details","summary","dialog",
-        "canvas","video","audio","source","picture","figure","figcaption",
-        "svg","path","circle","rect","line","g","defs","use","text",
+        "div",
+        "span",
+        "p",
+        "a",
+        "button",
+        "input",
+        "img",
+        "form",
+        "label",
+        "h1",
+        "h2",
+        "h3",
+        "h4",
+        "h5",
+        "h6",
+        "ul",
+        "ol",
+        "li",
+        "dl",
+        "dt",
+        "dd",
+        "table",
+        "thead",
+        "tbody",
+        "tfoot",
+        "tr",
+        "th",
+        "td",
+        "section",
+        "article",
+        "aside",
+        "header",
+        "footer",
+        "nav",
+        "main",
+        "strong",
+        "em",
+        "b",
+        "i",
+        "u",
+        "s",
+        "small",
+        "mark",
+        "code",
+        "pre",
+        "blockquote",
+        "br",
+        "hr",
+        "wbr",
+        "select",
+        "option",
+        "optgroup",
+        "textarea",
+        "fieldset",
+        "legend",
+        "details",
+        "summary",
+        "dialog",
+        "canvas",
+        "video",
+        "audio",
+        "source",
+        "picture",
+        "figure",
+        "figcaption",
+        "svg",
+        "path",
+        "circle",
+        "rect",
+        "line",
+        "g",
+        "defs",
+        "use",
+        "text",
       ];
-      var VOID_TAGS = new Set(["br","hr","img","input","wbr","source"]);
+      var VOID_TAGS = new Set(["br", "hr", "img", "input", "wbr", "source"]);
 
       monaco.languages.registerCompletionItemProvider("javascript", {
         triggerCharacters: ["<"],
@@ -165,12 +249,15 @@
           // After "<" — suggest tags
           var afterBracket = before.match(/<([a-zA-Z]*)$/);
           // Bare word at line start or after whitespace/{ — Emmet-like (lower or upper)
-          var bareWord = !afterBracket && before.match(/(?:^|[\s{(,])([a-zA-Z][a-zA-Z0-9]*)$/);
+          var bareWord =
+            !afterBracket &&
+            before.match(/(?:^|[\s{(,])([a-zA-Z][a-zA-Z0-9]*)$/);
 
           if (!afterBracket && !bareWord) return { suggestions: [] };
 
           var typed = (afterBracket ? afterBracket[1] : bareWord[1]) || "";
-          var replaceStart = position.column - typed.length - (afterBracket ? 1 : 0);
+          var replaceStart =
+            position.column - typed.length - (afterBracket ? 1 : 0);
 
           var range = {
             startLineNumber: position.lineNumber,
@@ -192,7 +279,8 @@
                 label: tag,
                 kind: monaco.languages.CompletionItemKind.Property,
                 insertText: "<" + tag + " $0/>",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + tag + " />",
                 sortText: "0" + tag,
@@ -202,7 +290,8 @@
                 label: tag,
                 kind: monaco.languages.CompletionItemKind.Property,
                 insertText: "<" + tag + ">$0</" + tag + ">",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + tag + ">…</" + tag + ">",
                 sortText: "0" + tag + "a",
@@ -211,7 +300,8 @@
                 label: tag,
                 kind: monaco.languages.CompletionItemKind.Property,
                 insertText: "<" + tag + " $0/>",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + tag + " />",
                 sortText: "0" + tag + "b",
@@ -220,9 +310,15 @@
           }
 
           // Custom components from registry (PascalCase)
-          var upperMatch = afterBracket && before.match(/<([A-Z][a-zA-Z0-9]*)$/);
-          var bareUpper = !afterBracket && before.match(/(?:^|[\s{(,])([A-Z][a-zA-Z0-9]*)$/);
-          var compTyped = upperMatch ? upperMatch[1] : (bareUpper ? bareUpper[1] : "");
+          var upperMatch =
+            afterBracket && before.match(/<([A-Z][a-zA-Z0-9]*)$/);
+          var bareUpper =
+            !afterBracket && before.match(/(?:^|[\s{(,])([A-Z][a-zA-Z0-9]*)$/);
+          var compTyped = upperMatch
+            ? upperMatch[1]
+            : bareUpper
+              ? bareUpper[1]
+              : "";
 
           if (compTyped || (!typed && afterBracket)) {
             // Fetch component names from registry (cached on window)
@@ -231,13 +327,19 @@
               var name = reg[c];
               if (seen.has(name)) continue;
               if (compTyped && name.indexOf(compTyped) !== 0) continue;
-              if (!compTyped && typed && name.toLowerCase().indexOf(typed) !== 0) continue;
+              if (
+                !compTyped &&
+                typed &&
+                name.toLowerCase().indexOf(typed) !== 0
+              )
+                continue;
               seen.add(name);
               suggestions.push({
                 label: name,
                 kind: monaco.languages.CompletionItemKind.Class,
                 insertText: "<" + name + ">$0</" + name + ">",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + name + ">…</" + name + ">",
                 sortText: "0" + name + "a",
@@ -246,7 +348,8 @@
                 label: name,
                 kind: monaco.languages.CompletionItemKind.Class,
                 insertText: "<" + name + " $0/>",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + name + " />",
                 sortText: "0" + name + "b",
@@ -258,7 +361,8 @@
                 label: compTyped,
                 kind: monaco.languages.CompletionItemKind.Class,
                 insertText: "<" + compTyped + ">$0</" + compTyped + ">",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + compTyped + ">…</" + compTyped + ">",
                 sortText: "0" + compTyped + "a",
@@ -267,7 +371,8 @@
                 label: compTyped,
                 kind: monaco.languages.CompletionItemKind.Class,
                 insertText: "<" + compTyped + " $0/>",
-                insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
+                insertTextRules:
+                  monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                 range: range,
                 detail: "<" + compTyped + " />",
                 sortText: "0" + compTyped + "b",
@@ -275,7 +380,13 @@
             }
           }
 
-          console.log(PREFIX, "JSX tag completion: typed='" + typed + "', suggestions=" + suggestions.length);
+          console.log(
+            PREFIX,
+            "JSX tag completion: typed='" +
+              typed +
+              "', suggestions=" +
+              suggestions.length,
+          );
           return { suggestions: suggestions };
         },
       });
@@ -296,12 +407,14 @@
           var m = line.match(/^(.*)<([a-zA-Z][a-zA-Z0-9]*)>\/<\/\2>(.*)$/);
           var matchStr, tag, prefix;
           if (m) {
-            prefix = m[1]; tag = m[2];
+            prefix = m[1];
+            tag = m[2];
             matchStr = "<" + tag + ">/</" + tag + ">";
           } else {
             m = line.match(/^(.*)<([a-zA-Z][a-zA-Z0-9]*)\/><\/\2>(.*)$/);
             if (!m) return;
-            prefix = m[1]; tag = m[2];
+            prefix = m[1];
+            tag = m[2];
             matchStr = "<" + tag + "/></" + tag + ">";
           }
           var startCol = prefix.length + 1;
@@ -309,15 +422,17 @@
           var replacement = "<" + tag + " />";
           var cursorCol = startCol + replacement.length - 2;
           setTimeout(function () {
-            editor.executeEdits("self-close-collapse", [{
-              range: {
-                startLineNumber: lineNum,
-                endLineNumber: lineNum,
-                startColumn: startCol,
-                endColumn: endCol,
+            editor.executeEdits("self-close-collapse", [
+              {
+                range: {
+                  startLineNumber: lineNum,
+                  endLineNumber: lineNum,
+                  startColumn: startCol,
+                  endColumn: endCol,
+                },
+                text: replacement,
               },
-              text: replacement,
-            }]);
+            ]);
             editor.setPosition({ lineNumber: lineNum, column: cursorCol });
           }, 0);
         });
@@ -328,7 +443,11 @@
       function refreshComponentNames() {
         $.getJSON("portal-react/registry", function (reg) {
           window.__fcComponentNames = Object.keys(reg);
-          console.log(PREFIX, "component names loaded:", window.__fcComponentNames);
+          console.log(
+            PREFIX,
+            "component names loaded:",
+            window.__fcComponentNames,
+          );
         }).fail(function () {
           window.__fcComponentNames = [];
         });
@@ -343,11 +462,19 @@
             console.group(PREFIX + " MARKERS on " + uri.toString());
             markers.forEach(function (m) {
               console.log(
-                "  code=" + (m.code || "?") +
-                " severity=" + m.severity +
-                " source=" + (m.source || "?") +
-                " msg=" + m.message +
-                " [L" + m.startLineNumber + ":" + m.startColumn + "]"
+                "  code=" +
+                  (m.code || "?") +
+                  " severity=" +
+                  m.severity +
+                  " source=" +
+                  (m.source || "?") +
+                  " msg=" +
+                  m.message +
+                  " [L" +
+                  m.startLineNumber +
+                  ":" +
+                  m.startColumn +
+                  "]",
               );
             });
             console.groupEnd();
@@ -379,8 +506,16 @@
       console.log(PREFIX, "setDiagnosticsOptions:", JSON.stringify(diagOpts));
       jsDef.setDiagnosticsOptions(diagOpts);
 
-      console.log(PREFIX, "readback compilerOptions:", JSON.stringify(jsDef.getCompilerOptions()));
-      console.log(PREFIX, "readback diagnosticsOptions:", JSON.stringify(jsDef.getDiagnosticsOptions()));
+      console.log(
+        PREFIX,
+        "readback compilerOptions:",
+        JSON.stringify(jsDef.getCompilerOptions()),
+      );
+      console.log(
+        PREFIX,
+        "readback diagnosticsOptions:",
+        JSON.stringify(jsDef.getDiagnosticsOptions()),
+      );
     }
 
     // Exported for oneditprepare to call before model creation
@@ -391,7 +526,10 @@
     window.__fcLoadMonaco = function (cb) {
       console.log(PREFIX, "loadMonaco called, monaco exists:", !!window.monaco);
       if (window.monaco) {
-        console.log(PREFIX, "Monaco already loaded (by Node-RED?), running setup inline");
+        console.log(
+          PREFIX,
+          "Monaco already loaded (by Node-RED?), running setup inline",
+        );
         ensureJsxSetup();
         cb();
         return;
@@ -497,7 +635,7 @@
       inputs: 0,
       outputs: 0,
       icon: "font-awesome/fa-cube",
-      paletteLabel: "component",
+      paletteLabel: "fromcubes component",
       label: function () {
         return this.name || this.compName || "component";
       },
@@ -510,22 +648,32 @@
         if (!window.__fcTwClasses) {
           console.log("[FC-Monaco] loading tw-classes...");
           $.getJSON("portal-react/tw-classes", function (classes) {
-            console.log("[FC-Monaco] tw-classes loaded, count=" + classes.length);
+            console.log(
+              "[FC-Monaco] tw-classes loaded, count=" + classes.length,
+            );
             window.__fcTwClasses = classes;
           }).fail(function (xhr) {
-            console.error("[FC-Monaco] tw-classes FAILED:", xhr.status, xhr.statusText);
+            console.error(
+              "[FC-Monaco] tw-classes FAILED:",
+              xhr.status,
+              xhr.statusText,
+            );
           });
         }
 
         window.__fcLoadMonaco(function (failed) {
           if (failed) {
-            console.error("[FC-Monaco] COMP: Monaco load failed, using fallback textarea");
+            console.error(
+              "[FC-Monaco] COMP: Monaco load failed, using fallback textarea",
+            );
             $("#fcc-monaco").hide();
             $("#fcc-fallback").show().val(code);
             return;
           }
 
-          console.log("[FC-Monaco] COMP: applying JSX defaults before model creation");
+          console.log(
+            "[FC-Monaco] COMP: applying JSX defaults before model creation",
+          );
           window.__fcApplyJsxDefaults();
 
           var compUri = monaco.Uri.parse("file:///fc-comp-" + node.id + ".jsx");
@@ -535,8 +683,15 @@
             console.log("[FC-Monaco] COMP: disposing existing model");
             existingModel.dispose();
           }
-          var compModel = monaco.editor.createModel(code, "javascript", compUri);
-          console.log("[FC-Monaco] COMP: model created, language=" + compModel.getLanguageId());
+          var compModel = monaco.editor.createModel(
+            code,
+            "javascript",
+            compUri,
+          );
+          console.log(
+            "[FC-Monaco] COMP: model created, language=" +
+              compModel.getLanguageId(),
+          );
 
           compEditorInstance = monaco.editor.create(
             document.getElementById("fcc-monaco"),
@@ -547,13 +702,27 @@
           // Log markers after a short delay (diagnostics are async)
           setTimeout(function () {
             var markers = monaco.editor.getModelMarkers({ resource: compUri });
-            console.log("[FC-Monaco] COMP: markers after 500ms, count=" + markers.length);
+            console.log(
+              "[FC-Monaco] COMP: markers after 500ms, count=" + markers.length,
+            );
             markers.forEach(function (m) {
-              console.log("[FC-Monaco] COMP marker: code=" + m.code + " msg=" + m.message);
+              console.log(
+                "[FC-Monaco] COMP marker: code=" + m.code + " msg=" + m.message,
+              );
             });
             // Also log current compiler options state
-            console.log("[FC-Monaco] COMP: current compilerOptions:", JSON.stringify(monaco.typescript.javascriptDefaults.getCompilerOptions()));
-            console.log("[FC-Monaco] COMP: current diagnosticsOptions:", JSON.stringify(monaco.typescript.javascriptDefaults.getDiagnosticsOptions()));
+            console.log(
+              "[FC-Monaco] COMP: current compilerOptions:",
+              JSON.stringify(
+                monaco.typescript.javascriptDefaults.getCompilerOptions(),
+              ),
+            );
+            console.log(
+              "[FC-Monaco] COMP: current diagnosticsOptions:",
+              JSON.stringify(
+                monaco.typescript.javascriptDefaults.getDiagnosticsOptions(),
+              ),
+            );
           }, 500);
         });
       },
@@ -631,6 +800,34 @@
     <ul id="fc-tabs" style="min-width:600px;margin-bottom:0;"></ul>
   </div>
   <div id="fc-tabs-content">
+    <!-- ── Tab: JSX ── -->
+    <div id="fc-tab-jsx" class="fc-tab-pane">
+      <div class="form-row node-text-editor-row">
+        <div
+          id="fc-editor-wrap"
+          style="width:100%;height:420px;border:1px solid var(--red-ui-form-input-border-color,#555);border-radius:4px;overflow:hidden;position:relative;"
+        >
+          <div id="fc-monaco" style="width:100%;height:100%;"></div>
+          <textarea
+            id="fc-fallback"
+            style="display:none;width:100%;height:100%;font-family:'Cascadia Code',Consolas,monospace;font-size:13px;background:#1e1e1e;color:#d4d4d4;border:none;padding:12px;resize:none;"
+          ></textarea>
+        </div>
+      </div>
+      <div class="form-row" style="display:flex;gap:8px;margin-top:4px;flex-wrap:wrap;">
+        <button type="button" class="red-ui-button" id="fc-btn-starter">
+          <i class="fa fa-magic"></i> Default
+        </button>
+        <button type="button" class="red-ui-button" id="fc-btn-components">
+          <i class="fa fa-cube"></i> Components
+        </button>
+        <span style="flex:1"></span>
+        <button type="button" class="red-ui-button" id="fc-btn-preview">
+          <i class="fa fa-eye"></i> Preview
+        </button>
+      </div>
+    </div>
+
     <!-- ── Tab: Properties ── -->
     <div id="fc-tab-props" class="fc-tab-pane" style="display:none;">
       <div class="form-row">
@@ -641,7 +838,7 @@
         <label for="node-input-endpoint"
           ><i class="fa fa-globe"></i> Endpoint</label
         >
-        <input type="text" id="node-input-endpoint" placeholder="/portal" />
+        <input type="text" id="node-input-endpoint" placeholder="/fromcubes" />
         <div
           style="font-size:11px;opacity:.5;margin-top:2px;margin-left:105px;"
           id="fc-url-hint"
@@ -653,41 +850,41 @@
         >
         <input type="text" id="node-input-pageTitle" placeholder="Portal" />
       </div>
-    </div>
-
-    <!-- ── Tab: JSX ── -->
-    <div id="fc-tab-jsx" class="fc-tab-pane">
-      <div class="form-row" style="margin-bottom:0;">
-        <div style="font-size:11px;opacity:.6;margin-bottom:4px;">
-          <code>useNodeRed()</code> &rarr;
-          <code>{ data, send }</code> &nbsp;|&nbsp; Components from
-          <code>fc-portal-component</code> nodes auto-imported &nbsp;|&nbsp;
-          Must export <code>&lt;App /&gt;</code> &nbsp;|&nbsp;
-          <strong>Transpiled server-side at deploy</strong>
-        </div>
-      </div>
-      <div class="form-row node-text-editor-row">
+      <div class="form-row node-input-libs-container-row">
+        <label style="width:auto;"><i class="fa fa-archive"></i> Modules</label>
+        <ol id="node-input-libs-container"></ol>
         <div
-          id="fc-editor-wrap"
-          style="width:100%;height:420px;border:1px solid var(--red-ui-form-input-border-color,#555);border-radius:4px;overflow:hidden;position:relative;"
+          style="font-size:11px;opacity:.5;margin-top:4px;margin-left:4px;"
         >
-          <div id="fc-monaco" style="width:100%;height:100%;"></div>
-          <textarea
-            id="fc-fallback"
-            style="display:none;width:100%;height:100%;font-family:'Cascadia Code',Consolas,monospace;font-size:13px;background:#1e1e1e;color:#d4d4d4;border:none;padding:12px;resize:none;"
-          ></textarea>
+          npm packages to bundle. Node-RED auto-installs them at deploy time.
         </div>
       </div>
-      <div class="form-row" style="display:flex;gap:8px;margin-top:4px;">
-        <button type="button" class="red-ui-button" id="fc-btn-preview">
-          <i class="fa fa-eye"></i> Preview
-        </button>
-        <button type="button" class="red-ui-button" id="fc-btn-components">
-          <i class="fa fa-cube"></i> Components
-        </button>
-        <button type="button" class="red-ui-button" id="fc-btn-starter">
-          <i class="fa fa-magic"></i> Starter
-        </button>
+      <div class="form-row" style="margin-top:12px;">
+        <label style="width:auto;">
+          <input
+            type="checkbox"
+            id="node-input-showWsStatus"
+            style="width:auto;margin:0 8px 0 0;vertical-align:middle;"
+          />
+          Show WebSocket status indicator
+        </label>
+        <div style="font-size:11px;opacity:.5;margin-top:4px;margin-left:4px;">
+          Displays a small <em>fromcubes</em> badge in the bottom-right corner
+          showing connection state.
+        </div>
+      </div>
+      <div class="form-row" style="margin-top:12px;">
+        <label style="width:auto;">
+          <input
+            type="checkbox"
+            id="node-input-portalAuth"
+            style="width:auto;margin:0 8px 0 0;vertical-align:middle;"
+          />
+          Enable Portal Auth headers
+        </label>
+        <div style="font-size:11px;opacity:.5;margin-top:4px;margin-left:4px;">
+          Read <code>X-Portal-*</code> headers from reverse proxy.
+        </div>
       </div>
     </div>
 
@@ -734,7 +931,7 @@
       "",
       "  return (",
       '    <div className="min-h-screen bg-zinc-950 p-8">',
-      '      <h1 className="text-2xl font-light text-cyan-400 mb-6">Portal</h1>',
+      '      <h1 className="text-2xl font-light text-cyan-400 mb-6">fromcubes</h1>',
       '      <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4">',
       '        <StatusCard label="Value" value={d.value ?? "—"} unit="" />',
       "      </div>",
@@ -754,15 +951,18 @@
       color: "#61dafb",
       defaults: {
         name: { value: "" },
-        endpoint: { value: "/portal", required: true },
-        pageTitle: { value: "Portal" },
+        endpoint: { value: "/fromcubes", required: true },
+        pageTitle: { value: "fromcubes" },
         componentCode: { value: STARTER },
         customHead: { value: "" },
+        portalAuth: { value: false },
+        showWsStatus: { value: false },
+        libs: { value: [] },
       },
       inputs: 1,
       outputs: 1,
       icon: "font-awesome/fa-desktop",
-      paletteLabel: "portal react",
+      paletteLabel: "fromcubes portal",
       label: function () {
         return this.name || this.endpoint || "portal react";
       },
@@ -776,10 +976,16 @@
         if (!window.__fcTwClasses) {
           console.log("[FC-Monaco] loading tw-classes...");
           $.getJSON("portal-react/tw-classes", function (classes) {
-            console.log("[FC-Monaco] tw-classes loaded, count=" + classes.length);
+            console.log(
+              "[FC-Monaco] tw-classes loaded, count=" + classes.length,
+            );
             window.__fcTwClasses = classes;
           }).fail(function (xhr) {
-            console.error("[FC-Monaco] tw-classes FAILED:", xhr.status, xhr.statusText);
+            console.error(
+              "[FC-Monaco] tw-classes FAILED:",
+              xhr.status,
+              xhr.statusText,
+            );
           });
         }
 
@@ -802,16 +1008,39 @@
 
         // URL hint
         function updateHint() {
-          var ep = $("#node-input-endpoint").val() || "/portal";
-          $("#fc-url-hint").text("Page served at: http://<host>:1880" + ep);
+          var ep = $("#node-input-endpoint").val() || "/fromcubes";
+          var root = (RED.settings.httpNodeRoot || "/").replace(/\/$/, "");
+          $("#fc-url-hint").text("Page served at: http://<host>:1880" + root + ep);
         }
         $("#node-input-endpoint").on("input", updateHint);
         updateHint();
 
+        // Modules editableList (like function node's libs)
+        var libsList = node.libs || [];
+        $("#node-input-libs-container").css("min-height","68px").editableList({
+          addItem: function(container, i, opt) {
+            var lib = opt || {};
+            var row = $('<div/>',{style:"display:flex;gap:8px;align-items:center;"}).appendTo(container);
+            var modInput = $('<input/>',{type:"text",placeholder:"e.g. chart.js/auto@^4.4.0",style:"flex:1;"}).appendTo(row);
+            var varInput = $('<input/>',{type:"text",placeholder:"Import as (e.g. Chart)",style:"width:140px;"}).appendTo(row);
+            modInput.val(lib.module || "");
+            varInput.val(lib.var || "");
+            container.data("mod", modInput);
+            container.data("var", varInput);
+          },
+          removable: true,
+          sortable: true
+        });
+        libsList.forEach(function(lib) {
+          $("#node-input-libs-container").editableList("addItem", lib);
+        });
+
         // Monaco
         window.__fcLoadMonaco(function (failed) {
           if (failed) {
-            console.error("[FC-Monaco] PORTAL: Monaco load failed, using fallback textarea");
+            console.error(
+              "[FC-Monaco] PORTAL: Monaco load failed, using fallback textarea",
+            );
             $("#fc-monaco").hide();
             $("#fc-fallback").show().val(code);
             $("#fc-head-monaco").hide();
@@ -819,11 +1048,15 @@
             return;
           }
 
-          console.log("[FC-Monaco] PORTAL: applying JSX defaults before model creation");
+          console.log(
+            "[FC-Monaco] PORTAL: applying JSX defaults before model creation",
+          );
           window.__fcApplyJsxDefaults();
           var opts = window.__fcEditorOpts;
 
-          var jsxUri = monaco.Uri.parse("file:///fc-portal-" + node.id + ".jsx");
+          var jsxUri = monaco.Uri.parse(
+            "file:///fc-portal-" + node.id + ".jsx",
+          );
           console.log("[FC-Monaco] PORTAL: JSX model URI=" + jsxUri.toString());
           var existingJsx = monaco.editor.getModel(jsxUri);
           if (existingJsx) {
@@ -831,15 +1064,21 @@
             existingJsx.dispose();
           }
           var jsxModel = monaco.editor.createModel(code, "javascript", jsxUri);
-          console.log("[FC-Monaco] PORTAL: JSX model created, language=" + jsxModel.getLanguageId());
+          console.log(
+            "[FC-Monaco] PORTAL: JSX model created, language=" +
+              jsxModel.getLanguageId(),
+          );
           editorInstance = monaco.editor.create(
             document.getElementById("fc-monaco"),
             Object.assign({ model: jsxModel }, opts),
           );
           console.log("[FC-Monaco] PORTAL: JSX editor created");
-          if (window.__fcAttachSelfClose) window.__fcAttachSelfClose(editorInstance);
+          if (window.__fcAttachSelfClose)
+            window.__fcAttachSelfClose(editorInstance);
 
-          var headUri = monaco.Uri.parse("file:///fc-head-" + node.id + ".html");
+          var headUri = monaco.Uri.parse(
+            "file:///fc-head-" + node.id + ".html",
+          );
           var existingHead = monaco.editor.getModel(headUri);
           if (existingHead) existingHead.dispose();
           var headModel = monaco.editor.createModel(headCode, "html", headUri);
@@ -852,77 +1091,173 @@
           // Log markers after a short delay (diagnostics are async)
           setTimeout(function () {
             var markers = monaco.editor.getModelMarkers({ resource: jsxUri });
-            console.log("[FC-Monaco] PORTAL: markers after 500ms, count=" + markers.length);
+            console.log(
+              "[FC-Monaco] PORTAL: markers after 500ms, count=" +
+                markers.length,
+            );
             markers.forEach(function (m) {
-              console.log("[FC-Monaco] PORTAL marker: code=" + m.code + " severity=" + m.severity + " msg=" + m.message);
+              console.log(
+                "[FC-Monaco] PORTAL marker: code=" +
+                  m.code +
+                  " severity=" +
+                  m.severity +
+                  " msg=" +
+                  m.message,
+              );
             });
-            console.log("[FC-Monaco] PORTAL: current compilerOptions:", JSON.stringify(monaco.typescript.javascriptDefaults.getCompilerOptions()));
-            console.log("[FC-Monaco] PORTAL: current diagnosticsOptions:", JSON.stringify(monaco.typescript.javascriptDefaults.getDiagnosticsOptions()));
+            console.log(
+              "[FC-Monaco] PORTAL: current compilerOptions:",
+              JSON.stringify(
+                monaco.typescript.javascriptDefaults.getCompilerOptions(),
+              ),
+            );
+            console.log(
+              "[FC-Monaco] PORTAL: current diagnosticsOptions:",
+              JSON.stringify(
+                monaco.typescript.javascriptDefaults.getDiagnosticsOptions(),
+              ),
+            );
           }, 500);
         });
 
         // Buttons
         $("#fc-btn-starter").on("click", function () {
-          if (editorInstance) editorInstance.setValue(STARTER);
-          else $("#fc-fallback").val(STARTER);
+          $("<div>Replace current JSX with default starter code?</div>").dialog({
+            title: "Load Default",
+            modal: true,
+            width: 360,
+            buttons: [
+              { text: "Cancel", click: function () { $(this).dialog("close"); } },
+              { text: "Replace", class: "primary", click: function () {
+                if (editorInstance) editorInstance.setValue(STARTER);
+                else $("#fc-fallback").val(STARTER);
+                $(this).dialog("close");
+              }},
+            ],
+            close: function () { $(this).remove(); },
+          });
         });
 
         $("#fc-btn-preview").on("click", function () {
           var ep = $("#node-input-endpoint").val();
-          if (ep) window.open(ep, "_blank");
+          var root = (RED.settings.httpNodeRoot || "/").replace(/\/$/, "");
+          if (ep) window.open(root + ep, "_blank");
         });
 
         $("#fc-btn-components").on("click", function () {
           $.getJSON("portal-react/registry", function (reg) {
-            var names = Object.keys(reg);
+            var names = Object.keys(reg).sort();
             if (!names.length) {
               RED.notify("No component nodes on canvas.", "warning");
               return;
             }
-            var html = "<p>Click to insert:</p>";
+
+            function extractProps(code) {
+              if (!code) return [];
+              var m = code.match(/function\s+\w+\s*\(\s*\{([^}]*)\}/);
+              if (!m) return [];
+              return m[1].split(",").map(function (s) { return s.trim().split(/\s*=\s*/)[0]; }).filter(Boolean);
+            }
+
+            var html =
+              '<div style="display:flex;flex-direction:column;height:100%;overflow:hidden;">' +
+              '<input type="text" id="fc-comp-search" placeholder="Search..." ' +
+              'style="width:100%;box-sizing:border-box;margin-bottom:6px;padding:5px 8px;border:1px solid rgba(128,128,128,.4);border-radius:3px;' +
+              'background:var(--red-ui-form-input-background-color,#fff);color:var(--red-ui-form-text-color,#333);font-size:12px;flex-shrink:0;" />' +
+              '<div id="fc-comp-list" style="flex:1;overflow-y:auto;">';
+
             names.forEach(function (n) {
               var c = reg[n];
+              var props = extractProps(c.code);
+              var detailParts = [];
+              if (props.length) {
+                detailParts.push('<div style="margin:4px 0 0 0;font-size:11px;opacity:.6;">' +
+                  props.map(function (p) {
+                    return '<code style="background:rgba(128,128,128,.15);padding:0 4px;border-radius:2px;margin-right:3px;">' + p + '</code>';
+                  }).join("") + '</div>');
+              }
+              var io = [];
+              if ((c.inputs || []).length) io.push("in: " + c.inputs.join(", "));
+              if ((c.outputs || []).length) io.push("out: " + c.outputs.join(", "));
+              if (io.length) {
+                detailParts.push('<div style="font-size:10px;opacity:.4;margin-top:2px;">' + io.join(" &bull; ") + '</div>');
+              }
+              var hasDetail = detailParts.length > 0;
+
               html +=
-                '<div style="padding:4px 0;border-bottom:1px solid rgba(128,128,128,.2)">' +
-                '<button class="red-ui-button fc-lib-ins" data-name="' +
-                n +
-                '">' +
-                n +
-                "</button>" +
-                ' <span style="opacity:.5;font-size:11px">in:[' +
-                (c.inputs || []).join(",") +
-                "] out:[" +
-                (c.outputs || []).join(",") +
-                "]</span></div>";
+                '<div class="fc-comp-item" data-name="' + n + '" data-search="' + n.toLowerCase() + '" ' +
+                'style="border-bottom:1px solid rgba(128,128,128,.1);">' +
+                '<div style="display:flex;align-items:center;padding:4px 6px;cursor:pointer;" class="fc-comp-row">' +
+                (hasDetail ? '<i class="fa fa-caret-right fc-comp-arrow" style="width:14px;opacity:.4;font-size:12px;transition:transform .15s;"></i>' : '<span style="width:14px;"></span>') +
+                '<span class="fc-comp-name" data-name="' + n + '" style="font-weight:600;font-size:12px;flex:1;">' + n + '</span>' +
+                '</div>' +
+                (hasDetail ? '<div class="fc-comp-detail" style="display:none;padding:0 6px 4px 20px;">' + detailParts.join("") + '</div>' : '') +
+                '</div>';
             });
-            $("<div></div>")
-              .html(html)
-              .dialog({
-                title: "Available Components",
-                modal: true,
-                width: 400,
-                buttons: [
-                  {
-                    text: "Close",
-                    click: function () {
-                      $(this).dialog("close");
-                    },
-                  },
-                ],
-                close: function () {
-                  $(this).remove();
-                },
+            html += '</div></div>';
+
+            var $dlg = $("<div></div>").html(html).dialog({
+              title: "Components",
+              modal: true,
+              width: 380,
+              buttons: [
+                { text: "Close", click: function () { $(this).dialog("close"); } },
+              ],
+              close: function () { $(this).remove(); },
+            });
+
+            // Search
+            $dlg.find("#fc-comp-search").on("input", function () {
+              var q = $(this).val().toLowerCase();
+              $dlg.find(".fc-comp-item").each(function () {
+                $(this).toggle($(this).data("search").indexOf(q) !== -1);
               });
-            $(document).on("click", ".fc-lib-ins", function () {
-              var tag = "<" + $(this).data("name") + " />";
+            }).focus();
+
+            // Hover
+            $dlg.on("mouseenter", ".fc-comp-row", function () {
+              $(this).css("background", "rgba(128,128,128,.1)");
+            }).on("mouseleave", ".fc-comp-row", function () {
+              $(this).css("background", "");
+            });
+
+            // Arrow toggle detail
+            $dlg.on("click", ".fc-comp-arrow", function (e) {
+              e.stopPropagation();
+              var $item = $(this).closest(".fc-comp-item");
+              var $detail = $item.find(".fc-comp-detail");
+              var open = $detail.is(":visible");
+              $detail.slideToggle(100);
+              $(this).css("transform", open ? "" : "rotate(90deg)");
+            });
+
+            // Click name: delete selection, insert <Tag></Tag> in one line, cursor between tags
+            $dlg.on("click", ".fc-comp-name", function () {
+              var name = $(this).data("name");
+              var openTag = "<" + name + ">";
+              var closeTag = "</" + name + ">";
+              var text = openTag + closeTag;
+              $dlg.dialog("close");
               if (editorInstance) {
-                editorInstance.trigger("keyboard", "type", { text: tag });
-                editorInstance.focus();
+                var sel = editorInstance.getSelection();
+                var startLine = sel.startLineNumber;
+                var startCol = sel.startColumn;
+                editorInstance.executeEdits("fc-components", [{
+                  range: sel,
+                  text: text,
+                }]);
+                setTimeout(function () {
+                  editorInstance.setPosition({ lineNumber: startLine, column: startCol + openTag.length });
+                  editorInstance.focus();
+                }, 50);
               } else {
                 var ta = $("#fc-fallback")[0];
-                var p = ta.selectionStart,
-                  v = ta.value;
-                ta.value = v.slice(0, p) + tag + v.slice(p);
+                var s = ta.selectionStart, e = ta.selectionEnd, v = ta.value;
+                ta.value = v.slice(0, s) + text + v.slice(e);
+                setTimeout(function () {
+                  ta.selectionStart = ta.selectionEnd = s + openTag.length;
+                  ta.focus();
+                }, 50);
               }
             });
           });
@@ -931,6 +1266,19 @@
 
       oneditsave: function () {
         console.log("[FC-Monaco] PORTAL oneditsave");
+
+        // Collect libs from editableList
+        var libs = [];
+        var items = $("#node-input-libs-container").editableList("items");
+        items.each(function() {
+          var mod = $(this).data("mod").val().trim();
+          var v = $(this).data("var").val().trim();
+          if (mod) {
+            libs.push({ module: mod, var: v });
+          }
+        });
+        this.libs = libs;
+
         var code = editorInstance
           ? editorInstance.getValue()
           : $("#fc-fallback").val();
@@ -997,15 +1345,20 @@
      Help
      ============================================================ -->
 <script type="text/html" data-help-name="portal-react">
+  <h3>Quick Reference</h3>
+  <ul>
+    <li><code>useNodeRed()</code> &rarr; <code>{ data, send, user }</code></li>
+    <li>Components from <code>fc-portal-component</code> nodes are auto-imported</li>
+    <li>Must export <code>&lt;App /&gt;</code></li>
+    <li>JSX is transpiled server-side at deploy</li>
+  </ul>
+
   <p>
-    Renders a React application on a configurable HTTP endpoint with live
-    WebSocket data binding.
-  </p>
-  <h3>Key difference from Dashboard 2.0</h3>
-  <p>
-    JSX is transpiled <strong>server-side at deploy time</strong> using Sucrase.
-    The browser receives plain JS — no Babel, no runtime compilation. Page
-    weight: ~45 KB (React production).
+    Renders a React 19 application on a configurable HTTP endpoint with live
+    WebSocket data binding. JSX is transpiled <strong>server-side at deploy
+    time</strong> using esbuild — browsers receive pre-compiled JS with zero
+    runtime compilation. Tailwind CSS 4 utility classes are generated
+    server-side and served as static CSS.
   </p>
 
   <h3>Inputs</h3>
@@ -1013,21 +1366,36 @@
     <code>msg.payload</code> is pushed to all connected clients via WebSocket.
   </p>
   <pre>
-const { data, send } = useNodeRed();
-// data = last msg.payload</pre
+const { data, send, user } = useNodeRed();
+// data = last msg.payload (reactive)
+// send(payload, topic?) — emit msg on output wire
+// user = portal auth data or null</pre
   >
 
   <h3>Outputs</h3>
   <p>
     <code>send(payload, topic?)</code> emits a <code>msg</code> on the node's
-    output wire.
+    output wire via WebSocket.
+  </p>
+
+  <h3>npm Packages</h3>
+  <p>
+    Add npm packages in the <strong>Modules</strong> list (e.g.
+    <code>chart.js/auto@^4.4.0</code>, <code>d3</code>, <code>three</code>).
+    Node-RED auto-installs them at deploy time. All packages are bundled with
+    React into a single vendor IIFE via esbuild, cached by hash of installed
+    versions. Use them in JSX via standard imports.
   </p>
 
   <h3>Deploy behavior</h3>
   <ul>
     <li>
-      Each deploy re-transpiles JSX (cached by content hash — unchanged code is
-      instant)
+      Each deploy re-transpiles JSX via esbuild and rebuilds Tailwind CSS
+      (both cached by content hash — unchanged code is instant)
+    </li>
+    <li>
+      Vendor bundle (React + npm packages) rebuilt only when package versions
+      change
     </li>
     <li>
       Active WebSocket clients receive close code 1001 and auto-reconnect
@@ -1045,15 +1413,34 @@ const { data, send } = useNodeRed();
   <p>
     Components defined in <strong>fc-portal-component</strong> nodes on the
     canvas are auto-injected into every portal-react page. Use them as JSX tags
-    by their component name.
+    by their component name — no imports needed.
   </p>
 
+  <h3>Portal Auth</h3>
+  <p>
+    When enabled in the Auth tab, reads <code>X-Portal-*</code> headers set by
+    a reverse proxy (e.g. Nginx) and exposes user data:
+  </p>
+  <ul>
+    <li><code>useNodeRed()</code> returns <code>{ data, send, user }</code></li>
+    <li>
+      Messages from WebSocket include <code>msg._client</code> with user info
+    </li>
+  </ul>
+
   <h3>Custom Head HTML</h3>
   <p>
     Inject CDN links, fonts, or extra stylesheets into
     <code>&lt;head&gt;</code>. Example:
   </p>
   <pre>
-&lt;link href="https://fonts.googleapis.com/css2?family=Inter&display=swap" rel="stylesheet"&gt;</pre
+&lt;link href="https://fonts.googleapis.com/css2?family=Inter&amp;display=swap" rel="stylesheet"&gt;</pre
   >
+
+  <h3>WebSocket Status</h3>
+  <p>
+    Optional <em>fromcubes</em> badge in the bottom-right corner showing
+    connection state. Enable via the <strong>Show WebSocket status
+    indicator</strong> checkbox (off by default).
+  </p>
 </script>