feat(12.1-01): list row states from one controller call per page

- pact.ListRowStates with the fixed RowState set deleted, negative, disabled
- list response meta.row_states keyed by row id; unknown values dropped
- list messages rowStateDeleted, rowStateNegative, rowStateDisabled
- update writes through the scope the load used, so a soft-deleted record
  a controller includes stays soft-deleted
- DataTable row state badges and text styles
- roster fixture, smoke tests, OpenAPI, TS types, dist, READMEs, docs

admin/src/components/list/DataTable.vue

@@ -6,6 +6,7 @@ import type { AdminRecord, ListColumn } from '../../api/types'
 import { t } from '../../app/i18n'
 import type { RowId } from '../../app/listQuery'
 import CellValue from './CellValue.vue'
+import RowStateBadges from './RowStateBadges.vue'
 
 // Schema-driven table (design screen 3, D-12, D-16): exactly the server's
 // columns, each record read through its column keys. Optional checkbox
@@ -16,7 +17,11 @@ import CellValue from './CellValue.vue'
 // before the first column's text and the remaining columns muted. Phase
 // 12.2: with `openable` its rows open (the first cell's text is a button and
 // a row click outside other controls does the same), and `trailing` adds a
-// 56px last cell filled by the `trailing` slot.
+// 56px last cell filled by the `trailing` slot. Phase 12.1 (UI-SPEC S4): a
+// row may carry states from the fixed set deleted, negative, disabled; each
+// shows as a text badge after the first cell's text plus a text style, and
+// the row background, selection, sorting, links and row click stay as they
+// are. A value outside the set is ignored.
 
 const props = withDefaults(
   defineProps<{
@@ -33,6 +38,10 @@ const props = withDefaults(
     openable?: boolean
     /** Adds a trailing 56px cell per row, filled by the `trailing` slot. */
     trailing?: boolean
+    /** States per row id (list meta row_states). */
+    rowStates?: Record<string, string[]>
+    /** Badge text per state. */
+    stateLabels?: Record<string, string>
   }>(),
   {
     loading: false,
@@ -44,6 +53,8 @@ const props = withDefaults(
     variant: 'list',
     openable: false,
     trailing: false,
+    rowStates: () => ({}),
+    stateLabels: () => ({}),
   },
 )
 const emit = defineEmits<{
@@ -146,11 +157,34 @@ function initials(value: unknown): string {
     .join('')
 }
 
-function cellClass(column: ListColumn, columnIndex: number): string {
-  if (columnIndex === 0) {
-    return 'font-semibold'
+const ROW_STATES = ['deleted', 'negative', 'disabled']
+
+/** The row's known states in the fixed order; anything else is dropped. */
+function statesOf(row: AdminRecord): string[] {
+  const id = rowId(row)
+  const states = id === null ? undefined : props.rowStates[String(id)]
+  if (!Array.isArray(states)) {
+    return []
   }
-  return relation.value || column.relation ? 'text-muted' : ''
+  return ROW_STATES.filter((state) => states.includes(state))
+}
+
+function cellClass(column: ListColumn, columnIndex: number, states: string[] = []): string {
+  // A deleted or disabled row mutes every cell; the first keeps weight 600.
+  const muted = states.includes('deleted') || states.includes('disabled')
+  if (columnIndex === 0) {
+    return muted ? 'font-semibold text-muted' : 'font-semibold'
+  }
+  return muted || relation.value || column.relation ? 'text-muted' : ''
+}
+
+/** First-cell text of a row with states: struck through, danger or muted. */
+function stateTextClass(states: string[]): string[] {
+  return [
+    'min-w-0 truncate',
+    states.includes('deleted') ? 'line-through' : 'no-underline',
+    states.includes('negative') ? 'text-danger' : states.includes('deleted') || states.includes('disabled') ? 'text-muted' : 'text-text',
+  ]
 }
 
 const span = computed(() =>
@@ -238,6 +272,7 @@ const widths = ['w-3/5', 'w-2/5', 'w-1/2', 'w-3/4', 'w-1/3', 'w-2/3', 'w-1/2', '
               linkOf(row) || openable ? 'cursor-pointer' : '',
             ]"
             :aria-selected="selectable ? (isSelected(row) ? 'true' : 'false') : undefined"
+            :data-row-states="statesOf(row).length > 0 ? statesOf(row).join(' ') : undefined"
             class="border-b border-border transition-colors duration-150 ease-out"
             @click="openRow($event, row)"
           >
@@ -257,7 +292,7 @@ const widths = ['w-3/5', 'w-2/5', 'w-1/2', 'w-3/4', 'w-1/3', 'w-2/3', 'w-1/2', '
             <td
               v-for="(column, columnIndex) in columns"
               :key="column.key"
-              :class="cellClass(column, columnIndex)"
+              :class="cellClass(column, columnIndex, statesOf(row))"
               class="px-3.5 first:pl-5 last:pr-5"
             >
               <span v-if="relation && columnIndex === 0" class="flex items-center gap-3">
@@ -278,6 +313,15 @@ const widths = ['w-3/5', 'w-2/5', 'w-1/2', 'w-3/4', 'w-1/3', 'w-2/3', 'w-1/2', '
                 </button>
                 <CellValue v-else :column="column" :value="row[column.key]" />
               </span>
+              <span v-else-if="columnIndex === 0 && statesOf(row).length > 0" class="flex items-center gap-2">
+                <RouterLink v-if="linkOf(row)" :to="linkOf(row)!" :class="stateTextClass(statesOf(row))">
+                  <CellValue :column="column" :value="row[column.key]" />
+                </RouterLink>
+                <span v-else :class="stateTextClass(statesOf(row))">
+                  <CellValue :column="column" :value="row[column.key]" />
+                </span>
+                <RowStateBadges :states="statesOf(row)" :labels="stateLabels" />
+              </span>
               <RouterLink v-else-if="columnIndex === 0 && linkOf(row)" :to="linkOf(row)!" class="text-text no-underline">
                 <CellValue :column="column" :value="row[column.key]" />
               </RouterLink>