citadel_cli 1.1.5 → 1.1.6

package/dist/citadel.es.js

@@ -1,13 +1,13 @@
 var ge = Object.defineProperty;
 var fe = (r, e, n) => e in r ? ge(r, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : r[e] = n;
-var b = (r, e, n) => fe(r, typeof e != "symbol" ? e + "" : e, n);
+var y = (r, e, n) => fe(r, typeof e != "symbol" ? e + "" : e, n);
 import { jsx as m, jsxs as _, Fragment as we } from "react/jsx-runtime";
-import L, { createContext as be, useEffect as A, useContext as Y, useState as R, useCallback as w, useMemo as V, useReducer as ye, useRef as H } from "react";
+import L, { createContext as be, useEffect as A, useContext as Y, useState as R, useCallback as b, useMemo as V, useReducer as ye, useRef as P } from "react";
 import { createRoot as xe } from "react-dom/client";
 var T = /* @__PURE__ */ ((r) => (r.Pending = "pending", r.Success = "success", r.Failure = "failure", r.Timeout = "timeout", r))(T || {});
 class U {
   constructor(e = Date.now()) {
-    b(this, "_status", "pending");
+    y(this, "_status", "pending");
     this.timestamp = e;
   }
   get status() {
@@ -76,7 +76,7 @@ const Se = (r) => async function() {
   );
 };
 var W = /* @__PURE__ */ ((r) => (r[r.NONE = 0] = "NONE", r[r.ERROR = 1] = "ERROR", r[r.WARN = 2] = "WARN", r[r.INFO = 3] = "INFO", r[r.DEBUG = 4] = "DEBUG", r[r.TRACE = 5] = "TRACE", r))(W || {});
-class C {
+class E {
   static configure(e) {
     this.level = e.level, this.prefix = e.prefix || "[Citadel]";
   }
@@ -96,7 +96,7 @@ class C {
     this.level >= 1 && console.error(this.prefix, ...e);
   }
 }
-b(C, "level", 0), b(C, "prefix", "");
+y(E, "level", 0), y(E, "prefix", "");
 const z = {
   commandTimeoutMs: 1e4,
   cursorColor: "var(--cursor-color, #fff)",
@@ -118,7 +118,7 @@ const z = {
 };
 class ie {
   constructor(e) {
-    b(this, "config");
+    y(this, "config");
     this.config = {
       type: "localStorage",
       maxCommands: 100,
@@ -138,7 +138,7 @@ class ie {
 class ke extends ie {
   constructor(n) {
     super(n);
-    b(this, "storageKey", "citadel_command_history");
+    y(this, "storageKey", "citadel_command_history");
   }
   async getStoredCommands() {
     try {
@@ -173,7 +173,7 @@ class ke extends ie {
 class Ee extends ie {
   constructor(n) {
     super(n);
-    b(this, "storedCommands", []);
+    y(this, "storedCommands", []);
   }
   async getStoredCommands() {
     return this.storedCommands.map((n) => ({
@@ -193,7 +193,7 @@ class Ee extends ie {
 }
 const D = class D {
   constructor() {
-    b(this, "currentStorage");
+    y(this, "currentStorage");
   }
   static getInstance() {
     return D.instance || (D.instance = new D()), D.instance;
@@ -212,7 +212,7 @@ const D = class D {
     return this.currentStorage;
   }
 };
-b(D, "instance");
+y(D, "instance");
 let q = D;
 const le = async () => new ae("");
 class J {
@@ -240,10 +240,10 @@ class _e extends J {
 }
 class Ae {
   constructor(e, n, t = le) {
-    b(this, "_segments");
-    b(this, "_description");
+    y(this, "_segments");
+    y(this, "_description");
     // Used by `Help` command, etc.
-    b(this, "_handler");
+    y(this, "_handler");
     this._segments = e, this._description = n, this._handler = t;
   }
   get segments() {
@@ -270,7 +270,7 @@ class Ae {
 }
 class Q {
   constructor() {
-    b(this, "_commands", []);
+    y(this, "_commands", []);
   }
   get commands() {
     return this._commands;
@@ -301,6 +301,16 @@ class Q {
       throw new Error(`Duplicate commands: '${s.fullPath_s}' and '${o.fullPath_s}'`);
     this._commands.push(o);
   }
+  /**
+   * Removes a command that exactly matches the provided path.
+   *
+   * @param path The command path to remove.
+   * @returns True if a command was removed; otherwise false.
+   */
+  removeCommand(e) {
+    const n = e.join(" "), t = this._commands.findIndex((o) => o.fullPath.join(" ") === n);
+    return t === -1 ? !1 : (this._commands.splice(t, 1), !0);
+  }
   /**
    * Retrieves a command from the registry for the given path.
    * 
@@ -346,10 +356,10 @@ class Q {
    * @returns An array of completion strings.
    */
   getCompletions(e) {
-    if (C.debug("[getCompletions] path: ", e), !e.length) {
+    if (E.debug("[getCompletions] path: ", e), !e.length) {
       const s = this._commands.map((d) => d.segments[0]), a = (d, c) => d.type === c.type && d.name === c.name;
       return s.filter(
-        (d, c, u) => c === u.findIndex((p) => a(p, d))
+        (d, c, u) => c === u.findIndex((h) => a(h, d))
       );
     }
     const n = e.length;
@@ -378,9 +388,9 @@ class Q {
 }
 class de {
   constructor() {
-    b(this, "segments", []);
-    b(this, "nullSegment", new ce());
-    b(this, "observers", []);
+    y(this, "segments", []);
+    y(this, "nullSegment", new ce());
+    y(this, "observers", []);
   }
   subscribe(e) {
     this.observers.push(e);
@@ -487,13 +497,19 @@ const ze = {
       s.storage ?? z.storage
     ), o(q.getInstance().getStorage());
   }, []), A(() => {
-    if (e && s.includeHelpCommand && !e.commandExistsForPath(["help"])) {
-      const l = Se(e);
-      e.addCommand(
-        [{ type: "word", name: "help" }],
-        "Show available commands",
-        l
-      );
+    if (e) {
+      if (s.includeHelpCommand) {
+        if (!e.commandExistsForPath(["help"])) {
+          const l = Se(e);
+          e.addCommand(
+            [{ type: "word", name: "help" }],
+            "Show available commands",
+            l
+          );
+        }
+        return;
+      }
+      e.removeCommand(["help"]);
     }
   }, [e, s.includeHelpCommand]);
   const a = {
@@ -526,13 +542,13 @@ const ze = {
 };
 class Re {
   constructor(e, n) {
-    b(this, "timestamp");
-    b(this, "command");
-    b(this, "result");
+    y(this, "timestamp");
+    y(this, "command");
+    y(this, "result");
     this.command = e.toArray().map((t) => t.type === "argument" ? t.value || "" : t.name), this.timestamp = Date.now(), this.result = n ?? new Ce();
   }
 }
-function Pe(r) {
+function He(r) {
   return {
     commandSegments: r,
     timestamp: Date.now()
@@ -542,10 +558,10 @@ function ue() {
   const r = me(), [e, n] = R({
     storedCommands: [],
     position: null
-  }), t = w(async (l) => {
+  }), t = b(async (l) => {
     if (r)
       try {
-        const d = Pe(l);
+        const d = He(l);
         await r.addStoredCommand(d), n((c) => ({
           ...c,
           storedCommands: [...c.storedCommands, d],
@@ -554,7 +570,7 @@ function ue() {
       } catch (d) {
         console.warn("Failed to save command to history:", d);
       }
-  }, [r]), o = w(async () => r ? await r.getStoredCommands() : [], [r]);
+  }, [r]), o = b(async () => r ? await r.getStoredCommands() : [], [r]);
   A(() => {
     if (!r) return;
     (async () => {
@@ -569,12 +585,12 @@ function ue() {
       }
     })();
   }, [r]);
-  const s = w(async (l) => {
+  const s = b(async (l) => {
     if ((await o()).length === 0)
       return { segments: null, position: null };
     let c = null;
-    return l === "up" ? e.position === null ? c = e.storedCommands.length - 1 : e.position > 0 ? c = e.position - 1 : c = 0 : e.position === null || e.position >= e.storedCommands.length - 1 ? c = null : c = e.position + 1, n((p) => ({
-      ...p,
+    return l === "up" ? e.position === null ? c = e.storedCommands.length - 1 : e.position > 0 ? c = e.position - 1 : c = 0 : e.position === null || e.position >= e.storedCommands.length - 1 ? c = null : c = e.position + 1, n((h) => ({
+      ...h,
       position: c
     })), c === null ? {
       segments: [],
@@ -583,7 +599,7 @@ function ue() {
       segments: c !== null ? e.storedCommands[c].commandSegments : null,
       position: c
     };
-  }, [e, o]), a = w(async () => {
+  }, [e, o]), a = b(async () => {
     try {
       if (!r) return;
       await r.clear(), n({
@@ -625,78 +641,78 @@ const X = () => {
     }));
   }, [n.history, o]);
   const l = {
-    setCurrentInput: w((u) => {
-      C.debug("[CitadelActions] setCurrentInput: ", u), a((p) => ({ ...p, currentInput: u }));
+    setCurrentInput: b((u) => {
+      E.debug("[CitadelActions] setCurrentInput: ", u), a((h) => ({ ...h, currentInput: u }));
     }, []),
-    setIsEnteringArg: w((u) => {
-      C.debug("[CitadelActions] setIsEnteringArg: ", u), a((p) => ({ ...p, isEnteringArg: u }));
+    setIsEnteringArg: b((u) => {
+      E.debug("[CitadelActions] setIsEnteringArg: ", u), a((h) => ({ ...h, isEnteringArg: u }));
     }, []),
-    addOutput: w((u) => {
-      C.debug("[CitadelActions]addOutput: ", u), a((p) => ({
-        ...p,
-        output: [...p.output, u]
+    addOutput: b((u) => {
+      E.debug("[CitadelActions]addOutput: ", u), a((h) => ({
+        ...h,
+        output: [...h.output, u]
       }));
     }, []),
-    executeCommand: w(async () => {
-      const u = t.path(), p = e.getCommand(u);
-      if (!p) {
+    executeCommand: b(async () => {
+      const u = t.path(), h = e.getCommand(u);
+      if (!h) {
         console.error("[CitadelActions][executeCommand] Cannot execute command because no command was found for the given path: ", u);
         return;
       }
-      const k = new Re(t);
-      a((y) => ({
-        ...y,
-        output: [...y.output, k]
+      const C = new Re(t);
+      a((f) => ({
+        ...f,
+        output: [...f.output, C]
       }));
       try {
-        const y = new Promise((i, h) => {
+        const f = new Promise((i, p) => {
           setTimeout(() => {
-            h(new Error("Request timed out"));
+            p(new Error("Request timed out"));
           }, r.commandTimeoutMs);
-        }), E = t.arguments.map((i) => i.value || ""), N = await Promise.race([
-          p.handler(E),
-          y
+        }), x = t.arguments.map((i) => i.value || ""), k = await Promise.race([
+          h.handler(x),
+          f
         ]);
-        if (!(N instanceof U))
+        if (!(k instanceof U))
           throw new Error(
             `The ${u.join(".")} command returned an invalid result type. Commands must return an instance of a CommandResult.
 For example:
    return new JsonCommandResult({ text: "Hello World" });
 Check the definition of the ${u.join(".")} command and update the return type for its handler.`
           );
-        N.markSuccess(), a((i) => ({
+        k.markSuccess(), a((i) => ({
           ...i,
           output: i.output.map(
-            (h) => h.timestamp === k.timestamp ? { ...h, result: N } : h
+            (p) => p.timestamp === C.timestamp ? { ...p, result: k } : p
           )
         }));
-      } catch (y) {
-        const E = new ve(
-          y instanceof Error ? y.message : "Unknown error"
+      } catch (f) {
+        const x = new ve(
+          f instanceof Error ? f.message : "Unknown error"
         );
-        E.markFailure(), a((N) => ({
-          ...N,
-          output: N.output.map(
-            (i) => i.timestamp === k.timestamp ? { ...i, result: E } : i
+        x.markFailure(), a((k) => ({
+          ...k,
+          output: k.output.map(
+            (i) => i.timestamp === C.timestamp ? { ...i, result: x } : i
           )
         }));
       }
     }, [e, r.commandTimeoutMs, t]),
-    clearHistory: w(async () => {
+    clearHistory: b(async () => {
       try {
         await n.clear();
       } catch (u) {
         console.warn("Failed to clear history:", u);
       }
     }, [n])
-  }, d = w(() => e.getCompletions_s(t.path()), [t, e]), c = w(() => e.getCompletions(t.path()), [t, e]);
+  }, d = b(() => e.getCompletions_s(t.path()), [t, e]), c = b(() => e.getCompletions(t.path()), [t, e]);
   return {
     state: s,
     actions: l,
     getAvailableCommands_s: d,
     getAvailableCommandSegments: c
   };
-}, He = ({ onOpen: r, onClose: e, isVisible: n, showCitadelKey: t }) => {
+}, Pe = ({ onOpen: r, onClose: e, isVisible: n, showCitadelKey: t }) => {
   A(() => {
     const o = (s) => {
       var a, l;
@@ -775,7 +791,7 @@ Check the definition of the ${u.join(".")} command and update the return type fo
     }
   )
 ] }), Ve = ({ output: r, outputRef: e }) => {
-  const n = F(), t = w(() => {
+  const n = F(), t = b(() => {
     if (e.current) {
       const o = e.current;
       requestAnimationFrame(() => {
@@ -841,7 +857,7 @@ Check the definition of the ${u.join(".")} command and update the return type fo
   A(() => {
     if (t.speed === 0) return;
     const u = setInterval(() => {
-      t.type === "blink" ? s((p) => !p) : ["spin", "bbs"].includes(t.type) && l((p) => (p + 1) % (t.type === "bbs" ? ne.length : ee.length));
+      t.type === "blink" ? s((h) => !h) : ["spin", "bbs"].includes(t.type) && l((h) => (h + 1) % (t.type === "bbs" ? ne.length : ee.length));
     }, t.speed);
     return () => clearInterval(u);
   }, [t.type, t.speed]);
@@ -862,7 +878,7 @@ Check the definition of the ${u.join(".")} command and update the return type fo
 function Ye(r, e) {
   switch (e.type) {
     case "set":
-      return C.debug(`[inputStateReducer] InputState changing from ${r} to ${e.state}`), e.state;
+      return E.debug(`[inputStateReducer] InputState changing from ${r} to ${e.state}`), e.state;
     default:
       return r;
   }
@@ -870,83 +886,83 @@ function Ye(r, e) {
 const Be = () => {
   const { state: r } = X(), e = B(), n = ue(), t = O(), [o, s] = ye(Ye, "idle"), a = (i) => {
     s({ type: "set", state: i });
-  }, l = w(() => {
-    const h = e.getCompletions(t.path())[0] || t.nullSegment;
-    return C.debug("[getNextExpectedSegment] ", h), h;
-  }, [e, t]), d = w(() => e.getCompletions_s(t.path()).map((h) => e.getCommand([...t.path(), h])).filter((h) => h !== void 0), [e, t]), c = w((i, h) => {
-    if (!i) return h;
-    const g = h.reduce((f, x) => {
-      const v = l();
-      return (v == null ? void 0 : v.type) === "word" && f.set(v.name, x), f;
+  }, l = b(() => {
+    const p = e.getCompletions(t.path())[0] || t.nullSegment;
+    return E.debug("[getNextExpectedSegment] ", p), p;
+  }, [e, t]), d = b(() => e.getCompletions_s(t.path()).map((p) => e.getCommand([...t.path(), p])).filter((p) => p !== void 0), [e, t]), c = b((i, p) => {
+    if (!i) return p;
+    const g = p.reduce((w, v) => {
+      const S = l();
+      return (S == null ? void 0 : S.type) === "word" && w.set(S.name, v), w;
     }, /* @__PURE__ */ new Map());
     return Array.from(g.values()).filter(() => {
-      const f = l();
-      return f.type !== "word" ? !1 : f.name.toLowerCase().startsWith(i.toLowerCase());
+      const w = l();
+      return w.type !== "word" ? !1 : w.name.toLowerCase().startsWith(i.toLowerCase());
     });
-  }, [l]), u = w((i) => {
-    const g = e.getCompletions(t.path()).filter((S) => S.type === "word").filter(
-      (S) => S.name.toLowerCase().startsWith(i.toLowerCase())
+  }, [l]), u = b((i) => {
+    const g = e.getCompletions(t.path()).filter((N) => N.type === "word").filter(
+      (N) => N.name.toLowerCase().startsWith(i.toLowerCase())
     );
     return g.length === 1 ? g[0] : t.nullSegment;
-  }, [e, t]), p = w((i) => {
-    const h = t.path(), g = e.getCompletions(h);
-    return g.length === 0 && i ? !1 : g.some((f) => f.type === "argument") ? !0 : g.some(
-      (f) => f.type === "word" && f.name.toLowerCase().startsWith(i.toLowerCase())
+  }, [e, t]), h = b((i) => {
+    const p = t.path(), g = e.getCompletions(p);
+    return g.length === 0 && i ? !1 : g.some((w) => w.type === "argument") ? !0 : g.some(
+      (w) => w.type === "word" && w.name.toLowerCase().startsWith(i.toLowerCase())
     );
-  }, [e, t]), k = w((i) => {
-    C.debug("[tryAutoComplete] input: ", i);
-    const h = u(i);
-    return !h || h.name === i ? new ce() : (C.debug("[tryAutoComplete] result: ", h), h);
-  }, [u]), y = w((i, h) => {
+  }, [e, t]), C = b((i) => {
+    E.debug("[tryAutoComplete] input: ", i);
+    const p = u(i);
+    return !p || p.name === i ? new ce() : (E.debug("[tryAutoComplete] result: ", p), p);
+  }, [u]), f = b((i, p) => {
     if (r.history.position === null) {
-      if (h.setCurrentInput(i), C.debug("[useCommandParser][handleInputChange] newValue: ", i), o === "entering_argument") {
+      if (p.setCurrentInput(i), E.debug("[useCommandParser][handleInputChange] newValue: ", i), o === "entering_argument") {
         const g = te(i);
         if (g.isQuoted)
           if (g.isComplete) {
-            const S = l();
-            if (S.type === "argument") {
-              const f = S;
-              f.value = i.trim() || "", C.debug("[useCommandParser][handleInputChange][entering_command] pushing: ", f), t.push(f), h.setCurrentInput(""), a("idle");
+            const N = l();
+            if (N.type === "argument") {
+              const w = N;
+              w.value = i.trim() || "", E.debug("[useCommandParser][handleInputChange][entering_command] pushing: ", w), t.push(w), p.setCurrentInput(""), a("idle");
               return;
             }
           } else
             return;
         else if (g.isComplete) {
-          const S = l();
-          S.value = i.trim() || "", C.debug("[useCommandParser][handleInputChange][entering_command] pushing: ", S), t.push(S), h.setCurrentInput(""), a("idle");
+          const N = l();
+          N.value = i.trim() || "", E.debug("[useCommandParser][handleInputChange][entering_command] pushing: ", N), t.push(N), p.setCurrentInput(""), a("idle");
           return;
         } else
           return;
       }
       if (o == "entering_command") {
-        const g = k(i);
+        const g = C(i);
         if (g.type === "word") {
-          C.debug("[useCommandParser][handleInputChange][entering_command] pushing: ", g), t.push(g), h.setCurrentInput(""), a("idle");
+          E.debug("[useCommandParser][handleInputChange][entering_command] pushing: ", g), t.push(g), p.setCurrentInput(""), a("idle");
           return;
         }
       }
     }
-  }, [k, r, l, o, t]), E = w((i) => {
+  }, [C, r, l, o, t]), x = b((i) => {
     i.setCurrentInput(""), i.setIsEnteringArg(!1), t.clear(), a("idle");
-  }, [t]), N = w((i, h, g) => {
+  }, [t]), k = b((i, p, g) => {
     if (!(i.key === "Backspace" || i.key === "Enter" || i.key === "ArrowUp" || i.key === "ArrowDown" || i.key === "ArrowLeft" || i.key === "ArrowRight" || i.key === "Escape" || i.key === "Delete" || i.key === "Home" || i.key === "End" || i.key.length === 1))
       return !0;
-    const { currentInput: f, isEnteringArg: x } = h, v = te(f);
+    const { currentInput: w, isEnteringArg: v } = p, S = te(w);
     switch (i.key) {
       case "Backspace":
-        return f === "" && (i.preventDefault(), t.size() > 0 && t.pop(), a("idle")), !0;
+        return w === "" && (i.preventDefault(), t.size() > 0 && t.pop(), a("idle")), !0;
       case "Enter": {
-        if (i.preventDefault(), v.isQuoted && !v.isComplete)
+        if (i.preventDefault(), S.isQuoted && !S.isComplete)
           return !0;
-        if (o === "entering_argument" || x && f.trim()) {
+        if (o === "entering_argument" || v && w.trim()) {
           const G = l();
-          G.value = f, C.debug("[handleKeyDown][Enter]['entering_argument'] pushing: ", G), t.push(G);
+          G.value = w, E.debug("[handleKeyDown][Enter]['entering_argument'] pushing: ", G), t.push(G);
         }
-        const I = t.path(), P = e.getCommand(I);
-        if (!P)
+        const I = t.path(), H = e.getCommand(I);
+        if (!H)
           return !1;
-        const $ = P.segments.filter((M) => M.type === "argument"), K = t.arguments;
-        return $.length > K.length ? !1 : (C.debug("[handleKeyDown][Enter] calling actions.executeCommand. segmentStack: ", t), g.executeCommand(), n.addStoredCommand(t.toArray()), E(g), !0);
+        const $ = H.segments.filter((M) => M.type === "argument"), K = t.arguments;
+        return $.length > K.length ? !1 : (E.debug("[handleKeyDown][Enter] calling actions.executeCommand. segmentStack: ", t), g.executeCommand(), n.addStoredCommand(t.toArray()), x(g), !0);
       }
       case "ArrowUp":
         return i.preventDefault(), (async () => {
@@ -959,9 +975,9 @@ const Be = () => {
           return I.segments && (t.clear(), t.pushAll(I.segments), g.setCurrentInput("")), !0;
         })();
       default: {
-        if (!x && i.key.length === 1) {
-          const I = f + i.key;
-          if (!p(I))
+        if (!v && i.key.length === 1) {
+          const I = w + i.key;
+          if (!h(I))
             return i.preventDefault(), !1;
         }
         return !0;
@@ -969,16 +985,16 @@ const Be = () => {
     }
   }, [
     o,
-    p,
+    h,
     l,
     n,
-    E,
+    x,
     e,
     t
   ]);
   return {
-    handleInputChange: y,
-    handleKeyDown: N,
+    handleInputChange: f,
+    handleKeyDown: k,
     inputState: o,
     setInputStateWithLogging: a,
     // Expose internal functions for testing
@@ -986,7 +1002,7 @@ const Be = () => {
     getAutocompleteSuggestion: u,
     getAvailableNodes: d,
     getNextExpectedSegment: l,
-    isValidCommandInput: p
+    isValidCommandInput: h
   };
 };
 function te(r) {
@@ -1020,62 +1036,62 @@ const Ge = () => {
   state: r,
   actions: e
 }) => {
-  const n = H(null), t = B(), o = O(), {
+  const n = P(null), t = B(), o = O(), {
     handleKeyDown: s,
     handleInputChange: a,
     inputState: l,
     setInputStateWithLogging: d,
     getNextExpectedSegment: c
-  } = Be(), [u, p] = R(!1), k = F(), y = Ge(), E = async (x) => {
-    const v = s(x, r, e);
-    await Promise.resolve(v) === !1 && (p(!0), setTimeout(() => p(!1), 500));
-  }, N = (x) => {
-    a(x.target.value, e);
-  }, i = (x) => {
-    x.preventDefault();
-    const v = x.clipboardData.getData("text");
-    a(v, e);
+  } = Be(), [u, h] = R(!1), C = F(), f = Ge(), x = async (v) => {
+    const S = s(v, r, e);
+    await Promise.resolve(S) === !1 && (h(!0), setTimeout(() => h(!1), 500));
+  }, k = (v) => {
+    a(v.target.value, e);
+  }, i = (v) => {
+    v.preventDefault();
+    const S = v.clipboardData.getData("text");
+    a(S, e);
   };
   A(() => {
     n.current && n.current.focus(), l !== "entering_command" && d("entering_command");
   }, [l, d]), A(() => {
     if (l !== "idle") return;
-    const x = c();
-    let v = "idle";
-    switch (x.type) {
+    const v = c();
+    let S = "idle";
+    switch (v.type) {
       case "word":
-        v = "entering_command", e.setIsEnteringArg(!1);
+        S = "entering_command", e.setIsEnteringArg(!1);
         break;
       case "argument":
-        v = "entering_argument", e.setIsEnteringArg(!0);
+        S = "entering_argument", e.setIsEnteringArg(!0);
         break;
     }
-    d(v);
-  }, [y, l, c, d, e]);
-  const [h, g] = R([]);
+    d(S);
+  }, [f, l, c, d, e]);
+  const [p, g] = R([]);
   A(() => {
-    const x = [], v = o.toArray().map((P, $) => {
-      x.push(P.name);
-      const K = t.hasNextSegment(x);
-      if (P.type === "argument") {
-        const M = P;
+    const v = [], S = o.toArray().map((H, $) => {
+      v.push(H.name);
+      const K = t.hasNextSegment(v);
+      if (H.type === "argument") {
+        const M = H;
         return /* @__PURE__ */ _(L.Fragment, { children: [
           /* @__PURE__ */ m("span", { className: "text-gray-200 whitespace-pre", children: M.value }),
           $ < o.size() && K && /* @__PURE__ */ m("span", { className: "text-gray-200 whitespace-pre", children: " " })
         ] }, "arg-" + M.name + M.value);
       }
       return /* @__PURE__ */ _(L.Fragment, { children: [
-        /* @__PURE__ */ m("span", { className: "text-blue-400 whitespace-pre", children: P.name }),
+        /* @__PURE__ */ m("span", { className: "text-blue-400 whitespace-pre", children: H.name }),
         $ < o.size() && K && /* @__PURE__ */ m("span", { className: "text-blue-400 whitespace-pre", children: " " })
-      ] }, "word-" + P.name);
+      ] }, "word-" + H.name);
     });
-    g([/* @__PURE__ */ m("div", { className: "flex items-center gap-1", "data-testid": "user-input-area", children: v }, "{segmentStackVersion}")]);
-  }, [y, t, o]);
-  const [S, f] = R("");
+    g([/* @__PURE__ */ m("div", { className: "flex items-center gap-1", "data-testid": "user-input-area", children: S }, "{segmentStackVersion}")]);
+  }, [f, t, o]);
+  const [N, w] = R("");
   return A(() => {
-    const x = c();
-    x.type === "argument" ? f(x.name) : f("");
-  }, [y, c]), /* @__PURE__ */ _("div", { className: "flex flex-col w-full bg-gray-900 rounded-lg p-4", children: [
+    const v = c();
+    v.type === "argument" ? w(v.name) : w("");
+  }, [f, c]), /* @__PURE__ */ _("div", { className: "flex flex-col w-full bg-gray-900 rounded-lg p-4", children: [
     /* @__PURE__ */ m("style", { children: `
         @keyframes subtleGlow {
           0%, 100% { box-shadow: 0 0 0 rgba(239, 68, 68, 0); }
@@ -1088,7 +1104,7 @@ const Ge = () => {
     /* @__PURE__ */ _("div", { className: "flex items-center gap-2", children: [
       /* @__PURE__ */ m("div", { className: "text-gray-400 font-mono", children: ">" }),
       /* @__PURE__ */ _("div", { className: "flex-1 font-mono flex items-center", children: [
-        h,
+        p,
         /* @__PURE__ */ _("div", { className: "relative flex-1", children: [
           /* @__PURE__ */ m(
             "input",
@@ -1097,14 +1113,14 @@ const Ge = () => {
               type: "text",
               role: "textbox",
               value: r.currentInput,
-              onChange: N,
-              onKeyDown: E,
+              onChange: k,
+              onKeyDown: x,
               onPaste: i,
               "data-testid": "citadel-command-input",
               className: `w-full bg-transparent outline-none text-gray-200 caret-transparent ${u ? "invalid-input-animation" : ""}`,
               spellCheck: !1,
               autoComplete: "off",
-              placeholder: S
+              placeholder: N
             }
           ),
           /* @__PURE__ */ m(
@@ -1119,9 +1135,9 @@ const Ge = () => {
                 qe,
                 {
                   style: {
-                    type: k.cursorType ?? z.cursorType,
-                    color: k.cursorColor || z.cursorColor,
-                    speed: k.cursorSpeed || z.cursorSpeed
+                    type: C.cursorType ?? z.cursorType,
+                    color: C.cursorColor || z.cursorColor,
+                    speed: C.cursorSpeed || z.cursorSpeed
                   }
                 }
               )
@@ -1132,14 +1148,16 @@ const Ge = () => {
     ] })
   ] });
 }, Qe = () => {
-  const r = B(), e = F(), n = O(), t = "h-12 mt-2 border-t border-gray-700 px-4", o = "text-gray-300 pt-2", s = r.getCompletions(n.path());
-  C.debug("[AvailableCommands] nextCommandSegments: ", s);
+  const r = B(), e = F(), n = O(), t = "mt-2 border-t border-gray-700 px-4 py-2", o = "text-gray-300", s = r.getCompletions(n.path());
+  E.debug("[AvailableCommands] nextCommandSegments: ", s);
   const a = L.useMemo(() => {
-    if (e.includeHelpCommand) {
-      const c = s.filter((p) => p.name !== "help"), u = s.find((p) => p.name === "help");
-      return [...c, ...u ? [u] : []];
-    }
-    return s;
+    const c = [...s], u = (x) => x.name.toLowerCase() === "help", C = c.filter((x) => !u(x)).sort(
+      (x, k) => x.name.localeCompare(k.name, void 0, { sensitivity: "base" })
+    );
+    if (!e.includeHelpCommand)
+      return C;
+    const f = c.find(u);
+    return f ? [...C, f] : C;
   }, [s, e.includeHelpCommand]), l = s.some((c) => c.type === "argument"), d = s[0];
   return /* @__PURE__ */ m("div", { className: t, "data-testid": "available-commands", children: /* @__PURE__ */ m("div", { className: o, children: l ? s.length > 0 ? /* @__PURE__ */ _(we, { children: [
     /* @__PURE__ */ m("span", { className: "text-blue-400", children: d.name }),
@@ -1148,12 +1166,12 @@ const Ge = () => {
       d.description
     ] })
   ] }) : null : /* @__PURE__ */ m("div", { className: "flex flex-wrap gap-2", children: a == null ? void 0 : a.map((c) => {
-    const u = a == null ? void 0 : a.reduce((p, k) => {
-      if (k === c) return p;
-      let y = 0;
-      for (; y < c.name.length && y < k.name.length && c.name[y].toLowerCase() === k.name[y].toLowerCase(); )
-        y++;
-      return Math.max(p, y + 1);
+    const u = a == null ? void 0 : a.reduce((h, C) => {
+      if (C === c) return h;
+      let f = 0;
+      for (; f < c.name.length && f < C.name.length && c.name[f].toLowerCase() === C.name[f].toLowerCase(); )
+        f++;
+      return Math.max(h, f + 1);
     }, 1);
     return /* @__PURE__ */ m(
       "div",
@@ -1178,36 +1196,36 @@ const Ge = () => {
     /* @__PURE__ */ m(Qe, {})
   ] })
 ] }), Xe = () => {
-  const [r, e] = R(!1), [n, t] = R(!1), o = F(), [s, a] = R(() => o.initialHeight || null), l = H(null), d = H(null), c = H(!1), u = H(0), p = H(0), { state: k, actions: y } = X();
-  He({
+  const [r, e] = R(!1), [n, t] = R(!1), o = F(), [s, a] = R(() => o.initialHeight || null), l = P(null), d = P(null), c = P(!1), u = P(0), h = P(0), { state: C, actions: f } = X();
+  Pe({
     onOpen: () => e(!0),
     onClose: () => t(!0),
     isVisible: r,
     showCitadelKey: o.showCitadelKey || "."
   });
-  const E = w((g) => {
-    var v;
+  const x = b((g) => {
+    var S;
     if (!c.current) return;
-    const S = g.clientY - u.current, f = (v = o.maxHeight) != null && v.endsWith("vh") ? window.innerHeight * parseInt(o.maxHeight, 10) / 100 : parseInt(o.maxHeight || "80vh", 10), x = Math.min(
-      Math.max(p.current - S, parseInt(o.minHeight || "200", 10)),
-      f
+    const N = g.clientY - u.current, w = (S = o.maxHeight) != null && S.endsWith("vh") ? window.innerHeight * parseInt(o.maxHeight, 10) / 100 : parseInt(o.maxHeight || "80vh", 10), v = Math.min(
+      Math.max(h.current - N, parseInt(o.minHeight || "200", 10)),
+      w
     );
-    d.current && (d.current.style.height = `${x}px`, d.current.style.bottom = "0", a(`${x}px`));
-  }, [o.maxHeight, o.minHeight]), N = w(() => {
-    c.current = !1, document.documentElement.style.userSelect = "", document.documentElement.style.webkitUserSelect = "", document.documentElement.style.mozUserSelect = "", document.documentElement.style.msUserSelect = "", document.removeEventListener("mousemove", E), document.removeEventListener("mouseup", N);
-  }, [E]), i = w((g) => {
-    d.current && (c.current = !0, u.current = g.clientY, p.current = d.current.offsetHeight, document.documentElement.style.userSelect = "none", document.documentElement.style.webkitUserSelect = "none", document.documentElement.style.mozUserSelect = "none", document.documentElement.style.msUserSelect = "none", document.addEventListener("mousemove", E), document.addEventListener("mouseup", N));
-  }, [E, N]);
+    d.current && (d.current.style.height = `${v}px`, d.current.style.bottom = "0", a(`${v}px`));
+  }, [o.maxHeight, o.minHeight]), k = b(() => {
+    c.current = !1, document.documentElement.style.userSelect = "", document.documentElement.style.webkitUserSelect = "", document.documentElement.style.mozUserSelect = "", document.documentElement.style.msUserSelect = "", document.removeEventListener("mousemove", x), document.removeEventListener("mouseup", k);
+  }, [x]), i = b((g) => {
+    d.current && (c.current = !0, u.current = g.clientY, h.current = d.current.offsetHeight, document.documentElement.style.userSelect = "none", document.documentElement.style.webkitUserSelect = "none", document.documentElement.style.mozUserSelect = "none", document.documentElement.style.msUserSelect = "none", document.addEventListener("mousemove", x), document.addEventListener("mouseup", k));
+  }, [x, k]);
   A(() => () => {
-    document.removeEventListener("mousemove", E), document.removeEventListener("mouseup", N);
-  }, [E, N]);
-  const h = w(() => {
+    document.removeEventListener("mousemove", x), document.removeEventListener("mouseup", k);
+  }, [x, k]);
+  const p = b(() => {
     n && (e(!1), t(!1));
   }, [n]);
   return $e({
     isVisible: r,
     isClosing: n,
-    onAnimationComplete: h
+    onAnimationComplete: p
   }), r ? /* @__PURE__ */ _(
     "div",
     {
@@ -1222,8 +1240,8 @@ const Ge = () => {
         /* @__PURE__ */ m(
           pe,
           {
-            state: k,
-            actions: y,
+            state: C,
+            actions: f,
             outputRef: l
           }
         )
@@ -1231,7 +1249,7 @@ const Ge = () => {
     }
   ) : null;
 }, Ze = () => {
-  const { state: r, actions: e } = X(), n = H(null);
+  const { state: r, actions: e } = X(), n = P(null);
   return /* @__PURE__ */ m(
     "div",
     {
@@ -2258,9 +2276,9 @@ video {
   commandRegistry: e = new Q(),
   containerId: n = null
 }) => {
-  const t = H(null), o = r.displayMode ?? z.displayMode ?? "panel";
+  const t = P(null), o = r.displayMode ?? z.displayMode ?? "panel";
   return A(() => {
-    C.configure({
+    E.configure({
       level: r.logLevel || z.logLevel || W.ERROR,
       prefix: "[Citadel]"
     });
@@ -2284,10 +2302,10 @@ class he extends HTMLElement {
   constructor(n, t) {
     var s;
     super();
-    b(this, "shadow");
-    b(this, "root", null);
-    b(this, "commandRegistry");
-    b(this, "config");
+    y(this, "shadow");
+    y(this, "root", null);
+    y(this, "commandRegistry");
+    y(this, "config");
     this.shadow = this.attachShadow({ mode: "open" }), this.commandRegistry = n, this.config = t;
     const o = ((s = this.config) == null ? void 0 : s.displayMode) ?? "panel";
     this.setAttribute("data-display-mode", o);

package/dist/citadel.umd.js

@@ -1,9 +1,9 @@
-(function(w,i){typeof exports=="object"&&typeof module<"u"?i(exports,require("react/jsx-runtime"),require("react"),require("react-dom/client")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react","react-dom/client"],i):(w=typeof globalThis<"u"?globalThis:w||self,i(w.Citadel={},w.jsxRuntime,w.React,w.client))})(this,function(w,i,s,pe){"use strict";var Ke=Object.defineProperty;var Le=(w,i,s)=>i in w?Ke(w,i,{enumerable:!0,configurable:!0,writable:!0,value:s}):w[i]=s;var y=(w,i,s)=>Le(w,typeof i!="symbol"?i+"":i,s);var D=(r=>(r.Pending="pending",r.Success="success",r.Failure="failure",r.Timeout="timeout",r))(D||{});class P{constructor(e=Date.now()){y(this,"_status","pending");this.timestamp=e}get status(){return this._status}markSuccess(){this._status="success"}markFailure(){this._status="failure"}markTimeout(){this._status="timeout"}}class he extends P{constructor(e,n){super(n),this.data=e}render(){return i.jsx("pre",{className:"text-gray-200",children:JSON.stringify(this.data,null,2)})}}class V extends P{constructor(e,n){super(n),this.text=e}render(){return i.jsx("div",{className:"text-gray-200 whitespace-pre font-mono",children:this.text})}}class G extends P{constructor(e,n){super(n),this.error=e,this.markFailure()}render(){return i.jsx("div",{className:"mt-1 text-red-400",children:this.error})}}class J extends P{render(){return i.jsx("div",{className:"text-gray-400",children:"..."})}}class ge extends P{constructor(e,n="",t){super(t),this.imageUrl=e,this.altText=n}render(){return i.jsx("div",{className:"my-2",children:i.jsx("img",{src:this.imageUrl,alt:this.altText,className:"max-w-[400px] max-h-[300px] h-auto rounded-lg object-contain"})})}}const fe=r=>async function(){const e=r.commands.filter(n=>n.fullPath[0]!=="help").map(n=>`${n.segments.map(o=>o.type==="argument"?`<${o.name}>`:o.name).join(" ")} - ${n.description}`).sort();return e.push("help - Show available commands"),new V(e.length>0?`Available Commands:
+(function(w,a){typeof exports=="object"&&typeof module<"u"?a(exports,require("react/jsx-runtime"),require("react"),require("react-dom/client")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react","react-dom/client"],a):(w=typeof globalThis<"u"?globalThis:w||self,a(w.Citadel={},w.jsxRuntime,w.React,w.client))})(this,function(w,a,s,pe){"use strict";var $e=Object.defineProperty;var Ke=(w,a,s)=>a in w?$e(w,a,{enumerable:!0,configurable:!0,writable:!0,value:s}):w[a]=s;var x=(w,a,s)=>Ke(w,typeof a!="symbol"?a+"":a,s);var D=(r=>(r.Pending="pending",r.Success="success",r.Failure="failure",r.Timeout="timeout",r))(D||{});class P{constructor(e=Date.now()){x(this,"_status","pending");this.timestamp=e}get status(){return this._status}markSuccess(){this._status="success"}markFailure(){this._status="failure"}markTimeout(){this._status="timeout"}}class he extends P{constructor(e,n){super(n),this.data=e}render(){return a.jsx("pre",{className:"text-gray-200",children:JSON.stringify(this.data,null,2)})}}class V extends P{constructor(e,n){super(n),this.text=e}render(){return a.jsx("div",{className:"text-gray-200 whitespace-pre font-mono",children:this.text})}}class G extends P{constructor(e,n){super(n),this.error=e,this.markFailure()}render(){return a.jsx("div",{className:"mt-1 text-red-400",children:this.error})}}class J extends P{render(){return a.jsx("div",{className:"text-gray-400",children:"..."})}}class ge extends P{constructor(e,n="",t){super(t),this.imageUrl=e,this.altText=n}render(){return a.jsx("div",{className:"my-2",children:a.jsx("img",{src:this.imageUrl,alt:this.altText,className:"max-w-[400px] max-h-[300px] h-auto rounded-lg object-contain"})})}}const fe=r=>async function(){const e=r.commands.filter(n=>n.fullPath[0]!=="help").map(n=>`${n.segments.map(o=>o.type==="argument"?`<${o.name}>`:o.name).join(" ")} - ${n.description}`).sort();return e.push("help - Show available commands"),new V(e.length>0?`Available Commands:
 `+e.join(`
-`):"No commands available yet. Add some commands to get started!")};var j=(r=>(r[r.NONE=0]="NONE",r[r.ERROR=1]="ERROR",r[r.WARN=2]="WARN",r[r.INFO=3]="INFO",r[r.DEBUG=4]="DEBUG",r[r.TRACE=5]="TRACE",r))(j||{});class S{static configure(e){this.level=e.level,this.prefix=e.prefix||"[Citadel]"}static trace(...e){this.level>=5&&process.env.NODE_ENV!=="production"&&console.trace(this.prefix,...e)}static debug(...e){this.level>=4&&process.env.NODE_ENV!=="production"&&console.debug(this.prefix,...e)}static info(...e){this.level>=3&&console.info(this.prefix,...e)}static warn(...e){this.level>=2&&console.warn(this.prefix,...e)}static error(...e){this.level>=1&&console.error(this.prefix,...e)}}y(S,"level",0),y(S,"prefix","");const A={commandTimeoutMs:1e4,cursorColor:"var(--cursor-color, #fff)",cursorSpeed:530,cursorType:"blink",includeHelpCommand:!0,initialHeight:"40vh",logLevel:process.env.NODE_ENV==="production"?j.ERROR:j.DEBUG,maxHeight:"80vh",minHeight:"200",outputFontSize:"0.875rem",resetStateOnHide:!1,showCitadelKey:".",displayMode:"panel",storage:{type:"localStorage",maxCommands:100}};class Q{constructor(e){y(this,"config");this.config={type:"localStorage",maxCommands:100,...e}}async addStoredCommand(e){const n=await this.getStoredCommands();for(n.push(e);n.length>this.config.maxCommands;)n.shift();await this.saveCommands(n)}}class we extends Q{constructor(n){super(n);y(this,"storageKey","citadel_command_history")}async getStoredCommands(){try{const n=window.localStorage.getItem(this.storageKey);return n?JSON.parse(n).map(o=>({commandSegments:o.commandSegments||[],timestamp:o.timestamp})):[]}catch(n){return console.warn("Failed to load commands from localStorage:",n),[]}}async clear(){try{window.localStorage.removeItem(this.storageKey)}catch(n){console.warn("Failed to clear localStorage:",n)}}async saveCommands(n){try{const t=n.map(o=>({commandSegments:Array.isArray(o.commandSegments)?[...o.commandSegments]:[],timestamp:o.timestamp}));window.localStorage.setItem(this.storageKey,JSON.stringify(t))}catch(t){throw console.warn("Failed to save commands to localStorage:",t),t}}}class be extends Q{constructor(n){super(n);y(this,"storedCommands",[])}async getStoredCommands(){return this.storedCommands.map(n=>({commandSegments:Array.isArray(n.commandSegments)?[...n.commandSegments]:[],timestamp:n.timestamp}))}async clear(){this.storedCommands=[]}async saveCommands(n){this.storedCommands=n.map(t=>({commandSegments:Array.isArray(t.commandSegments)?[...t.commandSegments]:[],timestamp:t.timestamp}))}}const H=class H{constructor(){y(this,"currentStorage")}static getInstance(){return H.instance||(H.instance=new H),H.instance}initializeStorage(e){if(!this.currentStorage)try{this.currentStorage=new we(e)}catch(n){console.warn("Failed to create storage, falling back to memory storage:",n),this.currentStorage=new be(e)}}getStorage(){if(!this.currentStorage)throw new Error("Storage not initialized. Call initializeStorage first.");return this.currentStorage}};y(H,"instance");let O=H;const X=async()=>new V("");class W{constructor(e,n,t){this.type=e,this.name=n,this.description=t}toString(){return this.name}}class Z extends W{constructor(){super("null",">null<","Empty segment")}}class ye extends W{constructor(e,n){super("word",e,n)}}class xe extends W{constructor(e,n,t,o){super("argument",e,n),this.value=t,this.valid=o}}class Ce{constructor(e,n,t=X){y(this,"_segments");y(this,"_description");y(this,"_handler");this._segments=e,this._description=n,this._handler=t}get segments(){return this._segments}get description(){return this._description}get handler(){return this._handler}get hasArguments(){return this.segments.some(e=>e.type==="argument")}get fullPath(){return this.segments.map(e=>e.name)}get fullPath_s(){return this.fullPath.join(" ")}equals(e){return this.fullPath.join(" ")===e.fullPath.join(" ")}}class ${constructor(){y(this,"_commands",[])}get commands(){return this._commands}addCommand(e,n,t=X){if(e===void 0||e.length===0)throw new Error("Command path cannot be empty");const o=new Ce(e,n,t),a=this._commands.find(l=>{const d=l.segments.map(m=>m.type==="argument"?"*":m.name).join(" "),u=e.map(m=>m.type==="argument"?"*":m.name).join(" ");return d===u});if(a)throw new Error(`Duplicate commands: '${a.fullPath_s}' and '${o.fullPath_s}'`);this._commands.push(o)}getCommand(e){return this._commands.find(n=>{const t=n.fullPath.join(" "),o=e.join(" ");if(t===o)return!0;const l=n.segments.filter(d=>d.type==="word").map(d=>d.name);return l.length===e.length&&l.join(" ")===o})}commandExistsForPath(e){const n=this._commands.map(o=>o.segments.map(a=>a.type==="argument"?"*":a.name).join(" ")),t=e.map((o,a)=>this._commands.some(d=>{var u;return((u=d.segments[a])==null?void 0:u.type)==="argument"})?"*":o).join(" ");return n.includes(t)}getCompletions_s(e){return this.getCompletions(e).map(n=>n.name)}getCompletions(e){if(S.debug("[getCompletions] path: ",e),!e.length){const a=this._commands.map(u=>u.segments[0]),l=(u,m)=>u.type===m.type&&u.name===m.name;return a.filter((u,m,p)=>m===p.findIndex(h=>l(h,u)))}const n=e.length;return this._commands.filter(a=>{const l=a.segments;if(l.length<=n-1)return!1;for(let d=0;d<n;d++){const u=e[d],m=l[d];if(!(u==="*"&&m.type==="argument")&&u!==m.name)return!1}return!0}).filter(a=>a.segments.length>n).map(a=>{const l=a.segments[n],d=l.type==="argument"?xe:ye;return new d(l.name,l.description)}).filter((a,l,d)=>l===d.findIndex(u=>u.type===a.type&&u.name===a.name))}hasNextSegment(e){return this.getCompletions(e).length>0}}class R{constructor(){y(this,"segments",[]);y(this,"nullSegment",new Z);y(this,"observers",[])}subscribe(e){this.observers.push(e)}unsubscribe(e){this.observers=this.observers.filter(n=>n!==e)}notifyObservers(){this.observers.forEach(e=>e.update())}clear(){this.segments=[],this.notifyObservers()}push(e){this.segments.push(e),this.notifyObservers()}pushAll(e){e.forEach(n=>this.push(n))}pop(){const e=this.segments.pop()||this.nullSegment;return this.notifyObservers(),e}peek(){return this.segments[this.segments.length-1]||this.nullSegment}size(){return this.segments.length}isEmpty(){return this.segments.length===0}get hasArguments(){return this.segments.some(e=>e.type==="argument")}get arguments(){return this.segments.filter(e=>e.type==="argument")}path(){return this.segments.map(e=>e.name)}toArray(){return[...this.segments]}}const ve={config:A,commands:new $,segmentStack:new R},U=s.createContext(ve),Se=({config:r=A,commandRegistry:e,children:n})=>{const[t,o]=s.useState(),a={...A,...r,storage:{...A.storage,...r.storage},cursorType:r.cursorType??A.cursorType,cursorColor:r.cursorColor??A.cursorColor,cursorSpeed:r.cursorSpeed??A.cursorSpeed,showCitadelKey:r.showCitadelKey||"."};s.useEffect(()=>{O.getInstance().initializeStorage(a.storage??A.storage),o(O.getInstance().getStorage())},[]),s.useEffect(()=>{if(e&&a.includeHelpCommand&&!e.commandExistsForPath(["help"])){const d=fe(e);e.addCommand([{type:"word",name:"help"}],"Show available commands",d)}},[e,a.includeHelpCommand]);const l={config:a,commands:e||new $,storage:t,segmentStack:new R};return i.jsx(U.Provider,{value:l,children:n})},M=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useCitadelConfig must be used within a CitadelConfigProvider");return r.config},K=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useCitadelCommands must be used within a CitadelConfigProvider");return r.commands},ee=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useCitadelStorage must be used within a CitadelConfigProvider");return r.storage},F=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useSegmentStack must be used within a CitadelConfigProvider");return r.segmentStack};class ne{constructor(e,n){y(this,"timestamp");y(this,"command");y(this,"result");this.command=e.toArray().map(t=>t.type==="argument"?t.value||"":t.name),this.timestamp=Date.now(),this.result=n??new J}}function ke(r){return{commandSegments:r,timestamp:Date.now()}}function te(){const r=ee(),[e,n]=s.useState({storedCommands:[],position:null}),t=s.useCallback(async d=>{if(r)try{const u=ke(d);await r.addStoredCommand(u),n(m=>({...m,storedCommands:[...m.storedCommands,u],position:null}))}catch(u){console.warn("Failed to save command to history:",u)}},[r]),o=s.useCallback(async()=>r?await r.getStoredCommands():[],[r]);s.useEffect(()=>{if(!r)return;(async()=>{try{const u=await r.getStoredCommands();return n(m=>({...m,storedCommands:u})),u}catch(u){console.warn("Failed to load command history:",u)}})()},[r]);const a=s.useCallback(async d=>{if((await o()).length===0)return{segments:null,position:null};let m=null;return d==="up"?e.position===null?m=e.storedCommands.length-1:e.position>0?m=e.position-1:m=0:e.position===null||e.position>=e.storedCommands.length-1?m=null:m=e.position+1,n(h=>({...h,position:m})),m===null?{segments:[],position:null}:{segments:m!==null?e.storedCommands[m].commandSegments:null,position:m}},[e,o]),l=s.useCallback(async()=>{try{if(!r)return;await r.clear(),n({storedCommands:[],position:null})}catch(d){console.warn("Failed to clear command history:",d)}},[r]);return{history:e,addStoredCommand:t,getStoredCommands:o,navigateHistory:a,clear:l}}const Y=()=>{const r=M(),e=K(),n=te(),t=F(),o=ee(),[a,l]=s.useState({currentInput:"",isEnteringArg:!1,output:[],history:{commands:[],position:null,storage:o}});s.useEffect(()=>{},[o]),s.useEffect(()=>{l(p=>({...p,history:{commands:n.history.storedCommands,position:n.history.position,storage:o}}))},[n.history,o]);const d={setCurrentInput:s.useCallback(p=>{S.debug("[CitadelActions] setCurrentInput: ",p),l(h=>({...h,currentInput:p}))},[]),setIsEnteringArg:s.useCallback(p=>{S.debug("[CitadelActions] setIsEnteringArg: ",p),l(h=>({...h,isEnteringArg:p}))},[]),addOutput:s.useCallback(p=>{S.debug("[CitadelActions]addOutput: ",p),l(h=>({...h,output:[...h.output,p]}))},[]),executeCommand:s.useCallback(async()=>{const p=t.path(),h=e.getCommand(p);if(!h){console.error("[CitadelActions][executeCommand] Cannot execute command because no command was found for the given path: ",p);return}const E=new ne(t);l(x=>({...x,output:[...x.output,E]}));try{const x=new Promise((c,g)=>{setTimeout(()=>{g(new Error("Request timed out"))},r.commandTimeoutMs)}),_=t.arguments.map(c=>c.value||""),N=await Promise.race([h.handler(_),x]);if(!(N instanceof P))throw new Error(`The ${p.join(".")} command returned an invalid result type. Commands must return an instance of a CommandResult.
+`):"No commands available yet. Add some commands to get started!")};var F=(r=>(r[r.NONE=0]="NONE",r[r.ERROR=1]="ERROR",r[r.WARN=2]="WARN",r[r.INFO=3]="INFO",r[r.DEBUG=4]="DEBUG",r[r.TRACE=5]="TRACE",r))(F||{});class E{static configure(e){this.level=e.level,this.prefix=e.prefix||"[Citadel]"}static trace(...e){this.level>=5&&process.env.NODE_ENV!=="production"&&console.trace(this.prefix,...e)}static debug(...e){this.level>=4&&process.env.NODE_ENV!=="production"&&console.debug(this.prefix,...e)}static info(...e){this.level>=3&&console.info(this.prefix,...e)}static warn(...e){this.level>=2&&console.warn(this.prefix,...e)}static error(...e){this.level>=1&&console.error(this.prefix,...e)}}x(E,"level",0),x(E,"prefix","");const A={commandTimeoutMs:1e4,cursorColor:"var(--cursor-color, #fff)",cursorSpeed:530,cursorType:"blink",includeHelpCommand:!0,initialHeight:"40vh",logLevel:process.env.NODE_ENV==="production"?F.ERROR:F.DEBUG,maxHeight:"80vh",minHeight:"200",outputFontSize:"0.875rem",resetStateOnHide:!1,showCitadelKey:".",displayMode:"panel",storage:{type:"localStorage",maxCommands:100}};class Q{constructor(e){x(this,"config");this.config={type:"localStorage",maxCommands:100,...e}}async addStoredCommand(e){const n=await this.getStoredCommands();for(n.push(e);n.length>this.config.maxCommands;)n.shift();await this.saveCommands(n)}}class we extends Q{constructor(n){super(n);x(this,"storageKey","citadel_command_history")}async getStoredCommands(){try{const n=window.localStorage.getItem(this.storageKey);return n?JSON.parse(n).map(o=>({commandSegments:o.commandSegments||[],timestamp:o.timestamp})):[]}catch(n){return console.warn("Failed to load commands from localStorage:",n),[]}}async clear(){try{window.localStorage.removeItem(this.storageKey)}catch(n){console.warn("Failed to clear localStorage:",n)}}async saveCommands(n){try{const t=n.map(o=>({commandSegments:Array.isArray(o.commandSegments)?[...o.commandSegments]:[],timestamp:o.timestamp}));window.localStorage.setItem(this.storageKey,JSON.stringify(t))}catch(t){throw console.warn("Failed to save commands to localStorage:",t),t}}}class be extends Q{constructor(n){super(n);x(this,"storedCommands",[])}async getStoredCommands(){return this.storedCommands.map(n=>({commandSegments:Array.isArray(n.commandSegments)?[...n.commandSegments]:[],timestamp:n.timestamp}))}async clear(){this.storedCommands=[]}async saveCommands(n){this.storedCommands=n.map(t=>({commandSegments:Array.isArray(t.commandSegments)?[...t.commandSegments]:[],timestamp:t.timestamp}))}}const H=class H{constructor(){x(this,"currentStorage")}static getInstance(){return H.instance||(H.instance=new H),H.instance}initializeStorage(e){if(!this.currentStorage)try{this.currentStorage=new we(e)}catch(n){console.warn("Failed to create storage, falling back to memory storage:",n),this.currentStorage=new be(e)}}getStorage(){if(!this.currentStorage)throw new Error("Storage not initialized. Call initializeStorage first.");return this.currentStorage}};x(H,"instance");let O=H;const X=async()=>new V("");class W{constructor(e,n,t){this.type=e,this.name=n,this.description=t}toString(){return this.name}}class Z extends W{constructor(){super("null",">null<","Empty segment")}}class ye extends W{constructor(e,n){super("word",e,n)}}class xe extends W{constructor(e,n,t,o){super("argument",e,n),this.value=t,this.valid=o}}class Ce{constructor(e,n,t=X){x(this,"_segments");x(this,"_description");x(this,"_handler");this._segments=e,this._description=n,this._handler=t}get segments(){return this._segments}get description(){return this._description}get handler(){return this._handler}get hasArguments(){return this.segments.some(e=>e.type==="argument")}get fullPath(){return this.segments.map(e=>e.name)}get fullPath_s(){return this.fullPath.join(" ")}equals(e){return this.fullPath.join(" ")===e.fullPath.join(" ")}}class L{constructor(){x(this,"_commands",[])}get commands(){return this._commands}addCommand(e,n,t=X){if(e===void 0||e.length===0)throw new Error("Command path cannot be empty");const o=new Ce(e,n,t),i=this._commands.find(l=>{const m=l.segments.map(d=>d.type==="argument"?"*":d.name).join(" "),u=e.map(d=>d.type==="argument"?"*":d.name).join(" ");return m===u});if(i)throw new Error(`Duplicate commands: '${i.fullPath_s}' and '${o.fullPath_s}'`);this._commands.push(o)}removeCommand(e){const n=e.join(" "),t=this._commands.findIndex(o=>o.fullPath.join(" ")===n);return t===-1?!1:(this._commands.splice(t,1),!0)}getCommand(e){return this._commands.find(n=>{const t=n.fullPath.join(" "),o=e.join(" ");if(t===o)return!0;const l=n.segments.filter(m=>m.type==="word").map(m=>m.name);return l.length===e.length&&l.join(" ")===o})}commandExistsForPath(e){const n=this._commands.map(o=>o.segments.map(i=>i.type==="argument"?"*":i.name).join(" ")),t=e.map((o,i)=>this._commands.some(m=>{var u;return((u=m.segments[i])==null?void 0:u.type)==="argument"})?"*":o).join(" ");return n.includes(t)}getCompletions_s(e){return this.getCompletions(e).map(n=>n.name)}getCompletions(e){if(E.debug("[getCompletions] path: ",e),!e.length){const i=this._commands.map(u=>u.segments[0]),l=(u,d)=>u.type===d.type&&u.name===d.name;return i.filter((u,d,p)=>d===p.findIndex(g=>l(g,u)))}const n=e.length;return this._commands.filter(i=>{const l=i.segments;if(l.length<=n-1)return!1;for(let m=0;m<n;m++){const u=e[m],d=l[m];if(!(u==="*"&&d.type==="argument")&&u!==d.name)return!1}return!0}).filter(i=>i.segments.length>n).map(i=>{const l=i.segments[n],m=l.type==="argument"?xe:ye;return new m(l.name,l.description)}).filter((i,l,m)=>l===m.findIndex(u=>u.type===i.type&&u.name===i.name))}hasNextSegment(e){return this.getCompletions(e).length>0}}class R{constructor(){x(this,"segments",[]);x(this,"nullSegment",new Z);x(this,"observers",[])}subscribe(e){this.observers.push(e)}unsubscribe(e){this.observers=this.observers.filter(n=>n!==e)}notifyObservers(){this.observers.forEach(e=>e.update())}clear(){this.segments=[],this.notifyObservers()}push(e){this.segments.push(e),this.notifyObservers()}pushAll(e){e.forEach(n=>this.push(n))}pop(){const e=this.segments.pop()||this.nullSegment;return this.notifyObservers(),e}peek(){return this.segments[this.segments.length-1]||this.nullSegment}size(){return this.segments.length}isEmpty(){return this.segments.length===0}get hasArguments(){return this.segments.some(e=>e.type==="argument")}get arguments(){return this.segments.filter(e=>e.type==="argument")}path(){return this.segments.map(e=>e.name)}toArray(){return[...this.segments]}}const ve={config:A,commands:new L,segmentStack:new R},U=s.createContext(ve),Se=({config:r=A,commandRegistry:e,children:n})=>{const[t,o]=s.useState(),i={...A,...r,storage:{...A.storage,...r.storage},cursorType:r.cursorType??A.cursorType,cursorColor:r.cursorColor??A.cursorColor,cursorSpeed:r.cursorSpeed??A.cursorSpeed,showCitadelKey:r.showCitadelKey||"."};s.useEffect(()=>{O.getInstance().initializeStorage(i.storage??A.storage),o(O.getInstance().getStorage())},[]),s.useEffect(()=>{if(e){if(i.includeHelpCommand){if(!e.commandExistsForPath(["help"])){const m=fe(e);e.addCommand([{type:"word",name:"help"}],"Show available commands",m)}return}e.removeCommand(["help"])}},[e,i.includeHelpCommand]);const l={config:i,commands:e||new L,storage:t,segmentStack:new R};return a.jsx(U.Provider,{value:l,children:n})},M=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useCitadelConfig must be used within a CitadelConfigProvider");return r.config},$=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useCitadelCommands must be used within a CitadelConfigProvider");return r.commands},ee=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useCitadelStorage must be used within a CitadelConfigProvider");return r.storage},j=()=>{const r=s.useContext(U);if(r===void 0)throw new Error("useSegmentStack must be used within a CitadelConfigProvider");return r.segmentStack};class ne{constructor(e,n){x(this,"timestamp");x(this,"command");x(this,"result");this.command=e.toArray().map(t=>t.type==="argument"?t.value||"":t.name),this.timestamp=Date.now(),this.result=n??new J}}function ke(r){return{commandSegments:r,timestamp:Date.now()}}function te(){const r=ee(),[e,n]=s.useState({storedCommands:[],position:null}),t=s.useCallback(async m=>{if(r)try{const u=ke(m);await r.addStoredCommand(u),n(d=>({...d,storedCommands:[...d.storedCommands,u],position:null}))}catch(u){console.warn("Failed to save command to history:",u)}},[r]),o=s.useCallback(async()=>r?await r.getStoredCommands():[],[r]);s.useEffect(()=>{if(!r)return;(async()=>{try{const u=await r.getStoredCommands();return n(d=>({...d,storedCommands:u})),u}catch(u){console.warn("Failed to load command history:",u)}})()},[r]);const i=s.useCallback(async m=>{if((await o()).length===0)return{segments:null,position:null};let d=null;return m==="up"?e.position===null?d=e.storedCommands.length-1:e.position>0?d=e.position-1:d=0:e.position===null||e.position>=e.storedCommands.length-1?d=null:d=e.position+1,n(g=>({...g,position:d})),d===null?{segments:[],position:null}:{segments:d!==null?e.storedCommands[d].commandSegments:null,position:d}},[e,o]),l=s.useCallback(async()=>{try{if(!r)return;await r.clear(),n({storedCommands:[],position:null})}catch(m){console.warn("Failed to clear command history:",m)}},[r]);return{history:e,addStoredCommand:t,getStoredCommands:o,navigateHistory:i,clear:l}}const Y=()=>{const r=M(),e=$(),n=te(),t=j(),o=ee(),[i,l]=s.useState({currentInput:"",isEnteringArg:!1,output:[],history:{commands:[],position:null,storage:o}});s.useEffect(()=>{},[o]),s.useEffect(()=>{l(p=>({...p,history:{commands:n.history.storedCommands,position:n.history.position,storage:o}}))},[n.history,o]);const m={setCurrentInput:s.useCallback(p=>{E.debug("[CitadelActions] setCurrentInput: ",p),l(g=>({...g,currentInput:p}))},[]),setIsEnteringArg:s.useCallback(p=>{E.debug("[CitadelActions] setIsEnteringArg: ",p),l(g=>({...g,isEnteringArg:p}))},[]),addOutput:s.useCallback(p=>{E.debug("[CitadelActions]addOutput: ",p),l(g=>({...g,output:[...g.output,p]}))},[]),executeCommand:s.useCallback(async()=>{const p=t.path(),g=e.getCommand(p);if(!g){console.error("[CitadelActions][executeCommand] Cannot execute command because no command was found for the given path: ",p);return}const S=new ne(t);l(b=>({...b,output:[...b.output,S]}));try{const b=new Promise((c,h)=>{setTimeout(()=>{h(new Error("Request timed out"))},r.commandTimeoutMs)}),C=t.arguments.map(c=>c.value||""),_=await Promise.race([g.handler(C),b]);if(!(_ instanceof P))throw new Error(`The ${p.join(".")} command returned an invalid result type. Commands must return an instance of a CommandResult.
 For example:
    return new JsonCommandResult({ text: "Hello World" });
-Check the definition of the ${p.join(".")} command and update the return type for its handler.`);N.markSuccess(),l(c=>({...c,output:c.output.map(g=>g.timestamp===E.timestamp?{...g,result:N}:g)}))}catch(x){const _=new G(x instanceof Error?x.message:"Unknown error");_.markFailure(),l(N=>({...N,output:N.output.map(c=>c.timestamp===E.timestamp?{...c,result:_}:c)}))}},[e,r.commandTimeoutMs,t]),clearHistory:s.useCallback(async()=>{try{await n.clear()}catch(p){console.warn("Failed to clear history:",p)}},[n])},u=s.useCallback(()=>e.getCompletions_s(t.path()),[t,e]),m=s.useCallback(()=>e.getCompletions(t.path()),[t,e]);return{state:a,actions:d,getAvailableCommands_s:u,getAvailableCommandSegments:m}},Ee=({onOpen:r,onClose:e,isVisible:n,showCitadelKey:t})=>{s.useEffect(()=>{const o=a=>{var l,d;!n&&a.key===t&&!["input","textarea"].includes(((d=(l=a.target)==null?void 0:l.tagName)==null?void 0:d.toLowerCase())||"")&&(a.preventDefault(),r()),n&&a.key==="Escape"&&(a.preventDefault(),e())};return document.addEventListener("keydown",o),()=>document.removeEventListener("keydown",o)},[r,e,n,t])},re={panelContainer:"_panelContainer_1pav9_3",innerContainer:"_innerContainer_1pav9_19",inputSection:"_inputSection_1pav9_29",resizeHandle:"_resizeHandle_1pav9_36",citadel_slideUp:"_citadel_slideUp_1pav9_65",citadel_slideDown:"_citadel_slideDown_1pav9_69",inlineContainer:"_inlineContainer_1pav9_73"},_e=r=>{const{isVisible:e,isClosing:n,onAnimationComplete:t}=r,o=s.useMemo(()=>e?n?re.slideDown:re.slideUp:"",[e,n]);return s.useEffect(()=>{if(t){const l=setTimeout(()=>{t()},200);return()=>clearTimeout(l)}},[n,t]),{style:s.useMemo(()=>({opacity:e?1:0,transform:e?"translateY(0)":n?"translateY(100%)":"translateY(-100%)",transition:"opacity 200ms ease-in-out, transform 200ms ease-in-out"}),[e,n]),animationClass:o}},Ne=()=>i.jsx("div",{"data-testid":"spinner",className:"animate-spin rounded-full h-4 w-4 border-2 border-gray-300 border-t-gray-600"}),Ae=({command:r,timestamp:e,status:n})=>i.jsxs("div",{className:"flex items-center gap-2 font-mono text-sm",children:[i.jsxs("span",{className:"text-gray-200",children:["> ",r.split(" ").map((t,o)=>{const a=t.startsWith("<")&&t.endsWith(">");return i.jsxs("span",{className:a?"text-green-400":"text-gray-200",children:[o>0?" ":"",t]},o)})]}),i.jsx("span",{className:"text-gray-400",children:"·"}),i.jsx("span",{className:"text-gray-500",children:e}),n===D.Pending&&i.jsx(Ne,{}),n===D.Success&&i.jsx("div",{"data-testid":"success-indicator",className:"w-4 h-4 rounded-full bg-green-500"}),(n===D.Timeout||n===D.Failure)&&i.jsx("div",{"data-testid":"success-indicator",className:"w-4 h-4 rounded-full bg-red-500"})]}),ze=({output:r,outputRef:e})=>{const n=M(),t=s.useCallback(()=>{if(e.current){const o=e.current;requestAnimationFrame(()=>{o.scrollTop=o.scrollHeight})}},[e]);return s.useEffect(()=>{if(t(),e.current){const o=e.current.getElementsByTagName("img"),a=o[o.length-1];if(a&&!a.complete)return a.addEventListener("load",t),()=>a.removeEventListener("load",t)}},[r,t,e]),i.jsx("div",{ref:e,className:"h-full overflow-y-auto border border-gray-700 rounded-lg p-3 text-left","data-testid":"citadel-command-output",children:r.map((o,a)=>i.jsxs("div",{className:"mb-4 last:mb-0",children:[i.jsx(Ae,{command:o.command.join(" "),timestamp:new Date(o.timestamp).toLocaleTimeString(),status:o.result.status}),i.jsx("pre",{className:`text-gray-200 whitespace-pre font-mono ${n.outputFontSize}`,children:o.result.render()})]},a))})},oe={blink:{character:"▋",speed:530,color:"#fff"},spin:{character:"⠋",speed:120,color:"#fff"},solid:{character:"▋",speed:0,color:"#fff"},bbs:{character:"|",speed:120,color:"#fff"}},se=["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"],ae=["|","/","-","\\"],Ie=({style:r={type:"blink"},isValid:e=!0,errorMessage:n})=>{const t=s.useMemo(()=>({...oe[r.type],...r}),[r]),[o,a]=s.useState(!0),[l,d]=s.useState(0);s.useEffect(()=>{if(t.speed===0)return;const p=setInterval(()=>{t.type==="blink"?a(h=>!h):["spin","bbs"].includes(t.type)&&d(h=>(h+1)%(t.type==="bbs"?ae.length:se.length))},t.speed);return()=>clearInterval(p)},[t.type,t.speed]);const u=s.useMemo(()=>({color:e?t.color:"#ff4444",transition:"color 0.15s ease-in-out"}),[e,t.color]),m=()=>!e&&n?"✗":["spin","bbs"].includes(t.type)?(t.type==="bbs"?ae:se)[l]:t.type==="solid"||o?t.character:" ";return i.jsx("div",{className:"relative inline-block",children:i.jsx("span",{className:`command-cursor ${e?"":"animate-shake"}`,style:u,title:n,children:m()})})};function Pe(r,e){switch(e.type){case"set":return S.debug(`[inputStateReducer] InputState changing from ${r} to ${e.state}`),e.state;default:return r}}const He=()=>{const{state:r}=Y(),e=K(),n=te(),t=F(),[o,a]=s.useReducer(Pe,"idle"),l=c=>{a({type:"set",state:c})},d=s.useCallback(()=>{const g=e.getCompletions(t.path())[0]||t.nullSegment;return S.debug("[getNextExpectedSegment] ",g),g},[e,t]),u=s.useCallback(()=>e.getCompletions_s(t.path()).map(g=>e.getCommand([...t.path(),g])).filter(g=>g!==void 0),[e,t]),m=s.useCallback((c,g)=>{if(!c)return g;const f=g.reduce((b,C)=>{const v=d();return(v==null?void 0:v.type)==="word"&&b.set(v.name,C),b},new Map);return Array.from(f.values()).filter(()=>{const b=d();return b.type!=="word"?!1:b.name.toLowerCase().startsWith(c.toLowerCase())})},[d]),p=s.useCallback(c=>{const f=e.getCompletions(t.path()).filter(k=>k.type==="word").filter(k=>k.name.toLowerCase().startsWith(c.toLowerCase()));return f.length===1?f[0]:t.nullSegment},[e,t]),h=s.useCallback(c=>{const g=t.path(),f=e.getCompletions(g);return f.length===0&&c?!1:f.some(b=>b.type==="argument")?!0:f.some(b=>b.type==="word"&&b.name.toLowerCase().startsWith(c.toLowerCase()))},[e,t]),E=s.useCallback(c=>{S.debug("[tryAutoComplete] input: ",c);const g=p(c);return!g||g.name===c?new Z:(S.debug("[tryAutoComplete] result: ",g),g)},[p]),x=s.useCallback((c,g)=>{if(r.history.position===null){if(g.setCurrentInput(c),S.debug("[useCommandParser][handleInputChange] newValue: ",c),o==="entering_argument"){const f=ie(c);if(f.isQuoted)if(f.isComplete){const k=d();if(k.type==="argument"){const b=k;b.value=c.trim()||"",S.debug("[useCommandParser][handleInputChange][entering_command] pushing: ",b),t.push(b),g.setCurrentInput(""),l("idle");return}}else return;else if(f.isComplete){const k=d();k.value=c.trim()||"",S.debug("[useCommandParser][handleInputChange][entering_command] pushing: ",k),t.push(k),g.setCurrentInput(""),l("idle");return}else return}if(o=="entering_command"){const f=E(c);if(f.type==="word"){S.debug("[useCommandParser][handleInputChange][entering_command] pushing: ",f),t.push(f),g.setCurrentInput(""),l("idle");return}}}},[E,r,d,o,t]),_=s.useCallback(c=>{c.setCurrentInput(""),c.setIsEnteringArg(!1),t.clear(),l("idle")},[t]),N=s.useCallback((c,g,f)=>{if(!(c.key==="Backspace"||c.key==="Enter"||c.key==="ArrowUp"||c.key==="ArrowDown"||c.key==="ArrowLeft"||c.key==="ArrowRight"||c.key==="Escape"||c.key==="Delete"||c.key==="Home"||c.key==="End"||c.key.length===1))return!0;const{currentInput:b,isEnteringArg:C}=g,v=ie(b);switch(c.key){case"Backspace":return b===""&&(c.preventDefault(),t.size()>0&&t.pop(),l("idle")),!0;case"Enter":{if(c.preventDefault(),v.isQuoted&&!v.isComplete)return!0;if(o==="entering_argument"||C&&b.trim()){const B=d();B.value=b,S.debug("[handleKeyDown][Enter]['entering_argument'] pushing: ",B),t.push(B)}const z=t.path(),I=e.getCommand(z);if(!I)return!1;const L=I.segments.filter(T=>T.type==="argument"),q=t.arguments;return L.length>q.length?!1:(S.debug("[handleKeyDown][Enter] calling actions.executeCommand. segmentStack: ",t),f.executeCommand(),n.addStoredCommand(t.toArray()),_(f),!0)}case"ArrowUp":return c.preventDefault(),(async()=>{const z=await n.navigateHistory("up",t.toArray());return z.segments&&(t.clear(),t.pushAll(z.segments),f.setCurrentInput("")),!0})();case"ArrowDown":return c.preventDefault(),(async()=>{const z=await n.navigateHistory("down",t.toArray());return z.segments&&(t.clear(),t.pushAll(z.segments),f.setCurrentInput("")),!0})();default:{if(!C&&c.key.length===1){const z=b+c.key;if(!h(z))return c.preventDefault(),!1}return!0}}},[o,h,d,n,_,e,t]);return{handleInputChange:x,handleKeyDown:N,inputState:o,setInputStateWithLogging:l,findMatchingCommands:m,getAutocompleteSuggestion:p,getAvailableNodes:u,getNextExpectedSegment:d,isValidCommandInput:h}};function ie(r){const e=[];let n="",t=!1,o;for(let a=0;a<r.length;a++){const l=r[a];(l==='"'||l==="'")&&(!t||l===o)?t?(e.push(n),n="",t=!1,o=void 0):(n&&(e.push(n),n=""),t=!0,o=l):!t&&l===" "?n&&(e.push(n),n=""):n+=l}return{words:e,currentWord:n,isQuoted:t,quoteChar:o,isComplete:!t&&!n}}const De=()=>{const r=F(),[e,n]=s.useState(0);return s.useEffect(()=>{const t={update:()=>{n(o=>o+1)}};return r.subscribe(t),()=>{r.unsubscribe(t)}},[r]),e},Me=({state:r,actions:e})=>{const n=s.useRef(null),t=K(),o=F(),{handleKeyDown:a,handleInputChange:l,inputState:d,setInputStateWithLogging:u,getNextExpectedSegment:m}=He(),[p,h]=s.useState(!1),E=M(),x=De(),_=async C=>{const v=a(C,r,e);await Promise.resolve(v)===!1&&(h(!0),setTimeout(()=>h(!1),500))},N=C=>{l(C.target.value,e)},c=C=>{C.preventDefault();const v=C.clipboardData.getData("text");l(v,e)};s.useEffect(()=>{n.current&&n.current.focus(),d!=="entering_command"&&u("entering_command")},[d,u]),s.useEffect(()=>{if(d!=="idle")return;const C=m();let v="idle";switch(C.type){case"word":v="entering_command",e.setIsEnteringArg(!1);break;case"argument":v="entering_argument",e.setIsEnteringArg(!0);break}u(v)},[x,d,m,u,e]);const[g,f]=s.useState([]);s.useEffect(()=>{const C=[],v=o.toArray().map((I,L)=>{C.push(I.name);const q=t.hasNextSegment(C);if(I.type==="argument"){const T=I;return i.jsxs(s.Fragment,{children:[i.jsx("span",{className:"text-gray-200 whitespace-pre",children:T.value}),L<o.size()&&q&&i.jsx("span",{className:"text-gray-200 whitespace-pre",children:" "})]},"arg-"+T.name+T.value)}return i.jsxs(s.Fragment,{children:[i.jsx("span",{className:"text-blue-400 whitespace-pre",children:I.name}),L<o.size()&&q&&i.jsx("span",{className:"text-blue-400 whitespace-pre",children:" "})]},"word-"+I.name)});f([i.jsx("div",{className:"flex items-center gap-1","data-testid":"user-input-area",children:v},"{segmentStackVersion}")])},[x,t,o]);const[k,b]=s.useState("");return s.useEffect(()=>{const C=m();C.type==="argument"?b(C.name):b("")},[x,m]),i.jsxs("div",{className:"flex flex-col w-full bg-gray-900 rounded-lg p-4",children:[i.jsx("style",{children:`
+Check the definition of the ${p.join(".")} command and update the return type for its handler.`);_.markSuccess(),l(c=>({...c,output:c.output.map(h=>h.timestamp===S.timestamp?{...h,result:_}:h)}))}catch(b){const C=new G(b instanceof Error?b.message:"Unknown error");C.markFailure(),l(_=>({..._,output:_.output.map(c=>c.timestamp===S.timestamp?{...c,result:C}:c)}))}},[e,r.commandTimeoutMs,t]),clearHistory:s.useCallback(async()=>{try{await n.clear()}catch(p){console.warn("Failed to clear history:",p)}},[n])},u=s.useCallback(()=>e.getCompletions_s(t.path()),[t,e]),d=s.useCallback(()=>e.getCompletions(t.path()),[t,e]);return{state:i,actions:m,getAvailableCommands_s:u,getAvailableCommandSegments:d}},Ee=({onOpen:r,onClose:e,isVisible:n,showCitadelKey:t})=>{s.useEffect(()=>{const o=i=>{var l,m;!n&&i.key===t&&!["input","textarea"].includes(((m=(l=i.target)==null?void 0:l.tagName)==null?void 0:m.toLowerCase())||"")&&(i.preventDefault(),r()),n&&i.key==="Escape"&&(i.preventDefault(),e())};return document.addEventListener("keydown",o),()=>document.removeEventListener("keydown",o)},[r,e,n,t])},re={panelContainer:"_panelContainer_1pav9_3",innerContainer:"_innerContainer_1pav9_19",inputSection:"_inputSection_1pav9_29",resizeHandle:"_resizeHandle_1pav9_36",citadel_slideUp:"_citadel_slideUp_1pav9_65",citadel_slideDown:"_citadel_slideDown_1pav9_69",inlineContainer:"_inlineContainer_1pav9_73"},_e=r=>{const{isVisible:e,isClosing:n,onAnimationComplete:t}=r,o=s.useMemo(()=>e?n?re.slideDown:re.slideUp:"",[e,n]);return s.useEffect(()=>{if(t){const l=setTimeout(()=>{t()},200);return()=>clearTimeout(l)}},[n,t]),{style:s.useMemo(()=>({opacity:e?1:0,transform:e?"translateY(0)":n?"translateY(100%)":"translateY(-100%)",transition:"opacity 200ms ease-in-out, transform 200ms ease-in-out"}),[e,n]),animationClass:o}},Ne=()=>a.jsx("div",{"data-testid":"spinner",className:"animate-spin rounded-full h-4 w-4 border-2 border-gray-300 border-t-gray-600"}),Ae=({command:r,timestamp:e,status:n})=>a.jsxs("div",{className:"flex items-center gap-2 font-mono text-sm",children:[a.jsxs("span",{className:"text-gray-200",children:["> ",r.split(" ").map((t,o)=>{const i=t.startsWith("<")&&t.endsWith(">");return a.jsxs("span",{className:i?"text-green-400":"text-gray-200",children:[o>0?" ":"",t]},o)})]}),a.jsx("span",{className:"text-gray-400",children:"·"}),a.jsx("span",{className:"text-gray-500",children:e}),n===D.Pending&&a.jsx(Ne,{}),n===D.Success&&a.jsx("div",{"data-testid":"success-indicator",className:"w-4 h-4 rounded-full bg-green-500"}),(n===D.Timeout||n===D.Failure)&&a.jsx("div",{"data-testid":"success-indicator",className:"w-4 h-4 rounded-full bg-red-500"})]}),ze=({output:r,outputRef:e})=>{const n=M(),t=s.useCallback(()=>{if(e.current){const o=e.current;requestAnimationFrame(()=>{o.scrollTop=o.scrollHeight})}},[e]);return s.useEffect(()=>{if(t(),e.current){const o=e.current.getElementsByTagName("img"),i=o[o.length-1];if(i&&!i.complete)return i.addEventListener("load",t),()=>i.removeEventListener("load",t)}},[r,t,e]),a.jsx("div",{ref:e,className:"h-full overflow-y-auto border border-gray-700 rounded-lg p-3 text-left","data-testid":"citadel-command-output",children:r.map((o,i)=>a.jsxs("div",{className:"mb-4 last:mb-0",children:[a.jsx(Ae,{command:o.command.join(" "),timestamp:new Date(o.timestamp).toLocaleTimeString(),status:o.result.status}),a.jsx("pre",{className:`text-gray-200 whitespace-pre font-mono ${n.outputFontSize}`,children:o.result.render()})]},i))})},oe={blink:{character:"▋",speed:530,color:"#fff"},spin:{character:"⠋",speed:120,color:"#fff"},solid:{character:"▋",speed:0,color:"#fff"},bbs:{character:"|",speed:120,color:"#fff"}},se=["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"],ae=["|","/","-","\\"],Ie=({style:r={type:"blink"},isValid:e=!0,errorMessage:n})=>{const t=s.useMemo(()=>({...oe[r.type],...r}),[r]),[o,i]=s.useState(!0),[l,m]=s.useState(0);s.useEffect(()=>{if(t.speed===0)return;const p=setInterval(()=>{t.type==="blink"?i(g=>!g):["spin","bbs"].includes(t.type)&&m(g=>(g+1)%(t.type==="bbs"?ae.length:se.length))},t.speed);return()=>clearInterval(p)},[t.type,t.speed]);const u=s.useMemo(()=>({color:e?t.color:"#ff4444",transition:"color 0.15s ease-in-out"}),[e,t.color]),d=()=>!e&&n?"✗":["spin","bbs"].includes(t.type)?(t.type==="bbs"?ae:se)[l]:t.type==="solid"||o?t.character:" ";return a.jsx("div",{className:"relative inline-block",children:a.jsx("span",{className:`command-cursor ${e?"":"animate-shake"}`,style:u,title:n,children:d()})})};function Pe(r,e){switch(e.type){case"set":return E.debug(`[inputStateReducer] InputState changing from ${r} to ${e.state}`),e.state;default:return r}}const He=()=>{const{state:r}=Y(),e=$(),n=te(),t=j(),[o,i]=s.useReducer(Pe,"idle"),l=c=>{i({type:"set",state:c})},m=s.useCallback(()=>{const h=e.getCompletions(t.path())[0]||t.nullSegment;return E.debug("[getNextExpectedSegment] ",h),h},[e,t]),u=s.useCallback(()=>e.getCompletions_s(t.path()).map(h=>e.getCommand([...t.path(),h])).filter(h=>h!==void 0),[e,t]),d=s.useCallback((c,h)=>{if(!c)return h;const f=h.reduce((y,v)=>{const k=m();return(k==null?void 0:k.type)==="word"&&y.set(k.name,v),y},new Map);return Array.from(f.values()).filter(()=>{const y=m();return y.type!=="word"?!1:y.name.toLowerCase().startsWith(c.toLowerCase())})},[m]),p=s.useCallback(c=>{const f=e.getCompletions(t.path()).filter(N=>N.type==="word").filter(N=>N.name.toLowerCase().startsWith(c.toLowerCase()));return f.length===1?f[0]:t.nullSegment},[e,t]),g=s.useCallback(c=>{const h=t.path(),f=e.getCompletions(h);return f.length===0&&c?!1:f.some(y=>y.type==="argument")?!0:f.some(y=>y.type==="word"&&y.name.toLowerCase().startsWith(c.toLowerCase()))},[e,t]),S=s.useCallback(c=>{E.debug("[tryAutoComplete] input: ",c);const h=p(c);return!h||h.name===c?new Z:(E.debug("[tryAutoComplete] result: ",h),h)},[p]),b=s.useCallback((c,h)=>{if(r.history.position===null){if(h.setCurrentInput(c),E.debug("[useCommandParser][handleInputChange] newValue: ",c),o==="entering_argument"){const f=ie(c);if(f.isQuoted)if(f.isComplete){const N=m();if(N.type==="argument"){const y=N;y.value=c.trim()||"",E.debug("[useCommandParser][handleInputChange][entering_command] pushing: ",y),t.push(y),h.setCurrentInput(""),l("idle");return}}else return;else if(f.isComplete){const N=m();N.value=c.trim()||"",E.debug("[useCommandParser][handleInputChange][entering_command] pushing: ",N),t.push(N),h.setCurrentInput(""),l("idle");return}else return}if(o=="entering_command"){const f=S(c);if(f.type==="word"){E.debug("[useCommandParser][handleInputChange][entering_command] pushing: ",f),t.push(f),h.setCurrentInput(""),l("idle");return}}}},[S,r,m,o,t]),C=s.useCallback(c=>{c.setCurrentInput(""),c.setIsEnteringArg(!1),t.clear(),l("idle")},[t]),_=s.useCallback((c,h,f)=>{if(!(c.key==="Backspace"||c.key==="Enter"||c.key==="ArrowUp"||c.key==="ArrowDown"||c.key==="ArrowLeft"||c.key==="ArrowRight"||c.key==="Escape"||c.key==="Delete"||c.key==="Home"||c.key==="End"||c.key.length===1))return!0;const{currentInput:y,isEnteringArg:v}=h,k=ie(y);switch(c.key){case"Backspace":return y===""&&(c.preventDefault(),t.size()>0&&t.pop(),l("idle")),!0;case"Enter":{if(c.preventDefault(),k.isQuoted&&!k.isComplete)return!0;if(o==="entering_argument"||v&&y.trim()){const B=m();B.value=y,E.debug("[handleKeyDown][Enter]['entering_argument'] pushing: ",B),t.push(B)}const z=t.path(),I=e.getCommand(z);if(!I)return!1;const K=I.segments.filter(T=>T.type==="argument"),q=t.arguments;return K.length>q.length?!1:(E.debug("[handleKeyDown][Enter] calling actions.executeCommand. segmentStack: ",t),f.executeCommand(),n.addStoredCommand(t.toArray()),C(f),!0)}case"ArrowUp":return c.preventDefault(),(async()=>{const z=await n.navigateHistory("up",t.toArray());return z.segments&&(t.clear(),t.pushAll(z.segments),f.setCurrentInput("")),!0})();case"ArrowDown":return c.preventDefault(),(async()=>{const z=await n.navigateHistory("down",t.toArray());return z.segments&&(t.clear(),t.pushAll(z.segments),f.setCurrentInput("")),!0})();default:{if(!v&&c.key.length===1){const z=y+c.key;if(!g(z))return c.preventDefault(),!1}return!0}}},[o,g,m,n,C,e,t]);return{handleInputChange:b,handleKeyDown:_,inputState:o,setInputStateWithLogging:l,findMatchingCommands:d,getAutocompleteSuggestion:p,getAvailableNodes:u,getNextExpectedSegment:m,isValidCommandInput:g}};function ie(r){const e=[];let n="",t=!1,o;for(let i=0;i<r.length;i++){const l=r[i];(l==='"'||l==="'")&&(!t||l===o)?t?(e.push(n),n="",t=!1,o=void 0):(n&&(e.push(n),n=""),t=!0,o=l):!t&&l===" "?n&&(e.push(n),n=""):n+=l}return{words:e,currentWord:n,isQuoted:t,quoteChar:o,isComplete:!t&&!n}}const De=()=>{const r=j(),[e,n]=s.useState(0);return s.useEffect(()=>{const t={update:()=>{n(o=>o+1)}};return r.subscribe(t),()=>{r.unsubscribe(t)}},[r]),e},Me=({state:r,actions:e})=>{const n=s.useRef(null),t=$(),o=j(),{handleKeyDown:i,handleInputChange:l,inputState:m,setInputStateWithLogging:u,getNextExpectedSegment:d}=He(),[p,g]=s.useState(!1),S=M(),b=De(),C=async v=>{const k=i(v,r,e);await Promise.resolve(k)===!1&&(g(!0),setTimeout(()=>g(!1),500))},_=v=>{l(v.target.value,e)},c=v=>{v.preventDefault();const k=v.clipboardData.getData("text");l(k,e)};s.useEffect(()=>{n.current&&n.current.focus(),m!=="entering_command"&&u("entering_command")},[m,u]),s.useEffect(()=>{if(m!=="idle")return;const v=d();let k="idle";switch(v.type){case"word":k="entering_command",e.setIsEnteringArg(!1);break;case"argument":k="entering_argument",e.setIsEnteringArg(!0);break}u(k)},[b,m,d,u,e]);const[h,f]=s.useState([]);s.useEffect(()=>{const v=[],k=o.toArray().map((I,K)=>{v.push(I.name);const q=t.hasNextSegment(v);if(I.type==="argument"){const T=I;return a.jsxs(s.Fragment,{children:[a.jsx("span",{className:"text-gray-200 whitespace-pre",children:T.value}),K<o.size()&&q&&a.jsx("span",{className:"text-gray-200 whitespace-pre",children:" "})]},"arg-"+T.name+T.value)}return a.jsxs(s.Fragment,{children:[a.jsx("span",{className:"text-blue-400 whitespace-pre",children:I.name}),K<o.size()&&q&&a.jsx("span",{className:"text-blue-400 whitespace-pre",children:" "})]},"word-"+I.name)});f([a.jsx("div",{className:"flex items-center gap-1","data-testid":"user-input-area",children:k},"{segmentStackVersion}")])},[b,t,o]);const[N,y]=s.useState("");return s.useEffect(()=>{const v=d();v.type==="argument"?y(v.name):y("")},[b,d]),a.jsxs("div",{className:"flex flex-col w-full bg-gray-900 rounded-lg p-4",children:[a.jsx("style",{children:`
         @keyframes subtleGlow {
           0%, 100% { box-shadow: 0 0 0 rgba(239, 68, 68, 0); }
           50% { box-shadow: 0 0 8px rgba(239, 68, 68, 0.6); }
@@ -11,7 +11,7 @@ Check the definition of the ${p.join(".")} command and update the return type fo
         .invalid-input-animation {
           animation: subtleGlow 0.4s ease-in-out;
         }
-      `}),i.jsxs("div",{className:"flex items-center gap-2",children:[i.jsx("div",{className:"text-gray-400 font-mono",children:">"}),i.jsxs("div",{className:"flex-1 font-mono flex items-center",children:[g,i.jsxs("div",{className:"relative flex-1",children:[i.jsx("input",{ref:n,type:"text",role:"textbox",value:r.currentInput,onChange:N,onKeyDown:_,onPaste:c,"data-testid":"citadel-command-input",className:`w-full bg-transparent outline-none text-gray-200 caret-transparent ${p?"invalid-input-animation":""}`,spellCheck:!1,autoComplete:"off",placeholder:k}),i.jsx("div",{className:"absolute top-0 pointer-events-none",style:{left:`${r.currentInput.length}ch`,transition:"left 0.05s ease-out"},children:i.jsx(Ie,{style:{type:E.cursorType??A.cursorType,color:E.cursorColor||A.cursorColor,speed:E.cursorSpeed||A.cursorSpeed}})})]})]})]})]})},Te=()=>{const r=K(),e=M(),n=F(),t="h-12 mt-2 border-t border-gray-700 px-4",o="text-gray-300 pt-2",a=r.getCompletions(n.path());S.debug("[AvailableCommands] nextCommandSegments: ",a);const l=s.useMemo(()=>{if(e.includeHelpCommand){const m=a.filter(h=>h.name!=="help"),p=a.find(h=>h.name==="help");return[...m,...p?[p]:[]]}return a},[a,e.includeHelpCommand]),d=a.some(m=>m.type==="argument"),u=a[0];return i.jsx("div",{className:t,"data-testid":"available-commands",children:i.jsx("div",{className:o,children:d?a.length>0?i.jsxs(i.Fragment,{children:[i.jsx("span",{className:"text-blue-400",children:u.name}),u.description&&i.jsxs("span",{className:"text-gray-400 ml-2",children:["- ",u.description]})]}):null:i.jsx("div",{className:"flex flex-wrap gap-2",children:l==null?void 0:l.map(m=>{const p=l==null?void 0:l.reduce((h,E)=>{if(E===m)return h;let x=0;for(;x<m.name.length&&x<E.name.length&&m.name[x].toLowerCase()===E.name[x].toLowerCase();)x++;return Math.max(h,x+1)},1);return i.jsx("div",{className:"px-2 py-1 rounded bg-gray-800 mr-2 last:mr-0",children:i.jsxs("span",{className:"font-mono text-white",children:[i.jsx("strong",{className:"underline",children:m.name.slice(0,p)}),m.name.slice(p)]})},m.name)})})})})},le=({state:r,actions:e,outputRef:n})=>i.jsxs("div",{className:"innerContainer",children:[i.jsx("div",{className:"flex-1 min-h-0 pt-3 px-4",children:i.jsx(ze,{output:r.output,outputRef:n})}),i.jsxs("div",{children:[i.jsx(Me,{state:r,actions:e}),i.jsx(Te,{})]})]}),Ue=()=>{const[r,e]=s.useState(!1),[n,t]=s.useState(!1),o=M(),[a,l]=s.useState(()=>o.initialHeight||null),d=s.useRef(null),u=s.useRef(null),m=s.useRef(!1),p=s.useRef(0),h=s.useRef(0),{state:E,actions:x}=Y();Ee({onOpen:()=>e(!0),onClose:()=>t(!0),isVisible:r,showCitadelKey:o.showCitadelKey||"."});const _=s.useCallback(f=>{var v;if(!m.current)return;const k=f.clientY-p.current,b=(v=o.maxHeight)!=null&&v.endsWith("vh")?window.innerHeight*parseInt(o.maxHeight,10)/100:parseInt(o.maxHeight||"80vh",10),C=Math.min(Math.max(h.current-k,parseInt(o.minHeight||"200",10)),b);u.current&&(u.current.style.height=`${C}px`,u.current.style.bottom="0",l(`${C}px`))},[o.maxHeight,o.minHeight]),N=s.useCallback(()=>{m.current=!1,document.documentElement.style.userSelect="",document.documentElement.style.webkitUserSelect="",document.documentElement.style.mozUserSelect="",document.documentElement.style.msUserSelect="",document.removeEventListener("mousemove",_),document.removeEventListener("mouseup",N)},[_]),c=s.useCallback(f=>{u.current&&(m.current=!0,p.current=f.clientY,h.current=u.current.offsetHeight,document.documentElement.style.userSelect="none",document.documentElement.style.webkitUserSelect="none",document.documentElement.style.mozUserSelect="none",document.documentElement.style.msUserSelect="none",document.addEventListener("mousemove",_),document.addEventListener("mouseup",N))},[_,N]);s.useEffect(()=>()=>{document.removeEventListener("mousemove",_),document.removeEventListener("mouseup",N)},[_,N]);const g=s.useCallback(()=>{n&&(e(!1),t(!1))},[n]);return _e({isVisible:r,isClosing:n,onAnimationComplete:g}),r?i.jsxs("div",{ref:u,className:`panelContainer ${r?"citadel_slideUp":""} ${n?"citadel_slideDown":""}`,style:{...a?{height:a}:void 0,maxHeight:o.maxHeight},children:[i.jsx("div",{className:"resizeHandle",onMouseDown:c}),i.jsx(le,{state:E,actions:x,outputRef:d})]}):null},Fe=()=>{const{state:r,actions:e}=Y(),n=s.useRef(null);return i.jsx("div",{className:"inlineContainer","data-testid":"citadel-inline-container",children:i.jsx(le,{state:r,actions:e,outputRef:n})})},ce=`:host {
+      `}),a.jsxs("div",{className:"flex items-center gap-2",children:[a.jsx("div",{className:"text-gray-400 font-mono",children:">"}),a.jsxs("div",{className:"flex-1 font-mono flex items-center",children:[h,a.jsxs("div",{className:"relative flex-1",children:[a.jsx("input",{ref:n,type:"text",role:"textbox",value:r.currentInput,onChange:_,onKeyDown:C,onPaste:c,"data-testid":"citadel-command-input",className:`w-full bg-transparent outline-none text-gray-200 caret-transparent ${p?"invalid-input-animation":""}`,spellCheck:!1,autoComplete:"off",placeholder:N}),a.jsx("div",{className:"absolute top-0 pointer-events-none",style:{left:`${r.currentInput.length}ch`,transition:"left 0.05s ease-out"},children:a.jsx(Ie,{style:{type:S.cursorType??A.cursorType,color:S.cursorColor||A.cursorColor,speed:S.cursorSpeed||A.cursorSpeed}})})]})]})]})]})},Te=()=>{const r=$(),e=M(),n=j(),t="mt-2 border-t border-gray-700 px-4 py-2",o="text-gray-300",i=r.getCompletions(n.path());E.debug("[AvailableCommands] nextCommandSegments: ",i);const l=s.useMemo(()=>{const d=[...i],p=C=>C.name.toLowerCase()==="help",S=d.filter(C=>!p(C)).sort((C,_)=>C.name.localeCompare(_.name,void 0,{sensitivity:"base"}));if(!e.includeHelpCommand)return S;const b=d.find(p);return b?[...S,b]:S},[i,e.includeHelpCommand]),m=i.some(d=>d.type==="argument"),u=i[0];return a.jsx("div",{className:t,"data-testid":"available-commands",children:a.jsx("div",{className:o,children:m?i.length>0?a.jsxs(a.Fragment,{children:[a.jsx("span",{className:"text-blue-400",children:u.name}),u.description&&a.jsxs("span",{className:"text-gray-400 ml-2",children:["- ",u.description]})]}):null:a.jsx("div",{className:"flex flex-wrap gap-2",children:l==null?void 0:l.map(d=>{const p=l==null?void 0:l.reduce((g,S)=>{if(S===d)return g;let b=0;for(;b<d.name.length&&b<S.name.length&&d.name[b].toLowerCase()===S.name[b].toLowerCase();)b++;return Math.max(g,b+1)},1);return a.jsx("div",{className:"px-2 py-1 rounded bg-gray-800 mr-2 last:mr-0",children:a.jsxs("span",{className:"font-mono text-white",children:[a.jsx("strong",{className:"underline",children:d.name.slice(0,p)}),d.name.slice(p)]})},d.name)})})})})},le=({state:r,actions:e,outputRef:n})=>a.jsxs("div",{className:"innerContainer",children:[a.jsx("div",{className:"flex-1 min-h-0 pt-3 px-4",children:a.jsx(ze,{output:r.output,outputRef:n})}),a.jsxs("div",{children:[a.jsx(Me,{state:r,actions:e}),a.jsx(Te,{})]})]}),Ue=()=>{const[r,e]=s.useState(!1),[n,t]=s.useState(!1),o=M(),[i,l]=s.useState(()=>o.initialHeight||null),m=s.useRef(null),u=s.useRef(null),d=s.useRef(!1),p=s.useRef(0),g=s.useRef(0),{state:S,actions:b}=Y();Ee({onOpen:()=>e(!0),onClose:()=>t(!0),isVisible:r,showCitadelKey:o.showCitadelKey||"."});const C=s.useCallback(f=>{var k;if(!d.current)return;const N=f.clientY-p.current,y=(k=o.maxHeight)!=null&&k.endsWith("vh")?window.innerHeight*parseInt(o.maxHeight,10)/100:parseInt(o.maxHeight||"80vh",10),v=Math.min(Math.max(g.current-N,parseInt(o.minHeight||"200",10)),y);u.current&&(u.current.style.height=`${v}px`,u.current.style.bottom="0",l(`${v}px`))},[o.maxHeight,o.minHeight]),_=s.useCallback(()=>{d.current=!1,document.documentElement.style.userSelect="",document.documentElement.style.webkitUserSelect="",document.documentElement.style.mozUserSelect="",document.documentElement.style.msUserSelect="",document.removeEventListener("mousemove",C),document.removeEventListener("mouseup",_)},[C]),c=s.useCallback(f=>{u.current&&(d.current=!0,p.current=f.clientY,g.current=u.current.offsetHeight,document.documentElement.style.userSelect="none",document.documentElement.style.webkitUserSelect="none",document.documentElement.style.mozUserSelect="none",document.documentElement.style.msUserSelect="none",document.addEventListener("mousemove",C),document.addEventListener("mouseup",_))},[C,_]);s.useEffect(()=>()=>{document.removeEventListener("mousemove",C),document.removeEventListener("mouseup",_)},[C,_]);const h=s.useCallback(()=>{n&&(e(!1),t(!1))},[n]);return _e({isVisible:r,isClosing:n,onAnimationComplete:h}),r?a.jsxs("div",{ref:u,className:`panelContainer ${r?"citadel_slideUp":""} ${n?"citadel_slideDown":""}`,style:{...i?{height:i}:void 0,maxHeight:o.maxHeight},children:[a.jsx("div",{className:"resizeHandle",onMouseDown:c}),a.jsx(le,{state:S,actions:b,outputRef:m})]}):null},je=()=>{const{state:r,actions:e}=Y(),n=s.useRef(null);return a.jsx("div",{className:"inlineContainer","data-testid":"citadel-inline-container",children:a.jsx(le,{state:r,actions:e,outputRef:n})})},ce=`:host {
   --citadel-bg: rgb(17, 24, 39);
   --citadel-text: rgba(255, 255, 255, 0.87);
   --citadel-border: rgb(55, 65, 81);
@@ -200,7 +200,7 @@ a:hover {
 `,me=`@tailwind base;
 @tailwind components;
 @tailwind utilities;
-`,je=`*, ::before, ::after {
+`,Fe=`*, ::before, ::after {
   --tw-border-spacing-x: 0;
   --tw-border-spacing-y: 0;
   --tw-translate-x: 0;
@@ -1017,5 +1017,5 @@ video {
 .last\\:mr-0:last-child {
   margin-right: 0px;
 }
-`,Oe=({config:r=A,commandRegistry:e=new $,containerId:n=null})=>{const t=s.useRef(null),o=r.displayMode??A.displayMode??"panel";return s.useEffect(()=>{S.configure({level:r.logLevel||A.logLevel||j.ERROR,prefix:"[Citadel]"});const a=new ue(e,r),l=o==="inline"&&!n,d=l?t.current:n?document.getElementById(n):document.body;if(d)d.appendChild(a);else{if(l){console.warn("[Citadel] No host available for inline mode; skipping mount.");return}console.warn(`Container with id "${n}" not found, falling back to body`),document.body.appendChild(a)}return()=>{var u;(u=a.parentElement)==null||u.removeChild(a)}},[e,n,r,o]),o==="inline"&&!n?i.jsx("div",{ref:t,style:{width:"100%",height:"100%"}}):null};class ue extends HTMLElement{constructor(n,t){var a;super();y(this,"shadow");y(this,"root",null);y(this,"commandRegistry");y(this,"config");this.shadow=this.attachShadow({mode:"open"}),this.commandRegistry=n,this.config=t;const o=((a=this.config)==null?void 0:a.displayMode)??"panel";this.setAttribute("data-display-mode",o)}connectedCallback(){try{const t=[ce,de,me,je].map(o=>{const a=new CSSStyleSheet;return a.replaceSync(o),a});this.shadow.adoptedStyleSheets=[...t]}catch{const t=[ce,de,me].join(`
-`),o=document.createElement("style");o.textContent=t,this.shadow.appendChild(o)}const n=document.createElement("div");n.id="citadel-root",n.style.width="100%",n.style.height="100%",this.shadow.appendChild(n),this.root=pe.createRoot(n),this.root.render(i.jsx(Se,{config:this.config||A,commandRegistry:this.commandRegistry,children:i.jsx($e,{})}))}}customElements.define("citadel-element",ue);const $e=()=>(M().displayMode??"panel")==="inline"?i.jsx(Fe,{}):i.jsx(Ue,{});w.Citadel=Oe,w.CommandRegistry=$,w.CommandResult=P,w.CommandStatus=D,w.DEFAULT_CURSOR_CONFIGS=oe,w.ErrorCommandResult=G,w.ImageCommandResult=ge,w.JsonCommandResult=he,w.OutputItem=ne,w.PendingCommandResult=J,w.TextCommandResult=V,Object.defineProperty(w,Symbol.toStringTag,{value:"Module"})});
+`,Oe=({config:r=A,commandRegistry:e=new L,containerId:n=null})=>{const t=s.useRef(null),o=r.displayMode??A.displayMode??"panel";return s.useEffect(()=>{E.configure({level:r.logLevel||A.logLevel||F.ERROR,prefix:"[Citadel]"});const i=new ue(e,r),l=o==="inline"&&!n,m=l?t.current:n?document.getElementById(n):document.body;if(m)m.appendChild(i);else{if(l){console.warn("[Citadel] No host available for inline mode; skipping mount.");return}console.warn(`Container with id "${n}" not found, falling back to body`),document.body.appendChild(i)}return()=>{var u;(u=i.parentElement)==null||u.removeChild(i)}},[e,n,r,o]),o==="inline"&&!n?a.jsx("div",{ref:t,style:{width:"100%",height:"100%"}}):null};class ue extends HTMLElement{constructor(n,t){var i;super();x(this,"shadow");x(this,"root",null);x(this,"commandRegistry");x(this,"config");this.shadow=this.attachShadow({mode:"open"}),this.commandRegistry=n,this.config=t;const o=((i=this.config)==null?void 0:i.displayMode)??"panel";this.setAttribute("data-display-mode",o)}connectedCallback(){try{const t=[ce,de,me,Fe].map(o=>{const i=new CSSStyleSheet;return i.replaceSync(o),i});this.shadow.adoptedStyleSheets=[...t]}catch{const t=[ce,de,me].join(`
+`),o=document.createElement("style");o.textContent=t,this.shadow.appendChild(o)}const n=document.createElement("div");n.id="citadel-root",n.style.width="100%",n.style.height="100%",this.shadow.appendChild(n),this.root=pe.createRoot(n),this.root.render(a.jsx(Se,{config:this.config||A,commandRegistry:this.commandRegistry,children:a.jsx(Le,{})}))}}customElements.define("citadel-element",ue);const Le=()=>(M().displayMode??"panel")==="inline"?a.jsx(je,{}):a.jsx(Ue,{});w.Citadel=Oe,w.CommandRegistry=L,w.CommandResult=P,w.CommandStatus=D,w.DEFAULT_CURSOR_CONFIGS=oe,w.ErrorCommandResult=G,w.ImageCommandResult=ge,w.JsonCommandResult=he,w.OutputItem=ne,w.PendingCommandResult=J,w.TextCommandResult=V,Object.defineProperty(w,Symbol.toStringTag,{value:"Module"})});

package/dist/components/Citadel/types/command-registry.d.ts

@@ -66,6 +66,13 @@ export declare class CommandRegistry {
      * @throws {Error} If the segment list is empty or the path collides with an existing command.
      */
     addCommand(segments: CommandSegment[], description: string, handler?: CommandHandler): void;
+    /**
+     * Removes a command that exactly matches the provided path.
+     *
+     * @param path The command path to remove.
+     * @returns True if a command was removed; otherwise false.
+     */
+    removeCommand(path: string[]): boolean;
     /**
      * Retrieves a command from the registry for the given path.
      *

package/package.json

@@ -17,7 +17,7 @@
     "type": "git",
     "url": "git+https://github.com/jchilders/citadel_cli.git"
   },
-  "version": "1.1.5",
+  "version": "1.1.6",
   "type": "module",
   "scripts": {
     "build": "tsc && vite build",