@factorialco/f0-react 1.362.2 → 1.362.3

package/dist/ai.d.ts

@@ -1164,9 +1164,9 @@ declare namespace Calendar {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -1174,9 +1174,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }

package/dist/experimental.d.ts

@@ -6634,9 +6634,9 @@ declare namespace Calendar {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -6644,9 +6644,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }

package/dist/f0.d.ts

@@ -106,6 +106,7 @@ import { TrackReferenceOrPlaceholder } from '@livekit/components-react';
 import { ValueDisplayRendererContext } from '../../../ui/value-display';
 import { VariantProps } from 'cva';
 import { z } from 'zod';
+import { ZodEffects } from 'zod';
 import { ZodRawShape } from 'zod';
 import { ZodTypeAny } from 'zod';
 
@@ -3415,28 +3416,78 @@ declare type F0CustomFieldConfigWithConfig<TValue = unknown, TConfig = unknown>
 /**
  * F0 config options specific to date fields
  *
- * Note: `minDate`, `maxDate`, and `clearable` are derived from the Zod schema:
+ * Note: `clearable` is derived from the Zod schema:
+ * - `z.date().optional()` or `z.date().nullable()` → clearable
+ *
+ * Static minDate/maxDate can also be derived from the Zod schema:
  * - `z.date().min(date)` → minDate
  * - `z.date().max(date)` → maxDate
- * - `z.date().optional()` or `z.date().nullable()` → clearable
+ *
+ * For dynamic constraints based on other fields, use function syntax:
+ * @example
+ * ```ts
+ * endDate: f0FormField(z.date(), {
+ *   label: "End Date",
+ *   minDate: ({ values }) => values.startDate, // Dynamic: after start date
+ * })
+ * ```
  */
 export declare interface F0DateConfig {
     /** Available granularities for the date picker */
     granularities?: DateGranularity[];
     /** Preset date options to display */
     presets?: DatePreset[];
+    /**
+     * Minimum selectable date.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     * Overrides z.date().min() if provided.
+     * @example
+     * // Static constraint
+     * minDate: new Date("2024-01-01")
+     *
+     * // Dynamic constraint based on another field
+     * minDate: ({ values }) => values.startDate
+     */
+    minDate?: F0DateConstraintProp;
+    /**
+     * Maximum selectable date.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     * Overrides z.date().max() if provided.
+     * @example
+     * // Static constraint
+     * maxDate: new Date("2025-12-31")
+     *
+     * // Dynamic constraint based on another field
+     * maxDate: ({ values }) => values.endDate
+     */
+    maxDate?: F0DateConstraintProp;
 }
 
+/**
+ * Function type for dynamic date constraint evaluation based on form values.
+ * Used for minDate/maxDate that depend on other field values.
+ *
+ * @example
+ * ```ts
+ * // End date must be after start date
+ * minDate: ({ values }) => values.startDate
+ * ```
+ */
+declare type F0DateConstraintFunction = (context: {
+    values: Record<string, unknown>;
+}) => Date | undefined;
+
+/**
+ * Date constraint can be a static Date or a function that receives form values
+ */
+declare type F0DateConstraintProp = Date | F0DateConstraintFunction;
+
 /**
  * Date field with all properties for rendering
  * Includes properties derived from Zod schema
  */
 export declare type F0DateField = F0BaseField & F0DateConfig & {
     type: "date";
-    /** Minimum selectable date (derived from z.date().min()) */
-    minDate?: Date;
-    /** Maximum selectable date (derived from z.date().max()) */
-    maxDate?: Date;
     /** Whether the date can be cleared (derived from optional/nullable) */
     clearable?: boolean;
     /** Conditional rendering based on another field's value */
@@ -3509,9 +3560,7 @@ export declare type F0DateRangeFieldConfig = F0BaseConfig & F0DateRangeConfig &
 /**
  * F0 config options specific to datetime fields
  *
- * Note: `minDate`, `maxDate`, and `clearable` are derived from the Zod schema:
- * - `z.date().min(date)` → minDate
- * - `z.date().max(date)` → maxDate
+ * Note: `clearable` is derived from the Zod schema:
  * - `z.date().optional()` or `z.date().nullable()` → clearable
  */
 export declare interface F0DateTimeConfig {
@@ -3519,6 +3568,18 @@ export declare interface F0DateTimeConfig {
     granularities?: DateGranularity[];
     /** Preset date options to display in the date picker */
     presets?: DatePreset[];
+    /**
+     * Minimum selectable datetime.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     * Overrides z.date().min() if provided.
+     */
+    minDate?: F0DateConstraintProp;
+    /**
+     * Maximum selectable datetime.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     * Overrides z.date().max() if provided.
+     */
+    maxDate?: F0DateConstraintProp;
 }
 
 /**
@@ -3527,10 +3588,6 @@ export declare interface F0DateTimeConfig {
  */
 export declare type F0DateTimeField = F0BaseField & F0DateTimeConfig & {
     type: "datetime";
-    /** Minimum selectable datetime (derived from z.date().min()) */
-    minDate?: Date;
-    /** Maximum selectable datetime (derived from z.date().max()) */
-    maxDate?: Date;
     /** Whether the datetime can be cleared (derived from optional/nullable) */
     clearable?: boolean;
     /** Conditional rendering based on another field's value */
@@ -3707,7 +3764,7 @@ export declare interface F0FilterPickerContentProps<Filters extends FiltersDefin
 /**
  * @experimental This is an experimental component, use it at your own risk
  */
-export declare const F0Form: <TSchema extends z.ZodObject<ZodRawShape>>(props: F0FormProps<TSchema>) => React.ReactElement;
+export declare const F0Form: <TSchema extends F0FormSchema>(props: F0FormProps<TSchema>) => React.ReactElement;
 
 /**
  * Submit configuration for action bar type
@@ -3851,6 +3908,7 @@ export declare function f0FormField<T extends ZodTypeAny, V extends string | num
  * Props for the F0Form component
  *
  * @typeParam TSchema - The Zod object schema type. The form data type is inferred from this.
+ *                      Can be a plain ZodObject or a refined ZodObject (using .refine()).
  *
  * @example
  * ```tsx
@@ -3867,20 +3925,17 @@ export declare function f0FormField<T extends ZodTypeAny, V extends string | num
  *   onSubmit={(data) => ({ success: true })}
  * />
  *
- * // Action bar with discard button
- * <F0Form
- *   name="my-form"
- *   schema={schema}
- *   submitConfig={{
- *     type: "action-bar",
- *     discardable: true,
- *   }}
- *   defaultValues={{ name: "" }}
- *   onSubmit={(data) => ({ success: true })}
- * />
+ * // With cross-field validation using .refine()
+ * const schemaWithRefine = z.object({
+ *   startDate: f0FormField(z.date(), { label: "Start" }),
+ *   endDate: f0FormField(z.date(), { label: "End" }),
+ * }).refine((data) => data.endDate > data.startDate, {
+ *   message: "End date must be after start date",
+ *   path: ["endDate"],
+ * })
  * ```
  */
-export declare interface F0FormProps<TSchema extends z.ZodObject<ZodRawShape>> {
+export declare interface F0FormProps<TSchema extends F0FormSchema> {
     /** Unique name for the form, used for generating anchor links (e.g., #forms.[name].[sectionId].[fieldId]) */
     name: string;
     /** Zod object schema with F0 field configurations */
@@ -3945,9 +4000,9 @@ export declare interface F0FormRef {
 }
 
 /**
- * Type helper for creating a form schema with F0 fields
+ * Type for F0Form schemas - can be a plain ZodObject or a refined ZodObject (ZodEffects)
  */
-export declare type F0FormSchema<T extends Record<string, ZodTypeAny>> = z.ZodObject<T>;
+export declare type F0FormSchema<T extends ZodRawShape = ZodRawShape> = z.ZodObject<T> | ZodEffects<z.ZodObject<T>>;
 
 /**
  * Callback to update form state in the hook
@@ -4626,6 +4681,16 @@ export declare type F0ThinkingProps = {
  * - `z.string().optional()` or `z.string().nullable()` → clearable
  */
 export declare interface F0TimeConfig {
+    /**
+     * Minimum selectable time.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     */
+    minDate?: F0DateConstraintProp;
+    /**
+     * Maximum selectable time.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     */
+    maxDate?: F0DateConstraintProp;
 }
 
 /**
@@ -4634,10 +4699,6 @@ export declare interface F0TimeConfig {
  */
 export declare type F0TimeField = F0BaseField & F0TimeConfig & {
     type: "time";
-    /** Minimum selectable date/time (derived from z.date().min()) */
-    minDate?: Date;
-    /** Maximum selectable date/time (derived from z.date().max()) */
-    maxDate?: Date;
     /** Whether the time can be cleared (derived from optional/nullable) */
     clearable?: boolean;
     /** Conditional rendering based on another field's value */
@@ -4920,7 +4981,7 @@ export declare function getF0Config(schema: ZodTypeAny): F0FieldConfig | undefin
  * @param sections - Optional section configurations keyed by section ID
  * @returns Array of form definition items
  */
-export declare function getSchemaDefinition(schema: z.ZodObject<ZodRawShape>, sections?: Record<string, F0SectionConfig>): FormDefinitionItem[];
+export declare function getSchemaDefinition(schema: F0FormSchema, sections?: Record<string, F0SectionConfig>): FormDefinitionItem[];
 
 declare interface GranularityDefinition {
     calendarMode?: CalendarMode;
@@ -7434,7 +7495,7 @@ export declare const useReducedMotion: () => boolean;
  * })
  * ```
  */
-export declare function useSchemaDefinition(schema: z.ZodObject<ZodRawShape>, sections?: Record<string, F0SectionConfig>): FormDefinitionItem[];
+export declare function useSchemaDefinition(schema: F0FormSchema, sections?: Record<string, F0SectionConfig>): FormDefinitionItem[];
 
 /**
  * Custom hook to manage selection state for items and groups in a data table
@@ -7634,7 +7695,7 @@ declare interface WithTooltipDescription {
  * Zod type names for type checking without instanceof
  * Using _def.typeName is more reliable across module boundaries than instanceof
  */
-declare type ZodTypeName = "ZodString" | "ZodNumber" | "ZodBoolean" | "ZodDate" | "ZodEnum" | "ZodArray" | "ZodObject" | "ZodOptional" | "ZodNullable" | "ZodDefault" | "ZodLiteral";
+declare type ZodTypeName = "ZodString" | "ZodNumber" | "ZodBoolean" | "ZodDate" | "ZodEnum" | "ZodArray" | "ZodObject" | "ZodOptional" | "ZodNullable" | "ZodDefault" | "ZodLiteral" | "ZodEffects";
 
 export { }
 
@@ -7683,9 +7744,9 @@ declare namespace Calendar {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -7693,9 +7754,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }