@eifi1/ui-kit 0.52.0 → 0.54.0

package/src/components/section-nav.tsx

@@ -1,72 +0,0 @@
-import { cn } from "../lib/cn";
-import { NavPills } from "./nav-pills";
-import type { NavPillItem, NavPillLinkProps } from "./nav-pills";
-import type { ReactElement, Ref } from "react";
-
-/** @deprecated 0.52 — `NavPillsProps` with `layout="scroll"`, what SectionNav wraps; removed in
- *  0.53 (no app renders SectionNav: refactor audit 2026-10-30, MOD-5). */
-export interface SectionNavProps<T extends string> {
-  /** The section's pages, each with its `href` (a pill without one is a button that
-   *  calls `onSelect`). Labels short: the row is one line. */
-  items: NavPillItem<T>[];
-  /** The page that is open. `null`: none of them. */
-  current: T | null;
-  /** The section's name — the landmark's accessible name ("Accounting"). */
-  label: string;
-  /** Called with a pill's value on a click, before the router follows its link. */
-  onSelect?: (value: T) => void;
-  /** Your router's link. Default: the `<UiKitProvider linkComponent>`, then `<a>`. */
-  renderLink?: (props: NavPillLinkProps) => ReactElement;
-  /** Default `true`: only below `md`, where the sidebar that lists the same pages is
-   *  gone. `false` shows it at every width. */
-  phoneOnly?: boolean;
-  className?: string;
-  ref?: Ref<HTMLElement>;
-}
-
-/**
- * The pages of a section on a phone, as one row of pills under the page title (0.49
- * KIT-6) — kastlan's section pills, which each section page drew by hand.
- *
- * On a desktop the sidebar lists a group's pages; on a phone the AppShell's bar holds
- * the groups, and a group's pages are a sheet away. This row puts them on the page
- * itself: {@link NavPills} with `layout="scroll"` — one line that scrolls sideways, faded
- * where it is cut, the open page scrolled into view (the row only, never the page). At
- * most 48 px high: 44 px pills, the touch target a finger needs, and 2 px above and
- * below. Each pill is a link (`aria-current="page"` on the open one) and its own tab
- * stop; the row is a `<nav>` named by `label`.
- *
- * Place it right under the page's title (`PageHeader`); the AppShell's own row of a
- * group's pages above the bar (`mobileSubNav`) is the shell-wide alternative — use one,
- * not both, for the same pages.
- *
- * @deprecated 0.52 — `<NavPills layout="scroll" itemClassName="min-h-11 focus-visible:ring-inset"
- * className="md:hidden">`, the same row; removed in 0.53. kastlan, whose section pills it
- * was made for (0.49 KIT-6), never adopted it: no app renders it (refactor audit
- * 2026-10-30, MOD-5).
- */
-export function SectionNav<T extends string>({
-  items,
-  current,
-  label,
-  onSelect,
-  renderLink,
-  phoneOnly = true,
-  className,
-  ref,
-}: SectionNavProps<T>) {
-  return (
-    <NavPills
-      ref={ref}
-      aria-label={label}
-      items={items}
-      current={current}
-      onSelect={onSelect}
-      renderLink={renderLink}
-      layout="scroll"
-      // The ring inside the pill: the row scrolls, so it clips what leaves its box.
-      itemClassName="min-h-11 focus-visible:ring-inset"
-      className={cn("py-0.5 large:py-0", phoneOnly && "md:hidden", className)}
-    />
-  );
-}

package/src/components/sign-chip-labels.ts

@@ -1,13 +0,0 @@
-// The English words of ./sign-chip, in a module with no component code: the English
-// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
-// chunk like the other languages (0.34, KS U8). ./sign-chip re-exports them.
-
-import type { SignChipLabels } from "./sign-chip";
-
-/** @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */
-export const DEFAULT_SIGN_CHIP_LABELS: SignChipLabels = {
-  outflow: "Outflow",
-  inflow: "Inflow",
-  direction: (current, next) => `Direction: ${current} — switch to ${next}`,
-  switchTo: (next) => `Switch to ${next}`,
-};

package/src/components/sign-chip.tsx

@@ -1,133 +0,0 @@
-import { ArrowUpDown, Minus, Plus } from "lucide-react";
-import { Chip } from "./chip";
-import { Tooltip } from "./tooltip";
-import { cn } from "../lib/cn";
-import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
-import { useLargeText } from "../hooks/use-large-text";
-import { DEFAULT_SIGN_CHIP_LABELS } from "./sign-chip-labels";
-
-// ── Labels ────────────────────────────────────────────────────────────────────
-
-/** The words a {@link SignChip} says — the `signChip` namespace of
- *  `<UiKitProvider labels>`, and per chip through its `labels` prop.
- *
- * @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */
-export interface SignChipLabels {
-  /** The chip's text while the figure is negative — money going out. */
-  outflow: string;
-  /** The chip's text while the figure is positive — money coming in. */
-  inflow: string;
-  /** The chip's accessible name and its tooltip: the state it is in, and what a press
-   *  turns it into — `current` and `next` are the two words above. The other option is
-   *  nowhere on screen to be read, so the name has to say both. */
-  direction: (current: string, next: string) => string;
-  /** 0.32: what a press does, in words under the chip at Large and Extra large —
-   *  `next` is the other direction's word ("Switch to Inflow"). The tooltip's half of
-   *  `direction`, shown, since a fact may not live only in a tooltip there (§4). */
-  switchTo: (next: string) => string;
-}
-
-// Defined in ./sign-chip-labels, which holds no component code (0.34, KS U8).
-export { DEFAULT_SIGN_CHIP_LABELS };
-
-/** @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */
-export interface SignChipProps {
-  /** The figure is negative (an outflow) — the same flag {@link AmountInput}'s
-   *  `negative` is, so one state feeds both: `<AmountInput negative={neg}
-   *  onNegativeChange={setNeg} />` and `<SignChip negative={neg}
-   *  onNegativeChange={setNeg} />`. */
-  negative: boolean;
-  /** A press: the other direction. */
-  onNegativeChange: (negative: boolean) => void;
-  disabled?: boolean;
-  /** Per-chip overrides of the `signChip` namespace. */
-  labels?: LabelOverride<SignChipLabels>;
-  /** On the chip. Place it in its row from here — keksdose's form passes `self-end`
-   *  to sit it on the display figure's baseline strip. */
-  className?: string;
-}
-
-/**
- * The SIGN of an amount, as one chip that shows only the state it is in — keksdose
- * K15, its `DirectionToggle` (feedback #417, #430, #431, dev#434) made a kit piece,
- * so the figure and its direction come from one package and wear one palette.
- *
- * WHY A CHIP, NOT A SEGMENTED CONTROL. A two-option toggle spends half its width
- * telling you what the figure is NOT, and at a phone's width it was the widest thing on
- * the form after the figure itself (#417). This sits beside the amount and reads as one
- * phrase with it — "−42,50 Outflow" — and a press flips it. Hiding the alternative costs
- * discoverability, so two things pay it back: the ± glyph and the swap arrows say "this
- * is a control", not a badge; and the name and tooltip spell out both the current state
- * and what a press will do.
- *
- * NOT A PRESSED/UNPRESSED TOGGLE. A {@link Chip} toggle has a FIXED label naming its
- * on-state, with `aria-pressed` carrying the state. Here the word IS the state, so it
- * is an action button with no `aria-pressed`: "Direction: Inflow, not pressed" would
- * name no on-state for "not pressed" to be the absence of. The name changing under
- * focus is the echo.
- *
- * THE COLOUR is the money pairing — the chip's `expense` / `income` tones, the same
- * `--money-expense` / `--money-income` that {@link AmountInput}'s `tone` paints the
- * figure with (dev#434): only the text and the border carry the tint, on a neutral
- * surface, because a filled pill next to a tinted figure reads as one smear.
- *
- * SIZE. `lg` on a phone — the 44px touch target beside a display figure that has no
- * field height to match — and from `md` up exactly a labelled field's 42px, so it never
- * stands taller than the fields in its grid row (#431).
- *
- * An exported chip rather than an `AmountInput signControl` slot: the slot would have
- * to own the row the two share, and every form lays that row out differently (beside
- * the figure on a phone, in a grid column on a desktop). The chip is the part that was
- * being re-written; the row stays the form's.
- *
- * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,
- * MOD-5): keksdose, whose chip this was (K15), kept its own `DirectionToggle` on `Chip`
- * and `Tooltip`, and no other app renders one.
- *
- * @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53.
- */
-export function SignChip({ negative, onNegativeChange, disabled, labels: labelsProp, className }: SignChipProps) {
-  const labels = useKitLabels("signChip", DEFAULT_SIGN_CHIP_LABELS, labelsProp);
-  const current = negative ? labels.outflow : labels.inflow;
-  const next = negative ? labels.inflow : labels.outflow;
-  const name = labels.direction(current, next);
-  // §4: at Large the chip's word is joined by what a press does, as a line under it —
-  // and the bubble that said only that goes.
-  const large = useLargeText();
-  const chip = (
-    <Chip
-      size="lg"
-      tone={negative ? "expense" : "income"}
-      icon={negative ? Minus : Plus}
-      onClick={() => onNegativeChange(!negative)}
-      disabled={disabled}
-      aria-label={name}
-      // `gap-1.5 px-3`: the chip's narrower body, because on a 375px screen every
-      // pixel of it is taken from the figure beside it (#430). `md:py-2.5` with the
-      // hairline border is the 42px a labelled field measures (#431).
-      className={cn("shrink-0 gap-1.5 whitespace-nowrap px-3 font-medium md:min-h-0 md:py-2.5", !large && className)}
-    >
-      {current}
-      {/* The swap arrows after the word, in the label's own row: decoration (the
-            name already says what a press does), set a little apart from the word. */}
-      <ArrowUpDown className="ms-1.5 inline size-3.5 align-[-0.2em] opacity-60" aria-hidden />
-    </Chip>
-  );
-  if (!large) {
-    return (
-      <Tooltip label={name} lazy>
-        {chip}
-      </Tooltip>
-    );
-  }
-  return (
-    // The caller's placement (`self-end`…) moves to the pair, which is now the row's item.
-    <span data-slot="sign-chip" className={cn("inline-flex shrink-0 flex-col items-start gap-0.5", className)}>
-      {chip}
-      {/* Hidden from the accessibility tree: the chip's name already says it. */}
-      <span aria-hidden className="text-xs text-muted">
-        {labels.switchTo(next)}
-      </span>
-    </span>
-  );
-}

package/src/lib/isin.ts

@@ -1,72 +0,0 @@
-/**
- * ISIN helpers — ISO 6166 — for keksdose, whose securities holdings are keyed by ISIN
- * and whose import and edit forms checked only the shape (two letters, ten
- * characters): a mistyped ISIN saved happily and then matched no price feed.
- *
- * An ISIN is twelve characters: a two-letter prefix (the issuing country, or a
- * supranational code such as `XS`), nine letters or digits (the national number) and
- * one check digit. The check digit is the Luhn digit of the first eleven characters
- * with every letter expanded to two digits (A = 10 … Z = 35) — which is all that is
- * checked here. Whether the prefix is an assigned code, and whether the security
- * exists, is a lookup, not a checksum.
- *
- * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,
- * MOD-5): keksdose, which they were written for, never imported them, and no other app
- * does.
- */
-
-/** Letters to their two-digit numbers (A = 10 … Z = 35), digits as they are. */
-function expandLetters(value: string): string {
-  return value.replace(/[A-Z]/g, (c) => String(c.charCodeAt(0) - 55));
-}
-
-/** The Luhn sum of `digits` with the RIGHTMOST digit doubled first — the shape of the
- *  sum when a check digit is about to be appended. */
-function luhnSum(digits: string, doubleRightmost: boolean): number {
-  let sum = 0;
-  let double = doubleRightmost;
-  for (let i = digits.length - 1; i >= 0; i--) {
-    let d = digits.charCodeAt(i) - 48;
-    if (double) {
-      d *= 2;
-      if (d > 9) d -= 9;
-    }
-    sum += d;
-    double = !double;
-  }
-  return sum;
-}
-
-/**
- * The ISIN as it is printed: upper case, unbroken (ISO 6166 has no grouping), with
- * the spaces and hyphens a paste from a broker's statement carries dropped.
- *
- * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.
- */
-export function formatIsin(value: string): string {
-  return value.replace(/[\s-]/g, "").toUpperCase();
-}
-
-/**
- * The check digit for the first eleven characters of an ISIN (prefix and national
- * number). For BUILDING one — a test fixture, a demo — rather than checking it.
- *
- * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.
- */
-export function isinCheckDigit(body: string): string {
-  const sum = luhnSum(expandLetters(formatIsin(body)), true);
-  return String((10 - (sum % 10)) % 10);
-}
-
-/**
- * Whether `value` is a valid ISIN: two letters, nine letters or digits, one digit,
- * and a matching Luhn check digit over the letter-expanded form. Spaces, hyphens and
- * lower case are fine (see {@link formatIsin}).
- *
- * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.
- */
-export function isValidIsin(value: string): boolean {
-  const isin = formatIsin(value);
-  if (!/^[A-Z]{2}[A-Z0-9]{9}\d$/.test(isin)) return false;
-  return luhnSum(expandLetters(isin), false) % 10 === 0;
-}

package/src/shell/role-switcher.tsx

@@ -1,53 +0,0 @@
-import { FlaskConical } from "lucide-react";
-import { OptionSwitcherMenu } from "./option-switcher-menu";
-import { DEFAULT_TOP_BAR_LABELS, useKitLabels } from "../i18n/kit-labels";
-
-/** @deprecated 0.52 — `DevMenuProps` (`roles`, `currentRole`, `onRole`) (MOD-5); removed in 0.53. */
-export interface RoleSwitcherProps<R extends string> {
-  roles: readonly R[];
-  value: R;
-  onChange: (role: R) => void;
-  /** Default: `topBar.switchRole` from the {@link UiKitProvider}, else English. */
-  "aria-label"?: string;
-  heading?: string;
-  /** The trigger's tooltip. Default: `topBar.role(value)`. */
-  title?: string;
-}
-
-/**
- * A reusable user-role switcher (feedback #337): a thin wrapper over
- * {@link OptionSwitcherMenu} with the standard flask icon, so an app drops it in
- * the top bar with just the role list + current value + a handler. Typically
- * dev-only / UI-only, but the app decides where and whether to render it.
- *
- * The flask wears `--warning` rather than a fixed `amber-500`: it is a caution
- * marker — the app is not showing you your own role — and the token carries that
- * amber across both themes instead of pinning one hue onto every palette.
- *
- * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,
- * MOD-5): the role switch every app draws is `DevMenu`'s Account section (0.51), and no
- * app renders this one.
- *
- * @deprecated 0.52 — `DevMenu` with `roles`, `currentRole` and `onRole` (MOD-5); removed in 0.53.
- */
-export function RoleSwitcher<R extends string>({
-  roles,
-  value,
-  onChange,
-  "aria-label": ariaLabel,
-  heading,
-  title,
-}: RoleSwitcherProps<R>) {
-  const labels = useKitLabels("topBar", DEFAULT_TOP_BAR_LABELS, { switchRole: ariaLabel });
-  return (
-    <OptionSwitcherMenu<R>
-      aria-label={labels.switchRole}
-      title={title ?? labels.role(value)}
-      heading={heading}
-      icon={<FlaskConical className="size-5 text-warning" />}
-      options={roles.map((r) => ({ value: r, label: r }))}
-      value={value}
-      onSelect={onChange}
-    />
-  );
-}