@eifi1/ui-kit 0.54.0 → 0.55.0

package/src/feedback/feedback-swipe.tsx

@@ -1,192 +0,0 @@
-import { Ban, Check, ChevronsRight } from "lucide-react";
-import type { SwipeAction } from "../components/swipeable-row";
-import type { MobileSwipeActions } from "../components/data-table";
-import { nextFeedbackStatus, visibleFeedbackStatuses, type FeedbackStatus } from "./feedback-vocabulary";
-import type { FeedbackStatusLabels } from "./feedback-labels";
-import type { FeedbackStatusChange, FeedbackStatusRow } from "./feedback-status-undo";
-
-/**
- * Swipes on the admin inbox's phone cards — §4.5 of the feedback contract, keksdose's
- * (`feedback-page.tsx:990`, feedback #144 rework item 4: *"it is a queue, and triaging it
- * one tap-into-the-row at a time is the slow way"*), for every app.
- *
- * - `advance` — one step along the chain (`nextFeedbackStatus`: OPEN → READY → IN_PROGRESS →
- *   IN_EVALUATION → DONE), labelled with the status it goes to;
- * - `done` — straight to DONE, for a row that plainly needs no stop on the way;
- * - `wont_do` — dismiss as WONT_DO.
- *
- * The same transitions the status column offers, so nothing is reachable by gesture that
- * is not reachable by tap. keksdose lets the user rebind them (Settings → Interaction,
- * feedback #404) and keeps that storage; kastlan and Kurvenschmiede take the default.
- */
-export const FEEDBACK_SWIPE_ACTIONS = ["advance", "done", "wont_do"] as const;
-
-/** One of {@link FEEDBACK_SWIPE_ACTIONS}. */
-export type FeedbackSwipeAction = (typeof FEEDBACK_SWIPE_ACTIONS)[number];
-
-/**
- * Which swipe does what — the same shape as 0.26's `TranslationReviewSwipeBinding`: per
- * LOGICAL side an ordered ladder, index 0 at the first threshold, index 1 at the longer
- * drag. `end` is a drag toward the reading end (right in a left-to-right page), `start`
- * the other way. keksdose stores PHYSICAL `right` / `left` ladders and hands
- * `{ end: right, start: left }`, as its translations page does
- * (`translations-page.tsx:280`).
- *
- * The ids are typed loosely on purpose: a stored binding carries keksdose's `"none"`
- * fillers and may carry an id from another version or another surface — they are
- * dropped (see {@link feedbackSwipePlan}), so it is passed in without a cast.
- */
-export interface FeedbackSwipeBinding {
-  /** A drag toward the reading START, nearest threshold first. */
-  start?: readonly (FeedbackSwipeAction | (string & {}))[];
-  /** A drag toward the reading END, nearest threshold first. */
-  end?: readonly (FeedbackSwipeAction | (string & {}))[];
-}
-
-/** keksdose's shipped binding (`swipe-prefs-store.ts:99`): toward the end advance, then
- *  done on the longer drag; toward the start won't do. A settings page's reset goes here. */
-export const DEFAULT_FEEDBACK_SWIPE: FeedbackSwipeBinding = Object.freeze({
-  start: Object.freeze(["wont_do"] as const),
-  end: Object.freeze(["advance", "done"] as const),
-});
-
-export interface FeedbackSwipeOptions {
-  /** What a swipe commits through: the undoable change from `useFeedbackStatusUndo`, the
-   *  same one the status cell and the detail's pills use — so a swipe gets the same 8 s
-   *  "Set to …" toast with Undo as a tap (§4.5, §7.10, Marcel 2026-10-04; keksdose's
-   *  `changeStatusUndoably` on its swipes too). A swipe is the easiest status change to
-   *  make by accident. The plan calls it and nothing else, so the page owns the PATCH. */
-  change: FeedbackStatusChange;
-  /** The status names the panels show — `useFeedbackStatusLabels()`. The `done` panel
-   *  reads DONE's, `wont_do` WONT_DO's, `advance` the next status's. */
-  labels: FeedbackStatusLabels;
-}
-
-/** Where an action takes a row, or null when it would do nothing from there. */
-function targetOf(id: string, status: FeedbackStatus): FeedbackStatus | null {
-  switch (id) {
-    case "advance":
-      // Null at the chain's end (DONE) and off it (NEEDS_LIVE_TEST, POSTPONED, WONT_DO):
-      // "advance" has no meaning there, and a threshold that commits nothing is a trap.
-      return nextFeedbackStatus(status);
-    case "done":
-      return status === "DONE" ? null : "DONE";
-    case "wont_do":
-      return status === "WONT_DO" ? null : "WONT_DO";
-    default:
-      // "none", or an id this version does not know: an empty slot.
-      return null;
-  }
-}
-
-/** One action's panel, by tone (0.33): SwipeableRow paints the tone's soft wash idle,
- *  and its fill under that fill's own foreground once armed — the same pairs in light
- *  and dark, where the fills turn pastel. */
-function panel(
-  id: FeedbackSwipeAction,
-  target: FeedbackStatus,
-  row: FeedbackStatusRow,
-  { change, labels }: FeedbackSwipeOptions,
-): SwipeAction {
-  const onCommit = () => change(row, target);
-  // `id`: the binding's own (0.46, dev#598) — DataTable's desktop column tells the
-  // actions apart by it, and `feedbackSwipeOmitShown` reads the target from it.
-  switch (id) {
-    case "advance":
-      return {
-        id,
-        onCommit,
-        label: labels[target],
-        icon: <ChevronsRight className="size-4" aria-hidden />,
-        tone: "info",
-      };
-    case "done":
-      return {
-        id,
-        onCommit,
-        label: labels.DONE,
-        icon: <Check className="size-4" aria-hidden />,
-        tone: "success",
-      };
-    case "wont_do":
-      return {
-        id,
-        onCommit,
-        label: labels.WONT_DO,
-        icon: <Ban className="size-4" aria-hidden />,
-        tone: "danger",
-      };
-  }
-}
-
-/**
- * The binding resolved against one row — what DataTable's `mobileSwipeActions` returns
- * for it, or `null` when the row offers no swipe at all:
- *
- * ```tsx
- * const changeStatus = useFeedbackStatusUndo(update.mutateAsync);
- * const statusLabels = useFeedbackStatusLabels();
- * <DataTable
- *   mobileSwipeActions={isAdmin && !mine
- *     ? (row) => feedbackSwipePlan(DEFAULT_FEEDBACK_SWIPE, row, { change: changeStatus, labels: statusLabels })
- *     : undefined}
- * />
- * ```
- *
- * Modelled on 0.26's `translationReviewSwipePlan` (keksdose's `resolveSwipePlan`): an
- * action the row cannot take DROPS OUT and the ladder closes up behind it, so the second
- * stage becomes the first instead of the side going dead behind an unreachable stage:
- *
- * - `advance` on DONE and off the chain (NEEDS_LIVE_TEST, POSTPONED, WONT_DO);
- * - `done` on DONE, `wont_do` on WONT_DO;
- * - `"none"` and any id this version does not know;
- * - a later stage that lands where an earlier one on the same side already does — the id
- *   named twice, or `done` behind `advance` on IN_EVALUATION (both go to DONE): a longer
- *   drag to the same effect would arm a threshold that adds nothing.
- *
- * Only what the ROW decides. Whether the page may write at all — the admin inbox, not
- * `/my-feedback`; no write lock — is the caller's, by passing no `mobileSwipeActions`.
- */
-export function feedbackSwipePlan(
-  binding: FeedbackSwipeBinding,
-  row: FeedbackStatusRow,
-  options: FeedbackSwipeOptions,
-): MobileSwipeActions | null {
-  const side = (ids: FeedbackSwipeBinding["start"]): SwipeAction[] => {
-    const reached = new Set<FeedbackStatus>();
-    const out: SwipeAction[] = [];
-    for (const id of ids ?? []) {
-      const target = targetOf(id, row.status);
-      if (target === null || reached.has(target)) continue;
-      reached.add(target);
-      out.push(panel(id as FeedbackSwipeAction, target, row, options));
-    }
-    return out;
-  };
-  const start = side(binding.start);
-  const end = side(binding.end);
-  if (start.length === 0 && end.length === 0) return null;
-  return { start, end };
-}
-
-/**
- * For DataTable's `desktopSwipeActions.omit` beside the kit's status cell (0.46, keksdose
- * dev#598 item 3): `true` for a planned action whose target status the cell already
- * offers as its own icon — {@link visibleFeedbackStatuses}, the next and the previous step
- * and the off-chain verdicts — so the desktop column adds only what the cell lacks ("Done"
- * where DONE is more than one step away). Read from the action's `id` and the row, never
- * from the translated label; an action without one of {@link FEEDBACK_SWIPE_ACTIONS} as its
- * id (an app's own) is kept.
- *
- * ```tsx
- * <DataTable
- *   mobileSwipeActions={(row) => feedbackSwipePlan(binding, row, options)}
- *   desktopSwipeActions={{ omit: feedbackSwipeOmitShown, name: (row) => row.title }}
- * />
- * ```
- */
-export function feedbackSwipeOmitShown(action: SwipeAction, row: FeedbackStatusRow): boolean {
-  if (action.id === undefined) return false;
-  const target = targetOf(action.id, row.status);
-  return target !== null && visibleFeedbackStatuses(row.status).includes(target);
-}

package/src/feedback/feedback-table-labels.ts

@@ -1,27 +0,0 @@
-// The English words of ./feedback-table, in a module with no component code: the English
-// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
-// chunk like the other languages (0.34, KS U8). ./feedback-table re-exports them.
-
-import type { FeedbackPageLabels } from "./feedback-table";
-
-export const DEFAULT_FEEDBACK_PAGE_LABELS: FeedbackPageLabels = {
-  title: "Feedback inbox",
-  myTitle: "My feedback",
-  columnId: "#",
-  columnDate: "Date",
-  columnCategory: "Category",
-  columnSubject: "Subject",
-  columnUser: "User",
-  columnEmail: "Email",
-  columnUrl: "URL",
-  columnStatus: "Status",
-  columnResolved: "Resolved",
-  openPage: "Open page",
-  empty: "None",
-  deletedUser: "<deleted user>",
-  userFallback: (id) => `user #${id}`,
-  environment: (environment) => String(environment ?? "").toUpperCase(),
-  reworkChip: (count) => (count === 1 ? "Rework" : `Rework ×${count}`),
-  awaitingFilter: "Only what is waiting for you",
-  phoneActions: "Feedback actions",
-};