@tea-ui/ux-standards 0.1.0

package/dist/forms.js

@@ -0,0 +1,79 @@
+const VALIDATION_TIMING = {
+  onSubmit: "always",
+  onBlur: true,
+  onChangeAfterTouched: true,
+  onChangeFromFirstKeystroke: false
+};
+const FIELD_RULES = {
+  text: base("text"),
+  email: base("email"),
+  password: base("password"),
+  search: base("search"),
+  number: base("number"),
+  date: base("date"),
+  time: base("time"),
+  url: base("url"),
+  tel: base("tel"),
+  textarea: base("textarea"),
+  select: base("select"),
+  checkbox: base("checkbox"),
+  radio: base("radio"),
+  switch: base("switch"),
+  slider: base("slider"),
+  file: base("file"),
+  otp: base("otp")
+};
+function base(control) {
+  return {
+    control,
+    requiresLabelAssociation: true,
+    requiresDescribedBy: true,
+    requiresErrorAnnouncement: true,
+    requiresAccessibleName: true,
+    requiresRequiredState: true
+  };
+}
+const AUTOCOMPLETE = {
+  name: "name",
+  givenName: "given-name",
+  familyName: "family-name",
+  email: "email",
+  username: "username",
+  currentPassword: "current-password",
+  newPassword: "new-password",
+  oneTimeCode: "one-time-code",
+  organization: "organization",
+  streetAddress: "street-address",
+  postalCode: "postal-code",
+  addressLevel1: "address-level1",
+  addressLevel2: "address-level2",
+  country: "country",
+  tel: "tel",
+  url: "url",
+  newPasswordConfirm: "new-password"
+};
+const UNSAVED_CHANGES = {
+  /** Wording of the guard. `du` register, per the content standard. */
+  title: "Ungespeicherte \xC4nderungen",
+  detail: "Deine \xC4nderungen wurden noch nicht gespeichert. Wenn du die Seite verl\xE4sst, gehen sie verloren.",
+  confirmLabel: "Verwerfen und verlassen",
+  cancelLabel: "Weiter bearbeiten",
+  /** Saving before navigating is the better path, so it is offered first. */
+  preferSave: true
+};
+const FORM_INTERACTION = {
+  blockPaste: false,
+  blockAutofill: false,
+  /** Multi-step forms must allow going back without losing input. */
+  allowStepBack: true,
+  /** Validation must be correctable: a field the user cannot fix is a bug. */
+  allowFixingErrors: true
+};
+export {
+  AUTOCOMPLETE,
+  FIELD_RULES,
+  FORM_INTERACTION,
+  UNSAVED_CHANGES,
+  VALIDATION_TIMING
+};
+//# sourceMappingURL=forms.js.map

package/dist/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/forms.ts"],"sourcesContent":["/**\n * TEA UI — form standards.\n *\n * The audit found the same form field implemented five times in one project and\n * three times in the other, with four of the five using a `<label>` that was\n * never associated with its control — so most inputs in both products had no\n * accessible name at all. These constants are what make a field correct by\n * default rather than by remembering.\n */\n\nexport type FieldControl =\n  | \"text\"\n  | \"email\"\n  | \"password\"\n  | \"search\"\n  | \"number\"\n  | \"date\"\n  | \"time\"\n  | \"url\"\n  | \"tel\"\n  | \"textarea\"\n  | \"select\"\n  | \"checkbox\"\n  | \"radio\"\n  | \"switch\"\n  | \"slider\"\n  | \"file\"\n  | \"otp\";\n\n/**\n * When validation runs. \"Too eager\" and a form nobody can finish are the same\n * defect, so the default is: validate on blur, re-validate on change *after*\n * the field has been touched, and validate on submit. Never on every keystroke\n * from the first character.\n */\nexport const VALIDATION_TIMING = {\n  onSubmit: \"always\",\n  onBlur: true,\n  onChangeAfterTouched: true,\n  onChangeFromFirstKeystroke: false,\n} as const;\n\nexport interface FormFieldRules {\n  /** The control type, which decides the association and keyboard contract. */\n  readonly control: FieldControl;\n  /** `htmlFor` is mandatory. A label without it does not name the control. */\n  readonly requiresLabelAssociation: true;\n  /** A description must be linked with `aria-describedby`, not merely placed nearby. */\n  readonly requiresDescribedBy: true;\n  /** An error must be linked with `aria-describedby` AND announced. */\n  readonly requiresErrorAnnouncement: true;\n  /** Icon-only controls require an accessible name. */\n  readonly requiresAccessibleName: true;\n  /** Required state must be conveyed programmatically, not only with an asterisk. */\n  readonly requiresRequiredState: true;\n}\n\nexport const FIELD_RULES: Readonly<Record<FieldControl, FormFieldRules>> = {\n  text: base(\"text\"),\n  email: base(\"email\"),\n  password: base(\"password\"),\n  search: base(\"search\"),\n  number: base(\"number\"),\n  date: base(\"date\"),\n  time: base(\"time\"),\n  url: base(\"url\"),\n  tel: base(\"tel\"),\n  textarea: base(\"textarea\"),\n  select: base(\"select\"),\n  checkbox: base(\"checkbox\"),\n  radio: base(\"radio\"),\n  switch: base(\"switch\"),\n  slider: base(\"slider\"),\n  file: base(\"file\"),\n  otp: base(\"otp\"),\n};\n\nfunction base(control: FieldControl): FormFieldRules {\n  return {\n    control,\n    requiresLabelAssociation: true,\n    requiresDescribedBy: true,\n    requiresErrorAnnouncement: true,\n    requiresAccessibleName: true,\n    requiresRequiredState: true,\n  };\n}\n\n/**\n * `autocomplete` tokens. Auto-fill is an accessibility feature, not a\n * convenience: without it a user relying on a password manager has to type\n * what the browser already knows.\n */\nexport const AUTOCOMPLETE = {\n  name: \"name\",\n  givenName: \"given-name\",\n  familyName: \"family-name\",\n  email: \"email\",\n  username: \"username\",\n  currentPassword: \"current-password\",\n  newPassword: \"new-password\",\n  oneTimeCode: \"one-time-code\",\n  organization: \"organization\",\n  streetAddress: \"street-address\",\n  postalCode: \"postal-code\",\n  addressLevel1: \"address-level1\",\n  addressLevel2: \"address-level2\",\n  country: \"country\",\n  tel: \"tel\",\n  url: \"url\",\n  newPasswordConfirm: \"new-password\",\n} as const;\n\n/**\n * The unsaved-changes standard. Losing typed input to a navigation is a data\n * loss bug, so the guard is mandatory wherever a form can be abandoned — and\n * it is a TEA UI pattern, not something each product re-implements.\n */\nexport const UNSAVED_CHANGES = {\n  /** Wording of the guard. `du` register, per the content standard. */\n  title: \"Ungespeicherte Änderungen\",\n  detail: \"Deine Änderungen wurden noch nicht gespeichert. Wenn du die Seite verlässt, gehen sie verloren.\",\n  confirmLabel: \"Verwerfen und verlassen\",\n  cancelLabel: \"Weiter bearbeiten\",\n  /** Saving before navigating is the better path, so it is offered first. */\n  preferSave: true,\n} as const;\n\n/** Paste is never blocked. Masking an input must not break paste. */\nexport const FORM_INTERACTION = {\n  blockPaste: false,\n  blockAutofill: false,\n  /** Multi-step forms must allow going back without losing input. */\n  allowStepBack: true,\n  /** Validation must be correctable: a field the user cannot fix is a bug. */\n  allowFixingErrors: true,\n} as const;\n"],"mappings":"AAmCO,MAAM,oBAAoB;AAAA,EAC/B,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,sBAAsB;AAAA,EACtB,4BAA4B;AAC9B;AAiBO,MAAM,cAA8D;AAAA,EACzE,MAAM,KAAK,MAAM;AAAA,EACjB,OAAO,KAAK,OAAO;AAAA,EACnB,UAAU,KAAK,UAAU;AAAA,EACzB,QAAQ,KAAK,QAAQ;AAAA,EACrB,QAAQ,KAAK,QAAQ;AAAA,EACrB,MAAM,KAAK,MAAM;AAAA,EACjB,MAAM,KAAK,MAAM;AAAA,EACjB,KAAK,KAAK,KAAK;AAAA,EACf,KAAK,KAAK,KAAK;AAAA,EACf,UAAU,KAAK,UAAU;AAAA,EACzB,QAAQ,KAAK,QAAQ;AAAA,EACrB,UAAU,KAAK,UAAU;AAAA,EACzB,OAAO,KAAK,OAAO;AAAA,EACnB,QAAQ,KAAK,QAAQ;AAAA,EACrB,QAAQ,KAAK,QAAQ;AAAA,EACrB,MAAM,KAAK,MAAM;AAAA,EACjB,KAAK,KAAK,KAAK;AACjB;AAEA,SAAS,KAAK,SAAuC;AACnD,SAAO;AAAA,IACL;AAAA,IACA,0BAA0B;AAAA,IAC1B,qBAAqB;AAAA,IACrB,2BAA2B;AAAA,IAC3B,wBAAwB;AAAA,IACxB,uBAAuB;AAAA,EACzB;AACF;AAOO,MAAM,eAAe;AAAA,EAC1B,MAAM;AAAA,EACN,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,aAAa;AAAA,EACb,aAAa;AAAA,EACb,cAAc;AAAA,EACd,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,eAAe;AAAA,EACf,SAAS;AAAA,EACT,KAAK;AAAA,EACL,KAAK;AAAA,EACL,oBAAoB;AACtB;AAOO,MAAM,kBAAkB;AAAA;AAAA,EAE7B,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,aAAa;AAAA;AAAA,EAEb,YAAY;AACd;AAGO,MAAM,mBAAmB;AAAA,EAC9B,YAAY;AAAA,EACZ,eAAe;AAAA;AAAA,EAEf,eAAe;AAAA;AAAA,EAEf,mBAAmB;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { AnyStatusKey, STATUS, StatusDomain, StatusKey, StatusMeta, statusEntries, statusKeysWithTone, statusMeta } from './status.js';
+export { DEFAULT_DENSITY, DENSITIES, Density, MOTION, TONES, Tone, isDensity } from '@tea-ui/tokens';
+export { FEEDBACK, FEEDBACK_STATES, FeedbackKind, FeedbackMeta, FeedbackState, NON_DESTRUCTIVE_STATES, NonDestructiveState, feedbackAttr, feedbackMeta, isNonDestructive } from './feedback.js';
+export { CONSEQUENCE_LEVELS, ConsequenceLevel, DESTRUCTIVE_POLICY, DESTRUCTIVE_VERBS, DestructivePolicy, Protection, consequenceSentence, destructivePolicy } from './destructive.js';
+export { ERROR_TITLES, ErrorAnatomy, ErrorKind, ErrorRecovery, hasTechnicalDetail, renderErrorMessage, shouldOfferRetry, toErrorAnatomy } from './error-anatomy.js';
+export { AUTOCOMPLETE, FIELD_RULES, FORM_INTERACTION, FieldControl, FormFieldRules, UNSAVED_CHANGES, VALIDATION_TIMING } from './forms.js';
+export { COPY, FORBIDDEN_COPY, REGISTER, Register, fill } from './terminology.js';
+export { IA_LIMITS, InformationArchitecture, NAVIGATION_MECHANISMS, NAVIGATION_RULES, NavigationMechanism, NavigationRule, URL_SYNC } from './navigation.js';
+export { BACKGROUND_OPERATION, DATA_VIZ, DataVizRules, EMPTY_STATE_TITLES, EmptyStateAnatomy, EmptyStateTitle, LOADING_AFFORDANCE, MIN_SKELETON_MS, MOTION_PURPOSE, MotionPurpose, REDUCED_MOTION, TRANSITION_PATTERNS } from './motion.js';

package/dist/index.js

@@ -0,0 +1,113 @@
+import {
+  STATUS,
+  statusMeta,
+  statusEntries,
+  statusKeysWithTone
+} from "./status.js";
+import { TONES } from "@tea-ui/tokens";
+import {
+  FEEDBACK,
+  FEEDBACK_STATES,
+  NON_DESTRUCTIVE_STATES,
+  feedbackMeta,
+  feedbackAttr,
+  isNonDestructive
+} from "./feedback.js";
+import {
+  DESTRUCTIVE_POLICY,
+  DESTRUCTIVE_VERBS,
+  CONSEQUENCE_LEVELS,
+  destructivePolicy,
+  consequenceSentence
+} from "./destructive.js";
+import {
+  ERROR_TITLES,
+  renderErrorMessage,
+  shouldOfferRetry,
+  hasTechnicalDetail,
+  toErrorAnatomy
+} from "./error-anatomy.js";
+import {
+  AUTOCOMPLETE,
+  FIELD_RULES,
+  FORM_INTERACTION,
+  UNSAVED_CHANGES,
+  VALIDATION_TIMING
+} from "./forms.js";
+import {
+  COPY,
+  FORBIDDEN_COPY,
+  REGISTER,
+  fill
+} from "./terminology.js";
+import {
+  IA_LIMITS,
+  NAVIGATION_RULES,
+  NAVIGATION_MECHANISMS,
+  URL_SYNC
+} from "./navigation.js";
+import {
+  BACKGROUND_OPERATION,
+  DATA_VIZ,
+  EMPTY_STATE_TITLES,
+  LOADING_AFFORDANCE,
+  MIN_SKELETON_MS,
+  MOTION,
+  MOTION_PURPOSE,
+  REDUCED_MOTION,
+  TRANSITION_PATTERNS
+} from "./motion.js";
+import {
+  DENSITIES,
+  DEFAULT_DENSITY,
+  isDensity
+} from "@tea-ui/tokens";
+export {
+  AUTOCOMPLETE,
+  BACKGROUND_OPERATION,
+  CONSEQUENCE_LEVELS,
+  COPY,
+  DATA_VIZ,
+  DEFAULT_DENSITY,
+  DENSITIES,
+  DESTRUCTIVE_POLICY,
+  DESTRUCTIVE_VERBS,
+  EMPTY_STATE_TITLES,
+  ERROR_TITLES,
+  FEEDBACK,
+  FEEDBACK_STATES,
+  FIELD_RULES,
+  FORBIDDEN_COPY,
+  FORM_INTERACTION,
+  IA_LIMITS,
+  LOADING_AFFORDANCE,
+  MIN_SKELETON_MS,
+  MOTION,
+  MOTION_PURPOSE,
+  NAVIGATION_MECHANISMS,
+  NAVIGATION_RULES,
+  NON_DESTRUCTIVE_STATES,
+  REDUCED_MOTION,
+  REGISTER,
+  STATUS,
+  TONES,
+  TRANSITION_PATTERNS,
+  UNSAVED_CHANGES,
+  URL_SYNC,
+  VALIDATION_TIMING,
+  consequenceSentence,
+  destructivePolicy,
+  feedbackAttr,
+  feedbackMeta,
+  fill,
+  hasTechnicalDetail,
+  isDensity,
+  isNonDestructive,
+  renderErrorMessage,
+  shouldOfferRetry,
+  statusEntries,
+  statusKeysWithTone,
+  statusMeta,
+  toErrorAnatomy
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * TEA UI — UX Standards.\n *\n * Standards are only real when something enforces them. This package is that\n * something: the vocabulary every other TEA UI package imports instead of\n * re-deriving. A component asks the registry for a status label; a dialog asks\n * the destructive policy what protection it needs; an error surface asks the\n * anatomy type for its four answers.\n *\n * If a rule here is inconvenient, the rule is what changes — not the call\n * site. That inversion is the entire point of the layer.\n */\n\nexport {\n  STATUS,\n  statusMeta,\n  statusEntries,\n  statusKeysWithTone,\n  type StatusMeta,\n  type StatusDomain,\n  type StatusKey,\n  type AnyStatusKey,\n} from \"./status\";\n\n/* The tone vocabulary is defined in the token layer — a theme colours it, the\n * standards layer names it — and re-exported here so a product reasoning about\n * status has one import for the whole vocabulary. */\nexport { TONES, type Tone } from \"@tea-ui/tokens\";\n\nexport {\n  FEEDBACK,\n  FEEDBACK_STATES,\n  NON_DESTRUCTIVE_STATES,\n  feedbackMeta,\n  feedbackAttr,\n  isNonDestructive,\n  type FeedbackState,\n  type FeedbackKind,\n  type FeedbackMeta,\n  type NonDestructiveState,\n} from \"./feedback\";\n\nexport {\n  DESTRUCTIVE_POLICY,\n  DESTRUCTIVE_VERBS,\n  CONSEQUENCE_LEVELS,\n  destructivePolicy,\n  consequenceSentence,\n  type ConsequenceLevel,\n  type DestructivePolicy,\n  type Protection,\n} from \"./destructive\";\n\nexport {\n  ERROR_TITLES,\n  renderErrorMessage,\n  shouldOfferRetry,\n  hasTechnicalDetail,\n  toErrorAnatomy,\n  type ErrorAnatomy,\n  type ErrorKind,\n  type ErrorRecovery,\n} from \"./error-anatomy\";\n\nexport {\n  AUTOCOMPLETE,\n  FIELD_RULES,\n  FORM_INTERACTION,\n  UNSAVED_CHANGES,\n  VALIDATION_TIMING,\n  type FieldControl,\n  type FormFieldRules,\n} from \"./forms\";\n\nexport {\n  COPY,\n  FORBIDDEN_COPY,\n  REGISTER,\n  fill,\n  type Register,\n} from \"./terminology\";\n\nexport {\n  IA_LIMITS,\n  NAVIGATION_RULES,\n  NAVIGATION_MECHANISMS,\n  URL_SYNC,\n  type InformationArchitecture,\n  type NavigationMechanism,\n  type NavigationRule,\n} from \"./navigation\";\n\nexport {\n  BACKGROUND_OPERATION,\n  DATA_VIZ,\n  EMPTY_STATE_TITLES,\n  LOADING_AFFORDANCE,\n  MIN_SKELETON_MS,\n  MOTION,\n  MOTION_PURPOSE,\n  REDUCED_MOTION,\n  TRANSITION_PATTERNS,\n  type DataVizRules,\n  type EmptyStateAnatomy,\n  type EmptyStateTitle,\n  type MotionPurpose,\n} from \"./motion\";\n\n/* The density vocabulary lives in the token layer, because it is expressed in\n * CSS custom properties. It is re-exported here so a product that reasons about\n * UX Standards has one import for the whole vocabulary. */\nexport {\n  DENSITIES,\n  DEFAULT_DENSITY,\n  isDensity,\n  type Density,\n} from \"@tea-ui/tokens\";\n"],"mappings":"AAaA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAKP,SAAS,aAAwB;AAEjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAKP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}

package/dist/motion.d.ts

@@ -0,0 +1,126 @@
+export { MOTION } from '@tea-ui/tokens';
+
+/**
+ * TEA UI — motion, density, performance UX and data-visualisation standards.
+ *
+ * These four are grouped because they are the same question asked about time
+ * and space: how much of the user's attention does the interface get to spend?
+ */
+
+/**
+ * Motion is only justified when it answers one of these questions. Anything
+ * else is decoration, and decoration in a working UI is a cost the user pays
+ * every time they open the page.
+ */
+declare const MOTION_PURPOSE: readonly ["feedback", "spatial-relationship", "state-change", "loading", "attention"];
+type MotionPurpose = (typeof MOTION_PURPOSE)[number];
+/** The permitted transition patterns, per UX-Standards §23. */
+declare const TRANSITION_PATTERNS: {
+    /** Hover, press, colour change. Short. */
+    readonly feedback: {
+        readonly duration: 120;
+        readonly ease: "cubic-bezier(0.2, 0, 0, 1)";
+    };
+    /** Panel, popover, dropdown appearing in place. */
+    readonly entrance: {
+        readonly duration: 180;
+        readonly ease: "cubic-bezier(0.16, 1, 0.3, 1)";
+    };
+    /** Dismissal. Faster than entrance, because the user asked for it to go. */
+    readonly exit: {
+        readonly duration: 120;
+        readonly ease: "cubic-bezier(0.4, 0, 1, 1)";
+    };
+    /** A value changing in place — width, position, colour. */
+    readonly stateChange: {
+        readonly duration: 180;
+        readonly ease: "cubic-bezier(0.2, 0, 0, 1)";
+    };
+    /** Layout shift after content arrives. Deliberately minimal. */
+    readonly reflow: {
+        readonly duration: 280;
+        readonly ease: "cubic-bezier(0.2, 0, 0, 1)";
+    };
+};
+/**
+ * Reduced motion is a floor, not an option. The audit found zero
+ * `prefers-reduced-motion` handling across two projects: 13 unguarded spinners
+ * and every overlay animation unconditional. The CSS floor lives in
+ * `tokens/src/index.css`; these are the rules about what remains.
+ */
+declare const REDUCED_MOTION: {
+    /** Essential, non-motion progress indicators must stay, as designed. */
+    readonly preserveEssential: true;
+    /** Data attributes: add `data-tea-motion="essential"` to opt out. */
+    readonly attribute: "data-tea-motion";
+    readonly values: readonly ["essential", "decorative"];
+    /** An animation that carries meaning must have a non-motion equivalent. */
+    readonly requireNonMotionEquivalent: true;
+};
+/**
+ * Which loading affordance to use. The audit's clearest defect was treating
+ * these as interchangeable and replacing readable content with a spinner on
+ * every poll.
+ */
+declare const LOADING_AFFORDANCE: {
+    /** Nothing on screen yet, first load. A skeleton matching the real layout. */
+    readonly initial: "skeleton";
+    /** Content exists and stays. A quiet indicator; never replace the content. */
+    readonly refresh: "inline-indicator";
+    /** A user-triggered operation. Inline progress on the control that started it. */
+    readonly processing: "control-progress";
+    /** A long operation the user must wait for. Determinate progress if possible. */
+    readonly blocking: "progress";
+    /** A background operation the user may leave. Announce on completion. */
+    readonly background: "toast-on-complete";
+};
+/** Minimum time a skeleton stays up, so it never flashes. */
+declare const MIN_SKELETON_MS = 250;
+/** Never block the UI for a background operation. */
+declare const BACKGROUND_OPERATION: {
+    readonly blockUI: false;
+    readonly announceOnComplete: true;
+    readonly allowCancel: true;
+};
+/**
+ * A chart must be readable with no colour perception at all. That is a hard
+ * requirement, not a preference: it is the difference between a dashboard that
+ * survives a monochrome printout and one that does not.
+ */
+interface DataVizRules {
+    /** Every series also carries a distinct mark, dash pattern or label. */
+    readonly requireNonColourEncoding: boolean;
+    /** Axes and gridlines must meet text contrast, not "looks fine" contrast. */
+    readonly minimumAxisContrast: number;
+    /** Missing data is drawn as a gap or a marker, never interpolated silently. */
+    readonly showMissingData: boolean;
+    /** Every chart ships a text alternative or a data table. */
+    readonly requireTextAlternative: boolean;
+    /** Legends label series; tooltips give exact values. */
+    readonly requireLegendForMultipleSeries: boolean;
+}
+declare const DATA_VIZ: DataVizRules;
+/**
+ * Every meaningful empty state answers three questions. "Keine Einträge." on
+ * its own answers none of them, and the audit found ten of them.
+ */
+interface EmptyStateAnatomy {
+    /** What is empty, named specifically. "Keine Server", not "Keine Einträge". */
+    readonly what: string;
+    /** Why it is empty, when the reason is not obvious. */
+    readonly why?: string;
+    /** The primary next action, when there is one. */
+    readonly action?: string;
+    /** A secondary escape hatch, e.g. clearing a filter. */
+    readonly secondaryAction?: string;
+}
+declare const EMPTY_STATE_TITLES: {
+    readonly neverCreated: "Noch nichts vorhanden";
+    readonly noResults: "Keine Treffer";
+    readonly filtered: "Alles ausgefiltert";
+    readonly noAccess: "Kein Zugriff";
+    readonly error: "Nicht geladen";
+};
+type EmptyStateTitle = (typeof EMPTY_STATE_TITLES)[keyof typeof EMPTY_STATE_TITLES];
+
+export { BACKGROUND_OPERATION, DATA_VIZ, type DataVizRules, EMPTY_STATE_TITLES, type EmptyStateAnatomy, type EmptyStateTitle, LOADING_AFFORDANCE, MIN_SKELETON_MS, MOTION_PURPOSE, type MotionPurpose, REDUCED_MOTION, TRANSITION_PATTERNS };

package/dist/motion.js

@@ -0,0 +1,67 @@
+import { MOTION } from "@tea-ui/tokens";
+const MOTION_PURPOSE = ["feedback", "spatial-relationship", "state-change", "loading", "attention"];
+const TRANSITION_PATTERNS = {
+  /** Hover, press, colour change. Short. */
+  feedback: { duration: MOTION.duration.fast, ease: MOTION.ease.standard },
+  /** Panel, popover, dropdown appearing in place. */
+  entrance: { duration: MOTION.duration.normal, ease: MOTION.ease.entrance },
+  /** Dismissal. Faster than entrance, because the user asked for it to go. */
+  exit: { duration: MOTION.duration.fast, ease: MOTION.ease.exit },
+  /** A value changing in place — width, position, colour. */
+  stateChange: { duration: MOTION.duration.normal, ease: MOTION.ease.standard },
+  /** Layout shift after content arrives. Deliberately minimal. */
+  reflow: { duration: MOTION.duration.slow, ease: MOTION.ease.standard }
+};
+const REDUCED_MOTION = {
+  /** Essential, non-motion progress indicators must stay, as designed. */
+  preserveEssential: true,
+  /** Data attributes: add `data-tea-motion="essential"` to opt out. */
+  attribute: "data-tea-motion",
+  values: ["essential", "decorative"],
+  /** An animation that carries meaning must have a non-motion equivalent. */
+  requireNonMotionEquivalent: true
+};
+const LOADING_AFFORDANCE = {
+  /** Nothing on screen yet, first load. A skeleton matching the real layout. */
+  initial: "skeleton",
+  /** Content exists and stays. A quiet indicator; never replace the content. */
+  refresh: "inline-indicator",
+  /** A user-triggered operation. Inline progress on the control that started it. */
+  processing: "control-progress",
+  /** A long operation the user must wait for. Determinate progress if possible. */
+  blocking: "progress",
+  /** A background operation the user may leave. Announce on completion. */
+  background: "toast-on-complete"
+};
+const MIN_SKELETON_MS = 250;
+const BACKGROUND_OPERATION = {
+  blockUI: false,
+  announceOnComplete: true,
+  allowCancel: true
+};
+const DATA_VIZ = {
+  requireNonColourEncoding: true,
+  minimumAxisContrast: 3,
+  showMissingData: true,
+  requireTextAlternative: true,
+  requireLegendForMultipleSeries: true
+};
+const EMPTY_STATE_TITLES = {
+  neverCreated: "Noch nichts vorhanden",
+  noResults: "Keine Treffer",
+  filtered: "Alles ausgefiltert",
+  noAccess: "Kein Zugriff",
+  error: "Nicht geladen"
+};
+export {
+  BACKGROUND_OPERATION,
+  DATA_VIZ,
+  EMPTY_STATE_TITLES,
+  LOADING_AFFORDANCE,
+  MIN_SKELETON_MS,
+  MOTION,
+  MOTION_PURPOSE,
+  REDUCED_MOTION,
+  TRANSITION_PATTERNS
+};
+//# sourceMappingURL=motion.js.map

package/dist/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/motion.ts"],"sourcesContent":["/**\n * TEA UI — motion, density, performance UX and data-visualisation standards.\n *\n * These four are grouped because they are the same question asked about time\n * and space: how much of the user's attention does the interface get to spend?\n */\n\nimport { MOTION } from \"@tea-ui/tokens\";\n\nexport { MOTION };\n\n/**\n * Motion is only justified when it answers one of these questions. Anything\n * else is decoration, and decoration in a working UI is a cost the user pays\n * every time they open the page.\n */\nexport const MOTION_PURPOSE = [\"feedback\", \"spatial-relationship\", \"state-change\", \"loading\", \"attention\"] as const;\n\nexport type MotionPurpose = (typeof MOTION_PURPOSE)[number];\n\n/** The permitted transition patterns, per UX-Standards §23. */\nexport const TRANSITION_PATTERNS = {\n  /** Hover, press, colour change. Short. */\n  feedback: { duration: MOTION.duration.fast, ease: MOTION.ease.standard },\n  /** Panel, popover, dropdown appearing in place. */\n  entrance: { duration: MOTION.duration.normal, ease: MOTION.ease.entrance },\n  /** Dismissal. Faster than entrance, because the user asked for it to go. */\n  exit: { duration: MOTION.duration.fast, ease: MOTION.ease.exit },\n  /** A value changing in place — width, position, colour. */\n  stateChange: { duration: MOTION.duration.normal, ease: MOTION.ease.standard },\n  /** Layout shift after content arrives. Deliberately minimal. */\n  reflow: { duration: MOTION.duration.slow, ease: MOTION.ease.standard },\n} as const;\n\n/**\n * Reduced motion is a floor, not an option. The audit found zero\n * `prefers-reduced-motion` handling across two projects: 13 unguarded spinners\n * and every overlay animation unconditional. The CSS floor lives in\n * `tokens/src/index.css`; these are the rules about what remains.\n */\nexport const REDUCED_MOTION = {\n  /** Essential, non-motion progress indicators must stay, as designed. */\n  preserveEssential: true,\n  /** Data attributes: add `data-tea-motion=\"essential\"` to opt out. */\n  attribute: \"data-tea-motion\",\n  values: [\"essential\", \"decorative\"] as const,\n  /** An animation that carries meaning must have a non-motion equivalent. */\n  requireNonMotionEquivalent: true,\n} as const;\n\n/* -------------------------------------------------------------------------- */\n/* Performance UX                                                              */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Which loading affordance to use. The audit's clearest defect was treating\n * these as interchangeable and replacing readable content with a spinner on\n * every poll.\n */\nexport const LOADING_AFFORDANCE = {\n  /** Nothing on screen yet, first load. A skeleton matching the real layout. */\n  initial: \"skeleton\",\n  /** Content exists and stays. A quiet indicator; never replace the content. */\n  refresh: \"inline-indicator\",\n  /** A user-triggered operation. Inline progress on the control that started it. */\n  processing: \"control-progress\",\n  /** A long operation the user must wait for. Determinate progress if possible. */\n  blocking: \"progress\",\n  /** A background operation the user may leave. Announce on completion. */\n  background: \"toast-on-complete\",\n} as const;\n\n/** Minimum time a skeleton stays up, so it never flashes. */\nexport const MIN_SKELETON_MS = 250;\n\n/** Never block the UI for a background operation. */\nexport const BACKGROUND_OPERATION = {\n  blockUI: false,\n  announceOnComplete: true,\n  allowCancel: true,\n} as const;\n\n/* -------------------------------------------------------------------------- */\n/* Data visualisation                                                          */\n/* -------------------------------------------------------------------------- */\n\n/**\n * A chart must be readable with no colour perception at all. That is a hard\n * requirement, not a preference: it is the difference between a dashboard that\n * survives a monochrome printout and one that does not.\n */\nexport interface DataVizRules {\n  /** Every series also carries a distinct mark, dash pattern or label. */\n  readonly requireNonColourEncoding: boolean;\n  /** Axes and gridlines must meet text contrast, not \"looks fine\" contrast. */\n  readonly minimumAxisContrast: number;\n  /** Missing data is drawn as a gap or a marker, never interpolated silently. */\n  readonly showMissingData: boolean;\n  /** Every chart ships a text alternative or a data table. */\n  readonly requireTextAlternative: boolean;\n  /** Legends label series; tooltips give exact values. */\n  readonly requireLegendForMultipleSeries: boolean;\n}\n\nexport const DATA_VIZ: DataVizRules = {\n  requireNonColourEncoding: true,\n  minimumAxisContrast: 3,\n  showMissingData: true,\n  requireTextAlternative: true,\n  requireLegendForMultipleSeries: true,\n};\n\n/* -------------------------------------------------------------------------- */\n/* Empty state                                                                 */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Every meaningful empty state answers three questions. \"Keine Einträge.\" on\n * its own answers none of them, and the audit found ten of them.\n */\nexport interface EmptyStateAnatomy {\n  /** What is empty, named specifically. \"Keine Server\", not \"Keine Einträge\". */\n  readonly what: string;\n  /** Why it is empty, when the reason is not obvious. */\n  readonly why?: string;\n  /** The primary next action, when there is one. */\n  readonly action?: string;\n  /** A secondary escape hatch, e.g. clearing a filter. */\n  readonly secondaryAction?: string;\n}\n\nexport const EMPTY_STATE_TITLES = {\n  neverCreated: \"Noch nichts vorhanden\",\n  noResults: \"Keine Treffer\",\n  filtered: \"Alles ausgefiltert\",\n  noAccess: \"Kein Zugriff\",\n  error: \"Nicht geladen\",\n} as const;\n\nexport type EmptyStateTitle = (typeof EMPTY_STATE_TITLES)[keyof typeof EMPTY_STATE_TITLES];\n"],"mappings":"AAOA,SAAS,cAAc;AAShB,MAAM,iBAAiB,CAAC,YAAY,wBAAwB,gBAAgB,WAAW,WAAW;AAKlG,MAAM,sBAAsB;AAAA;AAAA,EAEjC,UAAU,EAAE,UAAU,OAAO,SAAS,MAAM,MAAM,OAAO,KAAK,SAAS;AAAA;AAAA,EAEvE,UAAU,EAAE,UAAU,OAAO,SAAS,QAAQ,MAAM,OAAO,KAAK,SAAS;AAAA;AAAA,EAEzE,MAAM,EAAE,UAAU,OAAO,SAAS,MAAM,MAAM,OAAO,KAAK,KAAK;AAAA;AAAA,EAE/D,aAAa,EAAE,UAAU,OAAO,SAAS,QAAQ,MAAM,OAAO,KAAK,SAAS;AAAA;AAAA,EAE5E,QAAQ,EAAE,UAAU,OAAO,SAAS,MAAM,MAAM,OAAO,KAAK,SAAS;AACvE;AAQO,MAAM,iBAAiB;AAAA;AAAA,EAE5B,mBAAmB;AAAA;AAAA,EAEnB,WAAW;AAAA,EACX,QAAQ,CAAC,aAAa,YAAY;AAAA;AAAA,EAElC,4BAA4B;AAC9B;AAWO,MAAM,qBAAqB;AAAA;AAAA,EAEhC,SAAS;AAAA;AAAA,EAET,SAAS;AAAA;AAAA,EAET,YAAY;AAAA;AAAA,EAEZ,UAAU;AAAA;AAAA,EAEV,YAAY;AACd;AAGO,MAAM,kBAAkB;AAGxB,MAAM,uBAAuB;AAAA,EAClC,SAAS;AAAA,EACT,oBAAoB;AAAA,EACpB,aAAa;AACf;AAwBO,MAAM,WAAyB;AAAA,EACpC,0BAA0B;AAAA,EAC1B,qBAAqB;AAAA,EACrB,iBAAiB;AAAA,EACjB,wBAAwB;AAAA,EACxB,gCAAgC;AAClC;AAqBO,MAAM,qBAAqB;AAAA,EAChC,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,OAAO;AACT;","names":[]}

package/dist/navigation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TEA UI — navigation and information architecture standards.
+ *
+ * Navigation is the one thing a user has to learn before they can do anything
+ * else, so it is the thing that must be identical everywhere. The rule below
+ * is the whole standard: *the same information architecture problem gets the
+ * same navigation mechanism, in every TEA product.*
+ */
+declare const NAVIGATION_MECHANISMS: readonly ["sidebar", "tabs", "breadcrumb", "back", "command-palette", "global-search", "local-search", "contextual-nav", "stepper"];
+type NavigationMechanism = (typeof NAVIGATION_MECHANISMS)[number];
+/**
+ * Which mechanism answers which question. This is a decision table, not
+ * advice: given the situation, the mechanism is already chosen.
+ */
+interface NavigationRule {
+    readonly situation: string;
+    readonly use: NavigationMechanism;
+    readonly avoid: string;
+    readonly rationale: string;
+}
+declare const NAVIGATION_RULES: readonly NavigationRule[];
+interface InformationArchitecture {
+    /** Maximum top-level entries before the IA needs rethinking. */
+    readonly maxTopLevel: number;
+    /** Maximum entries in one navigation group before it needs a subgroup. */
+    readonly maxGroupSize: number;
+    /** Maximum tabs before they need to become a different mechanism. */
+    readonly maxTabs: number;
+}
+declare const IA_LIMITS: InformationArchitecture;
+/**
+ * URL/UI state synchronisation. State that the URL can express belongs in the
+ * URL, so the view is linkable, reloadable and back-navigable.
+ */
+declare const URL_SYNC: {
+    /** Tabs, filters, pagination, sort order, selection, open panels. */
+    readonly inUrl: readonly ["tab", "filter", "page", "sort", "selection", "panel"];
+    /** Never in the URL: transient state that would make a shared link confusing. */
+    readonly notInUrl: readonly ["hover", "focus", "tooltip", "toast", "skeleton", "popover"];
+};
+
+export { IA_LIMITS, type InformationArchitecture, NAVIGATION_MECHANISMS, NAVIGATION_RULES, type NavigationMechanism, type NavigationRule, URL_SYNC };

package/dist/navigation.js

@@ -0,0 +1,73 @@
+const NAVIGATION_MECHANISMS = [
+  "sidebar",
+  "tabs",
+  "breadcrumb",
+  "back",
+  "command-palette",
+  "global-search",
+  "local-search",
+  "contextual-nav",
+  "stepper"
+];
+const NAVIGATION_RULES = [
+  {
+    situation: "A product has 5 or more top-level areas a user moves between constantly",
+    use: "sidebar",
+    avoid: "a horizontal menu bar",
+    rationale: "A horizontal bar cannot hold labels that stay readable at this count. Both source projects converged on a 256px left sidebar; that is the ecosystem default."
+  },
+  {
+    situation: "A page has 2\u20137 peer views of the SAME subject",
+    use: "tabs",
+    avoid: "a sidebar entry per view",
+    rationale: "Tabs keep siblings visible. Promoting peers to sidebar entries multiplies the top level and destroys the grouping the tabs were expressing."
+  },
+  {
+    situation: "A user is 3+ levels deep in a hierarchy",
+    use: "breadcrumb",
+    avoid: "back-button-only",
+    rationale: "A breadcrumb shows where you are; back only shows where you were. Both, never either alone."
+  },
+  {
+    situation: "The product has 15+ actions or destinations, or a power-user workflow",
+    use: "command-palette",
+    avoid: "a settings page with 200 rows",
+    rationale: "A palette is searchable and keyboard-first, which is what a high action count actually requires."
+  },
+  {
+    situation: "The list or table on screen is long enough to need filtering",
+    use: "local-search",
+    avoid: "a dialog with the same data",
+    rationale: "Search belongs next to the thing it filters, so the relationship is obvious."
+  },
+  {
+    situation: "A destructive or hard-to-reverse multi-step task",
+    use: "stepper",
+    avoid: "a scrollable single page",
+    rationale: "A stepper makes progress, remaining work and recoverability all visible at once."
+  },
+  {
+    situation: "Viewport is below 1024px",
+    use: "back",
+    avoid: "a shrunken sidebar",
+    rationale: "Below `lg` a sidebar stops being information and becomes an obstruction; it collapses into a drawer. Both source projects already collapse at exactly this point."
+  }
+];
+const IA_LIMITS = {
+  maxTopLevel: 7,
+  maxGroupSize: 6,
+  maxTabs: 7
+};
+const URL_SYNC = {
+  /** Tabs, filters, pagination, sort order, selection, open panels. */
+  inUrl: ["tab", "filter", "page", "sort", "selection", "panel"],
+  /** Never in the URL: transient state that would make a shared link confusing. */
+  notInUrl: ["hover", "focus", "tooltip", "toast", "skeleton", "popover"]
+};
+export {
+  IA_LIMITS,
+  NAVIGATION_MECHANISMS,
+  NAVIGATION_RULES,
+  URL_SYNC
+};
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/navigation.ts"],"sourcesContent":["/**\n * TEA UI — navigation and information architecture standards.\n *\n * Navigation is the one thing a user has to learn before they can do anything\n * else, so it is the thing that must be identical everywhere. The rule below\n * is the whole standard: *the same information architecture problem gets the\n * same navigation mechanism, in every TEA product.*\n */\n\nexport const NAVIGATION_MECHANISMS = [\n  \"sidebar\",\n  \"tabs\",\n  \"breadcrumb\",\n  \"back\",\n  \"command-palette\",\n  \"global-search\",\n  \"local-search\",\n  \"contextual-nav\",\n  \"stepper\",\n] as const;\n\nexport type NavigationMechanism = (typeof NAVIGATION_MECHANISMS)[number];\n\n/**\n * Which mechanism answers which question. This is a decision table, not\n * advice: given the situation, the mechanism is already chosen.\n */\nexport interface NavigationRule {\n  readonly situation: string;\n  readonly use: NavigationMechanism;\n  readonly avoid: string;\n  readonly rationale: string;\n}\n\nexport const NAVIGATION_RULES: readonly NavigationRule[] = [\n  {\n    situation: \"A product has 5 or more top-level areas a user moves between constantly\",\n    use: \"sidebar\",\n    avoid: \"a horizontal menu bar\",\n    rationale:\n      \"A horizontal bar cannot hold labels that stay readable at this count. Both source projects converged on a 256px left sidebar; that is the ecosystem default.\",\n  },\n  {\n    situation: \"A page has 2–7 peer views of the SAME subject\",\n    use: \"tabs\",\n    avoid: \"a sidebar entry per view\",\n    rationale:\n      \"Tabs keep siblings visible. Promoting peers to sidebar entries multiplies the top level and destroys the grouping the tabs were expressing.\",\n  },\n  {\n    situation: \"A user is 3+ levels deep in a hierarchy\",\n    use: \"breadcrumb\",\n    avoid: \"back-button-only\",\n    rationale: \"A breadcrumb shows where you are; back only shows where you were. Both, never either alone.\",\n  },\n  {\n    situation: \"The product has 15+ actions or destinations, or a power-user workflow\",\n    use: \"command-palette\",\n    avoid: \"a settings page with 200 rows\",\n    rationale: \"A palette is searchable and keyboard-first, which is what a high action count actually requires.\",\n  },\n  {\n    situation: \"The list or table on screen is long enough to need filtering\",\n    use: \"local-search\",\n    avoid: \"a dialog with the same data\",\n    rationale: \"Search belongs next to the thing it filters, so the relationship is obvious.\",\n  },\n  {\n    situation: \"A destructive or hard-to-reverse multi-step task\",\n    use: \"stepper\",\n    avoid: \"a scrollable single page\",\n    rationale: \"A stepper makes progress, remaining work and recoverability all visible at once.\",\n  },\n  {\n    situation: \"Viewport is below 1024px\",\n    use: \"back\",\n    avoid: \"a shrunken sidebar\",\n    rationale:\n      \"Below `lg` a sidebar stops being information and becomes an obstruction; it collapses into a drawer. Both source projects already collapse at exactly this point.\",\n  },\n];\n\nexport interface InformationArchitecture {\n  /** Maximum top-level entries before the IA needs rethinking. */\n  readonly maxTopLevel: number;\n  /** Maximum entries in one navigation group before it needs a subgroup. */\n  readonly maxGroupSize: number;\n  /** Maximum tabs before they need to become a different mechanism. */\n  readonly maxTabs: number;\n}\n\nexport const IA_LIMITS: InformationArchitecture = {\n  maxTopLevel: 7,\n  maxGroupSize: 6,\n  maxTabs: 7,\n};\n\n/**\n * URL/UI state synchronisation. State that the URL can express belongs in the\n * URL, so the view is linkable, reloadable and back-navigable.\n */\nexport const URL_SYNC = {\n  /** Tabs, filters, pagination, sort order, selection, open panels. */\n  inUrl: [\"tab\", \"filter\", \"page\", \"sort\", \"selection\", \"panel\"] as const,\n  /** Never in the URL: transient state that would make a shared link confusing. */\n  notInUrl: [\"hover\", \"focus\", \"tooltip\", \"toast\", \"skeleton\", \"popover\"] as const,\n} as const;\n"],"mappings":"AASO,MAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAeO,MAAM,mBAA8C;AAAA,EACzD;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,WAAW;AAAA,IACX,KAAK;AAAA,IACL,OAAO;AAAA,IACP,WACE;AAAA,EACJ;AACF;AAWO,MAAM,YAAqC;AAAA,EAChD,aAAa;AAAA,EACb,cAAc;AAAA,EACd,SAAS;AACX;AAMO,MAAM,WAAW;AAAA;AAAA,EAEtB,OAAO,CAAC,OAAO,UAAU,QAAQ,QAAQ,aAAa,OAAO;AAAA;AAAA,EAE7D,UAAU,CAAC,SAAS,SAAS,WAAW,SAAS,YAAY,SAAS;AACxE;","names":[]}

package/dist/status.d.ts

@@ -0,0 +1,50 @@
+import { Tone } from '@tea-ui/tokens';
+export { Tone } from '@tea-ui/tokens';
+
+interface StatusMeta {
+    /** The word a user reads. Nominal, no trailing punctuation. */
+    readonly label: string;
+    /** The closed semantic tone. The only way a status reaches a colour. */
+    readonly tone: Tone;
+    /** One sentence explaining the state, for a tooltip or help text. */
+    readonly description: string;
+}
+declare const STATUS: {
+    readonly health: Readonly<Record<"offline" | "maintenance" | "online" | "degraded" | "unknown", StatusMeta>>;
+    readonly resource: Readonly<Record<"critical" | "normal" | "elevated" | "high", StatusMeta>>;
+    readonly backup: Readonly<Record<"succeeded" | "running" | "pending" | "failed" | "expired", StatusMeta>>;
+    readonly certificate: Readonly<Record<"unknown" | "expired" | "valid" | "expiring" | "invalid", StatusMeta>>;
+    readonly container: Readonly<Record<"error" | "running" | "created" | "paused" | "restarting" | "stopped", StatusMeta>>;
+    readonly website: Readonly<Record<"error" | "offline" | "online" | "degraded" | "unknown" | "deploying", StatusMeta>>;
+    readonly dependency: Readonly<Record<"warning" | "error" | "ok" | "missing", StatusMeta>>;
+    readonly security: Readonly<Record<"critical" | "warning" | "ok", StatusMeta>>;
+    readonly crm: Readonly<Record<"unprocessed" | "no_website" | "opportunity" | "contacted" | "conversation" | "offer" | "customer" | "archived", StatusMeta>>;
+    readonly project: Readonly<Record<"planning" | "active" | "on_hold" | "review" | "delivered" | "cancelled", StatusMeta>>;
+};
+type StatusDomain = keyof typeof STATUS;
+/** The wire values a given domain may take. */
+type StatusKey<D extends StatusDomain> = keyof (typeof STATUS)[D] & string;
+/** Union of every wire value across every domain, for exhaustive switches. */
+type AnyStatusKey = {
+    [D in StatusDomain]: StatusKey<D>;
+}[StatusDomain];
+/**
+ * Look up the label, tone and description for a wire value.
+ *
+ * The key is `domain` + `key` rather than a flat string, because a flat string
+ * cannot be checked: `statusMeta("healthy")` would compile even if no domain
+ * ever produced "healthy". This signature makes a typo a type error, and
+ * adding a wire value without a label is a type error too — which is exactly
+ * the failure mode that produced five disagreeing tables.
+ */
+declare function statusMeta<D extends StatusDomain>(domain: D, key: StatusKey<D>): StatusMeta;
+/** Every entry of a domain, as `[key, meta]` pairs. */
+declare function statusEntries<D extends StatusDomain>(domain: D): Array<[StatusKey<D>, StatusMeta]>;
+/**
+ * The wire values of one domain that a given tone covers, in registry order.
+ * Used by filter chips and legends, so a filter row can never invent a
+ * category the registry does not know.
+ */
+declare function statusKeysWithTone<D extends StatusDomain>(domain: D, tone: Tone): Array<StatusKey<D>>;
+
+export { type AnyStatusKey, STATUS, type StatusDomain, type StatusKey, type StatusMeta, statusEntries, statusKeysWithTone, statusMeta };