@kerfjs/ui 5.0.0-beta.54 → 5.0.0-beta.56

package/dist/chunk-BFPBS5Y4.js

@@ -0,0 +1,250 @@
+// src/install-help-tag.ts
+var HELP_TAG_SHOW_DELAY = 500;
+var HELP_TAG_WARM_WINDOW = 400;
+var HELP_TAG_VIEWPORT_MARGIN = 8;
+var LIFECYCLE_EVENTS = [
+  "wa-show",
+  "wa-after-show",
+  "wa-hide",
+  "wa-after-hide"
+];
+var installed = /* @__PURE__ */ new WeakSet();
+function isFocusVisible(element) {
+  try {
+    return element.matches(":focus-visible");
+  } catch {
+    return false;
+  }
+}
+var MENU_LABEL = ':scope > [slot="trigger"] .kui-popup-menu__label';
+var isPlainControl = (host) => host.localName === "button" || host.localName === "a";
+var words = (node) => node.textContent.replace(/\s+/g, " ").trim();
+var ariaLabel = (control) => (control.getAttribute("aria-label") ?? "").replace(/\s+/g, " ").trim();
+function isToolbarIconControl(target) {
+  if (!target.matches("button, a[href]")) return false;
+  if (!ariaLabel(target) || target.hasAttribute("title") || words(target))
+    return false;
+  if (!target.closest(".kui-toolbar-control-group")) return false;
+  return !(target.id && target.ownerDocument.querySelector(
+    `wa-tooltip[for="${CSS.escape(target.id)}"]`
+  ));
+}
+function helpTagHost(path) {
+  for (const target of path) {
+    if (!(target instanceof HTMLElement)) continue;
+    if (isToolbarIconControl(target)) return target;
+    const { component, selectedPresentation } = target.dataset;
+    if (component === "select" && target.localName === "wa-select" && selectedPresentation === "icon-only")
+      return target;
+    if (component === "popup-menu" && target.querySelector(MENU_LABEL))
+      return target;
+  }
+  return null;
+}
+function anchorOf(host) {
+  if (isPlainControl(host)) return host;
+  if (host.dataset.component === "select")
+    return host.shadowRoot?.querySelector('[part~="combobox"]') ?? null;
+  return host.querySelector(':scope > [slot="trigger"]');
+}
+function helpText(host) {
+  if (isPlainControl(host)) return ariaLabel(host);
+  const label = host.querySelector(MENU_LABEL) ?? host.querySelector(':scope > [slot="label"]');
+  if (label) return words(label);
+  const name = host.getAttribute("label") ?? "";
+  const chosen = host.selectedOptions?.[0];
+  const choice = chosen ? chosen.label || words(chosen) : "";
+  return choice && choice !== name ? `${name}: ${choice}` : name;
+}
+function installHelpTags(doc = document, { focusVisible = isFocusVisible } = {}) {
+  if (installed.has(doc)) return;
+  installed.add(doc);
+  const tags = /* @__PURE__ */ new WeakMap();
+  let hovered = null;
+  let focused = null;
+  let shown = null;
+  let dismissed = null;
+  let timer;
+  let warmUntil = 0;
+  let layer = null;
+  const layerRoot = () => {
+    if (!layer) {
+      layer = doc.createElement("div");
+      layer.className = "kui-help-tag-layer";
+      layer.setAttribute("aria-hidden", "true");
+      layer.setAttribute("data-morph-skip", "");
+      Object.assign(layer.style, {
+        position: "fixed",
+        top: "0",
+        left: "0",
+        width: "0",
+        height: "0"
+      });
+    }
+    if (!layer.isConnected) doc.body.append(layer);
+    return layer;
+  };
+  const tagFor = (host) => {
+    const plain = isPlainControl(host);
+    const root = plain ? layerRoot() : host.shadowRoot;
+    if (!root) return null;
+    let tag = tags.get(host);
+    if (!tag) {
+      tag = doc.createElement("wa-tooltip");
+      tag.className = "kui-help-tag";
+      tag.setAttribute("aria-hidden", "true");
+      tag.setAttribute("trigger", "manual");
+      tag.setAttribute("placement", "bottom");
+      tag.style.pointerEvents = "none";
+      for (const type of LIFECYCLE_EVENTS)
+        tag.addEventListener(type, (event) => event.stopPropagation());
+      if (plain) {
+        const created = tag;
+        created.addEventListener("wa-after-hide", () => {
+          if (created.open) return;
+          created.remove();
+          tags.delete(host);
+        });
+      }
+      root.append(tag);
+      tags.set(host, tag);
+    }
+    return tag;
+  };
+  const hide = (host) => {
+    if (shown?.host !== host) return;
+    shown.tag.open = false;
+    shown = null;
+    warmUntil = Date.now() + HELP_TAG_WARM_WINDOW;
+  };
+  const show = (host) => {
+    window.clearTimeout(timer);
+    timer = void 0;
+    if (host.open || dismissed === host || !host.isConnected) return;
+    const anchor = anchorOf(host);
+    const text = helpText(host);
+    if (!anchor || !text) return;
+    const tag = tagFor(host);
+    if (!tag) return;
+    if (shown) hide(shown.host);
+    if (anchor === host)
+      tag.style.colorScheme = window.getComputedStyle(host).colorScheme;
+    tag.anchor = anchor;
+    tag.textContent = text;
+    tag.open = true;
+    shown = { host, tag };
+    void tag.updateComplete.then(() => {
+      if (tag.anchor !== anchor) tag.anchor = anchor;
+      const popup = tag.shadowRoot?.querySelector("wa-popup");
+      if (popup) popup.shiftPadding = HELP_TAG_VIEWPORT_MARGIN;
+    });
+  };
+  const triggerHost = (event) => {
+    const path = event.composedPath();
+    const host = helpTagHost(path);
+    if (!host) return null;
+    const anchor = anchorOf(host);
+    return anchor && path.includes(anchor) ? host : null;
+  };
+  const leave = (host) => {
+    if (hovered !== host) {
+      window.clearTimeout(timer);
+      timer = void 0;
+    }
+    if (hovered !== host && focused !== host) hide(host);
+  };
+  const release = (host) => {
+    if (dismissed && dismissed !== host && !dismissed.open) dismissed = null;
+  };
+  doc.addEventListener(
+    "pointerover",
+    (event) => {
+      if (event.pointerType === "touch") return;
+      const host = triggerHost(event);
+      release(host);
+      if (host === hovered) return;
+      const previous = hovered;
+      hovered = host;
+      if (previous) leave(previous);
+      if (!host || host.open || dismissed === host || shown?.host === host)
+        return;
+      window.clearTimeout(timer);
+      if (Date.now() < warmUntil) show(host);
+      else timer = window.setTimeout(() => show(host), HELP_TAG_SHOW_DELAY);
+    },
+    true
+  );
+  doc.addEventListener(
+    "pointerout",
+    (event) => {
+      if (event.relatedTarget !== null || !hovered) return;
+      const previous = hovered;
+      hovered = null;
+      leave(previous);
+    },
+    true
+  );
+  const dismiss = (host) => {
+    dismissed = host;
+    hide(host);
+  };
+  doc.addEventListener(
+    "pointerdown",
+    (event) => {
+      const host = helpTagHost(event.composedPath());
+      if (host) dismiss(host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "focusin",
+    (event) => {
+      const target = event.composedPath()[0];
+      const host = target instanceof Element && focusVisible(target) ? triggerHost(event) : null;
+      if (host === focused) return;
+      const previous = focused;
+      focused = host;
+      if (previous) leave(previous);
+      if (host && dismissed !== host) show(host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "focusout",
+    (event) => {
+      const host = helpTagHost(event.composedPath());
+      const next = event.relatedTarget;
+      if (!host || next instanceof Node && host.contains(next)) return;
+      if (dismissed === host) dismissed = null;
+      if (host !== focused) return;
+      focused = null;
+      leave(host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "keydown",
+    (event) => {
+      if (event.key === "Escape" && shown) dismiss(shown.host);
+    },
+    true
+  );
+  doc.addEventListener(
+    "wa-show",
+    (event) => {
+      const host = helpTagHost(event.composedPath());
+      if (host && event.composedPath()[0] === host) dismiss(host);
+    },
+    true
+  );
+  const refresh = (event) => {
+    const host = helpTagHost(event.composedPath());
+    if (shown && host === shown.host) shown.tag.textContent = helpText(host);
+  };
+  doc.addEventListener("change", refresh, true);
+  doc.addEventListener("input", refresh, true);
+}
+
+export { installHelpTags };
+
+//# sourceMappingURL=chunk-BFPBS5Y4.js.map

package/dist/chunk-BFPBS5Y4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/install-help-tag.ts"],"names":[],"mappings":"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","file":"chunk-BFPBS5Y4.js","sourcesContent":["// Hover and keyboard-focus help tags for icon-only controls.\n//\n// An icon-only `Select` (single `selectedPresentation=\"icon-only\"` or the\n// multiple `triggerIcon` filter), an icon-only `PopupMenu` (a `label` instead\n// of visible `text`), and an icon-only `<button>` or link inside a\n// `ToolbarControlGroup` (named only by `aria-label`) carry their purpose — and\n// a Select its current choice — only in the accessible name. Sighted pointer\n// and keyboard users see just the icon, so the registration boundary shows a\n// Web Awesome `wa-tooltip` naming the control (Apple HIG \"help tag\"):\n//\n// - after a short hover delay, or immediately when a previous tag just closed\n//   (moving along a toolbar), and at once on keyboard (`:focus-visible`) focus;\n// - never while the control's popup is open, and not again after a press or\n//   Escape until the pointer or focus leaves and returns;\n// - with the same text the accessible name already announces, so the tag is\n//   `aria-hidden` and never joins the control's `aria-labelledby` (a manual\n//   trigger with a programmatic anchor, not `for`, so Web Awesome does not\n//   add it) — assistive technology hears the name once.\n//\n// A Select's or PopupMenu's tag lives in the control's open shadow root, so\n// the morph never sees it, `:has([open])` selectors on the light DOM ignore\n// it, and it inherits the control's theme. A plain button cannot host a shadow\n// root, so its tag lives in one body-level layer (re-attached if a body morph\n// drops it, and removed again once hidden) and copies the button's\n// `color-scheme`; the tag's Popover-API popup renders in the top layer, so its\n// place in the document does not affect where or above what it shows. A\n// button that already has a native `title`, or a Web Awesome tooltip `for` it,\n// keeps that and gets no second tag. Each tag's own lifecycle events stop at\n// the tag so an application listening for the control's `wa-show` / `wa-hide`\n// never hears the tag's.\n\n/** Hover delay before a help tag appears. */\nexport const HELP_TAG_SHOW_DELAY = 500;\n/** After a tag closes, a neighboring trigger shows its tag at once for this long. */\nexport const HELP_TAG_WARM_WINDOW = 400;\n/** A tag shifted inward stays this far from the viewport edge. */\nexport const HELP_TAG_VIEWPORT_MARGIN = 8;\n\ninterface HelpTagHost extends HTMLElement {\n  open?: boolean;\n  selectedOptions?: readonly (HTMLElement & { label?: string })[];\n}\n\ninterface HelpTag extends HTMLElement {\n  open: boolean;\n  readonly updateComplete: Promise<unknown>;\n  anchor: Element | null;\n  trigger: string;\n  placement: string;\n}\n\nexport interface HelpTagOptions {\n  /** Whether a newly focused element shows keyboard focus. */\n  focusVisible?: (element: Element) => boolean;\n}\n\nconst LIFECYCLE_EVENTS = [\n  'wa-show',\n  'wa-after-show',\n  'wa-hide',\n  'wa-after-hide',\n] as const;\n\nconst installed = new WeakSet<Document>();\n\nfunction isFocusVisible(element: Element): boolean {\n  try {\n    return element.matches(':focus-visible');\n  } catch {\n    return false;\n  }\n}\n\nconst MENU_LABEL = ':scope > [slot=\"trigger\"] .kui-popup-menu__label';\n\n/** A plain control (not a Web Awesome popup host) gets a body-layer tag. */\nconst isPlainControl = (host: HelpTagHost): boolean =>\n  host.localName === 'button' || host.localName === 'a';\n\n/** An element's text with whitespace collapsed (an element's is never null). */\nconst words = (node: Element): string =>\n  (node.textContent as string).replace(/\\s+/g, ' ').trim();\n\n/** The trimmed `aria-label` of a plain control. */\nconst ariaLabel = (control: Element): string =>\n  (control.getAttribute('aria-label') ?? '').replace(/\\s+/g, ' ').trim();\n\n/**\n * An icon-only toolbar button or link: inside a `ToolbarControlGroup`, named\n * by `aria-label`, with no visible text, and without a native `title` or a Web\n * Awesome tooltip of its own that a second tag would duplicate.\n */\nfunction isToolbarIconControl(target: HTMLElement): boolean {\n  if (!target.matches('button, a[href]')) return false;\n  if (!ariaLabel(target) || target.hasAttribute('title') || words(target))\n    return false;\n  if (!target.closest('.kui-toolbar-control-group')) return false;\n  return !(\n    target.id &&\n    target.ownerDocument.querySelector(\n      `wa-tooltip[for=\"${CSS.escape(target.id)}\"]`,\n    )\n  );\n}\n\n/** The icon-only Kerf control on an event path, if any. */\nfunction helpTagHost(path: readonly EventTarget[]): HelpTagHost | null {\n  for (const target of path) {\n    if (!(target instanceof HTMLElement)) continue;\n    if (isToolbarIconControl(target)) return target;\n    const { component, selectedPresentation } = target.dataset;\n    if (\n      component === 'select' &&\n      target.localName === 'wa-select' &&\n      selectedPresentation === 'icon-only'\n    )\n      return target;\n    if (component === 'popup-menu' && target.querySelector(MENU_LABEL))\n      return target;\n  }\n  return null;\n}\n\n/** The visible trigger the tag describes and anchors to. */\nfunction anchorOf(host: HelpTagHost): Element | null {\n  if (isPlainControl(host)) return host;\n  if (host.dataset.component === 'select')\n    return host.shadowRoot?.querySelector('[part~=\"combobox\"]') ?? null;\n  return host.querySelector(':scope > [slot=\"trigger\"]');\n}\n\n/** The tag text: the same words as the trigger's accessible name. */\nfunction helpText(host: HelpTagHost): string {\n  if (isPlainControl(host)) return ariaLabel(host);\n  // An icon-only PopupMenu's visually hidden label, or a multiple icon\n  // trigger's label slot (it already ends with the chosen labels).\n  const label =\n    host.querySelector(MENU_LABEL) ??\n    host.querySelector(':scope > [slot=\"label\"]');\n  if (label) return words(label);\n  const name = host.getAttribute('label') ?? '';\n  const chosen = host.selectedOptions?.[0];\n  const choice = chosen ? chosen.label || words(chosen) : '';\n  return choice && choice !== name ? `${name}: ${choice}` : name;\n}\n\n/**\n * Install once at an explicit registration boundary. Idempotent per document.\n */\nexport function installHelpTags(\n  doc: Document = document,\n  { focusVisible = isFocusVisible }: HelpTagOptions = {},\n): void {\n  if (installed.has(doc)) return;\n  installed.add(doc);\n  const tags = new WeakMap<HelpTagHost, HelpTag>();\n  let hovered: HelpTagHost | null = null;\n  let focused: HelpTagHost | null = null;\n  // The trigger whose tag is open, with that tag.\n  let shown: { host: HelpTagHost; tag: HelpTag } | null = null;\n  // A press, Escape, or an opened popup suppresses that trigger's tag.\n  let dismissed: HelpTagHost | null = null;\n  let timer: number | undefined;\n  let warmUntil = 0;\n  let layer: HTMLElement | null = null;\n\n  // The body-level home of plain controls' tags. Its fixed, zero-size box\n  // keeps it out of a grid or flex body's flow; a body morph that drops it is\n  // repaired on the next show.\n  const layerRoot = (): HTMLElement => {\n    if (!layer) {\n      layer = doc.createElement('div');\n      layer.className = 'kui-help-tag-layer';\n      layer.setAttribute('aria-hidden', 'true');\n      layer.setAttribute('data-morph-skip', '');\n      Object.assign(layer.style, {\n        position: 'fixed',\n        top: '0',\n        left: '0',\n        width: '0',\n        height: '0',\n      });\n    }\n    if (!layer.isConnected) doc.body.append(layer);\n    return layer;\n  };\n\n  const tagFor = (host: HelpTagHost): HelpTag | null => {\n    const plain = isPlainControl(host);\n    const root = plain ? layerRoot() : host.shadowRoot;\n    if (!root) return null;\n    let tag = tags.get(host);\n    if (!tag) {\n      tag = doc.createElement('wa-tooltip') as HelpTag;\n      tag.className = 'kui-help-tag';\n      tag.setAttribute('aria-hidden', 'true');\n      tag.setAttribute('trigger', 'manual');\n      tag.setAttribute('placement', 'bottom');\n      tag.style.pointerEvents = 'none';\n      for (const type of LIFECYCLE_EVENTS)\n        tag.addEventListener(type, (event) => event.stopPropagation());\n      if (plain) {\n        // A hidden button tag leaves the layer, so tags for buttons that a\n        // re-render replaced never accumulate there.\n        const created = tag;\n        created.addEventListener('wa-after-hide', () => {\n          if (created.open) return;\n          created.remove();\n          tags.delete(host);\n        });\n      }\n      root.append(tag);\n      tags.set(host, tag);\n    }\n    return tag;\n  };\n\n  const hide = (host: HelpTagHost) => {\n    if (shown?.host !== host) return;\n    shown.tag.open = false;\n    shown = null;\n    warmUntil = Date.now() + HELP_TAG_WARM_WINDOW;\n  };\n\n  const show = (host: HelpTagHost) => {\n    window.clearTimeout(timer);\n    timer = undefined;\n    if (host.open || dismissed === host || !host.isConnected) return;\n    const anchor = anchorOf(host);\n    const text = helpText(host);\n    if (!anchor || !text) return;\n    const tag = tagFor(host);\n    if (!tag) return;\n    if (shown) hide(shown.host);\n    // A body-layer tag takes its button's light or dark scheme, which a\n    // subtree theme (`.wa-dark`) may set below the document root.\n    if (anchor === host)\n      tag.style.colorScheme = window.getComputedStyle(host).colorScheme;\n    tag.anchor = anchor;\n    tag.textContent = text;\n    tag.open = true;\n    shown = { host, tag };\n    // A new tag's first update resets `anchor` from its (null) `for`. Its\n    // popup also keeps the standard 8px clear of the viewport edge when it\n    // shifts a long tag inward (Web Awesome's tooltip leaves this at 0).\n    void tag.updateComplete.then(() => {\n      if (tag.anchor !== anchor) tag.anchor = anchor;\n      const popup = tag.shadowRoot?.querySelector<\n        HTMLElement & { shiftPadding: number }\n      >('wa-popup');\n      if (popup) popup.shiftPadding = HELP_TAG_VIEWPORT_MARGIN;\n    });\n  };\n\n  /** The tagged host whose trigger (not its popup) is on the path. */\n  const triggerHost = (event: Event): HelpTagHost | null => {\n    const path = event.composedPath();\n    const host = helpTagHost(path);\n    if (!host) return null;\n    const anchor = anchorOf(host);\n    return anchor && path.includes(anchor) ? host : null;\n  };\n\n  // A pending hover belongs to the hovered trigger; a tag stays while either\n  // the pointer or keyboard focus is still on its trigger.\n  const leave = (host: HelpTagHost) => {\n    if (hovered !== host) {\n      window.clearTimeout(timer);\n      timer = undefined;\n    }\n    if (hovered !== host && focused !== host) hide(host);\n  };\n\n  // A press, Escape, or an opened popup dismisses a trigger's tag until the\n  // pointer moves onto something else while the popup is closed, or focus\n  // leaves the control.\n  const release = (host: HelpTagHost | null) => {\n    if (dismissed && dismissed !== host && !dismissed.open) dismissed = null;\n  };\n\n  doc.addEventListener(\n    'pointerover',\n    (event) => {\n      if ((event as PointerEvent).pointerType === 'touch') return;\n      const host = triggerHost(event);\n      release(host);\n      if (host === hovered) return;\n      const previous = hovered;\n      hovered = host;\n      if (previous) leave(previous);\n      if (!host || host.open || dismissed === host || shown?.host === host)\n        return;\n      window.clearTimeout(timer);\n      if (Date.now() < warmUntil) show(host);\n      else timer = window.setTimeout(() => show(host), HELP_TAG_SHOW_DELAY);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'pointerout',\n    (event) => {\n      // Leaving the window: nothing new is hovered.\n      if ((event as PointerEvent).relatedTarget !== null || !hovered) return;\n      const previous = hovered;\n      hovered = null;\n      leave(previous);\n    },\n    true,\n  );\n\n  // A pending hover show for this host re-checks the dismissal and no-ops.\n  const dismiss = (host: HelpTagHost) => {\n    dismissed = host;\n    hide(host);\n  };\n\n  doc.addEventListener(\n    'pointerdown',\n    (event) => {\n      const host = helpTagHost(event.composedPath());\n      if (host) dismiss(host);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'focusin',\n    (event) => {\n      // Only keyboard focus (`:focus-visible`) shows a tag; a click focuses\n      // the trigger without one.\n      const target = event.composedPath()[0];\n      const host =\n        target instanceof Element && focusVisible(target)\n          ? triggerHost(event)\n          : null;\n      if (host === focused) return;\n      const previous = focused;\n      focused = host;\n      if (previous) leave(previous);\n      if (host && dismissed !== host) show(host);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'focusout',\n    (event) => {\n      const host = helpTagHost(event.composedPath());\n      // Focus moving within the control (into its popup and back) is handled\n      // by focusin; only focus leaving the control ends a dismissal.\n      const next = (event as FocusEvent).relatedTarget;\n      if (!host || (next instanceof Node && host.contains(next))) return;\n      if (dismissed === host) dismissed = null;\n      if (host !== focused) return;\n      focused = null;\n      leave(host);\n    },\n    true,\n  );\n\n  doc.addEventListener(\n    'keydown',\n    (event) => {\n      if (event.key === 'Escape' && shown) dismiss(shown.host);\n    },\n    true,\n  );\n\n  // Opening the popup hides the tag: the menu itself now shows the choices.\n  doc.addEventListener(\n    'wa-show',\n    (event) => {\n      const host = helpTagHost(event.composedPath());\n      if (host && event.composedPath()[0] === host) dismiss(host);\n    },\n    true,\n  );\n\n  // Keep a visible tag's text in step with the selection.\n  const refresh = (event: Event) => {\n    const host = helpTagHost(event.composedPath());\n    if (shown && host === shown.host) shown.tag.textContent = helpText(host);\n  };\n  doc.addEventListener('change', refresh, true);\n  doc.addEventListener('input', refresh, true);\n}\n"]}

package/dist/chunk-DG6G5EPF.js

@@ -0,0 +1,35 @@
+import { filterDataAttributes } from './chunk-SRSJO5QE.js';
+import { jsx } from 'kerfjs/jsx-runtime';
+
+var listInsetTextProtectedAttributes = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-sides"
+]);
+function ListInsetText({
+  children,
+  sides = "trbl",
+  className = "",
+  rootAttributes = {},
+  slot
+}) {
+  const safeRootAttributes = filterDataAttributes(
+    rootAttributes,
+    listInsetTextProtectedAttributes
+  );
+  const cls = `kui-list-inset-text ${className}`.trim();
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...safeRootAttributes,
+      class: cls,
+      "data-component": "list-inset-text",
+      "data-sides": sides,
+      slot,
+      children
+    }
+  );
+}
+
+export { ListInsetText };
+
+//# sourceMappingURL=chunk-DG6G5EPF.js.map

package/dist/chunk-DG6G5EPF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/list-inset-text.tsx"],"names":[],"mappings":";;;AAIA,IAAM,gCAAA,uBAAuC,GAAA,CAAI;AAAA,EAC/C,gBAAA;AAAA,EACA;AACF,CAAC,CAAA;AA6BM,SAAS,aAAA,CAAc;AAAA,EAC5B,QAAA;AAAA,EACA,KAAA,GAAQ,MAAA;AAAA,EACR,SAAA,GAAY,EAAA;AAAA,EACZ,iBAAiB,EAAC;AAAA,EAClB;AACF,CAAA,EAAuB;AACrB,EAAA,MAAM,kBAAA,GAAqB,oBAAA;AAAA,IACzB,cAAA;AAAA,IACA;AAAA,GACF;AACA,EAAA,MAAM,GAAA,GAAM,CAAA,oBAAA,EAAuB,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AACpD,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACE,GAAG,kBAAA;AAAA,MACJ,KAAA,EAAO,GAAA;AAAA,MACP,gBAAA,EAAe,iBAAA;AAAA,MACf,YAAA,EAAY,KAAA;AAAA,MACZ,IAAA;AAAA,MAEC;AAAA;AAAA,GACH;AAEJ","file":"chunk-DG6G5EPF.js","sourcesContent":["import { filterDataAttributes } from './extension-attributes.js';\nimport type { KerfUiContent } from './semantic-content.js';\nimport type { Sides } from './sides.js';\n\nconst listInsetTextProtectedAttributes = new Set([\n  'data-component',\n  'data-sides',\n]);\n\ntype ListInsetTextRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-sides'?: never;\n  }\n>;\n\nexport interface ListInsetTextProps {\n  /** Text (or inline content) that carries no margin, border, or padding of its own. */\n  children: KerfUiContent | string;\n  /** Physical inset sides in canonical top/right/bottom/left order. Defaults to all sides. */\n  sides?: Sides;\n  className?: string;\n  /** Safe `data-*` metadata; component-owned structural attributes stay protected. */\n  rootAttributes?: ListInsetTextRootAttributes;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/**\n * Gives bare text the content-item geometry — an 8px inline margin, a 1px\n * transparent border, and 8px padding — so a plain string lines up with\n * bordered `.kui-content` items (its text edge lands at the same 17px inset).\n * Use it for text elements that have no margin, border, or padding of their own.\n * Pass `sides=\"rl\"` to keep the horizontal inset but drop the vertical box\n * space for tight text layout.\n */\nexport function ListInsetText({\n  children,\n  sides = 'trbl',\n  className = '',\n  rootAttributes = {},\n  slot,\n}: ListInsetTextProps) {\n  const safeRootAttributes = filterDataAttributes(\n    rootAttributes,\n    listInsetTextProtectedAttributes,\n  );\n  const cls = `kui-list-inset-text ${className}`.trim();\n  return (\n    <div\n      {...safeRootAttributes}\n      class={cls}\n      data-component=\"list-inset-text\"\n      data-sides={sides}\n      slot={slot}\n    >\n      {children}\n    </div>\n  );\n}\n\nexport type { Sides } from './sides.js';\n"]}

package/dist/{chunk-MTM43SJO.js → chunk-G33XC2NB.js}

@@ -42,4 +42,4 @@ function Toolbar({
 
 export { Toolbar };
 
-//# sourceMappingURL=chunk-MTM43SJO.js.map
+//# sourceMappingURL=chunk-G33XC2NB.js.map

package/dist/chunk-G33XC2NB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toolbar.tsx"],"names":[],"mappings":";;;AA0DA,IAAM,KAAA,GAAQ,CACZ,KAAA,EACA,IAAA,KACI,OAAO,QAAA,CAAS,IAAI,IAAI,MAAA,GAAS,MAAA;AAEhC,SAAS,OAAA,CAAQ;AAAA,EACtB,OAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA,YAAA,GAAe,GAAA;AAAA,EACf,WAAA,GAAc,QAAA;AAAA,EACd,UAAA,GAAa,MAAA;AAAA,EACb,YAAA,GAAe,QAAA;AAAA,EACf,aAAA;AAAA,EACA,SAAA,GAAY,EAAA;AAAA,EACZ;AACF,CAAA,EAAiB;AACf,EAAA,uBACE,IAAA;AAAA,IAAC,QAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAO,CAAA,YAAA,EAAe,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MACvC,gBAAA,EAAe,SAAA;AAAA,MACf,iBAAe,YAAA,IAAgB,MAAA;AAAA,MAC/B,iBAAA,EAAiB,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAC,CAAA;AAAA,MACvC,mBAAA,EAAmB,WAAA;AAAA,MACnB,iBAAA,EAAiB,UAAA;AAAA,MACjB,oBAAA,EAAoB,YAAA;AAAA,MACpB,4BAAA,EAA4B,KAAA,CAAM,aAAA,EAAe,aAAa,CAAA;AAAA,MAC9D,0BAAA,EAA0B,KAAA,CAAM,aAAA,EAAe,WAAW,CAAA;AAAA,MAC1D,6BAAA,EAA6B,KAAA,CAAM,aAAA,EAAe,cAAc,CAAA;AAAA,MAChE,2BAAA,EAA2B,KAAA,CAAM,aAAA,EAAe,YAAY,CAAA;AAAA,MAC5D,YAAA,EAAY,KAAA;AAAA,MACZ,IAAA;AAAA,MAEA,QAAA,EAAA;AAAA,wBAAA,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,sBAAA,EAAwB,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,wBAC3C,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,qBAAA,EAAuB,QAAA,EAAA,MAAA,EAAO,CAAA;AAAA,wBACzC,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,uBAAA,EAAyB,QAAA,EAAA,QAAA,EAAS;AAAA;AAAA;AAAA,GAC/C;AAEJ","file":"chunk-G33XC2NB.js","sourcesContent":["import type { PaneSeparatorSide } from './pane.js';\nimport type { KerfUiContent } from './semantic-content.js';\nimport type { Sides } from './sides.js';\n\nexport interface ToolbarProps {\n  leading?: KerfUiContent;\n  center?: KerfUiContent;\n  trailing?: KerfUiContent;\n  label?: string;\n  /** Physical divider edges in canonical top/right/bottom/left order. Defaults to bottom. */\n  dividerSides?: Sides;\n  /** Horizontal treatment of the center zone. Defaults to centered content. */\n  centerAlign?: 'center' | 'stretch';\n  /**\n   * Component-owned responsive layout; applications choose the policy rather\n   * than restyling toolbar internals. Under every policy the trailing zone\n   * wraps its groups instead of clipping an action, and the center zone keeps\n   * its whole content width: when the zones do not fit one row, the leading\n   * title truncates with an ellipsis rather than the center overlapping it.\n   * - `none` keeps one row; the leading identity truncates first.\n   * - `stack` stacks the zones at `responsiveAt`, wrapping stacked control\n   *   groups onto further rows.\n   * - `wrap` keeps one row while every zone fits at its natural width, and\n   *   otherwise moves the trailing zone below a whole leading identity.\n   * - `center-priority` gives an expanded center control the full row.\n   */\n  responsive?: 'none' | 'stack' | 'wrap' | 'center-priority';\n  /** Container width at which `responsive=\"stack\"` activates. */\n  responsiveAt?: 'compact' | 'narrow';\n  /**\n   * Screen edges this toolbar claims for device safe-area compensation, for an\n   * app bar or bottom bar that sits directly at a screen edge rather than in a\n   * Pane header or footer. Each listed side pads by the inset its surrounding\n   * layout reports through `--kui-edge-inset-*`, or the full device inset when\n   * nothing routes that edge, while the toolbar's box and dividers paint\n   * through. Omitted, the toolbar pads only the inline edges an owner such as\n   * a Pane header hands it, and never a block edge.\n   */\n  safeAreaEdges?: readonly PaneSeparatorSide[];\n  className?: string;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/**\n * A toolbar's configuration, apart from its content: the props a composite\n * that renders a `Toolbar` for the app (a Workbench or CollapsiblePanel\n * toolbar) forwards, so the app configures that toolbar instead of styling it.\n */\nexport type ToolbarConfig = Pick<\n  ToolbarProps,\n  | 'dividerSides'\n  | 'centerAlign'\n  | 'responsive'\n  | 'responsiveAt'\n  | 'safeAreaEdges'\n>;\n\nconst claim = (\n  edges: readonly PaneSeparatorSide[] | undefined,\n  side: PaneSeparatorSide,\n) => (edges?.includes(side) ? 'true' : undefined);\n\nexport function Toolbar({\n  leading,\n  center,\n  trailing,\n  label,\n  dividerSides = 'b',\n  centerAlign = 'center',\n  responsive = 'none',\n  responsiveAt = 'narrow',\n  safeAreaEdges,\n  className = '',\n  slot,\n}: ToolbarProps) {\n  return (\n    <header\n      class={`kui-toolbar ${className}`.trim()}\n      data-component=\"toolbar\"\n      divider-sides={dividerSides || undefined}\n      data-has-center={String(Boolean(center))}\n      data-center-align={centerAlign}\n      data-responsive={responsive}\n      data-responsive-at={responsiveAt}\n      data-safe-area-block-start={claim(safeAreaEdges, 'block-start')}\n      data-safe-area-block-end={claim(safeAreaEdges, 'block-end')}\n      data-safe-area-inline-start={claim(safeAreaEdges, 'inline-start')}\n      data-safe-area-inline-end={claim(safeAreaEdges, 'inline-end')}\n      aria-label={label}\n      slot={slot}\n    >\n      <div class=\"kui-toolbar__leading\">{leading}</div>\n      <div class=\"kui-toolbar__center\">{center}</div>\n      <div class=\"kui-toolbar__trailing\">{trailing}</div>\n    </header>\n  );\n}\n\nexport type { Sides } from './sides.js';\n"]}

package/dist/{chunk-TZ5IHWB2.js → chunk-K6UNVKDK.js}

@@ -1,5 +1,5 @@
-import { Skeleton } from './chunk-ATHXW6RP.js';
-import { em } from './chunk-WZ2GLEY4.js';
+import { Skeleton } from './chunk-AHEG27M7.js';
+import { em } from './chunk-2G2ZJQYK.js';
 import { jsx } from 'kerfjs/jsx-runtime';
 
 function ToolbarText({
@@ -38,4 +38,4 @@ function ToolbarText({
 
 export { ToolbarText };
 
-//# sourceMappingURL=chunk-TZ5IHWB2.js.map
+//# sourceMappingURL=chunk-K6UNVKDK.js.map

package/dist/{chunk-TZ5IHWB2.js.map → chunk-K6UNVKDK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/toolbar-text.tsx"],"names":[],"mappings":";;;;AA8CO,SAAS,WAAA,CAAY;AAAA,EAC1B,IAAA;AAAA,EACA,IAAA,GAAO,SAAA;AAAA,EACP,SAAA,GAAY,EAAA;AAAA,EACZ,EAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA,GAAc,KAAA;AAAA,EACd,IAAA,GAAO,KAAA;AAAA,EACP,QAAA,GAAW,IAAA;AAAA,EACX,QAAA,GAAW,IAAA;AAAA,EACX;AACF,CAAA,EAAqB;AACnB,EAAA,MAAM,MAAA,GAAS,IAAA,IAAQ,QAAA,IAAY,IAAA,IAAQ,QAAA,GAAW,CAAA;AACtD,EAAA,uBACE,GAAA;AAAA,IAAC,MAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAO,CAAA,iBAAA,EAAoB,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MAC5C,gBAAA,EAAe,cAAA;AAAA,MACf,WAAA,EAAW,IAAA;AAAA,MACX,WAAA,EAAW,OAAO,MAAA,GAAS,MAAA;AAAA,MAC3B,eAAA,EAAe,WAAW,MAAA,GAAY,OAAA;AAAA,MACtC,gBAAA,EAAgB,MAAA,GAAS,MAAA,CAAO,QAAQ,CAAA,GAAI,MAAA;AAAA,MAC5C,KAAA,EAAO,MAAA,GAAS,CAAA,6BAAA,EAAgC,QAAQ,CAAA,CAAA,GAAK,MAAA;AAAA,MAC7D,kBAAA,EAAkB,cAAc,MAAA,GAAS,MAAA;AAAA,MACzC,EAAA;AAAA,MACA,IAAA,EAAM,eAAe,SAAA,GAAY,MAAA;AAAA,MACjC,YAAA,EAAY,YAAA,GAAe,MAAA,CAAO,YAAY,CAAA,GAAI,MAAA;AAAA,MAClD,WAAA,EAAW,cAAc,MAAA,GAAS,MAAA;AAAA,MAClC,IAAA;AAAA,MAEC,QAAA,EAAA,WAAA,mBACC,GAAA,CAAC,QAAA,EAAA,EAAS,KAAA,EAAO,EAAA,CAAG,CAAC,CAAA,EAAG,CAAA,mBAExB,GAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAM,wBAAA,EAA0B,QAAA,EAAA,IAAA,EAAK;AAAA;AAAA,GAE/C;AAEJ","file":"chunk-TZ5IHWB2.js","sourcesContent":["import { em } from './css-values.js';\nimport { Skeleton } from './skeleton.js';\n\nexport type ToolbarTextSize = 'xlarge' | 'large' | 'default' | 'small';\n\n/** ARIA heading level for a title exposed as a heading landmark. */\nexport type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;\n\ninterface ToolbarTextBaseProps {\n  text: string;\n  size?: ToolbarTextSize;\n  className?: string;\n  /** Optional id, e.g. so a dialog can reference the title via aria-labelledby. */\n  id?: string;\n  /**\n   * Expose heading semantics (`role=\"heading\"` + `aria-level`) so the text acts as\n   * a heading landmark — e.g. a page's primary title. Omit to keep the plain span\n   * (the default), which suits a dialog title referenced via `aria-labelledby`.\n   */\n  headingLevel?: HeadingLevel;\n  /** Render the text as an unanimated loading skeleton instead of its value. */\n  placeholder?: boolean;\n  /**\n   * Show a trailing ellipsis (…) where the text is truncated — on the single line\n   * (default), or at the `maxLines` boundary when wrapping. Set false to hard-clip\n   * instead. Default true.\n   */\n  ellipsis?: boolean;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n  /**\n   * Cap wrapped text to this many lines, truncating past it. Only takes effect with\n   * `wrap`; ignored on a single line. `null`/omitted wraps without a line cap. Default null.\n   */\n}\n\ntype ToolbarTextWrappingProps =\n  | {\n      /** Wrap onto multiple lines; combine with `maxLines` to cap them. */\n      wrap: true;\n      maxLines?: number | null;\n    }\n  | { wrap?: false; maxLines?: never };\n\nexport type ToolbarTextProps = ToolbarTextBaseProps & ToolbarTextWrappingProps;\n\nexport function ToolbarText({\n  text,\n  size = 'default',\n  className = '',\n  id,\n  headingLevel,\n  placeholder = false,\n  wrap = false,\n  ellipsis = true,\n  maxLines = null,\n  slot,\n}: ToolbarTextProps) {\n  const capped = wrap && maxLines != null && maxLines > 0;\n  return (\n    <span\n      class={`kui-toolbar-text ${className}`.trim()}\n      data-component=\"toolbar-text\"\n      data-size={size}\n      data-wrap={wrap ? 'true' : undefined}\n      data-ellipsis={ellipsis ? undefined : 'false'}\n      data-max-lines={capped ? String(maxLines) : undefined}\n      style={capped ? `--kui-toolbar-text-max-lines:${maxLines}` : undefined}\n      data-placeholder={placeholder ? 'true' : undefined}\n      id={id}\n      role={headingLevel ? 'heading' : undefined}\n      aria-level={headingLevel ? String(headingLevel) : undefined}\n      aria-busy={placeholder ? 'true' : undefined}\n      slot={slot}\n    >\n      {placeholder ? (\n        <Skeleton width={em(8)} />\n      ) : (\n        <span class=\"kui-toolbar-text__text\">{text}</span>\n      )}\n    </span>\n  );\n}\n"]}
+{"version":3,"sources":["../src/toolbar-text.tsx"],"names":[],"mappings":";;;;AA8CO,SAAS,WAAA,CAAY;AAAA,EAC1B,IAAA;AAAA,EACA,IAAA,GAAO,SAAA;AAAA,EACP,SAAA,GAAY,EAAA;AAAA,EACZ,EAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA,GAAc,KAAA;AAAA,EACd,IAAA,GAAO,KAAA;AAAA,EACP,QAAA,GAAW,IAAA;AAAA,EACX,QAAA,GAAW,IAAA;AAAA,EACX;AACF,CAAA,EAAqB;AACnB,EAAA,MAAM,MAAA,GAAS,IAAA,IAAQ,QAAA,IAAY,IAAA,IAAQ,QAAA,GAAW,CAAA;AACtD,EAAA,uBACE,GAAA;AAAA,IAAC,MAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAO,CAAA,iBAAA,EAAoB,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MAC5C,gBAAA,EAAe,cAAA;AAAA,MACf,WAAA,EAAW,IAAA;AAAA,MACX,WAAA,EAAW,OAAO,MAAA,GAAS,MAAA;AAAA,MAC3B,eAAA,EAAe,WAAW,MAAA,GAAY,OAAA;AAAA,MACtC,gBAAA,EAAgB,MAAA,GAAS,MAAA,CAAO,QAAQ,CAAA,GAAI,MAAA;AAAA,MAC5C,KAAA,EAAO,MAAA,GAAS,CAAA,6BAAA,EAAgC,QAAQ,CAAA,CAAA,GAAK,MAAA;AAAA,MAC7D,kBAAA,EAAkB,cAAc,MAAA,GAAS,MAAA;AAAA,MACzC,EAAA;AAAA,MACA,IAAA,EAAM,eAAe,SAAA,GAAY,MAAA;AAAA,MACjC,YAAA,EAAY,YAAA,GAAe,MAAA,CAAO,YAAY,CAAA,GAAI,MAAA;AAAA,MAClD,WAAA,EAAW,cAAc,MAAA,GAAS,MAAA;AAAA,MAClC,IAAA;AAAA,MAEC,QAAA,EAAA,WAAA,mBACC,GAAA,CAAC,QAAA,EAAA,EAAS,KAAA,EAAO,EAAA,CAAG,CAAC,CAAA,EAAG,CAAA,mBAExB,GAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAM,wBAAA,EAA0B,QAAA,EAAA,IAAA,EAAK;AAAA;AAAA,GAE/C;AAEJ","file":"chunk-K6UNVKDK.js","sourcesContent":["import { em } from './css-values.js';\nimport { Skeleton } from './skeleton.js';\n\nexport type ToolbarTextSize = 'xlarge' | 'large' | 'default' | 'small';\n\n/** ARIA heading level for a title exposed as a heading landmark. */\nexport type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;\n\ninterface ToolbarTextBaseProps {\n  text: string;\n  size?: ToolbarTextSize;\n  className?: string;\n  /** Optional id, e.g. so a dialog can reference the title via aria-labelledby. */\n  id?: string;\n  /**\n   * Expose heading semantics (`role=\"heading\"` + `aria-level`) so the text acts as\n   * a heading landmark — e.g. a page's primary title. Omit to keep the plain span\n   * (the default), which suits a dialog title referenced via `aria-labelledby`.\n   */\n  headingLevel?: HeadingLevel;\n  /** Render the text as an unanimated loading skeleton instead of its value. */\n  placeholder?: boolean;\n  /**\n   * Show a trailing ellipsis (…) where the text is truncated — on the single line\n   * (default), or at the `maxLines` boundary when wrapping. Set false to hard-clip\n   * instead. Default true.\n   */\n  ellipsis?: boolean;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n  /**\n   * Cap wrapped text to this many lines, truncating past it. Only takes effect with\n   * `wrap`; ignored on a single line. `null`/omitted wraps without a line cap. Default null.\n   */\n}\n\ntype ToolbarTextWrappingProps =\n  | {\n      /** Wrap onto multiple lines; combine with `maxLines` to cap them. */\n      wrap: true;\n      maxLines?: number | null;\n    }\n  | { wrap?: false; maxLines?: never };\n\nexport type ToolbarTextProps = ToolbarTextBaseProps & ToolbarTextWrappingProps;\n\nexport function ToolbarText({\n  text,\n  size = 'default',\n  className = '',\n  id,\n  headingLevel,\n  placeholder = false,\n  wrap = false,\n  ellipsis = true,\n  maxLines = null,\n  slot,\n}: ToolbarTextProps) {\n  const capped = wrap && maxLines != null && maxLines > 0;\n  return (\n    <span\n      class={`kui-toolbar-text ${className}`.trim()}\n      data-component=\"toolbar-text\"\n      data-size={size}\n      data-wrap={wrap ? 'true' : undefined}\n      data-ellipsis={ellipsis ? undefined : 'false'}\n      data-max-lines={capped ? String(maxLines) : undefined}\n      style={capped ? `--kui-toolbar-text-max-lines:${maxLines}` : undefined}\n      data-placeholder={placeholder ? 'true' : undefined}\n      id={id}\n      role={headingLevel ? 'heading' : undefined}\n      aria-level={headingLevel ? String(headingLevel) : undefined}\n      aria-busy={placeholder ? 'true' : undefined}\n      slot={slot}\n    >\n      {placeholder ? (\n        <Skeleton width={em(8)} />\n      ) : (\n        <span class=\"kui-toolbar-text__text\">{text}</span>\n      )}\n    </span>\n  );\n}\n"]}