@osdk/react-components 0.2.0-beta.9 → 0.2.1-main-20260407074313

package/build/types/action-form/ActionFormApi.d.ts

@@ -1,43 +1,34 @@
-import type { ActionDefinition, ActionEditResponse, ActionReturnTypeForOptions, ActionValidationResponse } from "@osdk/api";
-import type { ActionValidationError, ApplyActionOptions } from "@osdk/client";
-import type { ActionParameters, FieldKey, FieldValueType, FormFieldDefinition } from "./FormFieldApi.js";
+import type { ActionDefinition, ActionEditResponse, ActionValidationResponse } from "@osdk/api";
+import type { ActionValidationError } from "@osdk/client";
+import type { ActionParameters, FieldKey, FieldValueType, FormFieldDefinition, RendererFieldDefinition } from "./FormFieldApi.js";
 /**
-* Props for the ActionForm component
+* Props for the ActionForm component.
+*
+* A discriminated union ensures that controlled mode (formState provided)
+* always requires onFormStateChange, and uncontrolled mode makes `onFormStateChange` optional
 */
-export interface ActionFormProps<Q extends ActionDefinition<unknown>> {
+export type ActionFormProps<Q extends ActionDefinition<unknown>> = (ActionFormConfigProps<Q> & {
+	formState: FormState<Q>
+	onFormStateChange: (updater: (prevState: FormState<Q>) => FormState<Q>) => void
+}) | (ActionFormConfigProps<Q> & {
+	formState?: undefined
+	onFormStateChange?: (updater: (prevState: FormState<Q>) => FormState<Q>) => void
+});
+interface ActionFormConfigProps<Q extends ActionDefinition<unknown>> extends Pick<BaseFormProps, "formTitle" | "isSubmitDisabled"> {
 	actionDefinition: Q;
 	/**
-	* If not supplied, defaults to actionDef.displayName
+	* If not supplied, field definitions are constructed from `ActionParameters`.
 	*/
-	formTitle?: string;
-	/**
-	* If not supplied, this will be constructed from ActionParameters
-	*/
-	formFieldDefinition?: Array<FormFieldDefinition<Q>>;
-	/**
-	* Called when a field value changed.
-	* Required when a field is in controlled mode, i.e. value is provided via formFieldDefinition.
-	*
-	* @param fieldKey The key of the changed field
-	* @param value the updated value of the field
-	*/
-	onFieldValueChanged?: <K extends FieldKey<Q>>(fieldKey: K, value: FieldValueType<Q, K>) => void;
-	/**
-	* Override to disable submit button
-	* If not provided, button is disabled when form is submitting or has validation errors
-	*
-	* @default false
-	*/
-	isSubmitDisabled?: boolean;
+	formFieldDefinitions?: ReadonlyArray<FormFieldDefinition<Q>>;
 	/**
 	* If supplied, this will override the default submit action
-	* By default, the action's applyAction will be called with $validateOnly: false
+	* By default, the action's applyAction will be called
 	*
 	* @param formState all field values when onSubmit is called
-	* @param applyAction the function to execute the action. Call it with $validateOnly: true options to run validation mode onSubmit.
+	* @param applyAction the function to execute the action
 	* @returns a promise of the submission response
 	*/
-	onSubmit?: <OP extends ApplyActionOptions>(formState: FormState<Q>, applyAction: (args: ActionParameters<Q>, options?: OP) => Promise<ActionReturnTypeForOptions<OP>>) => Promise<ActionReturnTypeForOptions<OP>> | void;
+	onSubmit?: (formState: FormState<Q>, applyAction: (args: ActionParameters<Q>) => Promise<ActionEditResponse | undefined>) => Promise<unknown> | void;
 	/**
 	* Called when the validation response is returned from a validateOnly submission
 	*
@@ -49,7 +40,7 @@ export interface ActionFormProps<Q extends ActionDefinition<unknown>> {
 	*
 	* @param results the submission response
 	*/
-	onSuccess?: (results: ActionEditResponse) => void;
+	onSuccess?: (results: ActionEditResponse | undefined) => void;
 	/**
 	* Called when there is an error in form submission
 	*
@@ -60,7 +51,7 @@ export interface ActionFormProps<Q extends ActionDefinition<unknown>> {
 /**
 * Form values mapping parameter names to their values
 */
-export type FormState<Q extends ActionDefinition<unknown>> = { [K in FieldKey<Q>] : FieldValueType<Q, K> };
+export type FormState<Q extends ActionDefinition<unknown>> = { [K in FieldKey<Q>]? : FieldValueType<Q, K> };
 /**
 * Form error discriminated union
 */
@@ -69,8 +60,34 @@ export type FormError = {
 	error: ActionValidationError
 } | {
 	type: "submission"
-	error: Error
+	error: unknown
 } | {
 	type: "unknown"
 	error: unknown
 };
+/**
+* Props for the `BaseForm` component, which renders a form without
+* OSDK data fetching.
+*
+* Uses a discriminated union so that controlled mode (`formState` provided)
+* always requires `onFieldValueChange`, and uncontrolled mode omits both.
+* `onSubmit` receives the current form state so callers can access values
+* even in uncontrolled mode.
+*/
+export type BaseFormProps = BaseFormCommonProps & ({
+	formState: Record<string, unknown>
+	onFieldValueChange: (fieldKey: string, value: unknown) => void
+} | {
+	formState?: undefined
+	onFieldValueChange?: (fieldKey: string, value: unknown) => void
+});
+interface BaseFormCommonProps {
+	formTitle?: string;
+	fieldDefinitions: ReadonlyArray<RendererFieldDefinition>;
+	onSubmit: (formState: Record<string, unknown>) => void;
+	isSubmitDisabled?: boolean;
+	isPending?: boolean;
+	isLoading?: boolean;
+	className?: string;
+}
+export {};

package/build/types/action-form/ActionFormApi.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,kBACA,oBACA,4BACA,gCACK,WAAY;AACnB,cAAc,uBAAuB,0BAA0B,cAAe;AAC9E,cACE,kBACA,UACA,gBACA,2BACK,mBAAoB;;;;AAK3B,iBAAiB,gBAAgB,UAAU,2BAA2B;CACpE,kBAAkB;;;;CAKlB;;;;CAKA,sBAAsB,MAAM,oBAAoB;;;;;;;;CAShD,uBAAuB,UAAU,SAAS,IACxCA,UAAU,GACVC,OAAO,eAAe,GAAG;;;;;;;CAS3B;;;;;;;;;CAUA,YAAY,WAAW,oBACrBC,WAAW,UAAU,IACrBC,cACEC,MAAM,iBAAiB,IACvBC,UAAU,OACP,QAAQ,2BAA2B,SACrC,QAAQ,2BAA2B;;;;;;CAOxC,wBAAwBC,SAAS;;;;;;CAOjC,aAAaC,SAAS;;;;;;CAOtB,WAAWC,OAAO;AACnB;;;;AAKD,YAAY,UAAU,UAAU,gCAC7B,KAAK,SAAS,MAAK,eAAe,GAAG;;;;AAMxC,YAAY,YACR;CAAE,MAAM;CAAc,OAAO;AAAuB,IACpD;CAAE,MAAM;CAAc,OAAO;AAAO,IACpC;CAAE,MAAM;CAAW;AAAgB","names":["fieldKey: K","value: FieldValueType<Q, K>","formState: FormState<Q>","applyAction: (\n      args: ActionParameters<Q>,\n      options?: OP,\n    ) => Promise<ActionReturnTypeForOptions<OP>>","args: ActionParameters<Q>","options?: OP","results: ActionValidationResponse","results: ActionEditResponse","error: FormError"],"sources":["../../../src/action-form/ActionFormApi.ts"],"version":3,"file":"ActionFormApi.d.ts"}
+{"mappings":"AAgBA,cACE,kBACA,oBACA,gCACK,WAAY;AACnB,cAAc,6BAA6B,cAAe;AAC1D,cACE,kBACA,UACA,gBACA,qBACA,+BACK,mBAAoB;;;;;;;AAQ3B,YAAY,gBAAgB,UAAU,8BACjC,sBAAsB,KAAK;CAC5B,WAAW,UAAU;CACrB,oBACEA,UAAUC,WAAW,UAAU,OAAO,UAAU;AAEnD,MACE,sBAAsB,KAAK;CAC5B;CACA,qBACED,UAAUC,WAAW,UAAU,OAAO,UAAU;AAEnD;UAEO,sBAAsB,UAAU,mCAChC,KAAK,eAAe,cAAc,oBAC5C;CACE,kBAAkB;;;;CAKlB,uBAAuB,cAAc,oBAAoB;;;;;;;;;CAUzD,YACEC,WAAW,UAAU,IACrBC,cACEC,MAAM,iBAAiB,OACpB,QAAQ,oCACV;;;;;;CAOL,wBAAwBC,SAAS;;;;;;CAOjC,aAAaC,SAAS;;;;;;CAOtB,WAAWC,OAAO;AACnB;;;;AAKD,YAAY,UAAU,UAAU,gCAC7B,KAAK,SAAS,OAAM,eAAe,GAAG;;;;AAMzC,YAAY,YACR;CAAE,MAAM;CAAc,OAAO;AAAuB,IACpD;CAAE,MAAM;CAAc;AAAgB,IACtC;CAAE,MAAM;CAAW;AAAgB;;;;;;;;;;AAWvC,YAAY,gBACR,uBAEE;CACA,WAAW;CACX,qBAAqBC,kBAAkBC;AACxC,IACC;CACA;CACA,sBAAsBD,kBAAkBC;AACzC;UAGK,oBAAoB;CAC5B;CACA,kBAAkB,cAAc;CAChC,WAAWC,WAAW;CACtB;CACA;CACA;CACA;AACD","names":["updater: (prevState: FormState<Q>) => FormState<Q>","prevState: FormState<Q>","formState: FormState<Q>","applyAction: (\n      args: ActionParameters<Q>,\n    ) => Promise<ActionEditResponse | undefined>","args: ActionParameters<Q>","results: ActionValidationResponse","results: ActionEditResponse | undefined","error: FormError","fieldKey: string","value: unknown","formState: Record<string, unknown>"],"sources":["../../../src/action-form/ActionFormApi.ts"],"version":3,"file":"ActionFormApi.d.ts"}

package/build/types/action-form/BaseForm.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { BaseFormProps } from "./ActionFormApi.js";
+export declare const BaseForm: React.FC<BaseFormProps>;

package/build/types/action-form/BaseForm.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,OAAO,WAA2C,OAAQ;AAG1D,cAAc,qBAAqB,oBAAqB;AAMxD,OAAO,cAAMA,UAAU,MAAM,GAAG","names":["BaseForm: React.FC<BaseFormProps>"],"sources":["../../../src/action-form/BaseForm.tsx"],"version":3,"file":"BaseForm.d.ts"}

package/build/types/action-form/FormField.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+interface FormFieldProps {
+	fieldKey: string;
+	label?: string;
+	isRequired?: boolean;
+	helperText?: string;
+	error?: string;
+	children: React.ReactNode;
+}
+export declare const FormField: React.FC<FormFieldProps>;
+export {};

package/build/types/action-form/FormField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAqB,OAAQ;UAG1B,eAAe;CACvB;CACA;CACA;CACA;CACA;CACA,UAAU,MAAM;AACjB;AAED,OAAO,cAAMA,WAAW,MAAM,GAAG","names":["FormField: React.FC<FormFieldProps>"],"sources":["../../../src/action-form/FormField.tsx"],"version":3,"file":"FormField.d.ts"}

package/build/types/action-form/FormFieldApi.d.ts

@@ -1,13 +1,11 @@
-import type { ActionDefinition, CompileTimeMetadata, ObjectSet, ObjectTypeDefinition } from "@osdk/api";
+import type { ActionDefinition, ActionMetadata, ActionParam, CompileTimeMetadata, DataValueClientToWire, ObjectSet, ObjectTypeDefinition } from "@osdk/api";
 import type React from "react";
 /**
 * A form field definition specifies configuration for a single field
 */
 export interface FormFieldDefinition<
 	Q extends ActionDefinition<unknown>,
-	K extends FieldKey<Q> = FieldKey<Q>,
-	V extends FieldValueType<Q, K> = FieldValueType<Q, K>,
-	C extends ValidFormFieldForPropertyType<V> = ValidFormFieldForPropertyType<V>
+	K extends FieldKey<Q> = FieldKey<Q>
 > {
 	/**
 	* The field's unique key
@@ -15,22 +13,16 @@ export interface FormFieldDefinition<
 	fieldKey: K;
 	/**
 	* Display label for the field
-	* If not provided, the form field will not show any label.
 	*/
-	label?: string;
-	/**
-	* Current value of the field
-	* If provided, the field operates in controlled mode
-	*/
-	value?: V;
+	label: string;
 	/**
 	* Default value of the field
 	*/
-	defaultValue?: V;
+	defaultValue?: FieldValueType<Q, K>;
 	/**
 	* The form field component type to render
 	*/
-	fieldComponent: C;
+	fieldComponent: ValidFormFieldForPropertyType<FieldDescriptorType<Q, K>>;
 	/**
 	* Whether the field is required
 	*/
@@ -67,12 +59,12 @@ export interface FormFieldDefinition<
 	* @param value the current field value
 	* @returns a boolean promise indicating whether the value is valid
 	*/
-	validate?: (value: V) => Promise<boolean>;
+	validate?: (value: FieldValueType<Q, K>) => Promise<boolean>;
 	/**
 	* The component props for the form field
-	* Excludes runtime props (key, onChange) which are managed by ActionForm
+	* Excludes runtime props (value, onChange) which are managed by ActionForm
 	*/
-	fieldComponentProps?: Omit<FormFieldPropsByType[C], "key" | "onChange">;
+	fieldComponentProps: Omit<FormFieldPropsByType[ValidFormFieldForPropertyType<FieldDescriptorType<Q, K>>], "value" | "onChange">;
 }
 type ValidationError = {
 	type: ValidationRule
@@ -84,7 +76,7 @@ type ValidationRule = "required" | "min" | "max" | "minLength" | "maxLength" | "
 */
 export interface FormFieldPropsByType {
 	DATETIME_PICKER: DatetimePickerFieldProps;
-	DROPDOWN: DropdownFieldProps<unknown>;
+	DROPDOWN: DropdownFieldProps<unknown, boolean>;
 	FILE_PICKER: FilePickerProps;
 	NUMBER_INPUT: NumberInputFieldProps;
 	OBJECT_SET: ObjectSetFieldProps<ObjectTypeDefinition>;
@@ -94,52 +86,78 @@ export interface FormFieldPropsByType {
 	CUSTOM: CustomFieldProps<unknown>;
 }
 /**
-* Datetime picker field props
+* Datetime picker field props.
+*
+* When `formatDate` is omitted, ISO-like format is used (YYYY-MM-DD / YYYY-MM-DD HH:mm).
 */
 export interface DatetimePickerFieldProps extends BaseFormFieldProps<Date> {
-	fieldComponent: "DATETIME_PICKER";
 	/**
-	* The earliest date the user can select
-	* If provided, this will be added to the field validation
+	* The earliest date the user can select.
+	* If provided, this will be added to the field validation.
 	*/
 	min?: Date;
 	/**
-	* The latest date the user can select
-	* If provided, this will be added to the field validation
+	* The latest date the user can select.
+	* If provided, this will be added to the field validation.
 	*/
 	max?: Date;
 	/**
-	* Whether to show time picker
+	* Whether to show time picker.
 	*/
 	showTime?: boolean;
 	/**
-	* Function to format the date string
+	* Whether to close the popover after selecting a date.
+	* @default true when `showTime` is false, false when `showTime` is true
 	*/
+	closeOnSelection?: boolean;
+	/**
+	* Placeholder text shown when no value is selected.
+	*/
+	placeholder?: string;
+	/** Formats a Date for display in the trigger button. */
 	formatDate?: (date: Date) => string;
 }
 /**
-* Dropdown field props with selectable options
+* Dropdown field props with selectable items
 */
 export interface DropdownFieldProps<
 	V,
-	IsMulti extends boolean = false
-> extends BaseFormFieldProps<IsMulti extends true ? V[] : V> {
-	fieldComponent: "DROPDOWN";
+	Multiple extends boolean = false
+> extends BaseFormFieldProps<Multiple extends true ? V[] : V> {
 	/**
-	* Available options for the dropdown
+	* Available items for the dropdown
 	*/
-	options: Option<V>[];
+	items: V[];
+	/**
+	* Converts an item to a display string. Defaults to `String()`.
+	*/
+	itemToStringLabel?: (item: V) => string;
+	/**
+	* Returns a unique string key for a list item. Used as the React `key`.
+	* Falls back to the item's index when not provided.
+	*/
+	itemToKey?: (item: V) => string;
+	/**
+	* Custom equality check for item values. Defaults to `Object.is`.
+	* Required when items are objects to ensure correct selection matching.
+	*/
+	isItemEqual?: (a: V, b: V) => boolean;
 	/**
-	* Whether the dropdown allows searching/filtering
+	* Whether the dropdown allows searching/filtering.
+	* When true, renders a Combobox with a search input.
+	* When false (default), renders a Select dropdown.
 	*/
 	isSearchable?: boolean;
 	/**
+	* Placeholder text shown when no value is selected.
+	*/
+	placeholder?: string;
+	/**
 	* Whether multiple values can be selected
 	*/
-	isMulti?: boolean;
+	isMultiple?: Multiple;
 }
 export interface FilePickerProps extends BaseFormFieldProps<File | File[]> {
-	fieldComponent: "FILE_PICKER";
 	/**
 	* Whether multiple files can be selected
 	*/
@@ -152,34 +170,66 @@ export interface FilePickerProps extends BaseFormFieldProps<File | File[]> {
 	* Maximum file size in bytes
 	*/
 	maxSize?: number;
+	/**
+	* The text displayed when no file is selected.
+	*
+	* @default "No file chosen"
+	*/
+	text?: string;
+	/**
+	* The text displayed on the browse button.
+	*
+	* @default "Browse"
+	*/
+	buttonText?: string;
 }
 /**
 * Text area field props
 */
 export interface TextAreaFieldProps extends BaseFormFieldProps<string>, Pick<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows" | "wrap" | "minLength" | "maxLength"> {
-	fieldComponent: "TEXT_AREA";
+	placeholder?: string;
 }
 export interface TextInputFieldProps extends BaseFormFieldProps<string>, Pick<React.InputHTMLAttributes<HTMLInputElement>, "minLength" | "maxLength"> {
-	fieldComponent: "TEXT_INPUT";
+	placeholder?: string;
 }
 /**
 * Number input field props
 */
-export interface NumberInputFieldProps extends BaseFormFieldProps<number>, Pick<React.InputHTMLAttributes<HTMLInputElement>, "min" | "max" | "step"> {
-	fieldComponent: "NUMBER_INPUT";
+export interface NumberInputFieldProps extends BaseFormFieldProps<number> {
+	/**
+	* Minimum allowed value.
+	*/
+	min?: number;
+	/**
+	* Maximum allowed value.
+	*/
+	max?: number;
+	/**
+	* Step increment for the input. Used by the stepper buttons and ArrowUp/ArrowDown keyboard stepping.
+	*
+	* @default 1
+	*/
+	step?: number;
+	/**
+	* Placeholder text shown when the input is empty.
+	*/
+	placeholder?: string;
 }
 /**
 * Radio buttons field props
 */
 export interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {
-	fieldComponent: "RADIO_BUTTONS";
 	/**
-	* Available options for radio buttons
+	* Available options for radio buttons.
+	*
+	* Values are compared by reference equality (`===`). When options contain
+	* non-primitive values, pass the same object references for `value` and
+	* the corresponding option entry.
 	*/
 	options: Option<V>[];
 }
 /**
-* Option interface for dropdown and radio options
+* Option interface for radio button options
 */
 export interface Option<V> {
 	label: string;
@@ -188,35 +238,40 @@ export interface Option<V> {
 /**
 * Object set field displays the summary of the count of the given object set
 */
-export interface ObjectSetFieldProps<T extends ObjectTypeDefinition> extends BaseFormFieldProps<ObjectSet<T>> {
-	fieldComponent: "OBJECT_SET";
-}
+export interface ObjectSetFieldProps<T extends ObjectTypeDefinition> extends BaseFormFieldProps<ObjectSet<T>> {}
 /**
 * Custom field props for user-defined renderers
 */
 export interface CustomFieldProps<V> extends BaseFormFieldProps<V> {
-	fieldComponent: "CUSTOM";
 	/**
 	* Custom renderer function
 	*/
 	customRenderer: (props: BaseFormFieldProps<V>) => React.ReactNode;
 }
 export interface BaseFormFieldProps<V> {
-	fieldComponent: FieldComponent;
 	/**
-	* Called when the field value changed.
+	* The HTML `id` attribute for the field input element.
+	* Used for `<label htmlFor>` association.
+	*/
+	id?: string;
+	/**
+	* The value of the form field
+	*/
+	value: V | null;
+	/**
+	* Called when the field value changes.
 	*
-	* ActionForm internally wraps this to pass the key to onFieldValueChanged:
+	* ActionForm internally wraps this to pass the key to `onFieldValueChange`:
 	* ```
 	* <DropdownField
 	*   {...fieldDef}
-	*   onChange={(value) => onFieldValueChanged(fieldDef.key, value)}
+	*   onChange={(value) => onFieldValueChange(fieldDef.key, value)}
 	* />
 	* ```
 	*
 	* @param value The new value of the form field
 	*/
-	onChange?: (value?: V) => void;
+	onChange?: (value: V | null) => void;
 }
 export type FieldKey<Q extends ActionDefinition<unknown>> = keyof ActionParameters<Q>;
 /**
@@ -225,8 +280,17 @@ export type FieldKey<Q extends ActionDefinition<unknown>> = keyof ActionParamete
 export type ActionParameters<Q extends ActionDefinition<unknown>> = CompileTimeMetadata<Q>["parameters"];
 /**
 * Extracts the value type for a specific parameter
+*
+* TODO: Re-use `BaseType`
 */
 export type FieldValueType<
+	Q extends ActionDefinition<unknown>,
+	K extends keyof ActionParameters<Q> = keyof ActionParameters<Q>
+> = ActionParameters<Q>[K]["type"] extends ActionMetadata.DataType.Object<infer T> ? ActionParam.ObjectType<T> : ActionParameters<Q>[K]["type"] extends ActionMetadata.DataType.ObjectSet<infer T> ? ActionParam.ObjectSetType<T> : ActionParameters<Q>[K]["type"] extends ActionMetadata.DataType.Struct<infer T> ? ActionParam.StructType<T> : ActionParameters<Q>[K]["type"] extends keyof DataValueClientToWire ? DataValueClientToWire[ActionParameters<Q>[K]["type"]] : never;
+/**
+* Extracts the parameter type descriptor for a specific action parameter.
+*/
+export type FieldDescriptorType<
 	Q extends ActionDefinition<unknown> = ActionDefinition<unknown>,
 	K extends keyof ActionParameters<Q> = keyof ActionParameters<Q>
 > = ActionParameters<Q>[K]["type"];
@@ -235,7 +299,44 @@ export type FieldValueType<
 */
 export type FieldComponent = "DATETIME_PICKER" | "DROPDOWN" | "FILE_PICKER" | "NUMBER_INPUT" | "RADIO_BUTTONS" | "OBJECT_SET" | "TEXT_AREA" | "TEXT_INPUT" | "CUSTOM";
 /**
+* Describes the data type of a form field, independent of OSDK.
+* Mirrors ActionMetadata.DataType to keep the rendering layer OSDK-agnostic.
+*/
+export type FieldType = "boolean" | "string" | "integer" | "long" | "double" | "datetime" | "timestamp" | "attachment" | "marking" | "mediaReference" | "objectType" | "geoshape" | "geohash" | {
+	type: "object"
+	object: string
+} | {
+	type: "objectSet"
+	objectSet: string
+} | {
+	type: "interface"
+	interface: string
+} | {
+	type: "struct"
+	struct: Record<string, string>
+};
+/**
+* An OSDK-agnostic field definition used by BaseForm and FormFieldRenderer.
+* Contains only the information needed to render a single field — no generics,
+* no compile-time parameter constraints.
+*
+* Implemented as a distributed mapped type: switching on `fieldComponent`
+* narrows `fieldComponentProps` to the correct props type automatically.
+*/
+export type RendererFieldDefinition = { [K in FieldComponent] : {
+	fieldKey: string
+	fieldComponent: K
+	fieldType?: FieldType
+	label: string
+	defaultValue?: unknown
+	isRequired?: boolean
+	placeholder?: string
+	helperText?: string
+	helperTextPlacement?: "bottom" | "tooltip"
+	fieldComponentProps: Omit<FormFieldPropsByType[K], "value" | "onChange">
+} }[FieldComponent];
+/**
 * Gets valid form field types for a given property type
 */
-export type ValidFormFieldForPropertyType<P extends FieldValueType> = P extends "objectSet" ? "OBJECT_SET" : P extends "object" ? "DROPDOWN" : P extends "mediaReference" | "attachment" ? "FILE_PICKER" : P extends "boolean" ? "RADIO_BUTTONS" | "DROPDOWN" : P extends "string" ? "TEXT_INPUT" | "TEXT_AREA" : P extends "datetime" | "timestamp" ? "DATETIME_PICKER" : P extends "double" | "integer" | "long" | "float" | "short" | "byte" | "decimal" ? "NUMBER_INPUT" : never;
+export type ValidFormFieldForPropertyType<P extends FieldDescriptorType> = P extends "objectSet" ? "OBJECT_SET" : P extends "object" ? "DROPDOWN" : P extends "mediaReference" | "attachment" ? "FILE_PICKER" : P extends "boolean" ? "RADIO_BUTTONS" | "DROPDOWN" : P extends "string" ? "TEXT_INPUT" | "TEXT_AREA" : P extends "datetime" | "timestamp" ? "DATETIME_PICKER" : P extends "double" | "integer" | "long" | "float" | "short" | "byte" | "decimal" ? "NUMBER_INPUT" : never;
 export {};

package/build/types/action-form/FormFieldApi.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,kBACA,qBACA,WACA,4BACK,WAAY;AACnB,YAAY,WAAW,OAAQ;;;;AAK/B,iBAAiB;CACf,UAAU;CACV,UAAU,SAAS,KAAK,SAAS;CACjC,UAAU,eAAe,GAAG,KAAK,eAAe,GAAG;CACnD,UAAU,8BAA8B,KAAK,8BAA8B;EAC3E;;;;CAIA,UAAU;;;;;CAMV;;;;;CAMA,QAAQ;;;;CAKR,eAAe;;;;CAKf,gBAAgB;;;;CAKhB;;;;CAKA;;;;;CAMA;;;;;;CAOA,sBAAsB,WAAW;;;;CAKjC;;;;;;;CAQA,qBAAqBA,OAAO;;;;;;;CAQ5B,YAAYC,OAAO,MAAM;;;;;CAMzB,sBAAsB,KAAK,qBAAqB,IAAI,QAAQ;AAC7D;KAEI,kBAAkB;CAAE,MAAM;CAAgB;AAAe;KAEzD,iBACD,aACA,QACA,QACA,cACA,cACA,YACA;;;;AAKJ,iBAAiB,qBAAqB;CACpC,iBAAiB;CACjB,UAAU;CACV,aAAa;CACb,cAAc;CACd,YAAY,oBAAoB;CAChC,eAAe;CACf,WAAW;CACX,YAAY;CACZ,QAAQ;AACT;;;;AAKD,iBAAiB,iCAAiC,mBAAmB,MAAM;CACzE,gBAAgB;;;;;CAMhB,MAAM;;;;;CAMN,MAAM;;;;CAKN;;;;CAKA,cAAcC,MAAM;AACrB;;;;AAKD,iBAAiB;CAAmB;CAAG,0BAA0B;UACvD,mBAAmB,gBAAgB,OAAO,MAAM,GAC1D;CACE,gBAAgB;;;;CAKhB,SAAS,OAAO;;;;CAKhB;;;;CAKA;AACD;AAED,iBAAiB,wBAAwB,mBAAmB,OAAO,QAAQ;CACzE,gBAAgB;;;;CAKhB;;;;CAKA;;;;CAKA;AACD;;;;AAKD,iBAAiB,2BACf,4BACA,KACE,MAAM,uBAAuB,sBAC3B,SACA,SAIA,cAIA,aAEN;CACE,gBAAgB;AACjB;AAED,iBAAiB,4BACf,4BACA,KACE,MAAM,oBAAoB,mBAIxB,cAIA,aAEN;CACE,gBAAgB;AACjB;;;;AAKD,iBAAiB,8BACf,4BACA,KACE,MAAM,oBAAoB,mBAIxB,QAIA,QACA,QAEN;CACE,gBAAgB;AACjB;;;;AAKD,iBAAiB,uBAAuB,WAAW,mBAAmB,GAAG;CACvE,gBAAgB;;;;CAKhB,SAAS,OAAO;AACjB;;;;AAKD,iBAAiB,OAAO,GAAG;CACzB;CACA,OAAO;AACR;;;;AAKD,iBAAiB,oBAAoB,UAAU,8BACrC,mBAAmB,UAAU,IACvC;CACE,gBAAgB;AACjB;;;;AAKD,iBAAiB,iBAAiB,WAAW,mBAAmB,GAAG;CACjE,gBAAgB;;;;CAKhB,iBAAiBC,OAAO,mBAAmB,OAAO,MAAM;AACzD;AAED,iBAAiB,mBAAmB,GAAG;CACrC,gBAAgB;;;;;;;;;;;;;;CAehB,YAAYC,QAAQ;AACrB;AAED,YAAY,SAAS,UAAU,mCACvB,iBAAiB;;;;AAKzB,YAAY,iBAAiB,UAAU,6BACrC,oBAAoB,GAAG;;;;AAKzB,YAAY;CACV,UAAU,4BAA4B;CACtC,gBAAgB,iBAAiB,WAAW,iBAAiB;IAC3D,iBAAiB,GAAG,GAAG;;;;AAK3B,YAAY,iBACR,oBACA,aACA,gBACA,iBACA,kBACA,eACA,cACA,eACA;;;;AAKJ,YAAY,8BAA8B,UAAU,kBAAkB,UACpE,cAAc,eACZ,UAAU,WAAW,aACrB,UAAU,mBAAmB,eAAe,gBAC5C,UAAU,YAAY,kBAAkB,aACxC,UAAU,WAAW,eAAe,cACpC,UAAU,aAAa,cAAc,oBACrC,UACE,WACA,YACA,SACA,UACA,UACA,SACA,YAAY","names":["error: ValidationError","value: V","date: Date","props: BaseFormFieldProps<V>","value?: V"],"sources":["../../../src/action-form/FormFieldApi.ts"],"version":3,"file":"FormFieldApi.d.ts"}
+{"mappings":"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","names":["error: ValidationError","value: FieldValueType<Q, K>","date: Date","item: V","a: V","b: V","props: BaseFormFieldProps<V>","value: V | null"],"sources":["../../../src/action-form/FormFieldApi.ts"],"version":3,"file":"FormFieldApi.d.ts"}

package/build/types/action-form/FormHeader.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+interface FormHeaderProps {
+	title: string;
+}
+export declare const FormHeader: React.FC<FormHeaderProps>;
+export {};

package/build/types/action-form/FormHeader.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAqB,OAAQ;UAG1B,gBAAgB;CACxB;AACD;AAED,OAAO,cAAMA,YAAY,MAAM,GAAG","names":["FormHeader: React.FC<FormHeaderProps>"],"sources":["../../../src/action-form/FormHeader.tsx"],"version":3,"file":"FormHeader.d.ts"}

package/build/types/action-form/fields/CustomField.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type { CustomFieldProps } from "../FormFieldApi.js";
+/**
+* Renders a user-provided custom field. Delegates all rendering to the
+* `customRenderer` callback, passing through the standard form field props
+* (value, onChange, id) so the custom implementation can participate in
+* form state management.
+*/
+export declare const CustomField: React.FC<CustomFieldProps<unknown>>;

package/build/types/action-form/fields/CustomField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAqB,OAAQ;AACpC,cAAc,wBAAwB,oBAAqB;;;;;;;AAQ3D,OAAO,cAAMA,aAAa,MAAM,GAAG","names":["CustomField: React.FC<CustomFieldProps<unknown>>"],"sources":["../../../../src/action-form/fields/CustomField.tsx"],"version":3,"file":"CustomField.d.ts"}

package/build/types/action-form/fields/DateCalendar.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+export interface DateCalendarProps {
+	dateSelected: Date | undefined;
+	onSelect: (date: Date | undefined) => void;
+	min?: Date;
+	max?: Date;
+	footer?: React.ReactNode;
+}
+export default function DateCalendar({ dateSelected, onSelect, min, max, footer }: DateCalendarProps): React.ReactElement;

package/build/types/action-form/fields/DateCalendar.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAwB,OAAQ;AA8BvC,iBAAiB,kBAAkB;CACjC,cAAc;CACd,WAAWA,MAAM;CACjB,MAAM;CACN,MAAM;CACN,SAAS,MAAM;AAChB;eAEc,SAAS,aAAa,EACnC,cACA,UACA,KACA,KACA,QACkB,EAAjB,oBAAoB,MAAM","names":["date: Date | undefined"],"sources":["../../../../src/action-form/fields/DateCalendar.tsx"],"version":3,"file":"DateCalendar.d.ts"}

package/build/types/action-form/fields/DatetimePickerField.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { DatetimePickerFieldProps } from "../FormFieldApi.js";
+export declare function DatetimePickerField({ id, value, onChange, min, max, placeholder, formatDate, showTime, closeOnSelection }: DatetimePickerFieldProps): React.ReactElement;

package/build/types/action-form/fields/DatetimePickerField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAmBA,OAAO,WAA+C,OAAQ;AAM9D,cAAc,gCAAgC,oBAAqB;AAWnE,OAAO,iBAAS,oBAAoB,EAClC,IACA,OACA,UACA,KACA,KACA,aACA,YACA,UACA,kBACyB,EAAxB,2BAA2B,MAAM","names":[],"sources":["../../../../src/action-form/fields/DatetimePickerField.tsx"],"version":3,"file":"DatetimePickerField.d.ts"}

package/build/types/action-form/fields/DropdownField.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+import type { DropdownFieldProps } from "../FormFieldApi.js";
+export declare function DropdownField<
+	V,
+	Multiple extends boolean = false
+>({ isSearchable, itemToStringLabel, itemToKey,...rest }: DropdownFieldProps<V, Multiple>): React.ReactElement;

package/build/types/action-form/fields/DropdownField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAA4B,OAAQ;AAI3C,cAAc,0BAA0B,oBAAqB;AAS7D,OAAO,iBAAS;CAAc;CAAG,2BAA2B;EAAO,EACjE,cACA,mBACA,UACA,GAAG,MAC6B,EAA/B,mBAAmB,GAAG,YAAY,MAAM","names":[],"sources":["../../../../src/action-form/fields/DropdownField.tsx"],"version":3,"file":"DropdownField.d.ts"}

package/build/types/action-form/fields/FieldBridge.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type { Control } from "react-hook-form";
+import type { RendererFieldDefinition } from "../FormFieldApi.js";
+export interface FieldBridgeProps {
+	fieldDef: RendererFieldDefinition;
+	control: Control<Record<string, unknown>>;
+	onExternalChange?: (fieldKey: string, value: unknown) => void;
+}
+export declare const FieldBridge: React.FC<FieldBridgeProps>;

package/build/types/action-form/fields/FieldBridge.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAkC,OAAQ;AACjD,cAAc,eAAe,iBAAkB;AAE/C,cAAc,+BAA+B,oBAAqB;AAGlE,iBAAiB,iBAAiB;CAChC,UAAU;CACV,SAAS,QAAQ;CACjB,oBAAoBA,kBAAkBC;AACvC;AACD,OAAO,cAAMC,aAAa,MAAM,GAAG","names":["fieldKey: string","value: unknown","FieldBridge: React.FC<FieldBridgeProps>"],"sources":["../../../../src/action-form/fields/FieldBridge.tsx"],"version":3,"file":"FieldBridge.d.ts"}

package/build/types/action-form/fields/FilePickerField.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { FilePickerProps } from "../FormFieldApi.js";
+export declare const FilePickerField: React.FC<FilePickerProps>;

package/build/types/action-form/fields/FilePickerField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAmBA,OAAO,WAA0C,OAAQ;AACzD,cAAc,uBAAuB,oBAAqB;AAG1D,OAAO,cAAMA,iBAAiB,MAAM,GAAG","names":["FilePickerField: React.FC<FilePickerProps>"],"sources":["../../../../src/action-form/fields/FilePickerField.tsx"],"version":3,"file":"FilePickerField.d.ts"}

package/build/types/action-form/fields/FormFieldRenderer.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { RendererFieldDefinition } from "../FormFieldApi.js";
+export interface FormFieldRendererProps {
+	fieldDefinition: RendererFieldDefinition;
+	value: unknown;
+	onFieldValueChange: (value: unknown) => void;
+}
+export declare const FormFieldRenderer: React.FC<FormFieldRendererProps>;

package/build/types/action-form/fields/FormFieldRenderer.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAqB,OAAQ;AAEpC,cAAc,+BAA+B,oBAAqB;AAUlE,iBAAiB,uBAAuB;CACtC,iBAAiB;CACjB;CACA,qBAAqBA;AACtB;AAED,OAAO,cAAMC,mBAAmB,MAAM,GAAG","names":["value: unknown","FormFieldRenderer: React.FC<FormFieldRendererProps>"],"sources":["../../../../src/action-form/fields/FormFieldRenderer.tsx"],"version":3,"file":"FormFieldRenderer.d.ts"}

package/build/types/action-form/fields/LazyDateCalendar.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { DateCalendarProps } from "./DateCalendar.js";
+export declare function LazyDateCalendar(props: DateCalendarProps): React.ReactElement;

package/build/types/action-form/fields/LazyDateCalendar.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,WAAyB,OAAQ;AACxC,cAAc,yBAAyB,mBAAoB;AAK3D,OAAO,iBAAS,iBAAiBA,OAAO,oBAAoB,MAAM","names":["props: DateCalendarProps"],"sources":["../../../../src/action-form/fields/LazyDateCalendar.tsx"],"version":3,"file":"LazyDateCalendar.d.ts"}

package/build/types/action-form/fields/NumberInputField.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { NumberInputFieldProps } from "../FormFieldApi.js";
+export declare function NumberInputField({ id, value, onChange, placeholder, min: _min, max: _max, step }: NumberInputFieldProps): React.ReactElement;

package/build/types/action-form/fields/NumberInputField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAmBA,OAAO,WAA8C,OAAQ;AAC7D,cAAc,6BAA6B,oBAAqB;AAsBhE,OAAO,iBAAS,iBAAiB,EAC/B,IACA,OACA,UACA,aACA,KAAK,MACL,KAAK,MACL,MACsB,EAArB,wBAAwB,MAAM","names":[],"sources":["../../../../src/action-form/fields/NumberInputField.tsx"],"version":3,"file":"NumberInputField.d.ts"}

package/build/types/action-form/fields/RadioButtonsField.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { RadioButtonsFieldProps } from "../FormFieldApi.js";
+export declare const RadioButtonsField: <V>(props: RadioButtonsFieldProps<V>) => React.ReactElement;

package/build/types/action-form/fields/RadioButtonsField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAkBA,OAAO,WAA2C,OAAQ;AAE1D,cAAsB,8BAA8B,oBAAqB;AAGzE,OAAO,cAAMA,oBAAoB,GAC/BC,OAAO,uBAAuB,OAC3B,MAAM","names":["RadioButtonsField: <V>(\n  props: RadioButtonsFieldProps<V>,\n) => React.ReactElement","props: RadioButtonsFieldProps<V>"],"sources":["../../../../src/action-form/fields/RadioButtonsField.tsx"],"version":3,"file":"RadioButtonsField.d.ts"}