@eifi1/ui-kit 0.33.0 → 0.34.0

package/dist/landing/routing.d.ts

@@ -1,113 +1,12 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { LandingSession } from './landing-actions.js';
-import '../delete-account-setting-DiPX4Vue.js';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/write-lock.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import '../hooks/use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/user-avatar.js';
-import '../lib/person-name.js';
-import '../shell/topbar-action-menu.js';
-import '../components/menu-item.js';
-import '../components/floating-panel.js';
-import '../hooks/use-authed-src.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import './access.js';
-import './landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
-
+import type { ReactNode } from "react";
+import type { LandingSession } from "./landing-actions.js";
 /**
  * 0.31.1: a session that is still being restored — an app whose access token lives in
  * memory reads it back from its refresh token first (kastlan's 0.31 adoption). Until
  * then `/` neither shows the landing nor resumes, and a public page neither shows nor
  * redirects: both render `loading` instead.
  */
-type RoutingSession = LandingSession | "loading";
+export type RoutingSession = LandingSession | "loading";
 /**
  * The public routes' logic (docs/landing-demo-harmonization.md §3): what `/` shows,
  * which pages a session skips, and the page a session resumes on — keksdose's
@@ -116,7 +15,7 @@ type RoutingSession = LandingSession | "loading";
  */
 /** The query parameter that carries "where I was actually trying to go" through the
  *  sign-in bounce (keksdose's `NEXT_PARAM`). */
-declare const NEXT_PARAM = "next";
+export declare const NEXT_PARAM = "next";
 /**
  * A `?next=` value that is safe to navigate to, or null.
  *
@@ -136,10 +35,10 @@ declare const NEXT_PARAM = "next";
  * keksdose's (shared/hooks/use-last-visited-page.ts), verbatim but for the fallback
  * origin.
  */
-declare function safeNextPath(raw: string | null | undefined): string | null;
+export declare function safeNextPath(raw: string | null | undefined): string | null;
 /** A path to leave out: a string is the path and everything under it (`/demo` is
  *  `/demo` and `/demo/ended`; `/` is only `/`), a RegExp is tested on the pathname. */
-type PathPattern = string | RegExp;
+export type PathPattern = string | RegExp;
 /**
  * The pages never recorded as a resume target (§3.2): the landing (`/`, `/welcome`), the
  * auth pages, the demo's own (`/demo*`) and the legal pages. The 404 has no path of its
@@ -147,8 +46,8 @@ type PathPattern = string | RegExp;
  * and it never sees one. The app adds its own one-shot routes (keksdose:
  * `/banks/callback`, `/join`, `/share-target`) through `exclude`.
  */
-declare const DEFAULT_LAST_VISITED_EXCLUDES: readonly PathPattern[];
-interface LastVisitedPageOptions {
+export declare const DEFAULT_LAST_VISITED_EXCLUDES: readonly PathPattern[];
+export interface LastVisitedPageOptions {
     /** The device key: `<app>.lastVisitedPage` (§3.2), one per app on the origin. */
     key: string;
     /** The app's own paths to leave out, ON TOP of {@link DEFAULT_LAST_VISITED_EXCLUDES}. */
@@ -166,19 +65,19 @@ interface LastVisitedPageOptions {
  * one-shot page (a bank callback, an invitation link) never becomes the place the next
  * launch opens on.
  */
-declare function useLastVisitedPage({ key, exclude, enabled }: LastVisitedPageOptions): void;
+export declare function useLastVisitedPage({ key, exclude, enabled }: LastVisitedPageOptions): void;
 /**
  * The page {@link useLastVisitedPage} remembered under `key` — checked by
  * {@link safeNextPath}, so a value someone planted in storage cannot leave the origin —
  * or `fallback` (default `null`) when there is none or storage is blocked. A string
  * fallback narrows the answer to a string, for react-router's `to`.
  */
-declare function readLastVisitedPage(key: string, fallback: string): string;
-declare function readLastVisitedPage(key: string, fallback?: null): string | null;
+export declare function readLastVisitedPage(key: string, fallback: string): string;
+export declare function readLastVisitedPage(key: string, fallback?: null): string | null;
 /** Forget the remembered page — on an explicit sign-out, so the next account does not
  *  resume on the previous one's page. */
-declare function clearLastVisitedPage(key: string): void;
-interface RootEntryProps {
+export declare function clearLastVisitedPage(key: string): void;
+export interface RootEntryProps {
     /** Without a session `/` is the landing; with one (real or demo) it resumes;
      *  `"loading"` while the app restores one. */
     session: RoutingSession;
@@ -201,8 +100,8 @@ interface RootEntryProps {
  * home instead, because a session at `/` came to use the app. The landing stays one tap
  * away at `/welcome`, where the signed-in brand link points.
  */
-declare function RootEntry({ session, resumePath, landing, home, loading }: RootEntryProps): react.JSX.Element;
-interface RedirectIfAuthedProps {
+export declare function RootEntry({ session, resumePath, landing, home, loading }: RootEntryProps): import("react").JSX.Element;
+export interface RedirectIfAuthedProps {
     /** `"loading"` while the app restores a session: neither the page nor a redirect. */
     session: RoutingSession;
     /** What shows while `session` is `"loading"`. Default: the kit's `LoadingState`. */
@@ -231,6 +130,4 @@ interface RedirectIfAuthedProps {
  * `allowDemo` around `/login`, `/register` and the invitation pages, and one without
  * around `/demo` (and `/forgot-password`).
  */
-declare function RedirectIfAuthed({ session, allowDemo, fallback, children, loading }: RedirectIfAuthedProps): react.JSX.Element;
-
-export { DEFAULT_LAST_VISITED_EXCLUDES, type LastVisitedPageOptions, NEXT_PARAM, type PathPattern, RedirectIfAuthed, type RedirectIfAuthedProps, RootEntry, type RootEntryProps, type RoutingSession, clearLastVisitedPage, readLastVisitedPage, safeNextPath, useLastVisitedPage };
+export declare function RedirectIfAuthed({ session, allowDemo, fallback, children, loading }: RedirectIfAuthedProps): import("react").JSX.Element;

package/dist/landing/routing.js

@@ -2,7 +2,7 @@
 import { Fragment, jsx } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { Navigate, Outlet, useLocation } from "react-router";
-import { readStored, writeStored } from "../lib/safe-storage.js";
+import { readStored, removeStored, writeStored } from "../lib/safe-storage.js";
 import { LoadingState } from "../components/loading-state.js";
 const NEXT_PARAM = "next";
 function safeNextPath(raw) {
@@ -50,11 +50,7 @@ function readLastVisitedPage(key, fallback = null) {
   return safeNextPath(readStored(key)) ?? fallback;
 }
 function clearLastVisitedPage(key) {
-  if (typeof window === "undefined") return;
-  try {
-    window.localStorage.removeItem(key);
-  } catch {
-  }
+  removeStored(key);
 }
 function RootEntry({ session, resumePath, landing, home, loading }) {
   if (session === "loading") return /* @__PURE__ */ jsx(Fragment, { children: loading ?? /* @__PURE__ */ jsx(LoadingState, {}) });

package/dist/landing/routing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/landing/routing.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Navigate, Outlet, useLocation } from \"react-router\";\n\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport type { LandingSession } from \"./landing-actions\";\nimport { LoadingState } from \"../components/loading-state\";\n\n/**\n * 0.31.1: a session that is still being restored — an app whose access token lives in\n * memory reads it back from its refresh token first (kastlan's 0.31 adoption). Until\n * then `/` neither shows the landing nor resumes, and a public page neither shows nor\n * redirects: both render `loading` instead.\n */\nexport type RoutingSession = LandingSession | \"loading\";\n\n/**\n * The public routes' logic (docs/landing-demo-harmonization.md §3): what `/` shows,\n * which pages a session skips, and the page a session resumes on — keksdose's\n * `RootEntry`, `RedirectIfAuthed` and use-last-visited-page.ts, for every app.\n * Router-aware (react-router), so they belong to the `./shell` entry.\n */\n\n/* ── ?next= ──────────────────────────────────────────────────────────────── */\n\n/** The query parameter that carries \"where I was actually trying to go\" through the\n *  sign-in bounce (keksdose's `NEXT_PARAM`). */\nexport const NEXT_PARAM = \"next\";\n\n/**\n * A `?next=` value that is safe to navigate to, or null.\n *\n * Same-origin PATHS only, decided by the URL PARSER rather than by string prefix —\n * this is the open-redirect check, and it is the reason this lives in one place\n * instead of at each call site.\n *\n * The prefix version (\"starts with `/`, does not start with `//`\") let two shapes\n * through that the browser resolves cross-origin, because the WHATWG parser does not\n * read them as text: a backslash after the leading slash counts as a second slash for\n * a special scheme, so `/\\evil.example` resolves to `https://evil.example/`; and tab,\n * LF and CR are STRIPPED anywhere in the input before parsing, so `/<TAB>/evil.example`\n * becomes `//evil.example`. Asking the same parser the browser will use closes every\n * such shape at once, including ones nobody has thought of yet, and it normalises what\n * comes back instead of echoing the caller's spelling.\n *\n * keksdose's (shared/hooks/use-last-visited-page.ts), verbatim but for the fallback\n * origin.\n */\nexport function safeNextPath(raw: string | null | undefined): string | null {\n  if (!raw) return null;\n  const base = typeof window !== \"undefined\" ? window.location.origin : \"https://kit.invalid\";\n  try {\n    const url = new URL(raw, base);\n    if (url.origin !== base) return null;\n    return `${url.pathname}${url.search}${url.hash}`;\n  } catch {\n    return null;\n  }\n}\n\n/* ── The last visited page (§3.2) ────────────────────────────────────────── */\n\n/** A path to leave out: a string is the path and everything under it (`/demo` is\n *  `/demo` and `/demo/ended`; `/` is only `/`), a RegExp is tested on the pathname. */\nexport type PathPattern = string | RegExp;\n\n/**\n * The pages never recorded as a resume target (§3.2): the landing (`/`, `/welcome`), the\n * auth pages, the demo's own (`/demo*`) and the legal pages. The 404 has no path of its\n * own — call {@link useLastVisitedPage} inside the signed-in layout, as keksdose does,\n * and it never sees one. The app adds its own one-shot routes (keksdose:\n * `/banks/callback`, `/join`, `/share-target`) through `exclude`.\n */\nexport const DEFAULT_LAST_VISITED_EXCLUDES: readonly PathPattern[] = Object.freeze([\n  \"/\",\n  \"/welcome\",\n  \"/login\",\n  \"/register\",\n  \"/forgot-password\",\n  \"/reset-password\",\n  \"/verify-email\",\n  \"/demo\",\n  \"/impressum\",\n  \"/privacy\",\n  \"/terms\",\n]);\n\nfunction matchesPath(pathname: string, pattern: PathPattern): boolean {\n  if (typeof pattern !== \"string\") return new RegExp(pattern.source, pattern.flags.replace(\"g\", \"\")).test(pathname);\n  if (pattern === \"/\") return pathname === \"/\";\n  const base = pattern.endsWith(\"/\") ? pattern.slice(0, -1) : pattern;\n  return pathname === base || pathname.startsWith(`${base}/`);\n}\n\n/** Whether `pathname` is one of the defaults or the app's `exclude`. */\nfunction isExcluded(pathname: string, exclude: readonly PathPattern[]): boolean {\n  return [...DEFAULT_LAST_VISITED_EXCLUDES, ...exclude].some((pattern) => matchesPath(pathname, pattern));\n}\n\nexport interface LastVisitedPageOptions {\n  /** The device key: `<app>.lastVisitedPage` (§3.2), one per app on the origin. */\n  key: string;\n  /** The app's own paths to leave out, ON TOP of {@link DEFAULT_LAST_VISITED_EXCLUDES}. */\n  exclude?: readonly PathPattern[];\n  /** `false` records nothing — while the session is still being restored, say. */\n  enabled?: boolean;\n}\n\n/**\n * Remember the page a session is on (path and query), on every navigation, so `/` — a\n * revisit, a fresh sign-in, the installed PWA, whose `start_url` is `/` — resumes there\n * (§3.2, keksdose feedback #59). Device-local, in `localStorage` under `key`; a blocked\n * storage records nothing.\n *\n * Call it once in the signed-in layout. The excluded paths are never written, so a\n * one-shot page (a bank callback, an invitation link) never becomes the place the next\n * launch opens on.\n */\nexport function useLastVisitedPage({ key, exclude = [], enabled = true }: LastVisitedPageOptions): void {\n  const { pathname, search } = useLocation();\n  // Decided here, so the effect depends on the answer and not on an `exclude` array the\n  // caller likely builds inline.\n  const skip = !enabled || isExcluded(pathname, exclude);\n  useEffect(() => {\n    if (skip) return;\n    writeStored(key, pathname + search);\n  }, [key, pathname, search, skip]);\n}\n\n/**\n * The page {@link useLastVisitedPage} remembered under `key` — checked by\n * {@link safeNextPath}, so a value someone planted in storage cannot leave the origin —\n * or `fallback` (default `null`) when there is none or storage is blocked. A string\n * fallback narrows the answer to a string, for react-router's `to`.\n */\nexport function readLastVisitedPage(key: string, fallback: string): string;\nexport function readLastVisitedPage(key: string, fallback?: null): string | null;\nexport function readLastVisitedPage(key: string, fallback: string | null = null): string | null {\n  return safeNextPath(readStored(key)) ?? fallback;\n}\n\n/** Forget the remembered page — on an explicit sign-out, so the next account does not\n *  resume on the previous one's page. */\nexport function clearLastVisitedPage(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // storage blocked: there is nothing to forget\n  }\n}\n\n/* ── RootEntry ───────────────────────────────────────────────────────────── */\n\nexport interface RootEntryProps {\n  /** Without a session `/` is the landing; with one (real or demo) it resumes;\n   *  `\"loading\"` while the app restores one. */\n  session: RoutingSession;\n  /** What shows while `session` is `\"loading\"`. Default: the kit's `LoadingState`. */\n  loading?: ReactNode;\n  /** The remembered page — `readLastVisitedPage(key)`. */\n  resumePath?: string | null;\n  /** The landing page element. */\n  landing: ReactNode;\n  /** The app's home: where a session goes with nothing to resume (keksdose `/budget`,\n   *  kastlan and Kurvenschmiede `/dashboard`). */\n  home: string;\n}\n\n/**\n * The `/` route (§3.1): the landing for a visitor, and for a session — real or demo —\n * the last visited page, else the app's home. Indexed and canonical `/` for the visitor;\n * a crawler never has a session, so for it `/` is stable.\n *\n * keksdose showed a session with nothing remembered the landing; the contract sends it\n * home instead, because a session at `/` came to use the app. The landing stays one tap\n * away at `/welcome`, where the signed-in brand link points.\n */\nexport function RootEntry({ session, resumePath, landing, home, loading }: RootEntryProps) {\n  if (session === \"loading\") return <>{loading ?? <LoadingState />}</>;\n  if (session === \"none\") return <>{landing}</>;\n  const resume = safeNextPath(resumePath);\n  return <Navigate to={resume && resume !== \"/\" ? resume : home} replace />;\n}\n\n/* ── RedirectIfAuthed ────────────────────────────────────────────────────── */\n\nexport interface RedirectIfAuthedProps {\n  /** `\"loading\"` while the app restores a session: neither the page nor a redirect. */\n  session: RoutingSession;\n  /** What shows while `session` is `\"loading\"`. Default: the kit's `LoadingState`. */\n  loading?: ReactNode;\n  /**\n   * Let a DEMO session through (§5.6): on `/login`, `/register` and the app's invitation\n   * pages, so a demo visitor can sign in or accept an invitation — a successful one\n   * replaces the demo session. Default `false`: on `/demo` a live demo continues instead\n   * of starting a second one (§5.2), and on `/forgot-password` a demo has no password.\n   */\n  allowDemo?: boolean;\n  /** Where a redirected session goes: the resume target —\n   *  `readLastVisitedPage(key, home)`. A safe `?next=` goes first. */\n  fallback: string;\n  /** The page. Left out, an `<Outlet />`: the component is a layout route around the\n   *  public pages, as in keksdose. */\n  children?: ReactNode;\n}\n\n/**\n * Public pages a session skips (§3.1): a signed-in visitor at `/login` goes back into\n * the app, to a safe `?next=` when the URL carries one (a share invitation or a push\n * deep link opened with a live session in another tab — keksdose) and else to\n * `fallback`.\n *\n * A demo session passes where `allowDemo` says so (§5.6). Mount one wrapper with\n * `allowDemo` around `/login`, `/register` and the invitation pages, and one without\n * around `/demo` (and `/forgot-password`).\n */\nexport function RedirectIfAuthed({ session, allowDemo = false, fallback, children, loading }: RedirectIfAuthedProps) {\n  const { search } = useLocation();\n  if (session === \"loading\") return <>{loading ?? <LoadingState />}</>;\n  if (session === \"none\" || (session === \"demo\" && allowDemo)) {\n    return children === undefined ? <Outlet /> : <>{children}</>;\n  }\n  const next = safeNextPath(new URLSearchParams(search).get(NEXT_PARAM));\n  return <Navigate to={next ?? fallback} replace />;\n}\n"],"mappings":";AAmLoC,mBAAc,WAAd;AAnLpC,SAAS,iBAAiB;AAE1B,SAAS,UAAU,QAAQ,mBAAmB;AAE9C,SAAS,YAAY,mBAAmB;AAExC,SAAS,oBAAoB;AAqBtB,MAAM,aAAa;AAqBnB,SAAS,aAAa,KAA+C;AAC1E,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,OAAO,OAAO,WAAW,cAAc,OAAO,SAAS,SAAS;AACtE,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK,IAAI;AAC7B,QAAI,IAAI,WAAW,KAAM,QAAO;AAChC,WAAO,GAAG,IAAI,QAAQ,GAAG,IAAI,MAAM,GAAG,IAAI,IAAI;AAAA,EAChD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeO,MAAM,gCAAwD,OAAO,OAAO;AAAA,EACjF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,YAAY,UAAkB,SAA+B;AACpE,MAAI,OAAO,YAAY,SAAU,QAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,MAAM,QAAQ,KAAK,EAAE,CAAC,EAAE,KAAK,QAAQ;AAChH,MAAI,YAAY,IAAK,QAAO,aAAa;AACzC,QAAM,OAAO,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI;AAC5D,SAAO,aAAa,QAAQ,SAAS,WAAW,GAAG,IAAI,GAAG;AAC5D;AAGA,SAAS,WAAW,UAAkB,SAA0C;AAC9E,SAAO,CAAC,GAAG,+BAA+B,GAAG,OAAO,EAAE,KAAK,CAAC,YAAY,YAAY,UAAU,OAAO,CAAC;AACxG;AAqBO,SAAS,mBAAmB,EAAE,KAAK,UAAU,CAAC,GAAG,UAAU,KAAK,GAAiC;AACtG,QAAM,EAAE,UAAU,OAAO,IAAI,YAAY;AAGzC,QAAM,OAAO,CAAC,WAAW,WAAW,UAAU,OAAO;AACrD,YAAU,MAAM;AACd,QAAI,KAAM;AACV,gBAAY,KAAK,WAAW,MAAM;AAAA,EACpC,GAAG,CAAC,KAAK,UAAU,QAAQ,IAAI,CAAC;AAClC;AAUO,SAAS,oBAAoB,KAAa,WAA0B,MAAqB;AAC9F,SAAO,aAAa,WAAW,GAAG,CAAC,KAAK;AAC1C;AAIO,SAAS,qBAAqB,KAAmB;AACtD,MAAI,OAAO,WAAW,YAAa;AACnC,MAAI;AACF,WAAO,aAAa,WAAW,GAAG;AAAA,EACpC,QAAQ;AAAA,EAER;AACF;AA4BO,SAAS,UAAU,EAAE,SAAS,YAAY,SAAS,MAAM,QAAQ,GAAmB;AACzF,MAAI,YAAY,UAAW,QAAO,gCAAG,qBAAW,oBAAC,gBAAa,GAAG;AACjE,MAAI,YAAY,OAAQ,QAAO,gCAAG,mBAAQ;AAC1C,QAAM,SAAS,aAAa,UAAU;AACtC,SAAO,oBAAC,YAAS,IAAI,UAAU,WAAW,MAAM,SAAS,MAAM,SAAO,MAAC;AACzE;AAkCO,SAAS,iBAAiB,EAAE,SAAS,YAAY,OAAO,UAAU,UAAU,QAAQ,GAA0B;AACnH,QAAM,EAAE,OAAO,IAAI,YAAY;AAC/B,MAAI,YAAY,UAAW,QAAO,gCAAG,qBAAW,oBAAC,gBAAa,GAAG;AACjE,MAAI,YAAY,UAAW,YAAY,UAAU,WAAY;AAC3D,WAAO,aAAa,SAAY,oBAAC,UAAO,IAAK,gCAAG,UAAS;AAAA,EAC3D;AACA,QAAM,OAAO,aAAa,IAAI,gBAAgB,MAAM,EAAE,IAAI,UAAU,CAAC;AACrE,SAAO,oBAAC,YAAS,IAAI,QAAQ,UAAU,SAAO,MAAC;AACjD;","names":[]}
+{"version":3,"sources":["../../src/landing/routing.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Navigate, Outlet, useLocation } from \"react-router\";\n\nimport { readStored, removeStored, writeStored } from \"../lib/safe-storage\";\nimport type { LandingSession } from \"./landing-actions\";\nimport { LoadingState } from \"../components/loading-state\";\n\n/**\n * 0.31.1: a session that is still being restored — an app whose access token lives in\n * memory reads it back from its refresh token first (kastlan's 0.31 adoption). Until\n * then `/` neither shows the landing nor resumes, and a public page neither shows nor\n * redirects: both render `loading` instead.\n */\nexport type RoutingSession = LandingSession | \"loading\";\n\n/**\n * The public routes' logic (docs/landing-demo-harmonization.md §3): what `/` shows,\n * which pages a session skips, and the page a session resumes on — keksdose's\n * `RootEntry`, `RedirectIfAuthed` and use-last-visited-page.ts, for every app.\n * Router-aware (react-router), so they belong to the `./shell` entry.\n */\n\n/* ── ?next= ──────────────────────────────────────────────────────────────── */\n\n/** The query parameter that carries \"where I was actually trying to go\" through the\n *  sign-in bounce (keksdose's `NEXT_PARAM`). */\nexport const NEXT_PARAM = \"next\";\n\n/**\n * A `?next=` value that is safe to navigate to, or null.\n *\n * Same-origin PATHS only, decided by the URL PARSER rather than by string prefix —\n * this is the open-redirect check, and it is the reason this lives in one place\n * instead of at each call site.\n *\n * The prefix version (\"starts with `/`, does not start with `//`\") let two shapes\n * through that the browser resolves cross-origin, because the WHATWG parser does not\n * read them as text: a backslash after the leading slash counts as a second slash for\n * a special scheme, so `/\\evil.example` resolves to `https://evil.example/`; and tab,\n * LF and CR are STRIPPED anywhere in the input before parsing, so `/<TAB>/evil.example`\n * becomes `//evil.example`. Asking the same parser the browser will use closes every\n * such shape at once, including ones nobody has thought of yet, and it normalises what\n * comes back instead of echoing the caller's spelling.\n *\n * keksdose's (shared/hooks/use-last-visited-page.ts), verbatim but for the fallback\n * origin.\n */\nexport function safeNextPath(raw: string | null | undefined): string | null {\n  if (!raw) return null;\n  const base = typeof window !== \"undefined\" ? window.location.origin : \"https://kit.invalid\";\n  try {\n    const url = new URL(raw, base);\n    if (url.origin !== base) return null;\n    return `${url.pathname}${url.search}${url.hash}`;\n  } catch {\n    return null;\n  }\n}\n\n/* ── The last visited page (§3.2) ────────────────────────────────────────── */\n\n/** A path to leave out: a string is the path and everything under it (`/demo` is\n *  `/demo` and `/demo/ended`; `/` is only `/`), a RegExp is tested on the pathname. */\nexport type PathPattern = string | RegExp;\n\n/**\n * The pages never recorded as a resume target (§3.2): the landing (`/`, `/welcome`), the\n * auth pages, the demo's own (`/demo*`) and the legal pages. The 404 has no path of its\n * own — call {@link useLastVisitedPage} inside the signed-in layout, as keksdose does,\n * and it never sees one. The app adds its own one-shot routes (keksdose:\n * `/banks/callback`, `/join`, `/share-target`) through `exclude`.\n */\nexport const DEFAULT_LAST_VISITED_EXCLUDES: readonly PathPattern[] = Object.freeze([\n  \"/\",\n  \"/welcome\",\n  \"/login\",\n  \"/register\",\n  \"/forgot-password\",\n  \"/reset-password\",\n  \"/verify-email\",\n  \"/demo\",\n  \"/impressum\",\n  \"/privacy\",\n  \"/terms\",\n]);\n\nfunction matchesPath(pathname: string, pattern: PathPattern): boolean {\n  if (typeof pattern !== \"string\") return new RegExp(pattern.source, pattern.flags.replace(\"g\", \"\")).test(pathname);\n  if (pattern === \"/\") return pathname === \"/\";\n  const base = pattern.endsWith(\"/\") ? pattern.slice(0, -1) : pattern;\n  return pathname === base || pathname.startsWith(`${base}/`);\n}\n\n/** Whether `pathname` is one of the defaults or the app's `exclude`. */\nfunction isExcluded(pathname: string, exclude: readonly PathPattern[]): boolean {\n  return [...DEFAULT_LAST_VISITED_EXCLUDES, ...exclude].some((pattern) => matchesPath(pathname, pattern));\n}\n\nexport interface LastVisitedPageOptions {\n  /** The device key: `<app>.lastVisitedPage` (§3.2), one per app on the origin. */\n  key: string;\n  /** The app's own paths to leave out, ON TOP of {@link DEFAULT_LAST_VISITED_EXCLUDES}. */\n  exclude?: readonly PathPattern[];\n  /** `false` records nothing — while the session is still being restored, say. */\n  enabled?: boolean;\n}\n\n/**\n * Remember the page a session is on (path and query), on every navigation, so `/` — a\n * revisit, a fresh sign-in, the installed PWA, whose `start_url` is `/` — resumes there\n * (§3.2, keksdose feedback #59). Device-local, in `localStorage` under `key`; a blocked\n * storage records nothing.\n *\n * Call it once in the signed-in layout. The excluded paths are never written, so a\n * one-shot page (a bank callback, an invitation link) never becomes the place the next\n * launch opens on.\n */\nexport function useLastVisitedPage({ key, exclude = [], enabled = true }: LastVisitedPageOptions): void {\n  const { pathname, search } = useLocation();\n  // Decided here, so the effect depends on the answer and not on an `exclude` array the\n  // caller likely builds inline.\n  const skip = !enabled || isExcluded(pathname, exclude);\n  useEffect(() => {\n    if (skip) return;\n    writeStored(key, pathname + search);\n  }, [key, pathname, search, skip]);\n}\n\n/**\n * The page {@link useLastVisitedPage} remembered under `key` — checked by\n * {@link safeNextPath}, so a value someone planted in storage cannot leave the origin —\n * or `fallback` (default `null`) when there is none or storage is blocked. A string\n * fallback narrows the answer to a string, for react-router's `to`.\n */\nexport function readLastVisitedPage(key: string, fallback: string): string;\nexport function readLastVisitedPage(key: string, fallback?: null): string | null;\nexport function readLastVisitedPage(key: string, fallback: string | null = null): string | null {\n  return safeNextPath(readStored(key)) ?? fallback;\n}\n\n/** Forget the remembered page — on an explicit sign-out, so the next account does not\n *  resume on the previous one's page. */\nexport function clearLastVisitedPage(key: string): void {\n  removeStored(key);\n}\n\n/* ── RootEntry ───────────────────────────────────────────────────────────── */\n\nexport interface RootEntryProps {\n  /** Without a session `/` is the landing; with one (real or demo) it resumes;\n   *  `\"loading\"` while the app restores one. */\n  session: RoutingSession;\n  /** What shows while `session` is `\"loading\"`. Default: the kit's `LoadingState`. */\n  loading?: ReactNode;\n  /** The remembered page — `readLastVisitedPage(key)`. */\n  resumePath?: string | null;\n  /** The landing page element. */\n  landing: ReactNode;\n  /** The app's home: where a session goes with nothing to resume (keksdose `/budget`,\n   *  kastlan and Kurvenschmiede `/dashboard`). */\n  home: string;\n}\n\n/**\n * The `/` route (§3.1): the landing for a visitor, and for a session — real or demo —\n * the last visited page, else the app's home. Indexed and canonical `/` for the visitor;\n * a crawler never has a session, so for it `/` is stable.\n *\n * keksdose showed a session with nothing remembered the landing; the contract sends it\n * home instead, because a session at `/` came to use the app. The landing stays one tap\n * away at `/welcome`, where the signed-in brand link points.\n */\nexport function RootEntry({ session, resumePath, landing, home, loading }: RootEntryProps) {\n  if (session === \"loading\") return <>{loading ?? <LoadingState />}</>;\n  if (session === \"none\") return <>{landing}</>;\n  const resume = safeNextPath(resumePath);\n  return <Navigate to={resume && resume !== \"/\" ? resume : home} replace />;\n}\n\n/* ── RedirectIfAuthed ────────────────────────────────────────────────────── */\n\nexport interface RedirectIfAuthedProps {\n  /** `\"loading\"` while the app restores a session: neither the page nor a redirect. */\n  session: RoutingSession;\n  /** What shows while `session` is `\"loading\"`. Default: the kit's `LoadingState`. */\n  loading?: ReactNode;\n  /**\n   * Let a DEMO session through (§5.6): on `/login`, `/register` and the app's invitation\n   * pages, so a demo visitor can sign in or accept an invitation — a successful one\n   * replaces the demo session. Default `false`: on `/demo` a live demo continues instead\n   * of starting a second one (§5.2), and on `/forgot-password` a demo has no password.\n   */\n  allowDemo?: boolean;\n  /** Where a redirected session goes: the resume target —\n   *  `readLastVisitedPage(key, home)`. A safe `?next=` goes first. */\n  fallback: string;\n  /** The page. Left out, an `<Outlet />`: the component is a layout route around the\n   *  public pages, as in keksdose. */\n  children?: ReactNode;\n}\n\n/**\n * Public pages a session skips (§3.1): a signed-in visitor at `/login` goes back into\n * the app, to a safe `?next=` when the URL carries one (a share invitation or a push\n * deep link opened with a live session in another tab — keksdose) and else to\n * `fallback`.\n *\n * A demo session passes where `allowDemo` says so (§5.6). Mount one wrapper with\n * `allowDemo` around `/login`, `/register` and the invitation pages, and one without\n * around `/demo` (and `/forgot-password`).\n */\nexport function RedirectIfAuthed({ session, allowDemo = false, fallback, children, loading }: RedirectIfAuthedProps) {\n  const { search } = useLocation();\n  if (session === \"loading\") return <>{loading ?? <LoadingState />}</>;\n  if (session === \"none\" || (session === \"demo\" && allowDemo)) {\n    return children === undefined ? <Outlet /> : <>{children}</>;\n  }\n  const next = safeNextPath(new URLSearchParams(search).get(NEXT_PARAM));\n  return <Navigate to={next ?? fallback} replace />;\n}\n"],"mappings":";AA8KoC,mBAAc,WAAd;AA9KpC,SAAS,iBAAiB;AAE1B,SAAS,UAAU,QAAQ,mBAAmB;AAE9C,SAAS,YAAY,cAAc,mBAAmB;AAEtD,SAAS,oBAAoB;AAqBtB,MAAM,aAAa;AAqBnB,SAAS,aAAa,KAA+C;AAC1E,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,OAAO,OAAO,WAAW,cAAc,OAAO,SAAS,SAAS;AACtE,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK,IAAI;AAC7B,QAAI,IAAI,WAAW,KAAM,QAAO;AAChC,WAAO,GAAG,IAAI,QAAQ,GAAG,IAAI,MAAM,GAAG,IAAI,IAAI;AAAA,EAChD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeO,MAAM,gCAAwD,OAAO,OAAO;AAAA,EACjF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,YAAY,UAAkB,SAA+B;AACpE,MAAI,OAAO,YAAY,SAAU,QAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,MAAM,QAAQ,KAAK,EAAE,CAAC,EAAE,KAAK,QAAQ;AAChH,MAAI,YAAY,IAAK,QAAO,aAAa;AACzC,QAAM,OAAO,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI;AAC5D,SAAO,aAAa,QAAQ,SAAS,WAAW,GAAG,IAAI,GAAG;AAC5D;AAGA,SAAS,WAAW,UAAkB,SAA0C;AAC9E,SAAO,CAAC,GAAG,+BAA+B,GAAG,OAAO,EAAE,KAAK,CAAC,YAAY,YAAY,UAAU,OAAO,CAAC;AACxG;AAqBO,SAAS,mBAAmB,EAAE,KAAK,UAAU,CAAC,GAAG,UAAU,KAAK,GAAiC;AACtG,QAAM,EAAE,UAAU,OAAO,IAAI,YAAY;AAGzC,QAAM,OAAO,CAAC,WAAW,WAAW,UAAU,OAAO;AACrD,YAAU,MAAM;AACd,QAAI,KAAM;AACV,gBAAY,KAAK,WAAW,MAAM;AAAA,EACpC,GAAG,CAAC,KAAK,UAAU,QAAQ,IAAI,CAAC;AAClC;AAUO,SAAS,oBAAoB,KAAa,WAA0B,MAAqB;AAC9F,SAAO,aAAa,WAAW,GAAG,CAAC,KAAK;AAC1C;AAIO,SAAS,qBAAqB,KAAmB;AACtD,eAAa,GAAG;AAClB;AA4BO,SAAS,UAAU,EAAE,SAAS,YAAY,SAAS,MAAM,QAAQ,GAAmB;AACzF,MAAI,YAAY,UAAW,QAAO,gCAAG,qBAAW,oBAAC,gBAAa,GAAG;AACjE,MAAI,YAAY,OAAQ,QAAO,gCAAG,mBAAQ;AAC1C,QAAM,SAAS,aAAa,UAAU;AACtC,SAAO,oBAAC,YAAS,IAAI,UAAU,WAAW,MAAM,SAAS,MAAM,SAAO,MAAC;AACzE;AAkCO,SAAS,iBAAiB,EAAE,SAAS,YAAY,OAAO,UAAU,UAAU,QAAQ,GAA0B;AACnH,QAAM,EAAE,OAAO,IAAI,YAAY;AAC/B,MAAI,YAAY,UAAW,QAAO,gCAAG,qBAAW,oBAAC,gBAAa,GAAG;AACjE,MAAI,YAAY,UAAW,YAAY,UAAU,WAAY;AAC3D,WAAO,aAAa,SAAY,oBAAC,UAAO,IAAK,gCAAG,UAAS;AAAA,EAC3D;AACA,QAAM,OAAO,aAAa,IAAI,gBAAgB,MAAM,EAAE,IAAI,UAAU,CAAC;AACrE,SAAO,oBAAC,YAAS,IAAI,QAAQ,UAAU,SAAO,MAAC;AACjD;","names":[]}

package/dist/lib/calc.d.ts

@@ -8,7 +8,7 @@
  */
 /** Evaluate an arithmetic string, returning `null` if it isn't a valid sum.
  * Accepts the on-screen operator glyphs (`× ÷ −`) and comma decimals too. */
-declare function evaluateExpression(expr: string): number | null;
+export declare function evaluateExpression(expr: string): number | null;
 /** True when `s` carries arithmetic beyond a single leading minus — i.e. a plain
  * number (or a lone negative like "-5") is NOT an expression, but "12+5" is.
  * Used to decide whether a field's text should be evaluated on commit.
@@ -18,7 +18,7 @@ declare function evaluateExpression(expr: string): number | null;
  * arithmetic went on to be read as a plain number — where the digits-only fallback
  * in {@link commitExpression} silently ate it, turning "-42−−50" (= 8) into a bare
  * 8 with no record that a sum had happened at all. */
-declare function looksLikeExpression(s: string): boolean;
+export declare function looksLikeExpression(s: string): boolean;
 /** Render an evaluated number back to a field-friendly string, trimming binary
  * float noise (so 0.1 + 0.2 reads "0.3", not "0.30000000000000004").
  *
@@ -40,7 +40,7 @@ declare function looksLikeExpression(s: string): boolean;
  * The invariant, which the test asserts directly rather than by example:
  * **`commitExpression(formatResult(n))` equals `formatResult(n)` for every finite
  * `n`.** Anything rendered here has to survive being read back. */
-declare function formatResult(n: number): string;
+export declare function formatResult(n: number): string;
 /** The single "on blur / Enter" transform a numeric field applies: evaluate the
  * text if it's an expression, otherwise normalise it to a bare number string
  * (comma → dot, dropping stray characters, non-leading minuses and anything after
@@ -54,7 +54,7 @@ declare function formatResult(n: number): string;
  * at the second dot ("1.2") rather than joined ("1.23"): with no keystroke to
  * ignore there is nothing to say which reading was meant, and the shorter one
  * cannot silently invent a bigger number. */
-declare function commitExpression(raw: string): string;
+export declare function commitExpression(raw: string): string;
 /** The live, per-keystroke transform a numeric field applies: comma → dot and
  * drop anything that isn't a digit, decimal point, arithmetic operator (incl.
  * the on-screen `× ÷` glyphs) or paren — so a typed calculation survives
@@ -62,13 +62,13 @@ declare function commitExpression(raw: string): string;
  * `-` is kept — in a plain field it is simply a negative amount; in a field whose
  * caller owns the sign it is read off again by {@link splitLeadingSign}. The text
  * is resolved to a plain number on blur/Enter via {@link commitExpression}. */
-declare function sanitizeLive(raw: string): string;
+export declare function sanitizeLive(raw: string): string;
 /** A bare, unsigned amount: digits with at most one decimal separator and nothing
  *  else — "42", "42.", ".5", "0,5". NOT "" (an empty field has no figure to put a
  *  sign in front of), not "-42", not "12+5". It is the only shape a DISPLAYED sign
  *  prefix makes sense in front of; an expression carries its own arithmetic and has
  *  to survive keystroke-for-keystroke. */
-declare function isBareAmount(s: string): boolean;
+export declare function isBareAmount(s: string): boolean;
 /**
  * Split a LEADING sign off a plain signed number (Keksdose live #201 rework):
  * `"-42"` → `{ sign: "-", rest: "42" }`, everything else → `{ sign: "", rest: text }`.
@@ -81,9 +81,7 @@ declare function isBareAmount(s: string): boolean;
  * A lone "-" splits (rest ""): the sign is a statement about the direction the
  * moment it is typed, before any digit exists.
  */
-declare function splitLeadingSign(text: string): {
+export declare function splitLeadingSign(text: string): {
     sign: "" | "-" | "+";
     rest: string;
 };
-
-export { commitExpression, evaluateExpression, formatResult, isBareAmount, looksLikeExpression, sanitizeLive, splitLeadingSign };

package/dist/lib/chip-edge-snap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Re-snap every chip rendered with `snapEdges`, now. The kit already re-snaps when a
+ * chip renders, resizes, or the window or the ratio changes; call this after moving
+ * chips some other way (a side panel sliding in beside a table of status chips),
+ * since a move is not something an observer can see.
+ */
+export declare function refreshChipEdges(): void;
+/** The ref a chip hangs on its visible pill, plus a re-snap after every render (its
+ *  label or its neighbours may have changed). */
+export declare function useSnapEdges(on: boolean): (el: HTMLElement | null) => void;

package/dist/lib/chip-edge-snap.js

@@ -0,0 +1,131 @@
+"use client";
+import { useCallback, useLayoutEffect, useRef } from "react";
+function chipEdgeGrid(dpr) {
+  for (let n = 1; n <= 4; n++) if (Math.abs(n * dpr - Math.round(n * dpr)) < 1e-3) return n;
+  return 0;
+}
+function snappedChipEdgeWidth(natural, left, dpr) {
+  const n = chipEdgeGrid(dpr);
+  if (n <= 2) return natural;
+  const l = Math.round(left);
+  let w = Math.ceil(natural - 0.01);
+  while (((2 * l + w) % n + n) % n !== 0) w++;
+  return w;
+}
+const snapped = /* @__PURE__ */ new Set();
+const written = /* @__PURE__ */ new WeakMap();
+let snapFrame = 0;
+let snapObserver = null;
+let ratioQuery = null;
+function clearOwn(el) {
+  const own = written.get(el);
+  if (own !== void 0 && el.style.minWidth === own) el.style.minWidth = "";
+  written.delete(el);
+}
+function refreshChipEdges() {
+  if (snapFrame) {
+    cancelAnimationFrame(snapFrame);
+    snapFrame = 0;
+  }
+  if (typeof window === "undefined" || !snapped.size) return;
+  const dpr = window.devicePixelRatio || 1;
+  const els = [...snapped];
+  for (const el of els) clearOwn(el);
+  const n = chipEdgeGrid(dpr);
+  if (n <= 2) return;
+  let pending = els;
+  for (let pass = 0; pass <= n && pending.length; pass++) {
+    const reads = pending.map((el) => {
+      const r = el.getBoundingClientRect();
+      const label = el.querySelector(".truncate-until-large");
+      if (!r.width || label && (label.scrollWidth > label.clientWidth || labelWraps(label))) return null;
+      const width = Math.round(r.width * 64) / 64;
+      const target = snappedChipEdgeWidth(width, r.left + window.scrollX, dpr);
+      return target === width ? null : target;
+    });
+    const next = [];
+    pending.forEach((el, i) => {
+      const target = reads[i];
+      if (target == null) return;
+      if (pass === n) {
+        clearOwn(el);
+        return;
+      }
+      const own = written.get(el);
+      const value = `${pass > 0 && own !== void 0 ? parseFloat(own) + 1 : target}px`;
+      el.style.minWidth = value;
+      written.set(el, value);
+      next.push(el);
+    });
+    pending = next;
+  }
+}
+function labelWraps(label) {
+  const line = Number.parseFloat(getComputedStyle(label).lineHeight);
+  return line > 0 && label.clientHeight > 1.5 * line;
+}
+function scheduleChipEdges() {
+  if (snapFrame || typeof requestAnimationFrame === "undefined") return;
+  snapFrame = requestAnimationFrame(() => {
+    snapFrame = 0;
+    refreshChipEdges();
+  });
+}
+function watchRatio() {
+  ratioQuery?.removeEventListener("change", onRatioChange);
+  ratioQuery = typeof window.matchMedia === "function" ? window.matchMedia(`(resolution: ${window.devicePixelRatio || 1}dppx)`) : null;
+  ratioQuery?.addEventListener("change", onRatioChange);
+}
+function onRatioChange() {
+  watchRatio();
+  scheduleChipEdges();
+}
+function registerSnap(el) {
+  if (snapped.has(el)) return;
+  if (!snapped.size) {
+    if (typeof ResizeObserver !== "undefined") snapObserver = new ResizeObserver(scheduleChipEdges);
+    window.addEventListener("resize", scheduleChipEdges);
+    watchRatio();
+  }
+  snapped.add(el);
+  snapObserver?.observe(el);
+  scheduleChipEdges();
+}
+function unregisterSnap(el) {
+  if (!snapped.delete(el)) return;
+  snapObserver?.unobserve(el);
+  clearOwn(el);
+  if (snapped.size) return;
+  snapObserver?.disconnect();
+  snapObserver = null;
+  window.removeEventListener("resize", scheduleChipEdges);
+  ratioQuery?.removeEventListener("change", onRatioChange);
+  ratioQuery = null;
+}
+function useSnapEdges(on) {
+  const node = useRef(null);
+  const ref = useCallback(
+    (el) => {
+      if (el === node.current) return;
+      const prev = node.current;
+      node.current = el;
+      if (prev) queueMicrotask(() => node.current !== prev && unregisterSnap(prev));
+      if (el && on) registerSnap(el);
+    },
+    [on]
+  );
+  useLayoutEffect(() => {
+    const el = node.current;
+    if (!el) return;
+    if (on) {
+      registerSnap(el);
+      scheduleChipEdges();
+    } else unregisterSnap(el);
+  });
+  return ref;
+}
+export {
+  refreshChipEdges,
+  useSnapEdges
+};
+//# sourceMappingURL=chip-edge-snap.js.map

package/dist/lib/chip-edge-snap.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/chip-edge-snap.ts"],"sourcesContent":["// Chip's edge snapping: the module-level engine (one ResizeObserver, one `resize`\n// listener and one resolution query for every snapped chip on the page, and the state\n// they share) and the hook a chip hangs it on. Moved out of components/chip.tsx as it\n// was (MOD-9, refactor audit 2026-10); chip.tsx still exports `refreshChipEdges`.\nimport { useCallback, useLayoutEffect, useRef } from \"react\";\n\n/* ── Edge snapping (fractional device-pixel ratios) ──────────────────────────\n *\n * WHY. At a device-pixel ratio of 1.25 (a 125 % Windows display, or 125 % browser\n * zoom) Chrome snaps a box to whole CSS pixels and only then scales it, so a 1px\n * border is 1.25 device pixels wide and starts at a quarter-pixel phase that depends\n * on where the edge lands. A chip's left edge follows whatever stands before it, its\n * right edge follows its own text, so the two land on unrelated phases: one rasterises\n * as a crisp pixel, the other as a two-pixel smear at half strength — and a 60 %-alpha\n * border (`--danger-border`) makes the smeared side read as a THINNER line (keksdose\n * dev #576).\n *\n * WHAT FIXES IT. The two edges rasterise as mirror images exactly when their device\n * positions sum to a whole number: `(2·left + width) · dpr` integral, `left` being the\n * edge's snapped CSS x. Rounding the WIDTH alone to the ratio's grid (4px at 1.25)\n * makes the phases EQUAL, which is not the same thing: measured with keksdose's\n * playwright harness across every left phase at 1.25, width-only rounding mirrored the\n * edges at two of the four phases and left the other two as lopsided as before (mean\n * peak asymmetry 16.5, worse than the unsnapped 10.9 a random width gets by luck); the\n * position-aware width below took it to 0 at every phase. Inset rings, whole-pixel\n * starts, compositing hints and fractional border widths were measured by keksdose\n * and do not help — Chrome rounds a sub-pixel border back up to 1px.\n *\n * So the fix needs the chip's position, which is why it is opt-in (`snapEdges`): it\n * reads layout. Cheaply — every snapped chip on the page shares one ResizeObserver,\n * one `resize` listener and one resolution media query, and a pass is batched into a\n * frame as read-all / write-all, not a forced layout per chip. At an integer ratio,\n * and at a half one (1.5, 2.5: grid 2 — measured symmetric already, both edges a\n * pixel and a half on the same pattern), there is nothing to fix and a pass\n * writes nothing.\n */\n\n/** The smallest whole CSS-pixel count `n` with `n × dpr` whole — 4 at 1.25, 2 at 1.5,\n *  1 at an integer ratio. 0 for a ratio no step up to 4px fits (110 % zoom wants 10px;\n *  a chip growing by up to 9px is a layout change, not a hairline fix). */\nfunction chipEdgeGrid(dpr: number): number {\n  for (let n = 1; n <= 4; n++) if (Math.abs(n * dpr - Math.round(n * dpr)) < 1e-3) return n;\n  return 0;\n}\n\n/**\n * The width (whole CSS px, at least `natural`) that mirrors a box's two edges at\n * `dpr`, for a box whose left edge sits at CSS x `left`. `natural` back when the ratio\n * needs nothing.\n */\nfunction snappedChipEdgeWidth(natural: number, left: number, dpr: number): number {\n  const n = chipEdgeGrid(dpr);\n  if (n <= 2) return natural;\n  const l = Math.round(left);\n  // A hair under a whole pixel is that pixel: 59.999 is a 60px chip, not a 61px one.\n  let w = Math.ceil(natural - 0.01);\n  while ((((2 * l + w) % n) + n) % n !== 0) w++;\n  return w;\n}\n\nconst snapped = new Set<HTMLElement>();\n/** The min-width each chip was given by a pass — so a pass only ever clears its own. */\nconst written = new WeakMap<HTMLElement, string>();\nlet snapFrame = 0;\nlet snapObserver: ResizeObserver | null = null;\nlet ratioQuery: MediaQueryList | null = null;\n\nfunction clearOwn(el: HTMLElement) {\n  const own = written.get(el);\n  if (own !== undefined && el.style.minWidth === own) el.style.minWidth = \"\";\n  written.delete(el);\n}\n\n/**\n * Re-snap every chip rendered with `snapEdges`, now. The kit already re-snaps when a\n * chip renders, resizes, or the window or the ratio changes; call this after moving\n * chips some other way (a side panel sliding in beside a table of status chips),\n * since a move is not something an observer can see.\n */\nexport function refreshChipEdges(): void {\n  if (snapFrame) {\n    cancelAnimationFrame(snapFrame);\n    snapFrame = 0;\n  }\n  if (typeof window === \"undefined\" || !snapped.size) return;\n  const dpr = window.devicePixelRatio || 1;\n  const els = [...snapped];\n  // Write: back to the natural width, so what is read below is the chip, not our pin.\n  for (const el of els) clearOwn(el);\n  const n = chipEdgeGrid(dpr);\n  if (n <= 2) return;\n  // A chip whose own end decides where it starts (RTL, `justify-end`) moves when it\n  // grows, so a pass re-reads what it wrote and steps on by a pixel until the edges\n  // agree — `n` steps cover every residue. Each pass is ONE layout for every chip\n  // together. A chip that never agrees (a centred one moves both edges at once) is\n  // given its natural width back rather than kept wider for nothing.\n  let pending = els;\n  for (let pass = 0; pass <= n && pending.length; pass++) {\n    const reads = pending.map((el) => {\n      const r = el.getBoundingClientRect();\n      // The text label (chip.tsx's CHIP_LABEL_TRUNCATE; `.truncate` before 0.33).\n      const label = el.querySelector<HTMLElement>(\".truncate-until-large\");\n      // Not laid out (a hidden ancestor, jsdom), or truncated at its container's edge,\n      // where a wider chip would overflow: leave it alone. So too a label wrapped onto\n      // a second line at Large (0.32.1): the chip is already as wide as its row lets it\n      // be, and a min-width past that would push it over the edge just the same.\n      if (!r.width || (label && (label.scrollWidth > label.clientWidth || labelWraps(label)))) return null;\n      const width = Math.round(r.width * 64) / 64;\n      const target = snappedChipEdgeWidth(width, r.left + window.scrollX, dpr);\n      return target === width ? null : target;\n    });\n    const next: HTMLElement[] = [];\n    pending.forEach((el, i) => {\n      const target = reads[i];\n      if (target == null) return;\n      if (pass === n) {\n        clearOwn(el);\n        return;\n      }\n      const own = written.get(el);\n      const value = `${pass > 0 && own !== undefined ? parseFloat(own) + 1 : target}px`;\n      el.style.minWidth = value;\n      written.set(el, value);\n      next.push(el);\n    });\n    pending = next;\n  }\n}\n\n/** Whether a chip's label runs to more than one line — taller than one and a half of\n *  its line height. A line height of `normal` (no number to compare) counts as one line. */\nfunction labelWraps(label: HTMLElement): boolean {\n  const line = Number.parseFloat(getComputedStyle(label).lineHeight);\n  return line > 0 && label.clientHeight > 1.5 * line;\n}\n\nfunction scheduleChipEdges() {\n  if (snapFrame || typeof requestAnimationFrame === \"undefined\") return;\n  snapFrame = requestAnimationFrame(() => {\n    snapFrame = 0;\n    refreshChipEdges();\n  });\n}\n\n/** The resolution query for the CURRENT ratio: it stops matching when the ratio\n *  changes (a window dragged to another display), which a `resize` need not fire. */\nfunction watchRatio() {\n  ratioQuery?.removeEventListener(\"change\", onRatioChange);\n  ratioQuery =\n    typeof window.matchMedia === \"function\"\n      ? window.matchMedia(`(resolution: ${window.devicePixelRatio || 1}dppx)`)\n      : null;\n  ratioQuery?.addEventListener(\"change\", onRatioChange);\n}\n\nfunction onRatioChange() {\n  watchRatio();\n  scheduleChipEdges();\n}\n\nfunction registerSnap(el: HTMLElement) {\n  if (snapped.has(el)) return;\n  if (!snapped.size) {\n    if (typeof ResizeObserver !== \"undefined\") snapObserver = new ResizeObserver(scheduleChipEdges);\n    window.addEventListener(\"resize\", scheduleChipEdges);\n    watchRatio();\n  }\n  snapped.add(el);\n  snapObserver?.observe(el);\n  scheduleChipEdges();\n}\n\nfunction unregisterSnap(el: HTMLElement) {\n  if (!snapped.delete(el)) return;\n  snapObserver?.unobserve(el);\n  clearOwn(el);\n  if (snapped.size) return;\n  snapObserver?.disconnect();\n  snapObserver = null;\n  window.removeEventListener(\"resize\", scheduleChipEdges);\n  ratioQuery?.removeEventListener(\"change\", onRatioChange);\n  ratioQuery = null;\n}\n\n/** The ref a chip hangs on its visible pill, plus a re-snap after every render (its\n *  label or its neighbours may have changed). */\nexport function useSnapEdges(on: boolean) {\n  const node = useRef<HTMLElement | null>(null);\n  const ref = useCallback(\n    (el: HTMLElement | null) => {\n      if (el === node.current) return;\n      const prev = node.current;\n      node.current = el;\n      // React detaches and re-attaches a ref whose callback changed identity (a\n      // consumer's inline ref) — the same element, a moment apart. Unregistering on\n      // the detach would clear the pin and paint one frame unsnapped, so the drop\n      // waits a microtask and is skipped if the element came straight back.\n      if (prev) queueMicrotask(() => node.current !== prev && unregisterSnap(prev));\n      if (el && on) registerSnap(el);\n    },\n    [on],\n  );\n  useLayoutEffect(() => {\n    const el = node.current;\n    if (!el) return;\n    if (on) {\n      registerSnap(el);\n      scheduleChipEdges();\n    } else unregisterSnap(el);\n  });\n  return ref;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/clipping.d.ts

@@ -13,13 +13,11 @@
  * (DataTable's body, Table's wrapper) carry the marker, so the answer is the same in
  * both; an app marks its own with `{ [CLIPS_ATTRIBUTE]: "" }` or a literal `data-clips`.
  */
-declare const CLIPS_ATTRIBUTE = "data-clips";
+export declare const CLIPS_ATTRIBUTE = "data-clips";
 /** Whether anything between `el` and `<body>` clips or scrolls its content — the
  *  containers an absolutely positioned bubble would be cut off by, or would widen.
  *  Either the computed `overflow` says so or the element carries
  *  {@link CLIPS_ATTRIBUTE}. `<body>` and `<html>` are not counted: their `overflow`
  *  belongs to the viewport (a dialog's scroll lock sets it), and the viewport clips a
  *  portalled bubble just the same. */
-declare function hasClippingAncestor(el: Element | null): boolean;
-
-export { CLIPS_ATTRIBUTE, hasClippingAncestor };
+export declare function hasClippingAncestor(el: Element | null): boolean;

package/dist/lib/cn.d.ts

@@ -1,6 +1,3 @@
-import { clsx } from 'clsx';
-
+import { clsx } from "clsx";
 /** Merge class lists with Tailwind conflict resolution (later wins). */
-declare const cn: (...inputs: Parameters<typeof clsx>) => string;
-
-export { cn };
+export declare const cn: (...inputs: Parameters<typeof clsx>) => string;

package/dist/lib/cn.js

@@ -1,7 +1,12 @@
 "use client";
 import { clsx } from "clsx";
 import { extendTailwindMerge } from "tailwind-merge";
-const merge = extendTailwindMerge({ extend: { theme: { text: ["micro", "caption"] } } });
+const merge = extendTailwindMerge({
+  extend: {
+    theme: { text: ["micro", "caption"] },
+    classGroups: { "ring-w": [{ ring: ["focus"] }], "outline-w": [{ outline: ["focus"] }] }
+  }
+});
 const cn = (...inputs) => merge(clsx(inputs));
 export {
   cn

package/dist/lib/cn.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/cn.ts"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { extendTailwindMerge } from \"tailwind-merge\";\n\n/**\n * tailwind-merge, told about the kit's own font sizes (docs/text-size-harmonization.md\n * §3.2): `text-micro` and `text-caption` are `@theme` sizes in tokens.css, which\n * tailwind-merge cannot see. Unknown, a `text-<word>` is taken for a COLOUR, so\n * `cn(\"text-caption text-[var(--text-muted)]\")` dropped the size — the later colour\n * \"won\" over it — and `cn(\"text-xs\", \"text-caption\")` kept both sizes. Registered as\n * sizes, they merge like `text-xs`: a later size replaces an earlier one, a colour sits\n * beside them.\n */\nconst merge = extendTailwindMerge({ extend: { theme: { text: [\"micro\", \"caption\"] } } });\n\n/** Merge class lists with Tailwind conflict resolution (later wins). */\nexport const cn = (...inputs: Parameters<typeof clsx>) => merge(clsx(inputs));\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,2BAA2B;AAWpC,MAAM,QAAQ,oBAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,SAAS,EAAE,EAAE,EAAE,CAAC;AAGhF,MAAM,KAAK,IAAI,WAAoC,MAAM,KAAK,MAAM,CAAC;","names":[]}
+{"version":3,"sources":["../../src/lib/cn.ts"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { extendTailwindMerge } from \"tailwind-merge\";\n\n/**\n * tailwind-merge, told about the kit's own font sizes (docs/text-size-harmonization.md\n * §3.2): `text-micro` and `text-caption` are `@theme` sizes in tokens.css, which\n * tailwind-merge cannot see. Unknown, a `text-<word>` is taken for a COLOUR, so\n * `cn(\"text-caption text-[var(--text-muted)]\")` dropped the size — the later colour\n * \"won\" over it — and `cn(\"text-xs\", \"text-caption\")` kept both sizes. Registered as\n * sizes, they merge like `text-xs`: a later size replaces an earlier one, a colour sits\n * beside them.\n *\n * The same for the focus frame's width (0.34, refactor audit DOC-7): `ring-focus` and\n * `outline-focus` are `@theme inline` WIDTHS, and unknown, a `ring-<word>` is taken for a\n * colour — so `cn(FOCUS_RING, \"focus-visible:ring-strong\")` dropped the width and the\n * ring was gone. Registered as widths, they merge like `ring-2` / `outline-2`, as the\n * arbitrary `length:` widths they replaced did. (No class is spelt out here: an app's\n * Tailwind scans the built source maps too, and would generate it.)\n */\nconst merge = extendTailwindMerge({\n  extend: {\n    theme: { text: [\"micro\", \"caption\"] },\n    classGroups: { \"ring-w\": [{ ring: [\"focus\"] }], \"outline-w\": [{ outline: [\"focus\"] }] },\n  },\n});\n\n/** Merge class lists with Tailwind conflict resolution (later wins). */\nexport const cn = (...inputs: Parameters<typeof clsx>) => merge(clsx(inputs));\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,2BAA2B;AAkBpC,MAAM,QAAQ,oBAAoB;AAAA,EAChC,QAAQ;AAAA,IACN,OAAO,EAAE,MAAM,CAAC,SAAS,SAAS,EAAE;AAAA,IACpC,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE;AAAA,EACxF;AACF,CAAC;AAGM,MAAM,KAAK,IAAI,WAAoC,MAAM,KAAK,MAAM,CAAC;","names":[]}

package/dist/lib/column-mapping.d.ts

@@ -1,7 +1,6 @@
-import { TextTable } from './table-text.js';
-
+import type { TextTable } from "./table-text.js";
 /** One part a column can play, defined by the caller. */
-interface ColumnRole<R extends string = string> {
+export interface ColumnRole<R extends string = string> {
     /** The key the mapping is stored under. */
     value: R;
     /** What the role select shows — translated by the caller. */
@@ -23,9 +22,9 @@ interface ColumnRole<R extends string = string> {
 }
 /** Role → column index. A role that is absent or `null` sits on no column — so a
  *  mapping with nullable fields (keksdose's `CsvMapping`) is one as it stands. */
-type ColumnMapping<R extends string = string> = Partial<Record<R, number | null>>;
+export type ColumnMapping<R extends string = string> = Partial<Record<R, number | null>>;
 /** What the table is, read through a mapping. */
-interface ColumnMapperResult<R extends string = string> extends TextTable {
+export interface ColumnMapperResult<R extends string = string> extends TextTable {
     mapping: ColumnMapping<R>;
     /** What the table still needs before it can be used: one entry per gap, each the
      *  roles any of which would fill it (one role, or a required group). */
@@ -34,7 +33,7 @@ interface ColumnMapperResult<R extends string = string> extends TextTable {
     complete: boolean;
 }
 /** The role on this column, or `null` for an ignored one. */
-declare function roleOfColumn<R extends string>(roles: readonly ColumnRole<R>[], mapping: ColumnMapping<R>, column: number): R | null;
+export declare function roleOfColumn<R extends string>(roles: readonly ColumnRole<R>[], mapping: ColumnMapping<R>, column: number): R | null;
 /**
  * Put `role` on `column` — or, with `null`, take the column's role off it.
  *
@@ -42,12 +41,12 @@ declare function roleOfColumn<R extends string>(roles: readonly ColumnRole<R>[],
  * column, in one new mapping (keksdose's `assignColumn`: "both halves are patches to
  * the same object"). Other fields of the mapping are kept as they are.
  */
-declare function assignColumnRole<R extends string, M extends ColumnMapping<R>>(roles: readonly ColumnRole<R>[], mapping: M, column: number, role: R | null): M;
+export declare function assignColumnRole<R extends string, M extends ColumnMapping<R>>(roles: readonly ColumnRole<R>[], mapping: M, column: number, role: R | null): M;
 /**
  * The gaps: each required role with no column, and each required group none of whose
  * roles has one. In the order of `roles`. A column index past `width` is no column.
  */
-declare function missingRoles<R extends string>(roles: readonly ColumnRole<R>[], mapping: ColumnMapping<R>, width?: number): R[][];
+export declare function missingRoles<R extends string>(roles: readonly ColumnRole<R>[], mapping: ColumnMapping<R>, width?: number): R[][];
 /**
  * A first mapping for a table nobody has mapped yet.
  *
@@ -58,14 +57,14 @@ declare function missingRoles<R extends string>(roles: readonly ColumnRole<R>[],
  * export of twelve columns, "the fourth role is the fourth column" is a wrong answer
  * presented as a suggestion, and an "ignore" is the honest one.
  */
-declare function guessMapping<R extends string>(roles: readonly ColumnRole<R>[], header: readonly string[] | null, width: number): ColumnMapping<R>;
+export declare function guessMapping<R extends string>(roles: readonly ColumnRole<R>[], header: readonly string[] | null, width: number): ColumnMapping<R>;
 /**
  * The table read through the mapping: the rows every `numeric` role can read, the
  * others moved to `unread` (in line order, with the parse's own), what is missing,
  * and whether the table can be used. Column indexes past the table's width count as
  * unplaced.
  */
-declare function readMappedTable<R extends string>(table: TextTable, roles: readonly ColumnRole<R>[], mapping: ColumnMapping<R>): ColumnMapperResult<R>;
+export declare function readMappedTable<R extends string>(table: TextTable, roles: readonly ColumnRole<R>[], mapping: ColumnMapping<R>): ColumnMapperResult<R>;
 /**
  * A dropped or chosen file's text — UTF-8 when it is UTF-8, else Windows-1252.
  *
@@ -76,6 +75,4 @@ declare function readMappedTable<R extends string>(table: TextTable, roles: read
  * read in the browser had nothing doing it). Falls back to `FileReader` where a `File`
  * has no `arrayBuffer` (Kurvenschmiede's `readText`).
  */
-declare function readTextFile(file: Blob): Promise<string>;
-
-export { type ColumnMapperResult, type ColumnMapping, type ColumnRole, assignColumnRole, guessMapping, missingRoles, readMappedTable, readTextFile, roleOfColumn };
+export declare function readTextFile(file: Blob): Promise<string>;