@factorialco/f0-react 6.4.0 → 6.6.0

package/dist/experimental.d.ts

@@ -3925,6 +3925,7 @@ declare const defaultTranslations: {
             readonly title: "No data available";
             readonly description: "Try a different date or fewer filters";
         };
+        readonly windowedCategories: "Showing {{count}} of {{total}} categories";
         readonly tooltip: {
             readonly ofTotal: "of total";
             readonly total: "total";

package/dist/experimental.js

@@ -3,8 +3,8 @@ import { cX as a1, cW as s1, d7 as l1, cT as c1, cU as d1, cN as u1, cO as f1, c
 import { jsx as n, jsxs as h, Fragment as Ae } from "react/jsx-runtime";
 import Y, { forwardRef as Oe, useRef as O, useTransition as bu, useState as B, useLayoutEffect as Hn, useId as Ln, useContext as zt, createContext as ht, useEffect as q, useCallback as U, useMemo as de, Fragment as _t, isValidElement as vu, cloneElement as hs, Suspense as Er, lazy as sn, createElement as or, memo as ps, Children as gs } from "react";
 import { d as k, T as xu, a as yu, b as wu, f as Ye, c as Nu, u as Cu } from "./tooltip-Cik7KBQT.js";
-import { C as Iu, P as ku, E as Su, a as Uo, b as Wn, M as Tu, p as Ru, c as Eu, R as Ri, e as bs, u as Lu, f as zu, g as Fu, h as Au, i as Pu, j as Mu, O as vs, k as xs, S as Ou, A as Du, B as Bu, L as _u, l as $u, V as Hu, m as Wu, n as ju, o as Uu } from "./index-C5uJNrqj.js";
-import { a5 as D1, a6 as B1, v as _1, w as $1, s as H1, N as W1, x as j1, H as U1, ag as V1, K as G1, t as K1, a3 as q1, ai as Y1, ah as X1, X as J1, al as Q1, F as Z1, a0 as ey, Z as ty, T as ny, an as ry, U as oy, a1 as iy, a2 as ay, y as sy, aj as ly, ak as cy, W as dy, a4 as uy, ad as fy, af as my, z as hy, G as py, I as gy, _ as by, am as vy, $ as xy, Y as yy, ao as wy, D as Ny, J as Cy, q as Iy, r as ky, a9 as Sy, aa as Ty, a7 as Ry, ae as Ey, Q as Ly, ab as zy, a8 as Fy, ac as Ay } from "./index-C5uJNrqj.js";
+import { C as Iu, P as ku, E as Su, a as Uo, b as Wn, M as Tu, p as Ru, c as Eu, R as Ri, e as bs, u as Lu, f as zu, g as Fu, h as Au, i as Pu, j as Mu, O as vs, k as xs, S as Ou, A as Du, B as Bu, L as _u, l as $u, V as Hu, m as Wu, n as ju, o as Uu } from "./index-GMJbBTvj.js";
+import { a5 as D1, a6 as B1, v as _1, w as $1, s as H1, N as W1, x as j1, H as U1, ag as V1, K as G1, t as K1, a3 as q1, ai as Y1, ah as X1, X as J1, al as Q1, F as Z1, a0 as ey, Z as ty, T as ny, an as ry, U as oy, a1 as iy, a2 as ay, y as sy, aj as ly, ak as cy, W as dy, a4 as uy, ad as fy, af as my, z as hy, G as py, I as gy, _ as by, am as vy, $ as xy, Y as yy, ao as wy, D as Ny, J as Cy, q as Iy, r as ky, a9 as Sy, aa as Ty, a7 as Ry, ae as Ey, Q as Ly, ab as zy, a8 as Fy, ac as Ay } from "./index-GMJbBTvj.js";
 import Vu from "react-dom";
 const Gu = hc("Search", [
   ["circle", { cx: "11", cy: "11", r: "8", key: "4ej97u" }],
@@ -7899,7 +7899,7 @@ const fl = () => Ut(ol, "useChatJump"), Jh = () => Ut(il, "useChatHighlightedId"
 }, Pr = (e, t) => {
   const r = document.createElement("a");
   r.href = e, r.download = t, r.rel = "noreferrer", r.click();
-}, tp = sn(() => import("./ChatPdfThumbnail-DyDN7a-p.js")), np = sn(() => import("./ChatSheetThumbnail-BvnxT-4A.js")), rp = sn(() => import("./ChatDocxThumbnail-DzNPNFya.js")), op = sn(() => import("./ChatTextThumbnail-yVt_iYi7.js")), ip = 288, ap = 160, sp = (e) => {
+}, tp = sn(() => import("./ChatPdfThumbnail-D64TOT76.js")), np = sn(() => import("./ChatSheetThumbnail-BvnxT-4A.js")), rp = sn(() => import("./ChatDocxThumbnail-DzNPNFya.js")), op = sn(() => import("./ChatTextThumbnail-yVt_iYi7.js")), ip = 288, ap = 160, sp = (e) => {
   const [t, r] = B(!1);
   return q(() => {
     const o = e.current;
@@ -9942,7 +9942,7 @@ const kp = {
     ] })
   ] }) });
 }, Dp = sn(
-  () => import("./index-Cdvq3ahA.js").then((e) => e.i).then((e) => ({
+  () => import("./index-BW-Go-y_.js").then((e) => e.i).then((e) => ({
     default: e.F0PdfViewer
   }))
 ), Bp = () => {

package/dist/f0.d.ts

@@ -5219,6 +5219,7 @@ export declare const defaultTranslations: {
             readonly title: "No data available";
             readonly description: "Try a different date or fewer filters";
         };
+        readonly windowedCategories: "Showing {{count}} of {{total}} categories";
         readonly tooltip: {
             readonly ofTotal: "of total";
             readonly total: "total";
@@ -8425,7 +8426,7 @@ export declare interface F0DataChartBarProps extends F0DataChartBaseProps {
     /**
      * Per-side clearance in pixels the widest value must have before
      * {@link F0DataChartBarProps.hideOverflowingLabels} counts it as fitting.
-     * Overrides the default, which is placement-based: **12** for stacked (inside)
+     * Overrides the default, which is placement-based: **6** for stacked (inside)
      * labels, **0** for labels outside the bar.
      */
     labelFitPadding?: number;
@@ -8438,6 +8439,43 @@ export declare interface F0DataChartBarProps extends F0DataChartBaseProps {
      * widths differ. Height overflow is also evaluated per bar. @default true
      */
     hideAllLabelsOnOverflow?: boolean;
+    /**
+     * Draw only as many categories as fit at a readable bar thickness, instead of
+     * compressing every one of them into the available height.
+     *
+     * Opt-in, because it hides data: a windowed chart shows the first N rows in
+     * data order and nothing in the chart itself leads to the rest. Set it only
+     * where the surrounding UI offers the way back — subscribe to
+     * {@link F0DataChartBarProps.onHiddenCategoriesChange} and put a control next
+     * to the count, as `F0AnalyticsDashboard` does. Left off, a dense chart stays
+     * complete and its bars get thinner, which is the readable-but-honest end of
+     * the trade.
+     *
+     * Ignored by vertical charts, which lay categories out along the width.
+     * @default false
+     */
+    windowCategories?: boolean;
+    /**
+     * Render every category at once, overriding
+     * {@link F0DataChartBarProps.windowCategories}.
+     *
+     * Set this when the reader has asked to see the whole distribution — an
+     * expanded or fullscreen view — and accepts thinner bars in exchange. Ignored
+     * by vertical charts, which lay categories out along the width.
+     * @default false
+     */
+    showAllCategories?: boolean;
+    /**
+     * Reports how many categories the row window is hiding — `0` when every
+     * category is on screen. Fires whenever the count changes, which includes
+     * container resizes and {@link F0DataChartBarProps.showAllCategories} being
+     * switched on.
+     *
+     * The chart states the fact rather than rendering an affordance for it: only
+     * the surrounding UI knows where a "see everything" control belongs. The
+     * dashboard puts it in the widget's description, next to the count.
+     */
+    onHiddenCategoriesChange?: (hiddenCategoryCount: number) => void;
     /**
      * Suggested number of segments on the value axis — lower values draw fewer
      * grid lines. Applies to whichever axis is the value axis (Y for vertical
@@ -10401,6 +10439,23 @@ export declare type F0FormFieldProps = F0FormFieldFileProps | F0FormFieldNonFile
  */
 export declare type F0FormLikeComponent = React.ComponentType<F0FormCommonProps>;
 
+/**
+ * Styling configuration for per-section schema forms.
+ * Extends the base config with options that only apply when each section
+ * has its own independent schema and submit button.
+ */
+declare interface F0FormPerSectionStylingConfig extends F0FormStylingConfig {
+    /**
+     * Renders only the section selected in the sidepanel instead of stacking
+     * all sections. Useful for large forms where showing every section at once
+     * is overwhelming. Hidden sections stay mounted so their values, dirty
+     * state, and validation are preserved.
+     * Has no effect unless `showSectionsSidepanel` is true.
+     * @default false
+     */
+    showOnlySelectedSection?: boolean;
+}
+
 /**
  * Union of all F0Form prop variants.
  * The component detects the mode based on whether `schema` is a single Zod schema
@@ -10443,7 +10498,7 @@ declare interface F0FormPropsWithDefinition {
 export declare interface F0FormPropsWithPerSectionDefinition<T extends F0PerSectionSchema> {
     formDefinition: F0FormDefinitionPerSection_2<T>;
     className?: string;
-    styling?: F0FormStylingConfig;
+    styling?: F0FormPerSectionStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
     /** Upload hook shared by all file fields in the form. */
@@ -10491,7 +10546,7 @@ export declare interface F0FormPropsWithPerSectionSchema<T extends F0PerSectionS
     /**
      * Styling configuration for form layout and appearance.
      */
-    styling?: F0FormStylingConfig;
+    styling?: F0FormPerSectionStylingConfig;
     /**
      * Ref to control the form programmatically from outside.
      */
@@ -10701,7 +10756,9 @@ declare type F0FormStateCallback = (state: {
  */
 export declare interface F0FormStylingConfig {
     /**
-     * Shows a sidebar with section navigation (Table of Contents)
+     * Shows a sidebar with section navigation (Table of Contents).
+     * Automatically hidden on small viewports (max-width 560px), where
+     * sections stack as in the regular layout.
      * @default false
      */
     showSectionsSidepanel?: boolean;