@factorialco/f0-react 6.91.2 → 6.93.0

package/dist/experimental.d.ts

@@ -10657,6 +10657,49 @@ export declare interface HomeSlotParamsMap {
     indicators: IndicatorsListProps;
 }
 
+export declare type HomeTrackingOptions = {
+    /** A widget's header link, footer action, or "View more" was used. */
+    onWidgetAction?: (event: HomeWidgetActionEvent) => void;
+    /**
+     * A row inside a widget was activated. Fires ALONGSIDE the navigation the
+     * row's `href` performs — it does not replace or gate it, so a middle-click
+     * or a modified click still behaves like the link it is.
+     */
+    onWidgetItemActivate?: (event: HomeWidgetItemActivateEvent) => void;
+};
+
+/**
+ * Payload for `tracking.onWidgetAction`. The widget is named by the id the host
+ * gave it, which is the key to everything else the host already knows about it.
+ */
+export declare type HomeWidgetActionEvent = {
+    widgetId: string;
+    action: HomeWidgetActionKind;
+};
+
+/**
+ * TRACKING FOR THE HOME — the same shape the AI kit uses (`AiChatTrackingOptions`):
+ * the host passes callbacks, the components fire them, and nothing about a
+ * widget's data changes to make it measurable.
+ *
+ * This exists because a Home widget is DECLARATIVE. Its rows carry an `href`
+ * and never an `onClick` (that is the one click behavior a `list` slot has, and
+ * a type test holds the line), so a host had no seam to observe an interaction
+ * from — its analytics simply could not see the Home. These callbacks are that
+ * seam, and they leave the row data alone: navigation is still the anchor's.
+ *
+ * BEHAVIOUR ONLY, deliberately. The payloads carry what the reader DID and say
+ * nothing about which column a widget sits in or where in it — that is the
+ * host's own persisted layout, and duplicating it into an analytics event
+ * would make two sources for one fact, the stale one being the event.
+ */
+/**
+ * WHICH AFFORDANCE was used. A widget has three ways out of it and they mean
+ * different things to whoever reads the numbers: the header's own link, the
+ * footer's call to action, and the "View more" a capped list grows.
+ */
+export declare type HomeWidgetActionKind = "header-link" | "footer-action" | "view-more";
+
 /**
  * The `Widget` chrome a Home widget may carry beyond its header, passed straight
  * through to the frame.
@@ -10765,6 +10808,19 @@ export declare type HomeWidgetItem = HomeWidgetChrome & {
     loading?: boolean;
 };
 
+/** Payload for `tracking.onWidgetItemActivate`. */
+export declare type HomeWidgetItemActivateEvent = {
+    widgetId: string;
+    /** The row's own id, as the slot was given it. */
+    itemId: string | number;
+    /**
+     * 1-based place of the row within its slot, AS DRAWN. Not layout state: it
+     * is where the reader's attention landed in a list ordered by its own data,
+     * which is the one position worth reporting.
+     */
+    itemPosition: number;
+};
+
 /**
  * A DIRECT ACTION on a widget's collapsed glyph: the one thing the widget can be
  * told to do without being opened — resume a paused timer, clock out, join the
@@ -12121,6 +12177,17 @@ export declare interface NewHomeLayoutProps {
     onClickAddNewWidget?: (side: WidgetContainerSide) => void;
     /** Called with a side and its widget ids in their new order after a drag. */
     onReorderWidgets?: (side: WidgetContainerSide, ids: string[]) => void;
+    /**
+     * ANALYTICS CALLBACKS for what the reader does inside the widgets — the same
+     * shape the AI kit takes (`ai.tracking`).
+     *
+     * A widget is declarative: its rows carry an `href` and never an `onClick`,
+     * so a host had no seam to observe a row from and its analytics could not see
+     * the Home at all. These fire for EVERY widget in the column, so a newly
+     * added one is measured without remembering anything. Nothing here changes
+     * behaviour — a row still navigates through its own anchor.
+     */
+    tracking?: HomeTrackingOptions;
     /** The daytime gradient period for the page surface. */
     period?: HomePeriod;
     /** Fixed px width of the side rail. */
@@ -16534,8 +16601,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData) => ReturnType;
+        videoEmbed: {
+            setVideoEmbed: (options: {
+                src: string;
+            }) => ReturnType;
         };
     }
 }
@@ -16543,10 +16612,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        videoEmbed: {
-            setVideoEmbed: (options: {
-                src: string;
-            }) => ReturnType;
+        transcript: {
+            insertTranscript: (data: TranscriptData) => ReturnType;
         };
     }
 }

package/dist/experimental.js

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

package/dist/f0.d.ts

@@ -1419,12 +1419,6 @@ export declare type AutofillTimesheetShift = {
     locationType?: string | null;
 };
 
-/**
- * An item that can be passed in the `availableFormDefinitions` array.
- * Accepts either a plain {@link F0AiAvailableFormDefinition} or the result
- * of calling {@link useF0FormDefinition} (i.e. {@link F0FormDefinitionSingleSchema}
- * or {@link F0FormDefinitionPerSection}).
- */
 export declare type AvailableFormDefinitionItem = F0AiAvailableFormDefinition | F0FormDefinitionSingleSchema<any> | F0FormDefinitionPerSection<any>;
 
 declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & {
@@ -2259,6 +2253,9 @@ declare type CanvasCardAction = {
     hideLabel?: boolean;
 };
 
+/** The card's own control: open/close, or the host's custom action. */
+declare const CanvasCardAction: ({ action, isActive, }: Pick<F0CanvasCardProps, "action" | "isActive">) => JSX_2.Element | null;
+
 declare type CanvasCardAvatar = {
     type: "module";
     module: ModuleId;
@@ -2270,6 +2267,9 @@ declare type CanvasCardAvatar = {
     icon: IconType;
 };
 
+/** Whichever avatar the card was given: a module, a file, or an icon. */
+declare const CanvasCardAvatar: ({ avatar }: Pick<F0CanvasCardProps, "avatar">) => JSX_2.Element | null;
+
 /**
  * Discriminated union for canvas panel content.
  * Add new entity types to this union as they are implemented.
@@ -3201,6 +3201,12 @@ declare interface CheckboxProps extends DataAttributes_2 {
      * The title of the checkbox
      */
     title?: string;
+    /**
+     * A secondary line of text rendered under the title, for context the title
+     * cannot carry on its own. Hidden along with the title when `hideLabel` is
+     * set, and exposed to assistive technology as the checkbox's description.
+     */
+    description?: string;
     /**
      * The id of the checkbox
      */
@@ -8954,7 +8960,7 @@ declare type F0CardSelectField = F0BaseField & {
 
 export declare const F0Checkbox: WithDataTestIdReturnType_3<typeof _F0Checkbox>;
 
-declare function _F0Checkbox({ title, onCheckedChange, id, disabled, indeterminate, checked, value, hideLabel, presentational, stopPropagation, name, required, ...rest }: CheckboxProps): JSX_2.Element;
+declare function _F0Checkbox({ title, description, onCheckedChange, id, disabled, indeterminate, checked, value, hideLabel, presentational, stopPropagation, name, required, ...rest }: CheckboxProps): JSX_2.Element;
 
 /**
  * F0 config options specific to checkbox fields
@@ -18826,6 +18832,11 @@ declare interface TextProps extends Omit<default_2.HTMLAttributes<HTMLElement>,
      * @default false
      */
     required?: boolean;
+    /**
+     * The id of the control this text labels. Only meaningful together with
+     * `as="label"`; `React.HTMLAttributes` does not carry it.
+     */
+    htmlFor?: string;
 }
 
 declare type TextQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
@@ -20643,8 +20654,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData) => ReturnType;
+        videoEmbed: {
+            setVideoEmbed: (options: {
+                src: string;
+            }) => ReturnType;
         };
     }
 }
@@ -20652,10 +20665,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        videoEmbed: {
-            setVideoEmbed: (options: {
-                src: string;
-            }) => ReturnType;
+        transcript: {
+            insertTranscript: (data: TranscriptData) => ReturnType;
         };
     }
 }