xmlui 0.9.63 → 0.9.65

package/dist/lib/{transform-BdB0APqE.mjs → transform--lQ60cbR.mjs}

@@ -1,10 +1,10 @@
 import { parseRegExpLiteral as Xe } from "@eslint-community/regexpp";
-const Bn = 1, Wn = 2, Un = 3, Mn = 4, yn = 5, Fn = 6, $n = 7, qn = 8, Xn = 9, Gn = 10, Hn = 11, Qn = 12, zn = 13, Yn = 14, Jn = 15, Zn = 16, Kn = 17, Cn = 18, jn = 19, Vn = 20, er = 100, nr = 101, rr = 102, tr = 103, ir = 104, lr = 105, sr = 106, ar = 107, or = 108, cr = 109, ur = 110, fr = 111, hr = 112, dr = 113, pr = 114, Er = 115, kr = 116, gr = 117, _r = 118, Nr = 200, Sr = 201, Tr = 202, mr = 203, xr = 204, Ar = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const Bn = 1, Wn = 2, Un = 3, yn = 4, Mn = 5, Fn = 6, $n = 7, qn = 8, Xn = 9, Gn = 10, Hn = 11, Qn = 12, zn = 13, Yn = 14, Jn = 15, Zn = 16, Kn = 17, Cn = 18, jn = 19, Vn = 20, er = 100, nr = 101, rr = 102, tr = 103, ir = 104, lr = 105, sr = 106, ar = 107, or = 108, cr = 109, ur = 110, fr = 111, hr = 112, dr = 113, pr = 114, Er = 115, kr = 116, gr = 117, _r = 118, Nr = 200, Sr = 201, Tr = 202, mr = 203, xr = 204, Ar = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   T_ARRAY_DESTRUCTURE: Tr,
   T_ARRAY_LITERAL: ur,
   T_ARROW_EXPRESSION: Er,
-  T_ARROW_EXPRESSION_STATEMENT: Mn,
+  T_ARROW_EXPRESSION_STATEMENT: yn,
   T_ASSIGNMENT_EXPRESSION: dr,
   T_BINARY_EXPRESSION: nr,
   T_BLOCK_STATEMENT: Bn,
@@ -24,7 +24,7 @@ const Bn = 1, Wn = 2, Un = 3, Mn = 4, yn = 5, Fn = 6, $n = 7, qn = 8, Xn = 9, Gn
   T_FUNCTION_INVOCATION_EXPRESSION: ir,
   T_IDENTIFIER: ar,
   T_IF_STATEMENT: qn,
-  T_LET_STATEMENT: yn,
+  T_LET_STATEMENT: Mn,
   T_LITERAL: cr,
   T_MEMBER_ACCESS_EXPRESSION: lr,
   T_NO_ARG_EXPRESSION: pr,
@@ -88,7 +88,7 @@ const Bn = 1, Wn = 2, Un = 3, Mn = 4, yn = 5, Fn = 6, $n = 7, qn = 8, Xn = 9, Gn
   T_POSTFIX_OP_EXPRESSION: In,
   T_REACTIVE_VAR_DECLARATION: wn,
   // Other node type values
-  T_VAR_DECLARATION: Me,
+  T_VAR_DECLARATION: ye,
   T_DESTRUCTURE: Ie,
   T_ARRAY_DESTRUCTURE: te,
   T_OBJECT_DESTRUCTURE: ae,
@@ -213,7 +213,7 @@ class He {
   fetch() {
     const n = this, r = this.input, t = this._prefetchedPos || r.position, l = r.line, a = this._prefetchedColumn || r.column;
     this._lastFetchPosition = this.input.position;
-    let s = null, o = "", u = i.Eof, D = r.position, O = r.column, h = null, M = !1, _ = this.getStartingPhaseThenReset();
+    let s = null, o = "", u = i.Eof, D = r.position, O = r.column, h = null, y = !1, _ = this.getStartingPhaseThenReset();
     for (; ; ) {
       if (h = this.fetchNextChar(), h === null)
         return R();
@@ -304,7 +304,7 @@ class He {
               s = h, _ = 35;
               break;
             default:
-              Ye(h) ? (M = !0, _ = 17, u = i.Identifier) : re(h) ? (_ = 27, u = i.DecimalLiteral) : m(i.Unknown);
+              Ye(h) ? (y = !0, _ = 17, u = i.Identifier) : re(h) ? (_ = 27, u = i.DecimalLiteral) : m(i.Unknown);
               break;
           }
           break;
@@ -520,7 +520,7 @@ class He {
         case 6:
           if (h === "{")
             return m(i.DollarLBrace);
-          _ = 17, M = !0, u = i.Identifier, Je(h) || R();
+          _ = 17, y = !0, u = i.Identifier, Je(h) || R();
           break;
         case 33: {
           _ = 34;
@@ -679,7 +679,7 @@ class He {
       o += h, n._prefetched = null, n._prefetchedPos = null, n._prefetchedColumn = null, D = r.position, O = r.position;
     }
     function R() {
-      return M && (u = W.get(o) ?? (Ye(o[0]) && o[o.length - 1] !== "'" ? i.Identifier : i.Unknown)), {
+      return y && (u = W.get(o) ?? (Ye(o[0]) && o[o.length - 1] !== "'" ? i.Identifier : i.Unknown)), {
         text: o,
         type: u,
         startPosition: t,
@@ -948,7 +948,7 @@ let Ir = 0;
 function Le() {
   return ++Ir;
 }
-class ye {
+class Me {
   /**
    * Initializes the parser with the specified source code
    * @param source Source code to parse
@@ -1144,7 +1144,7 @@ class ye {
         return this.reportError("W009", s), null;
       if (t.push(
         this.createExpressionNode(
-          Me,
+          ye,
           a,
           l,
           r
@@ -1202,7 +1202,7 @@ class ye {
       if (s === null) return null;
       if (a.expr = s, r = s.endToken, t.push(
         this.createExpressionNode(
-          Me,
+          ye,
           a,
           l,
           r
@@ -1792,15 +1792,15 @@ class ye {
                 break;
               case fe: {
                 if (o = !h.parenthesized, o) {
-                  const M = this.convertToObjectDestructure(h);
-                  M && u.push(M);
+                  const y = this.convertToObjectDestructure(h);
+                  y && u.push(y);
                 }
                 break;
               }
               case ue: {
                 if (o = !h.parenthesized, o) {
-                  const M = this.convertToArrayDestructure(h);
-                  M && u.push(M);
+                  const y = this.convertToArrayDestructure(h);
+                  y && u.push(y);
                 }
                 break;
               }
@@ -2496,10 +2496,10 @@ class ye {
           this._lexer.get();
           let O = [];
           if (this._lexer.peek().type !== i.RParent) {
-            const M = this.parseExpr();
-            if (!M)
+            const y = this.parseExpr();
+            if (!y)
               return this.reportError("W001"), null;
-            O = M.type === ce ? M.exprs : [M];
+            O = y.type === ce ? y.exprs : [y];
           }
           const h = this._lexer.peek();
           this.expectToken(i.RParent, "W006"), r = this.createExpressionNode(
@@ -3544,11 +3544,11 @@ const Pe = {
   code: "W001",
   category: 1,
   message: "Invalid character."
-}, Mr = {
+}, yr = {
   code: "W002",
   category: 1,
   message: "Unterminated string literal."
-}, yr = {
+}, Mr = {
   code: "W007",
   category: 1,
   message: "Unterminated comment"
@@ -3571,7 +3571,7 @@ function qr(e, n, r, t, l) {
     getTokenText: () => a.substring(D, s),
     getTokenValue: () => h,
     isIdentifier: () => O === c.Identifier,
-    peekChar: M,
+    peekChar: y,
     scanChar: _,
     scan: V,
     scanTrivia: R,
@@ -3582,7 +3582,7 @@ function qr(e, n, r, t, l) {
     resetTokenState: ee,
     back: J
   };
-  function M(k) {
+  function y(k) {
     if (s + (k ?? 0) >= o)
       return null;
     const p = Q(s + (k ?? 0));
@@ -3659,7 +3659,7 @@ function qr(e, n, r, t, l) {
                 return s += 3, O = c.CommentTrivia;
               s += le(x(s));
             }
-            return f(yr, 4), O = c.Unknown;
+            return f(Mr, 4), O = c.Unknown;
           } else if (
             // --- <![CDATA[ section
             x(s + 1) === d.exclamation && x(s + 2) === d.openBracket && x(s + 3) === d.C && x(s + 4) === d.D && x(s + 5) === d.A && x(s + 6) === d.T && x(s + 7) === d.A && x(s + 8) === d.openBracket
@@ -3750,7 +3750,7 @@ function qr(e, n, r, t, l) {
     let p = "", S = s;
     for (; ; ) {
       if (s >= o) {
-        p += a.substring(S, s), f(Mr, 1);
+        p += a.substring(S, s), f(yr, 1);
         break;
       }
       if (x(s) === k) {
@@ -3839,7 +3839,7 @@ function Kr(e) {
           k();
           break;
         case c.OpenNodeStart:
-          M();
+          y();
           break;
         default:
           const N = z(Yr);
@@ -3858,7 +3858,7 @@ function Kr(e) {
           k();
           break;
         case c.OpenNodeStart:
-          M();
+          y();
           break;
         case c.CloseNodeStart:
         case c.EndOfFileToken:
@@ -3870,7 +3870,7 @@ function Kr(e) {
       }
     l.children && l.children.length > 0 ? S(c.ContentListNode) : w();
   }
-  function M() {
+  function y() {
     p(), f(c.OpenNodeStart);
     let g = !0, N = null;
     if (ie(c.Identifier)) {
@@ -3977,8 +3977,8 @@ function Kr(e) {
       return S(c.TagNameNode);
   }
   function Q(g, { nameIdent: N, nsIdent: T }) {
-    const b = D(N), A = T && D(T), I = ({ ns: U, name: de }) => de === b && U === A, P = g.findIndex(I) !== -1, y = "A" <= b[0] && b[0] <= "Z", G = P || y;
-    P && F($.duplAttr(b), N.pos, N.end), !T && y && F($.uppercaseAttr(b), N.pos, N.end), G || g.push({ name: b, ns: A });
+    const b = D(N), A = T && D(T), I = ({ ns: U, name: de }) => de === b && U === A, P = g.findIndex(I) !== -1, M = "A" <= b[0] && b[0] <= "Z", G = P || M;
+    P && F($.duplAttr(b), N.pos, N.end), !T && M && F($.uppercaseAttr(b), N.pos, N.end), G || g.push({ name: b, ns: A });
   }
   function X({ code: g, message: N, category: T }) {
     const { pos: b, end: A } = Z();
@@ -4035,19 +4035,19 @@ function Kr(e) {
         P = b;
         break;
       }
-    let y = !1;
+    let M = !1;
     if (g.kind === c.StringLiteral) {
       const xe = g.end, Ae = v(!0);
-      y = Ae.kind === c.CData || Ae.kind === c.CloseNodeStart || Ae.kind === c.Script || Ae.kind === c.OpenNodeStart, o.resetTokenState(xe);
+      M = Ae.kind === c.CData || Ae.kind === c.CloseNodeStart || Ae.kind === c.Script || Ae.kind === c.OpenNodeStart, o.resetTokenState(xe);
     }
     let G;
-    y ? G = g.pos : A.length > 0 ? G = A[A.length - 1].end : I !== -1 ? G = N[I].pos : G = g.start;
+    M ? G = g.pos : A.length > 0 ? G = A[A.length - 1].end : I !== -1 ? G = N[I].pos : G = g.start;
     let U;
     A.length > 0 && (U = A, A[0].pos);
     let de = c.TextNode, Se = -1;
     if (P !== -1)
       Se = N[P].pos, o.resetTokenState(Se);
-    else if (y)
+    else if (M)
       de = c.StringLiteral, Se = g.end;
     else {
       for (; ; ) {
@@ -4095,8 +4095,8 @@ function Kr(e) {
         const I = o.getTokenStart(), P = T.length > 0 ? T : void 0;
         if (T = [], g && A.code === $e.invalidChar)
           return a = void 0, new j(N, I, o.getTokenEnd(), P);
-        const y = I + a.prefixLength, G = new j(N, I, y, P);
-        return o.resetTokenState(y), p(), l.children.push(G), F(A, I, y), S(c.ErrorNode), a = void 0, v(g);
+        const M = I + a.prefixLength, G = new j(N, I, M, P);
+        return o.resetTokenState(M), p(), l.children.push(G), F(A, I, M), S(c.ErrorNode), a = void 0, v(g);
       }
       switch (N) {
         case c.CommentTrivia:
@@ -4304,7 +4304,7 @@ function L(e, n, r, t, l, a) {
     case Rn:
     case In:
       return n = (t == null ? void 0 : t(!0, e, n, l, a)) || n, n.cancel || !n.skipChildren && (n = L(e.expr, n, r, t, e, "operand"), n.cancel) || (n = (t == null ? void 0 : t(!1, e, n, l, a)) || n), n;
-    case Me: {
+    case ye: {
       if (n = (t == null ? void 0 : t(!0, e, n, l, a)) || n, n.cancel) return n;
       if (!n.skipChildren) {
         if (e.aDestr !== void 0) {
@@ -4354,7 +4354,7 @@ function jr(e, n) {
   function a(s, o) {
     if (r.has(s))
       return r.get(s);
-    const u = new ye(o);
+    const u = new Me(o);
     let D = [];
     try {
       D = u.parseStatements();
@@ -4370,19 +4370,19 @@ function jr(e, n) {
         line: O.startLine,
         column: O.startColumn
       }), null;
-    const h = [], M = {};
+    const h = [], y = {};
     D.filter((R) => R.type === be).forEach((R) => {
       const m = R;
-      if (M[m.id.name]) {
+      if (y[m.id.name]) {
         V("W020", R, m.id.name);
         return;
       }
-      M[m.id.name] = m;
+      y[m.id.name] = m;
     });
     const _ = {
       type: "ScriptModule",
       name: s,
-      functions: M,
+      functions: y,
       statements: D,
       sources: /* @__PURE__ */ new Map()
     };
@@ -4543,14 +4543,7 @@ function Tt(e, n, r) {
     if (k === Ve)
       return O(f);
     let p = {
-      type: k,
-      debug: {
-        source: {
-          start: f.start,
-          end: f.end,
-          fileId: r
-        }
-      }
+      type: k
     };
     return h(E, p, f), p;
   }
@@ -4558,14 +4551,7 @@ function Tt(e, n, r) {
     const k = sn(f, t, o);
     k === Ve && B("T006");
     let p = {
-      type: k,
-      debug: {
-        source: {
-          start: f.start,
-          end: f.end,
-          fileId: r
-        }
-      }
+      type: k
     };
     return h(E, p, f), p;
   }
@@ -4599,32 +4585,19 @@ function Tt(e, n, r) {
     });
     let P = D(s, I);
     o.pop();
-    const y = {
+    const M = {
       name: k.value,
-      component: P,
-      debug: {
-        source: {
-          start: E.start,
-          end: E.end,
-          fileId: r
-        }
-      }
-    };
-    S && (y.api = S), w && (P.vars = { ...P.vars, ...w }), p && (y.codeBehind = p.value), P.debug = {
-      source: {
-        start: I.start,
-        end: I.end,
-        fileId: r
-      }
+      component: P
     };
+    S && (M.api = S), w && (P.vars = { ...P.vars, ...w }), p && (M.codeBehind = p.value);
     const G = tn(E, b);
-    return h(s, y, G), y;
+    return h(s, M, G), M;
   }
   function h(E, f, k) {
     var N;
     const p = !ne(f), S = Ee(k);
     if (o.push(/* @__PURE__ */ new Map()), S.forEach((T) => {
-      M(f, T);
+      y(f, T);
     }), ke(k).forEach((T) => {
       if (T.kind === c.Script) {
         Ee(T).length > 0 && B("T022");
@@ -4720,7 +4693,7 @@ function Tt(e, n, r) {
       }
     }), o.pop(), !f.script || f.script.trim().length === 0)
       return;
-    const w = new ye(f.script);
+    const w = new Me(f.script);
     try {
       w.parseStatements(), f.scriptCollected = Vr("Main", f.script);
     } catch (T) {
@@ -4729,7 +4702,7 @@ function Tt(e, n, r) {
     const g = ((N = f.scriptCollected) == null ? void 0 : N.moduleErrors) ?? {};
     Object.keys(g).length > 0 && (f.scriptError = g);
   }
-  function M(E, f) {
+  function y(E, f) {
     const { namespace: k, startSegment: p, name: S, value: v, unsegmentedName: w } = x(f);
     if (k === "xmlns")
       return ln(o, E, w, v);
@@ -4825,7 +4798,7 @@ function Tt(e, n, r) {
     if (b && v.length >= 1) {
       if (w.length > 0)
         return B("T020"), null;
-      const P = v.map((y) => D(E, y));
+      const P = v.map((M) => D(E, M));
       return {
         name: b,
         value: P.length === 1 ? P[0] : P
@@ -4921,20 +4894,20 @@ function Tt(e, n, r) {
     let g = !1, N = !1;
     for (let I = 0; I < f.length; ++I) {
       const P = f[I];
-      let y;
+      let M;
       if (P.kind == c.Script) {
         N = !0;
         continue;
       }
       if (P.kind === c.ElementNode) {
-        y = X(P), f[I] = y;
+        M = X(P), f[I] = M;
         continue;
       }
       let G = t(P);
-      P.kind === c.StringLiteral ? G = G.slice(1, -1) : P.kind === c.CData ? g = !0 : (P.kind, c.TextNode), S ? g ? y = ot(G) : y = nn(G) : y = {
+      P.kind === c.StringLiteral ? G = G.slice(1, -1) : P.kind === c.CData ? g = !0 : (P.kind, c.TextNode), S ? g ? M = ot(G) : M = nn(G) : M = {
         kind: c.TextNode,
         text: G
-      }, f[I] = y;
+      }, f[I] = M;
     }
     const T = [], b = [];
     let A = !1;
@@ -5033,7 +5006,7 @@ function Tt(e, n, r) {
   function Z(E) {
     if (typeof E != "string")
       return E;
-    const f = new ye(E);
+    const f = new Me(E);
     try {
       return {
         __PARSED: !0,
@@ -5210,7 +5183,7 @@ function ln(e, n, r, t) {
   const s = e[e.length - 1];
   if (s.has(r))
     return B("T025", r);
-  s.set(r, a), n.namespaces ?? (n.namespaces = {}), n.namespaces[r] = a;
+  s.set(r, a);
 }
 function ut(e, n) {
   e.children.length !== 2 && B("T001");
@@ -5242,7 +5215,7 @@ export {
   d as C,
   Dn as D,
   $e as E,
-  ye as F,
+  Me as F,
   An as G,
   xn as H,
   q as I,
@@ -5286,15 +5259,15 @@ export {
   ue as ai,
   ce as aj,
   Ln as ak,
-  Me as al,
+  ye as al,
   Ie as am,
   Be as an,
   Vr as ao,
   St as ap,
   Pe as b,
-  Mr as c,
+  yr as c,
   _t as d,
-  yr as e,
+  Mr as e,
   Fr as f,
   $r as g,
   Nt as h,

package/dist/lib/xmlui-parser.d.ts

@@ -248,19 +248,67 @@ declare interface ComponentDef<TMd extends ComponentMetadata = ComponentMetadata
     contextVars?: Record<keyof TMd["contextVars"], string>;
 }
 
+/**
+ * This interface represents the core properties of a component definition
+ * (independent of component metadata).
+ */
 declare interface ComponentDefCore {
+    /**
+     * The type discriminator field of the component; it defines the unique ID of the component type.
+     */
     type: string;
+    /**
+     * Unique identifier of a component-like object
+     */
     uid?: string;
+    /**
+     * An optional identifier we use for e2e tests; it does not influence the rendering of a component.
+     */
     testId?: string;
-    namespaces?: Record<string, string>;
+    /**
+     * Though components manage their state internally, the app logic may require user
+     * state management. Components may have user *variables*, which the UI logic uses to
+     * manage the application state. This property holds the variables (name and value
+     * pairs) associated with this component definition.
+     */
     vars?: Record<string, any>;
+    /**
+     * Each component may have child components to constitute a hierarchy of components.
+     * This property holds the definition of these nested children.
+     */
     children?: ComponentDef[];
+    /**
+     * Components may have slots that can be filled with other components. This property
+     * holds the contents of the slots.
+     */
     slots?: Record<string, ComponentDef[]>;
+    /**
+     * This property is evaluated to a Boolean value during run time. When this value is
+     * `true`, the component with its children chain is rendered; otherwise, the entire
+     * component hierarchy is omitted from the rendered tree.
+     */
     when?: string | boolean;
+    /**
+     * Some components work with data obtained asynchronously. Fetching this data requires
+     * some state management handling the complexity (including error handling) of data
+     * access. A *loader* is responsible for managing this logic. This property holds the
+     * loaders associated with this component definition.
+     */
     loaders?: ComponentDef[];
+    /**
+     * Components may have functions that are used to perform some logic. This property
+     * holds the functions (name and function body) associated with this component
+     * definition.
+     */
     functions?: Record<string, any>;
+    /**
+     * Components managing state through variables or loaders are wrapped with containers
+     * responsible for this job. Just as components, containers form a hierarchy. While
+     * working with this hierarchy, parent components may flow state values (key and value
+     * pairs) to their child containers. This property holds the name of state values to
+     * flow down to the direct child containers.
+     */
     uses?: string[];
-    debug?: Record<string, any>;
 }
 
 export declare const componentFileExtension = "xmlui";

package/dist/lib/xmlui-parser.mjs

@@ -1,5 +1,5 @@
-import { q as s, s as t, A as i, t as r, v as n, C as o, r as d, a as g, b as m, f as C, e as p, g as l, c as N, D as _, o as D, E as c, N as E, P as S, S as x, T as U, U as A, j as L, h as P, d as f, i as y, B as u, n as b, k as h, m as M, l as v, w as I, u as O, p as T, x as K, z as R, y as X } from "./transform-BdB0APqE.mjs";
-import { b as F, L as B, X as j, a as q, c as w, g as z, e as G, l as H, d as V, m as W, p as J } from "./xmlui-serializer-COAfRndx.mjs";
+import { q as s, s as t, A as i, t as r, v as n, C as o, r as d, a as g, b as m, f as C, e as p, g as l, c as N, D as _, o as D, E as c, N as E, P as S, S as x, T as U, U as A, j as L, h as P, d as f, i as y, B as u, n as b, k as h, m as M, l as v, w as I, u as O, p as T, x as K, z as R, y as X } from "./transform--lQ60cbR.mjs";
+import { b as F, L as B, X as j, a as q, c as w, g as z, e as G, l as H, d as V, m as W, p as J } from "./xmlui-serializer-B1QY_Hg9.mjs";
 export {
   s as AttributeKeyNode,
   t as AttributeListNode,

package/dist/lib/{xmlui-serializer-COAfRndx.mjs → xmlui-serializer-B1QY_Hg9.mjs}

@@ -1,4 +1,4 @@
-import { v as A, t as j } from "./transform-BdB0APqE.mjs";
+import { v as A, t as j } from "./transform--lQ60cbR.mjs";
 const k = "xmlui", P = "xmlui.xs", D = "xs";
 var V = /* @__PURE__ */ ((l) => (l[l.Skip = 0] = "Skip", l[l.Warning = 1] = "Warning", l[l.Error = 2] = "Error", l))(V || {}), w = /* @__PURE__ */ ((l) => (l[l.UnrecognisedProp = 0] = "UnrecognisedProp", l))(w || {});
 function L(l) {
@@ -12,7 +12,9 @@ function L(l) {
     case "skip":
       return 0;
     default:
-      return console.warn(`Invalid lint severity option '${l}'. Must be one of: 'warning', 'error', 'skip'. Defaulting to 'warning'.`), 1;
+      return console.warn(
+        `Invalid lint severity option '${l}'. Must be one of: 'warning', 'error', 'skip'. Defaulting to 'warning'.`
+      ), 1;
   }
 }
 function z({
@@ -105,7 +107,13 @@ function g(l, e, t) {
   return t;
 }
 function x(l, e, t) {
-  const r = Object.keys(l.props ?? {}).filter((a) => !e.getAttr(a)), n = Object.keys(l.events ?? {}).filter((a) => !e.getEvent(a)), s = Object.keys(l.api ?? {}).filter((a) => !e.getApi(a));
+  const r = Object.keys(l.props ?? {}).filter(
+    (a) => !e.getAttr(a)
+  ), n = Object.keys(l.events ?? {}).filter(
+    (a) => !e.getEvent(a)
+  ), s = Object.keys(l.api ?? {}).filter(
+    (a) => !e.getApi(a)
+  );
   r.push(...n), r.push(...s);
   for (const a of r)
     t.push(S(l, a));

package/dist/lib/xmlui.d.ts

@@ -325,19 +325,67 @@ export declare interface ComponentDef<TMd extends ComponentMetadata = ComponentM
     contextVars?: Record<keyof TMd["contextVars"], string>;
 }
 
+/**
+ * This interface represents the core properties of a component definition
+ * (independent of component metadata).
+ */
 declare interface ComponentDefCore {
+    /**
+     * The type discriminator field of the component; it defines the unique ID of the component type.
+     */
     type: string;
+    /**
+     * Unique identifier of a component-like object
+     */
     uid?: string;
+    /**
+     * An optional identifier we use for e2e tests; it does not influence the rendering of a component.
+     */
     testId?: string;
-    namespaces?: Record<string, string>;
+    /**
+     * Though components manage their state internally, the app logic may require user
+     * state management. Components may have user *variables*, which the UI logic uses to
+     * manage the application state. This property holds the variables (name and value
+     * pairs) associated with this component definition.
+     */
     vars?: Record<string, any>;
+    /**
+     * Each component may have child components to constitute a hierarchy of components.
+     * This property holds the definition of these nested children.
+     */
     children?: ComponentDef[];
+    /**
+     * Components may have slots that can be filled with other components. This property
+     * holds the contents of the slots.
+     */
     slots?: Record<string, ComponentDef[]>;
+    /**
+     * This property is evaluated to a Boolean value during run time. When this value is
+     * `true`, the component with its children chain is rendered; otherwise, the entire
+     * component hierarchy is omitted from the rendered tree.
+     */
     when?: string | boolean;
+    /**
+     * Some components work with data obtained asynchronously. Fetching this data requires
+     * some state management handling the complexity (including error handling) of data
+     * access. A *loader* is responsible for managing this logic. This property holds the
+     * loaders associated with this component definition.
+     */
     loaders?: ComponentDef[];
+    /**
+     * Components may have functions that are used to perform some logic. This property
+     * holds the functions (name and function body) associated with this component
+     * definition.
+     */
     functions?: Record<string, any>;
+    /**
+     * Components managing state through variables or loaders are wrapped with containers
+     * responsible for this job. Just as components, containers form a hierarchy. While
+     * working with this hierarchy, parent components may flow state values (key and value
+     * pairs) to their child containers. This property holds the name of state values to
+     * flow down to the direct child containers.
+     */
     uses?: string[];
-    debug?: Record<string, any>;
 }
 
 declare type ComponentExtension = ComponentRendererDef | CompoundComponentDef;
@@ -880,7 +928,7 @@ declare interface NavHierarchyNode {
     lastLink?: boolean;
 }
 
-export declare function NestedApp({ api, app, components, config, activeTheme, activeTone, title, height, allowPlaygroundPopup, popOutUrl, withFrame, style, refVersion, }: NestedAppProps): JSX_2.Element;
+export declare function NestedApp({ api, app, components, config, activeTheme, activeTone, title, height, allowPlaygroundPopup, popOutUrl, withFrame, noHeader, style, refVersion, }: NestedAppProps): JSX_2.Element;
 
 declare type NestedAppProps = {
     api?: any;
@@ -894,6 +942,7 @@ declare type NestedAppProps = {
     allowPlaygroundPopup?: boolean;
     popOutUrl?: string;
     withFrame?: boolean;
+    noHeader?: boolean;
     style?: CSSProperties;
     splitView?: boolean;
     refVersion?: number;

package/dist/lib/xmlui.mjs

@@ -1,5 +1,5 @@
-import { y as e, A as t, B as o, E as r, I as n, L as p, H as u, N as i, z as l, i as C, h as d, S as m, b as x, k as T, l as c, D as S, F as A, G as g, V as h, C as v, c as B, e as I, f as L, w as b, j as k, p as y, s as E, t as M, K as V, n as f, q as H, M as N, v as R, J as D, u as U, x as X } from "./index-BcEgj7aN.mjs";
-import { X as q } from "./xmlui-serializer-COAfRndx.mjs";
+import { y as e, A as t, B as o, E as r, I as n, L as p, H as u, N as i, z as l, i as C, h as d, S as m, b as x, k as T, l as c, D as S, F as A, G as g, V as h, C as v, c as B, e as I, f as L, w as b, j as k, p as y, s as E, t as M, K as V, n as f, q as H, M as N, v as R, J as D, u as U, x as X } from "./index-E-Ytu3U3.mjs";
+import { X as q } from "./xmlui-serializer-B1QY_Hg9.mjs";
 export {
   e as ApiInterceptorProvider,
   t as AppRoot,

package/dist/metadata/{apiInterceptorWorker-PHZNbofw.mjs → apiInterceptorWorker-BK3aQR7T.mjs}

@@ -7,7 +7,7 @@ var F = (e, a, o) => Go(e, typeof a != "symbol" ? a + "" : a, o), ka = (e, a, o)
 var ge = (e, a, o) => (ka(e, a, "read from private field"), o ? o.call(e) : a.get(e)), _e = (e, a, o) => a.has(e) ? Wa("Cannot add the same private member more than once") : a instanceof WeakSet ? a.add(e) : a.set(e, o), fa = (e, a, o, t) => (ka(e, a, "write to private field"), t ? t.call(e, o) : a.set(e, o), o), ze = (e, a, o) => (ka(e, a, "access private method"), o);
 import { delay as Ho, HttpResponse as Be, http as Vo } from "msw";
 import { isArray as co, isObject as lo, mapValues as Jo } from "lodash-es";
-import { r as Xo, g as Ko, d as Yo, m as Qo, a as Zo, o as ba, T as et } from "./collectedComponentMetadata-BGIWhaXW.mjs";
+import { r as Xo, g as Ko, d as Yo, m as Qo, a as Zo, o as ba, T as et } from "./collectedComponentMetadata-yjl6u0V8.mjs";
 import Ga from "dexie";
 var at = /(%?)(%([sdijo]))/g;
 function ot(e, a) {