@factorialco/f0-react 6.68.0 → 6.70.0

package/dist/experimental.d.ts

@@ -4128,6 +4128,7 @@ declare const defaultTranslations: {
         readonly copy: "Copy";
         readonly paste: "Paste";
         readonly close: "Close";
+        readonly back: "Back";
         readonly collapse: "Collapse";
         readonly collapseItem: "Collapse {{title}}";
         readonly expand: "Expand";
@@ -4691,6 +4692,7 @@ declare const defaultTranslations: {
             readonly ofTotal: "of total";
             readonly total: "total";
             readonly target: "target";
+            readonly ofTarget: "of target";
             readonly ofRange: "of range";
             readonly fromPrevious: "from previous";
             readonly fromStage: "from {{stage}}";
@@ -4983,6 +4985,7 @@ declare const defaultTranslations: {
         readonly editParamsTitle: "Edit widget params";
         readonly removeWidget: "Remove widget";
         readonly addWidget: "Add widget";
+        readonly configureWidget: "Configure {{title}}";
         /** Heads the widgets a Home suggests, at the top of the picker. */
         readonly recommended: "Recommended";
         /** Why a drop onto a pinned widget was refused. `{{title}}` is its name. */
@@ -14666,7 +14669,7 @@ export declare type WidgetAvatarsListItemProps = {
  * takes that column's width. So a Home keeps one list — the widgets it offers —
  * rather than two that have to be kept in step.
  */
-export declare function WidgetCatalog({ isOpen, onClose, widgets, onAdd, groups, area, previewWidth, slotRenderers, title, }: WidgetCatalogProps): JSX_2.Element;
+export declare function WidgetCatalog({ isOpen, onClose, widgets, onAdd, groups, area, previewWidth, slotRenderers, rebuildPreview, title, }: WidgetCatalogProps): JSX_2.Element;
 
 /**
  * One DOMAIN in the picker: a heading the widgets under it belong to.
@@ -14736,6 +14739,9 @@ export declare interface WidgetCatalogItem {
      * retire an entry without deleting it.
      */
     areas?: WidgetContainerSide[];
+    paramsSchema?: WidgetParamsSchema;
+    params?: WidgetParams;
+    addWithDefaults?: boolean;
 }
 
 export declare interface WidgetCatalogProps {
@@ -14744,7 +14750,7 @@ export declare interface WidgetCatalogProps {
     /** The widgets that can be added, in the order to list them. */
     widgets: WidgetCatalogItem[];
     /** Called with the chosen widget id when the CTA is pressed. */
-    onAdd: (id: string) => void;
+    onAdd: (id: string, params?: WidgetParams) => void;
     /**
      * The DOMAINS the picker is organised into, in the order to show them. Omit it
      * and the list is flat — grouping is an offer, not a requirement.
@@ -14775,6 +14781,7 @@ export declare interface WidgetCatalogProps {
      * "No renderer for slot …" and then render properly once added.
      */
     slotRenderers?: SlotRenderers;
+    rebuildPreview?: (item: WidgetCatalogItem, params: WidgetParams) => WidgetCatalogItem["preview"];
     title?: string;
 }
 
@@ -15209,11 +15216,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;
         };
     }
 }
@@ -15221,9 +15226,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;
         };
     }
 }

package/dist/experimental.js

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

package/dist/f0.d.ts

@@ -5019,6 +5019,7 @@ export declare const defaultTranslations: {
         readonly copy: "Copy";
         readonly paste: "Paste";
         readonly close: "Close";
+        readonly back: "Back";
         readonly collapse: "Collapse";
         readonly collapseItem: "Collapse {{title}}";
         readonly expand: "Expand";
@@ -5582,6 +5583,7 @@ export declare const defaultTranslations: {
             readonly ofTotal: "of total";
             readonly total: "total";
             readonly target: "target";
+            readonly ofTarget: "of target";
             readonly ofRange: "of range";
             readonly fromPrevious: "from previous";
             readonly fromStage: "from {{stage}}";
@@ -5874,6 +5876,7 @@ export declare const defaultTranslations: {
         readonly editParamsTitle: "Edit widget params";
         readonly removeWidget: "Remove widget";
         readonly addWidget: "Add widget";
+        readonly configureWidget: "Configure {{title}}";
         /** Heads the widgets a Home suggests, at the top of the picker. */
         readonly recommended: "Recommended";
         /** Why a drop onto a pinned widget was refused. `{{title}}` is its name. */
@@ -9049,6 +9052,33 @@ export declare interface F0DataChartBarProps extends F0DataChartBaseProps {
     orientation?: "vertical" | "horizontal";
     /** Stack all series into a single bar per category. @default false */
     stacked?: boolean;
+    /**
+     * Draw the stretch of a bar that ran past its `target` in a darker shade of
+     * the bar's own colour, split at the target.
+     *
+     * Left off, a target only shows as the faded ghost the bar has yet to reach,
+     * so a bar that beat its target looks the same as one that landed exactly on
+     * it — the reader has to eye its height against the ghosts beside it. Turn it
+     * on wherever passing the target is itself the news: attainment against a
+     * quota, a goal, a budget.
+     *
+     * Ignored by points with no target, and by negative values — "past the
+     * target" has no single reading when the bar grows downwards.
+     * @default false
+     */
+    highlightOverachievement?: boolean;
+    /**
+     * Add the share of the target the bar reached to its tooltip, under the
+     * target row (e.g. "108.1% of target").
+     *
+     * Opt-in: the percentage answers "how did this do against its target", which
+     * is the question on a quota or a goal, and noise on a chart where the target
+     * is a reference line the reader is not scoring against.
+     *
+     * The percentage is `value / target`, the same two numbers the bar draws.
+     * @default false
+     */
+    showTargetProgress?: boolean;
     /**
      * When {@link F0DataChartBaseProps.showLabels} is on, hide a category's value
      * labels if the widest value in that category doesn't fit the bar. The whole
@@ -20400,11 +20430,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;
         };
     }
 }
@@ -20412,9 +20440,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;
         };
     }
 }