@factorialco/f0-react 6.100.1 → 6.101.0

package/dist/experimental.d.ts

@@ -9859,6 +9859,31 @@ declare type F0SelectPopupProps<T extends string, R = unknown> = {
      * @default false for field selects; true for inline selects
      */
     fitContentWidth?: boolean;
+    /**
+     * What the TRIGGER says for a selected option — decided once for the whole
+     * select, instead of per option inside `mapOptions`.
+     *
+     * A row is read in the context the list gives it: under its group headers,
+     * beside its siblings. The trigger has none of that, so a label that is clear
+     * in the list can be ambiguous alone ("Backend", once the project header is
+     * gone). This is where the context goes back on, in whatever order reads
+     * best — `"Ship the API (Backend, Apollo)"` as readily as
+     * `"Apollo › Backend › Ship the API"`.
+     *
+     * Receives the option — its own `label`, and the `selectedLabel` `mapOptions`
+     * set if any — together with the record it was mapped from. Build the path
+     * from the RECORD (`item.project.name`), not from the group headers on
+     * screen: a selection made earlier, or one restored from `defaultItem`, is
+     * shown by the trigger while its group is nowhere in the loaded data, and the
+     * record is the part that is always there.
+     *
+     * Returns the string to show. It replaces `selectedLabel` for every selected
+     * option; the rows in the list are untouched.
+     */
+    getSelectedLabel?: (selection: {
+        option: F0SelectItemObject<T, ResolvedRecordType<R>>;
+        item?: ResolvedRecordType<R>;
+    }) => string;
 } & WithDataTestIdProps;
 
 /**
@@ -10742,6 +10767,14 @@ declare const GROUP_ID_SYMBOL: unique symbol;
 export declare type GroupingDefinition<R extends RecordType> = {
     /** Whether grouping is mandatory or the user can chose not to group */
     mandatory?: boolean;
+    /**
+     * Hides the grouping picker, leaving the grouping itself in force. For a
+     * grouping the product decides and the user does not: the headers render,
+     * the control to change them never does.
+     *
+     * Pair it with `mandatory: true` and a `defaultGrouping`/`currentGrouping`,
+     * or the state can still arrive as "no grouping" with no way to leave it.
+     */
     hideSelector?: boolean;
     groupBy: {
         [K in RecordPaths<R>]?: {
@@ -10764,19 +10797,50 @@ export declare type GroupingDefinition<R extends RecordType> = {
 });
 
 /**
- * The selected the grouping state
+ * One level of grouping: a field of the definition's `groupBy` map, plus the
+ * direction its groups are laid out in.
  * @template Grouping - The grouping definition
  */
-export declare type GroupingState<R extends RecordType, Grouping extends GroupingDefinition<R>> = {
+export declare type GroupingLevelState<R extends RecordType, Grouping extends GroupingDefinition<R>> = {
     field: keyof Grouping["groupBy"];
     order?: SortOrder;
-} | undefined;
+};
+
+/**
+ * The selected the grouping state
+ * @template Grouping - The grouping definition
+ */
+export declare type GroupingState<R extends RecordType, Grouping extends GroupingDefinition<R>> = (GroupingLevelState<R, Grouping> & {
+    /**
+     * Extra grouping levels, nested inside `field` in the order given: the
+     * second level splits each first-level group, the third splits each of
+     * those, and so on.
+     *
+     * Every level names another field of the SAME `groupBy` map, so it reuses
+     * that field's `name` and `label` and needs no configuration of its own.
+     * A level whose field the definition doesn't declare is ignored rather
+     * than thrown on, so a stale `thenBy` degrades to fewer levels instead of
+     * an empty list.
+     *
+     * Renderers that don't know about nesting see only the first level: each
+     * top-level group still carries all of its records flattened in
+     * `records`, exactly as it does without `thenBy`.
+     */
+    thenBy?: GroupingLevelState<R, Grouping>[];
+}) | undefined;
 
 declare type GroupRecord<RecordType> = {
     key: string;
     label: string | Promise<string>;
     itemCount: number | undefined | Promise<number | undefined>;
     records: RecordType[];
+    /**
+     * The next grouping level cut out of `records`, present only when the
+     * grouping state asked for one (`thenBy`). `records` stays complete either
+     * way, so a renderer that ignores this field shows exactly what it showed
+     * before nesting existed.
+     */
+    subGroups?: GroupRecord<RecordType>[];
 };
 
 /**
@@ -16929,9 +16993,11 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number, options?: {
+                placeholder?: string;
+            }) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -16939,11 +17005,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number, options?: {
-                placeholder?: string;
-            }) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
         };
     }
 }

package/dist/experimental.js

@@ -1,6 +1,6 @@
-import { x as s, w as t, A as i, a as o, L as r, ax as n, aw as l, ay as d, B as S, y as C, D as g, N as m, aE as u, aF as b, aO as c, z as h, C as P, aD as T, aP as p, I as F, G as I, a5 as E, b9 as A, bg as B, M as L, b8 as y, E as D, b as k, d as W, k as _, am as v, an as f, ak as O, J as M, at as R, F as x, l as H, p as N, q as V, n as w, e as G, s as z, t as U, H as j, aS as q, aT as J, aH as K, as as X, aX as Q, b6 as Y, az as Z, a8 as $, aR as aa, W as ea, ae as sa, O as ta, bk as ia, X as oa, P as ra, Q as na, T as la, aA as da, R as Sa, b4 as Ca, ba as ga, S as ma, a9 as ua, aa as ba, a0 as ca, a1 as ha, a2 as Pa, $ as Ta, a3 as pa, Y as Fa, a4 as Ia, a6 as Ea, a7 as Aa, ab as Ba, ac as La, be as ya, bd as Da, av as ka, au as Wa, aC as _a, aQ as va, aN as fa, aB as Oa, ad as Ma, aI as Ra, bf as xa, bi as Ha, aG as Na, aL as Va, aJ as wa, bj as Ga, aM as za, aK as Ua, bh as ja, c as qa, g as Ja, ah as Ka, aj as Xa, bc as Qa, bb as Ya, ai as Za, ap as $a, f as ae, o as ee, r as se, i as te, j as ie, a_ as oe, aY as re, aq as ne, ar as le, aW as de, b7 as Se, aZ as Ce, h as ge, v as me, b2 as ue, aV as be, a$ as ce, af as he, b5 as Pe, u as Te, al as pe, ag as Fe, ao as Ie, aU as Ee, V as Ae, U as Be, K as Le, _ as ye, Z as De, b3 as ke, b1 as We, b0 as _e } from "./experimental-Cr-mAy-h.js";
-import { dS as fe, es as Oe, er as Me, eF as Re, dp as xe, ep as He, cf as Ne, c5 as Ve, cc as we, ek as Ge, b_ as ze, b_ as Ue, bT as je, el as qe, ci as Je, e6 as Ke, ck as Xe, eI as Qe, eq as Ye, eB as Ze, eC as $e, d7 as as, eG as es, k as ss, dT as ts, cM as is, eo as os, eu as rs, et as ns, T as ls, h as ds, bU as Ss, eD as Cs, eJ as gs, eE as ms, eH as us, eA as bs, ex as cs, ez as hs, ev as Ps, em as Ts, en as ps, eg as Fs, ey as Is, ew as Es } from "./F0CanvasPanel-CE1gNxgB.js";
-import { ay as Bs, az as Ls, a6 as ys, a7 as Ds, a4 as ks, ah as Ws, C as _s, a8 as vs, aK as fs, ad as Os, aJ as Ms, ag as Rs, a5 as xs, aw as Hs, aM as Ns, aL as Vs, ao as ws, ai as Gs, ar as zs, aP as Us, a3 as js, at as qs, aq as Js, al as Ks, aR as Xs, am as Qs, au as Ys, av as Zs, a9 as $s, aN as at, aO as et, an as st, ax as tt, aG as it, O as ot, aI as rt, aa as nt, aT as lt, ac as dt, ae as St, ar as Ct, aQ as gt, as as mt, ap as ut, aS as bt, ab as ct, W as ht, af as Pt, a2 as Tt, a0 as pt, a1 as Ft, aC as It, aD as Et, aA as At, aH as Bt, ak as Lt, aj as yt, aE as Dt, m as kt, aB as Wt, aF as _t, D as vt } from "./CoachmarkProvider-DyBiw5zY.js";
+import { x as s, w as t, A as i, a as o, L as r, ax as n, aw as l, ay as d, B as S, y as C, D as g, N as m, aE as u, aF as b, aO as c, z as h, C as P, aD as T, aP as p, I as F, G as I, a5 as E, b9 as A, bg as B, M as L, b8 as y, E as D, b as k, d as W, k as _, am as v, an as f, ak as O, J as M, at as R, F as x, l as H, p as N, q as V, n as w, e as G, s as z, t as U, H as j, aS as q, aT as J, aH as K, as as X, aX as Q, b6 as Y, az as Z, a8 as $, aR as aa, W as ea, ae as sa, O as ta, bk as ia, X as oa, P as ra, Q as na, T as la, aA as da, R as Sa, b4 as Ca, ba as ga, S as ma, a9 as ua, aa as ba, a0 as ca, a1 as ha, a2 as Pa, $ as Ta, a3 as pa, Y as Fa, a4 as Ia, a6 as Ea, a7 as Aa, ab as Ba, ac as La, be as ya, bd as Da, av as ka, au as Wa, aC as _a, aQ as va, aN as fa, aB as Oa, ad as Ma, aI as Ra, bf as xa, bi as Ha, aG as Na, aL as Va, aJ as wa, bj as Ga, aM as za, aK as Ua, bh as ja, c as qa, g as Ja, ah as Ka, aj as Xa, bc as Qa, bb as Ya, ai as Za, ap as $a, f as ae, o as ee, r as se, i as te, j as ie, a_ as oe, aY as re, aq as ne, ar as le, aW as de, b7 as Se, aZ as Ce, h as ge, v as me, b2 as ue, aV as be, a$ as ce, af as he, b5 as Pe, u as Te, al as pe, ag as Fe, ao as Ie, aU as Ee, V as Ae, U as Be, K as Le, _ as ye, Z as De, b3 as ke, b1 as We, b0 as _e } from "./experimental-BamzvBVI.js";
+import { dS as fe, es as Oe, er as Me, eF as Re, dp as xe, ep as He, cf as Ne, c5 as Ve, cc as we, ek as Ge, b_ as ze, b_ as Ue, bT as je, el as qe, ci as Je, e6 as Ke, ck as Xe, eI as Qe, eq as Ye, eB as Ze, eC as $e, d7 as as, eG as es, k as ss, dT as ts, cM as is, eo as os, eu as rs, et as ns, T as ls, h as ds, bU as Ss, eD as Cs, eJ as gs, eE as ms, eH as us, eA as bs, ex as cs, ez as hs, ev as Ps, em as Ts, en as ps, eg as Fs, ey as Is, ew as Es } from "./F0CanvasPanel-B_HMcMEG.js";
+import { ay as Bs, az as Ls, a6 as ys, a7 as Ds, a4 as ks, ah as Ws, C as _s, a8 as vs, aK as fs, ad as Os, aJ as Ms, ag as Rs, a5 as xs, aw as Hs, aM as Ns, aL as Vs, ao as ws, ai as Gs, ar as zs, aP as Us, a3 as js, at as qs, aq as Js, al as Ks, aR as Xs, am as Qs, au as Ys, av as Zs, a9 as $s, aN as at, aO as et, an as st, ax as tt, aG as it, O as ot, aI as rt, aa as nt, aT as lt, ac as dt, ae as St, ar as Ct, aQ as gt, as as mt, ap as ut, aS as bt, ab as ct, W as ht, af as Pt, a2 as Tt, a0 as pt, a1 as Ft, aC as It, aD as Et, aA as At, aH as Bt, ak as Lt, aj as yt, aE as Dt, m as kt, aB as Wt, aF as _t, D as vt } from "./CoachmarkProvider-jpNFEH87.js";
 export {
   Bs as AUTO_PER_PAGE_MAX,
   Ls as AUTO_PER_PAGE_MIN_RESERVED_ROWS,

package/dist/f0.d.ts

@@ -12985,6 +12985,31 @@ declare type F0SelectPopupProps<T extends string, R = unknown> = {
      * @default false for field selects; true for inline selects
      */
     fitContentWidth?: boolean;
+    /**
+     * What the TRIGGER says for a selected option — decided once for the whole
+     * select, instead of per option inside `mapOptions`.
+     *
+     * A row is read in the context the list gives it: under its group headers,
+     * beside its siblings. The trigger has none of that, so a label that is clear
+     * in the list can be ambiguous alone ("Backend", once the project header is
+     * gone). This is where the context goes back on, in whatever order reads
+     * best — `"Ship the API (Backend, Apollo)"` as readily as
+     * `"Apollo › Backend › Ship the API"`.
+     *
+     * Receives the option — its own `label`, and the `selectedLabel` `mapOptions`
+     * set if any — together with the record it was mapped from. Build the path
+     * from the RECORD (`item.project.name`), not from the group headers on
+     * screen: a selection made earlier, or one restored from `defaultItem`, is
+     * shown by the trigger while its group is nowhere in the loaded data, and the
+     * record is the part that is always there.
+     *
+     * Returns the string to show. It replaces `selectedLabel` for every selected
+     * option; the rows in the list are untouched.
+     */
+    getSelectedLabel?: (selection: {
+        option: F0SelectItemObject<T, ResolvedRecordType<R>>;
+        item?: ResolvedRecordType<R>;
+    }) => string;
 } & WithDataTestIdProps;
 
 /**
@@ -14671,6 +14696,15 @@ export declare interface GridStackReactWidget extends Omit<GridStackWidget, "con
  */
 export declare const GROUP_ID_SYMBOL: unique symbol;
 
+/**
+ * Joins a nested group's key to its parent's. Sub-group keys have to be unique
+ * across the whole tree — "Barcelona" under Engineering and "Barcelona" under
+ * Sales are two different groups, and everything downstream (open/closed state,
+ * selection) addresses a group by its key alone. A unit separator keeps the key
+ * unambiguous without colliding with anything that can appear in a field value.
+ */
+export declare const GROUP_KEY_SEPARATOR = "\u001F";
+
 declare interface GroupGridProps<Widget extends GroupGridWidget, Deps extends Record<string, unknown> = Record<string, unknown>> {
     widgets: Optional<Widget, "x" | "y">[];
     editMode?: boolean;
@@ -14720,6 +14754,14 @@ declare type GroupGridWidgetSize = {
 export declare type GroupingDefinition<R extends RecordType> = {
     /** Whether grouping is mandatory or the user can chose not to group */
     mandatory?: boolean;
+    /**
+     * Hides the grouping picker, leaving the grouping itself in force. For a
+     * grouping the product decides and the user does not: the headers render,
+     * the control to change them never does.
+     *
+     * Pair it with `mandatory: true` and a `defaultGrouping`/`currentGrouping`,
+     * or the state can still arrive as "no grouping" with no way to leave it.
+     */
     hideSelector?: boolean;
     groupBy: {
         [K in RecordPaths<R>]?: {
@@ -14742,19 +14784,50 @@ export declare type GroupingDefinition<R extends RecordType> = {
 });
 
 /**
- * The selected the grouping state
+ * One level of grouping: a field of the definition's `groupBy` map, plus the
+ * direction its groups are laid out in.
  * @template Grouping - The grouping definition
  */
-export declare type GroupingState<R extends RecordType, Grouping extends GroupingDefinition<R>> = {
+export declare type GroupingLevelState<R extends RecordType, Grouping extends GroupingDefinition<R>> = {
     field: keyof Grouping["groupBy"];
     order?: SortOrder;
-} | undefined;
+};
+
+/**
+ * The selected the grouping state
+ * @template Grouping - The grouping definition
+ */
+export declare type GroupingState<R extends RecordType, Grouping extends GroupingDefinition<R>> = (GroupingLevelState<R, Grouping> & {
+    /**
+     * Extra grouping levels, nested inside `field` in the order given: the
+     * second level splits each first-level group, the third splits each of
+     * those, and so on.
+     *
+     * Every level names another field of the SAME `groupBy` map, so it reuses
+     * that field's `name` and `label` and needs no configuration of its own.
+     * A level whose field the definition doesn't declare is ignored rather
+     * than thrown on, so a stale `thenBy` degrades to fewer levels instead of
+     * an empty list.
+     *
+     * Renderers that don't know about nesting see only the first level: each
+     * top-level group still carries all of its records flattened in
+     * `records`, exactly as it does without `thenBy`.
+     */
+    thenBy?: GroupingLevelState<R, Grouping>[];
+}) | undefined;
 
 export declare type GroupRecord<RecordType> = {
     key: string;
     label: string | Promise<string>;
     itemCount: number | undefined | Promise<number | undefined>;
     records: RecordType[];
+    /**
+     * The next grouping level cut out of `records`, present only when the
+     * grouping state asked for one (`thenBy`). `records` stays complete either
+     * way, so a renderer that ignores this field shows exactly what it showed
+     * before nesting existed.
+     */
+    subGroups?: GroupRecord<RecordType>[];
 };
 
 /**
@@ -20781,9 +20854,11 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number, options?: {
+                placeholder?: string;
+            }) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -20791,11 +20866,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number, options?: {
-                placeholder?: string;
-            }) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
         };
     }
 }