@eifi1/ui-kit 0.37.0 → 0.38.1

package/dist/feedback/feedback-public-list.js

@@ -0,0 +1,299 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { ChevronLeft, ChevronRight, MessageSquare, ThumbsUp } from "lucide-react";
+import { DataTable } from "../components/data-table.js";
+import { DEFAULT_DATA_TABLE_LABELS } from "../components/data-table-labels.js";
+import { IconButton } from "../components/icon-button.js";
+import { SearchField } from "../components/search-field.js";
+import { ToggleGroup } from "../components/toggle-group.js";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { cn } from "../lib/cn.js";
+import { EMPTY_FORMATTED_VALUE } from "../lib/format.js";
+import { FeedbackCategoryBadge, FeedbackDetail, FeedbackDetailSection, FeedbackProse, FeedbackStatusBadge } from "./feedback-inbox.js";
+import { useFeedbackCategoryLabels } from "./feedback-labels.js";
+import { FeedbackCommentThread } from "./feedback-comment-thread.js";
+import { DEFAULT_FEEDBACK_PUBLIC_LABELS } from "./feedback-public-labels.js";
+import {
+  useFeedbackPageLabels,
+  useFeedbackRenderDate
+} from "./feedback-table.js";
+import { FeedbackVoteButton } from "./feedback-vote-button.js";
+function useFeedbackPublicLabels(labels) {
+  return useKitLabels("feedbackPublic", DEFAULT_FEEDBACK_PUBLIC_LABELS, labels);
+}
+const SORTS = ["newest", "votes", "updated"];
+function PublicDate({ value, renderDate }) {
+  if (!value) return /* @__PURE__ */ jsx("span", { className: "text-placeholder", children: EMPTY_FORMATTED_VALUE });
+  return /* @__PURE__ */ jsx("time", { dateTime: value, className: "whitespace-nowrap tabular-nums text-muted", children: renderDate(value) });
+}
+function CommentCount({ count, labels }) {
+  if (!count) return null;
+  return /* @__PURE__ */ jsxs("span", { className: "inline-flex shrink-0 items-center gap-1 text-xs text-muted", "data-feedback-comment-count": count, children: [
+    /* @__PURE__ */ jsx(MessageSquare, { className: "size-3.5", "aria-hidden": true }),
+    /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "tabular-nums", children: count }),
+    /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.comments(count) })
+  ] });
+}
+function VoteCount({ count, voted, labels }) {
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: cn("ms-auto inline-flex shrink-0 items-center gap-1 text-xs", voted ? "text-brand" : "text-muted"),
+      "data-feedback-vote-count": count,
+      children: [
+        /* @__PURE__ */ jsx(ThumbsUp, { className: "size-3.5", "aria-hidden": true }),
+        /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "tabular-nums", children: count }),
+        /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.votes(count) })
+      ]
+    }
+  );
+}
+function PublicPager({
+  page,
+  hasMore,
+  onPageChange,
+  labels
+}) {
+  const tableLabels = useKitLabels("dataTable", DEFAULT_DATA_TABLE_LABELS);
+  const name = labels.page(page + 1);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "group",
+      "aria-label": name,
+      className: "flex items-center justify-end gap-2 text-sm text-secondary",
+      "data-feedback-public-pager": page,
+      children: [
+        /* @__PURE__ */ jsx(
+          IconButton,
+          {
+            size: "sm",
+            variant: "secondary",
+            label: tableLabels.prevPage,
+            disabled: page <= 0,
+            onClick: () => onPageChange(page - 1),
+            children: /* @__PURE__ */ jsx(ChevronLeft, { className: "rtl:-scale-x-100" })
+          }
+        ),
+        /* @__PURE__ */ jsx("span", { className: "tabular-nums", "aria-hidden": true, children: name }),
+        /* @__PURE__ */ jsx(
+          IconButton,
+          {
+            size: "sm",
+            variant: "secondary",
+            label: tableLabels.nextPage,
+            disabled: !hasMore,
+            onClick: () => onPageChange(page + 1),
+            children: /* @__PURE__ */ jsx(ChevronRight, { className: "rtl:-scale-x-100" })
+          }
+        )
+      ]
+    }
+  );
+}
+function FeedbackPublicList({
+  rows,
+  total,
+  sort,
+  onSortChange,
+  search = "",
+  onSearchChange,
+  renderDetail,
+  onVote,
+  loading = false,
+  openId: openIdProp,
+  onOpenChange,
+  openRow,
+  page: pageIndex = 0,
+  hasMore = false,
+  onPageChange,
+  commit,
+  renderDate: renderDateProp,
+  labels: labelsProp,
+  pageLabels: pageLabelsProp,
+  className
+}) {
+  const labels = useFeedbackPublicLabels(labelsProp);
+  const page = useFeedbackPageLabels(pageLabelsProp);
+  const categoryLabels = useFeedbackCategoryLabels();
+  const renderDate = useFeedbackRenderDate(renderDateProp);
+  const [ownOpenId, setOwnOpenId] = useState(null);
+  const openId = openIdProp !== void 0 ? openIdProp : ownOpenId;
+  const setOpen = (id) => {
+    if (openIdProp === void 0) setOwnOpenId(id);
+    onOpenChange?.(id);
+  };
+  const shownRows = openRow && openId === openRow.id && !rows.some((row) => row.id === openRow.id) ? [openRow, ...rows] : rows;
+  const columns = useMemo(
+    () => [
+      {
+        key: "id",
+        header: page.columnId,
+        cell: (row) => /* @__PURE__ */ jsx("span", { className: "font-mono text-xs text-muted", children: row.id }),
+        mobileHidden: true
+      },
+      {
+        key: "date",
+        header: page.columnDate,
+        cell: (row) => /* @__PURE__ */ jsx(PublicDate, { value: row.created_at, renderDate })
+      },
+      {
+        key: "category",
+        header: page.columnCategory,
+        cell: (row) => /* @__PURE__ */ jsx(FeedbackCategoryBadge, { category: row.category, label: categoryLabels[row.category] })
+      },
+      {
+        key: "title",
+        header: page.columnSubject,
+        cell: (row) => /* @__PURE__ */ jsxs("span", { className: "inline-flex min-w-0 max-w-full items-center gap-2 large:items-start", children: [
+          /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate-until-large font-medium", children: row.title }),
+          /* @__PURE__ */ jsx(CommentCount, { count: row.comment_count, labels })
+        ] }),
+        mobilePrimary: true
+      },
+      {
+        key: "votes",
+        header: labels.columnVotes,
+        className: "whitespace-nowrap",
+        // The cell is a button: the row's own link must never wrap it.
+        noRowLink: true,
+        cell: (row) => /* @__PURE__ */ jsx(
+          FeedbackVoteButton,
+          {
+            votes: row.votes,
+            voted: row.voted,
+            own: row.mine,
+            onVote: (next) => onVote(row, next),
+            commit,
+            size: "sm"
+          }
+        )
+      },
+      {
+        key: "status",
+        header: page.columnStatus,
+        className: "whitespace-nowrap",
+        cell: (row) => /* @__PURE__ */ jsx(FeedbackStatusBadge, { status: row.status })
+      }
+    ],
+    [page, labels, categoryLabels, renderDate, onVote, commit]
+  );
+  return /* @__PURE__ */ jsxs("div", { className: cn("flex flex-col gap-3", className), "data-feedback-public-list": "", "aria-busy": loading || void 0, children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
+      /* @__PURE__ */ jsx(
+        ToggleGroup,
+        {
+          "aria-label": labels.sort,
+          value: sort,
+          onChange: (value) => onSortChange(value),
+          options: SORTS.map((value) => ({
+            value,
+            label: value === "newest" ? labels.sortNewest : value === "votes" ? labels.sortVotes : labels.sortUpdated
+          }))
+        }
+      ),
+      onSearchChange && /* @__PURE__ */ jsx(
+        SearchField,
+        {
+          "aria-label": labels.search,
+          placeholder: labels.search,
+          value: search,
+          onChange: onSearchChange,
+          className: "min-w-[12rem] flex-1 md:max-w-xs"
+        }
+      ),
+      total !== void 0 && /* @__PURE__ */ jsx("span", { className: "ms-auto text-sm text-muted", "data-feedback-public-total": total, children: labels.total(total) })
+    ] }),
+    /* @__PURE__ */ jsx(
+      DataTable,
+      {
+        rows: shownRows,
+        columns,
+        rowKey: (row) => row.id,
+        rowName: (row) => row.title,
+        onRowClick: (row) => setOpen(openId === row.id ? null : row.id),
+        isExpanded: (row) => row.id === openId,
+        expandedRow: (row) => renderDetail(row),
+        mobileExpandAsDialog: true,
+        paginated: false,
+        empty: loading ? labels.loading : labels.empty,
+        mobileCard: (row) => /* @__PURE__ */ jsxs("div", { className: "min-w-0 space-y-1", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-start justify-between gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 font-medium [overflow-wrap:anywhere]", children: row.title }),
+            /* @__PURE__ */ jsx(FeedbackStatusBadge, { status: row.status, className: "shrink-0" })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-wrap items-center gap-x-2 gap-y-1 text-xs text-muted", children: [
+            /* @__PURE__ */ jsx(FeedbackCategoryBadge, { category: row.category, compact: true, label: categoryLabels[row.category] }),
+            /* @__PURE__ */ jsx(PublicDate, { value: row.created_at, renderDate }),
+            /* @__PURE__ */ jsx(CommentCount, { count: row.comment_count, labels }),
+            /* @__PURE__ */ jsx(VoteCount, { count: row.votes, voted: row.voted || row.mine, labels })
+          ] })
+        ] })
+      }
+    ),
+    onPageChange && (pageIndex > 0 || hasMore) && /* @__PURE__ */ jsx(PublicPager, { page: pageIndex, hasMore, onPageChange, labels })
+  ] });
+}
+function FeedbackPublicDetail({
+  row,
+  comments,
+  onVote,
+  isAdmin = false,
+  onComment,
+  onHide,
+  onDelete,
+  pending,
+  commit,
+  voteDisabled,
+  renderDate: renderDateProp,
+  now,
+  labels: labelsProp,
+  commentLabels,
+  className
+}) {
+  const labels = useFeedbackPublicLabels(labelsProp);
+  const renderDate = useFeedbackRenderDate(renderDateProp);
+  return /* @__PURE__ */ jsxs(FeedbackDetail, { className, children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-3 gap-y-2", "data-feedback-public-detail": row.id, children: [
+      /* @__PURE__ */ jsx("span", { className: "text-sm text-secondary", "data-feedback-author": "", children: labels.filedBy(row.author_name ?? labels.anonymous) }),
+      /* @__PURE__ */ jsx(PublicDate, { value: row.created_at, renderDate }),
+      /* @__PURE__ */ jsx(
+        FeedbackVoteButton,
+        {
+          votes: row.votes,
+          voted: row.voted,
+          own: row.mine,
+          onVote,
+          disabled: voteDisabled,
+          commit,
+          className: "ms-auto"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(FeedbackDetailSection, { title: labels.body, children: /* @__PURE__ */ jsx(FeedbackProse, { children: row.body }) }),
+    /* @__PURE__ */ jsx(FeedbackDetailSection, { title: labels.conversation, children: /* @__PURE__ */ jsx(
+      FeedbackCommentThread,
+      {
+        replies: row.replies,
+        comments: comments ?? [],
+        loading: comments === void 0,
+        isAdmin,
+        onComment,
+        onHide,
+        onDelete,
+        pending,
+        commit,
+        now,
+        labels: commentLabels
+      }
+    ) })
+  ] });
+}
+export {
+  DEFAULT_FEEDBACK_PUBLIC_LABELS,
+  FeedbackPublicDetail,
+  FeedbackPublicList,
+  useFeedbackPublicLabels
+};
+//# sourceMappingURL=feedback-public-list.js.map

package/dist/feedback/feedback-public-list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-public-list.tsx"],"sourcesContent":["import { useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { ChevronLeft, ChevronRight, MessageSquare, ThumbsUp } from \"lucide-react\";\nimport { DataTable, type DataTableColumn } from \"../components/data-table\";\nimport { DEFAULT_DATA_TABLE_LABELS } from \"../components/data-table-labels\";\nimport { IconButton } from \"../components/icon-button\";\nimport { SearchField } from \"../components/search-field\";\nimport { ToggleGroup } from \"../components/toggle-group\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { EMPTY_FORMATTED_VALUE } from \"../lib/format\";\nimport { FeedbackCategoryBadge, FeedbackDetail, FeedbackDetailSection, FeedbackProse, FeedbackStatusBadge } from \"./feedback-inbox\";\nimport { useFeedbackCategoryLabels } from \"./feedback-labels\";\nimport { FeedbackCommentThread, type FeedbackCommentsLabels } from \"./feedback-comment-thread\";\nimport { DEFAULT_FEEDBACK_PUBLIC_LABELS, type FeedbackPublicLabels } from \"./feedback-public-labels\";\nimport type {\n  FeedbackComment,\n  FeedbackPublicListItem,\n  FeedbackPublicRecord,\n  FeedbackPublicSort,\n  FeedbackVoteState,\n} from \"./feedback-public-types\";\nimport {\n  useFeedbackPageLabels,\n  useFeedbackRenderDate,\n  type FeedbackPageLabels,\n  type FeedbackRenderDate,\n} from \"./feedback-table\";\nimport { FeedbackVoteButton } from \"./feedback-vote-button\";\n\nexport { DEFAULT_FEEDBACK_PUBLIC_LABELS };\nexport type { FeedbackPublicLabels };\n\n/** `feedbackPublic` resolved: English, then `<UiKitProvider labels>`, then `labels`. */\nexport function useFeedbackPublicLabels(labels?: LabelOverride<FeedbackPublicLabels>): FeedbackPublicLabels {\n  return useKitLabels(\"feedbackPublic\", DEFAULT_FEEDBACK_PUBLIC_LABELS, labels);\n}\n\n/** The sort toggle's order: the server's default first (§9.6). */\nconst SORTS: readonly FeedbackPublicSort[] = [\"newest\", \"votes\", \"updated\"];\n\n/** A date in a cell, as the inbox writes it: `<time>`, nowrap, tabular figures. */\nfunction PublicDate({ value, renderDate }: { value: string | null | undefined; renderDate: FeedbackRenderDate }) {\n  if (!value) return <span className=\"text-placeholder\">{EMPTY_FORMATTED_VALUE}</span>;\n  return (\n    <time dateTime={value} className=\"whitespace-nowrap tabular-nums text-muted\">\n      {renderDate(value)}\n    </time>\n  );\n}\n\n/** The visible comments as a small chip beside the title — the count in figures, the\n *  words for a screen reader. Nothing at 0. */\nfunction CommentCount({ count, labels }: { count: number; labels: FeedbackPublicLabels }) {\n  if (!count) return null;\n  return (\n    <span className=\"inline-flex shrink-0 items-center gap-1 text-xs text-muted\" data-feedback-comment-count={count}>\n      <MessageSquare className=\"size-3.5\" aria-hidden />\n      <span aria-hidden className=\"tabular-nums\">\n        {count}\n      </span>\n      <span className=\"sr-only\">{labels.comments(count)}</span>\n    </span>\n  );\n}\n\n/** The votes on a phone card: the thumb and the count, in the brand colour when the\n *  viewer's own. */\nfunction VoteCount({ count, voted, labels }: { count: number; voted: boolean; labels: FeedbackPublicLabels }) {\n  return (\n    <span\n      className={cn(\"ms-auto inline-flex shrink-0 items-center gap-1 text-xs\", voted ? \"text-brand\" : \"text-muted\")}\n      data-feedback-vote-count={count}\n    >\n      <ThumbsUp className=\"size-3.5\" aria-hidden />\n      <span aria-hidden className=\"tabular-nums\">\n        {count}\n      </span>\n      <span className=\"sr-only\">{labels.votes(count)}</span>\n    </span>\n  );\n}\n\n/** 0.38.1: previous / next over the server's pages when it answers no total\n *  (`GET /feedback/public` — Kurvenschmiede): \"Page 3\" between two arrows. The arrows'\n *  names are `dataTable`'s, the strip's; the page's is `feedbackPublic.page`. */\nfunction PublicPager({\n  page,\n  hasMore,\n  onPageChange,\n  labels,\n}: {\n  page: number;\n  hasMore: boolean;\n  onPageChange: (page: number) => void;\n  labels: FeedbackPublicLabels;\n}) {\n  const tableLabels = useKitLabels(\"dataTable\", DEFAULT_DATA_TABLE_LABELS);\n  const name = labels.page(page + 1);\n  return (\n    <div\n      role=\"group\"\n      aria-label={name}\n      className=\"flex items-center justify-end gap-2 text-sm text-secondary\"\n      data-feedback-public-pager={page}\n    >\n      <IconButton\n        size=\"sm\"\n        variant=\"secondary\"\n        label={tableLabels.prevPage}\n        disabled={page <= 0}\n        onClick={() => onPageChange(page - 1)}\n      >\n        {/* \"Previous\" points back along the line — left in LTR, right in RTL. */}\n        <ChevronLeft className=\"rtl:-scale-x-100\" />\n      </IconButton>\n      <span className=\"tabular-nums\" aria-hidden>\n        {name}\n      </span>\n      <IconButton\n        size=\"sm\"\n        variant=\"secondary\"\n        label={tableLabels.nextPage}\n        disabled={!hasMore}\n        onClick={() => onPageChange(page + 1)}\n      >\n        <ChevronRight className=\"rtl:-scale-x-100\" />\n      </IconButton>\n    </div>\n  );\n}\n\n/* ── The list ─────────────────────────────────────────────────────────────── */\n\nexport interface FeedbackPublicListProps<T extends FeedbackPublicListItem = FeedbackPublicListItem> {\n  /** `GET /feedback/public?sort=&q=` — the server's page, in the server's order. */\n  rows: T[];\n  /** How many the query has in all — the line beside the sort. Left out, no line. */\n  total?: number;\n  /** The server sorts (§9.6): the toggle only says which way. */\n  sort: FeedbackPublicSort;\n  onSortChange: (sort: FeedbackPublicSort) => void;\n  /** The search box's text (`q`, titles only). */\n  search?: string;\n  /**\n   * The search box is drawn ONLY with this handler: where the app's titles are sealed\n   * (Kurvenschmiede, `FeedbackDeps.public_search=False`, §9.9) there is nothing to search\n   * on and the server answers `q` with a 422 — so it passes none.\n   */\n  onSearchChange?: (search: string) => void;\n  /** The opened row: the app's {@link FeedbackPublicDetail} with the row's\n   *  `GET /feedback/public/{id}` and its comments. */\n  renderDetail: (row: T) => ReactNode;\n  /** `PUT` / `DELETE /feedback/{id}/vote` for a row's button (`next`: the new state);\n   *  resolve with the answer, reject to roll back. */\n  onVote: (row: T, next: boolean) => Promise<FeedbackVoteState>;\n  /** The page is loading: the table says so where its rows would be. */\n  loading?: boolean;\n  /** The opened row's id, when the app keeps it (a `?row=` param). Left out, the list\n   *  keeps it itself. */\n  openId?: number | null;\n  onOpenChange?: (id: number | null) => void;\n  /**\n   * 0.38.1: the opened report when it is NOT on this page — a `?row=` link to an older\n   * one (Kurvenschmiede). The app fetches it (`GET /feedback/public/{id}`, a list item's\n   * fields and more) and passes it with `openId`; while `openId` is its id it is drawn\n   * first, above the page's rows, and opened with `renderDetail` (on the phone, in the\n   * full-screen dialog). Closed, it is gone. A row the page has already is never drawn\n   * twice: the page's own is opened instead.\n   */\n  openRow?: T | null;\n  /**\n   * 0.38.1: the server's page, from 0 — for a pager where `/feedback/public` answers no\n   * total (Kurvenschmiede). With {@link onPageChange} a **Previous / Page n / Next**\n   * strip stands under the table; Next is off without {@link hasMore}. Left out, no\n   * pager: the server's `limit` is all there is.\n   */\n  page?: number;\n  /** 0.38.1: there is a page after this one (e.g. the page came back full). */\n  hasMore?: boolean;\n  /** 0.38.1: go to another page (`page ± 1`); the app fetches it. Draws the pager. */\n  onPageChange?: (page: number) => void;\n  /** A vote COMMITS — see Button's `commit`. */\n  commit?: CommitScope;\n  /** See {@link FeedbackRenderDate}. Default: the kit's, with the weekday. */\n  renderDate?: FeedbackRenderDate;\n  /** Over the `feedbackPublic` namespace. The shared column names (#, Date, Category,\n   *  Subject, Status) are `feedbackPage`'s: pass `pageLabels` for those. */\n  labels?: LabelOverride<FeedbackPublicLabels>;\n  pageLabels?: LabelOverride<FeedbackPageLabels>;\n  className?: string;\n}\n\n/**\n * **All feedback** — the reports every user the app lets in may read (round 0.38,\n * docs/feedback-harmonization.md §9.3, §9.9; keksdose's `/all-feedback`).\n *\n * - **Titles only** (decision 23): #, Date, Category, Subject (with the visible\n *   comments), Votes, Status. No body, no submitter, no file — the list item carries\n *   none of them (§9.10).\n * - **The server sorts**: the toggle **Newest / Most wanted / Recently updated** sets\n *   `sort`, and the columns themselves do not sort (a page of 50 sorted in the browser\n *   would not be the 50 the sort asks for).\n * - **The search box only with `onSearchChange`**: an app whose titles are sealed\n *   passes none (§9.9).\n * - **Votes** are `FeedbackVoteButton`s, optimistic, the viewer's own report pressed\n *   and locked (\"Your report\", §9.6).\n * - A row opens in place with `renderDetail` — on the phone, in a full-screen dialog.\n *   The phone cards carry the title, the status, the category, the date and the two\n *   counts; the vote itself is in the opened report (a button inside the card, which is\n *   the row's own button, would be two controls in one).\n *\n * No client paging: the server's `limit` is the page, and `total` says how many there\n * are. For more than one page, `page` / `hasMore` / `onPageChange` draw a previous /\n * next strip that needs no total (0.38.1); `openRow` shows a `?row=` report from\n * another page. Needs a router, as every `DataTable` does.\n */\nexport function FeedbackPublicList<T extends FeedbackPublicListItem = FeedbackPublicListItem>({\n  rows,\n  total,\n  sort,\n  onSortChange,\n  search = \"\",\n  onSearchChange,\n  renderDetail,\n  onVote,\n  loading = false,\n  openId: openIdProp,\n  onOpenChange,\n  openRow,\n  page: pageIndex = 0,\n  hasMore = false,\n  onPageChange,\n  commit,\n  renderDate: renderDateProp,\n  labels: labelsProp,\n  pageLabels: pageLabelsProp,\n  className,\n}: FeedbackPublicListProps<T>) {\n  const labels = useFeedbackPublicLabels(labelsProp);\n  const page = useFeedbackPageLabels(pageLabelsProp);\n  const categoryLabels = useFeedbackCategoryLabels();\n  const renderDate = useFeedbackRenderDate(renderDateProp);\n  const [ownOpenId, setOwnOpenId] = useState<number | null>(null);\n  const openId = openIdProp !== undefined ? openIdProp : ownOpenId;\n  const setOpen = (id: number | null) => {\n    if (openIdProp === undefined) setOwnOpenId(id);\n    onOpenChange?.(id);\n  };\n  // A `?row=` report from another page: first, while it is the open one, and only when\n  // the page does not have it itself.\n  const shownRows =\n    openRow && openId === openRow.id && !rows.some((row) => row.id === openRow.id) ? [openRow, ...rows] : rows;\n\n  const columns = useMemo<DataTableColumn<T>[]>(\n    () => [\n      {\n        key: \"id\",\n        header: page.columnId,\n        cell: (row) => <span className=\"font-mono text-xs text-muted\">{row.id}</span>,\n        mobileHidden: true,\n      },\n      {\n        key: \"date\",\n        header: page.columnDate,\n        cell: (row) => <PublicDate value={row.created_at} renderDate={renderDate} />,\n      },\n      {\n        key: \"category\",\n        header: page.columnCategory,\n        cell: (row) => <FeedbackCategoryBadge category={row.category} label={categoryLabels[row.category]} />,\n      },\n      {\n        key: \"title\",\n        header: page.columnSubject,\n        cell: (row) => (\n          <span className=\"inline-flex min-w-0 max-w-full items-center gap-2 large:items-start\">\n            <span className=\"min-w-0 truncate-until-large font-medium\">{row.title}</span>\n            <CommentCount count={row.comment_count} labels={labels} />\n          </span>\n        ),\n        mobilePrimary: true,\n      },\n      {\n        key: \"votes\",\n        header: labels.columnVotes,\n        className: \"whitespace-nowrap\",\n        // The cell is a button: the row's own link must never wrap it.\n        noRowLink: true,\n        cell: (row) => (\n          <FeedbackVoteButton\n            votes={row.votes}\n            voted={row.voted}\n            own={row.mine}\n            onVote={(next) => onVote(row, next)}\n            commit={commit}\n            size=\"sm\"\n          />\n        ),\n      },\n      {\n        key: \"status\",\n        header: page.columnStatus,\n        className: \"whitespace-nowrap\",\n        cell: (row) => <FeedbackStatusBadge status={row.status} />,\n      },\n    ],\n    [page, labels, categoryLabels, renderDate, onVote, commit],\n  );\n\n  return (\n    <div className={cn(\"flex flex-col gap-3\", className)} data-feedback-public-list=\"\" aria-busy={loading || undefined}>\n      <div className=\"flex flex-wrap items-center gap-2\">\n        <ToggleGroup\n          aria-label={labels.sort}\n          value={sort}\n          onChange={(value) => onSortChange(value)}\n          options={SORTS.map((value) => ({\n            value,\n            label: value === \"newest\" ? labels.sortNewest : value === \"votes\" ? labels.sortVotes : labels.sortUpdated,\n          }))}\n        />\n        {onSearchChange && (\n          <SearchField\n            aria-label={labels.search}\n            placeholder={labels.search}\n            value={search}\n            onChange={onSearchChange}\n            className=\"min-w-[12rem] flex-1 md:max-w-xs\"\n          />\n        )}\n        {total !== undefined && (\n          <span className=\"ms-auto text-sm text-muted\" data-feedback-public-total={total}>\n            {labels.total(total)}\n          </span>\n        )}\n      </div>\n      <DataTable\n        rows={shownRows}\n        columns={columns}\n        rowKey={(row) => row.id}\n        rowName={(row) => row.title}\n        onRowClick={(row) => setOpen(openId === row.id ? null : row.id)}\n        isExpanded={(row) => row.id === openId}\n        expandedRow={(row) => renderDetail(row)}\n        mobileExpandAsDialog\n        paginated={false}\n        empty={loading ? labels.loading : labels.empty}\n        mobileCard={(row) => (\n          <div className=\"min-w-0 space-y-1\">\n            <div className=\"flex items-start justify-between gap-2\">\n              <span className=\"min-w-0 flex-1 font-medium [overflow-wrap:anywhere]\">{row.title}</span>\n              <FeedbackStatusBadge status={row.status} className=\"shrink-0\" />\n            </div>\n            <div className=\"flex min-w-0 flex-wrap items-center gap-x-2 gap-y-1 text-xs text-muted\">\n              <FeedbackCategoryBadge category={row.category} compact label={categoryLabels[row.category]} />\n              <PublicDate value={row.created_at} renderDate={renderDate} />\n              <CommentCount count={row.comment_count} labels={labels} />\n              {/* A count, not the button: the whole card is the row's button, and a button\n                  inside it is two controls in one. The vote is in the opened report. */}\n              <VoteCount count={row.votes} voted={row.voted || row.mine} labels={labels} />\n            </div>\n          </div>\n        )}\n      />\n      {onPageChange && (pageIndex > 0 || hasMore) && (\n        <PublicPager page={pageIndex} hasMore={hasMore} onPageChange={onPageChange} labels={labels} />\n      )}\n    </div>\n  );\n}\n\n/* ── The detail ───────────────────────────────────────────────────────────── */\n\nexport interface FeedbackPublicDetailProps {\n  /** `GET /feedback/public/{id}`: the public body (attachment URLs already stripped by\n   *  the server, §9.4) and the replies. */\n  row: FeedbackPublicRecord;\n  /** `GET /feedback/{id}/comments`, oldest first; `undefined` while it loads. */\n  comments: readonly FeedbackComment[] | undefined;\n  /** `PUT` / `DELETE /feedback/{id}/vote`; resolve with the answer, reject to roll back. */\n  onVote: (next: boolean) => Promise<FeedbackVoteState>;\n  /** The viewer is the app's admin: Hide / Unhide on the comments. */\n  isAdmin?: boolean;\n  /** `POST /feedback/{id}/comments`. Left out — a demo, a reader who may not write — no\n   *  composer. */\n  onComment?: (body: string) => void | Promise<unknown>;\n  /** The admin's hide (`PATCH …/comments/{id} {hidden}`). */\n  onHide?: (comment: FeedbackComment, hidden: boolean) => void | Promise<unknown>;\n  /** The writer's delete (`DELETE …/comments/{id}`), after a confirm. */\n  onDelete?: (comment: FeedbackComment) => void | Promise<unknown>;\n  /** A comment is being sent. */\n  pending?: boolean;\n  /** The vote and the thread's buttons COMMIT — see Button's `commit`. */\n  commit?: CommitScope;\n  /** Voting is off for this viewer (a demo): `true`, or the reason. */\n  voteDisabled?: boolean | string;\n  /** See {@link FeedbackRenderDate}. */\n  renderDate?: FeedbackRenderDate;\n  /** \"Now\" for the thread's relative times — pin it in tests and stories. */\n  now?: Date | number;\n  /** Over the `feedbackPublic` namespace. */\n  labels?: LabelOverride<FeedbackPublicLabels>;\n  /** Over the `feedbackComments` namespace, for the thread. */\n  commentLabels?: LabelOverride<FeedbackCommentsLabels>;\n  className?: string;\n}\n\n/**\n * One public report opened (round 0.38, docs/feedback-harmonization.md §9.3, §9.10): who\n * filed it — the first name the server sent, else **\"A user\"** (§9.5) — and when; the\n * **vote**; the **public body**; and the **conversation**, the admin's replies and other\n * people's comments merged oldest first (§9.8, `FeedbackCommentThread`), with the box to\n * add one.\n *\n * What it never draws, because the public record never carries it (§9.10): an address,\n * a last name, a screenshot, a file, the page the report was filed on. The body is the\n * server's `public_body` — the client strips nothing and adds nothing.\n */\nexport function FeedbackPublicDetail({\n  row,\n  comments,\n  onVote,\n  isAdmin = false,\n  onComment,\n  onHide,\n  onDelete,\n  pending,\n  commit,\n  voteDisabled,\n  renderDate: renderDateProp,\n  now,\n  labels: labelsProp,\n  commentLabels,\n  className,\n}: FeedbackPublicDetailProps) {\n  const labels = useFeedbackPublicLabels(labelsProp);\n  const renderDate = useFeedbackRenderDate(renderDateProp);\n  return (\n    <FeedbackDetail className={className}>\n      <div className=\"flex flex-wrap items-center gap-x-3 gap-y-2\" data-feedback-public-detail={row.id}>\n        <span className=\"text-sm text-secondary\" data-feedback-author=\"\">\n          {labels.filedBy(row.author_name ?? labels.anonymous)}\n        </span>\n        <PublicDate value={row.created_at} renderDate={renderDate} />\n        <FeedbackVoteButton\n          votes={row.votes}\n          voted={row.voted}\n          own={row.mine}\n          onVote={onVote}\n          disabled={voteDisabled}\n          commit={commit}\n          className=\"ms-auto\"\n        />\n      </div>\n      <FeedbackDetailSection title={labels.body}>\n        {/* Rework rounds stay in it — the author's own words (§9.4). */}\n        <FeedbackProse>{row.body}</FeedbackProse>\n      </FeedbackDetailSection>\n      <FeedbackDetailSection title={labels.conversation}>\n        <FeedbackCommentThread\n          replies={row.replies}\n          comments={comments ?? []}\n          loading={comments === undefined}\n          isAdmin={isAdmin}\n          onComment={onComment}\n          onHide={onHide}\n          onDelete={onDelete}\n          pending={pending}\n          commit={commit}\n          now={now}\n          labels={commentLabels}\n        />\n      </FeedbackDetailSection>\n    </FeedbackDetail>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/feedback/feedback-public-switch.d.ts

@@ -0,0 +1,51 @@
+import type { CommitScope } from "../components/write-lock.js";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { type FeedbackRecord } from "./feedback-record.js";
+import { type FeedbackPublicLabels } from "./feedback-public-labels.js";
+/** What the switch reads off a report: {@link FeedbackRecord}'s fields (§9.3). */
+export type FeedbackPublicSwitchRow = Pick<FeedbackRecord, "user_id" | "category" | "status" | "public" | "filed_private" | "mine">;
+/** Who is looking: the app's admin check, and the signed-in user's id. */
+export interface FeedbackPublicSwitchViewer {
+    isAdmin: boolean;
+    viewerId?: number | null;
+}
+/**
+ * Whether the viewer may flip a report's `public` flag — the server's rule (§9.3), so the
+ * switch never offers what the `PATCH {public}` would refuse with a 403:
+ *
+ * - never on a CRASH (decision 9: a crash is private whatever its flag);
+ * - an admin, at any status;
+ * - the author while the status is OPEN, READY or IN_PROGRESS
+ *   (`FEEDBACK_AUTHOR_EDITABLE_STATUSES`), and on a `filed_private` report — one the
+ *   0.38 migration made public — at any status: that is the opt-out the notice offers.
+ */
+export declare function feedbackPublicSwitchAllowed(row: FeedbackPublicSwitchRow, { isAdmin, viewerId }: FeedbackPublicSwitchViewer): boolean;
+export interface FeedbackPublicSwitchProps extends FeedbackPublicSwitchViewer {
+    row: FeedbackPublicSwitchRow;
+    /** `PATCH /feedback/{id} {"public": next}` — the app's mutation. */
+    onChange: (next: boolean) => void;
+    /** The PATCH is in flight: the switch holds still. */
+    pending?: boolean;
+    /** Flipping it SAVES: pass `true` to put it under the page's `WriteLockProvider`
+     *  (Switch's `commit`). Off by default, as on the inbox's status buttons. */
+    commit?: CommitScope;
+    /** Over the `feedbackPublic` namespace (`visibleToOthers`, `visibleHint`,
+     *  `visibleLocked`). */
+    labels?: LabelOverride<FeedbackPublicLabels>;
+    className?: string;
+}
+/**
+ * **Visible to others** — a report's `public` flag (round 0.38, docs/feedback-harmonization.md
+ * §9.3, decision 6), for the row detail (`FeedbackRowDetail`'s `onPublicChange`) or an
+ * app's own page.
+ *
+ * - Drawn for the admin and the author only: nobody else is sent `public` (§9.10). Not
+ *   drawn on a CRASH, and not when the row carries no `public` at all (a server before
+ *   0.38, or an app without public parts — kastlan).
+ * - The author past the open window sees it **locked with the reason** ("Only while the
+ *   report is open"), focusable, so the reason reaches a keyboard; a `filed_private`
+ *   report is never locked for its author ({@link feedbackPublicSwitchAllowed}).
+ * - The line under it says what "visible" means: the title and the text, never the
+ *   screenshots or files (decision 1).
+ */
+export declare function FeedbackPublicSwitch({ row, isAdmin, viewerId, onChange, pending, commit, labels: labelsProp, className, }: FeedbackPublicSwitchProps): import("react").JSX.Element | null;

package/dist/feedback/feedback-public-switch.js

@@ -0,0 +1,50 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { Switch } from "../components/switch.js";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { FEEDBACK_AUTHOR_EDITABLE_STATUSES } from "./feedback-record.js";
+import { DEFAULT_FEEDBACK_PUBLIC_LABELS } from "./feedback-public-labels.js";
+function isAuthorOf(row, viewerId) {
+  if (row.mine != null) return row.mine;
+  return row.user_id !== null && viewerId !== void 0 && viewerId !== null && row.user_id === viewerId;
+}
+function feedbackPublicSwitchAllowed(row, { isAdmin, viewerId }) {
+  if (row.category === "CRASH") return false;
+  if (isAdmin) return true;
+  if (!isAuthorOf(row, viewerId)) return false;
+  return row.filed_private === true || FEEDBACK_AUTHOR_EDITABLE_STATUSES.includes(row.status);
+}
+function FeedbackPublicSwitch({
+  row,
+  isAdmin,
+  viewerId,
+  onChange,
+  pending = false,
+  commit,
+  labels: labelsProp,
+  className
+}) {
+  const labels = useKitLabels("feedbackPublic", DEFAULT_FEEDBACK_PUBLIC_LABELS, labelsProp);
+  if (row.category === "CRASH" || row.public == null) return null;
+  if (!isAdmin && !isAuthorOf(row, viewerId)) return null;
+  const allowed = feedbackPublicSwitchAllowed(row, { isAdmin, viewerId });
+  return /* @__PURE__ */ jsx(
+    Switch,
+    {
+      className,
+      label: labels.visibleToOthers,
+      description: labels.visibleHint,
+      checked: row.public === true,
+      disabled: pending,
+      disabledReason: allowed ? void 0 : labels.visibleLocked,
+      commit,
+      onCheckedChange: (next) => onChange(next),
+      "data-feedback-public": row.public ? "on" : "off"
+    }
+  );
+}
+export {
+  FeedbackPublicSwitch,
+  feedbackPublicSwitchAllowed
+};
+//# sourceMappingURL=feedback-public-switch.js.map

package/dist/feedback/feedback-public-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-public-switch.tsx"],"sourcesContent":["import { Switch } from \"../components/switch\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { FEEDBACK_AUTHOR_EDITABLE_STATUSES, type FeedbackRecord } from \"./feedback-record\";\nimport { DEFAULT_FEEDBACK_PUBLIC_LABELS, type FeedbackPublicLabels } from \"./feedback-public-labels\";\n\n/** What the switch reads off a report: {@link FeedbackRecord}'s fields (§9.3). */\nexport type FeedbackPublicSwitchRow = Pick<\n  FeedbackRecord,\n  \"user_id\" | \"category\" | \"status\" | \"public\" | \"filed_private\" | \"mine\"\n>;\n\n/** Who is looking: the app's admin check, and the signed-in user's id. */\nexport interface FeedbackPublicSwitchViewer {\n  isAdmin: boolean;\n  viewerId?: number | null;\n}\n\n/** The viewer filed the row — `mine` when the server sent it, else the ids (never for an\n *  erased author, `user_id: null`). */\nfunction isAuthorOf(row: FeedbackPublicSwitchRow, viewerId: number | null | undefined): boolean {\n  if (row.mine != null) return row.mine;\n  return row.user_id !== null && viewerId !== undefined && viewerId !== null && row.user_id === viewerId;\n}\n\n/**\n * Whether the viewer may flip a report's `public` flag — the server's rule (§9.3), so the\n * switch never offers what the `PATCH {public}` would refuse with a 403:\n *\n * - never on a CRASH (decision 9: a crash is private whatever its flag);\n * - an admin, at any status;\n * - the author while the status is OPEN, READY or IN_PROGRESS\n *   (`FEEDBACK_AUTHOR_EDITABLE_STATUSES`), and on a `filed_private` report — one the\n *   0.38 migration made public — at any status: that is the opt-out the notice offers.\n */\nexport function feedbackPublicSwitchAllowed(\n  row: FeedbackPublicSwitchRow,\n  { isAdmin, viewerId }: FeedbackPublicSwitchViewer,\n): boolean {\n  if (row.category === \"CRASH\") return false;\n  if (isAdmin) return true;\n  if (!isAuthorOf(row, viewerId)) return false;\n  return row.filed_private === true || FEEDBACK_AUTHOR_EDITABLE_STATUSES.includes(row.status);\n}\n\nexport interface FeedbackPublicSwitchProps extends FeedbackPublicSwitchViewer {\n  row: FeedbackPublicSwitchRow;\n  /** `PATCH /feedback/{id} {\"public\": next}` — the app's mutation. */\n  onChange: (next: boolean) => void;\n  /** The PATCH is in flight: the switch holds still. */\n  pending?: boolean;\n  /** Flipping it SAVES: pass `true` to put it under the page's `WriteLockProvider`\n   *  (Switch's `commit`). Off by default, as on the inbox's status buttons. */\n  commit?: CommitScope;\n  /** Over the `feedbackPublic` namespace (`visibleToOthers`, `visibleHint`,\n   *  `visibleLocked`). */\n  labels?: LabelOverride<FeedbackPublicLabels>;\n  className?: string;\n}\n\n/**\n * **Visible to others** — a report's `public` flag (round 0.38, docs/feedback-harmonization.md\n * §9.3, decision 6), for the row detail (`FeedbackRowDetail`'s `onPublicChange`) or an\n * app's own page.\n *\n * - Drawn for the admin and the author only: nobody else is sent `public` (§9.10). Not\n *   drawn on a CRASH, and not when the row carries no `public` at all (a server before\n *   0.38, or an app without public parts — kastlan).\n * - The author past the open window sees it **locked with the reason** (\"Only while the\n *   report is open\"), focusable, so the reason reaches a keyboard; a `filed_private`\n *   report is never locked for its author ({@link feedbackPublicSwitchAllowed}).\n * - The line under it says what \"visible\" means: the title and the text, never the\n *   screenshots or files (decision 1).\n */\nexport function FeedbackPublicSwitch({\n  row,\n  isAdmin,\n  viewerId,\n  onChange,\n  pending = false,\n  commit,\n  labels: labelsProp,\n  className,\n}: FeedbackPublicSwitchProps) {\n  const labels = useKitLabels(\"feedbackPublic\", DEFAULT_FEEDBACK_PUBLIC_LABELS, labelsProp);\n  if (row.category === \"CRASH\" || row.public == null) return null;\n  if (!isAdmin && !isAuthorOf(row, viewerId)) return null;\n  const allowed = feedbackPublicSwitchAllowed(row, { isAdmin, viewerId });\n  return (\n    <Switch\n      className={className}\n      label={labels.visibleToOthers}\n      description={labels.visibleHint}\n      checked={row.public === true}\n      disabled={pending}\n      disabledReason={allowed ? undefined : labels.visibleLocked}\n      commit={commit}\n      onCheckedChange={(next) => onChange(next)}\n      data-feedback-public={row.public ? \"on\" : \"off\"}\n    />\n  );\n}\n"],"mappings":";AAyFI;AAzFJ,SAAS,cAAc;AAEvB,SAAS,oBAAwC;AACjD,SAAS,yCAA8D;AACvE,SAAS,sCAAiE;AAgB1E,SAAS,WAAW,KAA8B,UAA8C;AAC9F,MAAI,IAAI,QAAQ,KAAM,QAAO,IAAI;AACjC,SAAO,IAAI,YAAY,QAAQ,aAAa,UAAa,aAAa,QAAQ,IAAI,YAAY;AAChG;AAYO,SAAS,4BACd,KACA,EAAE,SAAS,SAAS,GACX;AACT,MAAI,IAAI,aAAa,QAAS,QAAO;AACrC,MAAI,QAAS,QAAO;AACpB,MAAI,CAAC,WAAW,KAAK,QAAQ,EAAG,QAAO;AACvC,SAAO,IAAI,kBAAkB,QAAQ,kCAAkC,SAAS,IAAI,MAAM;AAC5F;AA+BO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAA8B;AAC5B,QAAM,SAAS,aAAa,kBAAkB,gCAAgC,UAAU;AACxF,MAAI,IAAI,aAAa,WAAW,IAAI,UAAU,KAAM,QAAO;AAC3D,MAAI,CAAC,WAAW,CAAC,WAAW,KAAK,QAAQ,EAAG,QAAO;AACnD,QAAM,UAAU,4BAA4B,KAAK,EAAE,SAAS,SAAS,CAAC;AACtE,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,OAAO;AAAA,MACd,aAAa,OAAO;AAAA,MACpB,SAAS,IAAI,WAAW;AAAA,MACxB,UAAU;AAAA,MACV,gBAAgB,UAAU,SAAY,OAAO;AAAA,MAC7C;AAAA,MACA,iBAAiB,CAAC,SAAS,SAAS,IAAI;AAAA,MACxC,wBAAsB,IAAI,SAAS,OAAO;AAAA;AAAA,EAC5C;AAEJ;","names":[]}

package/dist/feedback/feedback-public-types.d.ts

@@ -0,0 +1,75 @@
+import type { FeedbackCategory, FeedbackStatus } from "./feedback-vocabulary.js";
+/**
+ * The shapes of round 0.38's public feedback (docs/feedback-harmonization.md §9): the
+ * admin's replies as a list (§9.7), other people's comments as rows (§9.8), the upvote
+ * (§9.6) and the two public views of a report (§9.3). Types only: what the server
+ * answers, as the three apps' clients receive it.
+ *
+ * A name is always the server's (§9.5): `author_name` is a first name for others, the
+ * full name for an admin, and `null` when there is none to show (an erased or incomplete
+ * account, a loop's reply). The client never builds one from an id.
+ */
+/** One answer of the admin's — `FeedbackReplyResponse`, §9.7. Oldest first. */
+export interface FeedbackReply {
+    id: number;
+    /** `null`: a loop's reply, a migrated `outcome`, or an erased admin — drawn as the
+     *  app's word for its admin ("Admin"). */
+    author_name: string | null;
+    body: string;
+    /** The status this reply moved the report to; `null` = no status change. */
+    status_to: FeedbackStatus | null;
+    /** Where it moved from — the admin view only. */
+    status_from?: FeedbackStatus | null;
+    /** ISO 8601. */
+    created_at: string;
+}
+/** One comment by someone who reads the report — `FeedbackCommentResponse`, §9.8. */
+export interface FeedbackComment {
+    id: number;
+    /** First name for others, the full name for an admin; `null` → "A user". */
+    author_name: string | null;
+    /** The viewer wrote it (they may delete it). */
+    mine: boolean;
+    /** keksdose's migrated rows whose writer was an admin (K2): drawn as a staff post. */
+    staff: boolean;
+    /** `null` when hidden, but for its writer and an admin. */
+    body: string | null;
+    hidden: boolean;
+    /** ISO 8601. */
+    created_at: string;
+}
+/** What `PUT` / `DELETE /feedback/{id}/vote` answer — `FeedbackVoteResponse`, §9.6. */
+export interface FeedbackVoteState {
+    votes: number;
+    voted: boolean;
+}
+/** The public list's server-side sort (§9.6): newest first (default), most votes (then
+ *  newest), or most recently updated. */
+export type FeedbackPublicSort = "newest" | "votes" | "updated";
+/** One row of `GET /feedback/public` — `FeedbackPublicListItem`, §9.3, §9.9: titles
+ *  only, no body, no files, no account. */
+export interface FeedbackPublicListItem extends FeedbackVoteState {
+    id: number;
+    title: string;
+    category: FeedbackCategory;
+    status: FeedbackStatus;
+    /** First name, or `null` → "A user". */
+    author_name: string | null;
+    /** The viewer filed it. */
+    mine: boolean;
+    /** Visible comments. */
+    comment_count: number;
+    /** ISO 8601. */
+    created_at: string;
+    /** ISO 8601. */
+    updated_at: string;
+    /** ISO 8601, or `null`. */
+    resolved_at: string | null;
+}
+/** `GET /feedback/public/{id}` — `FeedbackPublicResponse`, §9.3: the list row plus the
+ *  public body (every attachment URL stripped by the server, §9.4) and the replies. The
+ *  comments are fetched beside it (`GET /feedback/{id}/comments`). */
+export interface FeedbackPublicRecord extends FeedbackPublicListItem {
+    body: string;
+    replies: FeedbackReply[];
+}

package/dist/feedback/feedback-public-types.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=feedback-public-types.js.map

package/dist/feedback/feedback-public-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/feedback/feedback-record.d.ts

@@ -1,4 +1,5 @@
 import type { FeedbackCategory, FeedbackStatus } from "./feedback-vocabulary.js";
+import type { FeedbackReply } from "./feedback-public-types.js";
 /**
  * One feedback report as the three apps send it, and the facts the kit reads off it.
  *
@@ -94,7 +95,9 @@ export interface FeedbackRecord {
     /** Up to 5 other files; `null` = none. Optional because a server older than the
      *  column sends no key at all (keksdose dev #578 met exactly that). */
     attachment_urls?: string[] | null;
-    /** The team's answer; `null` = none written. */
+    /** The team's answer; `null` = none written. **Frozen since 0.38** (§9.7): answered
+     *  as stored for one release, written by nothing, then dropped — the answer is
+     *  {@link FeedbackRecord.replies} now. */
     outcome: string | null;
     /** Set on ENTERING `DONE` / `WONT_DO`, cleared on leaving them. ISO 8601. */
     resolved_at: string | null;
@@ -102,6 +105,23 @@ export interface FeedbackRecord {
     created_at: string;
     /** ISO 8601. */
     updated_at: string;
+    /** The admin: the full name; the author: their own; `null`: none to show. */
+    author_name?: string | null;
+    /** The viewer filed it. */
+    mine?: boolean | null;
+    /** Visible to the app's other users (§9.3); never on a CRASH. */
+    public?: boolean | null;
+    /** Made public by the 0.38 migration: the author may switch it off at any status. */
+    filed_private?: boolean | null;
+    /** People who want this (the author's own vote included, §9.6). */
+    votes?: number | null;
+    /** The viewer's vote. */
+    voted?: boolean | null;
+    /** Comments (an admin's count includes hidden ones). */
+    comment_count?: number | null;
+    /** The admin's answers, oldest first (§9.7). Absent: a server before 0.38 — read
+     *  `outcome` instead. */
+    replies?: FeedbackReply[] | null;
 }
 /** The image types `FeedbackAttachmentField` takes when `accept` is not given. */
 export declare const DEFAULT_ATTACHMENT_ACCEPT: string[];
@@ -152,6 +172,17 @@ export declare const FEEDBACK_AUTHOR_EDITABLE_STATUSES: readonly FeedbackStatus[
  * you" toggle narrows the inbox to exactly these (§4.3).
  */
 export declare const FEEDBACK_AWAITING_STATUSES: readonly FeedbackStatus[];
+/**
+ * The **decided** statuses (§9.7, decision 13): `DONE`, `WONT_DO`, `POSTPONED`. A
+ * status-only move into one tells the author nothing (a status alone sends no
+ * notification), so the row detail nudges the admin toward a reply until one with that
+ * `status_to` exists.
+ */
+export declare const FEEDBACK_DECIDED_STATUSES: readonly FeedbackStatus[];
+/** A comment's longest body after trimming (§9.8). */
+export declare const FEEDBACK_COMMENT_MAX = 4000;
+/** A reply's longest body after trimming (§9.7). */
+export declare const FEEDBACK_REPLY_MAX = 8000;
 /** The body line for one uploaded attachment — what {@link appendRework} writes under
  *  the note. */
 export declare function feedbackAttachmentLine(url: string): string;

package/dist/feedback/feedback-record.js

@@ -28,6 +28,13 @@ const FEEDBACK_AWAITING_STATUSES = Object.freeze([
   "IN_EVALUATION",
   "NEEDS_LIVE_TEST"
 ]);
+const FEEDBACK_DECIDED_STATUSES = Object.freeze([
+  "DONE",
+  "WONT_DO",
+  "POSTPONED"
+]);
+const FEEDBACK_COMMENT_MAX = 4e3;
+const FEEDBACK_REPLY_MAX = 8e3;
 const ATTACHMENT_URL = /^\/api\/v1\/feedback\/attachments\/[\w.-]+$/;
 const ATTACHMENT_LINE = /^\[screenshot\]\s+(\/api\/v1\/feedback\/attachments\/[\w.-]+)\s*$/;
 const REWORK_RULE = /^---\s*REWORK\b.*---$/;
@@ -97,7 +104,10 @@ export {
   FEEDBACK_ATTACHMENT_ACCEPT,
   FEEDBACK_AUTHOR_EDITABLE_STATUSES,
   FEEDBACK_AWAITING_STATUSES,
+  FEEDBACK_COMMENT_MAX,
+  FEEDBACK_DECIDED_STATUSES,
   FEEDBACK_PICKABLE_CATEGORIES,
+  FEEDBACK_REPLY_MAX,
   FEEDBACK_REWORKABLE_STATUSES,
   appendRework,
   attachmentName,