@eifi1/ui-kit 0.51.4 → 0.51.6

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":"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","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":";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,SACE,OAAO,UAAU,YAAY,UAAU,QAAS,MAAkC,wBAAwB,MAAM;AAEpH;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,WAAW,iBAAiB,UAAa,IAAI,SAAS,YAAY,IAAI,eAAgB,IAAI,CAAC,KAAK;AAEtG,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":[]}

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)) }) })
   ] });
 }