@eifi1/ui-kit 0.33.1 → 0.34.0

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

@@ -1,101 +1,83 @@
-import 'react';
-import '../components/user-avatar.js';
-import '../shell/topbar-action-menu.js';
-export { k as DEFAULT_FEEDBACK_MENU_LABELS, ai as FeedbackMenu, aj as FeedbackMenuLabels, ak as FeedbackMenuProps } from '../delete-account-setting-DAgGBrbn.js';
-import '../lib/person-name.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../components/write-lock.js';
-import '../components/menu-item.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import '../hooks/use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/floating-panel.js';
-import '../hooks/use-authed-src.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../i18n/plurals.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
+import type { UserAvatarBadge } from "../components/user-avatar.js";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { type TopBarMenuEntry } from "../shell/topbar-action-menu.js";
+import type { HoverMenuProps } from "../components/hover-menu.js";
+import { type FeedbackCategory } from "./feedback-vocabulary.js";
+import { DEFAULT_FEEDBACK_MENU_LABELS } from "./feedback-menu-labels.js";
+/**
+ * `feedbackMenu` — the top-bar feedback menu's own words (0.27.0). The four category rows
+ * are `feedbackCategory`'s, shared with the badges and the dialog's picker. de-CH canon
+ * (keksdose `de-CH.json`): `trigger` "Feedback senden", `myFeedback` "Mein Feedback",
+ * `viewFeedback` "Feedback ansehen".
+ */
+export interface FeedbackMenuLabels {
+    /** The trigger's accessible name, and the menu's. keksdose `feedback.send`. */
+    trigger: string;
+    /** The link to the reporter's own reports — everyone but an admin. keksdose
+     *  `feedback.my_title`. */
+    myFeedback: string;
+    /** The link to the inbox — an admin's one list link, in place of "My feedback".
+     *  keksdose `feedback.view_all`. */
+    viewFeedback: string;
+}
+export { DEFAULT_FEEDBACK_MENU_LABELS };
+export interface FeedbackMenuProps {
+    /** A category row was chosen — open the submit dialog on it (`useFeedbackSubmit`'s
+     *  `open`). Never called with `CRASH`: there is no row for it. */
+    onFile: (category: FeedbackCategory) => void;
+    /** The list link is "View feedback" → {@link inboxHref} INSTEAD of "My feedback" (§4.1,
+     *  keksdose `top-bar.tsx:205-214`). The admin check is the app's (kastlan's is
+     *  company-scoped). Default `false`. */
+    isAdmin?: boolean;
+    /**
+     * Rows of the app's own, between the divider and the list link — keksdose's
+     * `Sparkles` Help assistant → `/assistant` and `MessagesSquare` Support chat →
+     * `/support` with its unread chip. Any {@link TopBarMenuEntry}; keep their `key`s clear
+     * of the menu's own (`BUG`, `IDEA`, `QUESTION`, `OTHER`, `feedback-divider`,
+     * `my-feedback`, `view-feedback`).
+     */
+    extraEntries?: TopBarMenuEntry[];
+    /** The user's own reports, linked for everyone but an admin. Default `"/my-feedback"`
+     *  (§2.3). */
+    myFeedbackHref?: string;
+    /** The admin inbox, linked for an admin. Default `"/feedback"` (§2.3). */
+    inboxHref?: string;
+    /** A dot on the trigger — keksdose's unread support replies (`tone: "danger"`). Its
+     *  `label` joins the trigger's name ("Send feedback 2 unread"). The words are the app's. */
+    iconBadge?: UserAvatarBadge | null;
+    /** Prop > `<UiKitProvider labels={{ feedbackMenu }}>` > English. */
+    labels?: LabelOverride<FeedbackMenuLabels>;
+    /** Which edge of the trigger the panel lines up with (see `HoverMenu`, whose type this
+     *  is: `left`/`right` are deprecated 0.34). Default `end`. */
+    align?: HoverMenuProps["align"];
+}
+/**
+ * The top-bar feedback menu, the same in every app (0.27.0, docs/feedback-harmonization.md
+ * §4.1) — keksdose `frontend/src/app/top-bar.tsx:156` on the kit's `TopBarActionMenu`:
+ *
+ * 1. a `MessageSquare` trigger named "Send feedback", with an optional `iconBadge`;
+ * 2. Bug · Idea · Question · Other (`Bug`, `Lightbulb`, `HelpCircle`, `MoreHorizontal` —
+ *    the category badges' own glyphs), each calling `onFile(category)`;
+ * 3. a divider, always;
+ * 4. the app's `extraEntries`;
+ * 5. ONE list link, `Inbox`: an admin's is "View feedback" → `/feedback`, everyone
+ *    else's "My feedback" → `/my-feedback` — keksdose's (`top-bar.tsx:205-214`, feedback
+ *    #331: admins get the management view, everyone else their own submissions).
+ *
+ * WHY A PRESET. Three apps had drawn three menus on the same primitive and they disagreed:
+ * kastlan headed it "New submission", Kurvenschmiede "Send feedback" with a single link
+ * that changed its words by role, keksdose had no heading and one link by role. keksdose
+ * is the source (§2.4, §7.11): no heading, one link — the inbox for an admin, who reaches
+ * their own reports there too — and the kit draws it, so the row order, the icons and the
+ * words cannot drift again. Where the menu sits in the bar stays each app's.
+ *
+ * `CRASH` has no row and never will: crash reports are filed by the error boundary with
+ * the stack and a fingerprint (keksdose feedback #160), and a hand-filed "crash" would sort
+ * to the top like one with none of what makes it actionable. The server refuses it with a
+ * 422 anyway (§3.4).
+ *
+ * The menu forwards nothing to its trigger, as `TopBarActionMenu` does not: keksdose's
+ * tour anchor (`data-tour="feedback-menu"`) stays on a wrapping `<span>`. Needs a router,
+ * as every `TopBarActionMenu` with link rows does.
+ */
+export declare function FeedbackMenu({ onFile, isAdmin, extraEntries, myFeedbackHref, inboxHref, iconBadge, labels: labelsProp, align, }: FeedbackMenuProps): import("react").JSX.Element;

package/dist/feedback/feedback-menu.js

@@ -3,14 +3,10 @@ import { jsx } from "react/jsx-runtime";
 import { Inbox, MessageSquare } from "lucide-react";
 import { useKitLabels } from "../i18n/kit-labels.js";
 import { TopBarActionMenu } from "../shell/topbar-action-menu.js";
-import { FEEDBACK_CATEGORY_META } from "./feedback-inbox.js";
+import { FEEDBACK_CATEGORY_META } from "./feedback-vocabulary.js";
 import { useFeedbackCategoryLabels } from "./feedback-labels.js";
 import { FEEDBACK_PICKABLE_CATEGORIES } from "./feedback-record.js";
-const DEFAULT_FEEDBACK_MENU_LABELS = {
-  trigger: "Send feedback",
-  myFeedback: "My feedback",
-  viewFeedback: "View feedback"
-};
+import { DEFAULT_FEEDBACK_MENU_LABELS } from "./feedback-menu-labels.js";
 function FeedbackMenu({
   onFile,
   isAdmin = false,
@@ -48,7 +44,7 @@ function FeedbackMenu({
     {
       icon: /* @__PURE__ */ jsx(MessageSquare, { className: "size-5" }),
       iconBadge,
-      ariaLabel: labels.trigger,
+      "aria-label": labels.trigger,
       entries,
       align
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/feedback-menu.tsx"],"sourcesContent":["import { Inbox, MessageSquare } from \"lucide-react\";\nimport type { UserAvatarBadge } from \"../components/user-avatar\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { TopBarActionMenu, type TopBarMenuEntry } from \"../shell/topbar-action-menu\";\nimport { FEEDBACK_CATEGORY_META, type FeedbackCategory } from \"./feedback-inbox\";\nimport { useFeedbackCategoryLabels } from \"./feedback-labels\";\nimport { FEEDBACK_PICKABLE_CATEGORIES } from \"./feedback-record\";\n\n/**\n * `feedbackMenu` — the top-bar feedback menu's own words (0.27.0). The four category rows\n * are `feedbackCategory`'s, shared with the badges and the dialog's picker. de-CH canon\n * (keksdose `de-CH.json`): `trigger` \"Feedback senden\", `myFeedback` \"Mein Feedback\",\n * `viewFeedback` \"Feedback ansehen\".\n */\nexport interface FeedbackMenuLabels {\n  /** The trigger's accessible name, and the menu's. keksdose `feedback.send`. */\n  trigger: string;\n  /** The link to the reporter's own reports — everyone but an admin. keksdose\n   *  `feedback.my_title`. */\n  myFeedback: string;\n  /** The link to the inbox — an admin's one list link, in place of \"My feedback\".\n   *  keksdose `feedback.view_all`. */\n  viewFeedback: string;\n}\n\nexport const DEFAULT_FEEDBACK_MENU_LABELS: FeedbackMenuLabels = {\n  trigger: \"Send feedback\",\n  myFeedback: \"My feedback\",\n  viewFeedback: \"View feedback\",\n};\n\nexport interface FeedbackMenuProps {\n  /** A category row was chosen — open the submit dialog on it (`useFeedbackSubmit`'s\n   *  `open`). Never called with `CRASH`: there is no row for it. */\n  onFile: (category: FeedbackCategory) => void;\n  /** The list link is \"View feedback\" → {@link inboxHref} INSTEAD of \"My feedback\" (§4.1,\n   *  keksdose `top-bar.tsx:205-214`). The admin check is the app's (kastlan's is\n   *  company-scoped). Default `false`. */\n  isAdmin?: boolean;\n  /**\n   * Rows of the app's own, between the divider and the list link — keksdose's\n   * `Sparkles` Help assistant → `/assistant` and `MessagesSquare` Support chat →\n   * `/support` with its unread chip. Any {@link TopBarMenuEntry}; keep their `key`s clear\n   * of the menu's own (`BUG`, `IDEA`, `QUESTION`, `OTHER`, `feedback-divider`,\n   * `my-feedback`, `view-feedback`).\n   */\n  extraEntries?: TopBarMenuEntry[];\n  /** The user's own reports, linked for everyone but an admin. Default `\"/my-feedback\"`\n   *  (§2.3). */\n  myFeedbackHref?: string;\n  /** The admin inbox, linked for an admin. Default `\"/feedback\"` (§2.3). */\n  inboxHref?: string;\n  /** A dot on the trigger — keksdose's unread support replies (`tone: \"danger\"`). Its\n   *  `label` joins the trigger's name (\"Send feedback 2 unread\"). The words are the app's. */\n  iconBadge?: UserAvatarBadge | null;\n  /** Prop > `<UiKitProvider labels={{ feedbackMenu }}>` > English. */\n  labels?: Partial<FeedbackMenuLabels>;\n  /** Which edge of the trigger the panel lines up with. Default `end`. */\n  align?: \"start\" | \"end\" | \"left\" | \"right\";\n}\n\n/**\n * The top-bar feedback menu, the same in every app (0.27.0, docs/feedback-harmonization.md\n * §4.1) — keksdose `frontend/src/app/top-bar.tsx:156` on the kit's `TopBarActionMenu`:\n *\n * 1. a `MessageSquare` trigger named \"Send feedback\", with an optional `iconBadge`;\n * 2. Bug · Idea · Question · Other (`Bug`, `Lightbulb`, `HelpCircle`, `MoreHorizontal` —\n *    the category badges' own glyphs), each calling `onFile(category)`;\n * 3. a divider, always;\n * 4. the app's `extraEntries`;\n * 5. ONE list link, `Inbox`: an admin's is \"View feedback\" → `/feedback`, everyone\n *    else's \"My feedback\" → `/my-feedback` — keksdose's (`top-bar.tsx:205-214`, feedback\n *    #331: admins get the management view, everyone else their own submissions).\n *\n * WHY A PRESET. Three apps had drawn three menus on the same primitive and they disagreed:\n * kastlan headed it \"New submission\", Kurvenschmiede \"Send feedback\" with a single link\n * that changed its words by role, keksdose had no heading and one link by role. keksdose\n * is the source (§2.4, §7.11): no heading, one link — the inbox for an admin, who reaches\n * their own reports there too — and the kit draws it, so the row order, the icons and the\n * words cannot drift again. Where the menu sits in the bar stays each app's.\n *\n * `CRASH` has no row and never will: crash reports are filed by the error boundary with\n * the stack and a fingerprint (keksdose feedback #160), and a hand-filed \"crash\" would sort\n * to the top like one with none of what makes it actionable. The server refuses it with a\n * 422 anyway (§3.4).\n *\n * The menu forwards nothing to its trigger, as `TopBarActionMenu` does not: keksdose's\n * tour anchor (`data-tour=\"feedback-menu\"`) stays on a wrapping `<span>`. Needs a router,\n * as every `TopBarActionMenu` with link rows does.\n */\nexport function FeedbackMenu({\n  onFile,\n  isAdmin = false,\n  extraEntries,\n  myFeedbackHref = \"/my-feedback\",\n  inboxHref = \"/feedback\",\n  iconBadge,\n  labels: labelsProp,\n  align,\n}: FeedbackMenuProps) {\n  const labels = useKitLabels(\"feedbackMenu\", DEFAULT_FEEDBACK_MENU_LABELS, labelsProp);\n  const categoryLabels = useFeedbackCategoryLabels();\n  const entries: TopBarMenuEntry[] = [\n    ...FEEDBACK_PICKABLE_CATEGORIES.map((category): TopBarMenuEntry => {\n      const Icon = FEEDBACK_CATEGORY_META[category].icon;\n      return {\n        key: category,\n        icon: <Icon className=\"size-4\" />,\n        label: categoryLabels[category],\n        onSelect: () => onFile(category),\n      };\n    }),\n    { kind: \"divider\", key: \"feedback-divider\" },\n    ...(extraEntries ?? []),\n    {\n      kind: \"link\",\n      key: isAdmin ? \"view-feedback\" : \"my-feedback\",\n      to: isAdmin ? inboxHref : myFeedbackHref,\n      icon: <Inbox className=\"size-4\" />,\n      label: isAdmin ? labels.viewFeedback : labels.myFeedback,\n    },\n  ];\n  return (\n    <TopBarActionMenu\n      icon={<MessageSquare className=\"size-5\" />}\n      iconBadge={iconBadge}\n      ariaLabel={labels.trigger}\n      entries={entries}\n      align={align}\n    />\n  );\n}\n"],"mappings":";AA2Gc;AA3Gd,SAAS,OAAO,qBAAqB;AAErC,SAAS,oBAAoB;AAC7B,SAAS,wBAA8C;AACvD,SAAS,8BAAqD;AAC9D,SAAS,iCAAiC;AAC1C,SAAS,oCAAoC;AAmBtC,MAAM,+BAAmD;AAAA,EAC9D,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,cAAc;AAChB;AA6DO,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAAsB;AACpB,QAAM,SAAS,aAAa,gBAAgB,8BAA8B,UAAU;AACpF,QAAM,iBAAiB,0BAA0B;AACjD,QAAM,UAA6B;AAAA,IACjC,GAAG,6BAA6B,IAAI,CAAC,aAA8B;AACjE,YAAM,OAAO,uBAAuB,QAAQ,EAAE;AAC9C,aAAO;AAAA,QACL,KAAK;AAAA,QACL,MAAM,oBAAC,QAAK,WAAU,UAAS;AAAA,QAC/B,OAAO,eAAe,QAAQ;AAAA,QAC9B,UAAU,MAAM,OAAO,QAAQ;AAAA,MACjC;AAAA,IACF,CAAC;AAAA,IACD,EAAE,MAAM,WAAW,KAAK,mBAAmB;AAAA,IAC3C,GAAI,gBAAgB,CAAC;AAAA,IACrB;AAAA,MACE,MAAM;AAAA,MACN,KAAK,UAAU,kBAAkB;AAAA,MACjC,IAAI,UAAU,YAAY;AAAA,MAC1B,MAAM,oBAAC,SAAM,WAAU,UAAS;AAAA,MAChC,OAAO,UAAU,OAAO,eAAe,OAAO;AAAA,IAChD;AAAA,EACF;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAM,oBAAC,iBAAc,WAAU,UAAS;AAAA,MACxC;AAAA,MACA,WAAW,OAAO;AAAA,MAClB;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/feedback/feedback-menu.tsx"],"sourcesContent":["import { Inbox, MessageSquare } from \"lucide-react\";\nimport type { UserAvatarBadge } from \"../components/user-avatar\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { TopBarActionMenu, type TopBarMenuEntry } from \"../shell/topbar-action-menu\";\nimport type { HoverMenuProps } from \"../components/hover-menu\";\n// The vocabulary module, not the inbox: this menu is in every app's top bar, the inbox\n// is a page (MOD-1).\nimport { FEEDBACK_CATEGORY_META, type FeedbackCategory } from \"./feedback-vocabulary\";\nimport { useFeedbackCategoryLabels } from \"./feedback-labels\";\nimport { FEEDBACK_PICKABLE_CATEGORIES } from \"./feedback-record\";\nimport { DEFAULT_FEEDBACK_MENU_LABELS } from \"./feedback-menu-labels\";\n\n/**\n * `feedbackMenu` — the top-bar feedback menu's own words (0.27.0). The four category rows\n * are `feedbackCategory`'s, shared with the badges and the dialog's picker. de-CH canon\n * (keksdose `de-CH.json`): `trigger` \"Feedback senden\", `myFeedback` \"Mein Feedback\",\n * `viewFeedback` \"Feedback ansehen\".\n */\nexport interface FeedbackMenuLabels {\n  /** The trigger's accessible name, and the menu's. keksdose `feedback.send`. */\n  trigger: string;\n  /** The link to the reporter's own reports — everyone but an admin. keksdose\n   *  `feedback.my_title`. */\n  myFeedback: string;\n  /** The link to the inbox — an admin's one list link, in place of \"My feedback\".\n   *  keksdose `feedback.view_all`. */\n  viewFeedback: string;\n}\n\n// Defined in ./feedback-menu-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_MENU_LABELS };\n\nexport interface FeedbackMenuProps {\n  /** A category row was chosen — open the submit dialog on it (`useFeedbackSubmit`'s\n   *  `open`). Never called with `CRASH`: there is no row for it. */\n  onFile: (category: FeedbackCategory) => void;\n  /** The list link is \"View feedback\" → {@link inboxHref} INSTEAD of \"My feedback\" (§4.1,\n   *  keksdose `top-bar.tsx:205-214`). The admin check is the app's (kastlan's is\n   *  company-scoped). Default `false`. */\n  isAdmin?: boolean;\n  /**\n   * Rows of the app's own, between the divider and the list link — keksdose's\n   * `Sparkles` Help assistant → `/assistant` and `MessagesSquare` Support chat →\n   * `/support` with its unread chip. Any {@link TopBarMenuEntry}; keep their `key`s clear\n   * of the menu's own (`BUG`, `IDEA`, `QUESTION`, `OTHER`, `feedback-divider`,\n   * `my-feedback`, `view-feedback`).\n   */\n  extraEntries?: TopBarMenuEntry[];\n  /** The user's own reports, linked for everyone but an admin. Default `\"/my-feedback\"`\n   *  (§2.3). */\n  myFeedbackHref?: string;\n  /** The admin inbox, linked for an admin. Default `\"/feedback\"` (§2.3). */\n  inboxHref?: string;\n  /** A dot on the trigger — keksdose's unread support replies (`tone: \"danger\"`). Its\n   *  `label` joins the trigger's name (\"Send feedback 2 unread\"). The words are the app's. */\n  iconBadge?: UserAvatarBadge | null;\n  /** Prop > `<UiKitProvider labels={{ feedbackMenu }}>` > English. */\n  labels?: LabelOverride<FeedbackMenuLabels>;\n  /** Which edge of the trigger the panel lines up with (see `HoverMenu`, whose type this\n   *  is: `left`/`right` are deprecated 0.34). Default `end`. */\n  align?: HoverMenuProps[\"align\"];\n}\n\n/**\n * The top-bar feedback menu, the same in every app (0.27.0, docs/feedback-harmonization.md\n * §4.1) — keksdose `frontend/src/app/top-bar.tsx:156` on the kit's `TopBarActionMenu`:\n *\n * 1. a `MessageSquare` trigger named \"Send feedback\", with an optional `iconBadge`;\n * 2. Bug · Idea · Question · Other (`Bug`, `Lightbulb`, `HelpCircle`, `MoreHorizontal` —\n *    the category badges' own glyphs), each calling `onFile(category)`;\n * 3. a divider, always;\n * 4. the app's `extraEntries`;\n * 5. ONE list link, `Inbox`: an admin's is \"View feedback\" → `/feedback`, everyone\n *    else's \"My feedback\" → `/my-feedback` — keksdose's (`top-bar.tsx:205-214`, feedback\n *    #331: admins get the management view, everyone else their own submissions).\n *\n * WHY A PRESET. Three apps had drawn three menus on the same primitive and they disagreed:\n * kastlan headed it \"New submission\", Kurvenschmiede \"Send feedback\" with a single link\n * that changed its words by role, keksdose had no heading and one link by role. keksdose\n * is the source (§2.4, §7.11): no heading, one link — the inbox for an admin, who reaches\n * their own reports there too — and the kit draws it, so the row order, the icons and the\n * words cannot drift again. Where the menu sits in the bar stays each app's.\n *\n * `CRASH` has no row and never will: crash reports are filed by the error boundary with\n * the stack and a fingerprint (keksdose feedback #160), and a hand-filed \"crash\" would sort\n * to the top like one with none of what makes it actionable. The server refuses it with a\n * 422 anyway (§3.4).\n *\n * The menu forwards nothing to its trigger, as `TopBarActionMenu` does not: keksdose's\n * tour anchor (`data-tour=\"feedback-menu\"`) stays on a wrapping `<span>`. Needs a router,\n * as every `TopBarActionMenu` with link rows does.\n */\nexport function FeedbackMenu({\n  onFile,\n  isAdmin = false,\n  extraEntries,\n  myFeedbackHref = \"/my-feedback\",\n  inboxHref = \"/feedback\",\n  iconBadge,\n  labels: labelsProp,\n  align,\n}: FeedbackMenuProps) {\n  const labels = useKitLabels(\"feedbackMenu\", DEFAULT_FEEDBACK_MENU_LABELS, labelsProp);\n  const categoryLabels = useFeedbackCategoryLabels();\n  const entries: TopBarMenuEntry[] = [\n    ...FEEDBACK_PICKABLE_CATEGORIES.map((category): TopBarMenuEntry => {\n      const Icon = FEEDBACK_CATEGORY_META[category].icon;\n      return {\n        key: category,\n        icon: <Icon className=\"size-4\" />,\n        label: categoryLabels[category],\n        onSelect: () => onFile(category),\n      };\n    }),\n    { kind: \"divider\", key: \"feedback-divider\" },\n    ...(extraEntries ?? []),\n    {\n      kind: \"link\",\n      key: isAdmin ? \"view-feedback\" : \"my-feedback\",\n      to: isAdmin ? inboxHref : myFeedbackHref,\n      icon: <Inbox className=\"size-4\" />,\n      label: isAdmin ? labels.viewFeedback : labels.myFeedback,\n    },\n  ];\n  return (\n    <TopBarActionMenu\n      icon={<MessageSquare className=\"size-5\" />}\n      iconBadge={iconBadge}\n      aria-label={labels.trigger}\n      entries={entries}\n      align={align}\n    />\n  );\n}\n"],"mappings":";AA6Gc;AA7Gd,SAAS,OAAO,qBAAqB;AAErC,SAAS,oBAAwC;AACjD,SAAS,wBAA8C;AAIvD,SAAS,8BAAqD;AAC9D,SAAS,iCAAiC;AAC1C,SAAS,oCAAoC;AAC7C,SAAS,oCAAoC;AAkFtC,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAAsB;AACpB,QAAM,SAAS,aAAa,gBAAgB,8BAA8B,UAAU;AACpF,QAAM,iBAAiB,0BAA0B;AACjD,QAAM,UAA6B;AAAA,IACjC,GAAG,6BAA6B,IAAI,CAAC,aAA8B;AACjE,YAAM,OAAO,uBAAuB,QAAQ,EAAE;AAC9C,aAAO;AAAA,QACL,KAAK;AAAA,QACL,MAAM,oBAAC,QAAK,WAAU,UAAS;AAAA,QAC/B,OAAO,eAAe,QAAQ;AAAA,QAC9B,UAAU,MAAM,OAAO,QAAQ;AAAA,MACjC;AAAA,IACF,CAAC;AAAA,IACD,EAAE,MAAM,WAAW,KAAK,mBAAmB;AAAA,IAC3C,GAAI,gBAAgB,CAAC;AAAA,IACrB;AAAA,MACE,MAAM;AAAA,MACN,KAAK,UAAU,kBAAkB;AAAA,MACjC,IAAI,UAAU,YAAY;AAAA,MAC1B,MAAM,oBAAC,SAAM,WAAU,UAAS;AAAA,MAChC,OAAO,UAAU,OAAO,eAAe,OAAO;AAAA,IAChD;AAAA,EACF;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAM,oBAAC,iBAAc,WAAU,UAAS;AAAA,MACxC;AAAA,MACA,cAAY,OAAO;AAAA,MACnB;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}

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

@@ -1,101 +1,239 @@
-export { F as FEEDBACK_ATTACHMENT_ACCEPT, r as FEEDBACK_AUTHOR_EDITABLE_STATUSES, s as FEEDBACK_AWAITING_STATUSES, v as FEEDBACK_PICKABLE_CATEGORIES, w as FEEDBACK_REWORKABLE_STATUSES, $ as FeedbackContext, ah as FeedbackEnvironment, as as FeedbackRecord, aY as appendRework, aZ as attachmentName, a_ as feedbackAttachmentLine, bc as isImageAttachment, bf as replaceDescription, bg as reworkCount, bi as splitBodyAttachments, bj as splitDescription } from '../delete-account-setting-DAgGBrbn.js';
-import 'react';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/write-lock.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import '../hooks/use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/user-avatar.js';
-import '../lib/person-name.js';
-import '../shell/topbar-action-menu.js';
-import '../components/menu-item.js';
-import '../components/floating-panel.js';
-import '../hooks/use-authed-src.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../i18n/plurals.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
+import type { FeedbackCategory, FeedbackStatus } from "./feedback-vocabulary.js";
+/**
+ * One feedback report as the three apps send it, and the facts the kit reads off it.
+ *
+ * Until 0.27 the inbox parts took no report at all ("no `Feedback` type in this file",
+ * feedback-inbox.tsx): keksdose kept its reporter context in a JSON column, kastlan a
+ * thinner copy of it, Kurvenschmiede a `page_path` and the bytes in the row. Marcel's
+ * feedback round (2026-10-04, docs/feedback-harmonization.md) settled one API contract
+ * for all three — keksdose's, read off its code — so the apps now share one shape and the
+ * kit can take a row instead of a dozen loose values. This file is that shape (§3.1,
+ * §3.2), the contract's constants (§3.4, §3.5, §4.3) and the readers and writers of the
+ * one field whose format is itself contract: the body, which carries the rework rounds
+ * (§3.4) — lifted from keksdose `frontend/src/features/feedback/body-attachments.ts`.
+ *
+ * Plain functions and data, no components: everything here is as usable from a loop
+ * script's helper or a test as from a page.
+ */
+/** Which copy of an app a report came from — keksdose `app/deploy-environment.ts`.
+ *  Any other string is read as "not prod" (the admin list shows it upper-cased as a
+ *  chip, §4.3), so an app with a `staging` loses nothing. */
+export type FeedbackEnvironment = "prod" | "dev" | "local";
+/**
+ * The reporter's context, written by the submit dialog (keksdose
+ * `use-feedback-dialog.tsx:105`) — §3.2 of the contract.
+ *
+ * **Every key is optional on read**, and a reader treats a missing one as "unknown":
+ * kastlan's client sends six of them (no email, no version), Kurvenschmiede's old rows are
+ * backfilled from two columns with a path-only `url`, crash rows add their own (and
+ * `origin` / `environment` from the crash payload, §3.6 — older crash rows have neither),
+ * and an erased account's row keeps only an allow-list (§3.2: `environment` stays,
+ * `origin` goes). Extra keys are allowed — a server may add its own — hence the index
+ * signature.
+ */
+export interface FeedbackContext {
+    /** The full `location.href` at open time; `""` when "Attach current page URL" was off.
+     *  Readers also accept a path-only value (Kurvenschmiede's backfilled rows). */
+    url?: string;
+    /** Its pathname; `""` when the URL was withheld. */
+    route?: string;
+    /** `location.origin` — which copy of the app, not personal; never withheld. */
+    origin?: string;
+    /** {@link FeedbackEnvironment}, or whatever the app calls its other copies. */
+    environment?: FeedbackEnvironment | (string & {});
+    /** The submitter, as a snapshot. The server should overwrite the three `user_*` keys
+     *  from the session (Kurvenschmiede does), so nobody files in someone else's name. */
+    user_id?: number | null;
+    user_email?: string | null;
+    user_display_name?: string | null;
+    /** `"406x816"`. */
+    viewport?: string;
+    /** `navigator.userAgent`. */
+    ua?: string;
+    /** The app build (`__APP_VERSION__`). */
+    version?: string;
+    fingerprint?: string;
+    /** Which error boundary caught it. */
+    boundary?: "app" | "page" | (string & {});
+    online?: boolean;
+    occurrences?: number;
+    first_seen_at?: string;
+    last_seen_at?: string;
+    auto_reported?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * One report — `FeedbackResponse`, keksdose `schemas/feedback.py:117`, §3.1 of the
+ * contract. What `GET /feedback`, `GET /feedback/my`, `POST /feedback` and
+ * `PATCH /feedback/{id}` answer in all three apps.
+ *
+ * Extra fields are allowed and ignored (kastlan's `company_id`, `user_name`): an app's
+ * own row type with more fields is assignable to this one as it stands.
+ *
+ * There is **no rework counter field** — {@link reworkCount} reads it off the body, so
+ * nothing can forget to set it.
+ */
+export interface FeedbackRecord {
+    id: number;
+    /** `null`: the author's account was erased (keksdose live #275). */
+    user_id: number | null;
+    /** The admin list only (joined); `null` — or absent — on `/my`, create and update. */
+    user_email?: string | null;
+    /** 1–255 characters, never blank. */
+    title: string;
+    /** `""` when none. Rework rounds are appended here (§3.4) — read it with
+     *  {@link splitDescription} / {@link splitBodyAttachments}, write it with
+     *  {@link appendRework} / {@link replaceDescription}. */
+    body: string;
+    category: FeedbackCategory;
+    status: FeedbackStatus;
+    /** §3.2; `null` on rows that have none. */
+    context: FeedbackContext | null;
+    /** The ONE captured screenshot's attachment URL, or `null`. */
+    screenshot_url: string | null;
+    /** 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. */
+    outcome: string | null;
+    /** Set on ENTERING `DONE` / `WONT_DO`, cleared on leaving them. ISO 8601. */
+    resolved_at: string | null;
+    /** ISO 8601. */
+    created_at: string;
+    /** ISO 8601. */
+    updated_at: string;
+}
+/** The image types `FeedbackAttachmentField` takes when `accept` is not given. */
+export declare const DEFAULT_ATTACHMENT_ACCEPT: string[];
+/** 10 MB, the contract's size limit for one file (§3.5). */
+export declare const DEFAULT_MAX_ATTACHMENT_BYTES: number;
+/** How many files `<FeedbackAttachmentField multiple>` takes when `max` is not given
+ *  (0.15.5). Five photos of one problem is already a lot to look through; a report
+ *  that needs more is a conversation, which the thread is for. */
+export declare const DEFAULT_MAX_ATTACHMENTS = 5;
+/**
+ * What a report may carry (§3.5, keksdose `upload_guards.py:197` and its
+ * `attachment-options.ts`): the kit's four image types plus a PDF and a plain-text log
+ * (keksdose feedback #87). SVG and HTML stay out — both are script-carrying documents in
+ * an image's clothing. For `FeedbackAttachmentField` / `FeedbackDialog`'s `accept`, with
+ * `DEFAULT_MAX_ATTACHMENTS` (5) and `DEFAULT_MAX_ATTACHMENT_BYTES` (10 MB) above, which
+ * already are the contract's limits.
+ *
+ * A plain array (not frozen) because `accept` takes `string[]`, as
+ * `DEFAULT_ATTACHMENT_ACCEPT` does — copy it before changing it.
+ */
+export declare const FEEDBACK_ATTACHMENT_ACCEPT: string[];
+/**
+ * The categories a person can pick — every one but `CRASH`, in triage order (Bug, Idea,
+ * Question, Other: the feedback menu's rows, §4.1). `CRASH` is filed by an error boundary
+ * and the server refuses it by hand with a 422 (keksdose `_reject_manual_crash`), so no
+ * picker may offer it.
+ */
+export declare const FEEDBACK_PICKABLE_CATEGORIES: readonly FeedbackCategory[];
+/**
+ * The statuses a report can be sent back for **rework** from (§3.4): everything the team
+ * has answered — `IN_EVALUATION`, `NEEDS_LIVE_TEST`, `POSTPONED`, `DONE`, `WONT_DO`. On
+ * these the server reopens the row when the body grows by a rework block; on `OPEN`,
+ * `READY` and `IN_PROGRESS` there is nothing to send back yet.
+ */
+export declare const FEEDBACK_REWORKABLE_STATUSES: readonly FeedbackStatus[];
+/**
+ * The statuses in which the AUTHOR may still edit title, body and category (§3.4,
+ * keksdose `canAuthorEdit`, `feedback-page.tsx:398`): `OPEN`, `READY` and `IN_PROGRESS`.
+ * Once the team has answered, the description is what they answered and stays as it
+ * was; a correction goes in as a rework.
+ */
+export declare const FEEDBACK_AUTHOR_EDITABLE_STATUSES: readonly FeedbackStatus[];
+/**
+ * The statuses that wait on the person triaging: filed and not yet triaged (`OPEN`,
+ * since READY took over "released for implementation" in 0.31, feedback contract §8.2),
+ * answered and handed back for a verdict, or answered and only checkable on a deployed
+ * build (keksdose `AWAITING_VERDICT`, live #330). The phone's "Only what is waiting for
+ * you" toggle narrows the inbox to exactly these (§4.3).
+ */
+export declare const FEEDBACK_AWAITING_STATUSES: readonly FeedbackStatus[];
+/** The body line for one uploaded attachment — what {@link appendRework} writes under
+ *  the note. */
+export declare function feedbackAttachmentLine(url: string): string;
+/**
+ * A rework round appended to a body — the exact text `PATCH /feedback/{id}` takes as the
+ * new `body` (§3.4; keksdose `submitRework`, `feedback-page.tsx:350`):
+ *
+ * ```text
+ * <old body>\n\n--- REWORK 2026-10-04 09:12 ---\n<note>\n[screenshot] /api/v1/feedback/attachments/<key>
+ * ```
+ *
+ * - The stamp is UTC, `YYYY-MM-DD HH:MM` (`toISOString().slice(0, 16)`), from `now`.
+ * - The old body is kept byte for byte, so the result STRICTLY EXTENDS it — which is
+ *   how the server recognises an append and reopens an answered row (keksdose
+ *   `_is_rework_append`, live #331). `\n\n` is left out when the old body is `""`.
+ * - ONE file per round (`url`), uploaded first by the caller: a body appended without
+ *   it would be a rework whose evidence never arrived.
+ *
+ * **Returns `null` when the trimmed note is empty** — a file alone cannot be sent
+ * (keksdose `:577`). Null rather than a throw because an empty note is something a
+ * person does, not a bug, and the type then makes every caller decide what an empty
+ * box means before anything can reach the PATCH.
+ *
+ * **Throws a `TypeError` when `url` is not an attachment URL** of the contract's shape
+ * (`/api/v1/feedback/attachments/<key>`): that one IS a bug — the upload handed back
+ * something foreign — and written anyway it would sit in the body as prose that no
+ * reader recognises as a file.
+ */
+export declare function appendRework(body: string, note: string, url?: string | null, now?: Date): string | null;
+/**
+ * How many times a report has been sent back — the count of `--- REWORK … ---` rule
+ * lines in its body (keksdose live #331: the "category for items in rework", derived
+ * rather than stored, so nothing can forget to set it or leave it set). Folded kastlan
+ * comments do not count.
+ */
+export declare function reworkCount(body: string): number;
+/**
+ * A body split into the prose to render and the files to show beside it, in body order.
+ *
+ * The file lines are stripped from the text: they are a location, not something anybody
+ * wrote, and left in they would put a raw URL in the middle of a sentence. Trailing blank
+ * lines go (what a stripped marker leaves at the end of a note); every blank line between
+ * paragraphs stays.
+ */
+export declare function splitBodyAttachments(body: string): {
+    text: string;
+    urls: string[];
+};
+/**
+ * The ORIGINAL description, apart from everything appended to it since (§4.4.1).
+ *
+ * - `description` — what the author wrote when filing, without its file lines and
+ *   trailing blank lines: the text the "Edit description" editor holds.
+ * - `appended` — every `--- REWORK … ---` round and folded `--- COMMENT … ---` block,
+ *   from the first one's rule line to the end, verbatim (`""` when there are none).
+ *
+ * keksdose's editor edits the raw body (`initial={fb.body}`, `feedback-page.tsx:420`), so
+ * an author tidying a typo could delete the rework history and the file lines with it.
+ * The kit's editor holds `description` only and saves through
+ * {@link replaceDescription}, which puts the rest back unchanged.
+ */
+export declare function splitDescription(body: string): {
+    description: string;
+    appended: string;
+};
+/**
+ * The body with its original description replaced and everything else kept — the file
+ * lines of the original part (after the new text, in their order) and the appended
+ * blocks (verbatim, after a blank line). The new text is trimmed; clearing it saves the
+ * rest alone (`""` when there is no rest).
+ *
+ * `replaceDescription(body, splitDescription(body).description)` gives back a canonical
+ * body unchanged — a trimmed description, then each block after one blank line, as the
+ * dialog and {@link appendRework} write them.
+ */
+export declare function replaceDescription(body: string, description: string): string;
+/**
+ * Whether an attachment URL is a picture (keksdose dev #578). The upload route takes
+ * PDFs and text logs too and serves them as downloads, never inline, so an `<img>` on
+ * one shows a broken icon. The key's extension is the server's own statement of the
+ * type (minted from the sniffed content), so it is the thing to read.
+ */
+export declare function isImageAttachment(url: string): boolean;
+/** The file name an attachment downloads as — its key, the last segment of the URL. */
+export declare function attachmentName(url: string): string;

package/dist/feedback/feedback-record.js

@@ -1,6 +1,8 @@
 "use client";
-import { DEFAULT_ATTACHMENT_ACCEPT } from "./feedback-attachment.js";
-import { FEEDBACK_CATEGORY_ORDER } from "./feedback-inbox.js";
+import { FEEDBACK_CATEGORY_ORDER } from "./feedback-vocabulary.js";
+const DEFAULT_ATTACHMENT_ACCEPT = ["image/png", "image/jpeg", "image/webp", "image/gif"];
+const DEFAULT_MAX_ATTACHMENT_BYTES = 10 * 1024 * 1024;
+const DEFAULT_MAX_ATTACHMENTS = 5;
 const FEEDBACK_ATTACHMENT_ACCEPT = [
   ...DEFAULT_ATTACHMENT_ACCEPT,
   "application/pdf",
@@ -89,6 +91,9 @@ function attachmentName(url) {
   return url.slice(url.lastIndexOf("/") + 1);
 }
 export {
+  DEFAULT_ATTACHMENT_ACCEPT,
+  DEFAULT_MAX_ATTACHMENTS,
+  DEFAULT_MAX_ATTACHMENT_BYTES,
   FEEDBACK_ATTACHMENT_ACCEPT,
   FEEDBACK_AUTHOR_EDITABLE_STATUSES,
   FEEDBACK_AWAITING_STATUSES,