@kerfjs/ui 4.5.0-beta.1 → 5.0.0-beta.100

package/dist/chunk-HLDRH23D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/actions/split-button/split-button.tsx"],"names":[],"mappings":";;;;;;AAWA,IAAM,oBAAA,uBAA2B,GAAA,CAAI;AAAA,EACnC,gBAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAC,CAAA;AAwDM,SAAS,WAAA,CAAY;AAAA,EAC1B,KAAA;AAAA,EACA,MAAA;AAAA,EACA,IAAA;AAAA,EACA,eAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA,eAAA,GAAkB,KAAA;AAAA,EAClB,YAAA,GAAe,MAAA;AAAA,EACf,eAAA;AAAA,EACA,IAAA,GAAO,OAAA;AAAA,EACP,IAAA,GAAO,KAAA;AAAA,EACP,IAAA,GAAO,KAAA;AAAA,EACP,QAAA,GAAW,KAAA;AAAA,EACX,eAAA,GAAkB,KAAA;AAAA,EAClB,KAAA;AAAA,EACA,SAAA,GAAY,EAAA;AAAA,EACZ,iBAAiB,EAAC;AAAA,EAClB;AACF,CAAA,EAAqB;AACnB,EAAA,MAAM,OAAA,GAAU,IAAA,mBAAO,GAAA,CAAC,cAAA,EAAA,EAAe,CAAA,GAAK,IAAA;AAC5C,EAAA,uBACE,IAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACE,GAAG,oBAAA,CAAqB,cAAA,EAAgB,oBAAoB,CAAA;AAAA,MAC7D,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,WAAA,EAAW,OAAO,MAAA,GAAS,MAAA;AAAA,MAC3B,IAAA,EAAK,OAAA;AAAA,MACL,IAAA;AAAA,MAEA,QAAA,EAAA;AAAA,wBAAA,IAAA;AAAA,UAAC,QAAA;AAAA,UAAA;AAAA,YACC,IAAA,EAAK,QAAA;AAAA,YACL,KAAA,EAAM,2BAAA;AAAA,YACN,aAAA,EAAa,MAAA;AAAA,YACb,YAAA,EAAY,eAAA;AAAA,YACZ,WAAA,EAAW,OAAO,MAAA,GAAS,MAAA;AAAA,YAC3B,KAAA;AAAA,YACA,QAAA;AAAA,YAEC,QAAA,EAAA;AAAA,cAAA,OAAA,wBACE,MAAA,EAAA,EAAK,KAAA,EAAM,wBAAA,EAAyB,aAAA,EAAY,QAC9C,QAAA,EAAA,OAAA,EACH,CAAA;AAAA,8BAEF,GAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAM,yBAAA,EAA2B,QAAA,EAAA,KAAA,EAAM;AAAA;AAAA;AAAA,SAC/C;AAAA,wBACA,GAAA;AAAA,UAAC,QAAA;AAAA,UAAA;AAAA,YACC,IAAA,EAAK,QAAA;AAAA,YACL,KAAA,EAAM,2BAAA;AAAA,YACN,aAAA,EAAa,aAAA;AAAA,YACb,YAAA,EAAY,YAAA;AAAA,YACZ,eAAA,EAAe,YAAA;AAAA,YACf,eAAA,EAAe,kBAAkB,MAAA,GAAS,OAAA;AAAA,YAC1C,eAAA,EAAe,eAAA;AAAA,YACf,KAAA,EAAO,YAAA;AAAA,YACP,QAAA,EAAU,eAAA;AAAA,YAEV,QAAA,kBAAA,GAAA,CAAC,UAAA,EAAA,EAAW,IAAA,EAAM,WAAA,EAAa,MAAK,cAAA,EAAe;AAAA;AAAA;AACrD;AAAA;AAAA,GACF;AAEJ","file":"chunk-HLDRH23D.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\nimport { ChevronDown } from 'lucide';\n\nimport { filterDataAttributes } from '../../../shared/dom/extension-attributes.js';\nimport { LoadingSpinner } from '../../feedback/loading-spinner/loading-spinner.js';\nimport { LucideIcon } from '../../media/lucide-icon/lucide-icon.js';\n\n/** The loud fill the whole split button paints. */\nexport type SplitButtonTone =\n  'brand' | 'neutral' | 'success' | 'warning' | 'danger';\n\nconst splitButtonProtected = new Set([\n  'data-component',\n  'data-tone',\n  'data-fill',\n  'data-busy',\n]);\n\ntype SplitButtonRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-component'?: never;\n    'data-tone'?: never;\n    'data-fill'?: never;\n    'data-busy'?: never;\n  }\n>;\n\nexport interface SplitButtonProps {\n  /** Visible primary label. */\n  label: string;\n  /** Delegated `data-action` of the primary half. */\n  action: string;\n  /** Optional decorative leading icon of the primary half. */\n  icon?: SafeHtml;\n  /** Primary accessible name when it should say more than `label`. */\n  accessibleLabel?: string;\n  /** Accessible name (and tooltip) of the options trigger. */\n  optionsLabel: string;\n  /** Delegated `data-action` of the options trigger, which opens the app's menu. */\n  optionsAction: string;\n  /** Whether the options menu is open, exposed as `aria-expanded`. */\n  optionsExpanded?: boolean;\n  /** What the options trigger opens, exposed as `aria-haspopup`; defaults to `menu`. */\n  optionsPopup?: 'menu' | 'dialog' | 'listbox';\n  /** Element id the options trigger controls, exposed as `aria-controls`. */\n  optionsControls?: string;\n  /** The loud fill; defaults to `brand`. Switch it (for example to `neutral`) while running. */\n  tone?: SplitButtonTone;\n  /** Span the full width of the parent instead of sizing to the label. */\n  fill?: boolean;\n  /** Show work in progress: a spinner replaces the icon and the primary is `aria-busy`. */\n  busy?: boolean;\n  /** Disable the primary half. */\n  disabled?: boolean;\n  /** Disable the options trigger. */\n  optionsDisabled?: boolean;\n  /** Native tooltip of the primary half, for example why it is disabled. */\n  title?: string;\n  className?: string;\n  /** Safe `data-*` metadata; SplitButton-owned markers stay protected. */\n  rootAttributes?: SplitButtonRootAttributes;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/**\n * A primary action with an attached options trigger on one loud, semantic\n * fill (a \"Drive\" button with a provider menu). Both halves are native\n * buttons, so `aria-expanded` and the accessible names reach assistive\n * technology directly; the application opens its own menu from the options\n * action and owns the running state.\n */\nexport function SplitButton({\n  label,\n  action,\n  icon,\n  accessibleLabel,\n  optionsLabel,\n  optionsAction,\n  optionsExpanded = false,\n  optionsPopup = 'menu',\n  optionsControls,\n  tone = 'brand',\n  fill = false,\n  busy = false,\n  disabled = false,\n  optionsDisabled = false,\n  title,\n  className = '',\n  rootAttributes = {},\n  slot,\n}: SplitButtonProps) {\n  const leading = busy ? <LoadingSpinner /> : icon;\n  return (\n    <div\n      {...filterDataAttributes(rootAttributes, splitButtonProtected)}\n      class={`kui-split-button ${className}`.trim()}\n      data-component=\"split-button\"\n      data-tone={tone}\n      data-fill={fill ? 'true' : undefined}\n      data-busy={busy ? 'true' : undefined}\n      role=\"group\"\n      slot={slot}\n    >\n      <button\n        type=\"button\"\n        class=\"kui-split-button__primary\"\n        data-action={action}\n        aria-label={accessibleLabel}\n        aria-busy={busy ? 'true' : undefined}\n        title={title}\n        disabled={disabled}\n      >\n        {leading && (\n          <span class=\"kui-split-button__icon\" aria-hidden=\"true\">\n            {leading}\n          </span>\n        )}\n        <span class=\"kui-split-button__label\">{label}</span>\n      </button>\n      <button\n        type=\"button\"\n        class=\"kui-split-button__options\"\n        data-action={optionsAction}\n        aria-label={optionsLabel}\n        aria-haspopup={optionsPopup}\n        aria-expanded={optionsExpanded ? 'true' : 'false'}\n        aria-controls={optionsControls}\n        title={optionsLabel}\n        disabled={optionsDisabled}\n      >\n        <LucideIcon icon={ChevronDown} name=\"chevron-down\" />\n      </button>\n    </div>\n  );\n}\n"]}

package/dist/chunk-HQZYKJ56.js

@@ -0,0 +1,302 @@
+import { jsx, jsxs, Fragment } from 'kerfjs/jsx-runtime';
+
+// src/components/actions/popup-menu/internal/popup-menu-content-cache.ts
+var hashState = new Int32Array(2);
+function hashCode(code) {
+  hashState[0] = Math.imul(hashState[0] ^ code, 16777619);
+  hashState[1] = Math.imul(hashState[1], 31) + code | 0;
+}
+function hashText(text) {
+  let digest = hashState[0];
+  let check = hashState[1];
+  const length = text.length;
+  for (let index = 0; index < length; index++) {
+    let code = text.charCodeAt(index);
+    if ((code & 64512) === 55296 && index + 1 < length) {
+      const low = text.charCodeAt(index + 1);
+      if ((low & 64512) === 56320) {
+        code = (code - 55296 << 10) + (low - 56320) + 65536;
+        index++;
+      }
+    }
+    digest = Math.imul(digest ^ code, 16777619);
+    check = Math.imul(check, 31) + code | 0;
+  }
+  hashState[0] = digest;
+  hashState[1] = check;
+}
+var LONG_PART_LENGTH = 64;
+var PART_DIGEST_LIMIT = 4096;
+var partDigests = /* @__PURE__ */ new Map();
+function hashLongText(text) {
+  let pair = partDigests.get(text);
+  if (!pair) {
+    const digest = hashState[0];
+    const check = hashState[1];
+    hashState[0] = 2166136261;
+    hashState[1] = 2538058380;
+    hashText(text);
+    pair = [hashState[0], hashState[1]];
+    hashState[0] = digest;
+    hashState[1] = check;
+    if (partDigests.size >= PART_DIGEST_LIMIT)
+      partDigests.delete(partDigests.keys().next().value);
+    partDigests.set(text, pair);
+  }
+  hashCode(pair[0]);
+  hashCode(pair[1]);
+}
+function hashPart(text) {
+  if (text.length >= LONG_PART_LENGTH) hashLongText(text);
+  else hashText(text);
+}
+var PART_SEPARATOR = 0;
+var FIELD_SEPARATOR = 1;
+function hashEntry(entry) {
+  if (entry.kind === "divider") {
+    hashCode(45);
+    return;
+  }
+  if (entry.kind === "heading") {
+    hashCode(35);
+    hashText(entry.label);
+    return;
+  }
+  hashText(entry.label);
+  hashCode(FIELD_SEPARATOR);
+  hashText(entry.action ?? "");
+  hashCode(FIELD_SEPARATOR);
+  hashText(entry.value ?? "");
+  hashCode(FIELD_SEPARATOR);
+  hashCode(entry.disabled ? 49 : 48);
+  hashCode(FIELD_SEPARATOR);
+  hashCode(entry.checked === void 0 ? 45 : entry.checked ? 49 : 48);
+  hashCode(FIELD_SEPARATOR);
+  hashText(entry.tone ?? "");
+  hashCode(FIELD_SEPARATOR);
+  hashText(entry.disabledReason ?? "");
+  hashCode(FIELD_SEPARATOR);
+  hashPart(String(entry.icon ?? ""));
+  hashCode(FIELD_SEPARATOR);
+  hashPart(String(entry.details ?? ""));
+  hashCode(FIELD_SEPARATOR);
+  hashText(entry.attributes ? JSON.stringify(entry.attributes) : "{}");
+  for (const child of entry.submenu ?? []) {
+    hashCode(FIELD_SEPARATOR);
+    hashEntry(child);
+  }
+}
+var MARKUP_CACHE_LIMIT = 1024;
+var markupCache = /* @__PURE__ */ new Map();
+function popupMenuContentKey(triggerParts, items) {
+  hashState[0] = 2166136261;
+  hashState[1] = 2538058380;
+  for (let index = 0; index < triggerParts.length; index++) {
+    if (index > 0) hashCode(PART_SEPARATOR);
+    hashPart(triggerParts[index]);
+  }
+  for (const entry of items) {
+    hashCode(PART_SEPARATOR);
+    hashEntry(entry);
+  }
+  const digest = (hashState[0] >>> 0).toString(36);
+  return {
+    key: `kui-popup-menu-${digest}`,
+    cacheKey: `${digest}:${(hashState[1] >>> 0).toString(36)}`
+  };
+}
+function cachedPopupMenuContent(cacheKey) {
+  const content = markupCache.get(cacheKey);
+  if (content) {
+    markupCache.delete(cacheKey);
+    markupCache.set(cacheKey, content);
+  }
+  return content;
+}
+function cachePopupMenuContent(cacheKey, content) {
+  if (content.__segment.kind !== "static") return;
+  if (markupCache.size >= MARKUP_CACHE_LIMIT)
+    markupCache.delete(markupCache.keys().next().value);
+  markupCache.set(cacheKey, content);
+}
+function hasChoice(entries) {
+  return entries.some(
+    (entry) => entry.kind !== "heading" && entry.kind !== "divider" && entry.checked !== void 0
+  );
+}
+function renderEntry(entry, nested = false, levelHasChoice = false) {
+  if (entry.kind === "divider")
+    return /* @__PURE__ */ jsx("wa-divider", { slot: nested ? "submenu" : void 0 });
+  if (entry.kind === "heading")
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        class: "kui-popup-menu__heading",
+        slot: nested ? "submenu" : void 0,
+        children: entry.label
+      }
+    );
+  const reserveCheck = levelHasChoice && entry.checked === void 0;
+  const submenuHasChoice = entry.submenu ? hasChoice(entry.submenu) : false;
+  return /* @__PURE__ */ jsxs(
+    "wa-dropdown-item",
+    {
+      ...entry.attributes ?? {},
+      slot: nested ? "submenu" : void 0,
+      "data-check-space": reserveCheck ? "reserved" : void 0,
+      "data-action": entry.action,
+      value: entry.value,
+      type: entry.checked === void 0 ? void 0 : "checkbox",
+      checked: entry.checked,
+      variant: entry.tone === "danger" ? "danger" : void 0,
+      disabled: entry.disabled,
+      title: entry.disabled ? entry.disabledReason : void 0,
+      children: [
+        reserveCheck ? /* @__PURE__ */ jsx(
+          "span",
+          {
+            slot: "icon",
+            class: "kui-popup-menu__check-space",
+            "aria-hidden": "true"
+          }
+        ) : null,
+        entry.icon ? /* @__PURE__ */ jsx("span", { slot: "icon", class: "kui-popup-menu__icon", children: entry.icon }) : null,
+        entry.label,
+        entry.details ? /* @__PURE__ */ jsx("span", { slot: "details", class: "kui-popup-menu__details", children: entry.details }) : entry.submenu ? /* @__PURE__ */ jsx("span", { slot: "details" }) : null,
+        entry.submenu?.map(
+          (child) => renderEntry(child, true, submenuHasChoice)
+        )
+      ]
+    }
+  );
+}
+var pointerRestores = /* @__PURE__ */ new WeakMap();
+function openPopupMenuAt(menu, x, y) {
+  menu.style.setProperty("--kui-popup-menu-context-x", `${x}px`);
+  menu.style.setProperty("--kui-popup-menu-context-y", `${y}px`);
+  const popup = menu.getAttribute("data-trigger") === "context" ? null : menu.shadowRoot?.querySelector("wa-popup");
+  if (popup) {
+    popup.anchor = {
+      getBoundingClientRect: () => new DOMRect(x, y, 0, 0)
+    };
+    popup.placement = "bottom-start";
+    const previous = pointerRestores.get(menu);
+    if (previous) menu.removeEventListener("wa-after-hide", previous);
+    const restore = (event) => {
+      if (event.target !== menu) return;
+      menu.removeEventListener("wa-after-hide", restore);
+      pointerRestores.delete(menu);
+      popup.anchor = void 0;
+      popup.placement = menu.getAttribute("placement") ?? "bottom-start";
+    };
+    pointerRestores.set(menu, restore);
+    menu.addEventListener("wa-after-hide", restore);
+  }
+  menu.open = true;
+}
+function openPopupMenu(menu) {
+  menu.open = true;
+}
+function closePopupMenu(menu) {
+  menu.open = false;
+}
+function renderContent({
+  context,
+  label,
+  icon,
+  text,
+  caret,
+  disabled,
+  items
+}) {
+  const levelHasChoice = hasChoice(items);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    context ? /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        slot: "trigger",
+        class: "kui-popup-menu__context-anchor",
+        "aria-label": label,
+        "aria-hidden": "true",
+        tabindex: -1
+      }
+    ) : /* @__PURE__ */ jsxs(
+      "wa-button",
+      {
+        slot: "trigger",
+        appearance: "plain",
+        "with-caret": caret,
+        disabled,
+        children: [
+          icon,
+          text ? /* @__PURE__ */ jsx("span", { children: text }) : /* @__PURE__ */ jsx("span", { class: "kui-popup-menu__label", children: label })
+        ]
+      }
+    ),
+    items.map((entry) => renderEntry(entry, false, levelHasChoice))
+  ] });
+}
+function PopupMenu({
+  text,
+  label,
+  icon,
+  items,
+  placement = "bottom-start",
+  caret = true,
+  disabled = false,
+  rootAttributes = {},
+  slot,
+  context = false,
+  anchor
+}) {
+  if (anchor !== void 0 && (!context || !Number.isFinite(anchor.x) || !Number.isFinite(anchor.y)))
+    throw new RangeError(
+      "PopupMenu anchor requires context mode and finite x and y coordinates"
+    );
+  const { key, cacheKey } = popupMenuContentKey(
+    [
+      text ?? "",
+      label ?? "",
+      String(icon ?? ""),
+      String(caret),
+      String(disabled),
+      String(context)
+    ],
+    items
+  );
+  let content = cachedPopupMenuContent(cacheKey);
+  if (!content) {
+    content = renderContent({
+      context,
+      label,
+      icon,
+      text,
+      caret,
+      disabled,
+      items
+    });
+    cachePopupMenuContent(cacheKey, content);
+  }
+  return /* @__PURE__ */ jsx(
+    "wa-dropdown",
+    {
+      size: "m",
+      ...rootAttributes,
+      class: "kui-popup-menu",
+      "data-component": "popup-menu",
+      "data-key": key,
+      "data-morph-skip-children": true,
+      "data-trigger": context ? "context" : "button",
+      "data-menu-label": text ?? label,
+      style: anchor ? `--kui-popup-menu-context-x:${anchor.x}px;--kui-popup-menu-context-y:${anchor.y}px` : void 0,
+      placement,
+      slot,
+      children: content
+    }
+  );
+}
+
+export { PopupMenu, closePopupMenu, openPopupMenu, openPopupMenuAt };
+
+//# sourceMappingURL=chunk-HQZYKJ56.js.map

package/dist/chunk-HQZYKJ56.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/actions/popup-menu/internal/popup-menu-content-cache.ts","../src/components/actions/popup-menu/popup-menu.tsx"],"names":[],"mappings":"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","file":"chunk-HQZYKJ56.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\n\nimport type { PopupMenuEntry } from '../popup-menu.js';\n\n/**\n * Streaming content hash: slot 0 is the FNV-1a digest that names\n * the menu's `data-key`; slot 1 is an independent check hash (a 31-multiplier\n * polynomial whose dependency chain runs in parallel with the digest's), so\n * the markup cache is keyed by about 64 bits and a digest collision cannot\n * serve another menu's markup. An `Int32Array` keeps both accumulators unboxed\n * between calls.\n */\nconst hashState = new Int32Array(2);\n\nfunction hashCode(code: number): void {\n  hashState[0] = Math.imul(hashState[0]! ^ code, 0x01000193);\n  hashState[1] = (Math.imul(hashState[1]!, 31) + code) | 0;\n}\n\n/**\n * Hash a string's code points. A surrogate pair is combined into one code\n * point, matching the former `for…of` iteration over the joined key, so the\n * digest, and with it the rendered `data-key`, is unchanged.\n */\nfunction hashText(text: string): void {\n  let digest = hashState[0]!;\n  let check = hashState[1]!;\n  const length = text.length;\n  for (let index = 0; index < length; index++) {\n    let code = text.charCodeAt(index);\n    if ((code & 0xfc00) === 0xd800 && index + 1 < length) {\n      const low = text.charCodeAt(index + 1);\n      if ((low & 0xfc00) === 0xdc00) {\n        code = ((code - 0xd800) << 10) + (low - 0xdc00) + 0x10000;\n        index++;\n      }\n    }\n    digest = Math.imul(digest ^ code, 0x01000193);\n    check = (Math.imul(check, 31) + code) | 0;\n  }\n  hashState[0] = digest;\n  hashState[1] = check;\n}\n\n/**\n * Parts at least this long (icon and details markup) are hashed through\n * {@link hashLongText}: by a memoized digest of the whole string instead of\n * character by character, so a glyph repeated on every row costs a map lookup.\n */\nexport const LONG_PART_LENGTH = 64;\n\n/** Bound on memoized long-part digests; past it the oldest is evicted. */\nexport const PART_DIGEST_LIMIT = 4096;\nconst partDigests = new Map<string, readonly [number, number]>();\n\n/**\n * Feed a long part as its own two hashes. A Lucide SVG is a few hundred\n * characters and repeats across every row's menu, so hashing its characters\n * dominated an unchanged menu's cost; V8 hashes a string key natively (once\n * per string object) and compares equal strings quickly.\n */\nfunction hashLongText(text: string): void {\n  let pair = partDigests.get(text);\n  if (!pair) {\n    const digest = hashState[0]!;\n    const check = hashState[1]!;\n    hashState[0] = 0x811c9dc5;\n    hashState[1] = 0x9747b28c;\n    hashText(text);\n    pair = [hashState[0], hashState[1]];\n    hashState[0] = digest;\n    hashState[1] = check;\n    if (partDigests.size >= PART_DIGEST_LIMIT)\n      partDigests.delete(partDigests.keys().next().value!);\n    partDigests.set(text, pair);\n  }\n  hashCode(pair[0]);\n  hashCode(pair[1]);\n}\n\n/** Hash a part, through its memoized digest when it is long. */\nfunction hashPart(text: string): void {\n  if (text.length >= LONG_PART_LENGTH) hashLongText(text);\n  else hashText(text);\n}\n\nconst PART_SEPARATOR = 0x00;\nconst FIELD_SEPARATOR = 0x01;\n\n/**\n * Feed one entry's structure: the fields, in order, separated by U+0001, with\n * each submenu entry appended the same way.\n */\nfunction hashEntry(entry: PopupMenuEntry): void {\n  if (entry.kind === 'divider') {\n    hashCode(0x2d); // '-'\n    return;\n  }\n  if (entry.kind === 'heading') {\n    hashCode(0x23); // '#'\n    hashText(entry.label);\n    return;\n  }\n  hashText(entry.label);\n  hashCode(FIELD_SEPARATOR);\n  hashText(entry.action ?? '');\n  hashCode(FIELD_SEPARATOR);\n  hashText(entry.value ?? '');\n  hashCode(FIELD_SEPARATOR);\n  hashCode(entry.disabled ? 0x31 : 0x30);\n  hashCode(FIELD_SEPARATOR);\n  hashCode(entry.checked === undefined ? 0x2d : entry.checked ? 0x31 : 0x30);\n  hashCode(FIELD_SEPARATOR);\n  hashText(entry.tone ?? '');\n  hashCode(FIELD_SEPARATOR);\n  hashText(entry.disabledReason ?? '');\n  hashCode(FIELD_SEPARATOR);\n  // SafeHtml stringifies to its stored markup without copying, and the key\n  // must change when an icon or details change.\n  hashPart(String(entry.icon ?? ''));\n  hashCode(FIELD_SEPARATOR);\n  hashPart(String(entry.details ?? ''));\n  hashCode(FIELD_SEPARATOR);\n  hashText(entry.attributes ? JSON.stringify(entry.attributes) : '{}');\n  for (const child of entry.submenu ?? []) {\n    hashCode(FIELD_SEPARATOR);\n    hashEntry(child);\n  }\n}\n\n/**\n * Bounded, least-recently-used cache of each menu's trigger and entry markup,\n * keyed by its content hashes. A list that re-renders unchanged menus then\n * pays one hash pass per menu instead of rendering every entry again, which\n * the morph would discard under `data-morph-skip-children` anyway. Sized above\n * a large list's distinct menus; past it, renders fall back to fresh markup.\n */\nexport const MARKUP_CACHE_LIMIT = 1024;\nconst markupCache = new Map<string, SafeHtml>();\n\n/**\n * The menu's `data-key` and its cache key. The digest covers, in order and\n * separated by U+0000, the trigger parts and then each entry, whose fields are\n * separated by U+0001; it is the FNV-1a hash of that joined text, except that\n * a part of {@link LONG_PART_LENGTH} or more characters contributes its own\n * two hashes in place of its characters.\n */\nexport function popupMenuContentKey(\n  triggerParts: readonly string[],\n  items: readonly PopupMenuEntry[],\n): { key: string; cacheKey: string } {\n  hashState[0] = 0x811c9dc5;\n  hashState[1] = 0x9747b28c;\n  for (let index = 0; index < triggerParts.length; index++) {\n    if (index > 0) hashCode(PART_SEPARATOR);\n    hashPart(triggerParts[index]!);\n  }\n  for (const entry of items) {\n    hashCode(PART_SEPARATOR);\n    hashEntry(entry);\n  }\n  const digest = (hashState[0]! >>> 0).toString(36);\n  return {\n    key: `kui-popup-menu-${digest}`,\n    cacheKey: `${digest}:${(hashState[1]! >>> 0).toString(36)}`,\n  };\n}\n\n/** Cached markup for a cache key, refreshed as most recently used. */\nexport function cachedPopupMenuContent(cacheKey: string): SafeHtml | undefined {\n  const content = markupCache.get(cacheKey);\n  if (content) {\n    markupCache.delete(cacheKey);\n    markupCache.set(cacheKey, content);\n  }\n  return content;\n}\n\n/**\n * Remember rendered markup, evicting the least recently used entry when full.\n * Only static markup is reusable: content that holds a keyed list must be\n * rendered in each pass for the list reconciler.\n */\nexport function cachePopupMenuContent(\n  cacheKey: string,\n  content: SafeHtml,\n): void {\n  if (content.__segment.kind !== 'static') return;\n  if (markupCache.size >= MARKUP_CACHE_LIMIT)\n    markupCache.delete(markupCache.keys().next().value!);\n  markupCache.set(cacheKey, content);\n}\n\n/** Test hook: drop cached menu markup and memoized part digests. */\nexport function _clearPopupMenuMarkupCache(): void {\n  markupCache.clear();\n  partDigests.clear();\n}\n\n/** Test hook: the number of memoized long-part digests. */\nexport function _popupMenuPartDigestCount(): number {\n  return partDigests.size;\n}\n\n/** Test hook: the number of cached menu markups. */\nexport function _popupMenuMarkupCacheSize(): number {\n  return markupCache.size;\n}\n","import type { SafeHtml } from 'kerfjs';\n\nimport type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport {\n  cachedPopupMenuContent,\n  cachePopupMenuContent,\n  popupMenuContentKey,\n} from './internal/popup-menu-content-cache.js';\n\nexport type PopupMenuPlacement =\n  'bottom-start' | 'bottom' | 'bottom-end' | 'top-start' | 'top' | 'top-end';\n\ntype PopupMenuDataAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-action'?: never;\n    'data-component'?: never;\n    'data-key'?: never;\n    'data-morph-skip-children'?: never;\n  }\n>;\n\n/** One command in the menu. */\nexport interface PopupMenuItem {\n  kind?: 'item';\n  label: string;\n  /** Delegated `data-action` the app handles when the item is chosen. */\n  action?: string;\n  /** Native `wa-dropdown-item` value, reported by its `wa-select` event. */\n  value?: string;\n  /** Leading icon, typically a `LucideIcon`; it is placed in the item's icon slot. */\n  icon?: SafeHtml;\n  /** A checkbox choice, including nested choices; omit for a plain command. */\n  checked?: boolean;\n  /** Trailing safe content, such as secondary status. */\n  details?: SafeHtml;\n  /** Destructive command styling. */\n  tone?: 'default' | 'danger';\n  disabled?: boolean;\n  /** Native tooltip text for a disabled command. */\n  disabledReason?: string;\n  /** Application `data-*` metadata such as a record id. */\n  attributes?: PopupMenuDataAttributes;\n  /** Child commands, headings, and dividers opened by hover or keyboard navigation. */\n  submenu?: readonly PopupMenuEntry[];\n}\n\n/** A labeled group heading; items that follow it belong to the group. */\nexport interface PopupMenuHeading {\n  kind: 'heading';\n  label: string;\n}\n\n/** A separator between groups of items. */\nexport interface PopupMenuDivider {\n  kind: 'divider';\n}\n\nexport type PopupMenuEntry =\n  PopupMenuItem | PopupMenuHeading | PopupMenuDivider;\n\ntype PopupMenuTriggerName =\n  | {\n      /** Visible trigger text, which is also its accessible name. */\n      text: string;\n      label?: never;\n    }\n  | {\n      text?: never;\n      /**\n       * Accessible name of an icon-only trigger, rendered as visually hidden\n       * slotted text (a Web Awesome button takes its name from its content).\n       */\n      label: string;\n    };\n\n/** A context PopupMenu's viewport anchor point. */\nexport interface PopupMenuAnchor {\n  x: number;\n  y: number;\n}\n\ntype PopupMenuTrigger =\n  | (PopupMenuTriggerName & { context?: false; anchor?: never })\n  | {\n      context: true;\n      label: string;\n      /**\n       * The viewport point (CSS pixels, as in `MouseEvent.clientX/Y`) the\n       * menu opens from. Rendered into the menu itself, so it survives\n       * re-renders and replacement; open it with `openPopupMenu`.\n       */\n      anchor?: PopupMenuAnchor;\n      text?: never;\n      icon?: never;\n      caret?: never;\n      disabled?: never;\n    };\n\nexport type PopupMenuProps = PopupMenuTrigger & {\n  /** Trigger icon, typically a `LucideIcon`, before any visible text. */\n  icon?: KerfUiContent;\n  items: readonly PopupMenuEntry[];\n  /** Where the menu opens relative to its trigger. Defaults to `bottom-start`. */\n  placement?: PopupMenuPlacement;\n  /** Show the disclosure caret after the trigger content. Defaults to true. */\n  caret?: boolean;\n  disabled?: boolean;\n  /** Application `data-*` metadata on the menu root. */\n  rootAttributes?: PopupMenuDataAttributes;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n};\n\n/** Whether a menu level holds a checkbox choice, so its plain items reserve the check column. */\nfunction hasChoice(entries: readonly PopupMenuEntry[]): boolean {\n  return entries.some(\n    (entry) =>\n      entry.kind !== 'heading' &&\n      entry.kind !== 'divider' &&\n      entry.checked !== undefined,\n  );\n}\n\nfunction renderEntry(\n  entry: PopupMenuEntry,\n  nested = false,\n  levelHasChoice = false,\n) {\n  if (entry.kind === 'divider')\n    return <wa-divider slot={nested ? 'submenu' : undefined} />;\n  // A group title styled like the Select's group title. It is not a slotted\n  // h1-h6, whose Web Awesome group-label metrics are !important.\n  if (entry.kind === 'heading')\n    return (\n      <div\n        class=\"kui-popup-menu__heading\"\n        slot={nested ? 'submenu' : undefined}\n      >\n        {entry.label}\n      </div>\n    );\n  // A plain command beside checkbox choices keeps their check column, so its\n  // icon and label line up with theirs.\n  const reserveCheck = levelHasChoice && entry.checked === undefined;\n  const submenuHasChoice = entry.submenu ? hasChoice(entry.submenu) : false;\n  return (\n    <wa-dropdown-item\n      {...(entry.attributes ?? {})}\n      slot={nested ? 'submenu' : undefined}\n      data-check-space={reserveCheck ? 'reserved' : undefined}\n      data-action={entry.action}\n      value={entry.value}\n      type={entry.checked === undefined ? undefined : 'checkbox'}\n      checked={entry.checked}\n      variant={entry.tone === 'danger' ? 'danger' : undefined}\n      disabled={entry.disabled}\n      title={entry.disabled ? entry.disabledReason : undefined}\n    >\n      {reserveCheck ? (\n        <span\n          slot=\"icon\"\n          class=\"kui-popup-menu__check-space\"\n          aria-hidden=\"true\"\n        />\n      ) : null}\n      {entry.icon ? (\n        <span slot=\"icon\" class=\"kui-popup-menu__icon\">\n          {entry.icon}\n        </span>\n      ) : null}\n      {entry.label}\n      {entry.details ? (\n        <span slot=\"details\" class=\"kui-popup-menu__details\">\n          {entry.details}\n        </span>\n      ) : entry.submenu ? (\n        <span slot=\"details\" />\n      ) : null}\n      {entry.submenu?.map((child) =>\n        renderEntry(child, true, submenuHasChoice),\n      )}\n    </wa-dropdown-item>\n  );\n}\n\n/** A rendered context PopupMenu with Web Awesome's controlled open state. */\nexport type PopupMenuElement = HTMLElement & { open: boolean };\n\n/** The Web Awesome popup inside an upgraded `wa-dropdown`, which accepts a virtual anchor. */\ntype PopupMenuPopup = HTMLElement & { anchor?: unknown; placement: string };\n\n/** Pending trigger-anchor restorations of pointer-opened button menus. */\nconst pointerRestores = new WeakMap<HTMLElement, (event: Event) => void>();\n\n/**\n * Open a PopupMenu at viewport pointer coordinates. A `context` menu rendered\n * without `anchor` moves its invisible anchor there (a menu rendered with\n * `anchor` opens with `openPopupMenu` instead). A button-triggered menu (such as a `ListActionRow`\n * trailing menu) anchors its popup at the point, opening `bottom-start` like a\n * context menu, for this opening only; once the menu has closed it returns to\n * its trigger and placement. Before Web Awesome upgrades it, the menu opens at\n * its trigger.\n */\nexport function openPopupMenuAt(\n  menu: PopupMenuElement,\n  x: number,\n  y: number,\n): void {\n  menu.style.setProperty('--kui-popup-menu-context-x', `${x}px`);\n  menu.style.setProperty('--kui-popup-menu-context-y', `${y}px`);\n  const popup =\n    menu.getAttribute('data-trigger') === 'context'\n      ? null\n      : menu.shadowRoot?.querySelector<PopupMenuPopup>('wa-popup');\n  if (popup) {\n    popup.anchor = {\n      getBoundingClientRect: () => new DOMRect(x, y, 0, 0),\n    };\n    popup.placement = 'bottom-start';\n    const previous = pointerRestores.get(menu);\n    if (previous) menu.removeEventListener('wa-after-hide', previous);\n    const restore = (event: Event) => {\n      if (event.target !== menu) return;\n      menu.removeEventListener('wa-after-hide', restore);\n      pointerRestores.delete(menu);\n      popup.anchor = undefined;\n      popup.placement = menu.getAttribute('placement') ?? 'bottom-start';\n    };\n    pointerRestores.set(menu, restore);\n    menu.addEventListener('wa-after-hide', restore);\n  }\n  menu.open = true;\n}\n\n/**\n * Open a context PopupMenu at the `anchor` it was rendered with (or the\n * point a previous `openPopupMenuAt` set).\n */\nexport function openPopupMenu(menu: PopupMenuElement): void {\n  menu.open = true;\n}\n\n/** Close a programmatically opened PopupMenu. */\nexport function closePopupMenu(menu: PopupMenuElement): void {\n  menu.open = false;\n}\n\ninterface PopupMenuContentProps {\n  context: boolean;\n  label: string | undefined;\n  icon: KerfUiContent;\n  text: string | undefined;\n  caret: boolean;\n  disabled: boolean;\n  items: readonly PopupMenuEntry[];\n}\n\n/** The trigger and entries: everything inside the `wa-dropdown` root. */\nfunction renderContent({\n  context,\n  label,\n  icon,\n  text,\n  caret,\n  disabled,\n  items,\n}: PopupMenuContentProps): SafeHtml {\n  const levelHasChoice = hasChoice(items);\n  return (\n    <>\n      {context ? (\n        <button\n          type=\"button\"\n          slot=\"trigger\"\n          class=\"kui-popup-menu__context-anchor\"\n          aria-label={label}\n          aria-hidden=\"true\"\n          tabindex={-1}\n        />\n      ) : (\n        <wa-button\n          slot=\"trigger\"\n          appearance=\"plain\"\n          with-caret={caret}\n          disabled={disabled}\n        >\n          {icon}\n          {text ? (\n            <span>{text}</span>\n          ) : (\n            <span class=\"kui-popup-menu__label\">{label}</span>\n          )}\n        </wa-button>\n      )}\n      {items.map((entry) => renderEntry(entry, false, levelHasChoice))}\n    </>\n  );\n}\n\n/**\n * An action menu: a trigger button that opens a list of commands. Renders the\n * `wa-dropdown` root directly, so a `single` `ToolbarControlGroup` (with\n * `nestedDropdown`) or a `PopupSurface` sizes and insets it as usual. Items\n * dispatch through delegated `data-action`s; the app owns the commands and any\n * open-state reaction. Import `@kerfjs/ui/popup-menu/register` once to register\n * the Web Awesome elements. At viewport widths up to 480px, submenus appear\n * above or below their parent menu so their rows do not cover the parent list.\n */\nexport function PopupMenu({\n  text,\n  label,\n  icon,\n  items,\n  placement = 'bottom-start',\n  caret = true,\n  disabled = false,\n  rootAttributes = {},\n  slot,\n  context = false,\n  anchor,\n}: PopupMenuProps) {\n  if (\n    anchor !== undefined &&\n    (!context || !Number.isFinite(anchor.x) || !Number.isFinite(anchor.y))\n  )\n    throw new RangeError(\n      'PopupMenu anchor requires context mode and finite x and y coordinates',\n    );\n  // Web Awesome owns the trigger and item DOM once upgraded, so the morph\n  // skips the children; the content key rebuilds the menu when they change.\n  // An unchanged menu reuses its cached markup and costs one hash pass.\n  const { key, cacheKey } = popupMenuContentKey(\n    [\n      text ?? '',\n      label ?? '',\n      String(icon ?? ''),\n      String(caret),\n      String(disabled),\n      String(context),\n    ],\n    items,\n  );\n  let content = cachedPopupMenuContent(cacheKey);\n  if (!content) {\n    content = renderContent({\n      context,\n      label,\n      icon,\n      text,\n      caret,\n      disabled,\n      items,\n    });\n    cachePopupMenuContent(cacheKey, content);\n  }\n  // data-menu-label names the shadow role=\"menu\" panel (the register copies\n  // it there), since no ID reference reaches the trigger across shadow roots.\n  // size=\"m\" is Web Awesome's reflected default; rendering it keeps a\n  // re-render's morph from stripping it and forcing a Lit update.\n  return (\n    <wa-dropdown\n      size=\"m\"\n      {...rootAttributes}\n      class=\"kui-popup-menu\"\n      data-component=\"popup-menu\"\n      data-key={key}\n      data-morph-skip-children\n      data-trigger={context ? 'context' : 'button'}\n      data-menu-label={text ?? label}\n      style={\n        anchor\n          ? `--kui-popup-menu-context-x:${anchor.x}px;--kui-popup-menu-context-y:${anchor.y}px`\n          : undefined\n      }\n      placement={placement}\n      slot={slot}\n    >\n      {content}\n    </wa-dropdown>\n  );\n}\n"]}

package/dist/chunk-HZPHCSCS.js

@@ -0,0 +1,95 @@
+import { verticalAlignment, horizontalAlignment } from './chunk-MXNIVEVL.js';
+import { gapLength } from './chunk-MHMWQ7RB.js';
+import { filterRootAttributes } from './chunk-KH4KEMSP.js';
+import { jsx } from 'kerfjs/jsx-runtime';
+
+var listGridAttributes = ["role", "aria-label", "aria-multiselectable"];
+var listProtectedAttributes = /* @__PURE__ */ new Set([
+  "data-component",
+  "data-gap",
+  "data-flex",
+  "data-fill",
+  "data-h-align",
+  "data-v-align",
+  "data-scrollable",
+  "data-scroll-clearance",
+  "data-frame",
+  "data-surface",
+  "data-inset",
+  "data-text-insets",
+  "data-control-insets"
+]);
+function List({
+  children,
+  selectionMode,
+  ariaLabel,
+  gap = false,
+  flex = false,
+  fill = false,
+  hAlign = "full",
+  vAlign = "top",
+  scrollable = false,
+  scrollClearance,
+  frame = false,
+  maxHeight,
+  minHeight,
+  surface,
+  inset,
+  dividerSides = "",
+  textInsets = "",
+  controlInsets = "",
+  className = "",
+  rootAttributes = {},
+  slot
+}) {
+  if (selectionMode === "multiple" && !ariaLabel) {
+    throw new Error("Multi-select List requires an ariaLabel");
+  }
+  const multiple = selectionMode === "multiple";
+  const safeRootAttributes = filterRootAttributes(
+    rootAttributes,
+    multiple ? /* @__PURE__ */ new Set([...listProtectedAttributes, ...listGridAttributes]) : listProtectedAttributes
+  );
+  const gridAttributes = multiple ? {
+    role: "grid",
+    "aria-label": ariaLabel,
+    "aria-multiselectable": "true"
+  } : {};
+  const gapStyle = gap === true ? "--_kui-list-gap:var(--kui-list-gap)" : gap === false ? "" : typeof gap === "string" ? `--_kui-list-gap:${gapLength(gap)}` : `--_kui-list-column-gap:${gapLength(gap.column)};--_kui-list-row-gap:${gapLength(gap.row)}`;
+  const flexValue = flex === true ? "1 1 auto" : flex || void 0;
+  const style = [
+    gapStyle,
+    flexValue ? `--_kui-list-flex:${flexValue}` : "",
+    maxHeight === void 0 ? "" : `--_kui-list-max-height:${maxHeight}`,
+    minHeight === void 0 ? "" : `--_kui-list-min-height:${minHeight}`
+  ].filter(Boolean).join(";");
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...safeRootAttributes,
+      ...gridAttributes,
+      class: `kui-list ${className}`.trim(),
+      "data-component": "list",
+      "data-gap": String(Boolean(gap)),
+      "data-flex": String(Boolean(flex)),
+      "data-fill": fill ? "true" : void 0,
+      "data-h-align": horizontalAlignment(hAlign),
+      "data-v-align": verticalAlignment(vAlign),
+      "data-scrollable": String(scrollable),
+      "data-scroll-clearance": scrollClearance,
+      "data-frame": frame ? "true" : void 0,
+      "data-surface": surface,
+      "data-inset": inset,
+      "divider-sides": dividerSides || void 0,
+      "data-text-insets": textInsets || void 0,
+      "data-control-insets": controlInsets || void 0,
+      style: style || void 0,
+      slot,
+      children
+    }
+  );
+}
+
+export { List };
+
+//# sourceMappingURL=chunk-HZPHCSCS.js.map

package/dist/chunk-HZPHCSCS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/collections/list/list.tsx"],"names":[],"mappings":"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","file":"chunk-HZPHCSCS.js","sourcesContent":["import type { KerfUiContent } from '../../../shared/content/semantic-content.js';\nimport {\n  filterRootAttributes,\n  type StructuralRootAttributes,\n} from '../../../shared/dom/extension-attributes.js';\nimport {\n  type HorizontalAlignment,\n  horizontalAlignment,\n  type ListVerticalAlignment,\n  verticalAlignment,\n} from '../../../shared/layout/flex-alignment.js';\nimport { gapLength } from '../../../shared/layout/gap.js';\nimport type { ScrollClearance } from '../../../shared/layout/scroll-clearance.js';\nimport type { Sides } from '../../../shared/layout/sides.js';\nimport {\n  type CssFlex,\n  type CssFlexKeyword,\n  type CssLength,\n  type UiGap,\n} from '../../../shared/styles/css-values.js';\n\n/** Attributes a multi-select List owns as an ARIA grid. */\nconst listGridAttributes = ['role', 'aria-label', 'aria-multiselectable'];\n\nconst listProtectedAttributes = new Set([\n  'data-component',\n  'data-gap',\n  'data-flex',\n  'data-fill',\n  'data-h-align',\n  'data-v-align',\n  'data-scrollable',\n  'data-scroll-clearance',\n  'data-frame',\n  'data-surface',\n  'data-inset',\n  'data-text-insets',\n  'data-control-insets',\n]);\n\ntype ListRootAttributes = StructuralRootAttributes &\n  Readonly<{\n    'data-component'?: never;\n    'data-gap'?: never;\n    'data-flex'?: never;\n    'data-fill'?: never;\n    'data-h-align'?: never;\n    'data-v-align'?: never;\n    'data-scrollable'?: never;\n    'data-scroll-clearance'?: never;\n    'data-frame'?: never;\n    'data-surface'?: never;\n    'data-inset'?: never;\n    'data-text-insets'?: never;\n    'data-control-insets'?: never;\n  }>;\n\n/**\n * A solid surface painted behind a List: `base` is the page surface\n * (`--kui-color-surface`), `raised` the raised surface\n * (`--kui-color-surface-raised`). A lowered region is a `SunkenPanel`.\n */\nexport type ListSurface = 'base' | 'raised';\n\n/**\n * A preset inset on all four sides. `document` is the reading inset for long\n * content such as a reader view: 24px block and 32px inline, narrowing to\n * 16px inline below 576px. It replaces any `textInsets`/`controlInsets`.\n */\nexport type ListInset = 'document';\n\nexport interface ListProps {\n  children?: KerfUiContent;\n  /** Make this list a labeled multi-select grid for `ContentItem selectionMode=\"multiple\"` rows. */\n  selectionMode?: 'multiple';\n  /** Accessible name for the multi-select grid. */\n  ariaLabel?: string;\n  /** Standard gap (`true`), one spacing value, or separate column and row values. Defaults to no gap. */\n  gap?: boolean | UiGap;\n  /** Allow this list to grow/shrink, use a keyword, or supply a typed CSS flex shorthand. */\n  flex?: boolean | CssFlexKeyword | CssFlex;\n  /**\n   * Fill the height of a parent with a definite height, such as an app root or\n   * a fixed-height frame, when this list is that parent's layout root. Inside a\n   * flex layout use `flex` instead. Defaults to false.\n   */\n  fill?: boolean;\n  /** Horizontal alignment. Defaults to full to preserve stretch-aligned list children. */\n  hAlign?: HorizontalAlignment;\n  /** Vertical distribution. Defaults to top. */\n  vAlign?: ListVerticalAlignment;\n  /**\n   * Own vertical scrolling and overscroll containment. Children keep their\n   * natural height and scroll instead of shrinking. To bound the list by a\n   * `max-height` ancestor (no definite height), give that ancestor a flex\n   * column and use `flex`; `fill` needs a definite-height parent.\n   */\n  scrollable?: boolean;\n  /**\n   * Clear chrome that lies over this scrollable List's block-start and/or\n   * block-end edge, such as a `DialogSurface` floating footer. The List adds\n   * the inherited `--kui-scroll-clearance-block-*` context that chrome\n   * publishes to its own block padding and `scroll-padding`, so its rows\n   * scroll visibly beneath the chrome while the first and last rows (and any\n   * row focused or scrolled into view) can still rest clear of it. Opt in only\n   * the one scroller that reaches the covered edge. Defaults to none.\n   */\n  scrollClearance?: ScrollClearance;\n  /**\n   * Draw a bordered, rounded frame around the stack: a 1px neutral border,\n   * the standard control radius, and a 4px inset on every side that keeps the\n   * first and last rows' focus rings inside a scrolling frame's clip. It\n   * replaces any `inset`/`textInsets`/`controlInsets`. With `scrollable` and\n   * `maxHeight` it is a bounded result picker of `ListItem` rows.\n   */\n  frame?: boolean;\n  /**\n   * The List's maximum block size, a typed `CssLength` from\n   * `@kerfjs/ui/css-values` (such as `rem(14)`). Pair it with `scrollable` so\n   * rows beyond it scroll; it bounds the List without a flex-column ancestor.\n   */\n  maxHeight?: CssLength;\n  /**\n   * The List's minimum block size, a typed `CssLength` (such as `rem(4.25)`),\n   * so a short or empty result set keeps a stable box. Defaults to no minimum.\n   */\n  minHeight?: CssLength;\n  /**\n   * Paint a solid surface behind the stack, including its insets: for a strip\n   * of chrome (a banner above a sunken work area) that must not show the\n   * lowered tint around its content. Omitted, the List is transparent.\n   */\n  surface?: ListSurface;\n  /** Physical divider edges in canonical top/right/bottom/left order. */\n  dividerSides?: Sides;\n  /** A preset four-sided inset; see `ListInset`. */\n  inset?: ListInset;\n  /** Physical sides that receive the standard 17px text inset. */\n  textInsets?: Sides;\n  /** Physical sides that receive the standard 8px control inset. Text insets win on overlap. */\n  controlInsets?: Sides;\n  className?: string;\n  /**\n   * Safe `data-*`, `aria-*`, and structural `role` metadata (a named drop\n   * `region`, `aria-busy`); List-owned structural attributes remain\n   * protected, and a multi-select List owns its grid role and name.\n   */\n  rootAttributes?: ListRootAttributes;\n  /** Native named-slot assignment when composed inside a web component. */\n  slot?: string;\n}\n\n/**\n * A list's configuration, apart from its content and styling hooks: the props a\n * composite that renders a `List` for the app (the Workbench's `mainHeader` /\n * `mainFooter` chrome) forwards, so the app configures that list instead of\n * styling it. An omitted or `undefined` field keeps the composite's default.\n */\nexport type ListConfig = Pick<\n  ListProps,\n  'gap' | 'hAlign' | 'vAlign' | 'dividerSides' | 'textInsets' | 'controlInsets'\n>;\n\n/** A stretch-aligned vertical stack with optional gap, flex, fill, scroll, and dividers. */\nexport function List({\n  children,\n  selectionMode,\n  ariaLabel,\n  gap = false,\n  flex = false,\n  fill = false,\n  hAlign = 'full',\n  vAlign = 'top',\n  scrollable = false,\n  scrollClearance,\n  frame = false,\n  maxHeight,\n  minHeight,\n  surface,\n  inset,\n  dividerSides = '',\n  textInsets = '',\n  controlInsets = '',\n  className = '',\n  rootAttributes = {},\n  slot,\n}: ListProps) {\n  if (selectionMode === 'multiple' && !ariaLabel) {\n    throw new Error('Multi-select List requires an ariaLabel');\n  }\n  const multiple = selectionMode === 'multiple';\n  const safeRootAttributes = filterRootAttributes(\n    rootAttributes,\n    multiple\n      ? new Set([...listProtectedAttributes, ...listGridAttributes])\n      : listProtectedAttributes,\n  );\n  const gridAttributes = multiple\n    ? {\n        role: 'grid',\n        'aria-label': ariaLabel,\n        'aria-multiselectable': 'true',\n      }\n    : {};\n  const gapStyle =\n    gap === true\n      ? '--_kui-list-gap:var(--kui-list-gap)'\n      : gap === false\n        ? ''\n        : typeof gap === 'string'\n          ? `--_kui-list-gap:${gapLength(gap)}`\n          : `--_kui-list-column-gap:${gapLength(gap.column)};--_kui-list-row-gap:${gapLength(gap.row)}`;\n  const flexValue = flex === true ? '1 1 auto' : flex || undefined;\n  const style = [\n    gapStyle,\n    flexValue ? `--_kui-list-flex:${flexValue}` : '',\n    maxHeight === undefined ? '' : `--_kui-list-max-height:${maxHeight}`,\n    minHeight === undefined ? '' : `--_kui-list-min-height:${minHeight}`,\n  ]\n    .filter(Boolean)\n    .join(';');\n\n  return (\n    <div\n      {...safeRootAttributes}\n      {...gridAttributes}\n      class={`kui-list ${className}`.trim()}\n      data-component=\"list\"\n      data-gap={String(Boolean(gap))}\n      data-flex={String(Boolean(flex))}\n      data-fill={fill ? 'true' : undefined}\n      data-h-align={horizontalAlignment(hAlign)}\n      data-v-align={verticalAlignment(vAlign)}\n      data-scrollable={String(scrollable)}\n      data-scroll-clearance={scrollClearance}\n      data-frame={frame ? 'true' : undefined}\n      data-surface={surface}\n      data-inset={inset}\n      divider-sides={dividerSides || undefined}\n      data-text-insets={textInsets || undefined}\n      data-control-insets={controlInsets || undefined}\n      style={style || undefined}\n      slot={slot}\n    >\n      {children}\n    </div>\n  );\n}\n\nexport type {\n  HorizontalAlignment,\n  ListVerticalAlignment,\n  VerticalAlignment,\n} from '../../../shared/layout/flex-alignment.js';\nexport type { ScrollClearance } from '../../../shared/layout/scroll-clearance.js';\nexport type { Sides } from '../../../shared/layout/sides.js';\nexport type {\n  CssFlex,\n  CssFlexKeyword,\n  CssLength,\n  UiGap,\n  UiGapValue,\n  UiSpaceName,\n} from '../../../shared/styles/css-values.js';\n"]}

package/dist/chunk-IKS72C6P.js

@@ -0,0 +1,53 @@
+// src/shared/styles/sunken-texture.ts
+var SUNKEN_TEXTURE_PROPERTY = "--_kui-sunken-texture-generated";
+var TILE = 100;
+var MAX_OPACITY = 0.04;
+var SEED = 7;
+function random(seed) {
+  let state = seed >>> 0;
+  return () => {
+    state = state + 1831565813 >>> 0;
+    let value = state;
+    value = Math.imul(value ^ value >>> 15, value | 1);
+    value ^= value + Math.imul(value ^ value >>> 7, value | 61);
+    return ((value ^ value >>> 14) >>> 0) / 4294967296;
+  };
+}
+function sunkenTexturePixels() {
+  const next = random(SEED);
+  const pixels = new Uint8ClampedArray(TILE * TILE * 4);
+  for (let index = 0; index < TILE * TILE; index += 1) {
+    const u = 1 - next();
+    const v = next();
+    const gaussian = Math.sqrt(-2 * Math.log(u)) * Math.cos(2 * Math.PI * v);
+    const strength = Math.max(-1, Math.min(1, gaussian / 2.5));
+    const channel = strength < 0 ? 0 : 255;
+    const offset = index * 4;
+    pixels[offset] = channel;
+    pixels[offset + 1] = channel;
+    pixels[offset + 2] = channel;
+    pixels[offset + 3] = Math.round(Math.abs(strength) * MAX_OPACITY * 255);
+  }
+  return pixels;
+}
+function sunkenTextureDataUrl(doc = globalThis.document) {
+  const canvas = doc?.createElement("canvas");
+  const context = canvas?.getContext("2d");
+  if (!canvas || !context) return void 0;
+  canvas.width = TILE;
+  canvas.height = TILE;
+  const image = context.createImageData(TILE, TILE);
+  image.data.set(sunkenTexturePixels());
+  context.putImageData(image, 0, 0);
+  return canvas.toDataURL("image/png");
+}
+function ensureSunkenTexture(doc = globalThis.document) {
+  const root = doc?.documentElement;
+  if (!root || root.style.getPropertyValue(SUNKEN_TEXTURE_PROPERTY)) return;
+  const url = sunkenTextureDataUrl(doc);
+  if (url) root.style.setProperty(SUNKEN_TEXTURE_PROPERTY, `url("${url}")`);
+}
+
+export { ensureSunkenTexture };
+
+//# sourceMappingURL=chunk-IKS72C6P.js.map

package/dist/chunk-IKS72C6P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/styles/sunken-texture.ts"],"names":[],"mappings":"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","file":"chunk-IKS72C6P.js","sourcesContent":["/**\n * The sunken-surface noise texture: a seeded 100×100 Gaussian grain tile,\n * drawn once per document at runtime and layered over the lowered surface by\n * `--kui-sunken-surface` (foundation.css). Nothing ships as an asset.\n */\n\n/** The private property the generated tile is stored in on `<html>`. */\nexport const SUNKEN_TEXTURE_PROPERTY = '--_kui-sunken-texture-generated';\n\n/** Tile edge in pixels; foundation.css repeats it at the same CSS size. */\nconst TILE = 100;\n/** Strongest grain opacity: the reviewed \"Gaussian 4%\" treatment. */\nconst MAX_OPACITY = 0.04;\nconst SEED = 7;\n\n/** A small deterministic PRNG (mulberry32), so every page draws the same tile. */\nfunction random(seed: number): () => number {\n  let state = seed >>> 0;\n  return () => {\n    state = (state + 0x6d2b79f5) >>> 0;\n    let value = state;\n    value = Math.imul(value ^ (value >>> 15), value | 1);\n    value ^= value + Math.imul(value ^ (value >>> 7), value | 61);\n    return ((value ^ (value >>> 14)) >>> 0) / 4294967296;\n  };\n}\n\n/**\n * The tile's RGBA pixels: monochrome grains, darker below and lighter above\n * the surface, with Gaussian strength clipped at 2.5σ.\n */\nexport function sunkenTexturePixels(): Uint8ClampedArray {\n  const next = random(SEED);\n  const pixels = new Uint8ClampedArray(TILE * TILE * 4);\n  for (let index = 0; index < TILE * TILE; index += 1) {\n    // Box-Muller; the first uniform is kept off zero for the logarithm.\n    const u = 1 - next();\n    const v = next();\n    const gaussian = Math.sqrt(-2 * Math.log(u)) * Math.cos(2 * Math.PI * v);\n    const strength = Math.max(-1, Math.min(1, gaussian / 2.5));\n    const channel = strength < 0 ? 0 : 255;\n    const offset = index * 4;\n    pixels[offset] = channel;\n    pixels[offset + 1] = channel;\n    pixels[offset + 2] = channel;\n    pixels[offset + 3] = Math.round(Math.abs(strength) * MAX_OPACITY * 255);\n  }\n  return pixels;\n}\n\n/** Draw the tile and return it as a PNG data URL, or undefined without a 2D canvas. */\nexport function sunkenTextureDataUrl(\n  doc: Document = globalThis.document,\n): string | undefined {\n  const canvas = doc?.createElement('canvas');\n  const context = canvas?.getContext('2d');\n  if (!canvas || !context) return undefined;\n  canvas.width = TILE;\n  canvas.height = TILE;\n  const image = context.createImageData(TILE, TILE);\n  image.data.set(sunkenTexturePixels());\n  context.putImageData(image, 0, 0);\n  return canvas.toDataURL('image/png');\n}\n\n/**\n * Generate the sunken texture once for a document. Sunken surfaces call this\n * as they render; it is idempotent, and on a server (no document) or without\n * a 2D canvas it does nothing, leaving the flat lowered surface.\n */\nexport function ensureSunkenTexture(\n  doc: Document | undefined = globalThis.document,\n): void {\n  const root = doc?.documentElement;\n  if (!root || root.style.getPropertyValue(SUNKEN_TEXTURE_PROPERTY)) return;\n  const url = sunkenTextureDataUrl(doc);\n  if (url) root.style.setProperty(SUNKEN_TEXTURE_PROPERTY, `url(\"${url}\")`);\n}\n"]}