@factorialco/f0-react 6.91.2 → 6.92.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. */
@@ -16480,16 +16547,6 @@ declare namespace Calendar {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
-        };
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         enhanceHighlight: {
@@ -16512,6 +16569,16 @@ declare module "@tiptap/core" {
 }
 
 
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        };
+    }
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         indent: {

package/dist/experimental.js

@@ -1,4 +1,4 @@
-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 { 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-CjCTiapX.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";
 export {

package/dist/f0.d.ts

@@ -20589,16 +20589,6 @@ declare namespace Calendar {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
-        };
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         enhanceHighlight: {
@@ -20621,6 +20611,16 @@ declare module "@tiptap/core" {
 }
 
 
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        };
+    }
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         indent: {

package/dist/i18n-provider-defaults.d.ts

@@ -1346,16 +1346,6 @@ declare namespace Calendar {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
-        };
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         enhanceHighlight: {
@@ -1378,6 +1368,16 @@ declare module "@tiptap/core" {
 }
 
 
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        };
+    }
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         indent: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factorialco/f0-react",
-  "version": "6.91.2",
+  "version": "6.92.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/factorialco/f0.git",
@@ -262,8 +262,8 @@
     "build-icons": "tsc --project ./tsconfig-build-icons.json",
     "build:tailwind": "NODE_ENV=production tailwindcss -i src/styles.css -o ./dist/styles.css --postcss --minify",
     "build:watch": "pnpm build --watch",
-    "lint": "sh -c 'oxlint --type-aware \"${@:-src/}\" --max-warnings 0' --",
-    "lint:fix": "sh -c 'oxlint --type-aware \"${@:-src/}\" --fix --max-warnings 0' --",
+    "lint": "sh -c 'oxlint --type-aware \"${@:-src/}\" --quiet' --",
+    "lint:fix": "sh -c 'oxlint --type-aware \"${@:-src/}\" --fix --quiet' --",
     "preview": "vite preview",
     "generate-icons": "rm -fR src/icons/app/* src/icons/modules/* src/flags/components/* src/icons/ai/* && run-p generate-app-icons generate-module-icons generate-flag-icons generate-ai-icons && oxfmt \"src/{icons,flags}/**/*.tsx\" && pnpm generate-icon-barrels",
     "generate-icon-barrels": "bash scripts/generate-icon-barrels.sh src/icons/app src/icons/modules src/icons/ai src/flags/components",
@@ -285,6 +285,7 @@
     "check:new-component-dod": "tsx .scripts/check-new-component-dod.ts",
     "check:stable-dod": "tsx .scripts/check-stable-dod.ts",
     "check:untranslated-copy": "tsx .scripts/check-untranslated-copy.ts",
+    "check:lint-debt": "tsx .scripts/check-lint-debt.ts",
     "preflight": "tsx .scripts/pre-push-preflight.ts",
     "vitest": "vitest --project=unit",
     "vitest:ui": "vitest --project=unit --ui",