@burojs/ui-shadcn 0.7.0 → 0.8.0

package/dist/use-record-subtitle-gIaCGgbI.js

@@ -0,0 +1,53 @@
+import { resolveEnumLabel } from "@burojs/core";
+import { useApp, useI18nCaps, useListAccess } from "@burojs/react";
+import { useCallback } from "react";
+//#region src/resource/use-record-subtitle.ts
+function declaredSubtitle(fns, record, ctx) {
+	for (const fn of fns) {
+		const out = fn?.(record, ctx);
+		if (out === null) return null;
+		if (typeof out === "string" && out.trim() !== "") return out;
+	}
+}
+function useRecordSubtitle(resource, override) {
+	const app = useApp();
+	const caps = useI18nCaps(resource);
+	const own = app.registry.get(resource)?.recordSubtitle;
+	return useCallback((record) => {
+		if (override === void 0 && own === void 0) return void 0;
+		return declaredSubtitle([override, own], record, { resolveEnum: (namespace, value, inlineDefault) => resolveEnumLabel(caps, namespace, value, inlineDefault) });
+	}, [
+		override,
+		own,
+		caps
+	]);
+}
+function useRowSubtitle(target, override) {
+	const app = useApp();
+	const access = useListAccess(target);
+	const def = app.registry.get(target);
+	const resolve = useRecordSubtitle(target, override);
+	const declares = override !== void 0 || def?.recordSubtitle !== void 0;
+	return useCallback((row) => {
+		if (!declares || access.status !== "ready") return void 0;
+		const declaredId = (def?.data)?.idField;
+		const idField = typeof declaredId === "string" && declaredId !== "" ? declaredId : "id";
+		const visible = {};
+		for (const name of Object.keys(def?.fields ?? {})) if (Object.hasOwn(row, name) && access.fieldVisible(name)) visible[name] = row[name];
+		if (Object.hasOwn(row, idField)) visible[idField] = row[idField];
+		return resolve(visible);
+	}, [
+		declares,
+		access,
+		def,
+		resolve
+	]);
+}
+function optionSubtitle(declared, label, id) {
+	if (declared !== void 0) return declared;
+	return label === id ? null : `#${id}`;
+}
+//#endregion
+export { useRecordSubtitle as n, useRowSubtitle as r, optionSubtitle as t };
+
+//# sourceMappingURL=use-record-subtitle-gIaCGgbI.js.map

package/dist/use-record-subtitle-gIaCGgbI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-record-subtitle-gIaCGgbI.js","names":[],"sources":["../src/resource/use-record-subtitle.ts"],"sourcesContent":["'use client';\nimport { type RecordTitleContext, resolveEnumLabel } from '@burojs/core';\nimport { useApp, useI18nCaps, useListAccess } from '@burojs/react';\nimport { useCallback } from 'react';\n\n/**\n * A record's second line as code declares it (REF-136): the resource's `recordSubtitle`, or a\n * relation field's `optionSubtitle` for that field's options. A string is the line, `null` says\n * there is none, `undefined` (or a blank string) leaves it to the surface.\n */\nexport type RecordSubtitleFn = (\n  record: Readonly<Record<string, unknown>>,\n  ctx?: RecordTitleContext,\n) => string | null | undefined;\n\n/** The first of `fns` that decides: a non-blank string, or `null`; else `undefined`. */\nfunction declaredSubtitle(\n  fns: readonly (RecordSubtitleFn | undefined)[],\n  record: Readonly<Record<string, unknown>>,\n  ctx: RecordTitleContext,\n): string | null | undefined {\n  for (const fn of fns) {\n    const out = fn?.(record, ctx);\n    if (out === null) return null;\n    if (typeof out === 'string' && out.trim() !== '') return out;\n  }\n  return undefined;\n}\n\n/**\n * The declared subtitle of one of `resource`'s records: `override` first, then the resource's\n * `recordSubtitle`. Hand it a record as its viewer may read it (projected in record reach); a row of\n * a list goes through {@link useRowSubtitle}. Like `recordTitle`, the hooks are called with an i18n\n * context bound to the resource, so an enum label in the line follows the active locale.\n */\nexport function useRecordSubtitle(\n  resource: string,\n  override?: RecordSubtitleFn,\n): (record: Readonly<Record<string, unknown>>) => string | null | undefined {\n  const app = useApp();\n  const caps = useI18nCaps(resource);\n  const own: RecordSubtitleFn | undefined = app.registry.get(resource)?.recordSubtitle;\n  return useCallback(\n    (record) => {\n      if (override === undefined && own === undefined) return undefined;\n      return declaredSubtitle([override, own], record, {\n        resolveEnum: (namespace, value, inlineDefault) =>\n          resolveEnumLabel(caps, namespace, value, inlineDefault),\n      });\n    },\n    [override, own, caps],\n  );\n}\n\n/**\n * The declared subtitle of a row a list surface shows (picker options, palette results): the hooks\n * see only the row's declared fields its user may view in any-record reach, and its id (P5 spec\n * 3.6, as a list title reads only a visible display field). Undecided access declares nothing.\n */\nexport function useRowSubtitle(\n  target: string,\n  override?: RecordSubtitleFn,\n): (row: Readonly<Record<string, unknown>>) => string | null | undefined {\n  const app = useApp();\n  const access = useListAccess(target);\n  const def = app.registry.get(target);\n  const resolve = useRecordSubtitle(target, override);\n  const declares = override !== undefined || def?.recordSubtitle !== undefined;\n  return useCallback(\n    (row) => {\n      if (!declares || access.status !== 'ready') return undefined;\n      const declaredId = (def?.data as { readonly idField?: unknown } | undefined)?.idField;\n      const idField = typeof declaredId === 'string' && declaredId !== '' ? declaredId : 'id';\n      const visible: Record<string, unknown> = {};\n      for (const name of Object.keys(def?.fields ?? {}))\n        if (Object.hasOwn(row, name) && access.fieldVisible(name)) visible[name] = row[name];\n      if (Object.hasOwn(row, idField)) visible[idField] = row[idField];\n      return resolve(visible);\n    },\n    [declares, access, def, resolve],\n  );\n}\n\n/**\n * A picker option's second line: the declared subtitle, else the option's `#<id>` — not drawn when\n * the label already is the id, which would print it twice (REF-40). `null`: none.\n */\nexport function optionSubtitle(\n  declared: string | null | undefined,\n  label: string,\n  id: string,\n): string | null {\n  if (declared !== undefined) return declared;\n  return label === id ? null : `#${id}`;\n}\n"],"mappings":";;;;AAgBA,SAAS,iBACP,KACA,QACA,KAC2B;CAC3B,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,MAAM,KAAK,QAAQ,GAAG;EAC5B,IAAI,QAAQ,MAAM,OAAO;EACzB,IAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,MAAM,IAAI,OAAO;CAC3D;AAEF;AAQA,SAAgB,kBACd,UACA,UAC0E;CAC1E,MAAM,MAAM,OAAO;CACnB,MAAM,OAAO,YAAY,QAAQ;CACjC,MAAM,MAAoC,IAAI,SAAS,IAAI,QAAQ,CAAC,EAAE;CACtE,OAAO,aACJ,WAAW;EACV,IAAI,aAAa,KAAA,KAAa,QAAQ,KAAA,GAAW,OAAO,KAAA;EACxD,OAAO,iBAAiB,CAAC,UAAU,GAAG,GAAG,QAAQ,EAC/C,cAAc,WAAW,OAAO,kBAC9B,iBAAiB,MAAM,WAAW,OAAO,aAAa,EAC1D,CAAC;CACH,GACA;EAAC;EAAU;EAAK;CAAI,CACtB;AACF;AAOA,SAAgB,eACd,QACA,UACuE;CACvE,MAAM,MAAM,OAAO;CACnB,MAAM,SAAS,cAAc,MAAM;CACnC,MAAM,MAAM,IAAI,SAAS,IAAI,MAAM;CACnC,MAAM,UAAU,kBAAkB,QAAQ,QAAQ;CAClD,MAAM,WAAW,aAAa,KAAA,KAAa,KAAK,mBAAmB,KAAA;CACnE,OAAO,aACJ,QAAQ;EACP,IAAI,CAAC,YAAY,OAAO,WAAW,SAAS,OAAO,KAAA;EACnD,MAAM,cAAc,KAAK,KAAA,EAAqD;EAC9E,MAAM,UAAU,OAAO,eAAe,YAAY,eAAe,KAAK,aAAa;EACnF,MAAM,UAAmC,CAAC;EAC1C,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,GAC9C,IAAI,OAAO,OAAO,KAAK,IAAI,KAAK,OAAO,aAAa,IAAI,GAAG,QAAQ,QAAQ,IAAI;EACjF,IAAI,OAAO,OAAO,KAAK,OAAO,GAAG,QAAQ,WAAW,IAAI;EACxD,OAAO,QAAQ,OAAO;CACxB,GACA;EAAC;EAAU;EAAQ;EAAK;CAAO,CACjC;AACF;AAMA,SAAgB,eACd,UACA,OACA,IACe;CACf,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO,UAAU,KAAK,OAAO,IAAI;AACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burojs/ui-shadcn",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "license": "MIT",
   "description": "Buro: default shadcn+Tailwind UI kit with required testid attributes",
   "type": "module",
@@ -120,11 +120,11 @@
     "tw-animate-css": "^1.4.0",
     "unist-util-visit": "^5",
     "zod": "^3.24.0",
-    "@burojs/core": "0.7.0",
-    "@burojs/field-types": "0.7.0",
-    "@burojs/file-storage": "0.7.0",
-    "@burojs/i18n-core": "0.7.0",
-    "@burojs/react": "0.7.0"
+    "@burojs/core": "0.8.0",
+    "@burojs/field-types": "0.8.0",
+    "@burojs/file-storage": "0.8.0",
+    "@burojs/i18n-core": "0.8.0",
+    "@burojs/react": "0.8.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -147,9 +147,9 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.5.0",
     "vitest": "^4.0.0",
-    "@burojs/context": "0.7.0",
-    "@burojs/export": "0.7.0",
-    "@burojs/testing": "0.7.0",
+    "@burojs/context": "0.8.0",
+    "@burojs/export": "0.8.0",
+    "@burojs/testing": "0.8.0",
     "@burojs/tooling-eslint": "0.0.0",
     "@burojs/tooling-globals": "0.0.0",
     "@burojs/tooling-tsconfig": "0.0.0"

package/dist/bulk-summary-BWSAS7k2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bulk-summary-BWSAS7k2.js","names":[],"sources":["../src/flows/bulk-summary.tsx"],"sourcesContent":["'use client';\nimport { BULK_SUMMARY_IDS, type BulkProgress, type DataError } from '@burojs/core';\nimport {\n  type ErrorTextPlace,\n  kindErrorText,\n  specificErrorText,\n  useI18nCaps,\n  useOptionalT,\n  useTestIds,\n} from '@burojs/react';\nimport { useForgetEachAttempt } from '@burojs/react/flows';\nimport { type ReactElement, useState } from 'react';\nimport { Button } from '../primitives/button.js';\n\nexport interface FlowBulkSummaryProps {\n  readonly resource: string;\n  readonly actionName: string;\n  /** The action's label. */\n  readonly label: string;\n  /** How many ids the run was given. */\n  readonly total: number;\n  readonly progress: BulkProgress;\n  /** The action's declared texts (`texts.validation`, `texts.rejected`): the resolver's action place. */\n  readonly texts?: unknown;\n}\n\n/** One line of a group: the ids that read the same text; `text` absent for a group without lines. */\ninterface SummaryLine {\n  readonly text?: string;\n  readonly ids: readonly string[];\n}\n\ninterface SummaryGroup {\n  readonly key: string;\n  readonly title: string;\n  readonly lines: readonly SummaryLine[];\n}\n\n/** The ids by their text, in the order each text first appears. */\nfunction linesByText(entries: readonly { readonly id: string; readonly text: string }[]) {\n  const lines = new Map<string, string[]>();\n  for (const { id, text } of entries) {\n    const ids = lines.get(text);\n    if (ids === undefined) lines.set(text, [id]);\n    else ids.push(id);\n  }\n  return [...lines].map(([text, ids]): SummaryLine => ({ text, ids }));\n}\n\n/**\n * A bulk flow's summary (P4 spec 4.16, T1 spec 4.17): the count that succeeded of the ids given\n * (the flow's own `resources.<r>.actions.<name>.summary`, `{{count}}` of `{{total}}`, else the\n * framework's count text), then one group per other outcome with its count and up to\n * `BULK_SUMMARY_IDS` ids per line. The ids the server answered for are grouped first by\n * `applied` — not applied (refused or failed) and may have been applied (unknown) — and then by\n * the text each one's error resolves to (spec 4.15, with the action as the place), so\n * \"3 records: Already linked\" and \"2 records: Not allowed\" are separate lines. Not processed\n * (gone or its precondition failed), unresolved from an earlier run and not attempted keep their\n * own groups. Every text resolves at render, so a language switch re-renders it.\n */\nexport function FlowBulkSummary({\n  resource,\n  actionName,\n  label,\n  total,\n  progress,\n  texts,\n}: FlowBulkSummaryProps): ReactElement {\n  const t = useOptionalT();\n  const caps = useI18nCaps(resource);\n  // An id the run left unknown, or found unresolved, has its exit here (P4-C review I3): the user\n  // checked the record, and the id's attempt is forgotten — the next run sends it again.\n  const forget = useForgetEachAttempt({ resource, action: actionName });\n  const [forgotten, setForgotten] = useState<ReadonlySet<string>>(() => new Set());\n  const forgetText = t('flow.forget', { defaultValue: \"I've checked — forget it\" });\n  const tid = useTestIds();\n  const testid = tid.bulkSummary(resource, actionName);\n  const own = `resources.${resource}.actions.${actionName}.summary`;\n  const count = progress.success.length;\n  const heading = caps.has(own, { count })\n    ? caps.t(own, { params: { total }, count })\n    : `${label}: ${t('flow.bulkSummary', { defaultValue: `${count} processed`, params: { total }, count })} / ${total}`;\n  // A bulk flow is a resource's action: its texts live under `resources.<r>.actions.<name>`.\n  const place: ErrorTextPlace = {\n    action: { prefix: `resources.${resource}.actions.${actionName}`, texts },\n  };\n  const textCaps = { has: (key: string) => caps.has(key), t: caps.t };\n  // Steps 1 to 5 of spec 4.15; the fallback is the outcome's own sentence.\n  const textOf = (error: DataError | undefined, fallback: () => string): string =>\n    (error === undefined\n      ? undefined\n      : (specificErrorText(error, textCaps, place) ??\n        kindErrorText(error.kind, textCaps, place))) ?? fallback();\n  const neutral = () =>\n    t('flow.rejected.validation', { defaultValue: 'Not accepted. Nothing was saved.' });\n  const notProcessed = progress.rejected.filter((entry) => entry.reason !== 'server');\n  const notApplied = [\n    ...progress.rejected\n      .filter((entry) => entry.reason === 'server')\n      .map((entry) => ({ id: entry.id, text: textOf(entry.error, neutral) })),\n    ...progress.failed.map((entry) => ({\n      id: entry.id,\n      text: textOf(entry.error, () =>\n        entry.reason === 'reread'\n          ? t('flow.couldNotReread', {\n              defaultValue: \"Couldn't re-read the record. Nothing was sent.\",\n            })\n          : t('flow.failed', {\n              defaultValue: 'The request could not be sent. Nothing was saved.',\n            }),\n      ),\n    })),\n  ];\n  const unknown = progress.unknown\n    .filter((entry) => !forgotten.has(entry.id))\n    .map((entry) => ({\n      id: entry.id,\n      text: textOf(entry.error, () =>\n        entry.error?.applied === 'partial'\n          ? t('flow.unknownPartial', {\n              defaultValue: 'Part of this may have been applied. Nothing was resent.',\n            })\n          : t('flow.unknown', { defaultValue: 'It may have been applied. Nothing was resent.' }),\n      ),\n    }));\n  const groups: readonly SummaryGroup[] = [\n    {\n      key: 'not-processed',\n      title: t('flow.rejected.precondition', {\n        defaultValue: 'The record changed. Nothing was sent.',\n      }),\n      lines: [{ ids: notProcessed.map((entry) => entry.id) }],\n    },\n    {\n      key: 'not-applied',\n      title: t('flow.bulkNotApplied', { defaultValue: 'Not applied' }),\n      lines: linesByText(notApplied),\n    },\n    {\n      key: 'unknown',\n      title: t('flow.bulkMayHaveBeenApplied', { defaultValue: 'May have been applied' }),\n      lines: linesByText(unknown),\n    },\n    {\n      key: 'unresolved',\n      title: t('flow.bulkUnresolved', {\n        defaultValue: 'Skipped: an earlier request for it may have been applied.',\n      }),\n      lines: [{ ids: progress.unresolved.filter((id) => !forgotten.has(id)) }],\n    },\n    {\n      key: 'not-attempted',\n      title: t('flow.bulkNotAttempted', { defaultValue: 'Not attempted.' }),\n      lines: [{ ids: progress.notAttempted }],\n    },\n  ];\n  const sizeOf = (group: SummaryGroup) =>\n    group.lines.reduce((sum, line) => sum + line.ids.length, 0);\n  return (\n    <div data-testid={testid} className=\"flex flex-col gap-3 text-sm\">\n      <p data-testid={`${testid}:heading`} className=\"font-medium\">\n        {heading}\n      </p>\n      {groups\n        .filter((group) => sizeOf(group) > 0)\n        .map((group) => (\n          <section key={group.key} data-testid={`${testid}:${group.key}`}>\n            <h3 className=\"font-medium\">\n              {group.title}{' '}\n              <span data-testid={`${testid}:${group.key}:count`} className=\"tabular-nums\">\n                ({sizeOf(group)})\n              </span>\n            </h3>\n            {group.lines.map((line, index) => (\n              <div\n                key={line.text ?? index}\n                data-testid={line.text === undefined ? undefined : `${testid}:${group.key}:line`}\n              >\n                {line.text === undefined ? null : (\n                  <p>\n                    {t('flow.bulkLine', {\n                      defaultValue: `${line.ids.length}: ${line.text}`,\n                      params: { message: line.text },\n                      count: line.ids.length,\n                    })}\n                  </p>\n                )}\n                <ul className=\"flex flex-wrap gap-1 text-muted-foreground\">\n                  {line.ids.slice(0, BULK_SUMMARY_IDS).map((id) => (\n                    <li\n                      key={id}\n                      data-testid={`${testid}:${group.key}:${id}`}\n                      className=\"flex items-center gap-1\"\n                    >\n                      {id}\n                      {group.key === 'unknown' || group.key === 'unresolved' ? (\n                        <Button\n                          type=\"button\"\n                          size=\"sm\"\n                          variant=\"ghost\"\n                          className=\"h-6 px-1.5 text-xs\"\n                          data-testid={`${testid}:forget:${id}`}\n                          onClick={() =>\n                            void forget(id).then(() =>\n                              setForgotten((previous) => new Set([...previous, id])),\n                            )\n                          }\n                        >\n                          {forgetText}\n                        </Button>\n                      ) : null}\n                    </li>\n                  ))}\n                  {line.ids.length > BULK_SUMMARY_IDS ? (\n                    <li>+{line.ids.length - BULK_SUMMARY_IDS}</li>\n                  ) : null}\n                </ul>\n              </div>\n            ))}\n          </section>\n        ))}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/bulk-summary-CrEij5vq.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"bulk-summary-CrEij5vq.cjs","names":["useOptionalT","useI18nCaps","useForgetEachAttempt","useState","useTestIds","specificErrorText","kindErrorText","BULK_SUMMARY_IDS","Button"],"sources":["../src/flows/bulk-summary.tsx"],"sourcesContent":["'use client';\nimport { BULK_SUMMARY_IDS, type BulkProgress, type DataError } from '@burojs/core';\nimport {\n  type ErrorTextPlace,\n  kindErrorText,\n  specificErrorText,\n  useI18nCaps,\n  useOptionalT,\n  useTestIds,\n} from '@burojs/react';\nimport { useForgetEachAttempt } from '@burojs/react/flows';\nimport { type ReactElement, useState } from 'react';\nimport { Button } from '../primitives/button.js';\n\nexport interface FlowBulkSummaryProps {\n  readonly resource: string;\n  readonly actionName: string;\n  /** The action's label. */\n  readonly label: string;\n  /** How many ids the run was given. */\n  readonly total: number;\n  readonly progress: BulkProgress;\n  /** The action's declared texts (`texts.validation`, `texts.rejected`): the resolver's action place. */\n  readonly texts?: unknown;\n}\n\n/** One line of a group: the ids that read the same text; `text` absent for a group without lines. */\ninterface SummaryLine {\n  readonly text?: string;\n  readonly ids: readonly string[];\n}\n\ninterface SummaryGroup {\n  readonly key: string;\n  readonly title: string;\n  readonly lines: readonly SummaryLine[];\n}\n\n/** The ids by their text, in the order each text first appears. */\nfunction linesByText(entries: readonly { readonly id: string; readonly text: string }[]) {\n  const lines = new Map<string, string[]>();\n  for (const { id, text } of entries) {\n    const ids = lines.get(text);\n    if (ids === undefined) lines.set(text, [id]);\n    else ids.push(id);\n  }\n  return [...lines].map(([text, ids]): SummaryLine => ({ text, ids }));\n}\n\n/**\n * A bulk flow's summary (P4 spec 4.16, T1 spec 4.17): the count that succeeded of the ids given\n * (the flow's own `resources.<r>.actions.<name>.summary`, `{{count}}` of `{{total}}`, else the\n * framework's count text), then one group per other outcome with its count and up to\n * `BULK_SUMMARY_IDS` ids per line. The ids the server answered for are grouped first by\n * `applied` — not applied (refused or failed) and may have been applied (unknown) — and then by\n * the text each one's error resolves to (spec 4.15, with the action as the place), so\n * \"3 records: Already linked\" and \"2 records: Not allowed\" are separate lines. Not processed\n * (gone or its precondition failed), unresolved from an earlier run and not attempted keep their\n * own groups. Every text resolves at render, so a language switch re-renders it.\n */\nexport function FlowBulkSummary({\n  resource,\n  actionName,\n  label,\n  total,\n  progress,\n  texts,\n}: FlowBulkSummaryProps): ReactElement {\n  const t = useOptionalT();\n  const caps = useI18nCaps(resource);\n  // An id the run left unknown, or found unresolved, has its exit here (P4-C review I3): the user\n  // checked the record, and the id's attempt is forgotten — the next run sends it again.\n  const forget = useForgetEachAttempt({ resource, action: actionName });\n  const [forgotten, setForgotten] = useState<ReadonlySet<string>>(() => new Set());\n  const forgetText = t('flow.forget', { defaultValue: \"I've checked — forget it\" });\n  const tid = useTestIds();\n  const testid = tid.bulkSummary(resource, actionName);\n  const own = `resources.${resource}.actions.${actionName}.summary`;\n  const count = progress.success.length;\n  const heading = caps.has(own, { count })\n    ? caps.t(own, { params: { total }, count })\n    : `${label}: ${t('flow.bulkSummary', { defaultValue: `${count} processed`, params: { total }, count })} / ${total}`;\n  // A bulk flow is a resource's action: its texts live under `resources.<r>.actions.<name>`.\n  const place: ErrorTextPlace = {\n    action: { prefix: `resources.${resource}.actions.${actionName}`, texts },\n  };\n  const textCaps = { has: (key: string) => caps.has(key), t: caps.t };\n  // Steps 1 to 5 of spec 4.15; the fallback is the outcome's own sentence.\n  const textOf = (error: DataError | undefined, fallback: () => string): string =>\n    (error === undefined\n      ? undefined\n      : (specificErrorText(error, textCaps, place) ??\n        kindErrorText(error.kind, textCaps, place))) ?? fallback();\n  const neutral = () =>\n    t('flow.rejected.validation', { defaultValue: 'Not accepted. Nothing was saved.' });\n  const notProcessed = progress.rejected.filter((entry) => entry.reason !== 'server');\n  const notApplied = [\n    ...progress.rejected\n      .filter((entry) => entry.reason === 'server')\n      .map((entry) => ({ id: entry.id, text: textOf(entry.error, neutral) })),\n    ...progress.failed.map((entry) => ({\n      id: entry.id,\n      text: textOf(entry.error, () =>\n        entry.reason === 'reread'\n          ? t('flow.couldNotReread', {\n              defaultValue: \"Couldn't re-read the record. Nothing was sent.\",\n            })\n          : t('flow.failed', {\n              defaultValue: 'The request could not be sent. Nothing was saved.',\n            }),\n      ),\n    })),\n  ];\n  const unknown = progress.unknown\n    .filter((entry) => !forgotten.has(entry.id))\n    .map((entry) => ({\n      id: entry.id,\n      text: textOf(entry.error, () =>\n        entry.error?.applied === 'partial'\n          ? t('flow.unknownPartial', {\n              defaultValue: 'Part of this may have been applied. Nothing was resent.',\n            })\n          : t('flow.unknown', { defaultValue: 'It may have been applied. Nothing was resent.' }),\n      ),\n    }));\n  const groups: readonly SummaryGroup[] = [\n    {\n      key: 'not-processed',\n      title: t('flow.rejected.precondition', {\n        defaultValue: 'The record changed. Nothing was sent.',\n      }),\n      lines: [{ ids: notProcessed.map((entry) => entry.id) }],\n    },\n    {\n      key: 'not-applied',\n      title: t('flow.bulkNotApplied', { defaultValue: 'Not applied' }),\n      lines: linesByText(notApplied),\n    },\n    {\n      key: 'unknown',\n      title: t('flow.bulkMayHaveBeenApplied', { defaultValue: 'May have been applied' }),\n      lines: linesByText(unknown),\n    },\n    {\n      key: 'unresolved',\n      title: t('flow.bulkUnresolved', {\n        defaultValue: 'Skipped: an earlier request for it may have been applied.',\n      }),\n      lines: [{ ids: progress.unresolved.filter((id) => !forgotten.has(id)) }],\n    },\n    {\n      key: 'not-attempted',\n      title: t('flow.bulkNotAttempted', { defaultValue: 'Not attempted.' }),\n      lines: [{ ids: progress.notAttempted }],\n    },\n  ];\n  const sizeOf = (group: SummaryGroup) =>\n    group.lines.reduce((sum, line) => sum + line.ids.length, 0);\n  return (\n    <div data-testid={testid} className=\"flex flex-col gap-3 text-sm\">\n      <p data-testid={`${testid}:heading`} className=\"font-medium\">\n        {heading}\n      </p>\n      {groups\n        .filter((group) => sizeOf(group) > 0)\n        .map((group) => (\n          <section key={group.key} data-testid={`${testid}:${group.key}`}>\n            <h3 className=\"font-medium\">\n              {group.title}{' '}\n              <span data-testid={`${testid}:${group.key}:count`} className=\"tabular-nums\">\n                ({sizeOf(group)})\n              </span>\n            </h3>\n            {group.lines.map((line, index) => (\n              <div\n                key={line.text ?? index}\n                data-testid={line.text === undefined ? undefined : `${testid}:${group.key}:line`}\n              >\n                {line.text === undefined ? null : (\n                  <p>\n                    {t('flow.bulkLine', {\n                      defaultValue: `${line.ids.length}: ${line.text}`,\n                      params: { message: line.text },\n                      count: line.ids.length,\n                    })}\n                  </p>\n                )}\n                <ul className=\"flex flex-wrap gap-1 text-muted-foreground\">\n                  {line.ids.slice(0, BULK_SUMMARY_IDS).map((id) => (\n                    <li\n                      key={id}\n                      data-testid={`${testid}:${group.key}:${id}`}\n                      className=\"flex items-center gap-1\"\n                    >\n                      {id}\n                      {group.key === 'unknown' || group.key === 'unresolved' ? (\n                        <Button\n                          type=\"button\"\n                          size=\"sm\"\n                          variant=\"ghost\"\n                          className=\"h-6 px-1.5 text-xs\"\n                          data-testid={`${testid}:forget:${id}`}\n                          onClick={() =>\n                            void forget(id).then(() =>\n                              setForgotten((previous) => new Set([...previous, id])),\n                            )\n                          }\n                        >\n                          {forgetText}\n                        </Button>\n                      ) : null}\n                    </li>\n                  ))}\n                  {line.ids.length > BULK_SUMMARY_IDS ? (\n                    <li>+{line.ids.length - BULK_SUMMARY_IDS}</li>\n                  ) : null}\n                </ul>\n              </div>\n            ))}\n          </section>\n        ))}\n    </div>\n  );\n}\n"],"mappings":"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"}