@eifi1/ui-kit 0.54.0 → 0.55.0

package/dist/feedback/feedback-inbox-page.d.ts

@@ -0,0 +1,260 @@
+import type { ReactNode } from "react";
+import { type DataTableColumn, type DataTableProps } from "../components/data-table.js";
+import type { CommitScope } from "../components/write-lock.js";
+import type { AuthedFetcher } from "../hooks/use-authed-src.js";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { PathPattern } from "../landing/routing.js";
+import type { FeedbackRecord } from "./feedback-record.js";
+import { type FeedbackDetailPatch, type FeedbackRowDetailProps, type FeedbackUpload } from "./feedback-row-detail.js";
+import { type FeedbackStatusChange } from "./feedback-status-undo.js";
+import { type FeedbackSwipeBinding } from "./feedback-swipe.js";
+import { type FeedbackPageLabels, type FeedbackRenderDate } from "./feedback-table.js";
+import type { FeedbackStatus } from "./feedback-vocabulary.js";
+/**
+ * The feedback inbox, ASSEMBLED ONCE (0.55; kastlan reuse audit 2026-11-02, proposal 2;
+ * docs/feedback-harmonization.md §13).
+ *
+ * Since 0.27 every part of `/feedback` and `/my-feedback` has been the kit's — the columns,
+ * the phone card and its day headers, the detail, the Undo, the swipes, the awaiting toggle
+ * (feedback-table.tsx, feedback-row-detail.tsx, feedback-swipe.tsx). What was not the kit's
+ * was the WIRING between them, and each app wrote the same ~150 lines of it:
+ * kastlan `frontend/src/features/feedback/pages/feedback-page.tsx:40-205`, keksdose
+ * `frontend/src/features/feedback/feedback-page.tsx:51-303`, Kurvenschmiede
+ * `frontend/src/features/feedback/feedback-page.tsx:88-245`. The open row in `?row=` with
+ * its numeric parse and its `rowHref`, `useFeedbackStatusUndo` over the page's PATCH, the
+ * `DataTable` with a dozen props, `FeedbackRowDetail` with a dozen more, the phone's
+ * grouping, card and swipe plan, the awaiting filter and its toggle. So every rename the
+ * parts took (0.52's `mutateAsync`, 0.53's removals) was made three times, and three
+ * times reviewed.
+ *
+ * Here that wiring is the kit's: {@link useFeedbackInbox} holds it and returns what the
+ * table, the detail and the phone cards need; {@link FeedbackInbox} draws the page from
+ * it. What stays the app's is what differs between the three, each a slot: where the rows
+ * come from and the three mutations (its API client, TanStack Query in all three — the kit
+ * sends no request), who may triage, the votes, the public switch, the comments (the app's
+ * `FeedbackCommentThread` over its own queries), its own columns, its swipe binding, its
+ * date writer, the page's header and frame, and whatever else `DataTable` takes.
+ *
+ * Additive: every part it is built from stays exported and unchanged, for a page that
+ * wants its own layout — call the hook and spread `inbox.table` into a `DataTable`.
+ */
+/**
+ * One of the page's mutations, as the inbox calls it: **TanStack Query's `useMutation`
+ * result, passed as it is** — `update={update}`. The inbox reads `mutateAsync` (whose
+ * promise settles for every call, refactor audit 2026-10-30 FLW-3) and `isPending`, and
+ * nothing else. Any object with those two fits, so a page on another data layer hands
+ * `{ mutateAsync: api.update, isPending }`.
+ *
+ * Taking the mutation rather than a callback per control is the point of the round: how
+ * the parts call it (0.52 moved them from `mutate` to `mutateAsync`) is then the kit's to
+ * change, once. Failure is the mutation's own: its `onError` toasts the server's sentence
+ * (§4.4), and the inbox catches the rejection.
+ */
+export interface FeedbackInboxMutation<V> {
+    mutateAsync: (variables: V) => Promise<unknown>;
+    /** In flight: the editors' and the composer's buttons wait for it. */
+    isPending?: boolean;
+}
+/** What the reply mutation is sent: `POST /feedback/{id}/replies` (§9.7, §12) — the
+ *  body, the status picked (absent: "No change") and the uploaded file's URL (absent:
+ *  none). Keys that carry nothing are left out, so a `mutationFn` may spread them onto
+ *  the wire. kastlan's `useFeedbackReply` takes exactly this. */
+export interface FeedbackReplyPost {
+    id: number;
+    body: string;
+    status?: FeedbackStatus;
+    attachmentUrl?: string;
+}
+/** What the rework mutation is sent: `POST /feedback/{id}/rework` (§10.3) — the author's
+ *  trimmed note and the uploaded file's URL (absent: none). kastlan's `useFeedbackRework`
+ *  takes exactly this. */
+export interface FeedbackReworkPost {
+    id: number;
+    note: string;
+    attachmentUrl?: string;
+}
+export interface UseFeedbackInboxOptions<T extends FeedbackRecord> {
+    /** The list as the app's query answered it (`GET /feedback`, `GET /feedback/my`) —
+     *  `list.data ?? []`. Shown newest first and, behind the awaiting toggle, narrowed. */
+    rows: readonly T[];
+    /** `/my-feedback`: the viewer's own reports — no triage there, for an admin too (§4.3). */
+    mine?: boolean;
+    /** The viewer may triage: the admin. Only on the inbox — `mine` wins — so `isAdmin`
+     *  is enough. The status cell, the pills, the reply composer, the swipes, the submitter
+     *  on the card and the awaiting toggle. */
+    canEdit: boolean;
+    /** The signed-in user's id: who the AUTHOR is (the description editor, Rework, the
+     *  public switch's window). */
+    viewerId?: number | null;
+    /**
+     * `PATCH /feedback/{id}` (§3.4): every edit of the report itself — a status change from
+     * the cell, the pills or a swipe (with the Undo, `useFeedbackStatusUndo`), the
+     * description, the legacy rework append and, with {@link publicSwitch}, the flip. ONE
+     * mutation for all of them, the page's, so its observer outlives a row a status filter
+     * removes (§4.5).
+     */
+    update: FeedbackInboxMutation<FeedbackDetailPatch>;
+    /** `POST /feedback/{id}/replies` — the admin's answer (§9.7) with its one file (§12).
+     *  Without it no composer is drawn. */
+    reply?: FeedbackInboxMutation<FeedbackReplyPost>;
+    /** `POST /feedback/{id}/rework` — the author's rework entry (§10.3). Without it a rework
+     *  goes through {@link update} as the legacy body append (§3.4). */
+    rework?: FeedbackInboxMutation<FeedbackReworkPost>;
+    /**
+     * The **Visible to others** switch in the detail (§9.3), its flip sent through
+     * {@link update} as `{ id, public }` — as keksdose and Kurvenschmiede send it. Off by
+     * default: an app without public parts (kastlan) has no switch.
+     */
+    publicSwitch?: boolean;
+    /** The **Votes** column and the card's count (§9.6). Off by default (kastlan); keksdose
+     *  always, Kurvenschmiede for a reader of the public parts. */
+    votes?: boolean;
+    /**
+     * The report's comments, in a section of their own under the replies (§9.8): the app's
+     * `FeedbackCommentThread` over its own queries — a component of its own, since its
+     * queries are hooks. Return `null` for a row without a thread (a CRASH, a reader who
+     * does not see the public parts; `false` is read as `null`). Called only for the open
+     * row.
+     *
+     * ```tsx
+     * comments={(row) => <RowComments id={row.id} isAdmin={isAdmin} canComment={!canEdit} />}
+     * ```
+     */
+    comments?: (row: T) => ReactNode;
+    /** The detail as drawn, to wrap or extend — kastlan's tour anchor:
+     *  `(row, detail) => <div data-tour="feedback-row-detail">{detail}</div>`. */
+    renderDetail?: (row: T, detail: ReactNode) => ReactNode;
+    /**
+     * The app's own columns over the kit's (§4.3's nine, and Votes): add, drop, reorder —
+     * the keys are stable (`columns.filter((c) => c.key !== "email")`). A column brings its
+     * filter with it. Keep it stable (module scope or `useCallback`): it is a memo's
+     * dependency.
+     */
+    columns?: (columns: readonly DataTableColumn<T>[]) => readonly DataTableColumn<T>[];
+    /** Which swipe does what on the phone (§4.5) — keksdose's Settings → Interaction binding,
+     *  `{ end: prefs.right, start: prefs.left }`. Default `DEFAULT_FEEDBACK_SWIPE`. */
+    swipe?: FeedbackSwipeBinding;
+    /** The status writes the TABLE offers — the status cell and the desktop's actions
+     *  column — commit: under a locked `WriteLockProvider` they stay and say why
+     *  (`FeedbackStatusTransitions`' `commit`). Off by default. The detail's own saves:
+     *  `detail={{ commit }}`. */
+    commit?: CommitScope;
+    /** `POST /feedback/attachments` (§3.3): the rework's file and the reply's. */
+    onUpload?: FeedbackUpload;
+    /** The app's authenticated GET for the pictures and the downloads (§3.5). */
+    fetcher?: AuthedFetcher | null;
+    /** "Capture screenshot" beside the rework's and the reply's file field. Default: the
+     *  kit's `captureAppScreenshot()`; `null` for no button. */
+    onCaptureScreenshot?: (() => Promise<File | null>) | null;
+    /**
+     * The app's date writer (keksdose's `useDateCell()`, the date-format setting): the date
+     * and resolved columns, the card, the phone's day headers AND the detail's "Resolved:",
+     * so all five say the same. Left out, the kit's date with the weekday in the table and
+     * on the phone, and in the detail its sentence date — as the parts draw them alone.
+     */
+    renderDate?: FeedbackRenderDate;
+    /** The app's one-shot routes, on top of the kit's (0.52, FLW-7) — for the URL column and
+     *  the detail's URL section alike. Keep it stable (module scope). */
+    pageLinkExclude?: readonly PathPattern[];
+    /** The list is still loading (`list.isPending`): the table says "Loading…" where its
+     *  rows will be, not "None". */
+    loading?: boolean;
+    /** Over the detail's props the inbox sets — `commit`, `showSubject`,
+     *  `reworkAttachment`, `replyAttachments` (on here), `labels`, `className`. Merged last,
+     *  so it wins. */
+    detail?: Partial<Omit<FeedbackRowDetailProps, "row">>;
+    /** Over the `feedbackPage` namespace: the columns, the card, the empty state, the toggle
+     *  and the title. Keep it stable: it is a memo's dependency. */
+    labels?: LabelOverride<FeedbackPageLabels>;
+}
+/** What {@link useFeedbackInbox} returns: the state, and the props of the parts. */
+export interface FeedbackInboxState<T extends FeedbackRecord> {
+    /** `canEdit && !mine`: the admin on the inbox. */
+    editable: boolean;
+    /** The page's title, `feedbackPage.title` — or `.myTitle` on `/my-feedback`. */
+    title: string;
+    /** The open row's id, from `?row=`; `null` when none is open or the param named no
+     *  id (`?row=abc`, `?row=1.5`, `?row=0`). */
+    openId: number | null;
+    /** Open a row by its id, or close it with `null`: rewrites `?row=`, replacing the
+     *  history entry rather than stacking one per report looked at. */
+    setOpenId: (id: number | null) => void;
+    /** A row's own address: this view — the table's page, sort and filters — with the row
+     *  open. The row's link (a new tab, a copied address); a plain click opens it in place. */
+    rowHref: (row: T) => string;
+    /** The undoable status change (§4.5): the status cell's, the pills', the swipes'. */
+    changeStatus: FeedbackStatusChange;
+    /** The phone's "Only what is waiting for you" — page state, not the URL (§4.3). */
+    awaiting: boolean;
+    setAwaiting: (next: boolean) => void;
+    /** The one date writer the columns, the card and the day headers use. */
+    renderDate: FeedbackRenderDate;
+    /** `FeedbackRowDetail`'s props for a row, slots included. */
+    detailProps: (row: T) => FeedbackRowDetailProps;
+    /** `DataTable`'s props, ready to spread: the rows (newest first, narrowed by
+     *  `awaiting`), the columns, the open row, the detail, the phone's card, day headers and
+     *  swipes, the desktop's actions column, the empty state, `urlSync`,
+     *  `storageKey="feedback"`, `fillHeight`. */
+    table: DataTableProps<T>;
+}
+/**
+ * The inbox's wiring, once (§13): from the app's rows and mutations to what the table,
+ * the detail and the phone cards take.
+ *
+ * ```tsx
+ * const list = useQuery({ queryKey: keys.feedback.all, queryFn: api.listFeedback });
+ * const update = useMutation({ mutationFn: ({ id, ...patch }: FeedbackDetailPatch) => api.update(id, patch), … });
+ * const inbox = useFeedbackInbox({ rows: list.data ?? [], canEdit: isAdmin, viewerId: user?.id, update });
+ * <DataTable {...inbox.table} edgeFade />
+ * ```
+ *
+ * {@link FeedbackInbox} is this hook drawn — use the hook alone for a layout of your own.
+ * Needs a react-router Router (`?row=`, `urlSync`).
+ */
+export declare function useFeedbackInbox<T extends FeedbackRecord>({ rows, mine, canEdit, viewerId, update, reply, rework, publicSwitch, votes, comments, renderDetail, columns: ownColumns, swipe, commit, onUpload, fetcher, onCaptureScreenshot, renderDate: renderDateProp, pageLinkExclude, loading, detail, labels, }: UseFeedbackInboxOptions<T>): FeedbackInboxState<T>;
+export interface FeedbackInboxProps<T extends FeedbackRecord> extends UseFeedbackInboxOptions<T> {
+    /**
+     * Above the table. Default: `<PageHeader title={title} className="mb-4 md:shrink-0" />`.
+     * A function gets the page's title (`feedbackPage.title` / `.myTitle`) — the app's own
+     * header: `(title) => <PageHeader size="compact" title={title} data-tour="feedback-header" />`.
+     * `null` for none.
+     */
+    header?: ReactNode | ((title: string) => ReactNode);
+    /** Over the inbox's `DataTable` props — `edgeFade`, `locale`, `mobileExpandAsDialog`,
+     *  `className`, another `storageKey`. Merged last, so it wins. */
+    table?: Partial<DataTableProps<T>>;
+    /** Further `FloatingAction`s on the phone: after the awaiting toggle on the inbox, in a
+     *  group of their own on `/my-feedback`. */
+    phoneActions?: ReactNode;
+    /** On the page's frame — the fill-height column (`FILL_HEIGHT_CLASS`); the app's page
+     *  padding goes here. */
+    className?: string;
+}
+/**
+ * The feedback inbox (§13): `/feedback` and `/my-feedback` drawn whole from
+ * {@link useFeedbackInbox} — the header, the table with its detail, phone cards and swipes,
+ * and the phone's awaiting toggle, in the fill-height frame (page layout §1.3) — so a page
+ * is its queries and this:
+ *
+ * ```tsx
+ * export function FeedbackPage({ mine = false }: { mine?: boolean }) {
+ *   const { user, isAdmin } = useAuth();
+ *   const list = useQuery({ queryKey: mine ? keys.mine : keys.all, queryFn: mine ? api.mine : api.all });
+ *   const update = useFeedbackUpdate();
+ *   const reply = useFeedbackReply();
+ *   const rework = useFeedbackRework();
+ *   if (!mine && !isAdmin) return <Navigate to="/my-feedback" replace />;
+ *   return (
+ *     <FeedbackInbox
+ *       rows={list.data ?? []} loading={list.isPending} mine={mine} canEdit={isAdmin} viewerId={user?.id}
+ *       update={update} reply={reply} rework={rework}
+ *       onUpload={api.upload} fetcher={api.file}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * Every slot is {@link UseFeedbackInboxOptions}' or one of the four below. The redirect of
+ * a non-admin, the routes and the queries stay the app's.
+ */
+export declare function FeedbackInbox<T extends FeedbackRecord>({ header, table, phoneActions, className, ...options }: FeedbackInboxProps<T>): import("react").JSX.Element;

package/dist/feedback/feedback-inbox-page.js

@@ -0,0 +1,207 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from "react";
+import { useHref, useLocation } from "react-router";
+import { cn } from "../lib/cn.js";
+import { DataTable } from "../components/data-table.js";
+import { FloatingActionGroup } from "../components/floating-panel.js";
+import { LoadingState } from "../components/loading-state.js";
+import { PageHeader } from "../components/page-header.js";
+import { useSearchParamState } from "../hooks/use-search-param-state.js";
+import { FILL_HEIGHT_CLASS } from "../shell/fill-height.js";
+import { captureAppScreenshot } from "./feedback-capture.js";
+import { useFeedbackStatusLabels } from "./feedback-labels.js";
+import { runMutation } from "./feedback-mutation.js";
+import {
+  FeedbackRowDetail
+} from "./feedback-row-detail.js";
+import { useFeedbackStatusUndo } from "./feedback-status-undo.js";
+import {
+  DEFAULT_FEEDBACK_SWIPE,
+  feedbackSwipeOmitShown,
+  feedbackSwipePlan
+} from "./feedback-swipe.js";
+import {
+  FeedbackAwaitingToggle,
+  FeedbackEmptyState,
+  FeedbackMobileCard,
+  feedbackMobileGroupBy,
+  isFeedbackAwaiting,
+  useFeedbackColumns,
+  useFeedbackPageLabels,
+  useFeedbackRenderDate
+} from "./feedback-table.js";
+function parseRowId(raw) {
+  if (!/^[1-9]\d*$/.test(raw)) return void 0;
+  const id = Number(raw);
+  return Number.isSafeInteger(id) ? id : void 0;
+}
+const ROW_PARAM = { parse: parseRowId, history: "replace" };
+const newestFirst = (a, b) => a.created_at < b.created_at ? 1 : a.created_at > b.created_at ? -1 : 0;
+const rowId = (row) => row.id;
+const rowTitle = (row) => row.title;
+const captureScreenshot = () => captureAppScreenshot();
+const ignore = () => {
+};
+const threadOf = (node) => node === false || node === "" ? void 0 : node;
+function useFeedbackInbox({
+  rows,
+  mine = false,
+  canEdit,
+  viewerId,
+  update,
+  reply,
+  rework,
+  publicSwitch = false,
+  votes = false,
+  comments,
+  renderDetail,
+  columns: ownColumns,
+  swipe = DEFAULT_FEEDBACK_SWIPE,
+  commit,
+  onUpload,
+  fetcher,
+  onCaptureScreenshot = captureScreenshot,
+  renderDate: renderDateProp,
+  pageLinkExclude,
+  loading = false,
+  detail,
+  labels
+}) {
+  const editable = canEdit && !mine;
+  const pageLabels = useFeedbackPageLabels(labels);
+  const statusLabels = useFeedbackStatusLabels();
+  const renderDate = useFeedbackRenderDate(renderDateProp);
+  const updateAsync = update.mutateAsync;
+  const changeStatus = useFeedbackStatusUndo(updateAsync);
+  const [openId, setOpenId] = useSearchParamState("row", null, ROW_PARAM);
+  const { pathname, search } = useLocation();
+  const here = useHref({ pathname });
+  const rowHref = useCallback(
+    (row) => {
+      const params = new URLSearchParams(search);
+      params.set("row", String(row.id));
+      return `${here}?${params.toString()}`;
+    },
+    [here, search]
+  );
+  const [awaiting, setAwaiting] = useState(false);
+  const shown = useMemo(
+    () => (editable && awaiting ? rows.filter((row) => isFeedbackAwaiting(row.status)) : [...rows]).sort(newestFirst),
+    [rows, editable, awaiting]
+  );
+  const kitColumns = useFeedbackColumns({
+    mine,
+    canEdit,
+    onStatus: changeStatus,
+    renderDate,
+    commit,
+    votes,
+    pageLinkExclude,
+    labels
+  });
+  const columns = useMemo(() => ownColumns ? ownColumns(kitColumns) : kitColumns, [ownColumns, kitColumns]);
+  const mobileGroupBy = useMemo(() => feedbackMobileGroupBy(renderDate), [renderDate]);
+  const pending = Boolean(update.isPending || rework?.isPending);
+  const capture = onCaptureScreenshot ?? void 0;
+  const detailProps = (row) => ({
+    row,
+    canEdit: editable,
+    viewerId,
+    onUpdate: updateAsync,
+    pending,
+    // The page's change, not one the detail would build: the same Undo as the cell's.
+    statusChange: changeStatus,
+    onUpload,
+    fetcher,
+    onCaptureScreenshot: capture,
+    // Only the app's own: left out, the detail's "Resolved:" is the kit's sentence date,
+    // no weekday — as kastlan's has always been.
+    renderDate: renderDateProp,
+    pageLinkExclude,
+    onReply: reply ? (body, status, attachmentUrl) => reply.mutateAsync({
+      id: row.id,
+      body,
+      ...status ? { status } : {},
+      ...attachmentUrl ? { attachmentUrl } : {}
+    }) : void 0,
+    // The reply's one file (§12): all three apps are on server-kit 0.18, and the reply
+    // mutation's `attachmentUrl` is in its type from the start (the B1 risk the detail's
+    // default guards against — an `onReply` that drops the file — cannot arise here).
+    replyAttachments: true,
+    replying: reply?.isPending ?? false,
+    onRework: rework ? (note, attachmentUrl) => rework.mutateAsync({ id: row.id, note, ...attachmentUrl ? { attachmentUrl } : {} }) : void 0,
+    comments: threadOf(comments?.(row)),
+    onPublicChange: publicSwitch ? (next) => runMutation(updateAsync, { id: row.id, public: next }, ignore) : void 0,
+    ...detail
+  });
+  const table = {
+    rows: shown,
+    columns,
+    rowKey: rowId,
+    storageKey: "feedback",
+    urlSync: true,
+    fillHeight: true,
+    rowHref,
+    // The link covers the row's first cell; a click anywhere on the row opens it — or,
+    // on the open one, closes it.
+    onRowClick: (row) => setOpenId((id) => id === row.id ? null : row.id),
+    isExpanded: (row) => row.id === openId,
+    expandedRow: (row) => {
+      const node = /* @__PURE__ */ jsx(FeedbackRowDetail, { ...detailProps(row) });
+      return renderDetail ? renderDetail(row, node) : node;
+    },
+    // §7.13: one word, also when a filter or the toggle leaves nothing; and while the
+    // first answer is out, what is happening instead.
+    empty: loading ? /* @__PURE__ */ jsx(LoadingState, { size: "sm", inline: true }) : /* @__PURE__ */ jsx(FeedbackEmptyState, { labels }),
+    mobileGroupBy,
+    mobileCard: (row) => /* @__PURE__ */ jsx(FeedbackMobileCard, { row, showSubmitter: editable, renderDate, votes, labels }),
+    // The admin inbox only — /my-feedback is read-only by design (keksdose #331) — and
+    // every swipe through the same Undo as a tap (§4.5, §7.10).
+    mobileSwipeActions: editable ? (row) => feedbackSwipePlan(swipe, row, { change: changeStatus, labels: statusLabels }) : void 0,
+    // The swipes as the desktop's last column (0.46, keksdose dev#598), less what the
+    // status cell already offers.
+    desktopSwipeActions: { omit: feedbackSwipeOmitShown, name: rowTitle, ...commit === void 0 ? {} : { commit } }
+  };
+  return {
+    editable,
+    title: mine ? pageLabels.myTitle : pageLabels.title,
+    openId,
+    setOpenId,
+    rowHref,
+    changeStatus,
+    awaiting,
+    setAwaiting,
+    renderDate,
+    detailProps,
+    table
+  };
+}
+function FeedbackInbox({
+  header,
+  table,
+  phoneActions,
+  className,
+  ...options
+}) {
+  const inbox = useFeedbackInbox(options);
+  const pageLabels = useFeedbackPageLabels(options.labels);
+  const head = header === void 0 ? /* @__PURE__ */ jsx(PageHeader, { title: inbox.title, className: "mb-4 md:shrink-0" }) : typeof header === "function" ? header(inbox.title) : header;
+  return (
+    // A plain element on the way to the table carries the fill (page layout §1.3).
+    /* @__PURE__ */ jsxs("div", { className: cn(FILL_HEIGHT_CLASS, className), "aria-busy": options.loading || void 0, "data-feedback-inbox": "", children: [
+      head,
+      /* @__PURE__ */ jsx(DataTable, { ...inbox.table, ...table }),
+      inbox.editable ? (
+        // The phone's floating action (keksdose feedback #58): only on the inbox — on
+        // /my-feedback the author is not waiting on their own verdict.
+        /* @__PURE__ */ jsx(FeedbackAwaitingToggle, { pressed: inbox.awaiting, onPressedChange: inbox.setAwaiting, labels: options.labels, children: phoneActions })
+      ) : phoneActions && /* @__PURE__ */ jsx(FloatingActionGroup, { "aria-label": pageLabels.phoneActions, className: "md:hidden", children: phoneActions })
+    ] })
+  );
+}
+export {
+  FeedbackInbox,
+  useFeedbackInbox
+};
+//# sourceMappingURL=feedback-inbox-page.js.map

package/dist/feedback/feedback-inbox-page.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-inbox-page.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useHref, useLocation } from \"react-router\";\nimport { cn } from \"../lib/cn\";\nimport { DataTable, type DataTableColumn, type DataTableProps } from \"../components/data-table\";\nimport { FloatingActionGroup } from \"../components/floating-panel\";\nimport { LoadingState } from \"../components/loading-state\";\nimport { PageHeader } from \"../components/page-header\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport type { AuthedFetcher } from \"../hooks/use-authed-src\";\nimport { useSearchParamState } from \"../hooks/use-search-param-state\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport type { PathPattern } from \"../landing/routing\";\nimport { FILL_HEIGHT_CLASS } from \"../shell/fill-height\";\nimport { captureAppScreenshot } from \"./feedback-capture\";\nimport { useFeedbackStatusLabels } from \"./feedback-labels\";\nimport { runMutation } from \"./feedback-mutation\";\nimport type { FeedbackRecord } from \"./feedback-record\";\nimport {\n  FeedbackRowDetail,\n  type FeedbackDetailPatch,\n  type FeedbackRowDetailProps,\n  type FeedbackUpload,\n} from \"./feedback-row-detail\";\nimport { useFeedbackStatusUndo, type FeedbackStatusChange } from \"./feedback-status-undo\";\nimport {\n  DEFAULT_FEEDBACK_SWIPE,\n  feedbackSwipeOmitShown,\n  feedbackSwipePlan,\n  type FeedbackSwipeBinding,\n} from \"./feedback-swipe\";\nimport {\n  FeedbackAwaitingToggle,\n  FeedbackEmptyState,\n  FeedbackMobileCard,\n  feedbackMobileGroupBy,\n  isFeedbackAwaiting,\n  useFeedbackColumns,\n  useFeedbackPageLabels,\n  useFeedbackRenderDate,\n  type FeedbackPageLabels,\n  type FeedbackRenderDate,\n} from \"./feedback-table\";\nimport type { FeedbackStatus } from \"./feedback-vocabulary\";\n\n/**\n * The feedback inbox, ASSEMBLED ONCE (0.55; kastlan reuse audit 2026-11-02, proposal 2;\n * docs/feedback-harmonization.md §13).\n *\n * Since 0.27 every part of `/feedback` and `/my-feedback` has been the kit's — the columns,\n * the phone card and its day headers, the detail, the Undo, the swipes, the awaiting toggle\n * (feedback-table.tsx, feedback-row-detail.tsx, feedback-swipe.tsx). What was not the kit's\n * was the WIRING between them, and each app wrote the same ~150 lines of it:\n * kastlan `frontend/src/features/feedback/pages/feedback-page.tsx:40-205`, keksdose\n * `frontend/src/features/feedback/feedback-page.tsx:51-303`, Kurvenschmiede\n * `frontend/src/features/feedback/feedback-page.tsx:88-245`. The open row in `?row=` with\n * its numeric parse and its `rowHref`, `useFeedbackStatusUndo` over the page's PATCH, the\n * `DataTable` with a dozen props, `FeedbackRowDetail` with a dozen more, the phone's\n * grouping, card and swipe plan, the awaiting filter and its toggle. So every rename the\n * parts took (0.52's `mutateAsync`, 0.53's removals) was made three times, and three\n * times reviewed.\n *\n * Here that wiring is the kit's: {@link useFeedbackInbox} holds it and returns what the\n * table, the detail and the phone cards need; {@link FeedbackInbox} draws the page from\n * it. What stays the app's is what differs between the three, each a slot: where the rows\n * come from and the three mutations (its API client, TanStack Query in all three — the kit\n * sends no request), who may triage, the votes, the public switch, the comments (the app's\n * `FeedbackCommentThread` over its own queries), its own columns, its swipe binding, its\n * date writer, the page's header and frame, and whatever else `DataTable` takes.\n *\n * Additive: every part it is built from stays exported and unchanged, for a page that\n * wants its own layout — call the hook and spread `inbox.table` into a `DataTable`.\n */\n\n/* ── The mutations ──────────────────────────────────────────────────────────── */\n\n/**\n * One of the page's mutations, as the inbox calls it: **TanStack Query's `useMutation`\n * result, passed as it is** — `update={update}`. The inbox reads `mutateAsync` (whose\n * promise settles for every call, refactor audit 2026-10-30 FLW-3) and `isPending`, and\n * nothing else. Any object with those two fits, so a page on another data layer hands\n * `{ mutateAsync: api.update, isPending }`.\n *\n * Taking the mutation rather than a callback per control is the point of the round: how\n * the parts call it (0.52 moved them from `mutate` to `mutateAsync`) is then the kit's to\n * change, once. Failure is the mutation's own: its `onError` toasts the server's sentence\n * (§4.4), and the inbox catches the rejection.\n */\nexport interface FeedbackInboxMutation<V> {\n  mutateAsync: (variables: V) => Promise<unknown>;\n  /** In flight: the editors' and the composer's buttons wait for it. */\n  isPending?: boolean;\n}\n\n/** What the reply mutation is sent: `POST /feedback/{id}/replies` (§9.7, §12) — the\n *  body, the status picked (absent: \"No change\") and the uploaded file's URL (absent:\n *  none). Keys that carry nothing are left out, so a `mutationFn` may spread them onto\n *  the wire. kastlan's `useFeedbackReply` takes exactly this. */\nexport interface FeedbackReplyPost {\n  id: number;\n  body: string;\n  status?: FeedbackStatus;\n  attachmentUrl?: string;\n}\n\n/** What the rework mutation is sent: `POST /feedback/{id}/rework` (§10.3) — the author's\n *  trimmed note and the uploaded file's URL (absent: none). kastlan's `useFeedbackRework`\n *  takes exactly this. */\nexport interface FeedbackReworkPost {\n  id: number;\n  note: string;\n  attachmentUrl?: string;\n}\n\n/* ── The hook ───────────────────────────────────────────────────────────────── */\n\nexport interface UseFeedbackInboxOptions<T extends FeedbackRecord> {\n  /** The list as the app's query answered it (`GET /feedback`, `GET /feedback/my`) —\n   *  `list.data ?? []`. Shown newest first and, behind the awaiting toggle, narrowed. */\n  rows: readonly T[];\n  /** `/my-feedback`: the viewer's own reports — no triage there, for an admin too (§4.3). */\n  mine?: boolean;\n  /** The viewer may triage: the admin. Only on the inbox — `mine` wins — so `isAdmin`\n   *  is enough. The status cell, the pills, the reply composer, the swipes, the submitter\n   *  on the card and the awaiting toggle. */\n  canEdit: boolean;\n  /** The signed-in user's id: who the AUTHOR is (the description editor, Rework, the\n   *  public switch's window). */\n  viewerId?: number | null;\n  /**\n   * `PATCH /feedback/{id}` (§3.4): every edit of the report itself — a status change from\n   * the cell, the pills or a swipe (with the Undo, `useFeedbackStatusUndo`), the\n   * description, the legacy rework append and, with {@link publicSwitch}, the flip. ONE\n   * mutation for all of them, the page's, so its observer outlives a row a status filter\n   * removes (§4.5).\n   */\n  update: FeedbackInboxMutation<FeedbackDetailPatch>;\n  /** `POST /feedback/{id}/replies` — the admin's answer (§9.7) with its one file (§12).\n   *  Without it no composer is drawn. */\n  reply?: FeedbackInboxMutation<FeedbackReplyPost>;\n  /** `POST /feedback/{id}/rework` — the author's rework entry (§10.3). Without it a rework\n   *  goes through {@link update} as the legacy body append (§3.4). */\n  rework?: FeedbackInboxMutation<FeedbackReworkPost>;\n  /**\n   * The **Visible to others** switch in the detail (§9.3), its flip sent through\n   * {@link update} as `{ id, public }` — as keksdose and Kurvenschmiede send it. Off by\n   * default: an app without public parts (kastlan) has no switch.\n   */\n  publicSwitch?: boolean;\n  /** The **Votes** column and the card's count (§9.6). Off by default (kastlan); keksdose\n   *  always, Kurvenschmiede for a reader of the public parts. */\n  votes?: boolean;\n  /**\n   * The report's comments, in a section of their own under the replies (§9.8): the app's\n   * `FeedbackCommentThread` over its own queries — a component of its own, since its\n   * queries are hooks. Return `null` for a row without a thread (a CRASH, a reader who\n   * does not see the public parts; `false` is read as `null`). Called only for the open\n   * row.\n   *\n   * ```tsx\n   * comments={(row) => <RowComments id={row.id} isAdmin={isAdmin} canComment={!canEdit} />}\n   * ```\n   */\n  comments?: (row: T) => ReactNode;\n  /** The detail as drawn, to wrap or extend — kastlan's tour anchor:\n   *  `(row, detail) => <div data-tour=\"feedback-row-detail\">{detail}</div>`. */\n  renderDetail?: (row: T, detail: ReactNode) => ReactNode;\n  /**\n   * The app's own columns over the kit's (§4.3's nine, and Votes): add, drop, reorder —\n   * the keys are stable (`columns.filter((c) => c.key !== \"email\")`). A column brings its\n   * filter with it. Keep it stable (module scope or `useCallback`): it is a memo's\n   * dependency.\n   */\n  columns?: (columns: readonly DataTableColumn<T>[]) => readonly DataTableColumn<T>[];\n  /** Which swipe does what on the phone (§4.5) — keksdose's Settings → Interaction binding,\n   *  `{ end: prefs.right, start: prefs.left }`. Default `DEFAULT_FEEDBACK_SWIPE`. */\n  swipe?: FeedbackSwipeBinding;\n  /** The status writes the TABLE offers — the status cell and the desktop's actions\n   *  column — commit: under a locked `WriteLockProvider` they stay and say why\n   *  (`FeedbackStatusTransitions`' `commit`). Off by default. The detail's own saves:\n   *  `detail={{ commit }}`. */\n  commit?: CommitScope;\n  /** `POST /feedback/attachments` (§3.3): the rework's file and the reply's. */\n  onUpload?: FeedbackUpload;\n  /** The app's authenticated GET for the pictures and the downloads (§3.5). */\n  fetcher?: AuthedFetcher | null;\n  /** \"Capture screenshot\" beside the rework's and the reply's file field. Default: the\n   *  kit's `captureAppScreenshot()`; `null` for no button. */\n  onCaptureScreenshot?: (() => Promise<File | null>) | null;\n  /**\n   * The app's date writer (keksdose's `useDateCell()`, the date-format setting): the date\n   * and resolved columns, the card, the phone's day headers AND the detail's \"Resolved:\",\n   * so all five say the same. Left out, the kit's date with the weekday in the table and\n   * on the phone, and in the detail its sentence date — as the parts draw them alone.\n   */\n  renderDate?: FeedbackRenderDate;\n  /** The app's one-shot routes, on top of the kit's (0.52, FLW-7) — for the URL column and\n   *  the detail's URL section alike. Keep it stable (module scope). */\n  pageLinkExclude?: readonly PathPattern[];\n  /** The list is still loading (`list.isPending`): the table says \"Loading…\" where its\n   *  rows will be, not \"None\". */\n  loading?: boolean;\n  /** Over the detail's props the inbox sets — `commit`, `showSubject`,\n   *  `reworkAttachment`, `replyAttachments` (on here), `labels`, `className`. Merged last,\n   *  so it wins. */\n  detail?: Partial<Omit<FeedbackRowDetailProps, \"row\">>;\n  /** Over the `feedbackPage` namespace: the columns, the card, the empty state, the toggle\n   *  and the title. Keep it stable: it is a memo's dependency. */\n  labels?: LabelOverride<FeedbackPageLabels>;\n}\n\n/** What {@link useFeedbackInbox} returns: the state, and the props of the parts. */\nexport interface FeedbackInboxState<T extends FeedbackRecord> {\n  /** `canEdit && !mine`: the admin on the inbox. */\n  editable: boolean;\n  /** The page's title, `feedbackPage.title` — or `.myTitle` on `/my-feedback`. */\n  title: string;\n  /** The open row's id, from `?row=`; `null` when none is open or the param named no\n   *  id (`?row=abc`, `?row=1.5`, `?row=0`). */\n  openId: number | null;\n  /** Open a row by its id, or close it with `null`: rewrites `?row=`, replacing the\n   *  history entry rather than stacking one per report looked at. */\n  setOpenId: (id: number | null) => void;\n  /** A row's own address: this view — the table's page, sort and filters — with the row\n   *  open. The row's link (a new tab, a copied address); a plain click opens it in place. */\n  rowHref: (row: T) => string;\n  /** The undoable status change (§4.5): the status cell's, the pills', the swipes'. */\n  changeStatus: FeedbackStatusChange;\n  /** The phone's \"Only what is waiting for you\" — page state, not the URL (§4.3). */\n  awaiting: boolean;\n  setAwaiting: (next: boolean) => void;\n  /** The one date writer the columns, the card and the day headers use. */\n  renderDate: FeedbackRenderDate;\n  /** `FeedbackRowDetail`'s props for a row, slots included. */\n  detailProps: (row: T) => FeedbackRowDetailProps;\n  /** `DataTable`'s props, ready to spread: the rows (newest first, narrowed by\n   *  `awaiting`), the columns, the open row, the detail, the phone's card, day headers and\n   *  swipes, the desktop's actions column, the empty state, `urlSync`,\n   *  `storageKey=\"feedback\"`, `fillHeight`. */\n  table: DataTableProps<T>;\n}\n\n/** `?row=`'s value: a report's id is a positive integer, written in digits. Anything\n *  else — a hand-edited link, `1e2`, `0x10`, `-3`, `1.5` — opens no row (and the URL\n *  keeps it until a row is opened or closed). The three apps parsed with `Number()`, so\n *  `?row=1e2` opened #100 in all three. */\nfunction parseRowId(raw: string): number | undefined {\n  if (!/^[1-9]\\d*$/.test(raw)) return undefined;\n  const id = Number(raw);\n  return Number.isSafeInteger(id) ? id : undefined;\n}\n\nconst ROW_PARAM = { parse: parseRowId, history: \"replace\" } as const;\n\n/** Newest first, as `GET /feedback` sends it (§3.3) — the phone's day headers group runs\n *  of equal days, so an older row between two of today's would split the day in two.\n *  ISO strings from one server sort as their instants; the sort is stable. */\nconst newestFirst = (a: FeedbackRecord, b: FeedbackRecord) =>\n  a.created_at < b.created_at ? 1 : a.created_at > b.created_at ? -1 : 0;\n\nconst rowId = (row: FeedbackRecord) => row.id;\nconst rowTitle = (row: FeedbackRecord) => row.title;\nconst captureScreenshot = () => captureAppScreenshot();\nconst ignore = () => {};\n/** A slot's \"nothing\": `cond && <Thread />` answers `false`, which the detail would draw\n *  as an empty Comments section (it draws one for anything but `null`). */\nconst threadOf = (node: ReactNode): ReactNode => (node === false || node === \"\" ? undefined : node);\n\n/**\n * The inbox's wiring, once (§13): from the app's rows and mutations to what the table,\n * the detail and the phone cards take.\n *\n * ```tsx\n * const list = useQuery({ queryKey: keys.feedback.all, queryFn: api.listFeedback });\n * const update = useMutation({ mutationFn: ({ id, ...patch }: FeedbackDetailPatch) => api.update(id, patch), … });\n * const inbox = useFeedbackInbox({ rows: list.data ?? [], canEdit: isAdmin, viewerId: user?.id, update });\n * <DataTable {...inbox.table} edgeFade />\n * ```\n *\n * {@link FeedbackInbox} is this hook drawn — use the hook alone for a layout of your own.\n * Needs a react-router Router (`?row=`, `urlSync`).\n */\nexport function useFeedbackInbox<T extends FeedbackRecord>({\n  rows,\n  mine = false,\n  canEdit,\n  viewerId,\n  update,\n  reply,\n  rework,\n  publicSwitch = false,\n  votes = false,\n  comments,\n  renderDetail,\n  columns: ownColumns,\n  swipe = DEFAULT_FEEDBACK_SWIPE,\n  commit,\n  onUpload,\n  fetcher,\n  onCaptureScreenshot = captureScreenshot,\n  renderDate: renderDateProp,\n  pageLinkExclude,\n  loading = false,\n  detail,\n  labels,\n}: UseFeedbackInboxOptions<T>): FeedbackInboxState<T> {\n  // An admin on /my-feedback reads as any author does (§4.3), as `feedbackColumns` has it.\n  const editable = canEdit && !mine;\n  const pageLabels = useFeedbackPageLabels(labels);\n  const statusLabels = useFeedbackStatusLabels();\n  const renderDate = useFeedbackRenderDate(renderDateProp);\n\n  // TanStack's `mutateAsync` is stable, so the Undo and the columns' memo hold across\n  // renders; the mutation object around it is not.\n  const updateAsync = update.mutateAsync;\n  const changeStatus = useFeedbackStatusUndo(updateAsync);\n\n  // The open row IS the URL (§4.3: `?row=<id>`, every app) — which is what makes a row a\n  // real link at all (keksdose feedback #451). Replace, not push: looking through ten\n  // reports is not ten steps for Back.\n  const [openId, setOpenId] = useSearchParamState<number | null>(\"row\", null, ROW_PARAM);\n  const { pathname, search } = useLocation();\n  // Through the router, so a basename (and a hash router's `#`) is in the address.\n  const here = useHref({ pathname });\n  // Built from the CURRENT query, not a bare `?row=`: the table keeps its `f.*`, `sort`\n  // and `p` in the URL, and dropping them would open the new tab on an unfiltered list\n  // where the row may not be on the first page (keksdose feedback-page.tsx:145).\n  const rowHref = useCallback(\n    (row: T) => {\n      const params = new URLSearchParams(search);\n      params.set(\"row\", String(row.id));\n      return `${here}?${params.toString()}`;\n    },\n    [here, search],\n  );\n\n  // A thumb gesture on one screen, not a view worth linking to (§4.3; keksdose live #330).\n  const [awaiting, setAwaiting] = useState(false);\n  const shown = useMemo(\n    () => (editable && awaiting ? rows.filter((row) => isFeedbackAwaiting(row.status)) : [...rows]).sort(newestFirst),\n    [rows, editable, awaiting],\n  );\n\n  const kitColumns = useFeedbackColumns<T>({\n    mine,\n    canEdit,\n    onStatus: changeStatus,\n    renderDate,\n    commit,\n    votes,\n    pageLinkExclude,\n    labels,\n  });\n  const columns = useMemo(() => (ownColumns ? ownColumns(kitColumns) : kitColumns), [ownColumns, kitColumns]);\n  const mobileGroupBy = useMemo(() => feedbackMobileGroupBy(renderDate), [renderDate]);\n\n  // The rework's sending is the detail's too (keksdose, Kurvenschmiede): its editors and\n  // the public switch wait for whichever write is out.\n  const pending = Boolean(update.isPending || rework?.isPending);\n  const capture = onCaptureScreenshot ?? undefined;\n\n  const detailProps = (row: T): FeedbackRowDetailProps => ({\n    row,\n    canEdit: editable,\n    viewerId,\n    onUpdate: updateAsync,\n    pending,\n    // The page's change, not one the detail would build: the same Undo as the cell's.\n    statusChange: changeStatus,\n    onUpload,\n    fetcher,\n    onCaptureScreenshot: capture,\n    // Only the app's own: left out, the detail's \"Resolved:\" is the kit's sentence date,\n    // no weekday — as kastlan's has always been.\n    renderDate: renderDateProp,\n    pageLinkExclude,\n    onReply: reply\n      ? (body, status, attachmentUrl) =>\n          reply.mutateAsync({\n            id: row.id,\n            body,\n            ...(status ? { status } : {}),\n            ...(attachmentUrl ? { attachmentUrl } : {}),\n          })\n      : undefined,\n    // The reply's one file (§12): all three apps are on server-kit 0.18, and the reply\n    // mutation's `attachmentUrl` is in its type from the start (the B1 risk the detail's\n    // default guards against — an `onReply` that drops the file — cannot arise here).\n    replyAttachments: true,\n    replying: reply?.isPending ?? false,\n    onRework: rework\n      ? (note, attachmentUrl) => rework.mutateAsync({ id: row.id, note, ...(attachmentUrl ? { attachmentUrl } : {}) })\n      : undefined,\n    comments: threadOf(comments?.(row)),\n    onPublicChange: publicSwitch ? (next) => runMutation(updateAsync, { id: row.id, public: next }, ignore) : undefined,\n    ...detail,\n  });\n\n  const table: DataTableProps<T> = {\n    rows: shown,\n    columns,\n    rowKey: rowId,\n    storageKey: \"feedback\",\n    urlSync: true,\n    fillHeight: true,\n    rowHref,\n    // The link covers the row's first cell; a click anywhere on the row opens it — or,\n    // on the open one, closes it.\n    onRowClick: (row) => setOpenId((id) => (id === row.id ? null : row.id)),\n    isExpanded: (row) => row.id === openId,\n    expandedRow: (row) => {\n      const node = <FeedbackRowDetail {...detailProps(row)} />;\n      return renderDetail ? renderDetail(row, node) : node;\n    },\n    // §7.13: one word, also when a filter or the toggle leaves nothing; and while the\n    // first answer is out, what is happening instead.\n    empty: loading ? <LoadingState size=\"sm\" inline /> : <FeedbackEmptyState labels={labels} />,\n    mobileGroupBy,\n    mobileCard: (row) => (\n      <FeedbackMobileCard row={row} showSubmitter={editable} renderDate={renderDate} votes={votes} labels={labels} />\n    ),\n    // The admin inbox only — /my-feedback is read-only by design (keksdose #331) — and\n    // every swipe through the same Undo as a tap (§4.5, §7.10).\n    mobileSwipeActions: editable\n      ? (row) => feedbackSwipePlan(swipe, row, { change: changeStatus, labels: statusLabels })\n      : undefined,\n    // The swipes as the desktop's last column (0.46, keksdose dev#598), less what the\n    // status cell already offers.\n    desktopSwipeActions: { omit: feedbackSwipeOmitShown, name: rowTitle, ...(commit === undefined ? {} : { commit }) },\n  };\n\n  return {\n    editable,\n    title: mine ? pageLabels.myTitle : pageLabels.title,\n    openId,\n    setOpenId,\n    rowHref,\n    changeStatus,\n    awaiting,\n    setAwaiting,\n    renderDate,\n    detailProps,\n    table,\n  };\n}\n\n/* ── The component ──────────────────────────────────────────────────────────── */\n\nexport interface FeedbackInboxProps<T extends FeedbackRecord> extends UseFeedbackInboxOptions<T> {\n  /**\n   * Above the table. Default: `<PageHeader title={title} className=\"mb-4 md:shrink-0\" />`.\n   * A function gets the page's title (`feedbackPage.title` / `.myTitle`) — the app's own\n   * header: `(title) => <PageHeader size=\"compact\" title={title} data-tour=\"feedback-header\" />`.\n   * `null` for none.\n   */\n  header?: ReactNode | ((title: string) => ReactNode);\n  /** Over the inbox's `DataTable` props — `edgeFade`, `locale`, `mobileExpandAsDialog`,\n   *  `className`, another `storageKey`. Merged last, so it wins. */\n  table?: Partial<DataTableProps<T>>;\n  /** Further `FloatingAction`s on the phone: after the awaiting toggle on the inbox, in a\n   *  group of their own on `/my-feedback`. */\n  phoneActions?: ReactNode;\n  /** On the page's frame — the fill-height column (`FILL_HEIGHT_CLASS`); the app's page\n   *  padding goes here. */\n  className?: string;\n}\n\n/**\n * The feedback inbox (§13): `/feedback` and `/my-feedback` drawn whole from\n * {@link useFeedbackInbox} — the header, the table with its detail, phone cards and swipes,\n * and the phone's awaiting toggle, in the fill-height frame (page layout §1.3) — so a page\n * is its queries and this:\n *\n * ```tsx\n * export function FeedbackPage({ mine = false }: { mine?: boolean }) {\n *   const { user, isAdmin } = useAuth();\n *   const list = useQuery({ queryKey: mine ? keys.mine : keys.all, queryFn: mine ? api.mine : api.all });\n *   const update = useFeedbackUpdate();\n *   const reply = useFeedbackReply();\n *   const rework = useFeedbackRework();\n *   if (!mine && !isAdmin) return <Navigate to=\"/my-feedback\" replace />;\n *   return (\n *     <FeedbackInbox\n *       rows={list.data ?? []} loading={list.isPending} mine={mine} canEdit={isAdmin} viewerId={user?.id}\n *       update={update} reply={reply} rework={rework}\n *       onUpload={api.upload} fetcher={api.file}\n *     />\n *   );\n * }\n * ```\n *\n * Every slot is {@link UseFeedbackInboxOptions}' or one of the four below. The redirect of\n * a non-admin, the routes and the queries stay the app's.\n */\nexport function FeedbackInbox<T extends FeedbackRecord>({\n  header,\n  table,\n  phoneActions,\n  className,\n  ...options\n}: FeedbackInboxProps<T>) {\n  const inbox = useFeedbackInbox<T>(options);\n  const pageLabels = useFeedbackPageLabels(options.labels);\n  const head =\n    header === undefined ? (\n      <PageHeader title={inbox.title} className=\"mb-4 md:shrink-0\" />\n    ) : typeof header === \"function\" ? (\n      header(inbox.title)\n    ) : (\n      header\n    );\n  return (\n    // A plain element on the way to the table carries the fill (page layout §1.3).\n    <div className={cn(FILL_HEIGHT_CLASS, className)} aria-busy={options.loading || undefined} data-feedback-inbox=\"\">\n      {head}\n      <DataTable {...inbox.table} {...table} />\n      {inbox.editable ? (\n        // The phone's floating action (keksdose feedback #58): only on the inbox — on\n        // /my-feedback the author is not waiting on their own verdict.\n        <FeedbackAwaitingToggle pressed={inbox.awaiting} onPressedChange={inbox.setAwaiting} labels={options.labels}>\n          {phoneActions}\n        </FeedbackAwaitingToggle>\n      ) : (\n        phoneActions && (\n          <FloatingActionGroup aria-label={pageLabels.phoneActions} className=\"md:hidden\">\n            {phoneActions}\n          </FloatingActionGroup>\n        )\n      )}\n    </div>\n  );\n}\n"],"mappings":";AA2ZmB,cAsGf,YAtGe;AA3ZnB,SAAS,aAAa,SAAS,gBAAgB;AAE/C,SAAS,SAAS,mBAAmB;AACrC,SAAS,UAAU;AACnB,SAAS,iBAA4D;AACrE,SAAS,2BAA2B;AACpC,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAG3B,SAAS,2BAA2B;AAGpC,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AACrC,SAAS,+BAA+B;AACxC,SAAS,mBAAmB;AAE5B;AAAA,EACE;AAAA,OAIK;AACP,SAAS,6BAAwD;AACjE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AA4MP,SAAS,WAAW,KAAiC;AACnD,MAAI,CAAC,aAAa,KAAK,GAAG,EAAG,QAAO;AACpC,QAAM,KAAK,OAAO,GAAG;AACrB,SAAO,OAAO,cAAc,EAAE,IAAI,KAAK;AACzC;AAEA,MAAM,YAAY,EAAE,OAAO,YAAY,SAAS,UAAU;AAK1D,MAAM,cAAc,CAAC,GAAmB,MACtC,EAAE,aAAa,EAAE,aAAa,IAAI,EAAE,aAAa,EAAE,aAAa,KAAK;AAEvE,MAAM,QAAQ,CAAC,QAAwB,IAAI;AAC3C,MAAM,WAAW,CAAC,QAAwB,IAAI;AAC9C,MAAM,oBAAoB,MAAM,qBAAqB;AACrD,MAAM,SAAS,MAAM;AAAC;AAGtB,MAAM,WAAW,CAAC,SAAgC,SAAS,SAAS,SAAS,KAAK,SAAY;AAgBvF,SAAS,iBAA2C;AAAA,EACzD;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA,sBAAsB;AAAA,EACtB,YAAY;AAAA,EACZ;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA;AACF,GAAsD;AAEpD,QAAM,WAAW,WAAW,CAAC;AAC7B,QAAM,aAAa,sBAAsB,MAAM;AAC/C,QAAM,eAAe,wBAAwB;AAC7C,QAAM,aAAa,sBAAsB,cAAc;AAIvD,QAAM,cAAc,OAAO;AAC3B,QAAM,eAAe,sBAAsB,WAAW;AAKtD,QAAM,CAAC,QAAQ,SAAS,IAAI,oBAAmC,OAAO,MAAM,SAAS;AACrF,QAAM,EAAE,UAAU,OAAO,IAAI,YAAY;AAEzC,QAAM,OAAO,QAAQ,EAAE,SAAS,CAAC;AAIjC,QAAM,UAAU;AAAA,IACd,CAAC,QAAW;AACV,YAAM,SAAS,IAAI,gBAAgB,MAAM;AACzC,aAAO,IAAI,OAAO,OAAO,IAAI,EAAE,CAAC;AAChC,aAAO,GAAG,IAAI,IAAI,OAAO,SAAS,CAAC;AAAA,IACrC;AAAA,IACA,CAAC,MAAM,MAAM;AAAA,EACf;AAGA,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,KAAK;AAC9C,QAAM,QAAQ;AAAA,IACZ,OAAO,YAAY,WAAW,KAAK,OAAO,CAAC,QAAQ,mBAAmB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,WAAW;AAAA,IAChH,CAAC,MAAM,UAAU,QAAQ;AAAA,EAC3B;AAEA,QAAM,aAAa,mBAAsB;AAAA,IACvC;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,UAAU,QAAQ,MAAO,aAAa,WAAW,UAAU,IAAI,YAAa,CAAC,YAAY,UAAU,CAAC;AAC1G,QAAM,gBAAgB,QAAQ,MAAM,sBAAsB,UAAU,GAAG,CAAC,UAAU,CAAC;AAInF,QAAM,UAAU,QAAQ,OAAO,aAAa,QAAQ,SAAS;AAC7D,QAAM,UAAU,uBAAuB;AAEvC,QAAM,cAAc,CAAC,SAAoC;AAAA,IACvD;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA,UAAU;AAAA,IACV;AAAA;AAAA,IAEA,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA,qBAAqB;AAAA;AAAA;AAAA,IAGrB,YAAY;AAAA,IACZ;AAAA,IACA,SAAS,QACL,CAAC,MAAM,QAAQ,kBACb,MAAM,YAAY;AAAA,MAChB,IAAI,IAAI;AAAA,MACR;AAAA,MACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,MAC3B,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC;AAAA,IAC3C,CAAC,IACH;AAAA;AAAA;AAAA;AAAA,IAIJ,kBAAkB;AAAA,IAClB,UAAU,OAAO,aAAa;AAAA,IAC9B,UAAU,SACN,CAAC,MAAM,kBAAkB,OAAO,YAAY,EAAE,IAAI,IAAI,IAAI,MAAM,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC,EAAG,CAAC,IAC7G;AAAA,IACJ,UAAU,SAAS,WAAW,GAAG,CAAC;AAAA,IAClC,gBAAgB,eAAe,CAAC,SAAS,YAAY,aAAa,EAAE,IAAI,IAAI,IAAI,QAAQ,KAAK,GAAG,MAAM,IAAI;AAAA,IAC1G,GAAG;AAAA,EACL;AAEA,QAAM,QAA2B;AAAA,IAC/B,MAAM;AAAA,IACN;AAAA,IACA,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,YAAY;AAAA,IACZ;AAAA;AAAA;AAAA,IAGA,YAAY,CAAC,QAAQ,UAAU,CAAC,OAAQ,OAAO,IAAI,KAAK,OAAO,IAAI,EAAG;AAAA,IACtE,YAAY,CAAC,QAAQ,IAAI,OAAO;AAAA,IAChC,aAAa,CAAC,QAAQ;AACpB,YAAM,OAAO,oBAAC,qBAAmB,GAAG,YAAY,GAAG,GAAG;AACtD,aAAO,eAAe,aAAa,KAAK,IAAI,IAAI;AAAA,IAClD;AAAA;AAAA;AAAA,IAGA,OAAO,UAAU,oBAAC,gBAAa,MAAK,MAAK,QAAM,MAAC,IAAK,oBAAC,sBAAmB,QAAgB;AAAA,IACzF;AAAA,IACA,YAAY,CAAC,QACX,oBAAC,sBAAmB,KAAU,eAAe,UAAU,YAAwB,OAAc,QAAgB;AAAA;AAAA;AAAA,IAI/G,oBAAoB,WAChB,CAAC,QAAQ,kBAAkB,OAAO,KAAK,EAAE,QAAQ,cAAc,QAAQ,aAAa,CAAC,IACrF;AAAA;AAAA;AAAA,IAGJ,qBAAqB,EAAE,MAAM,wBAAwB,MAAM,UAAU,GAAI,WAAW,SAAY,CAAC,IAAI,EAAE,OAAO,EAAG;AAAA,EACnH;AAEA,SAAO;AAAA,IACL;AAAA,IACA,OAAO,OAAO,WAAW,UAAU,WAAW;AAAA,IAC9C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAkDO,SAAS,cAAwC;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAA0B;AACxB,QAAM,QAAQ,iBAAoB,OAAO;AACzC,QAAM,aAAa,sBAAsB,QAAQ,MAAM;AACvD,QAAM,OACJ,WAAW,SACT,oBAAC,cAAW,OAAO,MAAM,OAAO,WAAU,oBAAmB,IAC3D,OAAO,WAAW,aACpB,OAAO,MAAM,KAAK,IAElB;AAEJ;AAAA;AAAA,IAEE,qBAAC,SAAI,WAAW,GAAG,mBAAmB,SAAS,GAAG,aAAW,QAAQ,WAAW,QAAW,uBAAoB,IAC5G;AAAA;AAAA,MACD,oBAAC,aAAW,GAAG,MAAM,OAAQ,GAAG,OAAO;AAAA,MACtC,MAAM;AAAA;AAAA;AAAA,QAGL,oBAAC,0BAAuB,SAAS,MAAM,UAAU,iBAAiB,MAAM,aAAa,QAAQ,QAAQ,QAClG,wBACH;AAAA,UAEA,gBACE,oBAAC,uBAAoB,cAAY,WAAW,cAAc,WAAU,aACjE,wBACH;AAAA,OAGN;AAAA;AAEJ;","names":[]}

package/dist/feedback/feedback-vocabulary.js

@@ -70,8 +70,8 @@ const FEEDBACK_STATUS_META = {
   },
   // The one status with nowhere to move to: the vocabulary has a brand, an info, a
   // warning and a danger, and nothing that means "succeeded". Deliberately NOT
-  // borrowed from a family that means something else — `--status-synced` is a
-  // FIELD's trip to the database rather than an outcome, and tokens.css says so in
+  // borrowed from a colour that means something else — a field's "saved" is a trip
+  // to the database rather than an outcome, and tokens.css's `--success` says so in
   // as many words. Green beside WONT_DO's red is the classic CVD-unsafe pair, which
   // is why both carry a glyph and neither leans on colour alone.
   DONE: {

package/dist/feedback/feedback-vocabulary.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/feedback-vocabulary.ts"],"sourcesContent":["import {\n  Ban,\n  Bug,\n  CheckCircle2,\n  ClipboardCheck,\n  CloudUpload,\n  Eye,\n  HelpCircle,\n  Inbox,\n  Lightbulb,\n  MoreHorizontal,\n  OctagonAlert,\n  PauseCircle,\n  RotateCcw,\n  Wrench,\n} from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\n\n/**\n * The feedback **vocabulary**: the nine statuses and five categories, the glyph and tone\n * of each, their orders, and the policy for how a report moves from status to status.\n *\n * Data and plain functions, no components. Until 0.34 this lived at the top of\n * feedback-inbox.tsx, so the feedback menu every app mounts in its top bar imported the\n * inbox — its components and the attachment field they render — for one constant (a\n * category's glyph), and only tree-shaking kept the rest out of every app's entry chunk.\n * From here the top bar's imports reach none of it (MOD-1, refactor audit 2026-10).\n * feedback-inbox.tsx re-exports every name here, so nothing an app imports has moved.\n */\n\n/** The nine states a report can be in.\n *\n *  Shared value for value across the apps on purpose: it is what lets one habit,\n *  and one agent prompt, work on any repo. Five are a chain and three sit off\n *  it — see {@link visibleFeedbackStatuses} for what that buys. `READY` joined in 0.31\n *  (feedback contract §8.2): OPEN is \"filed, not yet triaged\", READY \"released for\n *  implementation\", and nobody works an OPEN row. `REWORK` joined in 0.40 (§10.2\n *  decisions 2, 4): \"sent back, released for work again\" — a READY that came back. */\nexport type FeedbackStatus =\n  \"OPEN\" | \"READY\" | \"REWORK\" | \"IN_PROGRESS\" | \"IN_EVALUATION\" | \"NEEDS_LIVE_TEST\" | \"POSTPONED\" | \"DONE\" | \"WONT_DO\";\n\n/** What a report is about. `CRASH` is filed by an error boundary and never\n *  chosen, which is exactly why it is loud below and absent from every picker. */\nexport type FeedbackCategory = \"CRASH\" | \"BUG\" | \"IDEA\" | \"QUESTION\" | \"OTHER\";\n\n/**\n * A glyph and a tone per status.\n *\n * Colour alone is not a label — two of these sit a hue apart, and a consumer who\n * moves `--brand` can park it beside any of the others — so every status carries\n * its own shape as well. Declaration order is chain order, and\n * {@link FEEDBACK_STATUS_ORDER} is derived from it rather than restated, because\n * a restated list cannot be checked for exhaustiveness: an eighth status would\n * break the build here and leave a literal eight long (as READY did in 0.31).\n */\nexport const FEEDBACK_STATUS_META: Record<FeedbackStatus, { icon: LucideIcon; activeBg: string; activeText: string }> =\n  {\n    OPEN: {\n      icon: Inbox,\n      activeBg: \"bg-active\",\n      activeText: \"text-primary\",\n    },\n    // Triaged and released for implementation (feedback contract §8.2, keksdose live\n    // #396): OPEN is \"filed, nobody has looked yet\", READY is \"go\". The brand tint at full\n    // strength, so it reads as the go-ahead beside OPEN's neutral fill and\n    // NEEDS_LIVE_TEST's muted brand.\n    READY: {\n      icon: ClipboardCheck,\n      activeBg: \"bg-brand-soft\",\n      activeText: \"text-brand\",\n    },\n    // Sent back by its author or an admin and released for work again (0.40, feedback\n    // contract §10.2 decision 4): the Rework button's `RotateCcw`, in the danger tint so the\n    // queue shows reworks apart from new reports. Not IN_PROGRESS's warning tint — that is\n    // where a REWORK row moves next — and WONT_DO, the only other red, sits at the far end\n    // with `Ban`.\n    REWORK: {\n      icon: RotateCcw,\n      activeBg: \"bg-danger-soft\",\n      activeText: \"text-danger\",\n    },\n    IN_PROGRESS: {\n      icon: Wrench,\n      activeBg: \"bg-warning-soft\",\n      activeText: \"text-warning\",\n    },\n    // Where solved work is parked, waiting on the person who reported it. Its own\n    // colour, because \"somebody has to check this\" is a state you want to find by\n    // scanning rather than by reading.\n    IN_EVALUATION: {\n      icon: Eye,\n      activeBg: \"bg-info-soft\",\n      activeText: \"text-info\",\n    },\n    // Resolved but only checkable on a deployed build — the SOFT brand tint, so it\n    // reads as \"waiting on something\" rather than as a done or a refusal, and it\n    // follows whatever the consumer's brand is instead of pinning an indigo island\n    // beside it.\n    NEEDS_LIVE_TEST: {\n      icon: CloudUpload,\n      activeBg: \"bg-brand-soft\",\n      activeText: \"text-brand-muted\",\n    },\n    // Parked on purpose. Muted, not `--danger`: it is not a refusal.\n    POSTPONED: {\n      icon: PauseCircle,\n      activeBg: \"bg-active\",\n      activeText: \"text-secondary\",\n    },\n    // The one status with nowhere to move to: the vocabulary has a brand, an info, a\n    // warning and a danger, and nothing that means \"succeeded\". Deliberately NOT\n    // borrowed from a family that means something else — `--status-synced` is a\n    // FIELD's trip to the database rather than an outcome, and tokens.css says so in\n    // as many words. Green beside WONT_DO's red is the classic CVD-unsafe pair, which\n    // is why both carry a glyph and neither leans on colour alone.\n    DONE: {\n      icon: CheckCircle2,\n      activeBg: \"bg-success-soft\",\n      activeText: \"text-success\",\n    },\n    WONT_DO: {\n      icon: Ban,\n      activeBg: \"bg-danger-soft\",\n      activeText: \"text-danger\",\n    },\n  };\n\n/** Chain order, then the three off it. The order a picker offers, and the rank a\n *  status column sorts by — so a list sorted by status reads as a queue rather\n *  than as an alphabet. */\nexport const FEEDBACK_STATUS_ORDER = Object.keys(FEEDBACK_STATUS_META) as FeedbackStatus[];\n\n/** States that sit OFF the linear chain: reachable from anywhere, leading\n *  nowhere by themselves. `WONT_DO` has always worked this way; `POSTPONED`\n *  (\"not now\") and `NEEDS_LIVE_TEST` (\"resolved, but only provable on a deployed\n *  build\") are the same shape — a row can be parked or handed to the next deploy\n *  from any point, and comes back to the chain when somebody picks a real state\n *  for it.\n *\n *  Kept out of the forward chain deliberately: putting them in it would mean an\n *  \"advance\" gesture could park an item, and every row would have to pass\n *  through them to reach `DONE`. */\nconst OFF_CHAIN: FeedbackStatus[] = [\"NEEDS_LIVE_TEST\", \"POSTPONED\", \"WONT_DO\"];\n\nconst FORWARD_CHAIN: FeedbackStatus[] = [\"OPEN\", \"READY\", \"IN_PROGRESS\", \"IN_EVALUATION\", \"DONE\"];\n\n/** The next status along the chain, or null at the end (or off it, as `WONT_DO`\n *  is). What a swipe-to-advance gesture commits. `REWORK` (0.40) is not in the chain —\n *  \"advance\" from READY still goes to IN_PROGRESS — but it leads there too: a reworked\n *  row is READY's twin. */\nexport function nextFeedbackStatus(current: FeedbackStatus): FeedbackStatus | null {\n  if (current === \"REWORK\") return \"IN_PROGRESS\";\n  const at = FORWARD_CHAIN.indexOf(current);\n  return at !== -1 && at < FORWARD_CHAIN.length - 1 ? FORWARD_CHAIN[at + 1] : null;\n}\n\n/**\n * The steps that make sense from where a row currently stands.\n *\n * For the compact control in a table cell: it is a glanceable triage affordance,\n * and a row of nine icons in a cell is noise. One step forward, one step back\n * (so an item can be sent back for rework), and any of the three off-chain\n * verdicts — which is what makes those usable as verdicts at all.\n *\n * The two parking states are not dead ends: each offers the step that resumes\n * work and the ones that close it, but deliberately **not each other** —\n * \"postponed\" and \"waiting on a deploy\" are different answers to different\n * questions, and a row moving between them directly is a re-triage, which starts\n * by picking the work back up.\n */\nexport function visibleFeedbackStatuses(current: FeedbackStatus): FeedbackStatus[] {\n  const set = new Set<FeedbackStatus>([current]);\n  const at = FORWARD_CHAIN.indexOf(current);\n  if (current === \"REWORK\") {\n    // READY's twin (0.40, §10.2 decision 4): the step that picks the work up, and the\n    // verdicts a released row can still get.\n    set.add(\"IN_PROGRESS\");\n    for (const off of OFF_CHAIN) set.add(off);\n  } else if (at !== -1) {\n    if (at < FORWARD_CHAIN.length - 1) set.add(FORWARD_CHAIN[at + 1]);\n    if (at > 0) set.add(FORWARD_CHAIN[at - 1]);\n    for (const off of OFF_CHAIN) set.add(off);\n  } else if (current !== \"WONT_DO\") {\n    set.add(\"IN_PROGRESS\");\n    set.add(\"DONE\");\n    set.add(\"WONT_DO\");\n  }\n  // WONT_DO falls through with nothing added: it stays terminal, reopened by a\n  // note from its author rather than by a status pill.\n  return FEEDBACK_STATUS_ORDER.filter((status) => set.has(status));\n}\n\n/**\n * Every status, in chain order — what an EXPANDED row offers.\n *\n * {@link visibleFeedbackStatuses} narrows the choice to the steps that make\n * sense from where a row is, which is right for a table cell. Once the row is\n * open in front of you, that same narrowing turns every non-adjacent move into a\n * walk: OPEN to DONE meant three round trips, and WONT_DO could not be left at\n * all except through a rework note.\n *\n * Takes a `current` it does not use, so the two policies read as one pair at the\n * call sites and a future rule (\"terminal rows still cannot jump to X\") has a\n * place to live.\n */\nexport function selectableFeedbackStatuses(_current: FeedbackStatus): FeedbackStatus[] {\n  return [...FEEDBACK_STATUS_ORDER];\n}\n\n/**\n * Per-category badge treatment, the counterpart to the status meta above.\n *\n * A category cell that is one grey pill holding the raw enum makes a CRASH —\n * filed automatically, by somebody staring at a broken page right now — read\n * exactly like a QUESTION, and sit unnoticed in the queue. `--danger` plus its own\n * glyph is what makes that impossible; the hand-filed categories stay\n * deliberately quiet so that the loud one means something.\n *\n * Declaration order is triage order, CRASH first.\n */\nexport const FEEDBACK_CATEGORY_META: Record<\n  FeedbackCategory,\n  { icon: LucideIcon; badgeBg: string; badgeText: string }\n> = {\n  CRASH: {\n    icon: OctagonAlert,\n    badgeBg: \"bg-danger-soft\",\n    badgeText: \"text-danger\",\n  },\n  BUG: {\n    icon: Bug,\n    badgeBg: \"bg-warning-soft\",\n    badgeText: \"text-warning\",\n  },\n  IDEA: {\n    icon: Lightbulb,\n    badgeBg: \"bg-surface-2\",\n    badgeText: \"text-secondary\",\n  },\n  QUESTION: {\n    icon: HelpCircle,\n    badgeBg: \"bg-surface-2\",\n    badgeText: \"text-secondary\",\n  },\n  OTHER: {\n    icon: MoreHorizontal,\n    badgeBg: \"bg-surface-2\",\n    badgeText: \"text-secondary\",\n  },\n};\n\n/** Triage order, CRASH first — also a category column's sort key and the option\n *  order in its filter. Sorting by the raw enum is alphabetical, which parks\n *  CRASH between BUG and IDEA. */\nexport const FEEDBACK_CATEGORY_ORDER = Object.keys(FEEDBACK_CATEGORY_META) as FeedbackCategory[];\n\n/** A category's rank for a column sort. Anything this build has never heard of —\n *  an older client against a newer API — sorts LAST rather than to `indexOf`'s\n *  −1, which would rank it above CRASH. */\nexport function feedbackCategoryRank(category: FeedbackCategory): number {\n  const at = FEEDBACK_CATEGORY_ORDER.indexOf(category);\n  return at === -1 ? FEEDBACK_CATEGORY_ORDER.length : at;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/feedback/feedback-vocabulary.ts"],"sourcesContent":["import {\n  Ban,\n  Bug,\n  CheckCircle2,\n  ClipboardCheck,\n  CloudUpload,\n  Eye,\n  HelpCircle,\n  Inbox,\n  Lightbulb,\n  MoreHorizontal,\n  OctagonAlert,\n  PauseCircle,\n  RotateCcw,\n  Wrench,\n} from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\n\n/**\n * The feedback **vocabulary**: the nine statuses and five categories, the glyph and tone\n * of each, their orders, and the policy for how a report moves from status to status.\n *\n * Data and plain functions, no components. Until 0.34 this lived at the top of\n * feedback-inbox.tsx, so the feedback menu every app mounts in its top bar imported the\n * inbox — its components and the attachment field they render — for one constant (a\n * category's glyph), and only tree-shaking kept the rest out of every app's entry chunk.\n * From here the top bar's imports reach none of it (MOD-1, refactor audit 2026-10).\n * feedback-inbox.tsx re-exports every name here, so nothing an app imports has moved.\n */\n\n/** The nine states a report can be in.\n *\n *  Shared value for value across the apps on purpose: it is what lets one habit,\n *  and one agent prompt, work on any repo. Five are a chain and three sit off\n *  it — see {@link visibleFeedbackStatuses} for what that buys. `READY` joined in 0.31\n *  (feedback contract §8.2): OPEN is \"filed, not yet triaged\", READY \"released for\n *  implementation\", and nobody works an OPEN row. `REWORK` joined in 0.40 (§10.2\n *  decisions 2, 4): \"sent back, released for work again\" — a READY that came back. */\nexport type FeedbackStatus =\n  \"OPEN\" | \"READY\" | \"REWORK\" | \"IN_PROGRESS\" | \"IN_EVALUATION\" | \"NEEDS_LIVE_TEST\" | \"POSTPONED\" | \"DONE\" | \"WONT_DO\";\n\n/** What a report is about. `CRASH` is filed by an error boundary and never\n *  chosen, which is exactly why it is loud below and absent from every picker. */\nexport type FeedbackCategory = \"CRASH\" | \"BUG\" | \"IDEA\" | \"QUESTION\" | \"OTHER\";\n\n/**\n * A glyph and a tone per status.\n *\n * Colour alone is not a label — two of these sit a hue apart, and a consumer who\n * moves `--brand` can park it beside any of the others — so every status carries\n * its own shape as well. Declaration order is chain order, and\n * {@link FEEDBACK_STATUS_ORDER} is derived from it rather than restated, because\n * a restated list cannot be checked for exhaustiveness: an eighth status would\n * break the build here and leave a literal eight long (as READY did in 0.31).\n */\nexport const FEEDBACK_STATUS_META: Record<FeedbackStatus, { icon: LucideIcon; activeBg: string; activeText: string }> =\n  {\n    OPEN: {\n      icon: Inbox,\n      activeBg: \"bg-active\",\n      activeText: \"text-primary\",\n    },\n    // Triaged and released for implementation (feedback contract §8.2, keksdose live\n    // #396): OPEN is \"filed, nobody has looked yet\", READY is \"go\". The brand tint at full\n    // strength, so it reads as the go-ahead beside OPEN's neutral fill and\n    // NEEDS_LIVE_TEST's muted brand.\n    READY: {\n      icon: ClipboardCheck,\n      activeBg: \"bg-brand-soft\",\n      activeText: \"text-brand\",\n    },\n    // Sent back by its author or an admin and released for work again (0.40, feedback\n    // contract §10.2 decision 4): the Rework button's `RotateCcw`, in the danger tint so the\n    // queue shows reworks apart from new reports. Not IN_PROGRESS's warning tint — that is\n    // where a REWORK row moves next — and WONT_DO, the only other red, sits at the far end\n    // with `Ban`.\n    REWORK: {\n      icon: RotateCcw,\n      activeBg: \"bg-danger-soft\",\n      activeText: \"text-danger\",\n    },\n    IN_PROGRESS: {\n      icon: Wrench,\n      activeBg: \"bg-warning-soft\",\n      activeText: \"text-warning\",\n    },\n    // Where solved work is parked, waiting on the person who reported it. Its own\n    // colour, because \"somebody has to check this\" is a state you want to find by\n    // scanning rather than by reading.\n    IN_EVALUATION: {\n      icon: Eye,\n      activeBg: \"bg-info-soft\",\n      activeText: \"text-info\",\n    },\n    // Resolved but only checkable on a deployed build — the SOFT brand tint, so it\n    // reads as \"waiting on something\" rather than as a done or a refusal, and it\n    // follows whatever the consumer's brand is instead of pinning an indigo island\n    // beside it.\n    NEEDS_LIVE_TEST: {\n      icon: CloudUpload,\n      activeBg: \"bg-brand-soft\",\n      activeText: \"text-brand-muted\",\n    },\n    // Parked on purpose. Muted, not `--danger`: it is not a refusal.\n    POSTPONED: {\n      icon: PauseCircle,\n      activeBg: \"bg-active\",\n      activeText: \"text-secondary\",\n    },\n    // The one status with nowhere to move to: the vocabulary has a brand, an info, a\n    // warning and a danger, and nothing that means \"succeeded\". Deliberately NOT\n    // borrowed from a colour that means something else — a field's \"saved\" is a trip\n    // to the database rather than an outcome, and tokens.css's `--success` says so in\n    // as many words. Green beside WONT_DO's red is the classic CVD-unsafe pair, which\n    // is why both carry a glyph and neither leans on colour alone.\n    DONE: {\n      icon: CheckCircle2,\n      activeBg: \"bg-success-soft\",\n      activeText: \"text-success\",\n    },\n    WONT_DO: {\n      icon: Ban,\n      activeBg: \"bg-danger-soft\",\n      activeText: \"text-danger\",\n    },\n  };\n\n/** Chain order, then the three off it. The order a picker offers, and the rank a\n *  status column sorts by — so a list sorted by status reads as a queue rather\n *  than as an alphabet. */\nexport const FEEDBACK_STATUS_ORDER = Object.keys(FEEDBACK_STATUS_META) as FeedbackStatus[];\n\n/** States that sit OFF the linear chain: reachable from anywhere, leading\n *  nowhere by themselves. `WONT_DO` has always worked this way; `POSTPONED`\n *  (\"not now\") and `NEEDS_LIVE_TEST` (\"resolved, but only provable on a deployed\n *  build\") are the same shape — a row can be parked or handed to the next deploy\n *  from any point, and comes back to the chain when somebody picks a real state\n *  for it.\n *\n *  Kept out of the forward chain deliberately: putting them in it would mean an\n *  \"advance\" gesture could park an item, and every row would have to pass\n *  through them to reach `DONE`. */\nconst OFF_CHAIN: FeedbackStatus[] = [\"NEEDS_LIVE_TEST\", \"POSTPONED\", \"WONT_DO\"];\n\nconst FORWARD_CHAIN: FeedbackStatus[] = [\"OPEN\", \"READY\", \"IN_PROGRESS\", \"IN_EVALUATION\", \"DONE\"];\n\n/** The next status along the chain, or null at the end (or off it, as `WONT_DO`\n *  is). What a swipe-to-advance gesture commits. `REWORK` (0.40) is not in the chain —\n *  \"advance\" from READY still goes to IN_PROGRESS — but it leads there too: a reworked\n *  row is READY's twin. */\nexport function nextFeedbackStatus(current: FeedbackStatus): FeedbackStatus | null {\n  if (current === \"REWORK\") return \"IN_PROGRESS\";\n  const at = FORWARD_CHAIN.indexOf(current);\n  return at !== -1 && at < FORWARD_CHAIN.length - 1 ? FORWARD_CHAIN[at + 1] : null;\n}\n\n/**\n * The steps that make sense from where a row currently stands.\n *\n * For the compact control in a table cell: it is a glanceable triage affordance,\n * and a row of nine icons in a cell is noise. One step forward, one step back\n * (so an item can be sent back for rework), and any of the three off-chain\n * verdicts — which is what makes those usable as verdicts at all.\n *\n * The two parking states are not dead ends: each offers the step that resumes\n * work and the ones that close it, but deliberately **not each other** —\n * \"postponed\" and \"waiting on a deploy\" are different answers to different\n * questions, and a row moving between them directly is a re-triage, which starts\n * by picking the work back up.\n */\nexport function visibleFeedbackStatuses(current: FeedbackStatus): FeedbackStatus[] {\n  const set = new Set<FeedbackStatus>([current]);\n  const at = FORWARD_CHAIN.indexOf(current);\n  if (current === \"REWORK\") {\n    // READY's twin (0.40, §10.2 decision 4): the step that picks the work up, and the\n    // verdicts a released row can still get.\n    set.add(\"IN_PROGRESS\");\n    for (const off of OFF_CHAIN) set.add(off);\n  } else if (at !== -1) {\n    if (at < FORWARD_CHAIN.length - 1) set.add(FORWARD_CHAIN[at + 1]);\n    if (at > 0) set.add(FORWARD_CHAIN[at - 1]);\n    for (const off of OFF_CHAIN) set.add(off);\n  } else if (current !== \"WONT_DO\") {\n    set.add(\"IN_PROGRESS\");\n    set.add(\"DONE\");\n    set.add(\"WONT_DO\");\n  }\n  // WONT_DO falls through with nothing added: it stays terminal, reopened by a\n  // note from its author rather than by a status pill.\n  return FEEDBACK_STATUS_ORDER.filter((status) => set.has(status));\n}\n\n/**\n * Every status, in chain order — what an EXPANDED row offers.\n *\n * {@link visibleFeedbackStatuses} narrows the choice to the steps that make\n * sense from where a row is, which is right for a table cell. Once the row is\n * open in front of you, that same narrowing turns every non-adjacent move into a\n * walk: OPEN to DONE meant three round trips, and WONT_DO could not be left at\n * all except through a rework note.\n *\n * Takes a `current` it does not use, so the two policies read as one pair at the\n * call sites and a future rule (\"terminal rows still cannot jump to X\") has a\n * place to live.\n */\nexport function selectableFeedbackStatuses(_current: FeedbackStatus): FeedbackStatus[] {\n  return [...FEEDBACK_STATUS_ORDER];\n}\n\n/**\n * Per-category badge treatment, the counterpart to the status meta above.\n *\n * A category cell that is one grey pill holding the raw enum makes a CRASH —\n * filed automatically, by somebody staring at a broken page right now — read\n * exactly like a QUESTION, and sit unnoticed in the queue. `--danger` plus its own\n * glyph is what makes that impossible; the hand-filed categories stay\n * deliberately quiet so that the loud one means something.\n *\n * Declaration order is triage order, CRASH first.\n */\nexport const FEEDBACK_CATEGORY_META: Record<\n  FeedbackCategory,\n  { icon: LucideIcon; badgeBg: string; badgeText: string }\n> = {\n  CRASH: {\n    icon: OctagonAlert,\n    badgeBg: \"bg-danger-soft\",\n    badgeText: \"text-danger\",\n  },\n  BUG: {\n    icon: Bug,\n    badgeBg: \"bg-warning-soft\",\n    badgeText: \"text-warning\",\n  },\n  IDEA: {\n    icon: Lightbulb,\n    badgeBg: \"bg-surface-2\",\n    badgeText: \"text-secondary\",\n  },\n  QUESTION: {\n    icon: HelpCircle,\n    badgeBg: \"bg-surface-2\",\n    badgeText: \"text-secondary\",\n  },\n  OTHER: {\n    icon: MoreHorizontal,\n    badgeBg: \"bg-surface-2\",\n    badgeText: \"text-secondary\",\n  },\n};\n\n/** Triage order, CRASH first — also a category column's sort key and the option\n *  order in its filter. Sorting by the raw enum is alphabetical, which parks\n *  CRASH between BUG and IDEA. */\nexport const FEEDBACK_CATEGORY_ORDER = Object.keys(FEEDBACK_CATEGORY_META) as FeedbackCategory[];\n\n/** A category's rank for a column sort. Anything this build has never heard of —\n *  an older client against a newer API — sorts LAST rather than to `indexOf`'s\n *  −1, which would rank it above CRASH. */\nexport function feedbackCategoryRank(category: FeedbackCategory): number {\n  const at = FEEDBACK_CATEGORY_ORDER.indexOf(category);\n  return at === -1 ? FEEDBACK_CATEGORY_ORDER.length : at;\n}\n"],"mappings":"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","names":[]}

package/dist/feedback.d.ts

@@ -20,3 +20,4 @@ export * from "./feedback/feedback-vote-button.js";
 export * from "./feedback/feedback-comment-thread.js";
 export * from "./feedback/feedback-replies.js";
 export * from "./feedback/feedback-entry-file.js";
+export { useFeedbackInbox, FeedbackInbox, type FeedbackInboxMutation, type FeedbackReplyPost, type FeedbackReworkPost, type UseFeedbackInboxOptions, type FeedbackInboxState, type FeedbackInboxProps, } from "./feedback/feedback-inbox-page.js";