@hadoku/task-ui-components 0.0.0-stage → 4.20.3

package/dist/index.js

@@ -0,0 +1,72 @@
+import { HadokuThemePicker } from "./components/HadokuThemePicker.js";
+import { AppHeader } from "./components/AppHeader.js";
+import { ConnectedSettings } from "./components/ConnectedSettings.js";
+import { CoffeeIcon, FlowerIcon, HadokuThemeProvider, HeartIcon, LanternIcon, LeafIcon, MoonIcon, StrawberryIcon, SunIcon, WaveIcon, ZapIcon, useHadokuTheme, useHadokuThemeOptional } from "@wolffm/themes";
+import { Toast } from "./components/Toast.js";
+import { Toaster } from "./components/Toaster.js";
+import { Modal } from "./components/Modal.js";
+import { ContextMenu } from "./components/ContextMenu.js";
+import { LoadingSkeleton } from "./components/LoadingSkeleton.js";
+import { SettingsModal } from "./components/SettingsModal.js";
+import { Button } from "./components/Button.js";
+import { NativeSelect, Select } from "./components/Select.js";
+import { NumberInput } from "./components/NumberInput.js";
+import { Tooltip } from "./components/Tooltip.js";
+import { installTitleTooltips } from "./lib/titleTooltips.js";
+import { installSelectMenus } from "./lib/selectMenus.js";
+import { BentoGrid } from "./components/BentoGrid.js";
+import { BentoCard } from "./components/BentoCard.js";
+import { useToast } from "./hooks/useToast.js";
+import { useReducedMotion } from "./hooks/useReducedMotion.js";
+import { CircleIcon, DiamondIcon, FALLBACK_ICONS, HexagonIcon, OctagonIcon, PentagonIcon, SettingsIcon, SquareIcon, StarIcon, TagIcon, TriangleIcon, getFallbackIcon } from "./components/ThemeIcons.js";
+import { loadSignIn, switchKeyHref } from "./lib/settingsClient.js";
+export {
+  AppHeader,
+  BentoCard,
+  BentoGrid,
+  Button,
+  CircleIcon,
+  CoffeeIcon,
+  ConnectedSettings,
+  ContextMenu,
+  DiamondIcon,
+  FALLBACK_ICONS,
+  FlowerIcon,
+  HadokuThemePicker,
+  HadokuThemeProvider,
+  HeartIcon,
+  HexagonIcon,
+  LanternIcon,
+  LeafIcon,
+  LoadingSkeleton,
+  Modal,
+  MoonIcon,
+  NativeSelect,
+  NumberInput,
+  OctagonIcon,
+  PentagonIcon,
+  Select,
+  SettingsIcon,
+  SettingsModal,
+  SquareIcon,
+  StarIcon,
+  StrawberryIcon,
+  SunIcon,
+  TagIcon,
+  Toast,
+  Toaster,
+  Tooltip,
+  TriangleIcon,
+  WaveIcon,
+  ZapIcon,
+  getFallbackIcon,
+  installSelectMenus,
+  installTitleTooltips,
+  loadSignIn,
+  switchKeyHref,
+  useHadokuTheme,
+  useHadokuThemeOptional,
+  useReducedMotion,
+  useToast
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}

package/dist/lib/menuPlacement.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Where a dropdown list goes under (or over) its trigger, shared by <Select>
+ * and installSelectMenus so both lists sit and flip identically.
+ */
+export declare const MENU_GAP = 4;
+export declare const MENU_MAX_HEIGHT = 280;
+export interface MenuPosition {
+    left: number;
+    width: number;
+    top?: number;
+    bottom?: number;
+    maxHeight: number;
+}
+/** `listHeight` is the list's full scrollHeight, so a short list never flips. */
+export declare function placeMenu(rect: DOMRect, listHeight: number): MenuPosition;
+//# sourceMappingURL=menuPlacement.d.ts.map

package/dist/lib/menuPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuPlacement.d.ts","sourceRoot":"","sources":["../../src/lib/menuPlacement.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,QAAQ,IAAI,CAAA;AACzB,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAazE"}

package/dist/lib/menuPlacement.js

@@ -0,0 +1,19 @@
+const MENU_GAP = 4;
+const MENU_MAX_HEIGHT = 280;
+function placeMenu(rect, listHeight) {
+  const below = window.innerHeight - rect.bottom - MENU_GAP;
+  const above = rect.top - MENU_GAP;
+  const flip = below < Math.min(MENU_MAX_HEIGHT, listHeight) && above > below;
+  return {
+    left: rect.left,
+    width: rect.width,
+    ...flip ? { bottom: window.innerHeight - rect.top + MENU_GAP } : { top: rect.bottom + MENU_GAP },
+    maxHeight: Math.max(120, Math.min(MENU_MAX_HEIGHT, flip ? above : below) - 8)
+  };
+}
+export {
+  MENU_GAP,
+  MENU_MAX_HEIGHT,
+  placeMenu
+};
+//# sourceMappingURL=menuPlacement.js.map

package/dist/lib/menuPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuPlacement.js","sources":["../../src/lib/menuPlacement.ts"],"sourcesContent":["/**\n * Where a dropdown list goes under (or over) its trigger, shared by <Select>\n * and installSelectMenus so both lists sit and flip identically.\n */\n\nexport const MENU_GAP = 4\nexport const MENU_MAX_HEIGHT = 280\n\nexport interface MenuPosition {\n  left: number\n  width: number\n  top?: number\n  bottom?: number\n  maxHeight: number\n}\n\n/** `listHeight` is the list's full scrollHeight, so a short list never flips. */\nexport function placeMenu(rect: DOMRect, listHeight: number): MenuPosition {\n  const below = window.innerHeight - rect.bottom - MENU_GAP\n  const above = rect.top - MENU_GAP\n  // Flip up only when the list does not fit below AND there is more room above.\n  const flip = below < Math.min(MENU_MAX_HEIGHT, listHeight) && above > below\n  return {\n    left: rect.left,\n    width: rect.width,\n    ...(flip\n      ? { bottom: window.innerHeight - rect.top + MENU_GAP }\n      : { top: rect.bottom + MENU_GAP }),\n    maxHeight: Math.max(120, Math.min(MENU_MAX_HEIGHT, flip ? above : below) - 8)\n  }\n}\n"],"names":[],"mappings":"AAKO,MAAM,WAAW;AACjB,MAAM,kBAAkB;AAWxB,SAAS,UAAU,MAAe,YAAkC;AACzE,QAAM,QAAQ,OAAO,cAAc,KAAK,SAAS;AACjD,QAAM,QAAQ,KAAK,MAAM;AAEzB,QAAM,OAAO,QAAQ,KAAK,IAAI,iBAAiB,UAAU,KAAK,QAAQ;AACtE,SAAO;AAAA,IACL,MAAM,KAAK;AAAA,IACX,OAAO,KAAK;AAAA,IACZ,GAAI,OACA,EAAE,QAAQ,OAAO,cAAc,KAAK,MAAM,SAAA,IAC1C,EAAE,KAAK,KAAK,SAAS,SAAA;AAAA,IACzB,WAAW,KAAK,IAAI,KAAK,KAAK,IAAI,iBAAiB,OAAO,QAAQ,KAAK,IAAI,CAAC;AAAA,EAAA;AAEhF;"}

package/dist/lib/selectMenus.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The themed list for every native <select> on a page, with no change to the
+ * markup.
+ *
+ *   import { installSelectMenus } from '@wolffm/task-ui-components/select-menus'
+ *   import '@wolffm/task-ui-components/select.css'
+ *   installSelectMenus()
+ *
+ * hadoku_site calls this once from its shell, which covers every
+ * micro-frontend; an app does not call it itself. Framework-free and
+ * React-free, like installTitleTooltips, for the same reason.
+ *
+ * A native select's closed box takes CSS, but its open list is drawn by the
+ * OS and takes almost none. So a mouse press or an opening key on the select
+ * is intercepted (preventDefault on mousedown is what stops the OS list) and
+ * the same list <Select> renders opens instead, built from the select's own
+ * <option>s and <optgroup>s at that moment.
+ *
+ * The <select> stays the source of truth. Choosing sets its selectedIndex and
+ * fires `input` and `change` exactly as the OS list would, so every framework
+ * (React's onChange included) and every plain listener sees an ordinary
+ * change, and a form still submits the select's value.
+ *
+ * Left native on purpose:
+ *   - touch: a phone's own picker is the better control there
+ *   - `multiple` or `size > 1`, which render as an inline list, not a popup
+ *   - anything under `data-native-select`
+ */
+export declare function installSelectMenus(): () => void;
+//# sourceMappingURL=selectMenus.d.ts.map

package/dist/lib/selectMenus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectMenus.d.ts","sourceRoot":"","sources":["../../src/lib/selectMenus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA0BH,wBAAgB,kBAAkB,IAAI,MAAM,IAAI,CAyP/C"}

package/dist/lib/selectMenus.js

@@ -0,0 +1,236 @@
+import { themeScopeOf } from "./themeScope.js";
+import { placeMenu } from "./menuPlacement.js";
+const TYPEAHEAD_RESET_MS = 600;
+const LIST_ID = "hdk-select-menu";
+const CHECK_SVG = '<svg class="hdk-icon hdk-select__check" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10" /><path d="m9 12 2 2 4-4" /></svg>';
+const OPEN_KEYS = /* @__PURE__ */ new Set(["ArrowDown", "ArrowUp", " ", "F4"]);
+let uninstallCurrent = null;
+function eligible(el) {
+  return el instanceof HTMLSelectElement && !el.multiple && el.size <= 1 && !el.disabled && !el.closest("[data-native-select]");
+}
+function installSelectMenus() {
+  if (uninstallCurrent) return uninstallCurrent;
+  let lastPointer = "mouse";
+  let select = null;
+  let list = null;
+  let options = [];
+  let items = [];
+  let active = -1;
+  const typeahead = { text: "", at: 0 };
+  function setActive(i) {
+    if (items[active]) items[active].classList.remove("hdk-select__option--active");
+    active = i;
+    const item = items[i];
+    if (!item || !list) return;
+    item.classList.add("hdk-select__option--active");
+    list.setAttribute("aria-activedescendant", item.id);
+    item.scrollIntoView({ block: "nearest" });
+  }
+  function step(from, dir) {
+    for (let i = 1; i <= options.length; i++) {
+      const next = (from + dir * i + options.length) % options.length;
+      if (!isOff(next)) return next;
+    }
+    return from;
+  }
+  const edge = (dir) => step(dir === 1 ? -1 : options.length, dir);
+  function matchTypeahead(key) {
+    const now = Date.now();
+    typeahead.text = now - typeahead.at > TYPEAHEAD_RESET_MS ? key : typeahead.text + key;
+    typeahead.at = now;
+    const needle = typeahead.text.toLowerCase();
+    const start = Math.max(active, 0);
+    for (let i = 0; i < options.length; i++) {
+      const idx = (start + (typeahead.text.length === 1 ? i + 1 : i)) % options.length;
+      const o = options[idx];
+      if (!isOff(idx) && labelOf(o).toLowerCase().startsWith(needle)) return idx;
+    }
+    return -1;
+  }
+  const labelOf = (o) => o.label || o.text;
+  const isOff = (i) => options[i].disabled || options[i].parentElement?.disabled === true;
+  function place() {
+    if (!select || !list) return;
+    if (!select.isConnected) {
+      close(false);
+      return;
+    }
+    const p = placeMenu(select.getBoundingClientRect(), list.scrollHeight);
+    list.style.left = `${p.left}px`;
+    list.style.minWidth = `${p.width}px`;
+    list.style.top = p.top === void 0 ? "" : `${p.top}px`;
+    list.style.bottom = p.bottom === void 0 ? "" : `${p.bottom}px`;
+    list.style.maxHeight = `${p.maxHeight}px`;
+    list.style.visibility = "";
+  }
+  function open(el, start) {
+    close(false);
+    const scope = themeScopeOf(el);
+    if (!scope) return;
+    select = el;
+    options = Array.from(el.options).filter((o) => !o.hidden);
+    if (options.length === 0) return;
+    list = document.createElement("ul");
+    list.id = LIST_ID;
+    list.setAttribute("role", "listbox");
+    list.tabIndex = -1;
+    list.className = "hdk-select__menu hdk-scroll hdk-scroll--thin";
+    const name = el.getAttribute("aria-label") ?? el.labels?.[0]?.textContent?.trim();
+    if (name) list.setAttribute("aria-label", name);
+    const cs = getComputedStyle(el);
+    list.style.fontSize = cs.fontSize;
+    list.style.fontFamily = cs.fontFamily;
+    list.style.visibility = "hidden";
+    let group = null;
+    items = options.map((o, i) => {
+      const g = o.parentElement instanceof HTMLOptGroupElement ? o.parentElement : null;
+      if (g && g !== group) {
+        const head = document.createElement("li");
+        head.setAttribute("role", "presentation");
+        head.className = "hdk-select__group";
+        head.textContent = g.label;
+        list?.append(head);
+      }
+      group = g;
+      const item = document.createElement("li");
+      item.id = `${LIST_ID}-${i}`;
+      item.setAttribute("role", "option");
+      const selected = o.index === el.selectedIndex;
+      item.setAttribute("aria-selected", String(selected));
+      if (o.disabled || g?.disabled) item.setAttribute("aria-disabled", "true");
+      item.className = `hdk-select__option${selected ? " hdk-select__option--selected" : ""}`;
+      const text = document.createElement("span");
+      text.className = "hdk-select__option-label";
+      text.textContent = labelOf(o);
+      const wrap = document.createElement("span");
+      wrap.className = "hdk-select__option-text";
+      wrap.append(text);
+      item.append(wrap);
+      if (selected) item.insertAdjacentHTML("beforeend", CHECK_SVG);
+      item.addEventListener("pointermove", () => {
+        if (!isOff(i) && i !== active) setActive(i);
+      });
+      item.addEventListener("click", () => choose(i));
+      list?.append(item);
+      return item;
+    });
+    list.addEventListener("keydown", onListKeyDown);
+    scope.appendChild(list);
+    el.setAttribute("aria-expanded", "true");
+    el.setAttribute("aria-controls", LIST_ID);
+    const current = options.findIndex((o) => o.index === el.selectedIndex);
+    setActive(start === "last" ? edge(-1) : current >= 0 && !isOff(current) ? current : edge(1));
+    place();
+    list.focus({ preventScroll: true });
+    window.addEventListener("scroll", onScroll, true);
+    window.addEventListener("resize", place);
+  }
+  function close(refocus) {
+    window.removeEventListener("scroll", onScroll, true);
+    window.removeEventListener("resize", place);
+    list?.remove();
+    list = null;
+    if (!select) return;
+    select.removeAttribute("aria-expanded");
+    select.removeAttribute("aria-controls");
+    if (refocus) select.focus({ preventScroll: true });
+    select = null;
+    items = [];
+    options = [];
+    active = -1;
+  }
+  function choose(i) {
+    const el = select;
+    const o = options[i];
+    if (!el || !o || isOff(i)) return;
+    const changed = o.index !== el.selectedIndex;
+    close(true);
+    if (!changed) return;
+    el.selectedIndex = o.index;
+    el.dispatchEvent(new Event("input", { bubbles: true }));
+    el.dispatchEvent(new Event("change", { bubbles: true }));
+  }
+  const onScroll = (e) => {
+    if (list && e.target instanceof Node && list.contains(e.target)) return;
+    place();
+  };
+  function onListKeyDown(e) {
+    switch (e.key) {
+      case "ArrowDown":
+        e.preventDefault();
+        setActive(step(active, 1));
+        break;
+      case "ArrowUp":
+        e.preventDefault();
+        setActive(step(active, -1));
+        break;
+      case "Home":
+      case "PageUp":
+        e.preventDefault();
+        setActive(edge(1));
+        break;
+      case "End":
+      case "PageDown":
+        e.preventDefault();
+        setActive(edge(-1));
+        break;
+      case "Enter":
+      case " ":
+        e.preventDefault();
+        choose(active);
+        break;
+      case "Escape":
+        e.preventDefault();
+        e.stopPropagation();
+        close(true);
+        break;
+      case "Tab":
+        close(true);
+        break;
+      default:
+        if (e.key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey) {
+          const idx = matchTypeahead(e.key);
+          if (idx >= 0) setActive(idx);
+        }
+    }
+  }
+  const onPointerDown = (e) => {
+    lastPointer = e.pointerType;
+    const target = e.target;
+    if (list && !list.contains(target) && target !== select) close(false);
+  };
+  const onMouseDown = (e) => {
+    if (e.button !== 0 || lastPointer === "touch") return;
+    const el = e.target?.closest?.("select") ?? null;
+    if (!eligible(el)) return;
+    e.preventDefault();
+    if (select === el) {
+      close(true);
+      return;
+    }
+    el.focus({ preventScroll: true });
+    open(el);
+  };
+  const onKeyDown = (e) => {
+    const el = e.target;
+    if (!eligible(el) || select === el) return;
+    if (!OPEN_KEYS.has(e.key) || e.ctrlKey || e.metaKey) return;
+    e.preventDefault();
+    open(el, e.key === "ArrowUp" && !e.altKey ? "last" : void 0);
+  };
+  document.addEventListener("pointerdown", onPointerDown, true);
+  document.addEventListener("mousedown", onMouseDown, true);
+  document.addEventListener("keydown", onKeyDown, true);
+  uninstallCurrent = () => {
+    close(false);
+    document.removeEventListener("pointerdown", onPointerDown, true);
+    document.removeEventListener("mousedown", onMouseDown, true);
+    document.removeEventListener("keydown", onKeyDown, true);
+    uninstallCurrent = null;
+  };
+  return uninstallCurrent;
+}
+export {
+  installSelectMenus
+};
+//# sourceMappingURL=selectMenus.js.map

package/dist/lib/selectMenus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectMenus.js","sources":["../../src/lib/selectMenus.ts"],"sourcesContent":["/**\n * The themed list for every native <select> on a page, with no change to the\n * markup.\n *\n *   import { installSelectMenus } from '@wolffm/task-ui-components/select-menus'\n *   import '@wolffm/task-ui-components/select.css'\n *   installSelectMenus()\n *\n * hadoku_site calls this once from its shell, which covers every\n * micro-frontend; an app does not call it itself. Framework-free and\n * React-free, like installTitleTooltips, for the same reason.\n *\n * A native select's closed box takes CSS, but its open list is drawn by the\n * OS and takes almost none. So a mouse press or an opening key on the select\n * is intercepted (preventDefault on mousedown is what stops the OS list) and\n * the same list <Select> renders opens instead, built from the select's own\n * <option>s and <optgroup>s at that moment.\n *\n * The <select> stays the source of truth. Choosing sets its selectedIndex and\n * fires `input` and `change` exactly as the OS list would, so every framework\n * (React's onChange included) and every plain listener sees an ordinary\n * change, and a form still submits the select's value.\n *\n * Left native on purpose:\n *   - touch: a phone's own picker is the better control there\n *   - `multiple` or `size > 1`, which render as an inline list, not a popup\n *   - anything under `data-native-select`\n */\n\nimport { themeScopeOf } from './themeScope'\nimport { placeMenu } from './menuPlacement'\n\nconst TYPEAHEAD_RESET_MS = 600\nconst LIST_ID = 'hdk-select-menu'\n// `check` from the @wolffm/themes registry (Lucide circle-check), inlined so\n// this entry does not pull the whole registry into the shell.\nconst CHECK_SVG =\n  '<svg class=\"hdk-icon hdk-select__check\" width=\"1em\" height=\"1em\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"10\" /><path d=\"m9 12 2 2 4-4\" /></svg>'\n\nconst OPEN_KEYS = new Set(['ArrowDown', 'ArrowUp', ' ', 'F4'])\n\nlet uninstallCurrent: (() => void) | null = null\n\nfunction eligible(el: Element | null): el is HTMLSelectElement {\n  return (\n    el instanceof HTMLSelectElement &&\n    !el.multiple &&\n    el.size <= 1 &&\n    !el.disabled &&\n    !el.closest('[data-native-select]')\n  )\n}\n\nexport function installSelectMenus(): () => void {\n  if (uninstallCurrent) return uninstallCurrent\n\n  let lastPointer = 'mouse'\n  let select: HTMLSelectElement | null = null\n  let list: HTMLUListElement | null = null\n  let options: HTMLOptionElement[] = []\n  let items: HTMLLIElement[] = []\n  let active = -1\n  const typeahead = { text: '', at: 0 }\n\n  function setActive(i: number) {\n    if (items[active]) items[active].classList.remove('hdk-select__option--active')\n    active = i\n    const item = items[i]\n    if (!item || !list) return\n    item.classList.add('hdk-select__option--active')\n    list.setAttribute('aria-activedescendant', item.id)\n    item.scrollIntoView({ block: 'nearest' })\n  }\n\n  function step(from: number, dir: 1 | -1) {\n    for (let i = 1; i <= options.length; i++) {\n      const next = (from + dir * i + options.length) % options.length\n      if (!isOff(next)) return next\n    }\n    return from\n  }\n\n  const edge = (dir: 1 | -1) => step(dir === 1 ? -1 : options.length, dir)\n\n  function matchTypeahead(key: string) {\n    const now = Date.now()\n    typeahead.text = now - typeahead.at > TYPEAHEAD_RESET_MS ? key : typeahead.text + key\n    typeahead.at = now\n    const needle = typeahead.text.toLowerCase()\n    const start = Math.max(active, 0)\n    for (let i = 0; i < options.length; i++) {\n      // A single repeated key cycles; a longer prefix stays on the current match.\n      const idx = (start + (typeahead.text.length === 1 ? i + 1 : i)) % options.length\n      const o = options[idx]\n      if (!isOff(idx) && labelOf(o).toLowerCase().startsWith(needle)) return idx\n    }\n    return -1\n  }\n\n  const labelOf = (o: HTMLOptionElement) => o.label || o.text\n  // A disabled <optgroup> disables its options too.\n  const isOff = (i: number) =>\n    options[i].disabled ||\n    (options[i].parentElement as HTMLOptGroupElement | null)?.disabled === true\n\n  function place() {\n    if (!select || !list) return\n    if (!select.isConnected) {\n      close(false)\n      return\n    }\n    const p = placeMenu(select.getBoundingClientRect(), list.scrollHeight)\n    list.style.left = `${p.left}px`\n    list.style.minWidth = `${p.width}px`\n    list.style.top = p.top === undefined ? '' : `${p.top}px`\n    list.style.bottom = p.bottom === undefined ? '' : `${p.bottom}px`\n    list.style.maxHeight = `${p.maxHeight}px`\n    list.style.visibility = ''\n  }\n\n  function open(el: HTMLSelectElement, start?: 'last') {\n    close(false)\n    const scope = themeScopeOf(el)\n    if (!scope) return\n    select = el\n    options = Array.from(el.options).filter(o => !o.hidden)\n    if (options.length === 0) return\n\n    list = document.createElement('ul')\n    list.id = LIST_ID\n    list.setAttribute('role', 'listbox')\n    list.tabIndex = -1\n    list.className = 'hdk-select__menu hdk-scroll hdk-scroll--thin'\n    const name = el.getAttribute('aria-label') ?? el.labels?.[0]?.textContent?.trim()\n    if (name) list.setAttribute('aria-label', name)\n    // The list is portalled, so it cannot inherit the select's type size.\n    const cs = getComputedStyle(el)\n    list.style.fontSize = cs.fontSize\n    list.style.fontFamily = cs.fontFamily\n    list.style.visibility = 'hidden'\n\n    let group: HTMLOptGroupElement | null = null\n    items = options.map((o, i) => {\n      const g = o.parentElement instanceof HTMLOptGroupElement ? o.parentElement : null\n      if (g && g !== group) {\n        const head = document.createElement('li')\n        head.setAttribute('role', 'presentation')\n        head.className = 'hdk-select__group'\n        head.textContent = g.label\n        list?.append(head)\n      }\n      group = g\n      const item = document.createElement('li')\n      item.id = `${LIST_ID}-${i}`\n      item.setAttribute('role', 'option')\n      const selected = o.index === el.selectedIndex\n      item.setAttribute('aria-selected', String(selected))\n      if (o.disabled || g?.disabled) item.setAttribute('aria-disabled', 'true')\n      item.className = `hdk-select__option${selected ? ' hdk-select__option--selected' : ''}`\n      const text = document.createElement('span')\n      text.className = 'hdk-select__option-label'\n      text.textContent = labelOf(o)\n      const wrap = document.createElement('span')\n      wrap.className = 'hdk-select__option-text'\n      wrap.append(text)\n      item.append(wrap)\n      if (selected) item.insertAdjacentHTML('beforeend', CHECK_SVG)\n      item.addEventListener('pointermove', () => {\n        if (!isOff(i) && i !== active) setActive(i)\n      })\n      item.addEventListener('click', () => choose(i))\n      list?.append(item)\n      return item\n    })\n    list.addEventListener('keydown', onListKeyDown)\n    scope.appendChild(list)\n    el.setAttribute('aria-expanded', 'true')\n    el.setAttribute('aria-controls', LIST_ID)\n\n    const current = options.findIndex(o => o.index === el.selectedIndex)\n    setActive(start === 'last' ? edge(-1) : current >= 0 && !isOff(current) ? current : edge(1))\n    place()\n    list.focus({ preventScroll: true })\n    window.addEventListener('scroll', onScroll, true)\n    window.addEventListener('resize', place)\n  }\n\n  function close(refocus: boolean) {\n    window.removeEventListener('scroll', onScroll, true)\n    window.removeEventListener('resize', place)\n    list?.remove()\n    list = null\n    if (!select) return\n    select.removeAttribute('aria-expanded')\n    select.removeAttribute('aria-controls')\n    if (refocus) select.focus({ preventScroll: true })\n    select = null\n    items = []\n    options = []\n    active = -1\n  }\n\n  function choose(i: number) {\n    const el = select\n    const o = options[i]\n    if (!el || !o || isOff(i)) return\n    const changed = o.index !== el.selectedIndex\n    close(true)\n    if (!changed) return\n    el.selectedIndex = o.index\n    el.dispatchEvent(new Event('input', { bubbles: true }))\n    el.dispatchEvent(new Event('change', { bubbles: true }))\n  }\n\n  // Scrolling the list itself must not re-place (or close) it.\n  const onScroll = (e: Event) => {\n    if (list && e.target instanceof Node && list.contains(e.target)) return\n    place()\n  }\n\n  function onListKeyDown(e: KeyboardEvent) {\n    switch (e.key) {\n      case 'ArrowDown':\n        e.preventDefault()\n        setActive(step(active, 1))\n        break\n      case 'ArrowUp':\n        e.preventDefault()\n        setActive(step(active, -1))\n        break\n      case 'Home':\n      case 'PageUp':\n        e.preventDefault()\n        setActive(edge(1))\n        break\n      case 'End':\n      case 'PageDown':\n        e.preventDefault()\n        setActive(edge(-1))\n        break\n      case 'Enter':\n      case ' ':\n        e.preventDefault()\n        choose(active)\n        break\n      case 'Escape':\n        // Stop here so an enclosing modal does not close along with the list.\n        e.preventDefault()\n        e.stopPropagation()\n        close(true)\n        break\n      case 'Tab':\n        close(true)\n        break\n      default:\n        if (e.key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey) {\n          const idx = matchTypeahead(e.key)\n          if (idx >= 0) setActive(idx)\n        }\n    }\n  }\n\n  const onPointerDown = (e: PointerEvent) => {\n    lastPointer = e.pointerType\n    const target = e.target as Node\n    if (list && !list.contains(target) && target !== select) close(false)\n  }\n\n  const onMouseDown = (e: MouseEvent) => {\n    if (e.button !== 0 || lastPointer === 'touch') return\n    const el = (e.target as Element | null)?.closest?.('select') ?? null\n    if (!eligible(el)) return\n    // This is what keeps the OS list from opening.\n    e.preventDefault()\n    if (select === el) {\n      close(true)\n      return\n    }\n    el.focus({ preventScroll: true })\n    open(el)\n  }\n\n  const onKeyDown = (e: KeyboardEvent) => {\n    const el = e.target as Element | null\n    if (!eligible(el) || select === el) return\n    if (!OPEN_KEYS.has(e.key) || e.ctrlKey || e.metaKey) return\n    e.preventDefault()\n    open(el, e.key === 'ArrowUp' && !e.altKey ? 'last' : undefined)\n  }\n\n  document.addEventListener('pointerdown', onPointerDown, true)\n  document.addEventListener('mousedown', onMouseDown, true)\n  document.addEventListener('keydown', onKeyDown, true)\n\n  uninstallCurrent = () => {\n    close(false)\n    document.removeEventListener('pointerdown', onPointerDown, true)\n    document.removeEventListener('mousedown', onMouseDown, true)\n    document.removeEventListener('keydown', onKeyDown, true)\n    uninstallCurrent = null\n  }\n  return uninstallCurrent\n}\n"],"names":[],"mappings":"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"}

package/dist/lib/settingsClient.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Client for the unified user-settings modal (ConnectedSettings).
+ *
+ * Two concerns, both cookie-authed against the hadoku.me edge-router, which
+ * resolves the `hadoku_session` cookie / `X-Session-Id` header → X-User-Key +
+ * X-User-Id for the backend:
+ *   - display name  → POST /session/name                   (edge-router, self rename)
+ *   - content level → GET/PUT /prefs/api/v1/content-level  (prefs-api)
+ *
+ * Switching keys goes through the SITE's sign-in client, never a call of ours:
+ * see `loadSignIn()`, with `switchKeyHref()` as the fallback.
+ *
+ * These are same-origin relative paths, so ConnectedSettings is portable to any
+ * app served under hadoku.me with zero wiring. Off-origin (e.g. a Storybook or
+ * a non-hadoku host) every call resolves to null and the UI degrades to a
+ * read-only shell — it never throws.
+ *
+ * The raw key is never held in the browser (the auth page deliberately drops
+ * it), so name + content-level changes go through session identity, not a key
+ * header, and no app ever asks for a key at all.
+ *
+ * WHEN THESE RUN
+ * --------------
+ * Everything the popout displays is resolved at PAGE LOAD, not on gear-click —
+ * see `prefetchSettings()`. Opening settings must cost zero requests. Pinned by
+ * `e2e/settings-prefetch.spec.ts` in hadoku-task.
+ */
+export interface ContentLevelState {
+    /** Current global content-visibility level (1 = safest default). */
+    level: number;
+    /** Highest level this caller's tier may select (friend=3, admin=4). */
+    maxLevel: number;
+}
+/** GET the caller's current content level + tier ceiling. null on error. */
+export declare function getContentLevel(): Promise<ContentLevelState | null>;
+/** PUT a new content level. Server clamps to the tier ceiling → 400 if out of
+ *  range. Returns the stored state on success, null on any failure. */
+export declare function setContentLevel(level: number): Promise<ContentLevelState | null>;
+/** POST a new display name for the signed-in user. Returns the stored name
+ *  (may differ from the request for wp-* protected keys) or null on failure. */
+export declare function setDisplayName(name: string): Promise<string | null>;
+/**
+ * The hadoku tier ladder, LOW to HIGH: `public < friend < service < wife < admin`.
+ * Mirrors TIER_RANK in @wolffm/worker-utils, which this browser bundle cannot
+ * import (it would pull hono into the client). A tier missing here does not
+ * error — it fails the union and, worse, drops out of every `Record<Tier, …>`
+ * lookup, so the caller renders as if unrecognised. Keep it complete.
+ */
+export type Tier = 'public' | 'friend' | 'service' | 'wife' | 'admin';
+export interface Identity {
+    userType: Tier;
+    name: string | null;
+}
+/**
+ * Resolve the signed-in caller's tier + display name from the edge-router.
+ * Returns { userType: 'public', name: null } for anonymous / off-origin / any
+ * failure — never throws, so ConnectedSettings can render unconditionally.
+ */
+export declare function whoami(): Promise<Identity>;
+/**
+ * Where a "Switch key" control sends the user when the inline sign-in client
+ * (`loadSignIn()`) can't be loaded: the site's sign-in page, which brings them
+ * back here afterwards.
+ *
+ * A browser session is created ONLY by /auth (hadoku_site, 2026-10-25): every
+ * render of that page carries an edge-signed funnel token and the device
+ * fingerprint, and /session/create alerts on — and will refuse — a sign-in
+ * without them. So an app never posts a key itself.
+ *
+ * `switch=1` stops /auth from sending an already signed-in visitor straight
+ * back, which would make switching impossible. `return` is this page's path,
+ * query and hash; /auth redirects there with the new session cookie, and the
+ * shell's mf-loader resyncs the localStorage mirror (hadoku_session_id /
+ * hadoku_user_type) from /session/whoami on that load, so nothing here writes it.
+ */
+export declare function switchKeyHref(): string;
+/** What the site's sign-in client resolves to on success. */
+export interface SignInResult {
+    valid: boolean;
+    userType?: string;
+    sessionId?: string;
+}
+/** `signIn` from hadoku.me's `/auth/sign-in.js`. Resolves on success; throws an
+ *  `Error` carrying the server's message on a refused or empty key. */
+export type SignIn = (key: string) => Promise<SignInResult>;
+export declare function loadSignIn(): Promise<SignIn | null>;
+/** Everything the settings popout displays, resolved together. */
+export interface SettingsSnapshot {
+    identity: Identity;
+    /** null = public caller (no pill) or the request failed. */
+    content: ContentLevelState | null;
+}
+/** Identity the host already knows, so we don't ask the server for it again. */
+export interface SettingsPrefetchHints {
+    /** Caller's tier. When supplied, whoami is skipped entirely. */
+    userType?: Tier;
+    /** Caller's display name. Only meaningful alongside `userType`. */
+    name?: string | null;
+}
+/**
+ * Resolve — once per page load — everything the settings popout shows.
+ *
+ * This is THE entry point, and it is called from ConnectedSettings' MOUNT, not
+ * from its open handler. Settings data is user identity: it is known at boot,
+ * it doesn't change while the page is up, and making the gear the trigger left
+ * the panel on screen but blank for a round trip (measured on prod: whoami
+ * 167ms and content-level 186ms, issued concurrently). It now rides along with
+ * the app's own boot traffic and the click costs nothing.
+ *
+ * Idempotent and shared: every caller after the first gets the same promise, so
+ * N mounted consumers still produce at most one whoami for the whole page.
+ * Mutations below write through to it rather than invalidating, so a remount
+ * never shows a value the user just changed.
+ *
+ * Against a current edge-router this issues NO requests of its own at all — the
+ * level rides on the whoami the shell already had in flight. See
+ * resolveSettings for the fallback when it doesn't.
+ */
+export declare function prefetchSettings(hints?: SettingsPrefetchHints): Promise<SettingsSnapshot>;
+//# sourceMappingURL=settingsClient.d.ts.map

package/dist/lib/settingsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settingsClient.d.ts","sourceRoot":"","sources":["../../src/lib/settingsClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAmDH,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,4EAA4E;AAC5E,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAYzE;AAED;uEACuE;AACvE,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgBtF;AAED;gFACgF;AAChF,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBzE;AAED;;;;;;GAMG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;AAErE,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,IAAI,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAyBD;;;;GAIG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,CAShD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;uEACuE;AACvE,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;AAyB3D,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUnD;AAMD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAA;IAClB,4DAA4D;IAC5D,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAClC;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,qBAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAG7F"}