@factorialco/f0-react 12.16.0 → 12.17.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-11-03T10:35:06.801Z",
+	generatedAt: "2026-11-03T11:52:48.940Z",
 	stats: {
 		total: 312,
 		byStatus: {

package/dist/experimental.d.ts

@@ -11940,13 +11940,36 @@ interface F0AgenticHomeProps {
   showSidebarToggle?: boolean;
   /**
    * The person's widgets, down the Home's right edge — the same items
-   * `NewHomeLayout` takes for its rail, drawn with `slotRenderers`. The strip
-   * is ALWAYS COLLAPSED: one glyph per widget (its `icon`, with an accent dot
-   * for `hasUpdates`), and pointing at one or focusing it floats the widget out
-   * to its left, centred on the glyph. Under the clock, centred on the Home's
-   * height. Not on narrow screens, where there is no room beside the column.
+   * `NewHomeLayout` takes for its rail, drawn with `slotRenderers`. COLLAPSED
+   * (the default) it is a strip: one glyph per widget (its `icon`, with an
+   * accent dot for `hasUpdates`), and pointing at one or focusing it floats the
+   * widget out to its left, centred on the glyph. Under the clock, centred on
+   * the Home's height. EXPANDED it is a column of every widget, under the
+   * clock, and the briefing centres in the room left beside it. Not on narrow
+   * screens, where there is no room beside the column.
    */
   widgets?: HomeWidgetItem[];
+  /**
+   * Whether the widget rail is collapsed into its strip — controlled. A button
+   * beside the clock toggles it, as `NewHomeLayout`'s does, and reports the
+   * new value through {@link onWidgetsCollapsedChange}. Omit it to let the Home
+   * keep its own state, starting from {@link defaultWidgetsCollapsed}.
+   *
+   * Narrowness always wins: while the Home is too narrow for the column and
+   * the expanded rail side by side, the rail is collapsed whatever this says,
+   * and the button is not offered.
+   */
+  widgetsCollapsed?: boolean;
+  /**
+   * Whether the widget rail starts collapsed, when {@link widgetsCollapsed}
+   * isn't controlled — the per-person default. Defaults to `true`.
+   */
+  defaultWidgetsCollapsed?: boolean;
+  /**
+   * Told when the person collapses (`true`) or expands (`false`) the widget
+   * rail — to remember their choice for the next visit.
+   */
+  onWidgetsCollapsedChange?: (collapsed: boolean) => void;
   /**
    * Offers "Add widget": a plus at the foot of the widget strip, under a short
    * divider. The host opens its catalog (`WidgetCatalog`) and adds what is
@@ -11959,6 +11982,13 @@ interface F0AgenticHomeProps {
    * widget's id; the host takes it out of `widgets`.
    */
   onRemoveWidget?: (id: string) => void;
+  /**
+   * Makes the widgets draggable in the EXPANDED rail, as `NewHomeLayout`'s
+   * columns are: called with every widget id in its new order after a drop.
+   * The host reorders `widgets` to match. The collapsed strip isn't
+   * arrangeable.
+   */
+  onReorderWidgets?: (ids: string[]) => void;
   /**
    * Offers "Edit params" in the menu of every widget that declares a
    * `paramsSchema` — as `NewHomeLayout` does. Called with the widget's id and