{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "shipments-demo",
  "title": "Shipments (demo block)",
  "description": "A working application composition: a Data Table with filters, selection and expanded detail, an inspector, bulk actions with undo.",
  "dependencies": [],
  "registryDependencies": [
    "@keyline-ui/keyline",
    "utils",
    "@keyline-ui/button",
    "@keyline-ui/menu",
    "@keyline-ui/toolbar",
    "@keyline-ui/field",
    "@keyline-ui/multiselect",
    "@keyline-ui/date-range",
    "@keyline-ui/table",
    "@keyline-ui/data-table",
    "@keyline-ui/data-table-model",
    "@keyline-ui/collection",
    "@keyline-ui/status",
    "@keyline-ui/kbd",
    "@keyline-ui/nav",
    "@keyline-ui/app-shell",
    "@keyline-ui/breadcrumb",
    "@keyline-ui/notice",
    "@keyline-ui/dialog",
    "@keyline-ui/inspector",
    "@keyline-ui/command",
    "@keyline-ui/toast",
    "@keyline-ui/selection"
  ],
  "files": [
    {
      "path": "src/registry/keyline/blocks/shipments/shipments.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\nimport { Button } from \"../../ui/button\";\nimport {\n  Menu,\n  MenuItem,\n  MenuCheckboxItem,\n  MenuRadioGroup,\n  MenuRadioItem,\n  MenuSeparator,\n  MenuGroup,\n  MenuGroupLabel,\n  MenuSubmenuRoot,\n  MenuSubmenuTrigger,\n  MenuPopup,\n} from \"../../ui/menu\";\nimport {\n  Toolbar,\n  ToolbarButton,\n  ToolbarToggle,\n  ToolbarToggleGroup,\n  ToolbarMenuTrigger,\n  ToolbarMenuContent,\n  ToolbarLink,\n} from \"../../ui/toolbar\";\nimport {\n  Field,\n  FieldLabel,\n  FieldFrame,\n  FieldControl,\n  FieldAffix,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldGroupPart,\n  FieldGroupJoin,\n  FieldGroupError,\n} from \"../../ui/field\";\nimport { Multiselect, type MultiselectOption } from \"../../ui/multiselect\";\nimport { DateRangePicker, formatRange, type DateRange } from \"../../ui/date-range\";\nimport {\n  TableFrame,\n  TableViews,\n  TableToolbar,\n  FilterToken,\n  TableScroll,\n  useRowMotion,\n  type SortDirection,\n} from \"../../ui/table\";\nimport {\n  useDataTable,\n  DataTable,\n  DataTableBulkBar,\n  DataTablePagination,\n  DataTableSearch,\n  type DataTableColumnDef,\n  type DataTableFilter,\n  type DataTableState,\n} from \"../../ui/data-table\";\nimport { matchesFilter, matchesSearch, nextSorting, selectionScope, toSortList } from \"../../lib/data-table\";\nimport { compareValues } from \"../../lib/collection\";\nimport { Status } from \"../../ui/status\";\nimport { Kbd } from \"../../ui/kbd\";\nimport { Nav, NavIdentity, type NavItem } from \"../../ui/nav\";\nimport { AppShell } from \"../../ui/app-shell\";\nimport { Breadcrumb } from \"../../ui/breadcrumb\";\nimport { Notice } from \"../../ui/notice\";\nimport { AlertDialog, AlertDialogContent } from \"../../ui/dialog\";\nimport {\n  Inspector,\n  InspectorHeader,\n  InspectorFacts,\n  InspectorBody,\n  InspectorSection,\n  InspectorRow,\n  InspectorActions,\n} from \"../../ui/inspector\";\nimport {\n  CommandDialog,\n  CommandInput,\n  CommandList,\n  CommandEmpty,\n  CommandGroup,\n  CommandItem,\n  CommandFooter,\n} from \"../../ui/command\";\nimport { ToastProvider, ToastDock, useToast } from \"../../ui/toast\";\nimport { patchWithUndo, removeWithUndo } from \"../../lib/selection\";\nimport {\n  CARRIERS,\n  LEGS,\n  STATUS,\n  TODAY,\n  fmtDay,\n  fmtEur,\n  fmtKg,\n  isUnavailable,\n  makeShipments,\n  searchCarriers,\n  type Shipment,\n  type StatusKey,\n} from \"./shipments-data\";\n\nconst PAGE = 12;\n/* Columns after the index, expand and ID cells. Each sorts; each but ID can be hidden from the View menu.\n   `first` is the direction a column starts in: the latest ETA, heaviest and costliest first would hide the\n   shipments that need action, so every column starts ascending except weight and value. */\ntype ColKey = \"dest\" | \"carrier\" | \"status\" | \"eta\" | \"kg\" | \"eur\";\ntype SortKey = \"id\" | ColKey;\nconst COLUMNS: { key: ColKey; label: string; unit?: string; align?: \"end\"; first?: SortDirection }[] = [\n  { key: \"dest\", label: \"Destination\" },\n  { key: \"carrier\", label: \"Carrier\" },\n  { key: \"status\", label: \"Status\" },\n  { key: \"eta\", label: \"ETA\", align: \"end\" },\n  { key: \"kg\", label: \"Weight\", unit: \"kg\", align: \"end\", first: \"descending\" },\n  { key: \"eur\", label: \"Value\", unit: \"€\", align: \"end\", first: \"descending\" },\n];\n/* status sorts by urgency, not by label: what needs action first */\nconst STATUS_RANK: Record<StatusKey, number> = { none: 0, delayed: 1, docs: 2, booked: 3, transit: 4, delivered: 5 };\nconst DENSITIES = [\n  { value: \"12\", label: \"12 rows\" },\n  { value: \"24\", label: \"24 rows\" },\n  { value: \"48\", label: \"48 rows\" },\n];\nconst VIEWS = [\n  { value: \"all\", label: \"All\", test: () => true },\n  { value: \"active\", label: \"Active\", test: (s: Shipment) => s.status !== \"delivered\" },\n  {\n    value: \"attention\",\n    label: \"Needs attention\",\n    test: (s: Shipment) => s.status === \"delayed\" || s.status === \"docs\" || s.status === \"none\",\n  },\n  { value: \"delivered\", label: \"Delivered\", test: (s: Shipment) => s.status === \"delivered\" },\n];\nconst FLAG_STATUS: StatusKey[] = [\"transit\", \"docs\", \"delayed\", \"booked\"];\nconst wait = (ms: number) => new Promise((r) => setTimeout(r, ms));\nconst addDays = (d: Date, n: number) => new Date(d.getFullYear(), d.getMonth(), d.getDate() + n);\nconst plural = (n: number, one: string, many = one + \"s\") => `${n.toLocaleString(\"en-GB\")} ${n === 1 ? one : many}`;\n\ntype Load = \"ready\" | \"loading\" | \"error\";\ntype Signal = \"idle\" | \"pending\" | \"done\" | \"failed\";\n\n/* --------------------------------------------------------------------------------------------- *\n * The table's columns. TanStack sorts, filters and pages; the cells are Keyline's.\n * --------------------------------------------------------------------------------------------- */\n/* the row being inspected, for the ID cell's pressed state; and the handler that opens a row */\nconst Inspecting = React.createContext<{ id: string | null; open: (id: string, opener: HTMLElement | null) => void }>({\n  id: null,\n  open: () => {},\n});\n\n/* KEY: the ID cell answers the press; the cobalt edge and the inspector follow on release */\nfunction OpenButton({ id }: { id: string }) {\n  const inspecting = React.useContext(Inspecting);\n  return (\n    <button\n      type=\"button\"\n      data-testid=\"shipment-open\"\n      className={cn(\n        \"flex h-(--kl-row) w-full cursor-pointer items-center border-0 bg-transparent px-(--kl-inset) py-0 text-start\",\n        \"font-(family-name:--kl-font-mono) text-[13px] text-inherit\",\n        \"hover:underline hover:decoration-[1.5px] hover:underline-offset-[3px] active:bg-kl-press\",\n        \"aria-pressed:shadow-[inset_3px_0_0_var(--kl-cobalt)] kl-rtl:aria-pressed:shadow-[inset_-3px_0_0_var(--kl-cobalt)]\",\n        \"focus-visible:outline-(length:--kl-ring) focus-visible:outline-offset-[-5px] focus-visible:outline-kl-focus focus-visible:outline-solid\",\n      )}\n      aria-pressed={inspecting.id === id}\n      onClick={(e) => (e.stopPropagation(), inspecting.open(id, e.currentTarget))}\n    >\n      {id}\n    </button>\n  );\n}\n\n/* compares as the block always has: numbers and dates by value, text with an en-GB collator (\"Box 9\" before\n   \"Box 10\"); TanStack reverses it for a descending level and breaks ties by the rows' order */\nconst byValue = (a: { getValue: (id: string) => unknown }, b: { getValue: (id: string) => unknown }, id: string) =>\n  compareValues(a.getValue(id), b.getValue(id), \"ascending\", \"en-GB\");\nconst unitHeader = (label: string, unit: string) => () => (\n  <>\n    {label} <span className=\"kl-code\">{unit}</span>\n  </>\n);\n\nconst COLUMN_DEFS: DataTableColumnDef<Shipment>[] = [\n  {\n    accessorKey: \"id\",\n    header: \"ID\",\n    enableHiding: false,\n    sortFn: byValue,\n    meta: { cellClassName: \"p-0\" },\n    cell: ({ row }) => <OpenButton id={row.original.id} />,\n  },\n  {\n    accessorKey: \"dest\",\n    header: \"Destination\",\n    sortFn: byValue,\n    meta: { cellClassName: \"max-w-[220px] overflow-hidden text-ellipsis\" },\n  },\n  { accessorKey: \"carrier\", header: \"Carrier\", sortFn: byValue, filterFn: \"keyline\" },\n  {\n    accessorKey: \"status\",\n    header: \"Status\",\n    enableGlobalFilter: false,\n    filterFn: \"keyline\",\n    sortFn: (a, b) => STATUS_RANK[a.getValue(\"status\") as StatusKey] - STATUS_RANK[b.getValue(\"status\") as StatusKey],\n    cell: ({ row }) => {\n      const st = STATUS[row.original.status];\n      return <Status kind={st.kind}>{st.label}</Status>;\n    },\n  },\n  {\n    accessorKey: \"eta\",\n    header: \"ETA\",\n    enableGlobalFilter: false,\n    filterFn: \"keyline\",\n    sortFn: byValue,\n    meta: { align: \"end\" },\n    cell: ({ row }) => {\n      const s = row.original;\n      return s.status !== \"delivered\" && s.eta < TODAY ? (\n        <span className=\"font-(--kl-weight-strong) text-kl-red-text\">{fmtDay(s.eta)}</span>\n      ) : (\n        fmtDay(s.eta)\n      );\n    },\n  },\n  {\n    id: \"kg\",\n    accessorFn: (s) => s.kg ?? undefined,\n    header: unitHeader(\"Weight\", \"kg\"),\n    enableGlobalFilter: false,\n    sortDescFirst: true,\n    sortUndefined: \"last\",\n    sortFn: byValue,\n    meta: { align: \"end\" },\n    cell: ({ row }) => fmtKg(row.original.kg),\n  },\n  {\n    // a value of 0 is not yet priced: it prints \"—\" and sorts last, as an empty value does\n    id: \"eur\",\n    accessorFn: (s) => s.eur || undefined,\n    header: unitHeader(\"Value\", \"€\"),\n    enableGlobalFilter: false,\n    sortDescFirst: true,\n    sortUndefined: \"last\",\n    sortFn: byValue,\n    meta: { align: \"end\" },\n    cell: ({ row }) => (row.original.eur ? fmtEur(row.original.eur) : \"—\"),\n  },\n  // never shown: the search also reads the PO reference, and the view tabs filter by status\n  { accessorKey: \"reference\", enableSorting: false },\n  {\n    id: \"view\",\n    accessorFn: (s) => s.status,\n    enableSorting: false,\n    enableGlobalFilter: false,\n    filterFn: (row, _id, view: string) => VIEWS.find((v) => v.value === view)?.test(row.original) ?? true,\n  },\n];\nconst HIDDEN = { reference: false, view: false };\n\n/* --------------------------------------------------------------------------------------------- *\n * A row's detail: its legs as cells on one keyline.\n * --------------------------------------------------------------------------------------------- */\nconst renderLegs = (row: { original: Shipment }) => (\n  <ol\n    className=\"m-0 grid list-none grid-cols-[repeat(4,minmax(150px,1fr))] p-0 [@media(max-width:640px)]:grid-cols-[1fr_1fr]\"\n    aria-label={`Legs for ${row.original.id}`}\n  >\n    {LEGS.map((l) => (\n      <li\n        key={l.at}\n        data-status={l.state}\n        className={cn(\n          \"grid gap-0.5 border-s-(length:--kl-k1) border-s-kl-line-soft px-3.5 pt-2.5 pb-3 text-[13px] first:border-s-0\",\n          \"data-[status=current]:shadow-[inset_0_3px_0_var(--kl-cobalt)] data-[status=next]:text-kl-ink-2\",\n          \"[@media(max-width:640px)]:nth-3:border-s-0\",\n          \"[@media(max-width:640px)]:nth-[n+3]:border-t-(length:--kl-k1) [@media(max-width:640px)]:nth-[n+3]:border-t-kl-line-soft\",\n        )}\n      >\n        <span className=\"kl-code\">{l.at}</span>\n        <b>{l.place}</b>\n        <span>{l.what}</span>\n      </li>\n    ))}\n  </ol>\n);\nconst legsLabel = (row: { original: Shipment }, expanded: boolean) =>\n  `${expanded ? \"Hide\" : \"Show\"} legs for ${row.original.id}`;\nconst selectLabel = (row: { original: Shipment }) => `Select ${row.original.id}`;\n\n/* --------------------------------------------------------------------------------------------- *\n * App navigation: location is cobalt and STRETCHES vertically between items.\n * --------------------------------------------------------------------------------------------- */\n/* 16px glyphs in the nav's key cells: one stroke weight, square caps, like the shell's toggle glyph */\nconst Glyph = ({ d }: { d: string }) => (\n  <svg\n    viewBox=\"0 0 16 16\"\n    width=\"16\"\n    height=\"16\"\n    fill=\"none\"\n    stroke=\"currentColor\"\n    strokeWidth=\"1.75\"\n    strokeLinecap=\"square\"\n    aria-hidden\n  >\n    <path d={d} />\n  </svg>\n);\nconst NAV: { label: string; items: NavItem[] }[] = [\n  {\n    label: \"Operations\",\n    items: [\n      // a parcel; a truck; a dock door; a sheet with lines\n      {\n        value: \"shipments\",\n        label: \"Shipments\",\n        count: 64,\n        icon: <Glyph d=\"M2.5 4.5 8 2l5.5 2.5v7L8 14l-5.5-2.5zM2.5 4.5 8 7l5.5-2.5M8 7v7\" />,\n      },\n      {\n        value: \"carriers\",\n        label: \"Carriers\",\n        count: 9,\n        icon: (\n          <Glyph d=\"M1.5 4h8v7h-8zM9.5 6.5h3l2 2.5v2h-5M4 13.5a1 1 0 1 0 0-2 1 1 0 0 0 0 2zM12 13.5a1 1 0 1 0 0-2 1 1 0 0 0 0 2z\" />\n        ),\n      },\n      { value: \"docks\", label: \"Dock schedule\", icon: <Glyph d=\"M2 14V5l6-3 6 3v9M4.5 14V8h7v6M4.5 10.5h7\" /> },\n    ],\n  },\n  {\n    label: \"Billing\",\n    items: [\n      {\n        value: \"invoices\",\n        label: \"Invoices\",\n        count: 3,\n        icon: <Glyph d=\"M3.5 1.5h6l3 3v10h-9zM9.5 1.5v3h3M6 8h4.5M6 10.5h4.5\" />,\n      },\n    ],\n  },\n];\n\n/* --------------------------------------------------------------------------------------------- *\n * Inspector with validation and a save signal.\n * --------------------------------------------------------------------------------------------- */\ntype Draft = { reference: string; kg: string; l: string; w: string; h: string };\nfunction validate(d: Draft) {\n  const e: Partial<Record<keyof Draft, string>> = {};\n  if (!d.reference.trim()) e.reference = \"Enter the customer's PO reference.\";\n  else if (!/^PO-\\d{5}-[A-Z]{3}$/.test(d.reference.trim()))\n    e.reference = \"Use the format PO-88201-LYO (5 digits, 3 letters).\";\n  const kg = Number(d.kg.replace(/,/g, \"\"));\n  if (d.kg.trim() === \"\" || !Number.isFinite(kg) || kg <= 0) e.kg = \"Enter a weight above 0 kg.\";\n  else if (kg > 24000) e.kg = \"Over 24,000 kg needs two trucks. Split the shipment first.\";\n  for (const k of [\"l\", \"w\", \"h\"] as const) {\n    const v = Number(d[k]);\n    if (!Number.isFinite(v) || v <= 0) e[k] = \"Each side must be above 0 cm.\";\n    else if (k === \"h\" && v > 270) e.h = \"Height over 270 cm doesn't fit a standard trailer.\";\n  }\n  return e;\n}\n\nfunction ShipmentInspector({\n  s,\n  code,\n  state,\n  onClose,\n  onSave,\n  onRestore,\n  onShow,\n}: {\n  s: Shipment;\n  code: string;\n  state: \"live\" | \"hidden\" | \"cancelled\";\n  onClose: () => void;\n  onSave: (patch: Partial<Shipment>) => Promise<void>;\n  onRestore: () => void;\n  onShow: () => void;\n}) {\n  const initial = React.useCallback(\n    (): Draft => ({\n      reference: s.reference,\n      kg: s.kg == null ? \"\" : String(s.kg),\n      l: \"120\",\n      w: \"80\",\n      h: s.pallets > 10 ? \"240\" : \"160\",\n    }),\n    [s],\n  );\n  const [draft, setDraft] = React.useState<Draft>(initial);\n  const [touched, setTouched] = React.useState<Partial<Record<keyof Draft, boolean>>>({});\n  const [submitted, setSubmitted] = React.useState(false);\n  const [signal, setSignal] = React.useState<Signal>(\"idle\");\n  const formRef = React.useRef<HTMLFormElement>(null);\n  React.useEffect(() => {\n    setDraft(initial());\n    setTouched({});\n    setSubmitted(false);\n    setSignal(\"idle\");\n  }, [s.id]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const errors = validate(draft);\n  const show = (k: keyof Draft) => (submitted || touched[k]) && errors[k];\n  const dirty = JSON.stringify(draft) !== JSON.stringify(initial());\n  const set = (k: keyof Draft) => (e: React.ChangeEvent<HTMLInputElement>) => {\n    setDraft((d) => ({ ...d, [k]: e.target.value }));\n    if (signal !== \"pending\") setSignal(\"idle\");\n  };\n  const blur = (k: keyof Draft) => () => setTouched((t) => ({ ...t, [k]: true }));\n  const st = STATUS[s.status];\n  const dimErr = show(\"l\") || show(\"w\") || show(\"h\");\n\n  const save = async (e: React.FormEvent) => {\n    e.preventDefault();\n    setSubmitted(true);\n    if (Object.keys(errors).length) {\n      setSignal(\"failed\");\n      const first = ([\"reference\", \"kg\", \"l\", \"w\", \"h\"] as const).find((k) => errors[k]);\n      formRef.current?.querySelector<HTMLInputElement>(`[data-insp-field=\"${first}\"]`)?.focus();\n      return;\n    }\n    setSignal(\"pending\");\n    await onSave({ reference: draft.reference.trim(), kg: Number(draft.kg.replace(/,/g, \"\")) });\n    setSignal(\"done\");\n    setTimeout(() => setSignal((x) => (x === \"done\" ? \"idle\" : x)), 900);\n  };\n\n  return (\n    <Inspector aria-label={`Shipment ${s.id}`} className=\"bg-kl-cell\">\n      <InspectorHeader\n        code={code}\n        title={s.id}\n        status={\n          <Status kind={state === \"cancelled\" ? \"attention\" : st.kind}>\n            {state === \"cancelled\" ? \"Cancelled\" : st.label}\n          </Status>\n        }\n        onClose={onClose}\n      />\n      <Notice\n        layout=\"cell\"\n        open={state !== \"live\"}\n        tone={state === \"cancelled\" ? \"attention\" : \"neutral\"}\n        live\n        title={state === \"cancelled\" ? \"This shipment was cancelled.\" : \"Hidden by the current filters.\"}\n        description={state === \"cancelled\" ? \"Edits are off until it's restored.\" : \"You can still edit it.\"}\n        actions={\n          <Button layout=\"cell\" onClick={state === \"cancelled\" ? onRestore : onShow}>\n            {state === \"cancelled\" ? \"Restore\" : \"Show in table\"}\n          </Button>\n        }\n      />\n      <InspectorFacts\n        items={[\n          { label: \"Destination\", value: s.dest },\n          { label: \"Carrier\", value: s.carrier },\n          { label: \"ETA\", value: fmtDay(s.eta) },\n          { label: \"Value €\", value: s.eur ? fmtEur(s.eur) : \"—\" },\n        ]}\n      />\n      <form ref={formRef} className=\"flex min-h-0 flex-[1_1_auto] flex-col\" onSubmit={save} noValidate>\n        <fieldset\n          disabled={state === \"cancelled\" || signal === \"pending\"}\n          className=\"m-0 flex min-h-0 min-w-0 flex-[1_1_auto] flex-col border-0 p-0\"\n        >\n          <InspectorBody>\n            <InspectorSection>\n              <Field invalid={!!show(\"reference\")} disabled={state === \"cancelled\"}>\n                <FieldLabel>Customer reference</FieldLabel>\n                <FieldFrame>\n                  <FieldControl\n                    data-insp-field=\"reference\"\n                    value={draft.reference}\n                    onChange={set(\"reference\")}\n                    onBlur={blur(\"reference\")}\n                    autoComplete=\"off\"\n                    spellCheck={false}\n                    className=\"font-(family-name:--kl-font-mono)\"\n                  />\n                </FieldFrame>\n                {show(\"reference\") ? (\n                  <FieldError match>{errors.reference}</FieldError>\n                ) : (\n                  <FieldDescription>Printed on the delivery note.</FieldDescription>\n                )}\n              </Field>\n            </InspectorSection>\n            <InspectorSection>\n              <Field invalid={!!show(\"kg\")} disabled={state === \"cancelled\"}>\n                <FieldLabel>Gross weight</FieldLabel>\n                <FieldFrame>\n                  <FieldControl\n                    data-insp-field=\"kg\"\n                    inputMode=\"decimal\"\n                    align=\"end\"\n                    value={draft.kg}\n                    onChange={set(\"kg\")}\n                    onBlur={blur(\"kg\")}\n                  />\n                  <FieldAffix className=\"kl-code\">kg</FieldAffix>\n                </FieldFrame>\n                {show(\"kg\") ? (\n                  <FieldError match>{errors.kg}</FieldError>\n                ) : (\n                  <FieldDescription>{plural(s.pallets, \"pallet\")} · max 24,000 kg per truck.</FieldDescription>\n                )}\n              </Field>\n            </InspectorSection>\n            <InspectorSection>\n              <FieldGroup\n                legend={\n                  <>\n                    Pallet size <span className=\"kl-code\">cm</span>\n                  </>\n                }\n                invalid={!!dimErr}\n              >\n                <FieldGroupPart\n                  label=\"L\"\n                  invalid={!!show(\"l\")}\n                  inputProps={{\n                    value: draft.l,\n                    onChange: set(\"l\"),\n                    onBlur: blur(\"l\"),\n                    inputMode: \"numeric\",\n                    ...({ \"data-insp-field\": \"l\" } as object),\n                  }}\n                />\n                <FieldGroupJoin />\n                <FieldGroupPart\n                  label=\"W\"\n                  invalid={!!show(\"w\")}\n                  inputProps={{\n                    value: draft.w,\n                    onChange: set(\"w\"),\n                    onBlur: blur(\"w\"),\n                    inputMode: \"numeric\",\n                    ...({ \"data-insp-field\": \"w\" } as object),\n                  }}\n                />\n                <FieldGroupJoin />\n                <FieldGroupPart\n                  label=\"H\"\n                  invalid={!!show(\"h\")}\n                  inputProps={{\n                    value: draft.h,\n                    onChange: set(\"h\"),\n                    onBlur: blur(\"h\"),\n                    inputMode: \"numeric\",\n                    ...({ \"data-insp-field\": \"h\" } as object),\n                  }}\n                />\n              </FieldGroup>\n              <FieldGroupError>{dimErr || null}</FieldGroupError>\n            </InspectorSection>\n            <InspectorRow>\n              <InspectorSection>\n                <span className=\"kl-code\">Pallets</span>\n                <div className=\"text-[26px]/[1.1] font-(--kl-weight-strong) tabular-nums\">{s.pallets}</div>\n              </InspectorSection>\n              <InspectorSection>\n                <span className=\"kl-code\">Legs</span>\n                <div className=\"text-[26px]/[1.1] font-(--kl-weight-strong) tabular-nums\">{LEGS.length}</div>\n              </InspectorSection>\n            </InspectorRow>\n          </InspectorBody>\n        </fieldset>\n        <InspectorActions>\n          <Button\n            layout=\"cell\"\n            disabled={!dirty || signal === \"pending\"}\n            onClick={() => (setDraft(initial()), setTouched({}), setSubmitted(false), setSignal(\"idle\"))}\n          >\n            Discard\n          </Button>\n          <Button\n            type=\"submit\"\n            layout=\"cell\"\n            variant=\"primary\"\n            signal={signal}\n            disabled={state === \"cancelled\" || (!dirty && signal !== \"done\")}\n          >\n            {signal === \"pending\" ? \"Saving…\" : signal === \"done\" ? \"Saved\" : \"Save changes\"}\n          </Button>\n        </InspectorActions>\n      </form>\n    </Inspector>\n  );\n}\n\n/* --------------------------------------------------------------------------------------------- *\n * The application.\n * --------------------------------------------------------------------------------------------- */\nexport type ShipmentsProps = {\n  initialLoad?: Load;\n  portalContainer?: React.RefObject<HTMLElement | null>;\n  className?: string;\n};\n\nfunction ShipmentsApp({ initialLoad = \"ready\", portalContainer, className }: ShipmentsProps) {\n  const notify = useToast();\n  const [rows, setRows] = React.useState<Shipment[]>(() => makeShipments(64));\n  const [load, setLoad] = React.useState<Load>(initialLoad);\n  const failNext = React.useRef(false);\n  const [nav, setNav] = React.useState(\"shipments\");\n  const [inspect, setInspect] = React.useState<string | null>(null);\n  // the row's open button: the aside's sheet returns focus to it on close\n  const opener = React.useRef<HTMLElement | null>(null);\n  const [cancelled, setCancelled] = React.useState<Map<string, { row: Shipment; index: number }>>(new Map());\n  // the selection is the block's: the bulk bar, the command menu and the cancel alert all read it\n  const [rowSelection, setRowSelection] = React.useState<DataTableState[\"rowSelection\"]>({});\n  const [assignSig, setAssignSig] = React.useState<Signal>(\"idle\");\n  const [confirm, setConfirm] = React.useState(false);\n  const [cmd, setCmd] = React.useState(false);\n  const [cmdQ, setCmdQ] = React.useState(\"\");\n  // When a menu or command opens the confirmation, the closing surface must not pull focus back to its trigger.\n  const handoff = React.useRef(false);\n  const keepFocus = () => {\n    const go = !handoff.current;\n    handoff.current = false;\n    return go;\n  };\n  const askCancel = () => {\n    handoff.current = true;\n    setConfirm(true);\n  };\n  const container = portalContainer;\n  // cancelled rows close up where they were, and Undo opens them back in the same place\n  const rowMotion = useRowMotion();\n\n  /* ---- the table: TanStack holds the sort, the filters, the page, the open details and the column choice ---- */\n  const table = useDataTable({\n    data: rows,\n    columns: COLUMN_DEFS,\n    getRowId: (s) => s.id,\n    state: { rowSelection },\n    onStateChange: (next, { slice }) => {\n      if (slice === \"rowSelection\") setRowSelection(next.rowSelection);\n      // a new sort or filter starts on the first page; editing rows (assign, cancel, Undo) keeps the page\n      else if (slice === \"sorting\" || slice === \"columnFilters\" || slice === \"globalFilter\") table.setPageIndex(0);\n    },\n    defaultState: { pagination: { pageIndex: 0, pageSize: PAGE }, columnVisibility: HIDDEN },\n    autoResetPageIndex: false,\n    autoResetExpanded: false,\n  });\n  const { columnFilters, globalFilter, sorting, pagination } = table.state as DataTableState;\n  const pageSize = pagination.pageSize;\n\n  /* ---- filtering: every control affects results ---- */\n  const filterOf = (id: string) => columnFilters.find((f) => f.id === id)?.value;\n  const setFilter = (id: string, value: unknown) => table.getColumn(id)?.setFilterValue(value);\n  const q = globalFilter ?? \"\";\n  const carrierFilter = filterOf(\"carrier\") as Extract<DataTableFilter, { kind: \"set\" }> | undefined;\n  const statusFilter = filterOf(\"status\") as Extract<DataTableFilter, { kind: \"set\" }> | undefined;\n  const etaFilter = filterOf(\"eta\") as Extract<DataTableFilter, { kind: \"range\" }> | undefined;\n  const view = (filterOf(\"view\") as string | undefined) ?? \"all\";\n  const flags = (statusFilter?.values ?? []) as string[];\n  const eta = (etaFilter ?? null) as DateRange | null;\n  const carriers = React.useMemo(\n    () => (carrierFilter?.values ?? []).map((v) => CARRIERS.find((c) => c.value === v) ?? { value: v, label: v }),\n    [carrierFilter],\n  );\n  const setView = (v: string) => setFilter(\"view\", v === \"all\" ? undefined : v);\n  const setFlags = (values: string[]) => setFilter(\"status\", { kind: \"set\", values });\n  const setCarriers = (o: MultiselectOption[]) => setFilter(\"carrier\", { kind: \"set\", values: o.map((c) => c.value) });\n  const setEta = (r: DateRange | null) => setFilter(\"eta\", r ? { kind: \"range\", from: r.from, to: r.to } : undefined);\n  const clearFilters = () => {\n    table.setColumnFilters([]);\n    table.setGlobalFilter(\"\");\n  };\n  // the counts on the view tabs and status toggles: the rows each would show, under the other filters\n  const base = React.useMemo(\n    () =>\n      rows.filter(\n        (s) =>\n          matchesSearch([s.id, s.dest, s.carrier, s.reference], q) &&\n          matchesFilter(s.carrier, carrierFilter) &&\n          matchesFilter(s.eta, etaFilter),\n      ),\n    [rows, q, carrierFilter, etaFilter],\n  );\n  const viewTest = VIEWS.find((v) => v.value === view)!.test;\n  const afterView = base.filter(viewTest);\n  // the rows that pass every filter, sorted, before paging\n  const filtered = table.getPrePaginatedRowModel().rows;\n  const pageRows = table.getRowModel().rows;\n  // a removal can leave the page past the end: go back to the last page that has rows\n  const pageCount = table.getPageCount();\n  React.useLayoutEffect(() => {\n    if (pagination.pageIndex > 0 && pagination.pageIndex >= pageCount) table.setPageIndex(Math.max(0, pageCount - 1));\n  }, [pagination.pageIndex, pageCount, table]);\n  const sort = toSortList(sorting) as { key: SortKey; direction: SortDirection }[];\n  const setSort = (key: SortKey) =>\n    table.setSorting((x) => nextSorting(x, key, { first: colFirst(key), additive: true }));\n  const colLabel = (key: SortKey) => (key === \"id\" ? \"ID\" : COLUMNS.find((c) => c.key === key)!.label);\n  const colFirst = (key: SortKey) => (key === \"id\" ? undefined : COLUMNS.find((c) => c.key === key)!.first);\n  const sortable: SortKey[] = [\"id\", ...COLUMNS.map((c) => c.key)];\n  const shown = COLUMNS.filter((c) => table.getColumn(c.key)?.getIsVisible());\n\n  /* ---- selection scope (ids survive filtering and paging; the scope says what is hidden) ---- */\n  const selected = React.useMemo(\n    () => new Set(Object.keys(rowSelection).filter((id) => rowSelection[id])),\n    [rowSelection],\n  );\n  const filteredIds = React.useMemo(() => new Set(filtered.map((r) => r.id)), [filtered]);\n  const { count: nSel, hidden } = selectionScope(rowSelection, [...filteredIds]);\n  const allMatching = filtered.length > 0 && nSel - hidden === filtered.length;\n  const headerChecked = table.getIsAllPageRowsSelected();\n  const selectAllMatching = () =>\n    table.setRowSelection((s) => ({ ...s, ...Object.fromEntries(filtered.map((r) => [r.id, true])) }));\n  const keepVisibleOnly = () =>\n    table.setRowSelection((s) => Object.fromEntries(Object.entries(s).filter(([id, on]) => on && filteredIds.has(id))));\n  const clearSel = () => table.setRowSelection({});\n\n  // recovery: a failed bulk signal clears as soon as the working set changes\n  React.useEffect(() => setAssignSig((x) => (x === \"failed\" ? \"idle\" : x)), [rowSelection]);\n\n  /* ---- data load (loading / error / retry) ---- */\n  const reload = React.useCallback(async () => {\n    setLoad(\"loading\");\n    await wait(900);\n    if (failNext.current) {\n      failNext.current = false;\n      setLoad(\"error\");\n    } else setLoad(\"ready\");\n  }, []);\n  React.useEffect(() => {\n    if (initialLoad === \"loading\") void reload();\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  /* ---- bulk: assign carrier (pending → done/failed; Undo restores previous carriers exactly) ---- */\n  const assign = async (carrier: string) => {\n    const ids = [...selected];\n    if (!ids.length) return;\n    setAssignSig(\"pending\");\n    await wait(700);\n    if (carrier === \"Rhenus Road\" && ids.length > 5) {\n      setAssignSig(\"failed\");\n      notify({\n        title: `Rhenus Road can take 5 shipments this week; ${ids.length} selected. Nothing was changed.`,\n        type: \"failed\",\n        timeout: 0,\n      });\n      return;\n    }\n    const { next, undo, count } = patchWithUndo(rows, selected, (s) => ({ ...s, carrier }));\n    setRows(next);\n    setAssignSig(\"done\");\n    setTimeout(() => setAssignSig((x) => (x === \"done\" ? \"idle\" : x)), 900);\n    notify({\n      title: `${carrier} assigned to ${plural(count, \"shipment\")}.`,\n      action: {\n        label: \"Undo\",\n        onClick: () => {\n          setRows(undo);\n          notify({\n            title: `Restored the previous carrier on ${plural(count, \"shipment\")}.`,\n            type: \"info\",\n            timeout: 3000,\n          });\n        },\n      },\n    });\n  };\n\n  /* ---- bulk: reschedule ---- */\n  const reschedule = (days: number) => {\n    if (!selected.size) return;\n    const { next, undo, count } = patchWithUndo(rows, selected, (s) => ({ ...s, eta: addDays(s.eta, days) }));\n    setRows(next);\n    notify({\n      title: `Moved ${plural(count, \"ETA\")} ${days < 0 ? \"earlier\" : \"later\"} by ${plural(Math.abs(days), \"day\")}.`,\n      action: { label: \"Undo\", onClick: () => setRows(undo) },\n    });\n  };\n\n  /* ---- bulk: cancel (confirm → remove → Undo reinserts at the original positions) ---- */\n  const cancelSelected = () => {\n    const { next, removed: list } = removeWithUndo(rows, selected);\n    const removed = new Map(list.map((r) => [r.row.id, r]));\n    rowMotion.arm();\n    setRows(next);\n    setCancelled((c) => new Map([...c, ...removed]));\n    clearSel();\n    notify({\n      title: `Cancelled ${plural(removed.size, \"shipment\")}.`,\n      timeout: 8000,\n      action: { label: \"Undo\", onClick: () => restore([...removed.keys()]) },\n    });\n  };\n  const restore = (ids: string[]) => {\n    rowMotion.arm();\n    setCancelled((c) => {\n      const back = ids.map((id) => c.get(id)).filter(Boolean) as { row: Shipment; index: number }[];\n      setRows((rs) => {\n        const out = rs.filter((s) => !ids.includes(s.id));\n        back\n          .sort((a, b) => a.index - b.index)\n          .forEach(({ row, index }) => out.splice(Math.min(index, out.length), 0, row));\n        return out;\n      });\n      const n = new Map(c);\n      ids.forEach((id) => n.delete(id));\n      return n;\n    });\n  };\n\n  /* ---- inspector ---- */\n  const inspected = inspect ? (rows.find((s) => s.id === inspect) ?? cancelled.get(inspect)?.row) : undefined;\n  const inspState: \"live\" | \"hidden\" | \"cancelled\" = !inspect\n    ? \"live\"\n    : cancelled.has(inspect)\n      ? \"cancelled\"\n      : filteredIds.has(inspect)\n        ? \"live\"\n        : \"hidden\";\n  const inspIndex = inspected ? filtered.findIndex((r) => r.id === inspected.id) : -1;\n  const inspCode = inspIndex >= 0 ? `R${inspIndex + 1}/${filtered.length}` : \"R—\";\n  const saveInspector = async (patch: Partial<Shipment>) => {\n    await wait(650);\n    setRows((rs) => rs.map((s) => (s.id === inspect ? { ...s, ...patch } : s)));\n  };\n  // clear the filters, then page to the shipment where the sort puts it\n  const showInTable = () => {\n    const id = inspect;\n    clearFilters();\n    setTimeout(() => {\n      const i = table.getPrePaginatedRowModel().rows.findIndex((r) => r.id === id);\n      if (i >= 0) table.setPageIndex(Math.floor(i / table.atoms.pagination.get().pageSize));\n    }, 0);\n  };\n  const openRow = React.useCallback((id: string, el: HTMLElement | null) => {\n    opener.current = el;\n    setInspect(id);\n  }, []);\n  const inspecting = React.useMemo(() => ({ id: inspect, open: openRow }), [inspect, openRow]);\n  // a press anywhere on the row inspects it, as its ID does\n  const rowProps = React.useCallback(\n    (row: { id: string }) => ({\n      onClick: (e: React.MouseEvent<HTMLTableRowElement>) =>\n        openRow(row.id, e.currentTarget.querySelector<HTMLElement>(\"[data-testid=shipment-open]\")),\n    }),\n    [openRow],\n  );\n\n  /* ---- ⌘K ---- */\n  React.useEffect(() => {\n    const onKey = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === \"k\") {\n        e.preventDefault();\n        setCmd((o) => !o);\n      }\n    };\n    window.addEventListener(\"keydown\", onKey);\n    return () => window.removeEventListener(\"keydown\", onKey);\n  }, []);\n  const run = (fn: () => void) => () => {\n    setCmd(false);\n    setCmdQ(\"\");\n    fn();\n  };\n\n  const activeFilters =\n    (q ? 1 : 0) + (carriers.length ? 1 : 0) + (flags.length ? 1 : 0) + (eta ? 1 : 0) + (view !== \"all\" ? 1 : 0);\n  const viewCounts = VIEWS.map((v) => ({\n    value: v.value,\n    label: v.label,\n    count: load === \"ready\" ? base.filter(v.test).length : \"–\",\n  }));\n  const alerts = rows.filter((s) => s.status === \"delayed\" || s.status === \"docs\");\n  const flagCount = (k: StatusKey) => afterView.filter((s) => s.status === k).length;\n\n  return (\n    <AppShell\n      className={className}\n      data-inspector={inspected ? \"\" : undefined}\n      narrowAt={760}\n      collapse=\"rail\"\n      asideInlineAt={1180}\n      navSize=\"13rem\"\n      asideSize=\"22.5rem\"\n      container={container}\n      navLabel=\"Navigation\"\n      nav={\n        <Nav\n          label=\"Main\"\n          layout=\"cell\"\n          header={\n            <NavIdentity\n              mark={<span className=\"block size-3.5 bg-current\" />}\n              title=\"Freightdesk\"\n              meta=\"RTM · Rotterdam\"\n            />\n          }\n          footer={<NavIdentity mark=\"MJ\" title=\"Mila Jansen\" meta=\"Dispatch\" />}\n          value={nav}\n          onValueChange={setNav}\n          groups={NAV.map((g) => ({\n            ...g,\n            items: g.items.map((n) => ({\n              ...n,\n              href: `#${n.value}`,\n              count: n.value === \"shipments\" ? rows.length : n.count,\n            })),\n          }))}\n        />\n      }\n      header={\n        <Breadcrumb\n          layout=\"cell\"\n          items={[\n            { label: \"Freightdesk\", href: \"#shipments\" },\n            { label: \"Shipments\", href: \"#shipments\" },\n            { label: inspected ? inspected.id : VIEWS.find((v) => v.value === view)!.label },\n          ]}\n        />\n      }\n      actions={\n        // the page's own commands: one Tab stop beside the crumbs; when the header narrows they move into\n        // More (the crumbs fold first, down to their minimum)\n        <Toolbar layout=\"cell\" overflow=\"menu\" aria-label=\"Page actions\">\n          <Menu>\n            <ToolbarMenuTrigger affix={<span className=\"kl-code\">{alerts.length}</span>}>Alerts</ToolbarMenuTrigger>\n            <ToolbarMenuContent container={container} align=\"end\">\n              <MenuGroup>\n                <MenuGroupLabel>\n                  {alerts.length ? `${plural(alerts.length, \"shipment\")} need attention` : \"Nothing needs attention\"}\n                </MenuGroupLabel>\n                {alerts.slice(0, 6).map((s) => (\n                  <MenuItem\n                    key={s.id}\n                    code={s.id}\n                    onClick={(e) => {\n                      // the sheet returns focus to whichever trigger opened this menu (Alerts, or More)\n                      opener.current = e.currentTarget.ownerDocument.querySelector<HTMLElement>(\n                        '[data-slot=\"app-shell-actions\"] [aria-expanded=\"true\"]',\n                      );\n                      setInspect(s.id);\n                    }}\n                  >\n                    {s.dest} · {STATUS[s.status].label}\n                  </MenuItem>\n                ))}\n              </MenuGroup>\n            </ToolbarMenuContent>\n          </Menu>\n          <ToolbarButton\n            onClick={() =>\n              notify({\n                title: `Export of ${plural(afterView.length, \"shipment\")} started. The file arrives by email.`,\n                type: \"info\",\n                timeout: 4000,\n              })\n            }\n          >\n            Export\n          </ToolbarButton>\n          <ToolbarLink href=\"#help\">Help</ToolbarLink>\n        </Toolbar>\n      }\n      asideLabel={inspected ? `Shipment ${inspected.id}` : \"Shipment\"}\n      asideOpen={!!inspected}\n      onAsideOpenChange={(o) => !o && setInspect(null)}\n      asideFinalFocus={opener}\n      aside={\n        inspected ? (\n          <ShipmentInspector\n            s={inspected}\n            code={inspCode}\n            state={inspState}\n            onClose={() => setInspect(null)}\n            onSave={saveInspector}\n            onRestore={() => restore([inspected.id])}\n            onShow={showInTable}\n          />\n        ) : null\n      }\n    >\n      <TableFrame\n        aria-label=\"Shipments\"\n        data-testid=\"shipments-table\"\n        // the frame fills the viewport under the shell header; the grid scrolls inside it\n        className=\"max-h-[calc(100dvh_-_3_*_var(--kl-gutter)_-_var(--kl-ctl)_-_2_*_var(--kl-k3))] min-h-[360px] bg-kl-cell\"\n        aria-busy={load === \"loading\" || undefined}\n      >\n        <TableViews views={viewCounts} value={view} onValueChange={setView} label=\"Shipment views\">\n          <Toolbar layout=\"cell\" overflow=\"menu\" aria-label=\"Table\">\n            <Menu>\n              <ToolbarMenuTrigger\n                affix={\n                  <span className=\"kl-code\">\n                    {shown.length + 1}/{COLUMNS.length + 1}\n                  </span>\n                }\n              >\n                View\n              </ToolbarMenuTrigger>\n              <ToolbarMenuContent container={container} align=\"end\">\n                <MenuGroup>\n                  <MenuGroupLabel>Columns</MenuGroupLabel>\n                  <MenuCheckboxItem checked disabled description=\"Always shown\">\n                    ID\n                  </MenuCheckboxItem>\n                  {COLUMNS.map((c) => (\n                    <MenuCheckboxItem\n                      key={c.key}\n                      checked={shown.includes(c)}\n                      onCheckedChange={(on) => table.getColumn(c.key)?.toggleVisibility(on)}\n                    >\n                      {c.label}\n                    </MenuCheckboxItem>\n                  ))}\n                </MenuGroup>\n                <MenuSeparator />\n                <MenuGroup>\n                  <MenuGroupLabel>Rows per page</MenuGroupLabel>\n                  <MenuRadioGroup\n                    value={String(pageSize)}\n                    onValueChange={(v) => table.setPagination({ pageIndex: 0, pageSize: Number(v) })}\n                  >\n                    {DENSITIES.map((d) => (\n                      <MenuRadioItem key={d.value} value={d.value}>\n                        {d.label}\n                      </MenuRadioItem>\n                    ))}\n                  </MenuRadioGroup>\n                </MenuGroup>\n                <MenuSeparator />\n                {/* the sort, levels in order: the keyboard route to multi-column sort (headers take Shift + press) */}\n                <MenuGroup>\n                  <MenuGroupLabel>\n                    {sort.length ? `Sorted by ${sort.length === 1 ? \"1 column\" : `${sort.length} columns`}` : \"Sort\"}\n                  </MenuGroupLabel>\n                  {sort.map((lv, i) => (\n                    <MenuItem\n                      key={lv.key}\n                      code={i + 1}\n                      closeOnClick={false}\n                      description={`${lv.direction === \"ascending\" ? \"Ascending\" : \"Descending\"} · press to reverse`}\n                      onClick={() =>\n                        table.setSorting((x) => x.map((y) => (y.id === lv.key ? { ...y, desc: !y.desc } : y)))\n                      }\n                    >\n                      {colLabel(lv.key)}\n                    </MenuItem>\n                  ))}\n                  {sort.length < sortable.length ? (\n                    <MenuSubmenuRoot>\n                      <MenuSubmenuTrigger>{sort.length ? \"Then by\" : \"Sort by\"}</MenuSubmenuTrigger>\n                      <MenuPopup container={container}>\n                        {sortable\n                          .filter((k) => !sort.some((lv) => lv.key === k))\n                          .map((k) => (\n                            <MenuItem key={k} onClick={() => setSort(k)}>\n                              {colLabel(k)}\n                            </MenuItem>\n                          ))}\n                      </MenuPopup>\n                    </MenuSubmenuRoot>\n                  ) : null}\n                  {sort.length ? (\n                    <MenuItem\n                      onClick={() => table.setSorting([])}\n                      description={`Now by ${sort.map((lv) => `${colLabel(lv.key)} ${lv.direction}`).join(\", then \")}`}\n                    >\n                      Clear sort\n                    </MenuItem>\n                  ) : null}\n                </MenuGroup>\n              </ToolbarMenuContent>\n            </Menu>\n            <ToolbarButton\n              onClick={() => setCmd(true)}\n              aria-keyshortcuts=\"Meta+K\"\n              affix={<span className=\"kl-code\">⌘K</span>}\n            >\n              Commands\n            </ToolbarButton>\n          </Toolbar>\n        </TableViews>\n\n        <TableToolbar aria-label=\"Filters\">\n          <DataTableSearch table={table} label=\"Search shipments\" placeholder=\"Search ID, city, carrier or PO\" />\n          <Multiselect\n            layout=\"cell\"\n            label=\"Carrier\"\n            noun={[\"carrier\", \"carriers\"]}\n            placeholder=\"Carrier\"\n            value={carriers}\n            onValueChange={setCarriers}\n            loadOptions={searchCarriers}\n            container={container}\n          />\n          <DateRangePicker\n            layout=\"cell\"\n            label=\"ETA\"\n            value={eta}\n            onValueChange={setEta}\n            today={TODAY}\n            defaultMonth={TODAY}\n            isDateUnavailable={isUnavailable}\n            container={container}\n            presets={[\n              { label: \"Next 7 days\", range: () => ({ from: TODAY, to: addDays(TODAY, 6) }) },\n              { label: \"Next 14 days\", range: () => ({ from: TODAY, to: addDays(TODAY, 13) }) },\n              { label: \"This month\", range: () => ({ from: new Date(2026, 10, 1), to: new Date(2026, 10, 30) }) },\n            ]}\n            caption={(r) => (r ? `ETA ${formatRange(r)} · depot closed 17 and 22 Nov` : \"Any ETA\")}\n          />\n        </TableToolbar>\n\n        <Toolbar\n          layout=\"cell\"\n          overflow=\"menu\"\n          overflowLabel=\"More filters\"\n          overflowTrigger=\"label\"\n          aria-label=\"Status filters\"\n          className=\"min-h-(--kl-row)\"\n        >\n          <ToolbarToggleGroup value={flags} onValueChange={setFlags} aria-label=\"Status\">\n            {FLAG_STATUS.map((k) => (\n              <ToolbarToggle key={k} value={k} affix={load === \"ready\" ? flagCount(k) : undefined}>\n                {STATUS[k].label}\n              </ToolbarToggle>\n            ))}\n          </ToolbarToggleGroup>\n          {carriers.length ? (\n            <FilterToken\n              field=\"Carrier\"\n              op=\"is\"\n              value={carriers.length === 1 && carriers[0] ? carriers[0].label : `${carriers.length} carriers`}\n              onRemove={() => setCarriers([])}\n            />\n          ) : null}\n          {eta ? <FilterToken field=\"ETA\" op=\"in\" value={formatRange(eta)} onRemove={() => setEta(null)} /> : null}\n          {q ? <FilterToken field=\"Text\" op=\"has\" value={q} onRemove={() => table.setGlobalFilter(\"\")} /> : null}\n          {activeFilters ? (\n            <ToolbarButton onClick={clearFilters}>\n              Clear {activeFilters > 1 ? `all ${activeFilters}` : \"filter\"}\n            </ToolbarButton>\n          ) : null}\n        </Toolbar>\n\n        <DataTableBulkBar\n          table={table}\n          scope={\n            nSel === 0 ? (\n              <span className=\"text-kl-ink-2\">Select rows to assign, reschedule or cancel them.</span>\n            ) : (\n              <>\n                <span>\n                  {allMatching && filtered.length > pageRows.length\n                    ? `All ${filtered.length} matching selected.`\n                    : `${plural(nSel, \"shipment\")} selected.`}\n                  {hidden ? ` ${hidden} not in these results.` : \"\"}\n                </span>\n                {hidden ? (\n                  <button type=\"button\" onClick={keepVisibleOnly}>\n                    Keep only the {plural(nSel - hidden, \"visible one\", \"visible ones\")}\n                  </button>\n                ) : null}\n                {headerChecked && !allMatching && filtered.length > pageRows.length ? (\n                  <button type=\"button\" onClick={selectAllMatching}>\n                    Select all {filtered.length} matching\n                  </button>\n                ) : null}\n                <button type=\"button\" onClick={clearSel}>\n                  Clear\n                </button>\n              </>\n            )\n          }\n        >\n          <Toolbar layout=\"cell\" overflow=\"menu\" aria-label=\"Bulk actions\">\n            <ToolbarButton disabled={!nSel} onClick={() => reschedule(1)}>\n              Delay 1 day\n            </ToolbarButton>\n            <Menu>\n              <ToolbarMenuTrigger>Actions</ToolbarMenuTrigger>\n              <ToolbarMenuContent align=\"end\" container={container} finalFocus={keepFocus}>\n                <MenuItem shortcut=\"2\" disabled={!nSel} onClick={() => reschedule(2)}>\n                  Delay 2 days\n                </MenuItem>\n                <MenuItem shortcut=\"↩\" disabled={!nSel} onClick={() => reschedule(-1)}>\n                  Bring forward 1 day\n                </MenuItem>\n                <MenuItem disabled description=\"Needs customs documents on every selected shipment\">\n                  Request customs release\n                </MenuItem>\n                <MenuSeparator />\n                <MenuItem variant=\"destructive\" disabled={!nSel} onClick={askCancel}>\n                  Cancel {nSel ? plural(nSel, \"shipment\") : \"shipments\"}…\n                </MenuItem>\n              </ToolbarMenuContent>\n            </Menu>\n            <Menu>\n              <ToolbarMenuTrigger primary signal={assignSig} disabled={!nSel} affix={nSel}>\n                Assign carrier\n              </ToolbarMenuTrigger>\n              <ToolbarMenuContent align=\"end\" container={container}>\n                <MenuGroup>\n                  <MenuGroupLabel>Assign to {plural(nSel, \"shipment\")}</MenuGroupLabel>\n                  {CARRIERS.map((c) => (\n                    <MenuItem\n                      key={c.value}\n                      disabled={c.disabled}\n                      description={c.description ?? (c.value === \"Rhenus Road\" ? \"Capacity 5 this week\" : undefined)}\n                      onClick={() => void assign(c.value)}\n                    >\n                      {c.label}\n                    </MenuItem>\n                  ))}\n                </MenuGroup>\n              </ToolbarMenuContent>\n            </Menu>\n          </Toolbar>\n        </DataTableBulkBar>\n\n        <TableScroll>\n          <Inspecting.Provider value={inspecting}>\n            <DataTable\n              table={table}\n              aria-rowcount={filtered.length + 1}\n              rowLabel={selectLabel}\n              rowProps={rowProps}\n              renderDetail={renderLegs}\n              expandLabel={legsLabel}\n              bodyProps={{ ref: rowMotion.ref }}\n              loading={load === \"loading\"}\n              error={\n                load === \"error\"\n                  ? {\n                      title: \"Shipments couldn't load.\",\n                      body: \"The carrier gateway timed out (504). Your filters and selection are kept.\",\n                      action: <Button onClick={() => void reload()}>Try again</Button>,\n                    }\n                  : undefined\n              }\n              empty={{\n                title: rows.length === 0 ? \"No shipments yet.\" : \"No shipments match these filters.\",\n                body:\n                  rows.length === 0\n                    ? \"Cancelled shipments can be restored from the message below.\"\n                    : `${plural(rows.length, \"shipment\")} in total. ${activeFilters} ${activeFilters === 1 ? \"filter is\" : \"filters are\"} hiding them.`,\n                action: rows.length ? <Button onClick={clearFilters}>Clear filters</Button> : undefined,\n              }}\n            />\n          </Inspecting.Provider>\n        </TableScroll>\n\n        <DataTablePagination table={table} noun=\"shipments\" loading={load !== \"ready\"}>\n          <ToastDock />\n        </DataTablePagination>\n      </TableFrame>\n\n      <AlertDialog open={confirm} onOpenChange={setConfirm}>\n        <AlertDialogContent\n          title={`Cancel ${plural(nSel, \"shipment\")}?`}\n          description=\"Carriers are told immediately. You can undo for 8 seconds; after that, rebook from Dock schedule.\"\n          cancelLabel=\"Keep shipments\"\n          confirmLabel={`Cancel ${plural(nSel, \"shipment\")}`}\n          onConfirm={cancelSelected}\n          container={container}\n        >\n          <ul className=\"m-0 grid list-none gap-1 p-0 text-[14px]\">\n            {rows\n              .filter((s) => selected.has(s.id))\n              .slice(0, 4)\n              .map((s) => (\n                <li key={s.id}>\n                  <span className=\"kl-code\">{s.id}</span> {s.dest}\n                </li>\n              ))}\n            {nSel > 4 ? <li className=\"text-kl-ink-2\">and {nSel - 4} more</li> : null}\n          </ul>\n        </AlertDialogContent>\n      </AlertDialog>\n\n      <CommandDialog\n        open={cmd}\n        onOpenChange={(o) => (setCmd(o), o || setCmdQ(\"\"))}\n        container={container}\n        finalFocus={keepFocus}\n      >\n        <CommandInput placeholder=\"Type a command or a carrier…\" value={cmdQ} onValueChange={setCmdQ} />\n        <CommandList>\n          <CommandEmpty query={cmdQ}>Try “assign”, “view” or a carrier name.</CommandEmpty>\n          {nSel ? (\n            <CommandGroup heading={`Selected · ${plural(nSel, \"shipment\")}`}>\n              {CARRIERS.filter((c) => !c.disabled)\n                .slice(0, 5)\n                .map((c) => (\n                  <CommandItem\n                    key={c.value}\n                    value={`assign ${c.label}`}\n                    meta={<span className=\"kl-code\">{nSel}</span>}\n                    onSelect={run(() => void assign(c.value))}\n                  >\n                    Assign {c.label}\n                  </CommandItem>\n                ))}\n              <CommandItem value=\"delay 1 day reschedule\" onSelect={run(() => reschedule(1))}>\n                Delay 1 day\n              </CommandItem>\n              <CommandItem value=\"cancel shipments\" onSelect={run(askCancel)}>\n                Cancel {plural(nSel, \"shipment\")}…\n              </CommandItem>\n              <CommandItem value=\"clear selection\" onSelect={run(clearSel)}>\n                Clear selection\n              </CommandItem>\n            </CommandGroup>\n          ) : null}\n          <CommandGroup heading=\"View\">\n            {VIEWS.map((v) => (\n              <CommandItem\n                key={v.value}\n                value={`show ${v.label} view`}\n                meta={<span className=\"kl-code\">{base.filter(v.test).length}</span>}\n                onSelect={run(() => setView(v.value))}\n              >\n                Show {v.label.toLowerCase()}\n              </CommandItem>\n            ))}\n            <CommandItem value=\"select all matching\" disabled={!filtered.length} onSelect={run(selectAllMatching)}>\n              Select all {filtered.length} matching\n            </CommandItem>\n            <CommandItem value=\"clear filters\" disabled={!activeFilters} onSelect={run(clearFilters)}>\n              Clear filters\n            </CommandItem>\n          </CommandGroup>\n          <CommandGroup heading=\"Data\">\n            <CommandItem value=\"reload\" onSelect={run(() => void reload())}>\n              Reload shipments\n            </CommandItem>\n            <CommandItem\n              value=\"reload simulate gateway error failure\"\n              onSelect={run(() => ((failNext.current = true), void reload()))}\n            >\n              Reload and simulate a gateway error\n            </CommandItem>\n          </CommandGroup>\n        </CommandList>\n        <CommandFooter>\n          <span>\n            <Kbd>↑↓</Kbd> move\n          </span>\n          <span>\n            <Kbd>↵</Kbd> run\n          </span>\n          <span>\n            <Kbd>⌥1–9</Kbd> run by number\n          </span>\n        </CommandFooter>\n      </CommandDialog>\n    </AppShell>\n  );\n}\n\n/** A complete, working composition. Wrap once; the toast docks into the table pager. */\nexport function Shipments(props: ShipmentsProps) {\n  return (\n    <ToastProvider>\n      <ShipmentsApp {...props} />\n    </ToastProvider>\n  );\n}\n",
      "type": "registry:component",
      "target": "components/keyline/blocks/shipments/shipments.tsx"
    },
    {
      "path": "src/registry/keyline/blocks/shipments/shipments-data.ts",
      "content": "// Fictional demo data for the Shipments block. Deterministic, so renders are reproducible.\nexport type StatusKey = \"booked\" | \"transit\" | \"delayed\" | \"docs\" | \"delivered\" | \"none\";\nexport type Shipment = {\n  id: string;\n  dest: string;\n  carrier: string;\n  status: StatusKey;\n  kg: number | null;\n  eur: number;\n  eta: Date;\n  pallets: number;\n  reference: string;\n};\n\nexport const STATUS: Record<StatusKey, { label: string; kind: \"normal\" | \"waiting\" | \"attention\" | \"done\" | \"none\" }> =\n  {\n    booked: { label: \"Booked\", kind: \"normal\" },\n    transit: { label: \"In transit\", kind: \"normal\" },\n    delayed: { label: \"Delayed 2 d\", kind: \"attention\" },\n    docs: { label: \"Awaiting docs\", kind: \"waiting\" },\n    delivered: { label: \"Delivered\", kind: \"done\" },\n    none: { label: \"Not booked\", kind: \"none\" },\n  };\n\nexport const CARRIERS: { value: string; label: string; count: number; disabled?: boolean; description?: string }[] = [\n  { value: \"DHL Freight\", label: \"DHL Freight\", count: 412 },\n  { value: \"Maersk\", label: \"Maersk\", count: 298 },\n  { value: \"Raben\", label: \"Raben\", count: 141 },\n  { value: \"DSV Road\", label: \"DSV Road\", count: 96 },\n  { value: \"Kuehne+Nagel\", label: \"Kuehne+Nagel\", count: 88 },\n  { value: \"DB Schenker\", label: \"DB Schenker\", count: 77 },\n  { value: \"GEODIS\", label: \"GEODIS\", count: 64 },\n  { value: \"CEVA Logistics\", label: \"CEVA Logistics\", count: 59, disabled: true, description: \"Contract paused\" },\n  { value: \"Rhenus Road\", label: \"Rhenus Road\", count: 49 },\n];\n\nexport const TODAY = new Date(2026, 10, 7);\nexport const UNAVAILABLE: Record<number, string> = { 17: \"depot closed\", 22: \"depot closed\" };\nexport const isUnavailable = (d: Date) =>\n  d.getFullYear() === 2026 && d.getMonth() === 10 ? UNAVAILABLE[d.getDate()] : undefined;\n\nconst nov = (d: number) => new Date(2026, 10, d);\nconst SEED: Omit<Shipment, \"reference\">[] = [\n  {\n    id: \"SH-20481\",\n    dest: \"Hamburg, DE\",\n    carrier: \"DHL Freight\",\n    status: \"transit\",\n    kg: 1240.5,\n    eur: 18420,\n    eta: nov(14),\n    pallets: 4,\n  },\n  {\n    id: \"SH-20482\",\n    dest: \"Antwerpen, BE\",\n    carrier: \"Maersk\",\n    status: \"delayed\",\n    kg: 860,\n    eur: 9975.5,\n    eta: nov(15),\n    pallets: 3,\n  },\n  {\n    id: \"SH-20483\",\n    dest: \"Lyon, FR\",\n    carrier: \"DHL Freight\",\n    status: \"transit\",\n    kg: 12004,\n    eur: 142880,\n    eta: nov(16),\n    pallets: 22,\n  },\n  {\n    id: \"SH-20484\",\n    dest: \"Kraków, PL\",\n    carrier: \"Raben\",\n    status: \"docs\",\n    kg: 3310,\n    eur: 27040,\n    eta: nov(16),\n    pallets: 9,\n  },\n  {\n    id: \"SH-20485\",\n    dest: \"Göteborg, SE\",\n    carrier: \"Maersk\",\n    status: \"transit\",\n    kg: 5770,\n    eur: 61300,\n    eta: nov(16),\n    pallets: 14,\n  },\n  {\n    id: \"SH-20486\",\n    dest: \"Zaragoza, ES\",\n    carrier: \"DSV Road\",\n    status: \"none\",\n    kg: null,\n    eur: 0,\n    eta: nov(18),\n    pallets: 0,\n  },\n  {\n    id: \"SH-20487\",\n    dest: \"Thessaloníki, GR\",\n    carrier: \"DHL Freight\",\n    status: \"booked\",\n    kg: 98.2,\n    eur: 1204,\n    eta: nov(18),\n    pallets: 1,\n  },\n  {\n    id: \"SH-20488\",\n    dest: \"Bratislava, SK\",\n    carrier: \"Raben\",\n    status: \"booked\",\n    kg: 2410,\n    eur: 20118.75,\n    eta: nov(19),\n    pallets: 6,\n  },\n  {\n    id: \"SH-20489\",\n    dest: \"Porto, PT\",\n    carrier: \"Kuehne+Nagel\",\n    status: \"delivered\",\n    kg: 640,\n    eur: 5880,\n    eta: nov(11),\n    pallets: 2,\n  },\n  {\n    id: \"SH-20490\",\n    dest: \"Ljubljana, SI\",\n    carrier: \"DB Schenker\",\n    status: \"transit\",\n    kg: 7125,\n    eur: 88410,\n    eta: nov(17),\n    pallets: 18,\n  },\n  {\n    id: \"SH-20491\",\n    dest: \"Tallinn, EE\",\n    carrier: \"Maersk\",\n    status: \"docs\",\n    kg: 1980,\n    eur: 14600,\n    eta: nov(19),\n    pallets: 5,\n  },\n  {\n    id: \"SH-20492\",\n    dest: \"Bologna, IT\",\n    carrier: \"GEODIS\",\n    status: \"booked\",\n    kg: 455.5,\n    eur: 3912.4,\n    eta: nov(20),\n    pallets: 2,\n  },\n];\n\nconst CITIES = [\n  \"Rotterdam, NL\",\n  \"Gdańsk, PL\",\n  \"Wien, AT\",\n  \"Milano, IT\",\n  \"Brno, CZ\",\n  \"Lille, FR\",\n  \"Aarhus, DK\",\n  \"Valencia, ES\",\n  \"Debrecen, HU\",\n  \"Graz, AT\",\n  \"Leipzig, DE\",\n  \"Bordeaux, FR\",\n  \"Vilnius, LT\",\n  \"Cluj-Napoca, RO\",\n  \"Sevilla, ES\",\n  \"Kortrijk, BE\",\n  \"Malmö, SE\",\n  \"Plovdiv, BG\",\n  \"Rijeka, HR\",\n  \"Oulu, FI\",\n  \"Saint-Quentin-Fallavier, FR\",\n];\nconst KEYS: StatusKey[] = [\n  \"transit\",\n  \"transit\",\n  \"booked\",\n  \"delivered\",\n  \"delivered\",\n  \"docs\",\n  \"delayed\",\n  \"transit\",\n  \"booked\",\n  \"delivered\",\n];\n\nfunction rng(seed: number) {\n  return () => (seed = (seed * 1664525 + 1013904223) % 4294967296) / 4294967296;\n}\n\nexport function makeShipments(n = 64): Shipment[] {\n  const r = rng(20483);\n  const out: Shipment[] = SEED.map((s, i) => ({\n    ...s,\n    reference: `PO-${88201 + i}-${s.dest.slice(0, 3).toUpperCase()}`,\n  }));\n  for (let i = out.length; i < n; i++) {\n    const status = KEYS[Math.floor(r() * KEYS.length)];\n    const carrier = CARRIERS.filter((c) => !c.disabled)[Math.floor(r() * 8)]?.value;\n    const dest = CITIES[Math.floor(r() * CITIES.length)];\n    if (!status || !carrier || !dest) continue;\n    const kg = Math.round(r() * 9000 * 10) / 10 + 40;\n    out.push({\n      id: `SH-${20481 + i}`,\n      dest,\n      carrier,\n      status,\n      kg,\n      eur: Math.round(kg * (6 + r() * 8) * 100) / 100,\n      eta: nov(status === \"delivered\" ? 3 + Math.floor(r() * 6) : 9 + Math.floor(r() * 18)),\n      pallets: Math.max(1, Math.round(kg / 520)),\n      reference: `PO-${88201 + i}-${dest.slice(0, 3).toUpperCase()}`,\n    });\n  }\n  return out;\n}\n\nexport const LEGS = [\n  { at: \"09 Nov 06:10\", place: \"Rotterdam hub\", what: \"Picked up\", state: \"done\" as const },\n  { at: \"10 Nov 14:45\", place: \"Venlo cross-dock\", what: \"Consolidated\", state: \"done\" as const },\n  { at: \"12 Nov 08:20\", place: \"Metz, FR\", what: \"In transit · on time\", state: \"current\" as const },\n  { at: \"16 Nov (ETA)\", place: \"Lyon, FR\", what: \"Delivery window 08:00–12:00\", state: \"next\" as const },\n];\n\n/** Simulated carrier search: latency, abort, and an error for the query \"err\". */\nexport function searchCarriers(q: string, signal: AbortSignal) {\n  return new Promise<typeof CARRIERS>((resolve, reject) => {\n    const t = setTimeout(\n      () => {\n        if (q.trim().toLowerCase() === \"err\") reject(new Error(\"Carrier service timed out (504)\"));\n        else resolve(CARRIERS.filter((c) => c.label.toLowerCase().includes(q.trim().toLowerCase())));\n      },\n      260 + Math.random() * 260,\n    );\n    signal.addEventListener(\"abort\", () => clearTimeout(t));\n  });\n}\n\nexport const fmtKg = (n: number | null) =>\n  n == null ? \"—\" : n.toLocaleString(\"en-GB\", { minimumFractionDigits: 1, maximumFractionDigits: 1 });\nexport const fmtEur = (n: number) => n.toLocaleString(\"en-GB\", { minimumFractionDigits: 2, maximumFractionDigits: 2 });\nexport const fmtDay = (d: Date) =>\n  `${String(d.getDate()).padStart(2, \"0\")} ${d.toLocaleString(\"en-GB\", { month: \"short\" })}`;\n",
      "type": "registry:lib",
      "target": "components/keyline/blocks/shipments/shipments-data.ts"
    }
  ],
  "type": "registry:block"
}