@eifi1/ui-kit 0.51.3 → 0.51.5

package/dist/settings/use-settings-focus.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/settings/use-settings-focus.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\nimport { prefersReducedMotion } from \"../lib/reduced-motion\";\n\n/**\n * The ring a `?focus=` target wears for {@link SETTINGS_FOCUS_MS} — keksdose's\n * `HIGHLIGHT`, in tokens: `--brand` for the ring and the page's own surface for the gap,\n * where keksdose named a slate for the dark theme. A ring rather than a background\n * flash: the destructive cards already own a background tint, and a ring reads the same\n * on every card.\n */\nexport const SETTINGS_FOCUS_RING = [\"ring-2\", \"ring-brand\", \"ring-offset-2\", \"ring-offset-page\"];\n\n/** How long the ring stays (§3.5). */\nexport const SETTINGS_FOCUS_MS = 1800;\n\n/** How long a target that is not on the page yet (a lazy card, a card waiting for its\n *  data) is waited for before the hook gives up on it. */\nconst WAIT_MS = 5000;\n\nconst HEADING = \"[data-settings-heading], h1, h2, h3, h4, h5, h6\";\n\n/**\n * `?focus=<anchor>` (docs/settings-harmonization.md §3.5): scroll the card into view, ring\n * it for 1.8 s, move focus to its heading for a screen reader, then remove `focus` — and\n * ONLY `focus` — with a replace, so a reload does not ring it again. Every other\n * parameter stays: a tour's `tour` / `tourStep`, the admin roster's filters (dropping URL\n * parts broke keksdose's tours once, dev#495). The hash and `location.state` stay too.\n *\n * A search hit, ⌘K, a tour and a mail link all arrive this way. `SettingsLayout` calls it\n * for its own page; an app's own page can call it with no argument to act on its URL.\n *\n * `anchor`:\n *  - left out: the URL's `focus` parameter;\n *  - a string: that anchor (the layout passes the URL's, once its route is canonical);\n *  - `null`: nothing to do yet — the layout passes it while the address is about to be\n *    replaced, so a removal here cannot undo a redirect there.\n *\n * \"Once its group has rendered\": the effect runs after the commit that mounted the\n * group's cards, so the card is there; a card that mounts later (lazy, or behind its\n * data) is waited for, for a few seconds, before the hook gives up and leaves the URL\n * as it is.\n */\nexport function useSettingsFocus(anchor?: string | null): void {\n  const location = useLocation();\n  const navigate = useNavigate();\n  const target = anchor === undefined ? new URLSearchParams(location.search).get(\"focus\") : anchor;\n  // The ring outlives the effect that drew it: removing `focus` from the URL re-runs the\n  // effect (and cleans it up) at once, and the ring must still stay its 1.8 s.\n  const ring = useRef<{ el: HTMLElement; timer: number } | null>(null);\n\n  useEffect(() => {\n    if (!target) return;\n    const { pathname, search, hash, state } = location;\n\n    const land = (el: HTMLElement) => {\n      el.scrollIntoView?.({ behavior: prefersReducedMotion() ? \"auto\" : \"smooth\", block: \"center\" });\n\n      if (ring.current) {\n        window.clearTimeout(ring.current.timer);\n        ring.current.el.classList.remove(...SETTINGS_FOCUS_RING);\n      }\n      el.classList.add(...SETTINGS_FOCUS_RING);\n      el.setAttribute(\"data-settings-focus\", \"\");\n      const timer = window.setTimeout(() => {\n        el.classList.remove(...SETTINGS_FOCUS_RING);\n        el.removeAttribute(\"data-settings-focus\");\n        if (ring.current?.el === el) ring.current = null;\n      }, SETTINGS_FOCUS_MS);\n      ring.current = { el, timer };\n\n      // The heading, so a screen reader starts at the card's name; the card itself when\n      // it has none. `preventScroll`: the smooth scroll above is already on its way.\n      const heading = el.querySelector<HTMLElement>(HEADING) ?? el;\n      if (!heading.hasAttribute(\"tabindex\")) heading.setAttribute(\"tabindex\", \"-1\");\n      heading.focus({ preventScroll: true });\n\n      const params = new URLSearchParams(search);\n      if (params.get(\"focus\") !== target) return;\n      params.delete(\"focus\");\n      const rest = params.toString();\n      navigate({ pathname, search: rest ? `?${rest}` : \"\", hash }, { replace: true, state });\n    };\n\n    const found = document.getElementById(target);\n    if (found) {\n      land(found);\n      return;\n    }\n    const observer = new MutationObserver(() => {\n      const el = document.getElementById(target);\n      if (!el) return;\n      observer.disconnect();\n      window.clearTimeout(giveUp);\n      land(el);\n    });\n    observer.observe(document.body, { childList: true, subtree: true });\n    const giveUp = window.setTimeout(() => observer.disconnect(), WAIT_MS);\n    return () => {\n      observer.disconnect();\n      window.clearTimeout(giveUp);\n    };\n    // `location`, a new object per navigation: the same hit picked twice is two\n    // navigations, and rings twice.\n  }, [target, location, navigate]);\n\n  useEffect(\n    () => () => {\n      const current = ring.current;\n      if (!current) return;\n      window.clearTimeout(current.timer);\n      current.el.classList.remove(...SETTINGS_FOCUS_RING);\n      current.el.removeAttribute(\"data-settings-focus\");\n    },\n    [],\n  );\n}\n"],"mappings":";AAAA,SAAS,WAAW,cAAc;AAClC,SAAS,aAAa,mBAAmB;AACzC,SAAS,4BAA4B;AAS9B,MAAM,sBAAsB,CAAC,UAAU,cAAc,iBAAiB,kBAAkB;AAGxF,MAAM,oBAAoB;AAIjC,MAAM,UAAU;AAEhB,MAAM,UAAU;AAuBT,SAAS,iBAAiB,QAA8B;AAC7D,QAAM,WAAW,YAAY;AAC7B,QAAM,WAAW,YAAY;AAC7B,QAAM,SAAS,WAAW,SAAY,IAAI,gBAAgB,SAAS,MAAM,EAAE,IAAI,OAAO,IAAI;AAG1F,QAAM,OAAO,OAAkD,IAAI;AAEnE,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,EAAE,UAAU,QAAQ,MAAM,MAAM,IAAI;AAE1C,UAAM,OAAO,CAAC,OAAoB;AAChC,SAAG,iBAAiB,EAAE,UAAU,qBAAqB,IAAI,SAAS,UAAU,OAAO,SAAS,CAAC;AAE7F,UAAI,KAAK,SAAS;AAChB,eAAO,aAAa,KAAK,QAAQ,KAAK;AACtC,aAAK,QAAQ,GAAG,UAAU,OAAO,GAAG,mBAAmB;AAAA,MACzD;AACA,SAAG,UAAU,IAAI,GAAG,mBAAmB;AACvC,SAAG,aAAa,uBAAuB,EAAE;AACzC,YAAM,QAAQ,OAAO,WAAW,MAAM;AACpC,WAAG,UAAU,OAAO,GAAG,mBAAmB;AAC1C,WAAG,gBAAgB,qBAAqB;AACxC,YAAI,KAAK,SAAS,OAAO,GAAI,MAAK,UAAU;AAAA,MAC9C,GAAG,iBAAiB;AACpB,WAAK,UAAU,EAAE,IAAI,MAAM;AAI3B,YAAM,UAAU,GAAG,cAA2B,OAAO,KAAK;AAC1D,UAAI,CAAC,QAAQ,aAAa,UAAU,EAAG,SAAQ,aAAa,YAAY,IAAI;AAC5E,cAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;AAErC,YAAM,SAAS,IAAI,gBAAgB,MAAM;AACzC,UAAI,OAAO,IAAI,OAAO,MAAM,OAAQ;AACpC,aAAO,OAAO,OAAO;AACrB,YAAM,OAAO,OAAO,SAAS;AAC7B,eAAS,EAAE,UAAU,QAAQ,OAAO,IAAI,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE,SAAS,MAAM,MAAM,CAAC;AAAA,IACvF;AAEA,UAAM,QAAQ,SAAS,eAAe,MAAM;AAC5C,QAAI,OAAO;AACT,WAAK,KAAK;AACV;AAAA,IACF;AACA,UAAM,WAAW,IAAI,iBAAiB,MAAM;AAC1C,YAAM,KAAK,SAAS,eAAe,MAAM;AACzC,UAAI,CAAC,GAAI;AACT,eAAS,WAAW;AACpB,aAAO,aAAa,MAAM;AAC1B,WAAK,EAAE;AAAA,IACT,CAAC;AACD,aAAS,QAAQ,SAAS,MAAM,EAAE,WAAW,MAAM,SAAS,KAAK,CAAC;AAClE,UAAM,SAAS,OAAO,WAAW,MAAM,SAAS,WAAW,GAAG,OAAO;AACrE,WAAO,MAAM;AACX,eAAS,WAAW;AACpB,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,EAGF,GAAG,CAAC,QAAQ,UAAU,QAAQ,CAAC;AAE/B;AAAA,IACE,MAAM,MAAM;AACV,YAAM,UAAU,KAAK;AACrB,UAAI,CAAC,QAAS;AACd,aAAO,aAAa,QAAQ,KAAK;AACjC,cAAQ,GAAG,UAAU,OAAO,GAAG,mBAAmB;AAClD,cAAQ,GAAG,gBAAgB,qBAAqB;AAAA,IAClD;AAAA,IACA,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"sources":["../../src/settings/use-settings-focus.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\nimport { prefersReducedMotion } from \"../lib/reduced-motion\";\n\n/**\n * The ring a `?focus=` target wears for {@link SETTINGS_FOCUS_MS} — keksdose's\n * `HIGHLIGHT`, in tokens: `--brand` for the ring and the page's own surface for the gap,\n * where keksdose named a slate for the dark theme. A ring rather than a background\n * flash: the destructive cards already own a background tint, and a ring reads the same\n * on every card.\n */\nexport const SETTINGS_FOCUS_RING = [\"ring-2\", \"ring-brand\", \"ring-offset-2\", \"ring-offset-page\"];\n\n/** How long the ring stays (§3.5). */\nexport const SETTINGS_FOCUS_MS = 1800;\n\n/** How long a target that is not on the page yet (a lazy card, a card waiting for its\n *  data) is waited for before the hook gives up on it. */\nconst WAIT_MS = 5000;\n\nconst HEADING = \"[data-settings-heading], h1, h2, h3, h4, h5, h6\";\n\n/**\n * `?focus=<anchor>` (docs/settings-harmonization.md §3.5): scroll the card into view, ring\n * it for 1.8 s, move focus to its heading for a screen reader, then remove `focus` — and\n * ONLY `focus` — with a replace, so a reload does not ring it again. Every other\n * parameter stays: a tour's `tour` / `tourStep`, the admin roster's filters (dropping URL\n * parts broke keksdose's tours once, dev#495). The hash and `location.state` stay too.\n *\n * A search hit, ⌘K, a tour and a mail link all arrive this way. `SettingsLayout` calls it\n * for its own page; an app's own page can call it with no argument to act on its URL.\n *\n * `anchor`:\n *  - left out: the URL's `focus` parameter;\n *  - a string: that anchor (the layout passes the URL's, once its route is canonical);\n *  - `null`: nothing to do yet — the layout passes it while the address is about to be\n *    replaced, so a removal here cannot undo a redirect there.\n *\n * \"Once its group has rendered\": the effect runs after the commit that mounted the\n * group's cards, so the card is there; a card that mounts later (lazy, or behind its\n * data) is waited for, for a few seconds, before the hook gives up and leaves the URL\n * as it is.\n */\nexport function useSettingsFocus(anchor?: string | null): void {\n  const location = useLocation();\n  const navigate = useNavigate();\n  const target = anchor === undefined ? new URLSearchParams(location.search).get(\"focus\") : anchor;\n  // The ring outlives the effect that drew it: removing `focus` from the URL re-runs the\n  // effect (and cleans it up) at once, and the ring must still stay its 1.8 s.\n  const ring = useRef<{ el: HTMLElement; timer: number } | null>(null);\n\n  useEffect(() => {\n    if (!target) return;\n    const { pathname, search, hash, state } = location;\n\n    const land = (el: HTMLElement) => {\n      el.scrollIntoView?.({ behavior: prefersReducedMotion() ? \"auto\" : \"smooth\", block: \"center\" });\n\n      if (ring.current) {\n        window.clearTimeout(ring.current.timer);\n        ring.current.el.classList.remove(...SETTINGS_FOCUS_RING);\n      }\n      el.classList.add(...SETTINGS_FOCUS_RING);\n      el.setAttribute(\"data-settings-focus\", \"\");\n      const timer = window.setTimeout(() => {\n        el.classList.remove(...SETTINGS_FOCUS_RING);\n        el.removeAttribute(\"data-settings-focus\");\n        if (ring.current?.el === el) ring.current = null;\n      }, SETTINGS_FOCUS_MS);\n      ring.current = { el, timer };\n\n      // The heading, so a screen reader starts at the card's name; the card itself when\n      // it has none. `preventScroll`: the smooth scroll above is already on its way.\n      const heading = el.querySelector<HTMLElement>(HEADING) ?? el;\n      if (!heading.hasAttribute(\"tabindex\")) heading.setAttribute(\"tabindex\", \"-1\");\n      heading.focus({ preventScroll: true });\n\n      const params = new URLSearchParams(search);\n      if (params.get(\"focus\") !== target) return;\n      params.delete(\"focus\");\n      const rest = params.toString();\n      navigate({ pathname, search: rest ? `?${rest}` : \"\", hash }, { replace: true, state });\n    };\n\n    const found = document.getElementById(target);\n    if (found) {\n      land(found);\n      return;\n    }\n    const observer = new MutationObserver(() => {\n      const el = document.getElementById(target);\n      if (!el) return;\n      observer.disconnect();\n      window.clearTimeout(giveUp);\n      land(el);\n    });\n    observer.observe(document.body, { childList: true, subtree: true });\n    const giveUp = window.setTimeout(() => observer.disconnect(), WAIT_MS);\n    return () => {\n      observer.disconnect();\n      window.clearTimeout(giveUp);\n    };\n    // `location`, a new object per navigation: the same hit picked twice is two\n    // navigations, and rings twice.\n  }, [target, location, navigate]);\n\n  useEffect(\n    () => () => {\n      const current = ring.current;\n      if (!current) return;\n      window.clearTimeout(current.timer);\n      current.el.classList.remove(...SETTINGS_FOCUS_RING);\n      current.el.removeAttribute(\"data-settings-focus\");\n    },\n    [],\n  );\n}\n\n/**\n * {@link useSettingsFocus} under a name for any page (0.51.4, keksdose run 89): the hook\n * was always allowed on an app's own pages (keksdose's /reports/matching lands\n * `?focus=matching-unmatched` on a card), but its name said Settings at every such call\n * site. The same function, so the two cannot drift; `useSettingsFocus` stays.\n */\nexport const useFocusParam: typeof useSettingsFocus = useSettingsFocus;\n"],"mappings":";AAAA,SAAS,WAAW,cAAc;AAClC,SAAS,aAAa,mBAAmB;AACzC,SAAS,4BAA4B;AAS9B,MAAM,sBAAsB,CAAC,UAAU,cAAc,iBAAiB,kBAAkB;AAGxF,MAAM,oBAAoB;AAIjC,MAAM,UAAU;AAEhB,MAAM,UAAU;AAuBT,SAAS,iBAAiB,QAA8B;AAC7D,QAAM,WAAW,YAAY;AAC7B,QAAM,WAAW,YAAY;AAC7B,QAAM,SAAS,WAAW,SAAY,IAAI,gBAAgB,SAAS,MAAM,EAAE,IAAI,OAAO,IAAI;AAG1F,QAAM,OAAO,OAAkD,IAAI;AAEnE,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,EAAE,UAAU,QAAQ,MAAM,MAAM,IAAI;AAE1C,UAAM,OAAO,CAAC,OAAoB;AAChC,SAAG,iBAAiB,EAAE,UAAU,qBAAqB,IAAI,SAAS,UAAU,OAAO,SAAS,CAAC;AAE7F,UAAI,KAAK,SAAS;AAChB,eAAO,aAAa,KAAK,QAAQ,KAAK;AACtC,aAAK,QAAQ,GAAG,UAAU,OAAO,GAAG,mBAAmB;AAAA,MACzD;AACA,SAAG,UAAU,IAAI,GAAG,mBAAmB;AACvC,SAAG,aAAa,uBAAuB,EAAE;AACzC,YAAM,QAAQ,OAAO,WAAW,MAAM;AACpC,WAAG,UAAU,OAAO,GAAG,mBAAmB;AAC1C,WAAG,gBAAgB,qBAAqB;AACxC,YAAI,KAAK,SAAS,OAAO,GAAI,MAAK,UAAU;AAAA,MAC9C,GAAG,iBAAiB;AACpB,WAAK,UAAU,EAAE,IAAI,MAAM;AAI3B,YAAM,UAAU,GAAG,cAA2B,OAAO,KAAK;AAC1D,UAAI,CAAC,QAAQ,aAAa,UAAU,EAAG,SAAQ,aAAa,YAAY,IAAI;AAC5E,cAAQ,MAAM,EAAE,eAAe,KAAK,CAAC;AAErC,YAAM,SAAS,IAAI,gBAAgB,MAAM;AACzC,UAAI,OAAO,IAAI,OAAO,MAAM,OAAQ;AACpC,aAAO,OAAO,OAAO;AACrB,YAAM,OAAO,OAAO,SAAS;AAC7B,eAAS,EAAE,UAAU,QAAQ,OAAO,IAAI,IAAI,KAAK,IAAI,KAAK,GAAG,EAAE,SAAS,MAAM,MAAM,CAAC;AAAA,IACvF;AAEA,UAAM,QAAQ,SAAS,eAAe,MAAM;AAC5C,QAAI,OAAO;AACT,WAAK,KAAK;AACV;AAAA,IACF;AACA,UAAM,WAAW,IAAI,iBAAiB,MAAM;AAC1C,YAAM,KAAK,SAAS,eAAe,MAAM;AACzC,UAAI,CAAC,GAAI;AACT,eAAS,WAAW;AACpB,aAAO,aAAa,MAAM;AAC1B,WAAK,EAAE;AAAA,IACT,CAAC;AACD,aAAS,QAAQ,SAAS,MAAM,EAAE,WAAW,MAAM,SAAS,KAAK,CAAC;AAClE,UAAM,SAAS,OAAO,WAAW,MAAM,SAAS,WAAW,GAAG,OAAO;AACrE,WAAO,MAAM;AACX,eAAS,WAAW;AACpB,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,EAGF,GAAG,CAAC,QAAQ,UAAU,QAAQ,CAAC;AAE/B;AAAA,IACE,MAAM,MAAM;AACV,YAAM,UAAU,KAAK;AACrB,UAAI,CAAC,QAAS;AACd,aAAO,aAAa,QAAQ,KAAK;AACjC,cAAQ,GAAG,UAAU,OAAO,GAAG,mBAAmB;AAClD,cAAQ,GAAG,gBAAgB,qBAAqB;AAAA,IAClD;AAAA,IACA,CAAC;AAAA,EACH;AACF;AAQO,MAAM,gBAAyC;","names":[]}

package/dist/settings/use-settings-route.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/settings/use-settings-route.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\nimport { usePhoneLayout } from \"../hooks/use-breakpoint\";\nimport { normalizeSettingsBase, visibleSettingsGroups } from \"./settings-catalogue\";\nimport type { SettingsEntry, SettingsGroup } from \"./settings-catalogue\";\n\n/**\n * Which layout the settings page is in. `\"auto\"` follows the screen (`usePhoneLayout()`,\n * as `Tabs` does); `\"desktop\"` / `\"phone\"` pin one — for a preview of both side by side,\n * where the window is one width.\n */\nexport type SettingsLayoutMode = \"auto\" | \"desktop\" | \"phone\";\n\nexport interface UseSettingsRouteOptions<G extends string> {\n  groups: readonly SettingsGroup<G>[];\n  /** The catalogue's entries. Given, a group with no visible entry is hidden (§4.1), and\n   *  `/settings?focus=<anchor>` finds the anchor's group. */\n  entries?: readonly SettingsEntry<G>[];\n  /** `/settings` or `/admin`. */\n  basePath: string;\n  /** The group `/settings` opens on a desktop. Default: the first visible group (§4.1). */\n  defaultGroup?: G;\n  /** Retired group ids and their successors — `{ overview: \"metrics\" }` — applied with a\n   *  replace (§3.1, keksdose's admin). */\n  aliases?: Readonly<Partial<Record<string, G>>>;\n  /** See {@link SettingsLayoutMode}. Default `\"auto\"`. */\n  layout?: SettingsLayoutMode;\n}\n\nexport interface SettingsRoute<G extends string> {\n  /** The group on screen. `null` on a phone's list (and while there is no visible group). */\n  group: G | null;\n  /** The segment after the group, owned by a card; `null` without one. */\n  sub: string | null;\n  /** `?focus=<anchor>`, or `null`. */\n  focus: string | null;\n  /** Open a group: a PUSH on a phone, so the system back gesture returns to the list; a\n   *  REPLACE on a desktop, so back leaves settings instead of walking every group looked\n   *  at (§3.1, keksdose's rule). */\n  select: (group: G) => void;\n  /** See {@link SettingsLayoutContextValue.selectSub}. */\n  selectSub: (sub: string | null) => void;\n  /** To the list: `navigate(-1)` when the list is the previous entry, else a replace to\n   *  the base path — so a deep link from a mail never sends \"back\" out of the app. */\n  back: () => void;\n  /** The visible groups, in order. */\n  groups: SettingsGroup<G>[];\n  /** Whether the phone layout is in force. */\n  phone: boolean;\n  /** Whether this location is about to be replaced (a legacy hash, an alias, an unknown\n   *  group): what renders meanwhile is already the destination's, but nothing should\n   *  act on the URL until it is. */\n  redirecting: boolean;\n  /** Whether the list is the entry before this one (the marker {@link select} and the\n   *  list's links leave in `location.state`). */\n  fromList: boolean;\n}\n\n/**\n * The `location.state` key that says \"the list is the entry before this one\". Written by\n * the phone list's links and {@link SettingsRoute.select}; carried over by every replace\n * the page makes, since a replace does not change what came before.\n */\nexport const SETTINGS_FROM_LIST_STATE = \"eifi1.settings.fromList\";\n\n/** `location.state` with the marker set — for an app's own link to a group page that is\n *  opened FROM the list it renders. */\nexport function settingsFromListState(): Record<string, true> {\n  return { [SETTINGS_FROM_LIST_STATE]: true };\n}\n\nfunction isFromList(state: unknown): boolean {\n  return typeof state === \"object\" && state !== null && (state as Record<string, unknown>)[SETTINGS_FROM_LIST_STATE] === true;\n}\n\nexport interface SettingsLocation {\n  pathname: string;\n  search: string;\n  hash: string;\n}\n\nexport interface SettingsLocationRules<G extends string> {\n  basePath: string;\n  /** The visible group ids. */\n  groups: readonly G[];\n  /** The resolved default group, `null` with no visible group. */\n  defaultGroup: G | null;\n  aliases?: Readonly<Partial<Record<string, G>>>;\n  /** Anchor → group, for `/settings?focus=<anchor>` with no group named. */\n  anchorGroup?: ReadonlyMap<string, G>;\n  phone: boolean;\n}\n\nexport interface SettingsLocationResult<G extends string> {\n  group: G | null;\n  sub: string | null;\n  /** The path (with query) to replace the location with, or `null` when it is already\n   *  canonical. */\n  redirect: string | null;\n}\n\n/**\n * Where a location lands on the settings page — pure, so the rules of §3.1 are testable\n * without a router:\n *\n *  - `/settings` → the default group on a desktop (a replace), the list on a phone;\n *  - `/settings/<group>[/<sub>]` → that group, the rest of the path as `sub`;\n *  - an alias → its successor, with a replace, `sub`, query and hash kept;\n *  - an unknown or hidden group → the default group (desktop) or the list (phone), with\n *    a replace and the query kept — never a 404, so an old bookmark still lands;\n *  - keksdose's legacy `/settings?<query>#<group>[/<sub>]` →\n *    `/settings/<group>[/<sub>]?<query>`, the WHOLE query carried (a tour's\n *    `tour`/`tourStep` as well as `focus`), then resolved by the rules above;\n *  - `/settings?focus=<anchor>` with no group → the anchor's group, where it can ring.\n */\nexport function resolveSettingsLocation<G extends string>(\n  location: SettingsLocation,\n  rules: SettingsLocationRules<G>,\n): SettingsLocationResult<G> {\n  const base = normalizeSettingsBase(rules.basePath);\n  const { pathname, search, hash } = location;\n  const known = new Set<string>(rules.groups);\n  const atBase = pathname === base || pathname === `${base}/` || (base === \"\" && pathname === \"/\");\n\n  if (atBase) {\n    const legacy = hash.replace(/^#/, \"\").replace(/^\\/+/, \"\");\n    if (legacy) {\n      // The hash becomes the path; whatever the path then says (an alias, an unknown\n      // group) is resolved in the same step, so the history sees one replace.\n      const converted = `${base}/${legacy}`;\n      const next = resolveSettingsLocation({ pathname: converted, search, hash: \"\" }, rules);\n      return { ...next, redirect: next.redirect ?? `${converted}${search}` };\n    }\n    const anchor = new URLSearchParams(search).get(\"focus\");\n    const anchorGroup = anchor ? rules.anchorGroup?.get(anchor) : undefined;\n    if (anchorGroup && known.has(anchorGroup)) {\n      return { group: anchorGroup, sub: null, redirect: `${base}/${anchorGroup}${search}` };\n    }\n    if (rules.phone || rules.defaultGroup === null) return { group: null, sub: null, redirect: null };\n    return { group: rules.defaultGroup, sub: null, redirect: `${base}/${rules.defaultGroup}${search}` };\n  }\n\n  if (!pathname.startsWith(`${base}/`)) {\n    // Mounted somewhere `basePath` does not name: a misconfiguration, not a link to\n    // correct. Show what the base path would, and leave the address alone.\n    return { group: rules.phone ? null : rules.defaultGroup, sub: null, redirect: null };\n  }\n  const rest = pathname.slice(base.length + 1);\n  const [segment = \"\", ...subParts] = rest.split(\"/\");\n  const sub = subParts.filter(Boolean).join(\"/\") || null;\n  if (known.has(segment)) return { group: segment as G, sub, redirect: null };\n\n  const successor = rules.aliases?.[segment];\n  if (successor !== undefined && known.has(successor)) {\n    return {\n      group: successor,\n      sub,\n      redirect: `${base}/${successor}${sub ? `/${sub}` : \"\"}${search}${hash}`,\n    };\n  }\n\n  // Unknown or hidden. The hash is dropped: on the list it would read as a legacy group\n  // and send the page round again.\n  if (rules.phone || rules.defaultGroup === null) {\n    return { group: null, sub: null, redirect: `${base || \"/\"}${search}` };\n  }\n  return { group: rules.defaultGroup, sub: null, redirect: `${base}/${rules.defaultGroup}${search}` };\n}\n\n/**\n * The settings page's route (docs/settings-harmonization.md §3.1): which group the URL\n * names, and the history rules for moving between groups.\n *\n * The URL IS the selection, as it was in keksdose (where it was the hash): there is no\n * state to keep in step with it, so a deep link, a reload, back and forward all land\n * where the address says. Everything that is not canonical — `/settings` on a desktop, a\n * legacy hash, an alias, an unknown or hidden group — is replaced by its canonical path.\n *\n * **The replace runs on every navigation**, keyed on `location.key`, not once on mount:\n * the router keeps the page mounted across links followed inside the app — keksdose's\n * inbox renders admin-typed URLs, and a push click routes an open window without a\n * reload — so a legacy `/settings#security` arriving while the page is open converts too\n * (§10.1).\n */\nexport function useSettingsRoute<G extends string>(options: UseSettingsRouteOptions<G>): SettingsRoute<G> {\n  const { groups, entries, basePath, defaultGroup, aliases, layout = \"auto\" } = options;\n  const location = useLocation();\n  const navigate = useNavigate();\n  const narrow = usePhoneLayout();\n  const phone = layout === \"phone\" || (layout === \"auto\" && narrow);\n  const base = normalizeSettingsBase(basePath);\n\n  const visible = useMemo(() => visibleSettingsGroups(groups, entries), [groups, entries]);\n  const anchorGroup = useMemo(() => {\n    const map = new Map<string, G>();\n    for (const e of entries ?? []) if (e.visible !== false && !map.has(e.anchor)) map.set(e.anchor, e.group);\n    return map;\n  }, [entries]);\n  const ids = visible.map((g) => g.id);\n  const fallback =\n    defaultGroup !== undefined && ids.includes(defaultGroup) ? defaultGroup : (ids[0] ?? null);\n\n  const { group, sub, redirect } = resolveSettingsLocation(location, {\n    basePath: base,\n    groups: ids,\n    defaultGroup: fallback,\n    aliases,\n    anchorGroup,\n    phone,\n  });\n\n  const { key, state, search } = location;\n  useEffect(() => {\n    // `state` rides along: the marker describes the entry BEFORE this one, which a\n    // replace does not change.\n    if (redirect) navigate(redirect, { replace: true, state });\n  }, [key, redirect, state, navigate]);\n\n  const select = useCallback(\n    (next: G) => {\n      const to = `${base}/${next}`;\n      // From the list, the push marks it, so the group page's back is a real back.\n      if (phone) navigate(to, group === null ? { state: settingsFromListState() } : undefined);\n      // A new group is a new page: the old one's query (a focus, a roster filter) stays\n      // behind, as keksdose's `selectGroup` left it.\n      else navigate(to, { replace: true, state });\n    },\n    [base, phone, group, state, navigate],\n  );\n\n  const selectSub = useCallback(\n    (next: string | null) => {\n      if (group === null) return;\n      navigate(`${base}/${group}${next ? `/${next}` : \"\"}${search}`, { replace: true, state });\n    },\n    [base, group, search, state, navigate],\n  );\n\n  const fromList = isFromList(state);\n  const back = useCallback(() => {\n    if (fromList) navigate(-1);\n    else navigate(base || \"/\", { replace: true });\n  }, [fromList, base, navigate]);\n\n  return {\n    group,\n    sub,\n    focus: new URLSearchParams(search).get(\"focus\"),\n    select,\n    selectSub,\n    back,\n    groups: visible,\n    phone,\n    redirecting: redirect !== null,\n    fromList,\n  };\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,eAAe;AAChD,SAAS,aAAa,mBAAmB;AACzC,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB,6BAA6B;AA4DtD,MAAM,2BAA2B;AAIjC,SAAS,wBAA8C;AAC5D,SAAO,EAAE,CAAC,wBAAwB,GAAG,KAAK;AAC5C;AAEA,SAAS,WAAW,OAAyB;AAC3C,SAAO,OAAO,UAAU,YAAY,UAAU,QAAS,MAAkC,wBAAwB,MAAM;AACzH;AA0CO,SAAS,wBACd,UACA,OAC2B;AAC3B,QAAM,OAAO,sBAAsB,MAAM,QAAQ;AACjD,QAAM,EAAE,UAAU,QAAQ,KAAK,IAAI;AACnC,QAAM,QAAQ,IAAI,IAAY,MAAM,MAAM;AAC1C,QAAM,SAAS,aAAa,QAAQ,aAAa,GAAG,IAAI,OAAQ,SAAS,MAAM,aAAa;AAE5F,MAAI,QAAQ;AACV,UAAM,SAAS,KAAK,QAAQ,MAAM,EAAE,EAAE,QAAQ,QAAQ,EAAE;AACxD,QAAI,QAAQ;AAGV,YAAM,YAAY,GAAG,IAAI,IAAI,MAAM;AACnC,YAAM,OAAO,wBAAwB,EAAE,UAAU,WAAW,QAAQ,MAAM,GAAG,GAAG,KAAK;AACrF,aAAO,EAAE,GAAG,MAAM,UAAU,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG;AAAA,IACvE;AACA,UAAM,SAAS,IAAI,gBAAgB,MAAM,EAAE,IAAI,OAAO;AACtD,UAAM,cAAc,SAAS,MAAM,aAAa,IAAI,MAAM,IAAI;AAC9D,QAAI,eAAe,MAAM,IAAI,WAAW,GAAG;AACzC,aAAO,EAAE,OAAO,aAAa,KAAK,MAAM,UAAU,GAAG,IAAI,IAAI,WAAW,GAAG,MAAM,GAAG;AAAA,IACtF;AACA,QAAI,MAAM,SAAS,MAAM,iBAAiB,KAAM,QAAO,EAAE,OAAO,MAAM,KAAK,MAAM,UAAU,KAAK;AAChG,WAAO,EAAE,OAAO,MAAM,cAAc,KAAK,MAAM,UAAU,GAAG,IAAI,IAAI,MAAM,YAAY,GAAG,MAAM,GAAG;AAAA,EACpG;AAEA,MAAI,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,GAAG;AAGpC,WAAO,EAAE,OAAO,MAAM,QAAQ,OAAO,MAAM,cAAc,KAAK,MAAM,UAAU,KAAK;AAAA,EACrF;AACA,QAAM,OAAO,SAAS,MAAM,KAAK,SAAS,CAAC;AAC3C,QAAM,CAAC,UAAU,IAAI,GAAG,QAAQ,IAAI,KAAK,MAAM,GAAG;AAClD,QAAM,MAAM,SAAS,OAAO,OAAO,EAAE,KAAK,GAAG,KAAK;AAClD,MAAI,MAAM,IAAI,OAAO,EAAG,QAAO,EAAE,OAAO,SAAc,KAAK,UAAU,KAAK;AAE1E,QAAM,YAAY,MAAM,UAAU,OAAO;AACzC,MAAI,cAAc,UAAa,MAAM,IAAI,SAAS,GAAG;AACnD,WAAO;AAAA,MACL,OAAO;AAAA,MACP;AAAA,MACA,UAAU,GAAG,IAAI,IAAI,SAAS,GAAG,MAAM,IAAI,GAAG,KAAK,EAAE,GAAG,MAAM,GAAG,IAAI;AAAA,IACvE;AAAA,EACF;AAIA,MAAI,MAAM,SAAS,MAAM,iBAAiB,MAAM;AAC9C,WAAO,EAAE,OAAO,MAAM,KAAK,MAAM,UAAU,GAAG,QAAQ,GAAG,GAAG,MAAM,GAAG;AAAA,EACvE;AACA,SAAO,EAAE,OAAO,MAAM,cAAc,KAAK,MAAM,UAAU,GAAG,IAAI,IAAI,MAAM,YAAY,GAAG,MAAM,GAAG;AACpG;AAiBO,SAAS,iBAAmC,SAAuD;AACxG,QAAM,EAAE,QAAQ,SAAS,UAAU,cAAc,SAAS,SAAS,OAAO,IAAI;AAC9E,QAAM,WAAW,YAAY;AAC7B,QAAM,WAAW,YAAY;AAC7B,QAAM,SAAS,eAAe;AAC9B,QAAM,QAAQ,WAAW,WAAY,WAAW,UAAU;AAC1D,QAAM,OAAO,sBAAsB,QAAQ;AAE3C,QAAM,UAAU,QAAQ,MAAM,sBAAsB,QAAQ,OAAO,GAAG,CAAC,QAAQ,OAAO,CAAC;AACvF,QAAM,cAAc,QAAQ,MAAM;AAChC,UAAM,MAAM,oBAAI,IAAe;AAC/B,eAAW,KAAK,WAAW,CAAC,EAAG,KAAI,EAAE,YAAY,SAAS,CAAC,IAAI,IAAI,EAAE,MAAM,EAAG,KAAI,IAAI,EAAE,QAAQ,EAAE,KAAK;AACvG,WAAO;AAAA,EACT,GAAG,CAAC,OAAO,CAAC;AACZ,QAAM,MAAM,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE;AACnC,QAAM,WACJ,iBAAiB,UAAa,IAAI,SAAS,YAAY,IAAI,eAAgB,IAAI,CAAC,KAAK;AAEvF,QAAM,EAAE,OAAO,KAAK,SAAS,IAAI,wBAAwB,UAAU;AAAA,IACjE,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,EAAE,KAAK,OAAO,OAAO,IAAI;AAC/B,YAAU,MAAM;AAGd,QAAI,SAAU,UAAS,UAAU,EAAE,SAAS,MAAM,MAAM,CAAC;AAAA,EAC3D,GAAG,CAAC,KAAK,UAAU,OAAO,QAAQ,CAAC;AAEnC,QAAM,SAAS;AAAA,IACb,CAAC,SAAY;AACX,YAAM,KAAK,GAAG,IAAI,IAAI,IAAI;AAE1B,UAAI,MAAO,UAAS,IAAI,UAAU,OAAO,EAAE,OAAO,sBAAsB,EAAE,IAAI,MAAS;AAAA,UAGlF,UAAS,IAAI,EAAE,SAAS,MAAM,MAAM,CAAC;AAAA,IAC5C;AAAA,IACA,CAAC,MAAM,OAAO,OAAO,OAAO,QAAQ;AAAA,EACtC;AAEA,QAAM,YAAY;AAAA,IAChB,CAAC,SAAwB;AACvB,UAAI,UAAU,KAAM;AACpB,eAAS,GAAG,IAAI,IAAI,KAAK,GAAG,OAAO,IAAI,IAAI,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,SAAS,MAAM,MAAM,CAAC;AAAA,IACzF;AAAA,IACA,CAAC,MAAM,OAAO,QAAQ,OAAO,QAAQ;AAAA,EACvC;AAEA,QAAM,WAAW,WAAW,KAAK;AACjC,QAAM,OAAO,YAAY,MAAM;AAC7B,QAAI,SAAU,UAAS,EAAE;AAAA,QACpB,UAAS,QAAQ,KAAK,EAAE,SAAS,KAAK,CAAC;AAAA,EAC9C,GAAG,CAAC,UAAU,MAAM,QAAQ,CAAC;AAE7B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,IAAI,gBAAgB,MAAM,EAAE,IAAI,OAAO;AAAA,IAC9C;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,aAAa,aAAa;AAAA,IAC1B;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/settings/use-settings-route.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\nimport { usePhoneLayout } from \"../hooks/use-breakpoint\";\nimport { normalizeSettingsBase, visibleSettingsGroups } from \"./settings-catalogue\";\nimport type { SettingsEntry, SettingsGroup } from \"./settings-catalogue\";\n\n/**\n * Which layout the settings page is in. `\"auto\"` follows the screen (`usePhoneLayout()`,\n * as `Tabs` does); `\"desktop\"` / `\"phone\"` pin one — for a preview of both side by side,\n * where the window is one width.\n */\nexport type SettingsLayoutMode = \"auto\" | \"desktop\" | \"phone\";\n\nexport interface UseSettingsRouteOptions<G extends string> {\n  groups: readonly SettingsGroup<G>[];\n  /** The catalogue's entries. Given, a group with no visible entry is hidden (§4.1), and\n   *  `/settings?focus=<anchor>` finds the anchor's group. */\n  entries?: readonly SettingsEntry<G>[];\n  /** `/settings` or `/admin`. */\n  basePath: string;\n  /** The group `/settings` opens on a desktop. Default: the first visible group (§4.1). */\n  defaultGroup?: G;\n  /** Retired group ids and their successors — `{ overview: \"metrics\" }` — applied with a\n   *  replace (§3.1, keksdose's admin). */\n  aliases?: Readonly<Partial<Record<string, G>>>;\n  /** See {@link SettingsLayoutMode}. Default `\"auto\"`. */\n  layout?: SettingsLayoutMode;\n}\n\nexport interface SettingsRoute<G extends string> {\n  /** The group on screen. `null` on a phone's list (and while there is no visible group). */\n  group: G | null;\n  /** The segment after the group, owned by a card; `null` without one. */\n  sub: string | null;\n  /** `?focus=<anchor>`, or `null`. */\n  focus: string | null;\n  /** Open a group: a PUSH on a phone, so the system back gesture returns to the list; a\n   *  REPLACE on a desktop, so back leaves settings instead of walking every group looked\n   *  at (§3.1, keksdose's rule). */\n  select: (group: G) => void;\n  /** See {@link SettingsLayoutContextValue.selectSub}. */\n  selectSub: (sub: string | null) => void;\n  /** To the list: `navigate(-1)` when the list is the previous entry, else a replace to\n   *  the base path — so a deep link from a mail never sends \"back\" out of the app. */\n  back: () => void;\n  /** The visible groups, in order. */\n  groups: SettingsGroup<G>[];\n  /** Whether the phone layout is in force. */\n  phone: boolean;\n  /** Whether this location is about to be replaced (a legacy hash, an alias, an unknown\n   *  group): what renders meanwhile is already the destination's, but nothing should\n   *  act on the URL until it is. */\n  redirecting: boolean;\n  /** Whether the list is the entry before this one (the marker {@link select} and the\n   *  list's links leave in `location.state`). */\n  fromList: boolean;\n}\n\n/**\n * The `location.state` key that says \"the list is the entry before this one\". Written by\n * the phone list's links and {@link SettingsRoute.select}; carried over by every replace\n * the page makes, since a replace does not change what came before.\n */\nexport const SETTINGS_FROM_LIST_STATE = \"eifi1.settings.fromList\";\n\n/** `location.state` with the marker set — for an app's own link to a group page that is\n *  opened FROM the list it renders. */\nexport function settingsFromListState(): Record<string, true> {\n  return { [SETTINGS_FROM_LIST_STATE]: true };\n}\n\nfunction isFromList(state: unknown): boolean {\n  return (\n    typeof state === \"object\" && state !== null && (state as Record<string, unknown>)[SETTINGS_FROM_LIST_STATE] === true\n  );\n}\n\nexport interface SettingsLocation {\n  pathname: string;\n  search: string;\n  hash: string;\n}\n\nexport interface SettingsLocationRules<G extends string> {\n  basePath: string;\n  /** The visible group ids. */\n  groups: readonly G[];\n  /** The resolved default group, `null` with no visible group. */\n  defaultGroup: G | null;\n  aliases?: Readonly<Partial<Record<string, G>>>;\n  /** Anchor → group, for `/settings?focus=<anchor>` with no group named. */\n  anchorGroup?: ReadonlyMap<string, G>;\n  phone: boolean;\n}\n\nexport interface SettingsLocationResult<G extends string> {\n  group: G | null;\n  sub: string | null;\n  /** The path (with query) to replace the location with, or `null` when it is already\n   *  canonical. */\n  redirect: string | null;\n}\n\n/**\n * Where a location lands on the settings page — pure, so the rules of §3.1 are testable\n * without a router:\n *\n *  - `/settings` → the default group on a desktop (a replace), the list on a phone;\n *  - `/settings/<group>[/<sub>]` → that group, the rest of the path as `sub`;\n *  - an alias → its successor, with a replace, `sub`, query and hash kept;\n *  - an unknown or hidden group → the default group (desktop) or the list (phone), with\n *    a replace and the query kept — never a 404, so an old bookmark still lands;\n *  - keksdose's legacy `/settings?<query>#<group>[/<sub>]` →\n *    `/settings/<group>[/<sub>]?<query>`, the WHOLE query carried (a tour's\n *    `tour`/`tourStep` as well as `focus`), then resolved by the rules above;\n *  - `/settings?focus=<anchor>` with no group → the anchor's group, where it can ring.\n */\nexport function resolveSettingsLocation<G extends string>(\n  location: SettingsLocation,\n  rules: SettingsLocationRules<G>,\n): SettingsLocationResult<G> {\n  const base = normalizeSettingsBase(rules.basePath);\n  const { pathname, search, hash } = location;\n  const known = new Set<string>(rules.groups);\n  const atBase = pathname === base || pathname === `${base}/` || (base === \"\" && pathname === \"/\");\n\n  if (atBase) {\n    const legacy = hash.replace(/^#/, \"\").replace(/^\\/+/, \"\");\n    if (legacy) {\n      // The hash becomes the path; whatever the path then says (an alias, an unknown\n      // group) is resolved in the same step, so the history sees one replace.\n      const converted = `${base}/${legacy}`;\n      const next = resolveSettingsLocation({ pathname: converted, search, hash: \"\" }, rules);\n      return { ...next, redirect: next.redirect ?? `${converted}${search}` };\n    }\n    const anchor = new URLSearchParams(search).get(\"focus\");\n    const anchorGroup = anchor ? rules.anchorGroup?.get(anchor) : undefined;\n    if (anchorGroup && known.has(anchorGroup)) {\n      return { group: anchorGroup, sub: null, redirect: `${base}/${anchorGroup}${search}` };\n    }\n    if (rules.phone || rules.defaultGroup === null) return { group: null, sub: null, redirect: null };\n    return { group: rules.defaultGroup, sub: null, redirect: `${base}/${rules.defaultGroup}${search}` };\n  }\n\n  if (!pathname.startsWith(`${base}/`)) {\n    // Mounted somewhere `basePath` does not name: a misconfiguration, not a link to\n    // correct. Show what the base path would, and leave the address alone.\n    return { group: rules.phone ? null : rules.defaultGroup, sub: null, redirect: null };\n  }\n  const rest = pathname.slice(base.length + 1);\n  const [segment = \"\", ...subParts] = rest.split(\"/\");\n  const sub = subParts.filter(Boolean).join(\"/\") || null;\n  if (known.has(segment)) return { group: segment as G, sub, redirect: null };\n\n  const successor = rules.aliases?.[segment];\n  if (successor !== undefined && known.has(successor)) {\n    return {\n      group: successor,\n      sub,\n      redirect: `${base}/${successor}${sub ? `/${sub}` : \"\"}${search}${hash}`,\n    };\n  }\n\n  // Unknown or hidden. The hash is dropped: on the list it would read as a legacy group\n  // and send the page round again.\n  if (rules.phone || rules.defaultGroup === null) {\n    return { group: null, sub: null, redirect: `${base || \"/\"}${search}` };\n  }\n  return { group: rules.defaultGroup, sub: null, redirect: `${base}/${rules.defaultGroup}${search}` };\n}\n\n/**\n * The settings page's route (docs/settings-harmonization.md §3.1): which group the URL\n * names, and the history rules for moving between groups.\n *\n * The URL IS the selection, as it was in keksdose (where it was the hash): there is no\n * state to keep in step with it, so a deep link, a reload, back and forward all land\n * where the address says. Everything that is not canonical — `/settings` on a desktop, a\n * legacy hash, an alias, an unknown or hidden group — is replaced by its canonical path.\n *\n * **The replace runs on every navigation**, keyed on `location.key`, not once on mount:\n * the router keeps the page mounted across links followed inside the app — keksdose's\n * inbox renders admin-typed URLs, and a push click routes an open window without a\n * reload — so a legacy `/settings#security` arriving while the page is open converts too\n * (§10.1).\n */\nexport function useSettingsRoute<G extends string>(options: UseSettingsRouteOptions<G>): SettingsRoute<G> {\n  const { groups, entries, basePath, defaultGroup, aliases, layout = \"auto\" } = options;\n  const location = useLocation();\n  const navigate = useNavigate();\n  const narrow = usePhoneLayout();\n  const phone = layout === \"phone\" || (layout === \"auto\" && narrow);\n  const base = normalizeSettingsBase(basePath);\n\n  const visible = useMemo(() => visibleSettingsGroups(groups, entries), [groups, entries]);\n  const anchorGroup = useMemo(() => {\n    const map = new Map<string, G>();\n    for (const e of entries ?? []) if (e.visible !== false && !map.has(e.anchor)) map.set(e.anchor, e.group);\n    return map;\n  }, [entries]);\n  const ids = visible.map((g) => g.id);\n  const fallback = defaultGroup !== undefined && ids.includes(defaultGroup) ? defaultGroup : (ids[0] ?? null);\n\n  const { group, sub, redirect } = resolveSettingsLocation(location, {\n    basePath: base,\n    groups: ids,\n    defaultGroup: fallback,\n    aliases,\n    anchorGroup,\n    phone,\n  });\n\n  const { key, state, search } = location;\n  useEffect(() => {\n    // `state` rides along: the marker describes the entry BEFORE this one, which a\n    // replace does not change.\n    if (redirect) navigate(redirect, { replace: true, state });\n  }, [key, redirect, state, navigate]);\n\n  const select = useCallback(\n    (next: G) => {\n      const to = `${base}/${next}`;\n      // From the list, the push marks it, so the group page's back is a real back.\n      if (phone) navigate(to, group === null ? { state: settingsFromListState() } : undefined);\n      // A new group is a new page: the old one's query (a focus, a roster filter) stays\n      // behind, as keksdose's `selectGroup` left it.\n      else navigate(to, { replace: true, state });\n    },\n    [base, phone, group, state, navigate],\n  );\n\n  const selectSub = useCallback(\n    (next: string | null) => {\n      if (group === null) return;\n      navigate(`${base}/${group}${next ? `/${next}` : \"\"}${search}`, { replace: true, state });\n    },\n    [base, group, search, state, navigate],\n  );\n\n  const fromList = isFromList(state);\n  const back = useCallback(() => {\n    if (fromList) navigate(-1);\n    else navigate(base || \"/\", { replace: true });\n  }, [fromList, base, navigate]);\n\n  return {\n    group,\n    sub,\n    focus: new URLSearchParams(search).get(\"focus\"),\n    select,\n    selectSub,\n    back,\n    groups: visible,\n    phone,\n    redirecting: redirect !== null,\n    fromList,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/shell/app-shell.js

@@ -1,6 +1,16 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { createContext, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useId,
+  useLayoutEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
 import { createPortal } from "react-dom";
 import { Link, NavLink, matchPath, useHref, useLocation } from "react-router";
 import { ChevronRight, MoreHorizontal, PanelLeftClose, PanelLeftOpen } from "lucide-react";
@@ -88,9 +98,7 @@ function useNavHeightVar(ref, shellRef, embedded) {
     const node = ref.current;
     const shell = shellRef.current;
     const global = !embedded && !shell?.parentElement?.closest("[data-app-shell]");
-    const targets = [shell, global ? document.documentElement : null].filter(
-      (el) => el !== null
-    );
+    const targets = [shell, global ? document.documentElement : null].filter((el) => el !== null);
     const publish = () => {
       const value = `${node ? Math.floor(node.getBoundingClientRect().height) : 0}px`;
       for (const el of targets) el.style.setProperty("--app-nav-h", value);
@@ -263,30 +271,23 @@ function AppShell({
               footer
             ] })
           ] }),
-          /* @__PURE__ */ jsxs(
-            "div",
-            {
-              ref: navRef,
-              className: "md:hidden fixed bottom-0 inset-x-0 z-30 border-t border-subtle bg-surface",
-              children: [
-                mobileSubNav && /* @__PURE__ */ jsx(MobileSubNav, { nav, layout: mobileSubNavLayout }),
-                /* @__PURE__ */ jsxs(
-                  "nav",
-                  {
-                    "data-tour": "nav",
-                    className: "grid",
-                    style: { gridTemplateColumns: `repeat(${barNav.length + (moreNav.length ? 1 : 0)}, minmax(0, 1fr))` },
-                    children: [
-                      barNav.map(
-                        (item) => item.items?.length ? /* @__PURE__ */ jsx(MobileGroupCell, { item, labels: moreLabels }, item.to) : /* @__PURE__ */ jsx(MobileNavItem, { item }, item.to)
-                      ),
-                      moreNav.length > 0 && /* @__PURE__ */ jsx(MobileMoreCell, { hidden: moreNav, labels: moreLabels })
-                    ]
-                  }
-                )
-              ]
-            }
-          )
+          /* @__PURE__ */ jsxs("div", { ref: navRef, className: "md:hidden fixed bottom-0 inset-x-0 z-30 border-t border-subtle bg-surface", children: [
+            mobileSubNav && /* @__PURE__ */ jsx(MobileSubNav, { nav, layout: mobileSubNavLayout }),
+            /* @__PURE__ */ jsxs(
+              "nav",
+              {
+                "data-tour": "nav",
+                className: "grid",
+                style: { gridTemplateColumns: `repeat(${barNav.length + (moreNav.length ? 1 : 0)}, minmax(0, 1fr))` },
+                children: [
+                  barNav.map(
+                    (item) => item.items?.length ? /* @__PURE__ */ jsx(MobileGroupCell, { item, labels: moreLabels }, item.to) : /* @__PURE__ */ jsx(MobileNavItem, { item }, item.to)
+                  ),
+                  moreNav.length > 0 && /* @__PURE__ */ jsx(MobileMoreCell, { hidden: moreNav, labels: moreLabels })
+                ]
+              }
+            )
+          ] })
         ]
       }
     ) })
@@ -455,7 +456,17 @@ function MobileGroupCell({
     /* @__PURE__ */ jsx(TourAnchor, { to: item.to, dataTour: item.dataTour }),
     pages.filter((sub) => sub.to !== item.to).map((sub) => /* @__PURE__ */ jsx(TourAnchor, { to: sub.to }, sub.to)),
     /* @__PURE__ */ jsx(DialogFrame, { open, onClose: close, title: item.label, closeButton: true, bodyClassName: "space-y-1", children: /* @__PURE__ */ jsxs("ul", { className: "space-y-1", children: [
-      !ownPageListed && /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(SheetLink, { to: item.to, end: item.end, icon: item.icon, label: labels.overview, onClick: close, level: "entry" }) }),
+      !ownPageListed && /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+        SheetLink,
+        {
+          to: item.to,
+          end: item.end,
+          icon: item.icon,
+          label: labels.overview,
+          onClick: close,
+          level: "entry"
+        }
+      ) }),
       pages.map((sub) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(SheetLink, { to: sub.to, end: sub.end, icon: sub.icon, label: sub.label, onClick: close, level: "entry" }) }, sub.to))
     ] }) })
   ] });
@@ -508,8 +519,28 @@ function MobileMoreCell({
       ...(item.items ?? []).map((sub) => /* @__PURE__ */ jsx(TourAnchor, { to: sub.to }, `${item.to} ${sub.to}`))
     ]),
     /* @__PURE__ */ jsx(DialogFrame, { open, onClose: close, title: labels.moreTitle, closeButton: true, bodyClassName: "space-y-1", children: /* @__PURE__ */ jsx("ul", { className: "space-y-1", children: hidden.map((item) => /* @__PURE__ */ jsxs("li", { children: [
-      /* @__PURE__ */ jsx(SheetLink, { to: item.to, end: item.end, icon: item.icon, label: item.label, onClick: close, level: "entry" }),
-      !!item.items?.length && /* @__PURE__ */ jsx("ul", { "aria-label": item.label, className: "ms-[1.3rem] mt-0.5 space-y-0.5 border-s border-subtle ps-2", children: item.items.map((sub) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(SheetLink, { to: sub.to, end: sub.end, icon: sub.icon, label: sub.label, onClick: close, level: "page" }) }, sub.to)) })
+      /* @__PURE__ */ jsx(
+        SheetLink,
+        {
+          to: item.to,
+          end: item.end,
+          icon: item.icon,
+          label: item.label,
+          onClick: close,
+          level: "entry"
+        }
+      ),
+      !!item.items?.length && /* @__PURE__ */ jsx("ul", { "aria-label": item.label, className: "ms-[1.3rem] mt-0.5 space-y-0.5 border-s border-subtle ps-2", children: item.items.map((sub) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+        SheetLink,
+        {
+          to: sub.to,
+          end: sub.end,
+          icon: sub.icon,
+          label: sub.label,
+          onClick: close,
+          level: "page"
+        }
+      ) }, sub.to)) })
     ] }, item.to)) }) })
   ] });
 }