@factorialco/f0-react 10.17.2 → 11.0.0

package/dist/component-status.js

@@ -4,7 +4,7 @@ import { useCallback as i, useEffect as a, useRef as o, useState as s } from "re
 import { jsx as c, jsxs as l } from "react/jsx-runtime";
 //#region \0virtual:f0-component-status-data
 var u = {
-	generatedAt: "2026-10-27T09:50:22.014Z",
+	generatedAt: "2026-10-27T10:28:40.329Z",
 	stats: {
 		total: 309,
 		byStatus: {
@@ -6405,7 +6405,7 @@ var u = {
 				hasWhenToUse: !1,
 				hasWhenNotToUse: !1,
 				hasDoDonts: !1,
-				exampleCount: 10
+				exampleCount: 11
 			},
 			a11yTier: "todo",
 			storyFile: "domains/platform/home/Home/SlotWidget/__stories__/SlotWidget.stories.tsx"

package/dist/experimental.d.ts

@@ -8476,6 +8476,12 @@ type HomeListItemAction = {
   items: DropdownItem[];
   onClick?: never;
 });
+/**
+ * How a line of a row reads: muted (`default`), asking for attention soon —
+ * due today, due tomorrow — (`warning`), or bad news — overdue, rejected,
+ * over budget — (`critical`).
+ */
+type ListTextVariant = "default" | "warning" | "critical";
 /**
  * ONE FACT on a row's second line — the unit a `description` is made of when
  * the row has more than one thing to say ("€340", "12 receipts", "2 days
@@ -8490,8 +8496,8 @@ type HomeListItemAction = {
  */
 type DescriptionPart = {
   text: string;
-  /** Draws THIS part critical rather than muted. */
-  critical?: boolean;
+  /** How THIS part reads; muted by default. */
+  variant?: ListTextVariant;
 };
 //#endregion
 //#region src/domains/platform/home/Home/slotRenderers.d.ts
@@ -8678,27 +8684,28 @@ type ListClickData<C> = C extends "link" ? {
  */
 type SubtitleTone = {
   /**
-   * Draws THIS row's subtitle critical instead of muted — the row is overdue,
-   * rejected, over budget.
+   * How THIS row's subtitle reads: muted by default, `warning` when the row
+   * asks for attention soon (due today, due tomorrow), `critical` when it is
+   * bad news (overdue, rejected, over budget).
    *
-   * Per ROW rather than per schema, like `unread` and `actions`: what has gone
-   * wrong is a state of the row's own data, so one list holds rows that say so
-   * beside rows that have nothing to report. The title reads the same either
-   * way — the subtitle is what carries the news.
+   * Per ROW rather than per schema, like `unread` and `actions`: what is
+   * happening is a state of the row's own data, so one list holds rows that
+   * say so beside rows that have nothing to report. The title reads the same
+   * either way — the subtitle is what carries the news.
    */
-  subtitleCritical?: boolean;
+  subtitleVariant?: ListTextVariant;
 };
 /**
  * A row's SECOND LINE, in either of the two forms it may take.
  *
- * One string with `descriptionCritical` colours the whole line; a list of
+ * One string with `descriptionVariant` colours the whole line; a list of
  * {@link DescriptionPart}s colours each fact on it separately. The two are
- * mutually exclusive on purpose — parts already carry their own `critical`, so
+ * mutually exclusive on purpose — parts already carry their own `variant`, so
  * a row that passes both is saying the same thing twice and meaning different
  * things by it.
  *
  * Whichever form, the tone is per ROW rather than per schema, for the same
- * reason `subtitleCritical` is: what has gone wrong is a state of the row's
+ * reason `subtitleVariant` is: what is happening is a state of the row's
  * own data, so one list holds rows that say so beside rows that have nothing
  * to report.
  *
@@ -8708,10 +8715,10 @@ type SubtitleTone = {
  */
 type DescribedRow = {
   description: string;
-  descriptionCritical?: boolean;
+  descriptionVariant?: ListTextVariant;
 } | {
   description: DescriptionPart[];
-  descriptionCritical?: never;
+  descriptionVariant?: never;
 };
 type ListTextData<S extends ListSchema> = {
   title: string;
@@ -8721,13 +8728,13 @@ type ListTextData<S extends ListSchema> = {
   subtitle?: string;
 } & SubtitleTone : {
   subtitle?: never;
-  subtitleCritical?: never;
+  subtitleVariant?: never;
 }) & (S["descriptionRequired"] extends true ? DescribedRow : S["descriptionOptional"] extends true ? DescribedRow | {
   description?: undefined;
-  descriptionCritical?: never;
+  descriptionVariant?: never;
 } : {
   description?: never;
-  descriptionCritical?: never;
+  descriptionVariant?: never;
 });
 /**
  * One HOVER ACTION on a `list` row: an icon button over the row's right edge
@@ -10676,12 +10683,14 @@ interface AgenticHomeListRow {
   id: string;
   title: string;
   subtitle?: string;
-  subtitleCritical?: boolean;
+  /** How the subtitle reads: muted by default, `warning` (due soon) or `critical` (overdue). */
+  subtitleVariant?: ListTextVariant;
   description?: string | {
     text: string;
-    critical?: boolean;
+    variant?: ListTextVariant;
   }[];
-  descriptionCritical?: boolean;
+  /** How a one-string description reads, as `subtitleVariant`. */
+  descriptionVariant?: ListTextVariant;
   tooltipDescription?: string;
   unread?: boolean;
   /** Left glyph for `left: "person" | "team" | … | "icon"`. */