@appinternalleads/ui 0.2.0 → 0.4.0

package/src/components/onboarding/shared/shape.ts

@@ -48,7 +48,8 @@ function shapeOf(presets: PresetsFile<object>): Shape {
 const MAX = 8;
 
 function check(value: unknown, shape: Shape, path: string, out: OnboardingIssue[]) {
-  if (out.length >= MAX || value === undefined || shape.kinds.size === 0) return;
+  /* Presets that only ever say `null` (an optional id no case sets) say nothing about its kind. */
+  if (out.length >= MAX || value === undefined || shape.kinds.size === 0 || (shape.kinds.size === 1 && shape.kinds.has('null'))) return;
   const k = typeof value === 'function' ? null : kindOf(value);
   if (k === null || !shape.kinds.has(k)) {
     const want = [...shape.kinds].map(x => NAMES[x]).join(' or ');

package/src/components/onboarding/shipping-update/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "shipping-update",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",

package/src/components/onboarding/status-page/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "status-page",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",

package/src/components/onboarding/tabbed/TabbedView.tsx

@@ -12,6 +12,7 @@ import { runOutcome, usePatternStatus, useSceneReport, useSeededReducer } from '
 import { useOperationRunner } from '../../../runtime/operations';
 import { Ghost, webOnly, type WebEvents } from '../data-view/parts';
 import { FlatGroups, SimplifiedNote } from '../fallback/FallbackView';
+import { FALLBACK_PRESETS, type FallbackCopy } from '../fallback/contract';
 import { flatten } from '../fallback/engine';
 import { TABBED_PRESETS, validateTabbed, type CollectionItem, type TabDecl, type TabbedScene, type TabbedSettings } from './contract';
 import { initialTabbed, NUMERIC, reduceTabbed, tabbedSeed, tabLabel, validity, type TabbedAction, type TabbedSeed, type TabbedState } from './engine';
@@ -70,6 +71,8 @@ function Valid({ config, density, status, operations, reload, initial, onTab, on
   const [state, send, ref] = useSeededReducer<TabbedState, TabbedAction>(reduceTabbed, () => initialTabbed(config, seed), key, () => runner.abortAll());
   const base = `tb-${useId().replace(/:/g, '')}`;
   const tabRefs = useRef<(View | null)[]>([]);
+  /** The invalid panel's words: Fallback's defaults (without its field labels), then `fallbackCopy`. */
+  const fb = useMemo<FallbackCopy>(() => ({ ...FALLBACK_PRESETS.base, fieldLabels: {}, ...config.fallbackCopy }), [config.fallbackCopy]);
 
   const fetchPanel = (i: number) => runOutcome(runner, `panel-${i}`, load, { index: i }, { ok: () => send({ type: 'loaded', index: i }), fail: () => send({ type: 'loaded', index: i }) });
   useEffect(() => { if (ref.current.busy !== null) fetchPanel(ref.current.busy); }, [key]);
@@ -137,6 +140,7 @@ function Valid({ config, density, status, operations, reload, initial, onTab, on
             tab={t}
             id={`${base}-${i}-p`}
             labelledBy={`${base}-${i}`}
+            copy={fb}
             active={i === state.active}
             loading={state.busy === i}
             onEmpty={() => onEmptyAction?.(i)}
@@ -148,8 +152,8 @@ function Valid({ config, density, status, operations, reload, initial, onTab, on
   );
 }
 
-function Panel({ tab, id, labelledBy, active, loading, onEmpty, onOpenFile }: {
-  tab: TabDecl; id: string; labelledBy: string; active: boolean; loading: boolean; onEmpty: () => void; onOpenFile?: (name: string) => void;
+function Panel({ tab, id, labelledBy, copy, active, loading, onEmpty, onOpenFile }: {
+  tab: TabDecl; id: string; labelledBy: string; copy: FallbackCopy; active: boolean; loading: boolean; onEmpty: () => void; onOpenFile?: (name: string) => void;
 }) {
   const fade = useSwap(active ? `on-${loading ? 'l' : 'r'}` : 'off');
   const v = validity(tab);
@@ -164,8 +168,8 @@ function Panel({ tab, id, labelledBy, active, loading, onEmpty, onOpenFile }: {
       style={{ opacity: fade, display: active ? 'flex' : 'none', minWidth: 0, borderRadius: blockRadii.inset }}>
       {loading ? <PanelSkeleton />
         : v === 'empty' ? <PanelEmpty tab={tab} onAction={onEmpty} />
-        : v === 'invalid' ? <Box style={{ gap: 12 }}><SimplifiedNote declared={String(tab.type)} /><FlatGroups flat={flatten(tab.data)} /></Box>
-        : <Renderer tab={tab} onOpenFile={onOpenFile} />}
+        : v === 'invalid' ? <Box style={{ gap: 12 }}><SimplifiedNote declared={String(tab.type)} copy={copy} /><FlatGroups flat={flatten(tab.data, copy)} /></Box>
+        : <Renderer tab={tab} copy={copy} onOpenFile={onOpenFile} />}
     </MotionView>
   );
 }
@@ -190,11 +194,11 @@ function PanelEmpty({ tab, onAction }: { tab: TabDecl; onAction: () => void }) {
 }
 
 /** The prototype's simplified renderers, one per declared type. */
-function Renderer({ tab, onOpenFile }: { tab: TabDecl; onOpenFile?: (name: string) => void }) {
+function Renderer({ tab, copy, onOpenFile }: { tab: TabDecl; copy: FallbackCopy; onOpenFile?: (name: string) => void }) {
   const { colors } = useDs();
   const d = tab.data as never;
   switch (tab.type) {
-    case 'keyvalue': return <FlatGroups flat={flatten(d)} />;
+    case 'keyvalue': return <FlatGroups flat={flatten(d, copy)} />;
     case 'text':
       return (
         <Box style={{ gap: 10, maxWidth: 560 }}>
@@ -283,7 +287,7 @@ function Renderer({ tab, onOpenFile }: { tab: TabDecl; onOpenFile?: (name: strin
         </View>
       );
     default:
-      return <FlatGroups flat={flatten(d)} />;
+      return <FlatGroups flat={flatten(d, copy)} />;
   }
 }
 

package/src/components/onboarding/tabbed/contract.ts

@@ -1,4 +1,5 @@
 import type { DataType } from '../../../tokens';
+import type { FallbackCopy, FlatCopy } from '../fallback/contract';
 import type { HeaderConfig, LoadCopy, OnboardingIssue, PresetsFile } from '../shared/contract';
 import presetsJson from './presets.json';
 
@@ -24,8 +25,16 @@ export type TabDecl = {
   emptyAction?: string;
 };
 
+/**
+ * **The words of a tab's invalid panel** — it is Fallback's simplified view, so these are Fallback's
+ * keys (the rows' words, the note, and how each declared type is named). Any left out keep Fallback's defaults.
+ */
+export type TabbedFallbackCopy = Partial<Pick<FallbackCopy, keyof FlatCopy | 'noteTitle' | 'noteText' | 'typeLabels'>>;
+
 export type TabbedSettings = HeaderConfig & LoadCopy & {
   tabs: TabDecl[];
+  /** The invalid panel's words (Fallback's copy keys). */
+  fallbackCopy?: TabbedFallbackCopy;
   /** 0-based. Default 0. */
   activeTab?: number;
   ship?: string;
@@ -47,5 +56,8 @@ export function validateTabbed(c: TabbedSettings): OnboardingIssue[] {
     if (!t.label) issues.push({ path: `tabs[${i}].label`, message: 'Every tab needs a label.' });
     if (!t.type) issues.push({ path: `tabs[${i}].type`, message: 'Every tab declares its output type.' });
   });
+  if (c.fallbackCopy != null && (typeof c.fallbackCopy !== 'object' || Array.isArray(c.fallbackCopy))) {
+    issues.push({ path: 'fallbackCopy', message: 'fallbackCopy is an object of Fallback’s copy keys.' });
+  }
   return issues;
 }

package/src/components/onboarding/tabbed/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "tabbed",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",
@@ -73,6 +75,31 @@
         "emptyAction": "Add a note"
       }
     ],
+    "fallbackCopy": {
+      "noDataLabel": "No data",
+      "yesLabel": "Yes",
+      "noLabel": "No",
+      "valueLabel": "Value",
+      "valuesLabel": "Values",
+      "itemLabel": "Item {n}",
+      "fieldsText": "{count} fields",
+      "fieldsOneText": "{count} field",
+      "itemsText": "{count} items",
+      "itemsOneText": "{count} item",
+      "noteTitle": "Showing a simplified view",
+      "noteText": "This {declared} didn’t match its expected format, so its fields are listed instead.",
+      "typeLabels": {
+        "stats": "stats",
+        "table": "table",
+        "Table": "table",
+        "comparison": "comparison",
+        "keyvalue": "key-value",
+        "sequence": "sequence",
+        "artifact": "files",
+        "collection": "collection",
+        "text": "text"
+      }
+    },
     "emptyTitle": "Nothing to show",
     "emptyBody": "This output has no tabs.",
     "emptyCta": "Refresh"

package/src/components/onboarding/table/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "table",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",
@@ -97,7 +99,14 @@
         "label": "Status",
         "type": "status",
         "width": 130,
-        "gen": null,
+        "gen": {
+          "pool": [
+            "Paid",
+            "Overdue",
+            "Sent",
+            "Draft"
+          ]
+        },
         "tones": {
           "Paid": "mint",
           "Overdue": "apricot",
@@ -110,7 +119,173 @@
       "Finance"
     ],
     "selectable": true,
-    "m15": false
+    "m15": false,
+    "sortingLabel": "Sorting…",
+    "allLoadedLabel": "All {count} loaded",
+    "loadedOfLabel": "{n} of {count} loaded",
+    "selectedLabel": "{n} selected",
+    "notShownLabel": "{n} not shown",
+    "selectLoadedLabel": "Select {n} loaded",
+    "deleteTitle": "Delete {count}?",
+    "exportTitle": "Export {count}",
+    "assignToLabel": "Assign to {count}",
+    "replaceAssigneesLabel": "Replace assignees on {count}",
+    "assignTitle": "Assign {count}",
+    "assignedText": "Assigned {count} to {to}",
+    "peopleCountLabel": "{n} people",
+    "deleteFailedText": "Couldn’t delete {count}",
+    "deletedText": "{count} deleted",
+    "openedText": "Opened {title}",
+    "exportedText": "Exported {count}",
+    "assignLabel": "Assign",
+    "assignEmptyLabel": "Assign to…",
+    "searchPeoplePlaceholder": "Search people",
+    "dismissLabel": "Dismiss notification",
+    "deleteLabel": "Delete",
+    "deletingLabel": "Deleting…",
+    "cancelLabel": "Cancel",
+    "confirmDeleteLabel": "Confirm delete",
+    "deleteWarningText": "This can’t be undone.",
+    "closeExportLabel": "Close export",
+    "sortByLabel": "Sort by",
+    "sortNoneLabel": "None",
+    "sortAscOptionLabel": "{label}, ascending",
+    "sortDescOptionLabel": "{label}, descending",
+    "moreSortsLabel": "+{n} sort",
+    "multiSortLabel": "Multi-sort",
+    "multiSortCountLabel": "Multi-sort · {n}",
+    "sortOrderLabel": "Sort order",
+    "multiSortHint": "Click to cycle ascending, descending, off",
+    "ascendingLabel": "Ascending",
+    "descendingLabel": "Descending",
+    "sortOffLabel": "Off",
+    "clearSortLabel": "Clear sort",
+    "sortColumnLabel": "Sort by {label}. Shift to add a sort",
+    "sortColumnAscLabel": "Sort by {label}, currently ascending. Shift to add a sort",
+    "sortColumnDescLabel": "Sort by {label}, currently descending. Shift to add a sort",
+    "selectRowLabel": "Select {title}",
+    "clearLabel": "Clear",
+    "exportLabel": "Export",
+    "footerLoadingLabel": "Loading…",
+    "copyTextLabel": "Copy as text",
+    "copiedLabel": "Copied",
+    "loadMoreLabel": "Load more",
+    "loadingMoreLabel": "Loading more…",
+    "loadMoreErrorText": "Couldn’t load more",
+    "opensInNewTabLabel": "{text} (opens in a new tab)",
+    "scoreGoodLabel": "good",
+    "scoreFairLabel": "fair",
+    "scoreLowLabel": "low",
+    "monthNames": [
+      "Jan",
+      "Feb",
+      "Mar",
+      "Apr",
+      "May",
+      "Jun",
+      "Jul",
+      "Aug",
+      "Sep",
+      "Oct",
+      "Nov",
+      "Dec"
+    ],
+    "relativePastText": "{t} ago",
+    "relativeFutureText": "in {t}",
+    "minutesShortText": "{n}m",
+    "hoursShortText": "{n}h",
+    "daysShortText": "{n}d",
+    "moreRowsText": "and {n} more",
+    "exportFormat": {
+      "loadingLabel": "Loading {title}",
+      "attentionLabel": "Needs attention",
+      "loadErrorTitle": "Couldn’t load this step",
+      "loadErrorBody": "Nothing was lost. Retry to load it again.",
+      "retryLabel": "Retry",
+      "emptyCta": "Refresh",
+      "type": "file",
+      "icon": "download",
+      "title": "Default export format",
+      "subtitle": "Used whenever someone exports from Analytics.",
+      "sampleName": "weekly-signups",
+      "defaultFormat": "csv",
+      "formats": [
+        {
+          "value": "csv",
+          "label": "CSV",
+          "ext": "csv",
+          "description": "Opens in any spreadsheet",
+          "preview": "date,signups,source\n2026-09-14,1284,organic\n2026-09-15,1310,paid\n2026-09-16,1197,referral\n2026-09-17,1352,organic",
+          "binary": false
+        },
+        {
+          "value": "json",
+          "label": "JSON",
+          "ext": "json",
+          "description": "For scripts and APIs",
+          "preview": "[\n  { \"date\": \"2026-09-14\", \"signups\": 1284, \"source\": \"organic\" },\n  { \"date\": \"2026-09-15\", \"signups\": 1310, \"source\": \"paid\" },\n  { \"date\": \"2026-09-16\", \"signups\": 1197, \"source\": \"referral\" }\n]",
+          "binary": false
+        },
+        {
+          "value": "xlsx",
+          "label": "XLSX",
+          "ext": "xlsx",
+          "description": "Excel workbook with types kept",
+          "preview": "Workbook · 1 sheet\nSheet 1 · 3 columns · 1,284 rows\nColumns: date (date), signups (number), source (text)",
+          "binary": true
+        },
+        {
+          "value": "parquet",
+          "label": "Parquet",
+          "ext": "parquet",
+          "description": "Columnar, for data warehouses",
+          "preview": "Parquet · snappy compression\n1 row group · 3 columns · 1,284 rows\nSchema: date DATE, signups INT32, source STRING",
+          "binary": true
+        }
+      ],
+      "exportLabel": "Export",
+      "exportingLabel": "Exporting…",
+      "exportedLabel": "Exported",
+      "exportedHint": "Saved to Downloads",
+      "copyLabel": "Copy",
+      "copiedLabel": "Copied",
+      "failTitle": "Export failed",
+      "failBody": "The file couldn’t be generated. Your settings haven’t changed; retry to try again.",
+      "emptyTitle": "No formats available",
+      "emptyBody": "Exports are turned off for this workspace.",
+      "failedChipLabel": "Export failed",
+      "generatingHintTemplate": "Generating {file}…",
+      "formatGroupLabel": "Export format",
+      "previewLabel": "Preview",
+      "copyAriaTemplate": "{copy} preview",
+      "structureLabel": "structure"
+    },
+    "assignPicker": {
+      "personCountOne": "{n} person",
+      "personCountOther": "{n} people",
+      "assignedToast": "Assigned {people}",
+      "assignFailedToast": "Couldn’t assign {people}",
+      "assignFailedInline": "Couldn’t assign. Nothing changed.",
+      "applyingLabel": "Assigning…",
+      "cancelLabel": "Cancel",
+      "maxHint": "Up to {max} people",
+      "selectedHead": "Selected · {n}",
+      "suggestedHead": "Suggested",
+      "resultsHead": "Results · {n}",
+      "resultsHeadEmpty": "Results",
+      "noResultsText": "No people match ‘{q}’",
+      "liveFoundOne": "{n} person found",
+      "liveFoundOther": "{n} people found",
+      "liveNoneFound": "No people found",
+      "searchingLabel": "Searching",
+      "clearSearchLabel": "Clear search",
+      "clearLabel": "Clear",
+      "listLabel": "People",
+      "noSuggText": "Type to search",
+      "searchErrorText": "Couldn’t search people",
+      "loadingMoreLabel": "Loading more…",
+      "loadMoreLabel": "Load more"
+    }
   },
   "cases": {
     "case1": {},
@@ -307,7 +482,14 @@
           "label": "Priority",
           "type": "status",
           "width": 120,
-          "gen": null,
+          "gen": {
+            "pool": [
+              "Urgent",
+              "High",
+              "Normal",
+              "Low"
+            ]
+          },
           "tones": {
             "Urgent": "apricot",
             "High": "apricot",
@@ -381,7 +563,8 @@
           "type": "link",
           "width": 120,
           "gen": {
-            "hex": true
+            "hex": true,
+            "digits": "0123456789abcdef"
           },
           "href": "https://git.example.com/commit/",
           "external": true
@@ -406,7 +589,13 @@
           "label": "Env",
           "type": "status",
           "width": 130,
-          "gen": null,
+          "gen": {
+            "pool": [
+              "Production",
+              "Staging",
+              "Preview"
+            ]
+          },
           "tones": {
             "Production": "plain",
             "Staging": "plain",
@@ -535,7 +724,14 @@
           "label": "Fulfilment",
           "type": "status",
           "width": 150,
-          "gen": null,
+          "gen": {
+            "pool": [
+              "Fulfilled",
+              "Unfulfilled",
+              "On hold",
+              "Partial"
+            ]
+          },
           "tones": {
             "Fulfilled": "mint",
             "Unfulfilled": "plain",
@@ -663,7 +859,14 @@
           "label": "Status",
           "type": "status",
           "width": 170,
-          "gen": null,
+          "gen": {
+            "pool": [
+              "Confirmed",
+              "Needs confirmation",
+              "Checked in",
+              "Cancelled"
+            ]
+          },
           "tones": {
             "Confirmed": "mint",
             "Needs confirmation": "apricot",
@@ -867,4 +1070,4 @@
       "scenario": "Read-only article analytics. Rows reveal with M15 (a 60ms stagger capped at 8, 600ms bar fills, counting numbers) and so does every infinite-scroll page. Bars scale to the largest loaded value, so a new page that raises it re-scales every bar in one tween."
     }
   }
-}
+}

package/src/components/onboarding/tag-cloud/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "tag-cloud",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",

package/src/components/onboarding/tag-creation/TagCreationView.tsx

@@ -88,7 +88,7 @@ function Valid({
           max={config.max}
           placeholder={config.placeholder}
           disabled={state.save === 'saving'}
-          error={v.duplicate ? 'Tag already exists' : undefined}
+          error={v.duplicate ? config.duplicateError : undefined}
           helper={v.helper}
         />
         {state.save === 'failed' ? <Box pt="s2"><Callout alert title={config.saveErrorTitle}>{config.saveErrorBody}</Callout></Box> : null}

package/src/components/onboarding/tag-creation/contract.ts

@@ -26,6 +26,17 @@ export type TagCreationSettings = HeaderConfig & LoadCopy & {
   savedHint: string;
   saveErrorTitle: string;
   saveErrorBody: string;
+  /** The chip and button while saving, and once saved. */
+  savingLabel: string;
+  savedLabel: string;
+  /** The field's error when the draft is already a tag. */
+  duplicateError: string;
+  /** Helper at `max`: `{max}`, `{nouns}`. */
+  atMaxHelp: string;
+  /** Helper with some tags: `{n}`, `{max}`. */
+  addHelp: string;
+  /** Footer count: `{n}`, `{max}`, `{nouns}`. */
+  countHint: string;
 };
 
 export const TAG_PRESETS = presetsJson as unknown as PresetsFile<TagCreationSettings>;

package/src/components/onboarding/tag-creation/engine.ts

@@ -1,5 +1,5 @@
 import type { StateChipTone } from '../../../ds';
-import type { SavePhase } from '../shared/contract';
+import { fill, type SavePhase } from '../shared/contract';
 import type { TagCreationSettings, TagScene } from './contract';
 
 /** **The Tag Creation engine** — pure: the tags, the draft, the save. */
@@ -45,11 +45,11 @@ export function tagView(c: TagCreationSettings, s: TagState) {
     duplicate: dup,
     atMax,
     scene: (s.save !== 'idle' ? s.save : dup ? 'duplicate' : atMax ? 'atMax' : s.draft ? 'typing' : n === 0 ? 'none' : 'default') as TagScene,
-    chip: s.save === 'saving' ? { tone: 'neutral' as StateChipTone, label: 'Saving…' }
-      : { tone: (s.save === 'saved' ? 'success' : 'neutral') as StateChipTone, label: s.save === 'saved' ? 'Saved' : `${n} ${n === 1 ? c.noun : c.nouns}` },
-    helper: atMax ? `You’ve reached ${c.max} ${c.nouns}. Remove one to add another.` : n === 0 ? c.emptyHelp : `Press Enter or comma to add · ${n} of ${c.max}`,
-    footerHint: s.save === 'saved' ? c.savedHint : `${n} of ${c.max} ${c.nouns}`,
-    primaryLabel: s.save === 'saving' ? 'Saving…' : s.save === 'saved' ? 'Saved' : s.save === 'failed' ? c.retryLabel : c.primaryLabel,
+    chip: s.save === 'saving' ? { tone: 'neutral' as StateChipTone, label: c.savingLabel }
+      : { tone: (s.save === 'saved' ? 'success' : 'neutral') as StateChipTone, label: s.save === 'saved' ? c.savedLabel : `${n} ${n === 1 ? c.noun : c.nouns}` },
+    helper: atMax ? fill(c.atMaxHelp, { max: c.max, nouns: c.nouns }) : n === 0 ? c.emptyHelp : fill(c.addHelp, { n, max: c.max }),
+    footerHint: s.save === 'saved' ? c.savedHint : fill(c.countHint, { n, max: c.max, nouns: c.nouns }),
+    primaryLabel: s.save === 'saving' ? c.savingLabel : s.save === 'saved' ? c.savedLabel : s.save === 'failed' ? c.retryLabel : c.primaryLabel,
     canSave: s.save !== 'saving' && s.save !== 'saved',
   };
 }

package/src/components/onboarding/tag-creation/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "tag-creation",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",
@@ -23,6 +25,12 @@
     "savedHint": "Saved · tags appear on new posts",
     "saveErrorTitle": "Couldn’t save tags",
     "saveErrorBody": "Your tags are still here. Retry when you’re ready.",
+    "savingLabel": "Saving…",
+    "savedLabel": "Saved",
+    "duplicateError": "Tag already exists",
+    "atMaxHelp": "You’ve reached {max} {nouns}. Remove one to add another.",
+    "addHelp": "Press Enter or comma to add · {n} of {max}",
+    "countHint": "{n} of {max} {nouns}",
     "emptyTitle": "Tags are turned off",
     "emptyBody": "Turn tags on to organise posts.",
     "emptyCta": "Turn on tags"

package/src/components/onboarding/terms-consent/TermsConsentView.tsx

@@ -2,7 +2,7 @@ import { useEffect } from 'react';
 import { Box, ExternalLink, Icon, Text } from '../../../core';
 import { Callout, Checkbox } from '../../../ds';
 import { blockRadii, useDs, type DensityName } from '../../../tokens';
-import { resolveConfig, type OnboardingPreset, type OnboardingResult, type PatternStatus } from '../shared/contract';
+import { fill, resolveConfig, type OnboardingPreset, type OnboardingResult, type PatternStatus } from '../shared/contract';
 import type { OnboardingOperation } from '../shared/mock';
 import { InvalidConfig } from '../shared/InvalidConfig';
 import { OnboardingCard } from '../shared/OnboardingCard';
@@ -77,7 +77,7 @@ function Valid({
               <Box flex={1} style={{ minWidth: 0 }}>
                 <Checkbox
                   label={it.label}
-                  labelSuffix={it.required ? '' : ' (optional)'}
+                  labelSuffix={it.required ? '' : ` ${config.optionalSuffix}`}
                   description={it.description}
                   checked={state.checks[i]!}
                   disabled={v.locked}
@@ -87,9 +87,9 @@ function Valid({
               {it.href ? (
                 <ExternalLink
                   href={it.href}
-                  aria-label={`Read ${it.label} (opens in a new tab)`}
+                  aria-label={fill(config.readLinkAria, { label: it.label })}
                   style={{ flexDirection: 'row', alignItems: 'center', gap: 4, paddingHorizontal: 6, paddingVertical: 4, marginTop: 8, borderRadius: blockRadii.inset }}>
-                  <Text variant="caption" style={{ fontSize: 12, fontWeight: '600', color: colors.textPrimary }}>Read</Text>
+                  <Text variant="caption" style={{ fontSize: 12, fontWeight: '600', color: colors.textPrimary }}>{config.readLinkLabel}</Text>
                   <Icon name="external" size={13} color={colors.textSecondary} />
                 </ExternalLink>
               ) : null}

package/src/components/onboarding/terms-consent/contract.ts

@@ -19,6 +19,19 @@ export type TermsConsentSettings = HeaderConfig & LoadCopy & {
   acceptedHint: string;
   failTitle: string;
   failBody: string;
+  /** Chip and button while accepting, and once accepted. */
+  acceptingLabel: string;
+  acceptedLabel: string;
+  /** Chip before accepting: `{n}` checked of `{total}` required. */
+  requiredCountLabel: string;
+  /** Footer once every required item is checked, and before. */
+  readyHint: string;
+  pendingHint: string;
+  /** After an optional item's label — "(optional)". */
+  optionalSuffix: string;
+  /** The link to read an item, and its accessible name (`{label}`). */
+  readLinkLabel: string;
+  readLinkAria: string;
 };
 
 export const TERMS_PRESETS = presetsJson as unknown as PresetsFile<TermsConsentSettings>;

package/src/components/onboarding/terms-consent/engine.ts

@@ -1,4 +1,5 @@
 import type { StateChipTone } from '../../../ds';
+import { fill } from '../shared/contract';
 import type { TermsConsentSettings, TermsScene } from './contract';
 
 /** **The Terms Consent engine** — pure: which boxes are checked, and accepting. */
@@ -41,10 +42,10 @@ export function termsView(c: TermsConsentSettings, s: TermsState) {
     all,
     locked: s.run === 'accepting' || s.run === 'accepted',
     scene: (s.run !== 'idle' ? s.run : all && req > 0 ? 'allChecked' : ok > 0 ? 'partial' : 'default') as TermsScene,
-    chip: s.run === 'accepting' ? { tone: 'neutral' as StateChipTone, label: 'Accepting…' }
-      : { tone: (s.run === 'accepted' ? 'success' : 'neutral') as StateChipTone, label: s.run === 'accepted' ? 'Accepted' : `${ok} of ${req} required` },
-    footerHint: s.run === 'accepted' ? c.acceptedHint : all ? 'Ready to continue' : 'Accept the required items to continue',
-    primaryLabel: s.run === 'accepting' ? 'Accepting…' : s.run === 'accepted' ? 'Accepted' : s.run === 'failed' ? c.retryLabel : c.primaryLabel,
+    chip: s.run === 'accepting' ? { tone: 'neutral' as StateChipTone, label: c.acceptingLabel }
+      : { tone: (s.run === 'accepted' ? 'success' : 'neutral') as StateChipTone, label: s.run === 'accepted' ? c.acceptedLabel : fill(c.requiredCountLabel, { n: ok, total: req }) },
+    footerHint: s.run === 'accepted' ? c.acceptedHint : all ? c.readyHint : c.pendingHint,
+    primaryLabel: s.run === 'accepting' ? c.acceptingLabel : s.run === 'accepted' ? c.acceptedLabel : s.run === 'failed' ? c.retryLabel : c.primaryLabel,
     canAccept: all && s.run !== 'accepting' && s.run !== 'accepted',
   };
 }

package/src/components/onboarding/terms-consent/presets.json

@@ -1,6 +1,8 @@
 {
   "component": "terms-consent",
   "baseCopy": {
+    "loadingLabel": "Loading {title}",
+    "attentionLabel": "Needs attention",
     "loadErrorTitle": "Couldn’t load this step",
     "loadErrorBody": "Nothing was lost. Retry to load it again.",
     "retryLabel": "Retry",
@@ -35,6 +37,14 @@
     "acceptedHint": "Thanks · you can review these in Settings",
     "failTitle": "Couldn’t record your consent",
     "failBody": "Nothing was saved. Check your connection, then retry.",
+    "acceptingLabel": "Accepting…",
+    "acceptedLabel": "Accepted",
+    "requiredCountLabel": "{n} of {total} required",
+    "readyHint": "Ready to continue",
+    "pendingHint": "Accept the required items to continue",
+    "optionalSuffix": "(optional)",
+    "readLinkLabel": "Read",
+    "readLinkAria": "Read {label} (opens in a new tab)",
     "emptyTitle": "Nothing to accept",
     "emptyBody": "There are no terms for this account.",
     "emptyCta": "Continue"