@zeyos/zx 2.3.0 → 4.0.0

package/dist/zx-zeyos.esm.js

@@ -136,12 +136,12 @@ function registerFieldType(typeOrFormat, strategy) {
 function fieldToZxField(meta) {
   const normalized = normalizeMeta(meta);
   const strategy = strategyFor(normalized);
-  const fragment = strategyPart(strategy.field, normalized);
+  const fragment2 = strategyPart(strategy.field, normalized);
   const descriptor = {
     id: normalized.id,
     type: "text",
     label: fieldLabel(normalized),
-    ...fragment
+    ...fragment2
   };
   if (normalized.description != null) descriptor.description = String(normalized.description);
   if (normalized.required === true || normalized.nullable === false) descriptor.required = true;
@@ -524,6 +524,18 @@ function cloneValue(value) {
 
 // src/core/dom.js
 var activeRefs = null;
+function safeHref(value) {
+  if (typeof value !== "string") return null;
+  const href = value.trim();
+  if (!href) return null;
+  try {
+    const protocol = new URL(href, globalThis.location?.href ?? "https://zx.invalid/").protocol;
+    if (["javascript:", "data:", "vbscript:"].includes(protocol.toLowerCase())) return null;
+  } catch {
+    return null;
+  }
+  return href;
+}
 function h(tag, props, ...children) {
   const element = document.createElement(tag);
   let properties = props;
@@ -2970,6 +2982,14 @@ var MonthPicker = class extends DatePicker {
   static cssName = "month-picker";
   /** @type {MonthPickerOptions} */
   static defaults = { value: null, min: null, max: null };
+  /**
+   * Creates a month picker with its narrower month-based option contract.
+   * @param {Element|string|null} target Existing element, selector, or null.
+   * @param {MonthPickerOptions} [options={}] Month-picker options.
+   */
+  constructor(target, options = {}) {
+    super(target, options);
+  }
   /** @returns {HTMLElement} */
   render() {
     const root = (
@@ -3189,7 +3209,13 @@ var PLACEMENTS = /* @__PURE__ */ new Set([
   "top-start",
   "top-end",
   "bottom",
-  "top"
+  "top",
+  "right-start",
+  "right-end",
+  "left-start",
+  "left-end",
+  "right",
+  "left"
 ]);
 function position(anchor, floating, options = {}) {
   if (!(anchor instanceof Element) || !(floating instanceof HTMLElement)) {
@@ -3217,13 +3243,15 @@ function position(anchor, floating, options = {}) {
     floating.style.inset = "auto";
     floating.style.margin = "0";
     floating.style.setProperty("position-anchor", anchorName);
-    floating.style.setProperty("position-area", positionArea(placement));
-    floating.style.setProperty("inset-area", positionArea(placement));
+    const area = positionArea(placement, getComputedStyle(anchor).direction === "rtl");
+    floating.style.setProperty("position-area", area);
+    floating.style.setProperty("inset-area", area);
     floating.style.setProperty(
       "position-try-fallbacks",
       flip ? "flip-block, flip-inline, flip-block flip-inline" : "none"
     );
-    floating.style.setProperty(placement.startsWith("top") ? "margin-block-end" : "margin-block-start", `${offset}px`);
+    const margin = placement.startsWith("top") ? "margin-bottom" : placement.startsWith("bottom") ? "margin-top" : placement.startsWith("left") ? "margin-right" : "margin-left";
+    floating.style.setProperty(margin, `${offset}px`);
     update = () => {
       if (matchWidth) floating.style.minWidth = `${anchor.getBoundingClientRect().width}px`;
     };
@@ -3267,14 +3295,20 @@ function position(anchor, floating, options = {}) {
     }
   };
 }
-function positionArea(placement) {
+function positionArea(placement, rtl) {
   return {
-    "bottom-start": "block-end span-inline-end",
-    "bottom-end": "block-end span-inline-start",
-    "top-start": "block-start span-inline-end",
-    "top-end": "block-start span-inline-start",
-    bottom: "block-end",
-    top: "block-start"
+    "bottom-start": rtl ? "bottom span-left" : "bottom span-right",
+    "bottom-end": rtl ? "bottom span-right" : "bottom span-left",
+    "top-start": rtl ? "top span-left" : "top span-right",
+    "top-end": rtl ? "top span-right" : "top span-left",
+    "right-start": "right span-bottom",
+    "right-end": "right span-top",
+    "left-start": "left span-bottom",
+    "left-end": "left span-top",
+    bottom: "bottom",
+    top: "top",
+    right: "right",
+    left: "left"
   }[placement];
 }
 function updateFallback(anchor, floating, { placement, offset, flip, matchWidth }) {
@@ -3284,26 +3318,54 @@ function updateFallback(anchor, floating, { placement, offset, flip, matchWidth
   const viewportWidth = document.documentElement.clientWidth || window.innerWidth;
   const viewportHeight = document.documentElement.clientHeight || window.innerHeight;
   let actualPlacement = placement;
-  const prefersBottom = placement.startsWith("bottom");
+  const side = placementSide(placement);
   const bottomY = anchorRect.bottom + offset;
   const topY = anchorRect.top - offset - floatingRect.height;
+  const rightX = anchorRect.right + offset;
+  const leftX = anchorRect.left - offset - floatingRect.width;
   if (flip) {
-    if (prefersBottom && bottomY + floatingRect.height > viewportHeight && topY >= 0) {
-      actualPlacement = /** @type {typeof placement} */
-      placement.replace("bottom", "top");
-    } else if (!prefersBottom && topY < 0 && bottomY + floatingRect.height <= viewportHeight) {
-      actualPlacement = /** @type {typeof placement} */
-      placement.replace("top", "bottom");
+    if (side === "bottom" && bottomY + floatingRect.height > viewportHeight && topY >= 0) {
+      actualPlacement = flipPlacement(placement, "bottom", "top");
+    } else if (side === "top" && topY < 0 && bottomY + floatingRect.height <= viewportHeight) {
+      actualPlacement = flipPlacement(placement, "top", "bottom");
+    } else if (side === "right" && rightX + floatingRect.width > viewportWidth && leftX >= 0) {
+      actualPlacement = flipPlacement(placement, "right", "left");
+    } else if (side === "left" && leftX < 0 && rightX + floatingRect.width <= viewportWidth) {
+      actualPlacement = flipPlacement(placement, "left", "right");
     }
   }
+  const actualSide = placementSide(actualPlacement);
   let left;
-  if (actualPlacement.endsWith("-end")) left = anchorRect.right - floatingRect.width;
-  else if (actualPlacement.endsWith("-start")) left = anchorRect.left;
-  else left = anchorRect.left + (anchorRect.width - floatingRect.width) / 2;
-  const top = actualPlacement.startsWith("bottom") ? bottomY : topY;
+  let top;
+  if (actualSide === "bottom" || actualSide === "top") {
+    const rtl = getComputedStyle(anchor).direction === "rtl";
+    if (actualPlacement.endsWith("-end")) {
+      left = rtl ? anchorRect.left : anchorRect.right - floatingRect.width;
+    } else if (actualPlacement.endsWith("-start")) {
+      left = rtl ? anchorRect.right - floatingRect.width : anchorRect.left;
+    } else left = anchorRect.left + (anchorRect.width - floatingRect.width) / 2;
+    top = actualSide === "bottom" ? bottomY : topY;
+  } else {
+    left = actualSide === "right" ? rightX : leftX;
+    if (actualPlacement.endsWith("-end")) top = anchorRect.bottom - floatingRect.height;
+    else if (actualPlacement.endsWith("-start")) top = anchorRect.top;
+    else top = anchorRect.top + (anchorRect.height - floatingRect.height) / 2;
+  }
   floating.style.left = `${Math.round(clamp(left, 0, Math.max(0, viewportWidth - floatingRect.width)))}px`;
   floating.style.top = `${Math.round(clamp(top, 0, Math.max(0, viewportHeight - floatingRect.height)))}px`;
 }
+function placementSide(placement) {
+  return (
+    /** @type {'top'|'bottom'|'left'|'right'} */
+    placement.split("-")[0]
+  );
+}
+function flipPlacement(placement, from, to) {
+  return (
+    /** @type {Placement} */
+    placement.replace(from, to)
+  );
+}
 function showPopover(element) {
   if (typeof element.showPopover !== "function") return;
   try {
@@ -4136,31 +4198,31 @@ var PLACEHOLDER_TOKENS = {
   "%Y": "YYYY",
   "%y": "YY"
 };
-function parseRangeText(text3, format, separator) {
+function parseRangeText(text3, format2, separator) {
   const source = String(text3 ?? "").trim();
   if (source === "") return { start: null, end: null };
   const raw2 = String(separator ?? " \u2013 ");
   const core = raw2.trim();
-  const strict = core !== "" && String(format).includes(core) && /^\s|\s$/.test(raw2);
+  const strict = core !== "" && String(format2).includes(core) && /^\s|\s$/.test(raw2);
   const lead = strict ? "\\s+" : "\\s*";
   const tail = strict ? "(?:\\s+|$)" : "\\s*";
   const parts = core === "" ? [source] : source.split(new RegExp(`${lead}${escapeRegExp(core)}${tail}`));
   if (parts.length > 2) return null;
-  const first = parseDate(parts[0].trim(), format);
+  const first = parseDate(parts[0].trim(), format2);
   if (!first) return null;
   if (parts.length === 1) return { start: first, end: new Date(first.getTime()) };
   if (parts[1].trim() === "") return { start: first, end: null };
-  const second = parseDate(parts[1].trim(), format);
+  const second = parseDate(parts[1].trim(), format2);
   if (!second) return null;
   return normalizeRange(first, second);
 }
-function formatRangeText(range, format, separator) {
+function formatRangeText(range, format2, separator) {
   const start = range?.start ?? null;
   const end = range?.end ?? null;
   if (!start && !end) return "";
-  if (!end) return formatDate(start, format);
-  if (!start) return formatDate(end, format);
-  return `${formatDate(start, format)}${separator}${formatDate(end, format)}`;
+  if (!end) return formatDate(start, format2);
+  if (!start) return formatDate(end, format2);
+  return `${formatDate(start, format2)}${separator}${formatDate(end, format2)}`;
 }
 var DateRangeBox = class extends Component {
   static cssName = "date-range-box";
@@ -4818,12 +4880,12 @@ var DateTimeBox = function DateTimeBox2(target, options = {}) {
 function validDate4(value) {
   return value instanceof Date && !Number.isNaN(value.getTime()) ? new Date(value.getTime()) : null;
 }
-function effectiveFormat(format, time) {
-  const value = String(format || "%d.%m.%Y");
+function effectiveFormat(format2, time) {
+  const value = String(format2 || "%d.%m.%Y");
   return time && !/%[HM]/.test(value) ? `${value} %H:%M` : value;
 }
-function placeholderFromFormat(format) {
-  return format.replace(/%[demYyHMS]/g, (token) => ({
+function placeholderFromFormat(format2) {
+  return format2.replace(/%[demYyHMS]/g, (token) => ({
     "%d": "DD",
     "%e": "D",
     "%m": "MM",
@@ -6483,7 +6545,18 @@ var PRIORITY_KEYS = [
   "priority.high",
   "priority.highest"
 ];
-var PRIORITY_FALLBACKS = ["Lowest", "Low", "Normal", "High", "Highest"];
+var PRIORITY_FALLBACKS = ["Lowest", "Low", "Medium", "High", "Highest"];
+var DEFAULT_STATUSES = Object.freeze([
+  ["backlog", "status.backlog", "Backlog", "dotted", "muted"],
+  ["todo", "status.todo", "Todo", "ring", "neutral"],
+  ["in-progress", "status.inProgress", "In Progress", "progress", "warning"],
+  ["in-review", "status.inReview", "In Review", "review", "info"],
+  ["ready", "status.ready", "Ready to Merge", "ready", "accent"],
+  ["waiting", "status.waiting", "Waiting for feedback", "waiting", "warning"],
+  ["done", "status.done", "Done", "done", "info"],
+  ["canceled", "status.canceled", "Canceled", "canceled", "muted"],
+  ["duplicate", "status.duplicate", "Duplicate", "duplicate", "muted"]
+]);
 var Select = class _Select extends Component {
   static cssName = "select";
   /** @type {SelectOptions} */
@@ -6494,6 +6567,10 @@ var Select = class _Select extends Component {
     labelKey: "name",
     renderItem: null,
     renderValue: null,
+    renderValueAdornment: null,
+    renderNone: null,
+    noneLabel: null,
+    actions: [],
     value: null,
     disabled: false,
     placeholder: "",
@@ -6511,6 +6588,7 @@ var Select = class _Select extends Component {
     this._visibleItems = [];
     this._fixedItems = [];
     this._visibleFixed = [];
+    this._actions = [];
     this._selected = null;
     this._optionEntries = [];
     this._activeIndex = -1;
@@ -6549,6 +6627,12 @@ var Select = class _Select extends Component {
       placeholder: String(this.options.placeholder ?? ""),
       readOnly: !this.options.filter
     });
+    const valueAdornment = h("span", {
+      ref: "valueAdornment",
+      class: "zx-select__value-adornment",
+      ariaHidden: "true",
+      hidden: true
+    });
     const clear = h("button", {
       ref: "clear",
       class: "zx-icon-btn zx-select__clear",
@@ -6574,6 +6658,7 @@ var Select = class _Select extends Component {
     const control = h(
       "div",
       { ref: "control", class: "zx-select__control" },
+      valueAdornment,
       input,
       clear,
       loading,
@@ -6596,9 +6681,10 @@ var Select = class _Select extends Component {
     this._visibleItems = this._items.slice();
     this._fixedItems = Array.isArray(this.options.fixedItems) ? this.options.fixedItems.slice() : [];
     this._visibleFixed = this._fixedItems.slice();
+    this._actions = normalizeSelectActions(this.options.actions);
     this._disabled = Boolean(this.options.disabled);
     this._handleTypeahead = typeahead(
-      () => this._optionEntries.filter((entry) => !entry.clear).map((entry) => entry.element),
+      () => this._optionEntries.filter((entry) => !entry.clear && !entry.action).map((entry) => entry.element),
       (_option, index) => {
         if (!this._open) this.open();
         this._setActive(this._itemEntryIndex(index));
@@ -6693,6 +6779,13 @@ var Select = class _Select extends Component {
     this._position?.update();
     return this;
   }
+  /** Replaces command rows without changing the selected value. @param {SelectAction[]} actions @returns {this} */
+  setActions(actions) {
+    this._actions = normalizeSelectActions(actions);
+    this._renderOptions();
+    this._position?.update();
+    return this;
+  }
   /**
    * Restores the configured initial value.
    * @param {{silent?: boolean}} [options={}] Reset behavior.
@@ -6777,26 +6870,51 @@ var Select = class _Select extends Component {
       value: null,
       items: [],
       renderItem(item) {
-        return h(
-          "span",
-          { class: "zx-select__priority" },
-          h("span", {
-            class: "zx-select__priority-icon",
-            dataset: { level: item.level },
-            ariaHidden: "true"
-          }),
-          h("span", {}, String(item.name))
-        );
+        return priorityContent(item, true);
+      },
+      renderValueAdornment(item) {
+        return priorityIndicator(item.level);
       }
     });
-    select.setItems(PRIORITY_KEYS.map((key, level) => ({
-      ID: level,
-      name: select._message(key, PRIORITY_FALLBACKS[level]),
-      level
-    })));
+    select.setItems(PRIORITY_KEYS.map((key, level) => {
+      let name = level === 2 ? select.msg("priority.medium") : key;
+      if (name === "priority.medium") name = select._message(key, PRIORITY_FALLBACKS[level]);
+      else if (level !== 2) name = select._message(key, PRIORITY_FALLBACKS[level]);
+      return { ID: level, name, level };
+    }));
     select.set(requestedValue, { silent: true });
     return select;
   }
+  /**
+   * Creates a status picker with shape- and color-distinct workflow indicators.
+   * @param {Element|string|null} target Component target.
+   * @param {SelectOptions & {items?: Array<Record<string, any>>}} [options={}] Select overrides and status items.
+   * @returns {Select}
+   */
+  static status(target, options = {}) {
+    const { items = null, value = null, ...rest } = options;
+    const select = new _Select(target, {
+      ...rest,
+      value: null,
+      items: [],
+      renderItem(item) {
+        return statusContent(item);
+      },
+      renderValueAdornment(item) {
+        return statusIndicator(item);
+      }
+    });
+    const statuses = Array.isArray(items) ? items.map(normalizeStatusItem).filter(Boolean) : DEFAULT_STATUSES.map(([ID, key, fallback, indicator, tone], index) => ({
+      ID,
+      name: select._message(key, fallback),
+      indicator,
+      tone,
+      shortcut: String(index + 1)
+    }));
+    select.setItems(statuses);
+    select.set(value, { silent: true });
+    return select;
+  }
   /**
    * Creates the record-permission picker: the fixed Private and Public choices above the groups a
    * record can be shared with. The value is the tri-state ZeyOS stores — `false` for private,
@@ -6809,12 +6927,21 @@ var Select = class _Select extends Component {
    * @returns {Select}
    */
   static permission(target, options = {}) {
-    const { groups = [], value = true, valueKey = "ID", labelKey = "name", ...rest } = options;
+    const {
+      groups = [],
+      value = true,
+      valueKey = "ID",
+      labelKey = "name",
+      filter = "local",
+      ...rest
+    } = options;
     const loader = typeof groups === "function" ? groups : null;
     const shareable = loader ? [] : groups;
     const choices = [{ ID: false, name: "Private" }, { ID: true, name: "Public" }];
     const select = new _Select(target, {
-      filter: loader ?? "local",
+      // An async group loader is the data source and cannot be disconnected by an incidental
+      // `filter` override. Array-backed groups still honor local/disabled filtering.
+      filter: loader ?? filter,
       ...rest,
       value: null,
       items: shareable,
@@ -6850,6 +6977,18 @@ var Select = class _Select extends Component {
   /** @param {KeyboardEvent} event @returns {void} */
   _onKeydown(event) {
     if (this._disabled) return;
+    if (this._open && isPrintable(event)) {
+      const shortcut = this._optionEntries.findIndex((entry) => !entry.clear && !entry.action && String(
+        /** @type {Record<string, any>|null} */
+        entry.item?.shortcut ?? ""
+      ) === event.key);
+      if (shortcut >= 0) {
+        event.preventDefault();
+        this._setActive(shortcut);
+        this._chooseEntry(this._optionEntries[shortcut]);
+        return;
+      }
+    }
     if (event.key === "ArrowDown") {
       event.preventDefault();
       if (!this._open) this.open();
@@ -6897,6 +7036,7 @@ var Select = class _Select extends Component {
       /** @type {HTMLInputElement} */
       this.refs.input.value
     );
+    this._syncValueAdornment();
     if (!this._open) this.open();
     if (this.options.filter === "local") {
       this._visibleFixed = this._matchFixed(query);
@@ -6920,6 +7060,22 @@ var Select = class _Select extends Component {
   /** @param {SelectOptionEntry|undefined} entry @returns {void} */
   _chooseEntry(entry) {
     if (!entry) return;
+    if (entry.action) {
+      const detail = {
+        id: entry.action.id,
+        action: entry.action,
+        query: (
+          /** @type {HTMLInputElement} */
+          this.refs.input.value
+        ),
+        select: this
+      };
+      const action = this.emit("action", detail);
+      if (!action.defaultPrevented) entry.action.invoke?.(detail);
+      this.close();
+      this.focus();
+      return;
+    }
     this.set(entry.clear ? null : entry.item);
     this.close();
     this.focus();
@@ -6953,7 +7109,7 @@ var Select = class _Select extends Component {
     this._optionEntries = [];
     let lastGroup = /* @__PURE__ */ Symbol("initial-group");
     if (this.options.clearable) {
-      this._appendOption(null, true, this.options.placeholder || this._message("select.none", "No selection"));
+      this._appendOption(null, true, this.options.noneLabel ?? this._message("select.none", "No selection"));
     }
     for (const item of this._visibleFixed) this._appendOption(item, false);
     if (this._visibleFixed.length > 0 && this._visibleItems.length > 0 && !this.options.groupKey) {
@@ -6972,7 +7128,23 @@ var Select = class _Select extends Component {
       }
       this._appendOption(item, false);
     }
-    if (this._visibleItems.length === 0 && this._visibleFixed.length === 0 && !this._loading) {
+    if (this._actions.length > 0) {
+      if (this._visibleFixed.length > 0 || this._visibleItems.length > 0 || this.options.clearable) {
+        list.append(h("div", { class: "zx-select__separator", role: "presentation" }));
+      }
+      let actionGroup = /* @__PURE__ */ Symbol("initial-action-group");
+      for (const action of this._actions) {
+        if (action.group && action.group !== actionGroup) {
+          list.append(h("div", {
+            class: "zx-select__group",
+            role: "presentation"
+          }, action.group));
+          actionGroup = action.group;
+        }
+        this._appendAction(action);
+      }
+    }
+    if (this._visibleItems.length === 0 && this._visibleFixed.length === 0 && this._actions.length === 0 && !this._loading) {
       list.append(h("div", {
         class: "zx-select__empty",
         role: "status"
@@ -6984,7 +7156,7 @@ var Select = class _Select extends Component {
   _appendOption(item, clear, label) {
     const selected = clear ? this._selected === null : this._selected !== null && Object.is(this._itemValue(item), this.value);
     const index = this._optionEntries.length;
-    const content = clear ? String(label ?? "") : this._renderItem(item);
+    const content = clear && typeof this.options.renderNone === "function" ? normalizeRenderedContent(this.options.renderNone(String(label ?? ""))) : clear ? String(label ?? "") : this._renderItem(item);
     const option = h("div", {
       class: "zx-select__option",
       id: uid("zx-select-option"),
@@ -6994,16 +7166,37 @@ var Select = class _Select extends Component {
     }, h("span", { class: "zx-select__option-content" }, content));
     if (selected) option.append(icon("check", { size: 15 }));
     this.refs.list.append(option);
-    this._optionEntries.push({ item, clear, element: option });
+    this._optionEntries.push({ item, clear, action: null, element: option });
+  }
+  /** @param {SelectAction} action @returns {void} */
+  _appendAction(action) {
+    const index = this._optionEntries.length;
+    const visual = selectActionIcon(action.icon);
+    const option = h("div", {
+      class: "zx-select__option zx-select__action",
+      id: uid("zx-select-option"),
+      role: "option",
+      ariaSelected: "false",
+      dataset: { index, kind: "action" }
+    }, h(
+      "span",
+      { class: "zx-select__option-content zx-select__action-content" },
+      visual ? h("span", { class: "zx-select__action-icon", ariaHidden: "true" }, visual) : null,
+      h(
+        "span",
+        { class: "zx-select__action-copy" },
+        h("span", { class: "zx-select__action-label" }, action.label),
+        action.description ? h("span", { class: "zx-select__action-description" }, action.description) : null
+      )
+    ));
+    this.refs.list.append(option);
+    this._optionEntries.push({ item: null, clear: false, action, element: option });
   }
   /** @param {SelectItem|null} item @returns {Node|string} */
   _renderItem(item) {
     if (typeof this.options.renderItem === "function") {
       const rendered = this.options.renderItem(item);
-      return rendered && typeof rendered === "object" && "nodeType" in rendered ? (
-        /** @type {Node} */
-        rendered
-      ) : String(rendered ?? "");
+      return normalizeRenderedContent(rendered);
     }
     return this._itemLabel(item);
   }
@@ -7074,9 +7267,29 @@ var Select = class _Select extends Component {
       this.refs.input
     );
     input.value = this._selected === null ? "" : typeof this.options.renderValue === "function" ? String(this.options.renderValue(this._selected) ?? "") : this._itemLabel(this._selected);
+    this._syncValueAdornment();
     this.refs.clear.hidden = !this.options.clearable || this._selected === null;
   }
   /** @returns {void} */
+  _syncValueAdornment() {
+    const host = this.refs.valueAdornment;
+    if (!host) return;
+    const selectedLabel = this._selected === null ? "" : typeof this.options.renderValue === "function" ? String(this.options.renderValue(this._selected) ?? "") : this._itemLabel(this._selected);
+    const query = String(
+      /** @type {HTMLInputElement} */
+      this.refs.input?.value ?? ""
+    );
+    if (this._selected === null || typeof this.options.renderValueAdornment !== "function" || Boolean(this.options.filter && query !== selectedLabel)) {
+      host.replaceChildren();
+      host.hidden = true;
+      return;
+    }
+    const rendered = this.options.renderValueAdornment(this._selected);
+    const content = normalizeRenderedContent(rendered);
+    host.replaceChildren(content instanceof Node ? content : document.createTextNode(content));
+    host.hidden = rendered == null || typeof content === "string" && content === "";
+  }
+  /** @returns {void} */
   _syncDisabled() {
     const input = (
       /** @type {HTMLInputElement} */
@@ -7153,6 +7366,82 @@ var Select = class _Select extends Component {
     return message === key ? fallback : message;
   }
 };
+function normalizeRenderedContent(rendered) {
+  return rendered && typeof rendered === "object" && "nodeType" in rendered ? (
+    /** @type {Node} */
+    rendered
+  ) : String(rendered ?? "");
+}
+function normalizeSelectActions(actions) {
+  if (!Array.isArray(actions)) return [];
+  return actions.filter((action) => action && typeof action === "object" && action.id != null && action.label != null).map((action) => ({
+    ...action,
+    label: String(action.label),
+    description: action.description == null ? void 0 : String(action.description),
+    group: action.group == null ? void 0 : String(action.group)
+  }));
+}
+function selectActionIcon(visual) {
+  if (typeof visual === "string") return icon(visual);
+  if (visual instanceof Node) return visual.cloneNode(true);
+  return null;
+}
+function priorityContent(item, label) {
+  return h(
+    "span",
+    { class: "zx-select__priority" },
+    priorityIndicator(item.level),
+    label ? h("span", {}, String(item.name)) : null
+  );
+}
+function priorityIndicator(level) {
+  const normalized = Math.max(0, Math.min(4, Math.trunc(Number(level) || 0)));
+  return h("span", {
+    class: "zx-select__priority-icon",
+    dataset: { level: normalized },
+    ariaHidden: "true"
+  }, Array.from({ length: 5 }, (_, index) => h("span", {
+    dataset: { filled: String(index <= normalized) }
+  })));
+}
+function normalizeStatusItem(input) {
+  if (!input || typeof input !== "object" || input.ID == null || input.name == null) return null;
+  const indicators = ["dotted", "ring", "progress", "review", "ready", "waiting", "done", "canceled", "duplicate"];
+  const tones = ["muted", "neutral", "warning", "info", "accent", "success", "danger"];
+  return {
+    ...input,
+    name: String(input.name),
+    indicator: indicators.includes(String(input.indicator)) ? String(input.indicator) : "ring",
+    tone: tones.includes(String(input.tone)) ? String(input.tone) : "muted",
+    description: input.description == null ? "" : String(input.description),
+    shortcut: input.shortcut == null ? "" : String(input.shortcut)
+  };
+}
+function statusContent(item) {
+  return h(
+    "span",
+    { class: "zx-select__status" },
+    statusIndicator(item),
+    h(
+      "span",
+      { class: "zx-select__status-copy" },
+      h("span", { class: "zx-select__status-label" }, String(item.name)),
+      item.description ? h("span", { class: "zx-select__status-description" }, item.description) : null
+    ),
+    item.shortcut ? h("kbd", { class: "zx-select__status-shortcut" }, item.shortcut) : null
+  );
+}
+function statusIndicator(item) {
+  const indicator = String(item.indicator ?? "ring");
+  const marker = h("span", {
+    class: "zx-select__status-indicator",
+    dataset: { indicator, tone: String(item.tone ?? "muted") },
+    ariaHidden: "true"
+  });
+  if (indicator === "done") marker.append(icon("check", { size: 8 }));
+  if (indicator === "canceled") marker.append(icon("x", { size: 7 }));
+  return marker;
+}
 function readItem(item, reader) {
   if (typeof reader === "function") return reader(item);
   if (item === null || typeof item !== "object") return item;
@@ -7165,10 +7454,11 @@ function isPrintable(event) {
 // src/components/select/field-adapter.js
 function registerSelectFieldAdapter() {
   Field.register("zxselect", (field, options) => {
-    const select = field.own(new Select(null, {
-      ...options.props ?? {},
-      value: options.value
-    }));
+    const props = options.props ?? {};
+    const preset = props.preset;
+    const selectOptions = { ...props, value: options.value };
+    delete selectOptions.preset;
+    const select = field.own(preset === "priority" ? Select.priority(null, selectOptions) : preset === "status" ? Select.status(null, selectOptions) : new Select(null, selectOptions));
     field.listen(select.el, "change", (event) => event.stopImmediatePropagation());
     select.on("change", (event) => field.emit("change", { value: event.detail.value }));
     return {
@@ -9074,6 +9364,82 @@ function onBreakpoint(handler, options = {}) {
   };
 }
 
+// src/core/format.js
+var MIN_DIGITS = 0;
+var MAX_DIGITS = 20;
+var DEFAULT_MAX_DIGITS = 3;
+var numberFormatters = /* @__PURE__ */ new Map();
+function formatNumber(value, options = {}) {
+  const number = toFiniteNumber(value);
+  if (number === null) return "";
+  const { locale = getLanguage(), decimals, minDecimals, maxDecimals, group = true } = options;
+  return format(locale, digitOptions({ decimals, minDecimals, maxDecimals, group }), number);
+}
+function formatCurrency(value, currency, options = {}) {
+  const number = toFiniteNumber(value);
+  if (number === null) return "";
+  const { locale = getLanguage(), decimals } = options;
+  const code = currencyCode(currency);
+  if (code === null) return formatNumber(number, { locale, decimals });
+  const digits = digitOptions({ decimals, group: true });
+  return format(locale, { ...digits, style: "currency", currency: code }, number);
+}
+function formatPercent2(value, options = {}) {
+  const number = toFiniteNumber(value);
+  if (number === null) return "";
+  const { locale = getLanguage(), decimals = 0 } = options;
+  return format(locale, { ...digitOptions({ decimals, group: true }), style: "percent" }, number);
+}
+function format(locale, options, value) {
+  const key = `${locale}\0${JSON.stringify(options)}`;
+  let formatter = numberFormatters.get(key);
+  if (formatter === void 0) {
+    formatter = createNumberFormat(locale, options);
+    numberFormatters.set(key, formatter);
+  }
+  return formatter.format(value);
+}
+function createNumberFormat(locale, options) {
+  try {
+    return new Intl.NumberFormat(locale, options);
+  } catch {
+    try {
+      return new Intl.NumberFormat(void 0, options);
+    } catch {
+      return new Intl.NumberFormat();
+    }
+  }
+}
+function digitOptions({ decimals, minDecimals, maxDecimals, group = true }) {
+  const result = { useGrouping: group !== false };
+  const min = digitCount(minDecimals ?? decimals);
+  const max = digitCount(maxDecimals ?? decimals);
+  if (min !== null) result.minimumFractionDigits = min;
+  if (max !== null) {
+    result.maximumFractionDigits = max;
+    if (min !== null && min > max) result.minimumFractionDigits = max;
+  } else if (min !== null) {
+    result.maximumFractionDigits = Math.max(min, DEFAULT_MAX_DIGITS);
+  }
+  return result;
+}
+function digitCount(value) {
+  if (value == null) return null;
+  const number = Number(value);
+  if (!Number.isFinite(number)) return null;
+  return Math.min(MAX_DIGITS, Math.max(MIN_DIGITS, Math.round(number)));
+}
+function toFiniteNumber(value) {
+  if (value === null || value === void 0 || value === "") return null;
+  const number = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(number) ? number : null;
+}
+function currencyCode(value) {
+  if (typeof value !== "string") return null;
+  const code = value.trim().toUpperCase();
+  return /^[A-Z]{3}$/.test(code) ? code : null;
+}
+
 // src/components/table/sort.js
 function compareStrings(left, right) {
   return String(left).localeCompare(String(right));
@@ -9129,7 +9495,8 @@ var Table = class extends Component {
     emptyText: null,
     rowClass: null,
     zebra: true,
-    editMode: false
+    editMode: false,
+    hierarchy: false
   };
   /**
    * Creates a table around a target or creates a new root when target is null.
@@ -9141,12 +9508,14 @@ var Table = class extends Component {
   }
   /** @returns {HTMLElement} Table root. */
   render() {
+    const created = this.el === null;
     const root = (
       /** @type {HTMLElement} */
       this.el ?? h("div")
     );
     this.el = root;
-    this._originalChildren = this.el ? Array.from(this.el.childNodes) : null;
+    this._createdRoot = created;
+    this._original = created ? null : snapshotTarget(root);
     this._columns = Array.isArray(this.options.columns) ? this.options.columns.map((column) => ({ ...column })) : [];
     this._data = Array.isArray(this.options.data) ? [...this.options.data] : [];
     this._selected = /* @__PURE__ */ new Set();
@@ -9166,8 +9535,17 @@ var Table = class extends Component {
     this._rovingKey = null;
     this._rovingCell = null;
     this._rovingMatched = false;
+    this._hierarchy = normalizeHierarchy(this.options.hierarchy, this._columns);
+    this._expanded = initialExpanded(this._hierarchy?.expanded);
     if (this._sort && this.options.sortMode === "local") this._sortData();
+    if (this._hierarchy?.expanded === true) {
+      for (const id of hierarchyBranchIds(this._data, this.options.rowId, this._hierarchy.parentId)) {
+        this._expanded.add(id);
+      }
+    }
+    this._reconcileExpanded();
     this._table = h("table", { class: "zx-table__table" });
+    if (this._hierarchy) this._table.setAttribute("role", "treegrid");
     this._colgroup = h("colgroup", { class: "zx-table__columns" });
     this._thead = h("thead", { class: "zx-table__head" });
     this._tbody = h("tbody", { class: "zx-table__body" });
@@ -9212,8 +9590,8 @@ var Table = class extends Component {
   }
   /**
    * Toggles a loading state. While loading, the body is dimmed, an indeterminate progress bar is
-   * shown, and `aria-busy` is set — a lightweight take on the busy/skeleton pattern used by
-   * enterprise tables (SAP UI5, Salesforce SLDS). Call `setLoading(false)` (or `setData`) when done.
+   * shown, and `aria-busy` is set — a lightweight enterprise-table busy and skeleton pattern.
+   * Call `setLoading(false)` (or `setData`) when done.
    * @param {boolean} [loading=true] Whether the table is loading.
    * @returns {this}
    */
@@ -9236,6 +9614,7 @@ var Table = class extends Component {
     assertRows(rows);
     this._data = [...rows];
     if (this._sort && this.options.sortMode === "local") this._sortData();
+    this._reconcileExpanded();
     const selectionChanged = this._pruneSelection();
     this._renderBody();
     if (selectionChanged) this._emitSelectionChange();
@@ -9253,6 +9632,7 @@ var Table = class extends Component {
     assertRows(rows);
     this._data.push(...rows);
     if (this._sort && this.options.sortMode === "local") this._sortData();
+    this._reconcileExpanded();
     this._renderBody();
     this._emitDataChange();
     return this;
@@ -9272,6 +9652,7 @@ var Table = class extends Component {
     this._data[index] = row;
     if (wasSelected) this._selected.add(this._idFor(row));
     if (this._sort && this.options.sortMode === "local") this._sortData();
+    this._reconcileExpanded();
     this._renderBody();
     if (wasSelected && !Object.is(id, this._idFor(row))) this._emitSelectionChange();
     this._emitDataChange();
@@ -9289,6 +9670,7 @@ var Table = class extends Component {
     const index = this._data.findIndex((candidate) => Object.is(this._idFor(candidate), id));
     if (index < 0) return this;
     this._data.splice(index, 1);
+    this._reconcileExpanded();
     const selectionChanged = this._selected.delete(id);
     if (Object.is(this._selectionAnchorId, id)) this._selectionAnchorId = null;
     this._renderBody();
@@ -9304,7 +9686,10 @@ var Table = class extends Component {
   getRow(id) {
     return this._data.find((row) => Object.is(this._idFor(row), id)) ?? null;
   }
-  /** @returns {TableRow[]} Shallow copy of current rows in display order. */
+  /**
+   * Returns a shallow copy of the current rows in display order.
+   * @returns {TableRow[]} Current table rows.
+   */
   getData() {
     return [...this._data];
   }
@@ -9318,6 +9703,7 @@ var Table = class extends Component {
   empty() {
     const selectionChanged = this._selected.size > 0;
     this._data = [];
+    this._expanded.clear();
     this._selected.clear();
     this._selectionAnchorId = null;
     this._renderBody();
@@ -9352,7 +9738,10 @@ var Table = class extends Component {
     if (!options.silent) this.emit("sort", { id, dir: direction });
     return this;
   }
-  /** @returns {TableRow[]} Selected rows in current display order. */
+  /**
+   * Returns selected rows in current display order.
+   * @returns {TableRow[]} Selected rows.
+   */
   getSelection() {
     return this._data.filter((row) => this._selected.has(this._idFor(row)));
   }
@@ -9391,6 +9780,75 @@ var Table = class extends Component {
     this._emitSelectionChange();
     return this;
   }
+  /**
+   * Toggles one hierarchy branch. A leaf or an id absent from the table is a no-op.
+   * @param {unknown} id Row id.
+   * @param {{silent?: boolean}} [options={}] Event behavior.
+   * @returns {this}
+   * @fires Table#rowtoggle
+   */
+  toggleRow(id, options = {}) {
+    return this._expanded.has(id) ? this.collapseRow(id, options) : this.expandRow(id, options);
+  }
+  /**
+   * Expands one hierarchy branch.
+   * @param {unknown} id Row id.
+   * @param {{silent?: boolean}} [options={}] Event behavior.
+   * @returns {this}
+   * @fires Table#rowtoggle
+   */
+  expandRow(id, options = {}) {
+    return this._setRowExpanded(id, true, options);
+  }
+  /**
+   * Collapses one hierarchy branch without discarding its descendants or their expansion state.
+   * @param {unknown} id Row id.
+   * @param {{silent?: boolean}} [options={}] Event behavior.
+   * @returns {this}
+   * @fires Table#rowtoggle
+   */
+  collapseRow(id, options = {}) {
+    return this._setRowExpanded(id, false, options);
+  }
+  /**
+   * Expands every row that currently has children.
+   * @param {{silent?: boolean}} [options={}] Event behavior. When not silent, one `rowtoggle`
+   * event is emitted per branch whose state changed.
+   * @returns {this}
+   */
+  expandAll(options = {}) {
+    if (!this._hierarchy) return this;
+    const branchIds = hierarchyBranchIds(this._data, this.options.rowId, this._hierarchy.parentId);
+    const changed = branchIds.filter((id) => !this._expanded.has(id));
+    for (const id of changed) this._expanded.add(id);
+    if (changed.length) this._renderBody();
+    if (!options.silent) {
+      for (const id of changed) this._emitRowToggle(id, true);
+    }
+    return this;
+  }
+  /**
+   * Collapses every hierarchy branch.
+   * @param {{silent?: boolean}} [options={}] Event behavior.
+   * @returns {this}
+   */
+  collapseAll(options = {}) {
+    if (!this._hierarchy || this._expanded.size === 0) return this;
+    const changed = [...this._expanded];
+    this._expanded.clear();
+    this._renderBody();
+    if (!options.silent) {
+      for (const id of changed) this._emitRowToggle(id, false);
+    }
+    return this;
+  }
+  /**
+   * Returns expanded branch ids in current flat-data order.
+   * @returns {unknown[]} Expanded branch ids.
+   */
+  getExpanded() {
+    return this._data.map((row) => this._idFor(row)).filter((id) => this._expanded.has(id));
+  }
   /**
    * Opens the editor for a cell. No-op unless the table runs with `editMode` and the column
    * resolves to an editable type for that row. In `'row'` mode every editable cell of the row is
@@ -9498,11 +9956,17 @@ var Table = class extends Component {
     this._abortEdit({ focus: true });
     return this;
   }
-  /** @returns {boolean} Whether a cell or row is currently open for editing. */
+  /**
+   * Reports whether a cell or row is currently open for editing.
+   * @returns {boolean} Whether an edit is open.
+   */
   isEditing() {
     return this._edit !== null;
   }
-  /** @returns {{id: unknown, columnId: string}|null} Row id and focused column id, or null. */
+  /**
+   * Returns the row id and focused column id for the open edit.
+   * @returns {{id: unknown, columnId: string}|null} Editing location, or null.
+   */
   getEditing() {
     return this._edit ? { id: this._edit.id, columnId: this._edit.columnId } : null;
   }
@@ -9511,7 +9975,31 @@ var Table = class extends Component {
    * @returns {TableRow[]}
    */
   _visibleData() {
-    return this._rendered === Infinity ? this._data : this._data.slice(0, this._rendered);
+    return this._visibleEntries().map((entry) => entry.row);
+  }
+  /** @returns {TableHierarchyEntry[]} Rows visible after hierarchy expansion, before growing. */
+  _projectedData() {
+    if (!this._hierarchy) {
+      return this._data.map((row, index) => ({
+        row,
+        id: this._idFor(row),
+        index,
+        depth: 0,
+        hasChildren: false,
+        parentId: null
+      }));
+    }
+    return projectHierarchyRows(
+      this._data,
+      this.options.rowId,
+      this._hierarchy.parentId,
+      this._expanded
+    );
+  }
+  /** @returns {TableHierarchyEntry[]} Rows that currently have DOM entries. */
+  _visibleEntries() {
+    const projected = this._projectedData();
+    return this._rendered === Infinity ? projected : projected.slice(0, this._rendered);
   }
   /**
    * Renders the next batch of rows.
@@ -9523,10 +10011,11 @@ var Table = class extends Component {
     if (!this._growStep) return this;
     const step = Number(count) > 0 ? Math.trunc(Number(count)) : this._growStep;
     const before = this._rendered;
-    this._rendered = Math.min(this._data.length, this._rendered + step);
+    const total = this._projectedData().length;
+    this._rendered = Math.min(total, this._rendered + step);
     if (this._rendered === before) return this;
     this._renderBody();
-    this.emit("grow", { rendered: this._rendered, total: this._data.length });
+    this.emit("grow", { rendered: this._rendered, total });
     return this;
   }
   /**
@@ -9535,14 +10024,14 @@ var Table = class extends Component {
    * @fires Table#grow
    */
   showAll() {
-    return this.growBy(this._data.length);
+    return this.growBy(this._projectedData().length);
   }
   /**
    * How many rows are currently rendered.
    * @returns {number}
    */
   getRenderedCount() {
-    return Math.min(this._rendered, this._data.length);
+    return Math.min(this._rendered, this._projectedData().length);
   }
   /**
    * Keeps the "show more" control in step with what is rendered.
@@ -9554,7 +10043,7 @@ var Table = class extends Component {
    */
   _syncGrowing() {
     if (!this._growStep) return;
-    const remaining = this._data.length - this.getRenderedCount();
+    const remaining = this._projectedData().length - this.getRenderedCount();
     if (remaining <= 0) {
       this._more?.remove();
       this._more = null;
@@ -9625,10 +10114,11 @@ var Table = class extends Component {
    * @returns {void}
    */
   _applyStackedRoles(stacked) {
-    const parts = [[this._table, "table"], [this._thead, "rowgroup"], [this._tbody, "rowgroup"]];
+    const parts = [[this._table, this._hierarchy ? "treegrid" : "table"], [this._thead, "rowgroup"], [this._tbody, "rowgroup"]];
     for (const [element, role] of parts) {
       if (!element) continue;
       if (stacked) element.setAttribute("role", role);
+      else if (element === this._table && this._hierarchy) element.setAttribute("role", "treegrid");
       else element.removeAttribute("role");
     }
     for (const [selector, role] of [["tr", "row"], ["td", "cell"], ["th", "columnheader"]]) {
@@ -9650,18 +10140,17 @@ var Table = class extends Component {
     this._teardownEdit();
     this._width?.destroy();
     this._width = null;
-    if (this.el) delete this.el.dataset.editMode;
-    if (!this._restored && this._originalChildren) {
-      this.el.replaceChildren(...this._originalChildren);
+    if (!this._restored && !this._createdRoot) {
+      restoreTarget(this.el, this._original);
       this._restored = true;
     }
     super.destroy();
   }
   /** @returns {void} */
   _renderColumns() {
-    const fragment = document.createDocumentFragment();
+    const fragment2 = document.createDocumentFragment();
     if (this.options.selectable === "multi") {
-      fragment.append(h("col", { class: "zx-table__selection-column" }));
+      fragment2.append(h("col", { class: "zx-table__selection-column" }));
     }
     const fractions = this._columns.map((column) => parseFraction(column.width));
     const total = fractions.reduce((sum, value) => sum + value, 0);
@@ -9670,9 +10159,9 @@ var Table = class extends Component {
       const col = h("col");
       if (fractions[index] > 0) col.style.width = `${fractions[index] / total * 100}%`;
       else if (column.width && column.width !== "auto") col.style.width = String(column.width);
-      fragment.append(col);
+      fragment2.append(col);
     });
-    this._colgroup.replaceChildren(fragment);
+    this._colgroup.replaceChildren(fragment2);
   }
   /** @returns {void} */
   _renderHeader() {
@@ -9705,7 +10194,8 @@ var Table = class extends Component {
     this._headers = /* @__PURE__ */ new Map();
     for (const column of this._columns) {
       const th = h("th", { scope: "col" });
-      if (column.align) th.dataset.align = column.align;
+      const align = column.align ?? (isNumericColumn(column) ? "end" : null);
+      if (align) th.dataset.align = align;
       if (column.headerTitle) th.title = column.headerTitle;
       if (column.sortable) {
         const button = h("button", {
@@ -9729,13 +10219,15 @@ var Table = class extends Component {
   /** @returns {void} @fires Table#editcancel */
   _renderBody() {
     this._abortEdit({ focus: false });
-    const fragment = document.createDocumentFragment();
+    const fragment2 = document.createDocumentFragment();
     this._rowMeta = /* @__PURE__ */ new WeakMap();
     this._rowElements = /* @__PURE__ */ new Map();
     this._rovingCell = null;
     this._rovingMatched = false;
+    const projected = this._projectedData();
+    this._hierarchyMeta = new Map(projected.map((entry) => [entry.id, entry]));
     if (this._data.length === 0) {
-      fragment.append(h(
+      fragment2.append(h(
         "tr",
         { class: "zx-table__empty-row" },
         h("td", {
@@ -9744,10 +10236,12 @@ var Table = class extends Component {
         }, this._emptyContent())
       ));
     } else {
-      this._visibleData().forEach((row, index) => fragment.append(this._createRow(row, index)));
+      this._visibleEntries().forEach((entry, visibleIndex) => {
+        fragment2.append(this._createRow(entry.row, entry.index, { ...entry, visibleIndex }));
+      });
     }
-    this._tbody.replaceChildren(fragment);
-    if (this._growStep) this._table.setAttribute("aria-rowcount", String(this._data.length + 1));
+    this._tbody.replaceChildren(fragment2);
+    if (this._growStep) this._table.setAttribute("aria-rowcount", String(projected.length + 1));
     this._syncSelectAll();
     this._syncGrowing();
     if (this._stacked) this._applyStackedRoles(true);
@@ -9766,18 +10260,27 @@ var Table = class extends Component {
     if (empty == null) return this.msg("table.empty");
     return typeof empty === "function" ? empty() : empty;
   }
-  /** @param {TableRow} row @param {number} index @returns {HTMLTableRowElement} */
-  _createRow(row, index) {
+  /**
+   * @param {TableRow} row
+   * @param {number} index
+   * @param {TableHierarchyEntry & {visibleIndex: number}} tree
+   * @returns {HTMLTableRowElement}
+   */
+  _createRow(row, index, tree) {
     const id = this._idFor(row);
     const tr = (
       /** @type {HTMLTableRowElement} */
       h("tr", { dataset: { row: "" } })
     );
-    if (this._growStep) tr.setAttribute("aria-rowindex", String(index + 2));
+    if (this._growStep) tr.setAttribute("aria-rowindex", String(tree.visibleIndex + 2));
     const rowClass = typeof this.options.rowClass === "function" ? this.options.rowClass(row) : "";
     if (rowClass) tr.classList.add(...String(rowClass).split(/\s+/).filter(Boolean));
     if (this.options.selectable !== false) tr.setAttribute("aria-selected", String(this._selected.has(id)));
-    this._rowMeta.set(tr, { row, id, index });
+    if (this._hierarchy) {
+      tr.setAttribute("aria-level", String(tree.depth + 1));
+      if (tree.hasChildren) tr.setAttribute("aria-expanded", String(this._expanded.has(id)));
+    }
+    this._rowMeta.set(tr, { row, id, index, visibleIndex: tree.visibleIndex });
     const elements = this._rowElements.get(id) ?? [];
     elements.push(tr);
     this._rowElements.set(id, elements);
@@ -9795,7 +10298,8 @@ var Table = class extends Component {
         /** @type {HTMLTableCellElement} */
         h("td")
       );
-      if (column.align) cell.dataset.align = column.align;
+      const align = column.align ?? (isNumericColumn(column) ? "end" : null);
+      if (align) cell.dataset.align = align;
       cell.dataset.label = column.label;
       if (column.popin === false) cell.dataset.popin = "false";
       if (this._editMode !== false) {
@@ -9806,7 +10310,7 @@ var Table = class extends Component {
           this._offerRovingCell(cell, id, column.id);
         }
       }
-      this._renderCellContent(cell, column, row, index);
+      this._renderCellContent(cell, column, row, index, tree);
       tr.append(cell);
     });
     return tr;
@@ -9817,13 +10321,33 @@ var Table = class extends Component {
    * @param {TableColumn} column Column definition.
    * @param {TableRow} row Row data.
    * @param {number} index Row index.
+   * @param {TableHierarchyEntry} [tree] Hierarchy metadata for the row.
    * @returns {void}
    */
-  _renderCellContent(cell, column, row, index) {
-    const value = typeof column.render === "function" ? column.render(row, index) : row?.[column.id];
-    if (value && typeof value === "object" && typeof value.nodeType === "number") cell.replaceChildren(value);
-    else if (value != null) cell.replaceChildren(document.createTextNode(String(value)));
-    else cell.replaceChildren();
+  _renderCellContent(cell, column, row, index, tree = this._hierarchyMeta?.get(this._idFor(row))) {
+    const value = formatTableCell(column, row, index);
+    const content = h("span", { class: "zx-table__cell-content" });
+    if (value && typeof value === "object" && typeof value.nodeType === "number") content.append(value);
+    else if (value != null) content.append(document.createTextNode(String(value)));
+    if (!this._hierarchy || column.id !== this._hierarchy.column || !tree) {
+      cell.replaceChildren(...content.childNodes);
+      return;
+    }
+    const branch = h("span", { class: "zx-table__tree-cell" });
+    branch.style.setProperty("--zx-table-depth", String(tree.depth));
+    if (tree.hasChildren) {
+      const expanded = this._expanded.has(tree.id);
+      branch.append(h("button", {
+        class: "zx-table__tree-toggle",
+        type: "button",
+        ariaExpanded: String(expanded),
+        ariaLabel: `${expanded ? "Collapse" : "Expand"} row ${index + 1}`
+      }, icon(expanded ? "chevron-down" : "chevron-right", { size: 14 })));
+    } else {
+      branch.append(h("span", { class: "zx-table__tree-spacer", ariaHidden: "true" }));
+    }
+    branch.append(content);
+    cell.replaceChildren(branch);
   }
   /** @param {MouseEvent} event @returns {void} */
   _handleBodyClick(event) {
@@ -9836,7 +10360,15 @@ var Table = class extends Component {
     if (!rowElement || !this._tbody.contains(rowElement)) return;
     const meta = this._rowMeta.get(rowElement);
     if (!meta) return;
-    if (this._edit) this.commitEdit();
+    if (this._edit) {
+      this.commitEdit();
+      if (this._edit) return;
+    }
+    const disclosure = target.closest(".zx-table__tree-toggle");
+    if (disclosure) {
+      this.toggleRow(meta.id);
+      return;
+    }
     const checkbox = target.closest(".zx-table__row-checkbox");
     if (checkbox && this.options.selectable === "multi") {
       this._toggleMultiSelection(
@@ -9932,7 +10464,15 @@ var Table = class extends Component {
       return entry;
     }
     if (type === "number") {
-      const field = new NumberField(null, { ...props, value: value ?? null });
+      const locale = resolveColumnOption(column.locale, row);
+      const decimals = resolveColumnDecimals(column, row);
+      const suffix = column.type === "currency" ? resolveColumnOption(column.currency, row) : column.type === "unit" ? resolveColumnOption(column.unit, row) : null;
+      const inferred = {
+        ...locale != null && !Object.prototype.hasOwnProperty.call(props, "locale") ? { locale } : {},
+        ...decimals != null && !Object.prototype.hasOwnProperty.call(props, "precision") ? { precision: decimals } : {},
+        ...suffix != null && !Object.prototype.hasOwnProperty.call(props, "unit") ? { unit: String(suffix) } : {}
+      };
+      const field = new NumberField(null, { ...inferred, ...props, value: value ?? null });
       host.append(field.el);
       entry.component = field;
       entry.control = field.getInput();
@@ -10163,9 +10703,12 @@ var Table = class extends Component {
   _nextEditableCell(rowIndex, columnId, direction) {
     const columnCount = this._columns.length;
     if (rowIndex < 0 || columnCount === 0) return null;
-    let row = rowIndex;
+    const visible = this._visibleData();
+    const startingId = this._idFor(this._data[rowIndex]);
+    let row = visible.findIndex((candidate) => Object.is(this._idFor(candidate), startingId));
+    if (row < 0) return null;
     let column = this._columns.findIndex((candidate) => candidate.id === columnId);
-    const limit = this._data.length * columnCount + columnCount;
+    const limit = visible.length * columnCount + columnCount;
     for (let step = 0; step < limit; step += 1) {
       column += direction;
       if (column >= columnCount) {
@@ -10175,11 +10718,15 @@ var Table = class extends Component {
         row -= 1;
         column = columnCount - 1;
       }
-      if (row < 0 || row >= this._data.length) return null;
-      const candidateRow = this._data[row];
+      if (row < 0 || row >= visible.length) return null;
+      const candidateRow = visible[row];
       const candidateColumn = this._columns[column];
       if (resolveEditable(candidateColumn, candidateRow) !== false) {
-        return { id: this._idFor(candidateRow), columnId: candidateColumn.id, index: row };
+        return {
+          id: this._idFor(candidateRow),
+          columnId: candidateColumn.id,
+          index: this._data.indexOf(candidateRow)
+        };
       }
     }
     return null;
@@ -10246,14 +10793,16 @@ var Table = class extends Component {
     const message = this.msg(key);
     return message === key ? fallback : message;
   }
-  /** @param {{row: TableRow, id: unknown, index: number}} meta @param {boolean} checked @param {boolean} shiftKey @returns {void} */
+  /** @param {{row: TableRow, id: unknown, index: number, visibleIndex?: number}} meta @param {boolean} checked @param {boolean} shiftKey @returns {void} */
   _toggleMultiSelection(meta, checked, shiftKey) {
-    const anchorIndex = this._data.findIndex((row) => Object.is(this._idFor(row), this._selectionAnchorId));
+    const visible = this._visibleData();
+    const anchorIndex = visible.findIndex((row) => Object.is(this._idFor(row), this._selectionAnchorId));
     if (shiftKey && anchorIndex >= 0) {
-      const start = Math.min(anchorIndex, meta.index);
-      const end = Math.max(anchorIndex, meta.index);
+      const currentIndex = meta.visibleIndex ?? visible.findIndex((row) => Object.is(this._idFor(row), meta.id));
+      const start = Math.min(anchorIndex, currentIndex);
+      const end = Math.max(anchorIndex, currentIndex);
       for (let index = start; index <= end; index += 1) {
-        const id = this._idFor(this._data[index]);
+        const id = this._idFor(visible[index]);
         if (checked) this._selected.add(id);
         else this._selected.delete(id);
       }
@@ -10304,7 +10853,34 @@ var Table = class extends Component {
     const column = this._columns.find((candidate) => candidate.id === this._sort.id);
     if (!column) return;
     const getValue = typeof column.sortValue === "function" ? column.sortValue : (row) => row?.[column.id];
-    this._data = sortRows(this._data, getValue, this._sort.dir);
+    this._data = this._hierarchy ? sortHierarchyRows(this._data, this.options.rowId, this._hierarchy.parentId, getValue, this._sort.dir) : sortRows(this._data, getValue, this._sort.dir);
+  }
+  /** @param {unknown} id @param {boolean} expanded @param {{silent?: boolean}} options @returns {this} */
+  _setRowExpanded(id, expanded, options) {
+    if (!this._hierarchy) return this;
+    const branchIds = hierarchyBranchIds(this._data, this.options.rowId, this._hierarchy.parentId);
+    if (!branchIds.some((candidate) => Object.is(candidate, id))) return this;
+    if (this._expanded.has(id) === expanded) return this;
+    if (expanded) this._expanded.add(id);
+    else this._expanded.delete(id);
+    this._renderBody();
+    if (!options.silent) this._emitRowToggle(id, expanded);
+    return this;
+  }
+  /** @param {unknown} id @param {boolean} expanded @returns {void} */
+  _emitRowToggle(id, expanded) {
+    const row = this.getRow(id);
+    if (row) this.emit("rowtoggle", { row, id, expanded });
+  }
+  /** Keeps the reader's current expansion state limited to branches still present in the data. */
+  _reconcileExpanded() {
+    if (!this._hierarchy) {
+      this._expanded.clear();
+      return;
+    }
+    const branches = hierarchyBranchIds(this._data, this.options.rowId, this._hierarchy.parentId);
+    const valid = new Set(branches);
+    for (const id of this._expanded) if (!valid.has(id)) this._expanded.delete(id);
   }
   /** @returns {boolean} Whether selection changed. */
   _pruneSelection() {
@@ -10328,6 +10904,65 @@ var Table = class extends Component {
     this.emit("datachange", { rows: this.getData() });
   }
 };
+function formatTableCell(column, row, index = 0) {
+  if (typeof column?.render === "function") return column.render(row, index);
+  const value = row?.[column?.id];
+  const type = column?.type ?? "text";
+  if (type === "text") return value;
+  const locale = resolveColumnOption(column.locale, row);
+  const decimals = resolveColumnDecimals(column, row);
+  const options = {
+    ...locale != null ? { locale: String(locale) } : {},
+    ...decimals != null ? { decimals } : {}
+  };
+  if (type === "number") return formatNumber(value, options);
+  if (type === "currency") {
+    const currency = resolveColumnOption(column.currency, row);
+    return formatCurrency(value, currency == null ? null : String(currency), options);
+  }
+  if (type === "percent") return formatPercent2(value, options);
+  if (type === "unit") {
+    const number = formatNumber(value, options);
+    const unit = resolveColumnOption(column.unit, row);
+    return number && unit != null && String(unit) !== "" ? `${number}\xA0${unit}` : number;
+  }
+  return value;
+}
+function projectHierarchyRows(rows, rowId, parentId, expanded = []) {
+  const forest = hierarchyForest(rows, rowId, parentId);
+  const open = expanded instanceof Set ? expanded : new Set(expanded);
+  const result = [];
+  const stack = forest.roots.slice().reverse().map((node) => ({ node, depth: 0 }));
+  while (stack.length) {
+    const { node, depth } = stack.pop();
+    result.push({
+      row: node.row,
+      id: node.id,
+      index: node.index,
+      depth,
+      hasChildren: node.children.length > 0,
+      parentId: node.parent?.id ?? null
+    });
+    if (!open.has(node.id)) continue;
+    for (let index = node.children.length - 1; index >= 0; index -= 1) {
+      stack.push({ node: node.children[index], depth: depth + 1 });
+    }
+  }
+  return result;
+}
+function sortHierarchyRows(rows, rowId, parentId, getValue, direction) {
+  const forest = hierarchyForest(rows, rowId, parentId);
+  const sorted = (nodes) => sortRows(nodes, (node) => getValue(node.row), direction);
+  const result = [];
+  const stack = sorted(forest.roots).reverse();
+  while (stack.length) {
+    const node = stack.pop();
+    result.push(node.row);
+    const children = sorted(node.children);
+    for (let index = children.length - 1; index >= 0; index -= 1) stack.push(children[index]);
+  }
+  return result;
+}
 function resolveEditable(column, row) {
   if (!column || typeof column !== "object") return false;
   if (typeof column.editor === "function") {
@@ -10335,7 +10970,7 @@ function resolveEditable(column, row) {
     return "custom";
   }
   const declared = typeof column.editable === "function" ? column.editable(row) : column.editable;
-  if (declared === true) return "text";
+  if (declared === true) return isNumericColumn(column) ? "number" : "text";
   if (typeof declared === "string" && EDITOR_TYPES.has(declared)) return (
     /** @type {TableEditorType} */
     declared
@@ -10384,6 +11019,71 @@ function firstValidationError(values, columns, row, fallbackMessage = "Invalid v
   }
   return null;
 }
+function resolveColumnOption(option, row) {
+  return typeof option === "function" ? option(row) : option;
+}
+function resolveColumnDecimals(column, row) {
+  const value = resolveColumnOption(column?.decimals, row);
+  if (value == null) return null;
+  const number = Number(value);
+  return Number.isFinite(number) ? Math.max(0, Math.trunc(number)) : null;
+}
+function isNumericColumn(column) {
+  return ["number", "currency", "percent", "unit"].includes(column?.type);
+}
+function hierarchyForest(rows, rowId, parentId) {
+  const nodes = (Array.isArray(rows) ? rows : []).map((row, index) => ({
+    row,
+    id: readRowValue(rowId, row),
+    index,
+    parent: null,
+    children: []
+  }));
+  const byId = /* @__PURE__ */ new Map();
+  for (const node of nodes) if (!byId.has(node.id)) byId.set(node.id, node);
+  const parentOf = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const parent = byId.get(readRowValue(parentId, node.row)) ?? null;
+    parentOf.set(node, parent === node ? null : parent);
+  }
+  for (const node of nodes) {
+    const seen = /* @__PURE__ */ new Set([node]);
+    let cursor = parentOf.get(node) ?? null;
+    while (cursor) {
+      if (seen.has(cursor)) {
+        parentOf.set(cursor, null);
+        break;
+      }
+      seen.add(cursor);
+      cursor = parentOf.get(cursor) ?? null;
+    }
+  }
+  const roots = [];
+  for (const node of nodes) {
+    node.parent = parentOf.get(node) ?? null;
+    if (node.parent) node.parent.children.push(node);
+    else roots.push(node);
+  }
+  return { roots, nodes };
+}
+function hierarchyBranchIds(rows, rowId, parentId) {
+  return hierarchyForest(rows, rowId, parentId).nodes.filter((node) => node.children.length > 0).map((node) => node.id);
+}
+function readRowValue(accessor, row) {
+  return typeof accessor === "function" ? accessor(row) : row?.[accessor];
+}
+function normalizeHierarchy(option, columns) {
+  if (!option || typeof option !== "object") return null;
+  const parentId = option.parentId;
+  if (typeof parentId !== "string" && typeof parentId !== "function") return null;
+  const requested = typeof option.column === "string" ? option.column : null;
+  const column = columns.some((candidate) => candidate.id === requested) ? requested : columns[0]?.id;
+  if (!column) return null;
+  return { ...option, parentId, column };
+}
+function initialExpanded(option) {
+  return new Set(Array.isArray(option) ? option : []);
+}
 function normalizeEditMode(mode) {
   if (mode === "cell" || mode === "row") return mode;
   return mode === true ? "cell" : false;
@@ -10425,6 +11125,630 @@ function growStep(growing) {
   return Number.isFinite(step) && step > 0 ? step : null;
 }
 
+// src/components/launcher/launcher.js
+var Launcher = class extends Component {
+  static cssName = "launcher";
+  /** @type {Readonly<LauncherOptions>} */
+  static defaults = {
+    items: [],
+    sources: [],
+    query: "",
+    debounce: 250,
+    minQuery: 0,
+    maxResults: 100,
+    placeholder: "Search applications and records",
+    label: "Launcher",
+    closeLabel: "Close launcher",
+    resultsLabel: "Launcher results",
+    emptyText: "No results",
+    loadingText: "Searching\u2026",
+    shortcut: "mod+k",
+    hints: { move: "Move", open: "Open", close: "Close" }
+  };
+  /**
+   * Creates an owned launcher dialog or enhances an existing `<dialog>` target.
+   * @param {HTMLDialogElement|string|null} [target=null] Dialog target, selector, or null.
+   * @param {LauncherOptions} [options={}] Launcher options.
+   */
+  constructor(target = null, options = {}) {
+    super(target, options);
+  }
+  /** @returns {HTMLDialogElement} */
+  render() {
+    if (this.el !== null && !(this.el instanceof HTMLDialogElement)) {
+      throw new TypeError("Launcher target must be a <dialog> element");
+    }
+    this._createdRoot = this.el === null;
+    const dialog = (
+      /** @type {HTMLDialogElement} */
+      this.el ?? h("dialog")
+    );
+    this.el = dialog;
+    this._original = this._createdRoot ? null : {
+      attributes: Array.from(dialog.attributes, (attribute) => [attribute.name, attribute.value]),
+      children: Array.from(dialog.childNodes)
+    };
+    this._items = normalizeItems(this.options.items);
+    this._sources = normalizeSources(this.options.sources);
+    this._sourceItems = /* @__PURE__ */ new Map();
+    this._query = String(this.options.query ?? "");
+    this._renderedQuery = null;
+    this._results = [];
+    this._active = -1;
+    this._request = null;
+    this._requestSequence = 0;
+    this._queryTimer = null;
+    this._busy = false;
+    this._destroyed = false;
+    const listId = uid("zx-launcher-results");
+    const input = h("input", {
+      ref: "input",
+      class: "zx-launcher__input",
+      type: "search",
+      role: "combobox",
+      autocomplete: "off",
+      spellcheck: false,
+      ariaAutocomplete: "list",
+      ariaControls: listId,
+      ariaExpanded: "false",
+      ariaLabel: this.options.label,
+      placeholder: this.options.placeholder,
+      value: this._query
+    });
+    const close = h("button", {
+      ref: "close",
+      class: "zx-icon-btn zx-launcher__close",
+      type: "button",
+      ariaLabel: this.options.closeLabel
+    }, icon("x"));
+    const status = h("div", {
+      ref: "status",
+      class: "zx-launcher__status",
+      role: "status",
+      ariaLive: "polite"
+    });
+    const results = h("div", {
+      ref: "results",
+      class: "zx-launcher__results",
+      id: listId,
+      role: "listbox",
+      ariaLabel: this.options.resultsLabel
+    });
+    const shortcut = this.options.shortcut === "mod+k" ? h("kbd", {
+      class: "zx-launcher__shortcut",
+      ariaHidden: "true"
+    }, launcherShortcutLabel()) : null;
+    const footer = launcherHints(this.options.hints);
+    dialog.setAttribute("aria-label", String(this.options.label));
+    dialog.replaceChildren(
+      h(
+        "div",
+        { class: "zx-launcher__surface" },
+        h("div", {
+          class: "zx-launcher__search",
+          dataset: { shortcut: shortcut ? "true" : "false" }
+        }, icon("search"), input, shortcut, close),
+        status,
+        results,
+        footer
+      )
+    );
+    dialog.dataset.state = "closed";
+    if (this._createdRoot) document.body.append(dialog);
+    this.listen(input, "input", () => {
+      this._query = /** @type {HTMLInputElement} */
+      input.value;
+      this.emit("query", { query: this._query.trim() });
+      this._refresh();
+    });
+    this.listen(input, "keydown", (event) => this._onKeydown(
+      /** @type {KeyboardEvent} */
+      event
+    ));
+    this.listen(close, "click", () => this.close());
+    this.listen(results, "click", (event) => {
+      const option = (
+        /** @type {Element|null} */
+        event.target?.closest?.("[data-launcher-index]")
+      );
+      if (!option || !results.contains(option)) return;
+      this._activate(Number(option.getAttribute("data-launcher-index")), event);
+    });
+    this.listen(results, "pointermove", (event) => {
+      const option = (
+        /** @type {Element|null} */
+        event.target?.closest?.("[data-launcher-index]")
+      );
+      if (!option || !results.contains(option)) return;
+      const index = Number(option.getAttribute("data-launcher-index"));
+      if (!Number.isInteger(index) || this._results[index]?.disabled || index === this._active) return;
+      this._active = index;
+      this._syncActive();
+    });
+    this.listen(dialog, "cancel", (event) => {
+      event.preventDefault();
+      this.close();
+    });
+    this.listen(dialog, "close", () => {
+      dialog.dataset.state = "closed";
+      input.setAttribute("aria-expanded", "false");
+      this._abortRequest();
+      this.emit("close");
+    });
+    this.listen(document, "keydown", (event) => this._onDocumentKeydown(
+      /** @type {KeyboardEvent} */
+      event
+    ));
+    this._renderResults();
+    return dialog;
+  }
+  /** Opens the launcher and focuses/selects its query. @returns {this} @fires Launcher#open */
+  open() {
+    if (this.isOpen() || this._destroyed) return this;
+    this.el.showModal();
+    this.el.dataset.state = "open";
+    this.refs.input.setAttribute("aria-expanded", "true");
+    this._refresh();
+    queueMicrotask(() => {
+      if (!this.isOpen()) return;
+      this.refs.input.focus();
+      this.refs.input.select();
+    });
+    this.emit("open");
+    return this;
+  }
+  /** Closes the launcher. @returns {this} */
+  close() {
+    if (this.isOpen()) this.el.close();
+    return this;
+  }
+  /** Toggles the launcher. @returns {this} */
+  toggle() {
+    return this.isOpen() ? this.close() : this.open();
+  }
+  /** Reports whether the launcher is open. @returns {boolean} */
+  isOpen() {
+    return Boolean(this.el.open);
+  }
+  /** Focuses and selects the query field. @returns {this} */
+  focus() {
+    this.refs.input.focus();
+    this.refs.input.select();
+    return this;
+  }
+  /** Replaces the query and refreshes local and remote results. @param {string} query @returns {this} */
+  setQuery(query) {
+    this._query = String(query ?? "");
+    this.refs.input.value = this._query;
+    this.emit("query", { query: this._query.trim() });
+    this._refresh();
+    return this;
+  }
+  /** Returns the untrimmed query. @returns {string} */
+  getQuery() {
+    return this._query;
+  }
+  /** Replaces local catalogue items. @param {LauncherItem[]} items @returns {this} */
+  setItems(items) {
+    this._items = normalizeItems(items);
+    this._renderResults();
+    return this;
+  }
+  /** Marks one local item as the current destination. @param {string|number|null} id Item id. @returns {this} */
+  setCurrent(id) {
+    const key = id == null ? null : String(id);
+    this._items = this._items.map((item) => ({ ...item, current: key !== null && String(item.id) === key }));
+    this._renderResults();
+    return this;
+  }
+  /** Replaces asynchronous sources and aborts work from the old set. @param {LauncherSource[]} sources @returns {this} */
+  setSources(sources) {
+    this._abortRequest();
+    this._sources = normalizeSources(sources);
+    this._sourceItems.clear();
+    this._refresh();
+    return this;
+  }
+  /** Aborts sources and removes the owned dialog. @returns {void} */
+  destroy() {
+    if (this._destroyed) return;
+    this._destroyed = true;
+    const original = this._original;
+    this._abortRequest();
+    if (this.isOpen()) this.el.close();
+    super.destroy();
+    if (!this._createdRoot && original) {
+      for (const attribute of Array.from(this.el.attributes)) this.el.removeAttribute(attribute.name);
+      for (const [name, value] of original.attributes) this.el.setAttribute(name, value);
+      this.el.replaceChildren(...original.children);
+    }
+  }
+  /** @returns {void} */
+  _refresh() {
+    this._sourceItems.clear();
+    this._renderResults();
+    this._abortRequest();
+    if (this._sources.length === 0) return;
+    const delay = Math.max(0, Number(this.options.debounce) || 0);
+    this._queryTimer = setTimeout(() => this._loadSources(), delay);
+  }
+  /** @returns {Promise<void>} */
+  async _loadSources() {
+    this._queryTimer = null;
+    const query = this._query.trim();
+    const sources = this._sources.filter((source) => visibleForQuery(source.when, query) && query.length >= Math.max(Number(this.options.minQuery) || 0, Number(source.minQuery) || 0));
+    if (sources.length === 0) return;
+    const request = new AbortController();
+    const sequence = ++this._requestSequence;
+    this._request = request;
+    this._setBusy(true);
+    await Promise.all(sources.map(async (source) => {
+      try {
+        const loaded = await source.load(query, { signal: request.signal });
+        if (request.signal.aborted || sequence !== this._requestSequence) return;
+        this._sourceItems.set(source.id, normalizeItems(loaded).map((item, itemOrder) => ({
+          ...item,
+          _source: source.id,
+          _sourceOrder: source.order === "source",
+          group: item.group ?? source.label ?? "",
+          itemOrder: item.itemOrder ?? (source.order === "source" ? itemOrder : void 0)
+        })));
+        this._renderResults();
+      } catch (error) {
+        if (request.signal.aborted || sequence !== this._requestSequence) return;
+        this.emit("error", { source, error });
+      }
+    }));
+    if (request.signal.aborted || sequence !== this._requestSequence) return;
+    this._request = null;
+    this._setBusy(false);
+  }
+  /** @param {boolean} busy @returns {void} */
+  _setBusy(busy) {
+    this._busy = busy;
+    this.el.setAttribute("aria-busy", String(busy));
+    this._renderStatus();
+  }
+  /** @returns {void} */
+  _abortRequest() {
+    if (this._queryTimer !== null) clearTimeout(this._queryTimer);
+    this._queryTimer = null;
+    this._request?.abort();
+    this._request = null;
+    this._requestSequence += 1;
+    if (this._busy) this._setBusy(false);
+  }
+  /** @returns {void} */
+  _renderResults() {
+    const queryKey = this._query;
+    const activeId = this._renderedQuery === queryKey && this._active >= 0 && this._results[this._active] ? String(this._results[this._active].id) : null;
+    const query = this._query.trim();
+    const local = this._items.filter((item) => visibleForQuery(item.when, query));
+    const rankedLocal = rankLauncherItems(local, query, this.options.maxResults);
+    const remote = this._sources.flatMap((source) => {
+      const loaded = this._sourceItems.get(String(source.id)) ?? [];
+      return source.order === "source" ? loaded.filter((item) => visibleForQuery(item.when, query)) : rankLauncherItems(
+        loaded.filter((item) => visibleForQuery(item.when, query)),
+        query,
+        this.options.maxResults
+      );
+    });
+    const seen = /* @__PURE__ */ new Set();
+    const combined = [...rankedLocal.map((item) => ({ ...item, _source: null })), ...remote].filter((item) => {
+      const key = String(item.id);
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    }).slice(0, Math.max(0, Number(this.options.maxResults) || 0));
+    const groups = /* @__PURE__ */ new Map();
+    for (const item of combined) {
+      const group = String(item.group ?? "");
+      if (!groups.has(group)) groups.set(group, []);
+      groups.get(group).push(item);
+    }
+    this._results = [...groups.values()].flat();
+    this._renderedQuery = queryKey;
+    const preserved = activeId === null ? -1 : this._results.findIndex((item) => !item.disabled && String(item.id) === activeId);
+    this._active = preserved >= 0 ? preserved : this._results.findIndex((item) => !item.disabled);
+    const nodes = [];
+    let index = 0;
+    for (const [group, items] of groups) {
+      const options = items.map((item) => this._option(item, index++));
+      if (group) nodes.push(h("div", {
+        class: "zx-launcher__group",
+        role: "group",
+        ariaLabel: group,
+        dataset: { layout: items.every((item) => item.kind === "application") ? "grid" : "list" }
+      }, h("div", { class: "zx-launcher__group-label", ariaHidden: "true" }, group), options));
+      else nodes.push(...options);
+    }
+    this.refs.results.replaceChildren(...nodes);
+    this._syncActive();
+    this._renderStatus();
+  }
+  /** @param {RankedLauncherItem} item @param {number} index @returns {HTMLElement} */
+  _option(item, index) {
+    const href = safeHref(item.href);
+    const tag = href ? "a" : "button";
+    const children = [];
+    const visual = launcherItemIcon(item);
+    if (visual) children.push(h("span", {
+      class: "zx-launcher__icon",
+      ariaHidden: "true"
+    }, visual));
+    children.push(h(
+      "span",
+      { class: "zx-launcher__copy" },
+      h("span", { class: "zx-launcher__label" }, item.label),
+      item.description ? h("span", { class: "zx-launcher__description" }, item.description) : null
+    ));
+    if (item.badge != null) children.push(h("span", { class: "zx-launcher__badge" }, String(item.badge)));
+    return (
+      /** @type {HTMLElement} */
+      h(tag, {
+        class: "zx-launcher__option",
+        type: tag === "button" ? "button" : null,
+        href,
+        target: item.target ?? null,
+        rel: tag === "a" ? "noopener" : null,
+        role: "option",
+        id: uid("zx-launcher-option"),
+        tabIndex: -1,
+        ariaSelected: "false",
+        ariaDisabled: item.disabled ? "true" : null,
+        ariaCurrent: item.current ? "page" : null,
+        dataset: {
+          launcherIndex: index,
+          pinned: item.pinned !== void 0 && item.pinned !== false ? "true" : null,
+          kind: normalizeLauncherKind(item.kind)
+        }
+      }, children)
+    );
+  }
+  /** @returns {void} */
+  _renderStatus() {
+    if (this._busy) this.refs.status.textContent = String(this.options.loadingText);
+    else if (this._results.length === 0) this.refs.status.textContent = String(this.options.emptyText);
+    else this.refs.status.textContent = "";
+    this.refs.status.hidden = !this.refs.status.textContent;
+  }
+  /** @returns {void} */
+  _syncActive() {
+    const options = [...this.refs.results.querySelectorAll("[data-launcher-index]")];
+    for (const option of options) {
+      const selected = Number(option.getAttribute("data-launcher-index")) === this._active;
+      option.setAttribute("aria-selected", String(selected));
+    }
+    const active = options.find((option) => Number(option.getAttribute("data-launcher-index")) === this._active);
+    if (active) this.refs.input.setAttribute("aria-activedescendant", active.id);
+    else this.refs.input.removeAttribute("aria-activedescendant");
+  }
+  /** @param {KeyboardEvent} event @returns {void} */
+  _onKeydown(event) {
+    if (event.key === "Escape") {
+      this.close();
+      return;
+    }
+    if (event.key === "Enter") {
+      if (this._active < 0) return;
+      event.preventDefault();
+      const option = this.refs.results.querySelector(`[data-launcher-index="${this._active}"]`);
+      option?.click();
+      return;
+    }
+    const enabled = this._results.map((item, index) => item.disabled ? -1 : index).filter((index) => index >= 0);
+    if (enabled.length === 0) return;
+    if (/^Arrow(?:Left|Right|Up|Down)$/.test(event.key)) {
+      const next = this._spatialIndex(event.key, enabled);
+      if (next !== null) {
+        event.preventDefault();
+        this._active = next;
+        this._syncActive();
+        this.refs.results.querySelector(`[data-launcher-index="${this._active}"]`)?.scrollIntoView({ block: "nearest", inline: "nearest" });
+        return;
+      }
+      if (event.key === "ArrowLeft" || event.key === "ArrowRight") return;
+    }
+    let position2 = enabled.indexOf(this._active);
+    if (event.key === "Home" || event.key === "PageUp") position2 = 0;
+    else if (event.key === "End" || event.key === "PageDown") position2 = enabled.length - 1;
+    else if (event.key === "ArrowDown") position2 = (position2 + 1 + enabled.length) % enabled.length;
+    else if (event.key === "ArrowUp") position2 = (position2 - 1 + enabled.length) % enabled.length;
+    else return;
+    event.preventDefault();
+    this._active = enabled[position2];
+    this._syncActive();
+    this.refs.results.querySelector(`[data-launcher-index="${this._active}"]`)?.scrollIntoView({ block: "nearest" });
+  }
+  /** @param {string} direction @param {number[]} enabled @returns {number|null} */
+  _spatialIndex(direction, enabled) {
+    const current = this.refs.results.querySelector(`[data-launcher-index="${this._active}"]`);
+    if (!(current instanceof HTMLElement)) return null;
+    if ((direction === "ArrowLeft" || direction === "ArrowRight") && this._results[this._active]?.kind !== "application") return null;
+    const candidates = [...this.refs.results.querySelectorAll("[data-launcher-index]")].filter((option) => enabled.includes(Number(option.getAttribute("data-launcher-index"))) && (direction !== "ArrowLeft" && direction !== "ArrowRight" || option.getAttribute("data-kind") === "application"));
+    const next = findSpatialLauncherOption(candidates, current, direction);
+    return next ? Number(next.getAttribute("data-launcher-index")) : null;
+  }
+  /** @param {number} index @param {Event} event @returns {void} */
+  _activate(index, event) {
+    const item = this._results[index];
+    if (!item || item.disabled) {
+      event.preventDefault();
+      return;
+    }
+    const selected = this.emit("select", {
+      item,
+      value: item.value ?? item.id,
+      source: item._source ?? null,
+      query: this._query.trim()
+    });
+    if (selected.defaultPrevented) {
+      event.preventDefault();
+      return;
+    }
+    if (!item.href) {
+      event.preventDefault();
+      item.invoke?.();
+    }
+    this.close();
+  }
+  /** @param {KeyboardEvent} event @returns {void} */
+  _onDocumentKeydown(event) {
+    if (this.options.shortcut !== "mod+k" || event.isComposing || event.key.toLowerCase() !== "k" || Number(event.metaKey) + Number(event.ctrlKey) !== 1 || event.altKey || event.shiftKey) return;
+    const active = document.activeElement;
+    if (active instanceof HTMLInputElement || active instanceof HTMLTextAreaElement || active instanceof HTMLSelectElement || active instanceof HTMLElement && active.isContentEditable) return;
+    const modal = document.querySelector("dialog:modal");
+    if (modal && modal !== this.el) return;
+    event.preventDefault();
+    this.open();
+  }
+};
+function launcherShortcutLabel() {
+  const platform = String(
+    /** @type {any} */
+    navigator.userAgentData?.platform ?? navigator.platform ?? ""
+  );
+  return /mac|iphone|ipad/i.test(platform) ? "\u2318 K" : "Ctrl K";
+}
+function launcherHints(hints) {
+  if (hints === false) return null;
+  const labels = hints && typeof hints === "object" ? hints : {};
+  return h(
+    "footer",
+    { class: "zx-launcher__hints", ariaHidden: "true" },
+    h("span", {}, h("kbd", {}, "\u2191\u2193\u2190\u2192"), labels.move ?? "Move"),
+    h("span", {}, h("kbd", {}, "\u21B5"), labels.open ?? "Open"),
+    h("span", {}, h("kbd", {}, "Esc"), labels.close ?? "Close")
+  );
+}
+function launcherItemIcon(item) {
+  let visual = item.icon;
+  if (typeof visual === "function") visual = visual(item);
+  if (typeof visual === "string") return icon(visual);
+  if (visual instanceof Node) return visual.cloneNode(true);
+  if (visual && typeof visual === "object" && typeof /** @type {any} */
+  visual.toElement === "function") {
+    const element = (
+      /** @type {any} */
+      visual.toElement()
+    );
+    return element instanceof Node ? element.cloneNode(true) : null;
+  }
+  return null;
+}
+function normalizeLauncherKind(kind) {
+  return kind === "application" || kind === "record" ? kind : "action";
+}
+function visibleForQuery(when, query) {
+  if (when === "empty") return query === "";
+  if (when === "query") return query !== "";
+  return true;
+}
+function findSpatialLauncherOption(options, current, direction) {
+  const origin = current.getBoundingClientRect();
+  if (origin.width === 0 && origin.height === 0) return null;
+  const originX = origin.left + origin.width / 2;
+  const originY = origin.top + origin.height / 2;
+  let best = null;
+  let bestScore = Infinity;
+  for (const option of options) {
+    if (option === current) continue;
+    const rect = option.getBoundingClientRect();
+    const dx = rect.left + rect.width / 2 - originX;
+    const dy = rect.top + rect.height / 2 - originY;
+    let valid = false;
+    let score = Infinity;
+    if (direction === "ArrowLeft") {
+      valid = dx < -2 && Math.abs(dy) < Math.max(origin.height, rect.height) / 2;
+      score = Math.abs(dx) + Math.abs(dy) * 4;
+    } else if (direction === "ArrowRight") {
+      valid = dx > 2 && Math.abs(dy) < Math.max(origin.height, rect.height) / 2;
+      score = Math.abs(dx) + Math.abs(dy) * 4;
+    } else if (direction === "ArrowUp") {
+      valid = dy < -2;
+      score = Math.abs(dy) * 10 + Math.abs(dx);
+    } else if (direction === "ArrowDown") {
+      valid = dy > 2;
+      score = Math.abs(dy) * 10 + Math.abs(dx);
+    }
+    if (valid && score < bestScore) {
+      best = option;
+      bestScore = score;
+    }
+  }
+  return best;
+}
+function rankLauncherItems(items, query, limit = 100) {
+  const needle = searchable(query).trim();
+  const ranked = items.map((item, order) => ({ item, order, score: launcherScore(item, needle) })).filter(({ score }) => score < Infinity);
+  ranked.sort((a, b) => {
+    const aGroup = finiteOrder(a.item.groupOrder);
+    const bGroup = finiteOrder(b.item.groupOrder);
+    if (aGroup !== bGroup) return aGroup - bGroup;
+    if (needle === "") {
+      const aPinned = pinOrder(a.item.pinned, a.order);
+      const bPinned = pinOrder(b.item.pinned, b.order);
+      if (aPinned !== bPinned) return aPinned - bPinned;
+    }
+    return a.score - b.score || finiteOrder(a.item.itemOrder) - finiteOrder(b.item.itemOrder) || compareLauncherText(a.item.label, b.item.label) || a.order - b.order;
+  });
+  const maximum = Math.max(0, Number(limit) || 0);
+  return ranked.slice(0, maximum || 0).map(({ item, score }) => ({ ...item, _score: score }));
+}
+function launcherScore(item, needle) {
+  if (!needle) return item.pinned ? -1 : 0;
+  const label = searchable(item.label);
+  const identifier = searchable(item.id);
+  const keywords = searchable(Array.isArray(item.keywords) ? item.keywords.join(" ") : item.keywords ?? "");
+  if (label === needle) return 0;
+  if (label.startsWith(needle)) return 10;
+  if (label.split(/[^\p{L}\p{N}]+/u).some((word) => word.startsWith(needle))) return 20;
+  if (label.includes(needle) || keywords.includes(needle)) return 30;
+  if (identifier.includes(needle)) return 40;
+  const acronym = label.split(/[^\p{L}\p{N}]+/u).filter(Boolean).map((word) => word[0]).join("");
+  if (acronym.startsWith(needle)) return 50;
+  return Infinity;
+}
+function pinOrder(pinned, order) {
+  if (typeof pinned === "number" && Number.isFinite(pinned)) return pinned;
+  if (pinned) return order;
+  return Number.MAX_SAFE_INTEGER;
+}
+function finiteOrder(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : Number.MAX_SAFE_INTEGER;
+}
+function searchable(value) {
+  return String(value ?? "").normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase();
+}
+function compareLauncherText(left, right) {
+  const a = searchable(left);
+  const b = searchable(right);
+  if (a < b) return -1;
+  if (a > b) return 1;
+  const rawA = String(left ?? "").normalize("NFC");
+  const rawB = String(right ?? "").normalize("NFC");
+  return rawA < rawB ? -1 : rawA > rawB ? 1 : 0;
+}
+function normalizeItems(items) {
+  if (!Array.isArray(items)) return [];
+  return items.filter((item) => item && typeof item === "object" && item.id != null && item.label != null).map((item) => normalizeLauncherItem(item));
+}
+function normalizeLauncherItem(item) {
+  const normalized = { ...item, label: String(item.label) };
+  if (item.href == null) return normalized;
+  const href = safeHref(item.href);
+  if (href !== null) normalized.href = href;
+  else {
+    delete normalized.href;
+    if (typeof normalized.invoke !== "function") normalized.disabled = true;
+  }
+  return normalized;
+}
+function normalizeSources(sources) {
+  if (!Array.isArray(sources)) return [];
+  return sources.filter((source) => source && typeof source === "object" && source.id != null && typeof source.load === "function").map((source) => ({ ...source, id: String(source.id) }));
+}
+
 // src/components/message/message.js
 var MessageQueue = class {
   #limit;
@@ -11534,6 +12858,7 @@ var zeyosModules = Object.freeze({
   weblets: { label: "Weblets", icon: "zeyos-weblets", color: "#4f46e5", fa: "window-restore" }
 });
 var moduleAliases = Object.freeze({
+  main: "zeyos",
   addresses: "contacts",
   clocking: "actionsteps",
   comments: "notes",
@@ -11640,15 +12965,23 @@ function moduleIcon(name, options = {}) {
   return icon(standard ? `fa:${info.fa}` : `kit:${info.icon}`, rest);
 }
 function moduleChip(name, options = {}) {
-  const { size = 24, iconSize = "1em", label = null, title = false, standard = false } = options;
+  const {
+    size = 24,
+    iconSize = "1em",
+    label = null,
+    title = false,
+    standard = false,
+    color = null
+  } = options;
   const key = normalizeModuleName(name);
   const info = moduleInfo(name);
+  const background = color || info.color;
   const chip = h("span", {
     class: ["zx-module-icon", options.class].flat().filter(Boolean),
     dataset: { module: key },
     style: {
-      "--zx-module-color": info.color,
-      "--zx-module-glyph": moduleGlyphColor(info.color),
+      "--zx-module-color": background,
+      "--zx-module-glyph": moduleGlyphColor(background),
       "--zx-module-icon-size": typeof size === "number" ? `${size}px` : String(size)
     },
     title: title ? info.label : null
@@ -11662,6 +12995,307 @@ function moduleChip(name, options = {}) {
   return chip;
 }
 
+// src/zeyos/launcher.js
+var ZEYOS_LAUNCHER_APPLICATIONS = Object.freeze([
+  "accounts",
+  "actionsteps",
+  "admin",
+  "auth",
+  "billing",
+  "calendar",
+  "campaigns",
+  "collection",
+  "contacts",
+  "contracts",
+  "control",
+  "coupons",
+  "dev",
+  "documents",
+  "inventory",
+  "mailinglists",
+  "main",
+  "messages",
+  "links",
+  "notes",
+  "objects",
+  "opportunities",
+  "payments",
+  "pricelists",
+  "procurement",
+  "production",
+  "projects",
+  "tasks",
+  "tickets"
+]);
+function buildZeyosLauncherConfig(state = {}, options = {}) {
+  const {
+    standardIcons = false,
+    items: extraItems = [],
+    sources: extraSources = [],
+    ...launcherOptions
+  } = options;
+  const labels = launcherLabels(state.labels);
+  const iconOptions = {
+    standardIcons,
+    renderApplicationIcon: state.renderApplicationIcon,
+    renderWebletIcon: state.renderWebletIcon
+  };
+  const applications = normalizeZeyosLauncherApplications(state, iconOptions);
+  const recent = typeof state.loadRecent === "function" ? [] : normalizeZeyosLauncherRecords(state.recent ?? [], {
+    query: "",
+    labels,
+    resolveRecord: state.resolveRecord,
+    renderRecordIcon: state.renderRecordIcon,
+    standardIcons
+  });
+  const sources = [];
+  if (typeof state.loadRecent === "function") {
+    sources.push({
+      id: "zeyos-recent",
+      minQuery: 0,
+      when: "empty",
+      order: "source",
+      load: async (_query, context) => normalizeZeyosLauncherRecords(
+        await state.loadRecent(context),
+        {
+          query: "",
+          labels,
+          resolveRecord: state.resolveRecord,
+          renderRecordIcon: state.renderRecordIcon,
+          standardIcons
+        }
+      )
+    });
+  }
+  if (typeof state.search === "function") {
+    sources.push({
+      id: "zeyos-records",
+      minQuery: 1,
+      when: "query",
+      order: "source",
+      load: async (query, context) => normalizeZeyosLauncherRecords(
+        await state.search(query, context),
+        {
+          query,
+          labels,
+          resolveRecord: state.resolveRecord,
+          renderRecordIcon: state.renderRecordIcon,
+          standardIcons
+        }
+      )
+    });
+  }
+  sources.push(...extraSources);
+  return {
+    ...launcherOptions,
+    items: [...applications, ...recent, ...extraItems],
+    sources,
+    hints: options.hints ?? {
+      move: labels.move,
+      open: labels.open,
+      close: labels.close
+    }
+  };
+}
+function zeyosLauncher(state = {}, options = {}) {
+  return new Launcher(null, buildZeyosLauncherConfig(state, options));
+}
+function normalizeZeyosLauncherApplications(state = {}, options = {}) {
+  const labels = launcherLabels(state.labels);
+  const pinned = Array.isArray(state.pinned) ? state.pinned.map(String) : [];
+  const seen = /* @__PURE__ */ new Set();
+  const items = [];
+  const add = (raw2, fallbackId = null, fallbackLabel = null) => {
+    const app = normalizeApplication(raw2, fallbackId, fallbackLabel);
+    if (!app || seen.has(app.identifier)) return;
+    if (app.type === "module" && typeof state.canUseModule === "function" && !state.canUseModule(app.module)) return;
+    seen.add(app.identifier);
+    const resolved = mergeDestination(app.raw, state.resolveApplication);
+    const pin = pinned.indexOf(app.identifier);
+    const icon2 = () => {
+      const custom = typeof options.renderApplicationIcon === "function" ? options.renderApplicationIcon(app.raw, app) : app.type === "weblet" && typeof options.renderWebletIcon === "function" ? options.renderWebletIcon(app.raw, app) : null;
+      return custom ?? moduleChip(app.module, {
+        size: 36,
+        standard: Boolean(options.standardIcons),
+        color: app.color
+      });
+    };
+    items.push({
+      id: app.identifier,
+      label: app.label,
+      keywords: [app.identifier, app.module],
+      group: labels.applications,
+      groupOrder: 0,
+      kind: "application",
+      icon: icon2,
+      pinned: pin >= 0 ? pin : void 0,
+      current: app.identifier === state.activeIdentifier,
+      disabled: !resolved.href && typeof resolved.invoke !== "function",
+      ...resolved,
+      _zeyos: app
+    });
+  };
+  for (const raw2 of Array.isArray(state.menuApps) ? state.menuApps : []) add(raw2);
+  if (Array.isArray(state.modules)) {
+    for (const module of state.modules) {
+      if (typeof module === "string") add([module, moduleInfo(module).label]);
+      else add(module, module?.id ?? module?.module, module?.label);
+    }
+  } else {
+    for (const [module, label] of Object.entries(state.modules ?? {})) add([module, label]);
+  }
+  return items;
+}
+function normalizeZeyosLauncherRecords(payload, options = {}) {
+  const query = String(options.query ?? "");
+  const labels = launcherLabels(options.labels);
+  const records = flattenRecords(payload, query);
+  const groupOrders = /* @__PURE__ */ new Map();
+  return records.flatMap(({ raw: raw2, group }, itemOrder) => {
+    const record = normalizeRecord(raw2, group, query);
+    if (!record) return [];
+    const groupName = query === "" ? labels.recent : record.group === "" ? labels.results : labels.entities[record.group] ?? record.group;
+    if (!groupOrders.has(groupName)) groupOrders.set(groupName, groupOrders.size + 1);
+    const resolved = mergeDestination(record.raw, options.resolveRecord);
+    return [{
+      id: `record:${record.entity}:${record.fork ?? ""}:${record.ID}`,
+      label: record.name,
+      description: record.sec,
+      keywords: [record.entity, record.ID, record.fork ?? ""],
+      group: groupName,
+      groupOrder: groupOrders.get(groupName),
+      itemOrder,
+      kind: "record",
+      when: query === "" ? "empty" : "query",
+      icon: () => {
+        const custom = typeof options.renderRecordIcon === "function" ? options.renderRecordIcon(record.raw, record) : null;
+        return custom ?? moduleChip(record.entity, {
+          size: 28,
+          standard: Boolean(options.standardIcons)
+        });
+      },
+      disabled: !resolved.href && typeof resolved.invoke !== "function",
+      ...resolved,
+      _zeyos: record
+    }];
+  });
+}
+function zeyosActiveIdentifier(state = {}) {
+  if (state.weblet != null && state.weblet !== "") return `weblet#${state.weblet}`;
+  if (state.fork != null && state.fork !== "") return `fork#${state.fork}`;
+  return String(state.module ?? "");
+}
+function normalizeApplication(raw2, fallbackId, fallbackLabel) {
+  if (Array.isArray(raw2)) {
+    if (raw2.length < 2) return null;
+    if (raw2.length === 2) {
+      const module = String(raw2[0]);
+      return { raw: raw2, identifier: module, label: String(raw2[1]), module, type: "module", color: null };
+    }
+    if (raw2.length === 4) {
+      const module = String(raw2[2] || "default");
+      return {
+        raw: raw2,
+        identifier: `fork#${raw2[0]}`,
+        label: String(raw2[1]),
+        module,
+        type: "fork",
+        color: normalizeServerColor(raw2[3])
+      };
+    }
+    return {
+      raw: raw2,
+      identifier: `weblet#${raw2[0]}`,
+      label: String(raw2[1]),
+      module: "weblets",
+      type: "weblet",
+      color: normalizeServerColor(raw2[8])
+    };
+  }
+  if (!raw2 || typeof raw2 !== "object") return null;
+  const identifier = String(raw2.identifier ?? raw2.id ?? fallbackId ?? "");
+  if (!identifier) return null;
+  const type = identifier.startsWith("fork#") ? "fork" : identifier.startsWith("weblet#") ? "weblet" : "module";
+  return {
+    raw: raw2,
+    identifier,
+    label: String(raw2.label ?? fallbackLabel ?? moduleInfo(identifier).label),
+    module: String(raw2.module ?? (type === "module" ? identifier : type === "fork" ? "default" : "weblets")),
+    type,
+    color: normalizeServerColor(raw2.color)
+  };
+}
+function flattenRecords(payload, query) {
+  if (Array.isArray(payload)) return payload.map((raw2) => ({ raw: raw2, group: raw2?.group ?? "" }));
+  if (!payload || typeof payload !== "object") return [];
+  const result = [];
+  for (const [group, rows] of Object.entries(payload)) {
+    if (!Array.isArray(rows)) continue;
+    for (const row of rows) {
+      if (!Array.isArray(row)) {
+        result.push({ raw: row, group });
+        continue;
+      }
+      const raw2 = group === "" && row.length >= 5 ? { ID: row[0], fork: row[1], name: row[2], sec: row[3], entity: row[4], group } : { ID: row[0], fork: row[1], name: row[2], sec: row[3], entity: group, group };
+      result.push({ raw: raw2, group });
+    }
+  }
+  return result;
+}
+function normalizeRecord(raw2, group, query) {
+  if (Array.isArray(raw2)) {
+    if (query === "" && raw2.length >= 4) {
+      return {
+        raw: raw2,
+        entity: String(raw2[0]),
+        ID: raw2[1],
+        fork: raw2[2] ?? null,
+        name: String(raw2[3]),
+        sec: String(raw2[4] ?? ""),
+        group: ""
+      };
+    }
+    return null;
+  }
+  if (!raw2 || typeof raw2 !== "object" || raw2.ID == null || raw2.name == null) return null;
+  return {
+    raw: raw2,
+    entity: String(raw2.entity ?? group ?? "records"),
+    ID: raw2.ID,
+    fork: raw2.fork ?? null,
+    name: String(raw2.name),
+    sec: String(raw2.sec ?? ""),
+    group: String(raw2.group ?? group ?? "")
+  };
+}
+function mergeDestination(raw2, resolver) {
+  const direct = raw2 && typeof raw2 === "object" && !Array.isArray(raw2) ? raw2 : {};
+  const resolved = typeof resolver === "function" ? resolver(raw2) : null;
+  const destination = resolved && typeof resolved === "object" ? resolved : {};
+  return Object.fromEntries(["href", "target", "invoke", "value"].flatMap((key) => {
+    const value = destination[key] ?? direct[key];
+    return value === void 0 ? [] : [[key, value]];
+  }));
+}
+function normalizeServerColor(value) {
+  const source = String(value ?? "").trim();
+  if (!source) return null;
+  const color = source.startsWith("#") ? source : `#${source}`;
+  return /^#[\da-f]{3}(?:[\da-f]{3})?$/i.test(color) ? color : null;
+}
+function launcherLabels(input) {
+  const labels = input && typeof input === "object" ? input : {};
+  return {
+    applications: String(labels.applications ?? "Applications"),
+    recent: String(labels.recent ?? "Recent"),
+    results: String(labels.results ?? "Top results"),
+    entities: labels.entities && typeof labels.entities === "object" ? labels.entities : {},
+    move: String(labels.move ?? "Move"),
+    open: String(labels.open ?? "Open"),
+    close: String(labels.close ?? "Close")
+  };
+}
+
 // src/zeyos/select.js
 function buildZeyosSelectConfig(client, resource, opts = {}) {
   const {
@@ -11703,6 +13337,90 @@ function zeyosSelect(client, resource, opts = {}) {
   select.ready = hydrateInitialValue(select, client, resource, requestedValue);
   return select;
 }
+function buildZeyosEntitySelectConfig(client, resource, opts = {}) {
+  const {
+    fields,
+    labelKey = inferLabelKey(client, resource),
+    valueKey = "ID",
+    searchFields = inferSearchFields(client, resource),
+    subtitleKey = null,
+    moduleKey = () => resource,
+    groupKey = null,
+    none = true,
+    create = false,
+    renderIcon = defaultEntityIcon,
+    renderItem,
+    renderValueAdornment,
+    ...rest
+  } = opts;
+  const projection = fields ?? defaultProjection(valueKey, labelKey, [
+    ...searchFields,
+    ...[subtitleKey, moduleKey, groupKey].filter((reader) => typeof reader === "string")
+  ]);
+  const base = buildZeyosSelectConfig(client, resource, {
+    ...rest,
+    fields: projection,
+    labelKey,
+    valueKey,
+    searchFields,
+    groupKey,
+    clearable: none === false ? Boolean(rest.clearable) : true
+  });
+  const renderModuleIcon = (item, selected = false) => {
+    if (renderIcon === null) return null;
+    const module = readRecord(item, moduleKey) ?? resource;
+    return renderIcon(item, { resource, module: String(module), selected });
+  };
+  base.renderItem = renderItem ?? ((item) => {
+    const visual = renderModuleIcon(item);
+    return h(
+      "span",
+      { class: "zx-select__entity" },
+      visual ? h("span", {
+        class: "zx-select__entity-icon",
+        ariaHidden: "true"
+      }, visual) : null,
+      h(
+        "span",
+        { class: "zx-select__entity-copy" },
+        h("span", { class: "zx-select__entity-label" }, String(readRecord(item, labelKey) ?? "")),
+        subtitleKey && readRecord(item, subtitleKey) != null ? h("span", { class: "zx-select__entity-subtitle" }, String(readRecord(item, subtitleKey))) : null
+      )
+    );
+  });
+  base.renderValueAdornment = renderValueAdornment ?? ((item) => renderModuleIcon(item, true));
+  if (none !== false) {
+    base.noneLabel = typeof none === "string" ? none : rest.noneLabel ?? "No selection";
+    base.renderNone = rest.renderNone ?? ((label) => h(
+      "span",
+      { class: "zx-select__entity-none" },
+      h("span", { class: "zx-select__entity-none-icon", ariaHidden: "true" }),
+      h("span", {}, label)
+    ));
+  }
+  if (create) {
+    const descriptor = create === true ? {} : create;
+    const invoke = typeof descriptor.oninvoke === "function" ? descriptor.oninvoke : null;
+    base.actions = [...Array.isArray(base.actions) ? base.actions : [], {
+      id: descriptor.id ?? "create",
+      label: descriptor.label ?? "Create new\u2026",
+      group: descriptor.group ?? "New",
+      icon: descriptor.icon ?? "plus",
+      invoke: (detail) => invoke?.({ ...detail, resource })
+    }];
+  }
+  return base;
+}
+function zeyosEntitySelect(client, resource, opts = {}) {
+  const config2 = buildZeyosEntitySelectConfig(client, resource, opts);
+  const requestedValue = opts.value ?? null;
+  const select = (
+    /** @type {Select & {ready: Promise<Select>}} */
+    new Select(null, config2)
+  );
+  select.ready = hydrateInitialValue(select, client, resource, requestedValue);
+  return select;
+}
 function normalizeZeyosListResult(client, result) {
   if (typeof client?.normalizeListResult === "function") {
     return normalizeLocalListResult(client.normalizeListResult(result));
@@ -11719,12 +13437,12 @@ function normalizeLocalListResult(result) {
 async function hydrateInitialValue(select, client, resource, value) {
   if (value == null) return select;
   const record = value && typeof value === "object" ? value : await connect(client).get(resource, value);
-  const normalized = normalizeRecord(record);
+  const normalized = normalizeRecord2(record);
   select.setItems([normalized]);
   select.set(normalized, { silent: true });
   return select;
 }
-function normalizeRecord(result) {
+function normalizeRecord2(result) {
   if (result && typeof result === "object" && !Array.isArray(result)) {
     const nested = result.data;
     if (nested && typeof nested === "object" && !Array.isArray(nested)) return nested;
@@ -11732,6 +13450,16 @@ function normalizeRecord(result) {
   }
   throw new TypeError("ZeyOS get operation did not return a record");
 }
+function readRecord(item, reader) {
+  if (typeof reader === "function") return reader(item);
+  if (item && typeof item === "object" && typeof reader === "string") return item[reader];
+  return null;
+}
+function defaultEntityIcon(_item, context) {
+  const chip = moduleChip(String(context.module ?? "default"), { size: 20 });
+  chip.replaceChildren(icon("square", { size: 10 }));
+  return chip;
+}
 function defaultProjection(valueKey, labelKey, searchFields) {
   const keys = [valueKey, labelKey, ...searchFields].filter((key) => typeof key === "string" && key);
   return keys.length ? [...new Set(keys)] : void 0;
@@ -11811,7 +13539,7 @@ function zeyosForm(client, resource, opts = {}) {
     await Promise.all(config2.entityFields.map(async ({ id, resource: referencedResource2 }) => {
       const value = record[id];
       if (value == null) return;
-      const selected = value && typeof value === "object" ? value : normalizeRecord2(await facade.get(referencedResource2, value));
+      const selected = value && typeof value === "object" ? value : normalizeRecord3(await facade.get(referencedResource2, value));
       const select = Select.from(form.getField(id)?.getInput());
       if (select instanceof Select) select.setItems([selected]);
     }));
@@ -11820,7 +13548,7 @@ function zeyosForm(client, resource, opts = {}) {
   };
   const load = async (id) => {
     if (id == null || id === "") throw new TypeError("zeyosForm.load() requires an id");
-    const record = normalizeRecord2(await facade.get(resource, id));
+    const record = normalizeRecord3(await facade.get(resource, id));
     currentId = record.ID ?? id;
     await applyRecord(record);
     return record;
@@ -11839,7 +13567,7 @@ function zeyosForm(client, resource, opts = {}) {
         throw error;
       }
       const result = currentId == null ? await facade.create(resource, payload) : await facade.update(resource, { ID: currentId, ...payload });
-      const record = normalizeRecord2(result);
+      const record = normalizeRecord3(result);
       currentId = record.ID ?? currentId;
       if (opts.onSaved) {
         try {
@@ -11917,7 +13645,7 @@ function normalizeColumns(value) {
     [1, 2, 3].includes(number) ? number : 2
   );
 }
-function normalizeRecord2(result) {
+function normalizeRecord3(result) {
   if (result && typeof result === "object" && !Array.isArray(result)) {
     const nested = result.data;
     if (nested && typeof nested === "object" && !Array.isArray(nested)) return nested;
@@ -11951,7 +13679,7 @@ function buildZeyosTableConfig(client, resource, opts = {}) {
     const monetary = isMonetaryField(meta);
     const column = fieldToZxColumn(monetary ? { ...meta, format: "money" } : meta);
     if (monetary) {
-      column.render = (row) => formatCurrency(row?.[meta.id], row?.currency);
+      column.render = (row) => formatCurrency2(row?.[meta.id], row?.currency);
       if (schemaHasField(client, resource, "currency")) projection.currency = "currency";
     }
     return column;
@@ -12076,10 +13804,10 @@ function inferLabelKey2(client, resource) {
   return names[0] ?? "ID";
 }
 function isMonetaryField(meta) {
-  const format = String(meta.format ?? "").toLowerCase();
-  return /money|currency|price/.test(format) || /(?:amount|price)$/.test(String(meta.id).toLowerCase());
+  const format2 = String(meta.format ?? "").toLowerCase();
+  return /money|currency|price/.test(format2) || /(?:amount|price)$/.test(String(meta.id).toLowerCase());
 }
-function formatCurrency(value, currency) {
+function formatCurrency2(value, currency) {
   if (value == null || value === "") return "";
   const number = Number(value);
   if (!Number.isFinite(number)) return "";
@@ -12112,7 +13840,11 @@ function copyFilters(filters) {
 }
 export {
   ZEYOS_ICON_KIT,
+  ZEYOS_LAUNCHER_APPLICATIONS,
   buildListQuery,
+  buildZeyosEntitySelectConfig,
+  buildZeyosLauncherConfig,
+  buildZeyosSelectConfig,
   connect,
   dataFilterStateToFilters,
   dateToUnixSeconds,
@@ -12127,13 +13859,18 @@ export {
   moduleInfo,
   moduleKeys,
   normalizeModuleName,
+  normalizeZeyosLauncherApplications,
+  normalizeZeyosLauncherRecords,
   registerFieldType,
   registerModules,
   resolveFields,
   tableSortToQuery,
   unixSecondsToDate,
   useZeyosIcons,
+  zeyosActiveIdentifier,
+  zeyosEntitySelect,
   zeyosForm,
+  zeyosLauncher,
   zeyosModules,
   zeyosSelect,
   zeyosTable