@eifi1/ui-kit 0.51.6 → 0.51.7

package/dist/tour/use-tour-url-sync.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tour/use-tour-url-sync.ts"],"sourcesContent":["import { createContext, useContext, useEffect, useLayoutEffect, useRef, useState, type Context } from \"react\";\nimport * as ReactRouter from \"react-router\";\nimport { useLocation, useNavigate, type Navigator } from \"react-router\";\nimport { useSearchParamsState } from \"../hooks/use-search-param-state\";\nimport { useTourOptional, type TourEngine, type TourStart } from \"./tour\";\nimport { liveEngine } from \"./tour-engine\";\nimport { devWarnings } from \"./tour-gates\";\n\n/* ── useTourUrlSync ─────────────────────────────────────────────────────────── */\n\nexport interface UseTourUrlSyncOptions {\n  /**\n   * Start the tour `id` at `startIndex` (0-based) — the app's launcher, which builds the\n   * steps, awaits its own `prepare()` and passes `onFinish` (the completion, the points\n   * toast) to `useTour().start`. An unknown id should do nothing. May return a promise:\n   * the parameters are kept until it settles. Under a `TourProvider` the third argument is\n   * that provider's `start` (0.50, as `TourProvider launch` gets it), so one launcher serves\n   * both; the fourth is its whole engine, read live (0.50.1, `TourEngine`: `stop`, `next`,\n   * `active`, …). Without a provider `start` and the engine's methods do nothing (a\n   * development build warns) and the engine reads as idle.\n   */\n  launch: (\n    id: string,\n    options: { startIndex: number },\n    start: TourStart,\n    engine: TourEngine,\n  ) => void | Promise<unknown>;\n  /**\n   * Are the facts a tour's steps are built from loaded yet (keksdose's `ready`: the\n   * caches a branching tour reads)? A deep link waits for it, keeping its parameters, so\n   * an F5 mid-tour resumes the right variant at the right step. Default `true`.\n   */\n  ready?: boolean;\n  /**\n   * Older names of `tourStep`, read when it is absent and removed with it — kastlan's\n   * `ts` (§2.7, for one minor). Their value is a 0-based step index, as kastlan wrote it.\n   */\n  stepAliases?: readonly string[];\n}\n\ntype Place = { pathname: string; search: string; hash: string };\n\n/**\n * Has the router already moved on from the location React is still rendering?\n * keksdose's check (tour-url-sync.tsx, tours audit 2026-10-02): a mirror write built\n * from the page being LEFT is a replace back onto it, which cancels a step's `go()`.\n *\n * - A data router (`createBrowserRouter`, kastlan): its navigator has no location (build\n *   review 0.43, kastlan A2), so the router's own state answers — a navigation still\n *   loading, or a location it has committed that React has not rendered yet.\n * - A declarative router (`BrowserRouter`, keksdose): its navigator is its history and\n *   carries where it is.\n * - Anything else answers \"not in flight\".\n */\nfunction navigationInFlight(history: Navigator | undefined, dataRouter: DataRouterProbe, rendered: Place) {\n  const state = dataRouter?.router?.state;\n  if (state && (state.navigation?.state ?? \"idle\") !== \"idle\") return true;\n  const live = state?.location ?? (history as (Navigator & { location?: Partial<Place> }) | undefined)?.location;\n  if (!live) return false;\n  return (\n    live.pathname !== rendered.pathname ||\n    (live.search ?? \"\") !== rendered.search ||\n    (live.hash ?? \"\") !== rendered.hash\n  );\n}\n\ntype NavigationProbe = { navigator?: Navigator } | null;\nconst NO_NAVIGATION = createContext<NavigationProbe>(null);\n/** The data router's state, as `useSearchParamState` reads it. */\ntype DataRouterProbe = {\n  router?: { state?: { navigation?: { state?: string }; location?: Partial<Place> } };\n} | null;\nconst NO_DATA_ROUTER = createContext<DataRouterProbe>(null);\nconst DataRouterContext: Context<DataRouterProbe> = (() => {\n  try {\n    return (\n      (ReactRouter as unknown as { UNSAFE_DataRouterContext?: Context<DataRouterProbe> }).UNSAFE_DataRouterContext ??\n      NO_DATA_ROUTER\n    );\n  } catch {\n    return NO_DATA_ROUTER;\n  }\n})();\n/** Read off the namespace inside a `try`, as `useSearchParamState` reads the data router:\n *  a test's partial `vi.mock(\"react-router\")` throws on an export it does not define. */\nconst NavigationContext: Context<NavigationProbe> = (() => {\n  try {\n    return (\n      (ReactRouter as unknown as { UNSAFE_NavigationContext?: Context<NavigationProbe> }).UNSAFE_NavigationContext ??\n      NO_NAVIGATION\n    );\n  } catch {\n    return NO_NAVIGATION;\n  }\n})();\n\n/** The step a link asks for, 0-based: `tourStep` is 1-based (keksdose), an alias 0-based. */\nfunction stepOf(params: URLSearchParams, aliases: readonly string[]): number {\n  const step = Number(params.get(\"tourStep\"));\n  if (params.has(\"tourStep\")) return Number.isFinite(step) && step > 0 ? step - 1 : 0;\n  for (const alias of aliases) {\n    const value = Number(params.get(alias));\n    if (params.has(alias)) return Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;\n  }\n  return 0;\n}\n\n/**\n * Tours and the URL (docs/tours-harmonization.md §2.7, §6.4) — keksdose's `TourUrlSync`,\n * on the kit's engine (`useTourOptional`):\n *\n * - **`?tour=<id>` starts that tour whenever it APPEARS** — on load, and on in-app\n *   navigation too (kastlan's assistant links to `/help/tours?tour=<id>`, ka F4) —\n *   resuming at `&tourStep=<n>` (1-based). It waits for `ready`.\n * - **While a tour runs, `?tour=&tourStep=` mirror where it is**, so a reload or a copied\n *   link pins the step (kk K-3). A step that navigates drops them; this puts them back.\n * - **At the end it strips only its own parameters**; `?q=`, `?state=` and the hash stay.\n *\n * Mount it once inside the router and the `TourProvider`. Without a provider it still\n * launches through `launch` and never mirrors.\n */\nexport function useTourUrlSync({ launch, ready = true, stepAliases = [] }: UseTourUrlSyncOptions): void {\n  const navigate = useNavigate();\n  const location = useLocation();\n  const { pathname, search, hash } = location;\n  const history = useContext(NavigationContext)?.navigator;\n  const dataRouter = useContext(DataRouterContext);\n  const engine = useTourOptional();\n  const active = engine?.active ?? false;\n  const activeId = engine?.activeId ?? null;\n  const index = engine?.index ?? 0;\n  const urlTour = new URLSearchParams(search).get(\"tour\");\n  const aliases = stepAliases.join(\"\\n\");\n\n  const launchRef = useRef(launch);\n  const startRef = useRef<TourStart>(engine?.start ?? noProviderStart);\n  const [live] = useState(() => liveEngine<TourEngine>(ENGINE_KEYS, NO_PROVIDER_ENGINE));\n  const activeIdRef = useRef(activeId);\n  useLayoutEffect(() => {\n    launchRef.current = launch;\n    startRef.current = engine?.start ?? noProviderStart;\n    live.set(engine ?? NO_PROVIDER_ENGINE);\n    activeIdRef.current = active ? activeId : null;\n  });\n  /** The `tour` value last seen in the URL: a tour starts when it CHANGES to an id. */\n  const seenRef = useRef<string | null>(null);\n  /** A deep link waiting for `ready`. */\n  const pendingRef = useRef<{ id: string; startIndex: number } | null>(null);\n  /** A launch under way (an app's `prepare()`). */\n  const launchingRef = useRef(false);\n  /** Bumped when a launch settles, so the mirror looks again. */\n  const [settled, setSettled] = useState(0);\n\n  useEffect(() => {\n    if (urlTour !== seenRef.current) {\n      seenRef.current = urlTour;\n      // Its own mirror writing the running tour back is no new link.\n      pendingRef.current =\n        urlTour && urlTour !== activeIdRef.current\n          ? { id: urlTour, startIndex: stepOf(new URLSearchParams(search), aliases ? aliases.split(\"\\n\") : []) }\n          : null;\n    }\n    const pending = pendingRef.current;\n    if (!pending || !ready) return;\n    pendingRef.current = null;\n    launchingRef.current = true;\n    void Promise.resolve()\n      .then(() => launchRef.current(pending.id, { startIndex: pending.startIndex }, startRef.current, live.engine))\n      .catch(() => undefined)\n      .finally(() => {\n        launchingRef.current = false;\n        setSettled((n) => n + 1);\n      });\n    // Only a change of the parameter, or readiness, starts a tour.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [urlTour, ready]);\n\n  useEffect(() => {\n    if (navigationInFlight(history, dataRouter, { pathname, search, hash })) return;\n    // A link not yet used keeps its parameters: a reload in that window resumes.\n    if (pendingRef.current || launchingRef.current) return;\n    const tourId = active && activeId ? activeId : null;\n    const own = [\"tour\", \"tourStep\", ...(aliases ? aliases.split(\"\\n\") : [])];\n    const current = new URLSearchParams(search);\n    // Nothing to mirror and nothing to strip: never touch the URL (a no-op replace\n    // clobbers a page's own just-issued navigation, keksdose feedback #4).\n    if (!tourId && !own.some((key) => current.has(key))) return;\n    const next = new URLSearchParams(search);\n    // `set` keeps a parameter where it stands; only the aliases (and, at the end, the\n    // tour's own) go.\n    for (const key of tourId ? own.slice(2) : own) next.delete(key);\n    if (tourId) {\n      next.set(\"tour\", tourId);\n      next.set(\"tourStep\", String(index + 1));\n    }\n    if (next.toString() === current.toString()) return;\n    // Spelled out, not `setSearchParams` (\"?…\" drops the hash, keksdose dev#495).\n    void navigate({ pathname, search: next.toString(), hash }, { replace: true, state: location.state });\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [active, activeId, index, pathname, search, hash, settled, aliases]);\n}\n\n/** `start` for a launcher run with no `TourProvider` above `useTourUrlSync`. */\nconst noProviderStart: TourStart = () => {\n  if (devWarnings()) console.warn(\"[ui-kit] useTourUrlSync: the launcher's start needs a TourProvider above it.\");\n};\n\nconst noProviderCall = () => {\n  if (devWarnings()) console.warn(\"[ui-kit] useTourUrlSync: the launcher's engine needs a TourProvider above it.\");\n};\n/** The engine for a launcher run with no `TourProvider` above `useTourUrlSync`: idle. */\nconst NO_PROVIDER_ENGINE: TourEngine = {\n  active: false,\n  activeId: null,\n  start: noProviderStart,\n  stop: noProviderCall,\n  next: noProviderCall,\n  prev: noProviderCall,\n  goToStep: noProviderCall,\n  index: 0,\n  total: 0,\n  position: 0,\n  count: 0,\n};\nconst ENGINE_KEYS = Object.keys(NO_PROVIDER_ENGINE) as (keyof TourEngine)[];\n\n/* ── useTourCatalogueUrlState ───────────────────────────────────────────────── */\n\n/** The catalogue's state filter. */\nexport type TourStateFilter = \"all\" | \"todo\" | \"done\";\n\n/** The catalogue's filters: the search, the group (`null`: every group), the state. */\nexport interface TourCatalogueFilter {\n  query: string;\n  group: string | null;\n  state: TourStateFilter;\n}\n\nconst STATES: readonly TourStateFilter[] = [\"all\", \"todo\", \"done\"];\n\n/**\n * The catalogue's filters in the URL (§2.8) — keksdose's `?q`, `?topic`, `?state`, each\n * written with `replace` (typing does not bury the Back button), the defaults as the\n * clean URL. Spread it onto the catalogue: `<TourCatalogue {...useTourCatalogueUrlState()} … />`.\n * `params` renames them (kastlan's `?group`). Requires a react-router Router.\n */\nexport function useTourCatalogueUrlState(\n  params: { query?: string; group?: string; state?: string } = {},\n): TourCatalogueFilter & { onChange: (patch: Partial<TourCatalogueFilter>) => void } {\n  const [filter, setFilter] = useSearchParamsState<TourCatalogueFilter>({\n    query: { param: params.query ?? \"q\", default: \"\", history: \"replace\" },\n    group: { param: params.group ?? \"topic\", default: null, history: \"replace\", parse: (raw) => raw || undefined },\n    state: {\n      param: params.state ?? \"state\",\n      default: \"all\",\n      history: \"replace\",\n      parse: (raw) => STATES.find((x) => x === raw),\n    },\n  });\n  // `group: null` is a value to the setter (it clears `?topic`); `undefined` leaves it.\n  return { ...filter, onChange: setFilter };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tour/use-tour-url-sync.ts"],"sourcesContent":["import { createContext, useContext, useEffect, useLayoutEffect, useRef, useState, type Context } from \"react\";\nimport * as ReactRouter from \"react-router\";\nimport { useLocation, useNavigate, type Navigator } from \"react-router\";\nimport { useSearchParamsState } from \"../hooks/use-search-param-state\";\nimport { useTourOptional, type TourEngine, type TourStart } from \"./tour\";\nimport { liveEngine } from \"./tour-engine\";\nimport { devWarnings } from \"./tour-gates\";\n\n/* ── useTourUrlSync ─────────────────────────────────────────────────────────── */\n\nexport interface UseTourUrlSyncOptions {\n  /**\n   * Start the tour `id` at `startIndex` (0-based) — the app's launcher, which builds the\n   * steps, awaits its own `prepare()` and passes `onFinish` (the completion, the points\n   * toast) to `useTour().start`. An unknown id should do nothing. May return a promise:\n   * the parameters are kept until it settles. Under a `TourProvider` the third argument is\n   * that provider's `start` (0.50, as `TourProvider launch` gets it), so one launcher serves\n   * both; the fourth is its whole engine, read live (0.50.1, `TourEngine`: `stop`, `next`,\n   * `active`, …). Without a provider `start` and the engine's methods do nothing (a\n   * development build warns) and the engine reads as idle.\n   */\n  launch: (\n    id: string,\n    options: { startIndex: number },\n    start: TourStart,\n    engine: TourEngine,\n  ) => void | Promise<unknown>;\n  /**\n   * Are the facts a tour's steps are built from loaded yet (keksdose's `ready`: the\n   * caches a branching tour reads)? A deep link waits for it, keeping its parameters, so\n   * an F5 mid-tour resumes the right variant at the right step. Default `true`.\n   */\n  ready?: boolean;\n  /**\n   * Older names of `tourStep`, read when it is absent and removed with it — kastlan's\n   * `ts` (§2.7, for one minor). Their value is a 0-based step index, as kastlan wrote it.\n   */\n  stepAliases?: readonly string[];\n}\n\ntype Place = { pathname: string; search: string; hash: string };\n\n/**\n * Has the router already moved on from the location React is still rendering?\n * keksdose's check (tour-url-sync.tsx, tours audit 2026-10-02): a mirror write built\n * from the page being LEFT is a replace back onto it, which cancels a step's `go()`.\n *\n * - A data router (`createBrowserRouter`, kastlan): its navigator has no location (build\n *   review 0.43, kastlan A2), so the router's own state answers — a navigation still\n *   loading, or a location it has committed that React has not rendered yet.\n * - A declarative router (`BrowserRouter`, keksdose): its navigator is its history and\n *   carries where it is.\n * - Anything else answers \"not in flight\".\n */\nfunction navigationInFlight(history: Navigator | undefined, dataRouter: DataRouterProbe, rendered: Place) {\n  const state = dataRouter?.router?.state;\n  if (state && (state.navigation?.state ?? \"idle\") !== \"idle\") return true;\n  const live = state?.location ?? (history as (Navigator & { location?: Partial<Place> }) | undefined)?.location;\n  if (!live) return false;\n  return (\n    live.pathname !== rendered.pathname ||\n    (live.search ?? \"\") !== rendered.search ||\n    (live.hash ?? \"\") !== rendered.hash\n  );\n}\n\ntype NavigationProbe = { navigator?: Navigator } | null;\nconst NO_NAVIGATION = createContext<NavigationProbe>(null);\n/** The data router's state, as `useSearchParamState` reads it. */\ntype DataRouterProbe = {\n  router?: { state?: { navigation?: { state?: string }; location?: Partial<Place> } };\n} | null;\nconst NO_DATA_ROUTER = createContext<DataRouterProbe>(null);\nconst DataRouterContext: Context<DataRouterProbe> = (() => {\n  try {\n    return (\n      (ReactRouter as unknown as { UNSAFE_DataRouterContext?: Context<DataRouterProbe> }).UNSAFE_DataRouterContext ??\n      NO_DATA_ROUTER\n    );\n  } catch {\n    return NO_DATA_ROUTER;\n  }\n})();\n/** Read off the namespace inside a `try`, as `useSearchParamState` reads the data router:\n *  a test's partial `vi.mock(\"react-router\")` throws on an export it does not define. */\nconst NavigationContext: Context<NavigationProbe> = (() => {\n  try {\n    return (\n      (ReactRouter as unknown as { UNSAFE_NavigationContext?: Context<NavigationProbe> }).UNSAFE_NavigationContext ??\n      NO_NAVIGATION\n    );\n  } catch {\n    return NO_NAVIGATION;\n  }\n})();\n\n/** The step a link asks for, 0-based: `tourStep` is 1-based (keksdose), an alias 0-based.\n *  Floored, as the aliases always were (FLW-9): `?tourStep=2.5` was index 1.5. */\nfunction stepOf(params: URLSearchParams, aliases: readonly string[]): number {\n  const step = Number(params.get(\"tourStep\"));\n  if (params.has(\"tourStep\")) return Number.isFinite(step) && step >= 1 ? Math.floor(step) - 1 : 0;\n  for (const alias of aliases) {\n    const value = Number(params.get(alias));\n    if (params.has(alias)) return Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;\n  }\n  return 0;\n}\n\n/**\n * Tours and the URL (docs/tours-harmonization.md §2.7, §6.4) — keksdose's `TourUrlSync`,\n * on the kit's engine (`useTourOptional`):\n *\n * - **`?tour=<id>` starts that tour whenever it APPEARS** — on load, and on in-app\n *   navigation too (kastlan's assistant links to `/help/tours?tour=<id>`, ka F4) —\n *   resuming at `&tourStep=<n>` (1-based). It waits for `ready`.\n * - **While a tour runs, `?tour=&tourStep=` mirror where it is**, so a reload or a copied\n *   link pins the step (kk K-3). A step that navigates drops them; this puts them back.\n * - **At the end it strips only its own parameters**; `?q=`, `?state=` and the hash stay.\n *\n * Mount it once inside the router and the `TourProvider`. Without a provider it still\n * launches through `launch` and never mirrors.\n */\nexport function useTourUrlSync({ launch, ready = true, stepAliases = [] }: UseTourUrlSyncOptions): void {\n  const navigate = useNavigate();\n  const location = useLocation();\n  const { pathname, search, hash } = location;\n  const history = useContext(NavigationContext)?.navigator;\n  const dataRouter = useContext(DataRouterContext);\n  const engine = useTourOptional();\n  const active = engine?.active ?? false;\n  const activeId = engine?.activeId ?? null;\n  const index = engine?.index ?? 0;\n  const urlTour = new URLSearchParams(search).get(\"tour\");\n  const aliases = stepAliases.join(\"\\n\");\n\n  const launchRef = useRef(launch);\n  const startRef = useRef<TourStart>(engine?.start ?? noProviderStart);\n  const [live] = useState(() => liveEngine<TourEngine>(ENGINE_KEYS, NO_PROVIDER_ENGINE));\n  const activeIdRef = useRef(activeId);\n  useLayoutEffect(() => {\n    launchRef.current = launch;\n    startRef.current = engine?.start ?? noProviderStart;\n    live.set(engine ?? NO_PROVIDER_ENGINE);\n    activeIdRef.current = active ? activeId : null;\n  });\n  /** The `tour` value last seen in the URL: a tour starts when it CHANGES to an id. */\n  const seenRef = useRef<string | null>(null);\n  /** A deep link waiting for `ready`. */\n  const pendingRef = useRef<{ id: string; startIndex: number } | null>(null);\n  /** A launch under way (an app's `prepare()`). */\n  const launchingRef = useRef(false);\n  /** Bumped when a launch settles, so the mirror looks again. */\n  const [settled, setSettled] = useState(0);\n\n  useEffect(() => {\n    if (urlTour !== seenRef.current) {\n      seenRef.current = urlTour;\n      // Its own mirror writing the running tour back is no new link.\n      pendingRef.current =\n        urlTour && urlTour !== activeIdRef.current\n          ? { id: urlTour, startIndex: stepOf(new URLSearchParams(search), aliases ? aliases.split(\"\\n\") : []) }\n          : null;\n    }\n    const pending = pendingRef.current;\n    if (!pending || !ready) return;\n    pendingRef.current = null;\n    launchingRef.current = true;\n    void Promise.resolve()\n      .then(() => launchRef.current(pending.id, { startIndex: pending.startIndex }, startRef.current, live.engine))\n      // Said, as `TourProvider`'s own `launch` path says it (FLW-9): swallowed, a launch\n      // that failed was a tour that silently did not start — in kastlan after its\n      // launcher had already turned practice mode on.\n      .catch((error: unknown) => console.error(error))\n      .finally(() => {\n        launchingRef.current = false;\n        setSettled((n) => n + 1);\n      });\n    // Only a change of the parameter, or readiness, starts a tour.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [urlTour, ready]);\n\n  useEffect(() => {\n    if (navigationInFlight(history, dataRouter, { pathname, search, hash })) return;\n    // A link not yet used keeps its parameters: a reload in that window resumes.\n    if (pendingRef.current || launchingRef.current) return;\n    const tourId = active && activeId ? activeId : null;\n    const own = [\"tour\", \"tourStep\", ...(aliases ? aliases.split(\"\\n\") : [])];\n    const current = new URLSearchParams(search);\n    // Nothing to mirror and nothing to strip: never touch the URL (a no-op replace\n    // clobbers a page's own just-issued navigation, keksdose feedback #4).\n    if (!tourId && !own.some((key) => current.has(key))) return;\n    const next = new URLSearchParams(search);\n    // `set` keeps a parameter where it stands; only the aliases (and, at the end, the\n    // tour's own) go.\n    for (const key of tourId ? own.slice(2) : own) next.delete(key);\n    if (tourId) {\n      next.set(\"tour\", tourId);\n      next.set(\"tourStep\", String(index + 1));\n    }\n    if (next.toString() === current.toString()) return;\n    // Spelled out, not `setSearchParams` (\"?…\" drops the hash, keksdose dev#495).\n    void navigate({ pathname, search: next.toString(), hash }, { replace: true, state: location.state });\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [active, activeId, index, pathname, search, hash, settled, aliases]);\n}\n\n/** `start` for a launcher run with no `TourProvider` above `useTourUrlSync`. */\nconst noProviderStart: TourStart = () => {\n  if (devWarnings()) console.warn(\"[ui-kit] useTourUrlSync: the launcher's start needs a TourProvider above it.\");\n};\n\nconst noProviderCall = () => {\n  if (devWarnings()) console.warn(\"[ui-kit] useTourUrlSync: the launcher's engine needs a TourProvider above it.\");\n};\n/** The engine for a launcher run with no `TourProvider` above `useTourUrlSync`: idle. */\nconst NO_PROVIDER_ENGINE: TourEngine = {\n  active: false,\n  activeId: null,\n  start: noProviderStart,\n  stop: noProviderCall,\n  next: noProviderCall,\n  prev: noProviderCall,\n  goToStep: noProviderCall,\n  index: 0,\n  total: 0,\n  position: 0,\n  count: 0,\n};\nconst ENGINE_KEYS = Object.keys(NO_PROVIDER_ENGINE) as (keyof TourEngine)[];\n\n/* ── useTourCatalogueUrlState ───────────────────────────────────────────────── */\n\n/** The catalogue's state filter. */\nexport type TourStateFilter = \"all\" | \"todo\" | \"done\";\n\n/** The catalogue's filters: the search, the group (`null`: every group), the state. */\nexport interface TourCatalogueFilter {\n  query: string;\n  group: string | null;\n  state: TourStateFilter;\n}\n\nconst STATES: readonly TourStateFilter[] = [\"all\", \"todo\", \"done\"];\n\n/**\n * The catalogue's filters in the URL (§2.8) — keksdose's `?q`, `?topic`, `?state`, each\n * written with `replace` (typing does not bury the Back button), the defaults as the\n * clean URL. Spread it onto the catalogue: `<TourCatalogue {...useTourCatalogueUrlState()} … />`.\n * `params` renames them (kastlan's `?group`). Requires a react-router Router.\n */\nexport function useTourCatalogueUrlState(\n  params: { query?: string; group?: string; state?: string } = {},\n): TourCatalogueFilter & { onChange: (patch: Partial<TourCatalogueFilter>) => void } {\n  const [filter, setFilter] = useSearchParamsState<TourCatalogueFilter>({\n    query: { param: params.query ?? \"q\", default: \"\", history: \"replace\" },\n    group: { param: params.group ?? \"topic\", default: null, history: \"replace\", parse: (raw) => raw || undefined },\n    state: {\n      param: params.state ?? \"state\",\n      default: \"all\",\n      history: \"replace\",\n      parse: (raw) => STATES.find((x) => x === raw),\n    },\n  });\n  // `group: null` is a value to the setter (it clears `?topic`); `undefined` leaves it.\n  return { ...filter, onChange: setFilter };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eifi1/ui-kit",
-  "version": "0.51.6",
+  "version": "0.51.7",
   "type": "module",
   "description": "App-agnostic shared design system: domain-free React components, theme and tokens.",
   "_sideEffects": "The barrel (src/index.ts) re-exports EVERY component, including components/chart, which statically imports recharts. Without this field a bundler must assume each of those modules has side effects, so it cannot drop the unused ones: importing a Button from '@eifi1/ui-kit' dragged all 433KB of recharts into the consumer's ENTRY chunk, and Keksdose was preloading it on every page load, login included. Nothing in src/ imports for side effects (no bare imports, no CSS imports from JS, no module-level global writes) — the token stylesheet is its own './tokens.css' export — so this is safe. CSS is still listed so any future stylesheet survives. Re-checked when `flag-icons` left `dependencies` and tsup started emitting a `\"use client\"` banner: neither touches this. The flag stylesheet was never imported from JS in the first place (that was the finding), and a directive prologue is a string literal every bundler lifts out before it decides whether a module is inert.",
@@ -140,7 +140,7 @@
     "@testing-library/react": ">=16",
     "dexie": "^4",
     "idb-keyval": "^6",
-    "lucide-react": ">=0.400.0 <2",
+    "lucide-react": ">=0.577.0 <2",
     "modern-screenshot": "^4.7.0",
     "react": ">=19.2",
     "react-dom": ">=19.2",
@@ -178,7 +178,7 @@
       "optional": true
     }
   },
-  "_dependencies": "Only what the package imports AND owns the version of. `lucide-react` is a PEER: every consumer already declares `lucide-react: ^0.511.0` itself, so a hard dependency here bought each of them a second copy of the icon set in node_modules — and pinned to 0.511.x it held all three behind a release line that is now at 1.x. The range is deliberately wide (`>=0.400.0 <2`): the kit imports named icon components and nothing else, which has been stable across that whole span, so the app picks the version. `flag-icons` was never imported at all — 5.6 MB of stylesheet and SVG installed into every consumer to support class NAMES (`fi fi-xx`) that CurrencyFlag, CurrencySelect and LanguageMenu render as strings. The host supplies that stylesheet; see the dependency section of README.md. It stays a devDependency because the showcase imports it.",
+  "_dependencies": "Only what the package imports AND owns the version of. `lucide-react` is a PEER: every consumer already declares `lucide-react: ^0.511.0` itself, so a hard dependency here bought each of them a second copy of the icon set in node_modules — and pinned to 0.511.x it held all three behind a release line that is now at 1.x. The range is deliberately wide (`>=0.577.0 <2`): the kit imports named icon components and nothing else, so the app picks the version. Its floor is the version all three apps run, and scripts/verify-package.mjs installs that floor rather than the 1.x devDependency, so an icon that exists only in 1.x fails the kit's gate, not the apps' builds (MOD-2, refactor audit 2026-10-30; the old `>=0.400.0` floor had never been loaded by anything). `flag-icons` was never imported at all — 5.6 MB of stylesheet and SVG installed into every consumer to support class NAMES (`fi fi-xx`) that CurrencyFlag, CurrencySelect and LanguageMenu render as strings. The host supplies that stylesheet; see the dependency section of README.md. It stays a devDependency because the showcase imports it.",
   "dependencies": {
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.7.0",

package/src/admin/admin-action-confirm.tsx

@@ -1,5 +1,5 @@
 import { Children, useContext, useEffect, useId, useRef, useState } from "react";
-import type { KeyboardEvent, ReactNode } from "react";
+import type { ReactNode } from "react";
 import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
 import { AlertBanner } from "../components/alert-banner";
 import { Checkbox } from "../components/checkbox";
@@ -378,6 +378,8 @@ export function AdminActionConfirm({
         title={heading}
         description={identity}
         onClose={() => onClose(confirmed.current)}
+        // The removal offered with the refusal is a request too.
+        busy={busy}
         actions={(close) => (
           <CloseOnDone done={done}>
             <Button type="button" variant="secondary" disabled={busy} onClick={close}>
@@ -426,10 +428,7 @@ export function AdminActionConfirm({
       description={identity}
       onClose={() => onClose(confirmed.current)}
       // A request that has left cannot be called back by closing the dialog.
-      onKeyDown={(event: KeyboardEvent<HTMLDivElement>) => {
-        if (busy && event.key === "Escape") event.preventDefault();
-      }}
-      aria-busy={busy || undefined}
+      busy={busy}
       actions={(close) => (
         <CloseOnDone done={done}>
           <Button type="button" variant="ghost" disabled={busy} onClick={close}>

package/src/auth/complete-name-dialog.tsx

@@ -1,5 +1,5 @@
 import { useContext, useEffect, useId, useRef, useState } from "react";
-import type { KeyboardEvent, ReactNode } from "react";
+import type { ReactNode } from "react";
 
 import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
 import { usePromisePending } from "../components/danger-confirm";
@@ -74,8 +74,9 @@ export interface CompleteNameDialogProps {
  * complete name, no page is blocked, and the app asks again at the next sign-in.
  *
  * The promise handling is `ReauthDialog`'s: busy while `onSave` runs (the fields
- * read-only, "Later" disabled, Escape held — a request that has left cannot be called
- * back by closing the dialog), closed on resolve, kept open on reject. Save is a
+ * read-only, "Later" disabled, Escape, the backdrop and Back held — a request that has
+ * left cannot be called back by closing the dialog), closed on resolve, kept open on
+ * reject. Save is a
  * `commit` control, so a `WriteLockProvider` above it locks it with its reason — every
  * lock but a lapsed plan's (`COMMIT_EXCEPT_BILLING`, 0.33): one's own name is the
  * account's own settings, which billing never locks (docs/billing-harmonization.md §3.3,
@@ -160,10 +161,7 @@ export function CompleteNameDialog({
       title={labels.title}
       description={labels.description}
       onClose={() => onClose(saved.current)}
-      onKeyDown={(e: KeyboardEvent<HTMLDivElement>) => {
-        if (pending && e.key === "Escape") e.preventDefault();
-      }}
-      aria-busy={pending || undefined}
+      busy={pending}
       actions={
         <CompleteNameActions
           formId={formId}

package/src/billing/cancel-request.ts

@@ -1,4 +1,4 @@
-import { useState } from "react";
+import { useEffect, useState } from "react";
 
 /**
  * What the payer asked for in the app (0.43, kastlan `18bf4c0`): `"cancel"` after
@@ -8,6 +8,9 @@ import { useState } from "react";
  */
 export type CancelRequested = "cancel" | "resume" | null;
 
+/** How long a request waits for the provider's webhook: `useCheckoutProcessing`'s bound. */
+const WAIT_FOR = 10 * 60_000;
+
 /** What the page shows for the row as read now — `CancelRequest.view(rowScheduled)`. */
 export interface CancelRequestView {
   /** For `SubscriptionActions`' `cancelRequested`. */
@@ -23,7 +26,8 @@ export interface CancelRequestView {
 export interface CancelRequest {
   /** Read the overview again every few seconds while this is true — the overview query's
    *  `waiting` (kastlan's `useBillingOverview({ waiting })`, a `refetchInterval` inside) —
-   *  so the page follows the provider. Needs no overview data: pass it to the query. */
+   *  so the page follows the provider. Needs no overview data: pass it to the query.
+   *  False again after `timeoutMs` with no move of the row. */
   waiting: boolean;
   /**
    * The row as read now (the overview's `cancel_at_period_end`; `undefined` while it
@@ -54,10 +58,25 @@ export interface CancelRequest {
  *       onResume={() => resume.mutate(undefined, { onSuccess: view.noteAsked })}
  *       …
  *     />
+ *
+ * **Bounded,** as `useCheckoutProcessing` is (FLW-6): after `timeoutMs` (10 minutes)
+ * with no move of the row the request is dropped — the polling stops and the page shows
+ * the row as it is. Unbounded, a webhook that never landed kept kastlan re-reading the
+ * overview every 3 s for as long as the page was open, which also kept a Cloud Run
+ * instance awake, and the plan line said "Cancels on …" for a row that never moved.
  */
-export function useCancelRequest(): CancelRequest {
-  // What was asked, kept with the row's state it was asked against.
-  const [asked, setAsked] = useState<{ scheduled: boolean } | null>(null);
+export function useCancelRequest({ timeoutMs = WAIT_FOR }: { timeoutMs?: number } = {}): CancelRequest {
+  // What was asked, kept with the row's state it was asked against and when.
+  const [asked, setAsked] = useState<{ scheduled: boolean; at: number } | null>(null);
+  useEffect(() => {
+    if (asked === null) return;
+    // Only THIS ask: one that a later ask or the row has replaced is not dropped twice.
+    const timer = setTimeout(
+      () => setAsked((current) => (current === asked ? null : current)),
+      Math.max(0, asked.at + timeoutMs - Date.now()),
+    );
+    return () => clearTimeout(timer);
+  }, [asked, timeoutMs]);
   const view = (row: boolean | null | undefined): CancelRequestView => {
     // Not read yet: nothing to show against, and nothing to drop.
     if (row === undefined || row === null) return { requested: null, cancelScheduled: false, noteAsked: () => {} };
@@ -68,7 +87,10 @@ export function useCancelRequest(): CancelRequest {
     return {
       requested: open ? (row ? "resume" : "cancel") : null,
       cancelScheduled: open ? !row : row,
-      noteAsked: () => setAsked((a) => (a !== null && a.scheduled === row ? null : { scheduled: row })),
+      noteAsked: () => {
+        const at = Date.now();
+        setAsked((a) => (a !== null && a.scheduled === row ? null : { scheduled: row, at }));
+      },
     };
   };
   return { waiting: asked !== null, view };

package/src/billing/cancel-subscription.tsx

@@ -1,5 +1,3 @@
-import type { KeyboardEvent } from "react";
-
 import { useKitLabels, useKitLocale } from "../i18n/kit-labels";
 import type { LabelOverride } from "../i18n/kit-labels";
 import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels";
@@ -21,8 +19,8 @@ export interface CancelSubscriptionConfirmProps {
   periodEnd: DateInput;
   /** Confirm: the app's `POST /billing/cancel` (server-kit 0.14, §16.3). */
   onConfirm: () => void;
-  /** The cancel is under way: Confirm's spinner, no second press, and Escape and Back
-   *  don't close. */
+  /** The cancel is under way: Confirm's spinner, no second press, and neither Escape,
+   *  the backdrop nor Back closes it. */
   pending?: boolean;
   /** The date's locale. Default: the provider's. */
   locale?: string;
@@ -72,13 +70,8 @@ export function CancelSubscriptionConfirm({
       open={open}
       title={labels.cancelConfirmTitle}
       description={labels.cancelConfirmBody(formatDate(periodEnd, "medium", { locale }))}
-      onClose={() => {
-        if (!pending) onOpenChange(false);
-      }}
-      onKeyDown={(e: KeyboardEvent<HTMLDivElement>) => {
-        if (pending && e.key === "Escape") e.preventDefault();
-      }}
-      aria-busy={pending || undefined}
+      onClose={() => onOpenChange(false)}
+      busy={pending}
       data-cancel-subscription-confirm=""
       actions={(close) => (
         <>

package/src/billing/plan-switch.tsx

@@ -1,5 +1,3 @@
-import type { KeyboardEvent } from "react";
-
 import { useKitLabels, useKitLocale } from "../i18n/kit-labels";
 import type { LabelOverride } from "../i18n/kit-labels";
 import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels";
@@ -50,8 +48,8 @@ export interface PlanSwitchConfirmProps {
   /** `POST /billing/plan/preview`'s answer. Undefined while it loads: a spinner, and
    *  Confirm is held. */
   preview?: PlanSwitchPreview;
-  /** `POST /billing/plan` is under way: Confirm's spinner, no second press, and Escape
-   *  doesn't close. */
+  /** `POST /billing/plan` is under way: Confirm's spinner, no second press, and neither
+   *  Escape, the backdrop nor Back closes it. */
   pending?: boolean;
   /** The plan's display name, the app's (§3.1). Default: the code. */
   planName?: (code: string) => string;
@@ -152,10 +150,9 @@ export function PlanSwitchConfirm({
       title={labels.switchTitle}
       description={labels.switchFromTo(side(from), side(to))}
       onClose={() => onOpenChange(false)}
-      onKeyDown={(e: KeyboardEvent<HTMLDivElement>) => {
-        if (pending && e.key === "Escape") e.preventDefault();
-      }}
-      aria-busy={preview === undefined || pending || undefined}
+      busy={pending}
+      // A preview that loads is busy too, but holds nothing: Cancel stays a way out.
+      aria-busy={preview === undefined || undefined}
       actions={(close) => (
         <>
           <Button variant="secondary" onClick={close} disabled={pending}>

package/src/components/amount-input.tsx

@@ -267,10 +267,15 @@ export interface AmountInputProps extends FieldHelpProps, DataAttributes {
   max?: number;
   /**
    * The SETTLED figure, dot-decimal, sign included — fired on blur, on Enter, on the
-   * numpad's "=" and on every result the calculator writes back, never on a keystroke
-   * ("1200+" is not a figure yet). `onChange` still reports every keystroke; this is
-   * for a host that stores a number and must not see drafts (kastlan 52; see
-   * {@link MoneyField}, which is built on it).
+   * numpad's "=" and once per calculator session (its "=" or Enter in its display, or
+   * the pad closing on a result not committed yet), never on a keystroke ("1200+" is
+   * not a figure yet). `onChange` still reports every keystroke and every result the
+   * calculator writes back; this is for a host that stores a number and must not see
+   * drafts (kastlan 52; see {@link MoneyField}, which is built on it).
+   *
+   * Refactor audit 2026-10-30, INP-1: every calculator keystroke that resolved used to
+   * commit, so "100+50" committed 105 on its way to 150 — keksdose saved both, and its
+   * threshold field, `disabled` while it saves, lost the calculator to the first.
    */
   onCommit?: (value: string) => void;
   /**
@@ -681,12 +686,14 @@ export function AmountInput(props: AmountInputProps) {
                 // reads either mark, and "1.234,5" is two of them. The result comes back
                 // dot-decimal.
                 value={derived}
+                // Live: every result, settled, so the field never shows more decimals than
+                // it will keep. The commit is the session's one (INP-1): its "=", or the pad
+                // closing on a newer result — not each figure on the way to the result.
                 onChange={(result, expression) => {
                   setDraft(null);
-                  const settled = settle(result);
-                  handleText(settled, expression);
-                  onCommit?.(settled);
+                  handleText(settle(result), expression);
                 }}
+                onCommit={(result) => onCommit?.(settle(result))}
                 className="px-1.5"
                 aria-label={labels?.calculatorTrigger}
                 labels={labels?.calculator}

package/src/components/calculator.tsx

@@ -1,4 +1,5 @@
-import { useEffect, useMemo, useRef, useState } from "react";
+import { useEffect, useEffectEvent, useMemo, useRef, useState } from "react";
+import type { RefObject } from "react";
 import { Calculator as CalculatorIcon, Delete } from "lucide-react";
 import { Popover } from "./popover";
 import { cn } from "../lib/cn";
@@ -30,6 +31,24 @@ interface CalculatorButtonProps {
    * the one argument and ignore this.
    */
   onChange: (value: string, expression?: string) => void;
+  /**
+   * Called ONCE per calculator session, with the result the host should keep: on "="
+   * (the key, or Enter in the display), and when the panel closes — Escape, a press
+   * outside, the trigger — on a result `onChange` reported after the last commit. Never
+   * per keystroke: `onChange` is the live channel, this is the one to save on.
+   *
+   * Not called when the button goes away with its panel open (a lock or `disabled`
+   * arriving, the field unmounting): those say the value must not move, and the result
+   * stays where `onChange` put it.
+   *
+   * Refactor audit 2026-10-30, INP-1: the pad had no commit point of its own, and the
+   * two field engines guessed in opposite directions. NumberInput never committed a
+   * result, so Kurvenschmiede's dialogs saved the number from before the calculation;
+   * AmountInput committed every keystroke that resolved, so "100+50" saved 105 on its way
+   * to 150, and keksdose's threshold field, `disabled` while it saves, lost its pad to the
+   * first of them.
+   */
+  onCommit?: (value: string) => void;
   className?: string;
   /** The trigger's accessible name; wins over `calculator.open` from the provider. */
   "aria-label"?: string;
@@ -89,10 +108,13 @@ function seed(initial: string): string {
 function CalculatorPanel({
   initial,
   onChange,
+  onEquals,
   labels,
 }: {
   initial: string;
   onChange: (value: string, expression?: string) => void;
+  /** "=" was pressed on a result: the session's commit point. */
+  onEquals: () => void;
   labels: CalculatorLabels;
 }) {
   const [expr, setExpr] = useState(() => seed(initial));
@@ -132,6 +154,7 @@ function CalculatorPanel({
     const out = formatResult(result);
     setExpr(out);
     onChange(out, text);
+    onEquals();
   };
 
   return (
@@ -213,15 +236,66 @@ function CalculatorPanel({
   );
 }
 
+/**
+ * The trigger, and the place a session ends. The render in which `open` turns false is
+ * the panel closing, however it closed — Escape, a press outside, this button — and
+ * that is when a result the pad left unsettled is committed. A component of its own
+ * because `open` lives in Popover and reaches only the trigger.
+ *
+ * Not the panel's unmount: the panel also goes when a lock or `disabled` takes the
+ * calculator away, and nothing may commit then. Those unmount this button with it, so no
+ * render ever sees `open` turn false.
+ */
+function CalculatorTrigger({
+  open,
+  onToggle,
+  onClosed,
+  buttonRef,
+  label,
+  className,
+}: {
+  open: boolean;
+  onToggle: () => void;
+  onClosed: () => void;
+  buttonRef: RefObject<HTMLButtonElement | null>;
+  label: string;
+  className?: string;
+}) {
+  const closed = useEffectEvent(onClosed);
+  const wasOpen = useRef(open);
+  useEffect(() => {
+    if (wasOpen.current && !open) closed();
+    wasOpen.current = open;
+  }, [open]);
+  return (
+    <button
+      ref={buttonRef}
+      type="button"
+      tabIndex={-1}
+      onClick={onToggle}
+      aria-label={label}
+      aria-expanded={open}
+      className={cn(
+        "flex items-center justify-center text-placeholder transition-colors hover:text-secondary",
+        className,
+      )}
+    >
+      <CalculatorIcon className="size-4" />
+    </button>
+  );
+}
+
 /**
  * A calculator icon that opens a small keypad popover anchored to its host
  * field. Designed as a trailing-edge adornment: render it inside the field's
  * `relative` wrapper, positioned absolutely. The keypad seeds from the current
- * field value and writes evaluated results straight back through `onChange`.
+ * field value and writes evaluated results straight back through `onChange`, and
+ * commits the session once through `onCommit`.
  */
 export function CalculatorButton({
   value,
   onChange,
+  onCommit,
   className,
   "aria-label": ariaLabel,
   labels: labelsProp,
@@ -233,28 +307,35 @@ export function CalculatorButton({
     [ariaLabel, labelsProp],
   );
   const labels = useKitLabels("calculator", DEFAULT_CALCULATOR_LABELS, fromProps);
+  // The last result `onChange` reported that no commit has covered yet — what closing
+  // the panel commits. Written by the pad's handlers and read when it closes; never
+  // rendered, so a ref.
+  const unsettled = useRef<string | null>(null);
+  const change = (next: string, expression?: string) => {
+    unsettled.current = next;
+    onChange(next, expression);
+  };
+  const settle = () => {
+    const next = unsettled.current;
+    unsettled.current = null;
+    if (next !== null) onCommit?.(next);
+  };
   return (
     <Popover
       width="14rem"
       labels={{ panel: labels.panel }}
       trigger={({ open, toggle, ref }) => (
-        <button
-          ref={ref}
-          type="button"
-          tabIndex={-1}
-          onClick={toggle}
-          aria-label={labels.open}
-          aria-expanded={open}
-          className={cn(
-            "flex items-center justify-center text-placeholder transition-colors hover:text-secondary",
-            className,
-          )}
-        >
-          <CalculatorIcon className="size-4" />
-        </button>
+        <CalculatorTrigger
+          open={open}
+          onToggle={toggle}
+          onClosed={settle}
+          buttonRef={ref}
+          label={labels.open}
+          className={className}
+        />
       )}
     >
-      {() => <CalculatorPanel initial={value} onChange={onChange} labels={labels} />}
+      {() => <CalculatorPanel initial={value} onChange={change} onEquals={settle} labels={labels} />}
     </Popover>
   );
 }

package/src/components/combobox-core.tsx

@@ -22,7 +22,7 @@ import { anchoredInline, useAnchoredPanel, viewportSize, type AnchoredPanel } fr
 import { pressInside, takeEscape, useDismissLayer, useOutsideClick } from "../hooks/use-dismiss";
 import { useOverlayHistory } from "../hooks/use-overlay-history";
 import { isImeEnter } from "../lib/ime";
-import { matchesSearch, searchWords } from "../lib/text-match";
+import { matchesSearch, sameName, searchWords } from "../lib/text-match";
 import { DEFAULT_COMBOBOX_LABELS, useKitLabels, useKitLocale } from "../i18n/kit-labels";
 import { hasContent } from "../lib/presence";
 
@@ -108,25 +108,28 @@ export const DISABLED_ROW_CLASS = "cursor-not-allowed opacity-50 hover:bg-transp
  * Whether an entity picker offers its create row — one rule for
  * {@link EntityCombobox}, {@link MultiEntityCombobox} and {@link InlineEntityCombobox}.
  *
- * With a query: while the trimmed query names no option exactly (case-insensitive) —
- * an exact hit is a record the list is already showing, and a second way to "make" it
- * would mint a duplicate. With NO query: only when the caller named the row for that
+ * With a query: while the trimmed query names no option exactly — an exact hit is a
+ * record the list is already showing, and a second way to "make" it would mint a
+ * duplicate. "Exactly" as the list matches, folded by `locale` ({@link sameName}): with
+ * plain `toLowerCase`, "cafe" listed Café and offered "Create “cafe”" beside it (refactor
+ * audit 2026-10-30, DUP-5). With NO query: only when the caller named the row for that
  * case (`createEmptyLabel`) — a row reading `Create “”` says nothing, and the kit cannot
  * know the noun ("Create cash account") that would make it say something (keksdose G9).
  *
  * `names` is what the query is compared against: the loaded rows for a panel picker
- * (its async list is all it knows), every option for the inline one.
+ * (its async list is all it knows), every option for the inline one. `locale`: the
+ * provider's, which the list's match folds by; left out, the runtime's.
  */
 export function offersCreate(
   onCreate: unknown,
   query: string,
   names: readonly string[],
   createEmptyLabel: string | undefined,
+  locale?: string,
 ): boolean {
   if (!onCreate) return false;
   if (!query) return Boolean(createEmptyLabel);
-  const q = query.toLowerCase();
-  return !names.some((n) => n.toLowerCase() === q);
+  return !names.some((n) => sameName(n, query, locale));
 }
 
 /**

package/src/components/combobox.tsx

@@ -11,7 +11,7 @@ import { usePhoneLayout } from "../hooks/use-breakpoint";
 import { PickerSheet, SHEET_ROW_CLASS } from "./picker-sheet";
 import { ComboboxFieldLabel, endHintRowProps, GROUP_HEADING_STICKY, useActiveOptionScroll } from "./combobox-core";
 import { useKitLocale } from "../i18n/kit-labels";
-import { rankMatch } from "../lib/text-match";
+import { rankMatch, sameName } from "../lib/text-match";
 import {
   EndHintRow,
   FieldCaption,
@@ -328,8 +328,9 @@ export function Combobox(props: ComboboxProps) {
     setTyping(false);
   };
 
-  // Offered only when the typed text is genuinely NOT in the pool: an exact
-  // (case-insensitive) match is an existing entry the list is already showing, and a
+  // Offered only when the typed text is genuinely NOT in the pool: an exact match —
+  // folded as the list matches, so "cafe" is Café ({@link sameName}, DUP-5 in the
+  // 2026-10-30 refactor audit) — is an existing entry the list is already showing, and a
   // second way to pick it would be noise. Compared against `options`, not `matches` —
   // `matches` is capped, so a pool of 300 payees would otherwise offer to "add" one
   // that exists but fell off the end of the list.
@@ -352,9 +353,7 @@ export function Combobox(props: ComboboxProps) {
 
   const typed = value.trim();
   const createRow =
-    createLabel && typed.length > 0 && !options.some((o) => o.toLowerCase() === typed.toLowerCase())
-      ? createLabel(typed)
-      : null;
+    createLabel && typed.length > 0 && !options.some((o) => sameName(o, typed, locale)) ? createLabel(typed) : null;
 
   // The list is a layer on the Escape stack while it SHOWS (Wave 2, DUP-1): an Escape
   // over an empty "open" list is the dialog's, as it always was. On a phone the sheet