@osdk/react-components 0.2.0-beta.21 → 0.2.0-beta.22

package/build/cjs/public/experimental.d.cts

@@ -1,7 +1,8 @@
 import * as React from 'react';
 import React__default, { ReactNode, ReactElement } from 'react';
-import { ObjectTypeDefinition, ObjectSet, WhereClause, PropertyKeys, LinkNames, LinkedType, WirePropertyTypes, CompileTimeMetadata, ObjectOrInterfaceDefinition, SimplePropertyDef, QueryDefinition, QueryMetadata, Osdk, DerivedProperty, PrimaryKeyType, Media } from '@osdk/api';
+import { ObjectTypeDefinition, ObjectSet, WhereClause, PropertyKeys, LinkNames, LinkedType, WirePropertyTypes, CompileTimeMetadata, ObjectOrInterfaceDefinition, SimplePropertyDef, QueryDefinition, QueryMetadata, Osdk, DerivedProperty, PrimaryKeyType, Media, ActionDefinition, ActionMetadata, ActionParam, DataValueClientToWire, ActionEditResponse, ActionValidationResponse } from '@osdk/api';
 import { RowData, Table, Cell, VisibilityState, ColumnOrderState } from '@tanstack/react-table';
+import { ActionValidationError } from '@osdk/client';
 
 /**
  * State for custom filter
@@ -358,6 +359,8 @@ type RenderFilterInput<D> = (props: {
     filterKey: string;
     filterState: FilterState | undefined;
     onFilterStateChanged: (state: FilterState) => void;
+    searchQuery?: string;
+    excludeRowOpen?: boolean;
 }) => React__default.ReactNode;
 interface BaseFilterListProps<D> {
     filterDefinitions?: Array<D>;
@@ -442,14 +445,14 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
     /**
      * Controls how filter visibility (add/remove) is managed.
      *
-     * - `"controlled"` (default): The consumer manages which filters are
-     *   visible via `filterDefinitions`. Filters with `isVisible: false` are
-     *   excluded from the rendered list.
-     * - `"uncontrolled"`: FilterList manages visibility internally. An "Add
-     *   filter" popover is rendered for filters with `isVisible: false`, and
-     *   each visible filter shows a remove button.
+     * - `"uncontrolled"` (default): FilterList manages visibility internally.
+     *   An "Add filter" popover is rendered for filters with `isVisible: false`,
+     *   and each visible filter shows a remove button.
+     * - `"controlled"`: The consumer manages which filters are visible via
+     *   `filterDefinitions`. Filters with `isVisible: false` are excluded from
+     *   the rendered list.
      *
-     * @default "controlled"
+     * @default "uncontrolled"
      */
     addFilterMode?: "controlled" | "uncontrolled";
     /**
@@ -510,8 +513,11 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
     className?: string;
     /**
      * Custom render function for the "Add filter" button.
-     * Only used in controlled mode. In uncontrolled mode, the built-in
-     * AddFilterPopover is rendered automatically.
+     *
+     * - In uncontrolled mode: customizes the trigger element for the built-in
+     *   add-filter popover. The popover behavior is handled automatically.
+     * - In controlled mode: replaces the entire add-filter button area.
+     *   The consumer is responsible for all add-filter behavior.
      */
     renderAddFilterButton?: () => React__default.ReactNode;
 }
@@ -964,4 +970,407 @@ interface PdfRendererProps extends Omit<PdfViewerProps, "src"> {
 }
 declare function PdfRenderer({ media, className, ...pdfViewerProps }: PdfRendererProps): React__default.ReactElement;
 
-export { type AnnotationType, BaseFilterList, type BaseFilterListProps, BasePdfViewer, BaseTable, type BaseTableProps, type CellEditInfo, ColumnConfigDialog, type ColumnConfigDialogProps, type ColumnConfigOptions, type ColumnDefinition, type ColumnDefinitionLocator, type CustomColumnLocator, type FilterComponentType, type FilterDefinitionUnion, FilterList, type FilterListItemProps, type FilterListProps, type FilterState, type FunctionColumnLocator, ObjectTable, type ObjectTableProps, type PdfAnnotation, PdfRenderer, type PdfRendererProps, type PdfViewerProps, type PropertyColumnLocator, type PropertyFilterDefinition, type RdpColumnLocator, type RenderFilterInput, deserializeFilterStates, serializeFilterStates };
+/**
+ * A form field definition specifies configuration for a single field
+ */
+interface FormFieldDefinition<Q extends ActionDefinition<unknown>, K extends FieldKey<Q> = FieldKey<Q>> {
+    /**
+     * The field's unique key
+     */
+    fieldKey: K;
+    /**
+     * Display label for the field
+     * If not provided, the form field will not show any label.
+     */
+    label?: string;
+    /**
+     * Default value of the field
+     */
+    defaultValue?: FieldValueType<Q, K>;
+    /**
+     * The form field component type to render
+     */
+    fieldComponent: ValidFormFieldForPropertyType<FieldDescriptorType<Q, K>>;
+    /**
+     * Whether the field is required
+     */
+    isRequired?: boolean;
+    /**
+     * Placeholder text
+     */
+    placeholder?: string;
+    /**
+     * Additional information to display on this field
+     * The placement of helper text depends on the value of helperTextPlacement prop
+     */
+    helperText?: string;
+    /**
+     * The placement of the helper text either below the field or in a tooltip
+     *
+     * @default "tooltip"
+     */
+    helperTextPlacement?: "bottom" | "tooltip";
+    /**
+     * Whether the field is disabled
+     */
+    isDisabled?: boolean;
+    /**
+     * A callback to return a custom error message if validation failed
+     *
+     * @param validationRule the validation rule that failed with the error message
+     * @returns the error message to display
+     */
+    onValidationError?: (error: ValidationError) => string;
+    /**
+     * Additional function to validate the field
+     *
+     * @param value the current field value
+     * @returns a boolean promise indicating whether the value is valid
+     */
+    validate?: (value: FieldValueType<Q, K>) => Promise<boolean>;
+    /**
+     * The component props for the form field
+     * Excludes runtime props (key, onChange) which are managed by ActionForm
+     */
+    fieldComponentProps?: Omit<FormFieldPropsByType[ValidFormFieldForPropertyType<FieldDescriptorType<Q, K>>], "key" | "onChange">;
+}
+type ValidationError = {
+    type: ValidationRule;
+    error: string;
+};
+type ValidationRule = "required" | "min" | "max" | "minLength" | "maxLength" | "pattern" | "validate";
+/**
+ * Maps field types to their corresponding props
+ */
+interface FormFieldPropsByType {
+    DATETIME_PICKER: DatetimePickerFieldProps;
+    DROPDOWN: DropdownFieldProps<unknown, boolean>;
+    FILE_PICKER: FilePickerProps;
+    NUMBER_INPUT: NumberInputFieldProps;
+    OBJECT_SET: ObjectSetFieldProps<ObjectTypeDefinition>;
+    RADIO_BUTTONS: RadioButtonsFieldProps<unknown>;
+    TEXT_AREA: TextAreaFieldProps;
+    TEXT_INPUT: TextInputFieldProps;
+    CUSTOM: CustomFieldProps<unknown>;
+}
+/**
+ * Datetime picker field props
+ */
+interface DatetimePickerFieldProps extends BaseFormFieldProps<Date> {
+    /**
+     * 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
+     */
+    max?: Date;
+    /**
+     * Whether to show time picker
+     */
+    showTime?: boolean;
+    /**
+     * Function to format the date string
+     */
+    formatDate?: (date: Date) => string;
+}
+/**
+ * Dropdown field props with selectable items
+ */
+interface DropdownFieldProps<V, Multiple extends boolean = false> extends BaseFormFieldProps<Multiple extends true ? V[] : V> {
+    /**
+     * Available items for the dropdown
+     */
+    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.
+     * 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
+     */
+    isMultiple?: Multiple;
+}
+interface FilePickerProps extends BaseFormFieldProps<File | File[]> {
+    /**
+     * Whether multiple files can be selected
+     */
+    isMulti?: boolean;
+    /**
+     * Accepted file types (e.g., "image/*", ".pdf")
+     */
+    accept?: string | string[];
+    /**
+     * Maximum file size in bytes
+     */
+    maxSize?: number;
+}
+/**
+ * Text area field props
+ */
+interface TextAreaFieldProps extends BaseFormFieldProps<string>, Pick<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows" | "wrap"
+/**
+ * If provided, this will be added to the field validation
+ */
+ | "minLength"
+/**
+ * If provided, this will be added to the field validation
+ */
+ | "maxLength"> {
+}
+interface TextInputFieldProps extends BaseFormFieldProps<string>, Pick<React__default.InputHTMLAttributes<HTMLInputElement>, 
+/**
+ * If provided, this will be added to the field validation
+ */
+"minLength"
+/**
+ * If provided, this will be added to the field validation
+ */
+ | "maxLength"> {
+    placeholder?: string;
+}
+/**
+ * Number input field props
+ */
+interface NumberInputFieldProps extends BaseFormFieldProps<number>, Pick<React__default.InputHTMLAttributes<HTMLInputElement>, 
+/**
+ * If provided, this will be added to the field validation
+ */
+"min"
+/**
+ * If provided, this will be added to the field validation
+ */
+ | "max" | "step"> {
+}
+/**
+ * Radio buttons field props
+ */
+interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {
+    /**
+     * Available options for radio buttons
+     */
+    options: Option<V>[];
+}
+/**
+ * Option interface for radio button options
+ */
+interface Option<V> {
+    label: string;
+    value: V;
+}
+/**
+ * Object set field displays the summary of the count of the given object set
+ */
+interface ObjectSetFieldProps<T extends ObjectTypeDefinition> extends BaseFormFieldProps<ObjectSet<T>> {
+}
+/**
+ * Custom field props for user-defined renderers
+ */
+interface CustomFieldProps<V> extends BaseFormFieldProps<V> {
+    /**
+     * Custom renderer function
+     */
+    customRenderer: (props: BaseFormFieldProps<V>) => React__default.ReactNode;
+}
+interface BaseFormFieldProps<V> {
+    /**
+     * The value of the form field
+     */
+    value: V | null;
+    /**
+     * Called when the field value changes.
+     *
+     * ActionForm internally wraps this to pass the key to `onFieldValueChange`:
+     * ```
+     * <DropdownField
+     *   {...fieldDef}
+     *   onChange={(value) => onFieldValueChange(fieldDef.key, value)}
+     * />
+     * ```
+     *
+     * @param value The new value of the form field
+     */
+    onChange?: (value: V | null) => void;
+}
+type FieldKey<Q extends ActionDefinition<unknown>> = keyof ActionParameters<Q>;
+/**
+ * Extracts parameters from an ActionDefinition
+ */
+type ActionParameters<Q extends ActionDefinition<unknown>> = CompileTimeMetadata<Q>["parameters"];
+/**
+ * Extracts the value type for a specific parameter
+ *
+ * TODO: Re-use `BaseType`
+ */
+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.
+ */
+type FieldDescriptorType<Q extends ActionDefinition<unknown> = ActionDefinition<unknown>, K extends keyof ActionParameters<Q> = keyof ActionParameters<Q>> = ActionParameters<Q>[K]["type"];
+/**
+ * Available form field component types
+ */
+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.
+ */
+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.
+ */
+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
+ */
+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;
+
+/**
+ * Props for the ActionForm component.
+ *
+ * A discriminated union ensures that controlled mode (formState provided)
+ * always requires onFormStateChange, and uncontrolled mode makes `onFormStateChange` optional
+ */
+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, field definitions are constructed from `ActionParameters`.
+     */
+    formFieldDefinitions?: ReadonlyArray<FormFieldDefinition<Q>>;
+    /**
+     * If supplied, this will override the default submit action
+     * 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
+     * @returns a promise of the submission response
+     */
+    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
+     *
+     * @param results the validation response
+     */
+    onValidationResponse?: (results: ActionValidationResponse) => void;
+    /**
+     * Called when the action is successfully executed from a non-validateOnly submission
+     *
+     * @param results the submission response
+     */
+    onSuccess?: (results: ActionEditResponse | undefined) => void;
+    /**
+     * Called when there is an error in form submission
+     *
+     * @param error the error that occurred
+     */
+    onError?: (error: FormError) => void;
+}
+/**
+ * Form values mapping parameter names to their values
+ */
+type FormState<Q extends ActionDefinition<unknown>> = {
+    [K in FieldKey<Q>]?: FieldValueType<Q, K>;
+};
+/**
+ * Form error discriminated union
+ */
+type FormError = {
+    type: "validation";
+    error: ActionValidationError;
+} | {
+    type: "submission";
+    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.
+ */
+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;
+}
+
+declare const ActionForm: <Q extends ActionDefinition<unknown>>(props: ActionFormProps<Q>) => React__default.ReactElement;
+
+declare const BaseForm: React__default.FC<BaseFormProps>;
+
+export { ActionForm, type ActionFormProps, type ActionParameters, type AnnotationType, BaseFilterList, type BaseFilterListProps, BaseForm, type BaseFormFieldProps, type BaseFormProps, BasePdfViewer, BaseTable, type BaseTableProps, type CellEditInfo, ColumnConfigDialog, type ColumnConfigDialogProps, type ColumnConfigOptions, type ColumnDefinition, type ColumnDefinitionLocator, type CustomColumnLocator, type CustomFieldProps, type DatetimePickerFieldProps, type DropdownFieldProps, type FieldComponent, type FieldValueType, type FilePickerProps, type FilterComponentType, type FilterDefinitionUnion, FilterList, type FilterListItemProps, type FilterListProps, type FilterState, type FormError, type FormFieldDefinition, type FormFieldPropsByType, type FormState, type FunctionColumnLocator, type NumberInputFieldProps, type ObjectSetFieldProps, ObjectTable, type ObjectTableProps, type Option, type PdfAnnotation, PdfRenderer, type PdfRendererProps, type PdfViewerProps, type PropertyColumnLocator, type PropertyFilterDefinition, type RadioButtonsFieldProps, type RdpColumnLocator, type RenderFilterInput, type RendererFieldDefinition, type TextAreaFieldProps, type TextInputFieldProps, deserializeFilterStates, serializeFilterStates };

package/build/esm/action-form/ActionFormApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionFormApi.js","names":[],"sources":["ActionFormApi.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionEditResponse,\n  ActionValidationResponse,\n} from \"@osdk/api\";\nimport type { ActionValidationError } from \"@osdk/client\";\nimport type {\n  ActionParameters,\n  FieldKey,\n  FieldValueType,\n  FormFieldDefinition,\n  RendererFieldDefinition,\n} from \"./FormFieldApi.js\";\n\n/**\n * Props for the ActionForm component.\n *\n * A discriminated union ensures that controlled mode (formState provided)\n * always requires onFormStateChange, and uncontrolled mode makes `onFormStateChange` optional\n */\nexport type ActionFormProps<Q extends ActionDefinition<unknown>> =\n  | (ActionFormConfigProps<Q> & {\n    formState: FormState<Q>;\n    onFormStateChange: (\n      updater: (prevState: FormState<Q>) => FormState<Q>,\n    ) => void;\n  })\n  | (ActionFormConfigProps<Q> & {\n    formState?: undefined;\n    onFormStateChange?: (\n      updater: (prevState: FormState<Q>) => FormState<Q>,\n    ) => void;\n  });\n\ninterface ActionFormConfigProps<Q extends ActionDefinition<unknown>>\n  extends Pick<BaseFormProps, \"formTitle\" | \"isSubmitDisabled\">\n{\n  actionDefinition: Q;\n\n  /**\n   * If not supplied, field definitions are constructed from `ActionParameters`.\n   */\n  formFieldDefinitions?: ReadonlyArray<FormFieldDefinition<Q>>;\n\n  /**\n   * If supplied, this will override the default submit action\n   * By default, the action's applyAction will be called\n   *\n   * @param formState all field values when onSubmit is called\n   * @param applyAction the function to execute the action\n   * @returns a promise of the submission response\n   */\n  onSubmit?: (\n    formState: FormState<Q>,\n    applyAction: (\n      args: ActionParameters<Q>,\n    ) => Promise<ActionEditResponse | undefined>,\n  ) => Promise<unknown> | void;\n\n  /**\n   * Called when the validation response is returned from a validateOnly submission\n   *\n   * @param results the validation response\n   */\n  onValidationResponse?: (results: ActionValidationResponse) => void;\n\n  /**\n   * Called when the action is successfully executed from a non-validateOnly submission\n   *\n   * @param results the submission response\n   */\n  onSuccess?: (results: ActionEditResponse | undefined) => void;\n\n  /**\n   * Called when there is an error in form submission\n   *\n   * @param error the error that occurred\n   */\n  onError?: (error: FormError) => void;\n}\n\n/**\n * Form values mapping parameter names to their values\n */\nexport type FormState<Q extends ActionDefinition<unknown>> = {\n  [K in FieldKey<Q>]?: FieldValueType<Q, K>;\n};\n\n/**\n * Form error discriminated union\n */\nexport type FormError =\n  | { type: \"validation\"; error: ActionValidationError }\n  | { type: \"submission\"; error: unknown }\n  | { type: \"unknown\"; error: unknown };\n\n/**\n * Props for the `BaseForm` component, which renders a form without\n * OSDK data fetching.\n *\n * Uses a discriminated union so that controlled mode (`formState` provided)\n * always requires `onFieldValueChange`, and uncontrolled mode omits both.\n * `onSubmit` receives the current form state so callers can access values\n * even in uncontrolled mode.\n */\nexport type BaseFormProps =\n  & BaseFormCommonProps\n  & (\n    | {\n      formState: Record<string, unknown>;\n      onFieldValueChange: (fieldKey: string, value: unknown) => void;\n    }\n    | {\n      formState?: undefined;\n      onFieldValueChange?: (fieldKey: string, value: unknown) => void;\n    }\n  );\n\ninterface BaseFormCommonProps {\n  formTitle?: string;\n  fieldDefinitions: ReadonlyArray<RendererFieldDefinition>;\n  onSubmit: (formState: Record<string, unknown>) => void;\n  isSubmitDisabled?: boolean;\n  isPending?: boolean;\n  isLoading?: boolean;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ActionFormApi.js","names":[],"sources":["ActionFormApi.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ActionDefinition,\n  ActionEditResponse,\n  ActionValidationResponse,\n} from \"@osdk/api\";\nimport type { ActionValidationError } from \"@osdk/client\";\nimport type {\n  ActionParameters,\n  FieldKey,\n  FieldValueType,\n  FormFieldDefinition,\n  RendererFieldDefinition,\n} from \"./FormFieldApi.js\";\n\n/**\n * Props for the ActionForm component.\n *\n * A discriminated union ensures that controlled mode (formState provided)\n * always requires onFormStateChange, and uncontrolled mode makes `onFormStateChange` optional\n */\nexport type ActionFormProps<Q extends ActionDefinition<unknown>> =\n  | (ActionFormConfigProps<Q> & {\n    formState: FormState<Q>;\n    onFormStateChange: (\n      updater: (prevState: FormState<Q>) => FormState<Q>,\n    ) => void;\n  })\n  | (ActionFormConfigProps<Q> & {\n    formState?: undefined;\n    onFormStateChange?: (\n      updater: (prevState: FormState<Q>) => FormState<Q>,\n    ) => void;\n  });\n\ninterface ActionFormConfigProps<Q extends ActionDefinition<unknown>>\n  extends Pick<BaseFormProps, \"formTitle\" | \"isSubmitDisabled\">\n{\n  actionDefinition: Q;\n\n  /**\n   * If not supplied, field definitions are constructed from `ActionParameters`.\n   */\n  formFieldDefinitions?: ReadonlyArray<FormFieldDefinition<Q>>;\n\n  /**\n   * If supplied, this will override the default submit action\n   * By default, the action's applyAction will be called\n   *\n   * @param formState all field values when onSubmit is called\n   * @param applyAction the function to execute the action\n   * @returns a promise of the submission response\n   */\n  onSubmit?: (\n    formState: FormState<Q>,\n    applyAction: (\n      args: ActionParameters<Q>,\n    ) => Promise<ActionEditResponse | undefined>,\n  ) => Promise<unknown> | void;\n\n  /**\n   * Called when the validation response is returned from a validateOnly submission\n   *\n   * @param results the validation response\n   */\n  onValidationResponse?: (results: ActionValidationResponse) => void;\n\n  /**\n   * Called when the action is successfully executed from a non-validateOnly submission\n   *\n   * @param results the submission response\n   */\n  onSuccess?: (results: ActionEditResponse | undefined) => void;\n\n  /**\n   * Called when there is an error in form submission\n   *\n   * @param error the error that occurred\n   */\n  onError?: (error: FormError) => void;\n}\n\n/**\n * Form values mapping parameter names to their values\n */\nexport type FormState<Q extends ActionDefinition<unknown>> = {\n  [K in FieldKey<Q>]?: FieldValueType<Q, K>;\n};\n\n/**\n * Form error discriminated union\n */\nexport type FormError =\n  | { type: \"validation\"; error: ActionValidationError }\n  | { type: \"submission\"; error: unknown }\n  | { type: \"unknown\"; error: unknown };\n\n/**\n * Props for the `BaseForm` component, which renders a form without\n * OSDK data fetching.\n *\n * Uses a discriminated union so that controlled mode (`formState` provided)\n * always requires `onFieldValueChange`, and uncontrolled mode omits both.\n * `onSubmit` receives the current form state so callers can access values\n * even in uncontrolled mode.\n */\nexport type BaseFormProps =\n  & BaseFormCommonProps\n  & (\n    | {\n      formState: Record<string, unknown>;\n      onFieldValueChange: (fieldKey: string, value: unknown) => void;\n    }\n    | {\n      formState?: undefined;\n      onFieldValueChange?: (fieldKey: string, value: unknown) => void;\n    }\n  );\n\ninterface BaseFormCommonProps {\n  formTitle?: string;\n  fieldDefinitions: ReadonlyArray<RendererFieldDefinition>;\n  onSubmit: (formState: Record<string, unknown>) => void;\n  isSubmitDisabled?: boolean;\n  isPending?: boolean;\n  isLoading?: boolean;\n  className?: string;\n}\n"],"mappings":"","ignoreList":[]}

package/build/esm/action-form/BaseForm.js

@@ -14,9 +14,13 @@
  * limitations under the License.
  */
 
+import classNames from "classnames";
 import React, { memo, useCallback, useMemo } from "react";
 import { useForm } from "react-hook-form";
+import { ActionButton } from "../base-components/action-button/ActionButton.js";
+import styles from "./BaseForm.module.css";
 import { FieldBridge } from "./fields/FieldBridge.js";
+import { FormHeader } from "./FormHeader.js";
 export const BaseForm = /*#__PURE__*/memo(function ({
   formTitle,
   fieldDefinitions,
@@ -25,7 +29,8 @@ export const BaseForm = /*#__PURE__*/memo(function ({
   onSubmit,
   isSubmitDisabled = false,
   isPending = false,
-  isLoading = false
+  isLoading = false,
+  className
 }) {
   const defaultValues = useMemo(() => buildDefaultValues(fieldDefinitions), [fieldDefinitions]);
   const {
@@ -47,18 +52,26 @@ export const BaseForm = /*#__PURE__*/memo(function ({
     onSubmit(controlledFormState ?? rhfValues);
   }, [onSubmit, controlledFormState]);
   return /*#__PURE__*/React.createElement("form", {
+    className: classNames(styles.osdkForm, className),
     onSubmit: rhfHandleSubmit(onFormSubmit)
-  }, formTitle != null && /*#__PURE__*/React.createElement("h2", null, formTitle), isLoading && fieldDefinitions.length === 0 && /*#__PURE__*/React.createElement("div", {
+  }, formTitle != null && /*#__PURE__*/React.createElement(FormHeader, {
+    title: formTitle
+  }), isLoading && fieldDefinitions.length === 0 && /*#__PURE__*/React.createElement("div", {
     role: "status"
-  }, "Loading form fields..."), fieldDefinitions.map(fieldDef => /*#__PURE__*/React.createElement(FieldBridge, {
+  }, "Loading form fields..."), /*#__PURE__*/React.createElement("div", {
+    className: styles.osdkFormFields
+  }, fieldDefinitions.map(fieldDef => /*#__PURE__*/React.createElement(FieldBridge, {
     key: fieldDef.fieldKey,
     fieldDef: fieldDef,
     control: control,
     onExternalChange: onFieldValueChange
-  })), /*#__PURE__*/React.createElement("button", {
+  }))), /*#__PURE__*/React.createElement("div", {
+    className: styles.osdkFormFooter
+  }, /*#__PURE__*/React.createElement(ActionButton, {
     type: "submit",
+    variant: "primary",
     disabled: isSubmitDisabled || isPending
-  }, isPending ? "Submitting..." : "Submit"));
+  }, isPending ? "Submitting…" : "Submit")));
 });
 function buildDefaultValues(fieldDefinitions) {
   const values = {};

package/build/esm/action-form/BaseForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseForm.js","names":["React","memo","useCallback","useMemo","useForm","FieldBridge","BaseForm","formTitle","fieldDefinitions","formState","controlledFormState","onFieldValueChange","onSubmit","isSubmitDisabled","isPending","isLoading","defaultValues","buildDefaultValues","control","handleSubmit","rhfHandleSubmit","values","onFormSubmit","rhfValues","createElement","length","role","map","fieldDef","key","fieldKey","onExternalChange","type","disabled","def","defaultValue"],"sources":["BaseForm.tsx"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { memo, useCallback, useMemo } from \"react\";\nimport { useForm } from \"react-hook-form\";\nimport type { BaseFormProps } from \"./ActionFormApi.js\";\nimport { FieldBridge } from \"./fields/FieldBridge.js\";\nimport type { RendererFieldDefinition } from \"./FormFieldApi.js\";\n\nexport const BaseForm: React.FC<BaseFormProps> = memo(function BaseFormFn({\n  formTitle,\n  fieldDefinitions,\n  formState: controlledFormState,\n  onFieldValueChange,\n  onSubmit,\n  isSubmitDisabled = false,\n  isPending = false,\n  isLoading = false,\n}: BaseFormProps): React.ReactElement {\n  const isControlled = controlledFormState != null;\n\n  const defaultValues = useMemo(\n    () => buildDefaultValues(fieldDefinitions),\n    [fieldDefinitions],\n  );\n\n  const { control, handleSubmit: rhfHandleSubmit } = useForm<\n    Record<string, unknown>\n  >({\n    ...(isControlled ? { values: controlledFormState } : { defaultValues }),\n  });\n\n  const onFormSubmit = useCallback(\n    (rhfValues: Record<string, unknown>) => {\n      // In controlled mode, always submit the controlled state, not RHF's\n      // internal state. Between a user keystroke and the parent re-rendering,\n      // RHF's store may hold the user-typed value rather than the parent's\n      // value. Using controlledFormState directly preserves the existing\n      // guarantee that controlled mode submits the parent's state.\n      onSubmit(controlledFormState ?? rhfValues);\n    },\n    [onSubmit, controlledFormState],\n  );\n\n  return (\n    <form onSubmit={rhfHandleSubmit(onFormSubmit)}>\n      {formTitle != null && <h2>{formTitle}</h2>}\n      {isLoading && fieldDefinitions.length === 0 && (\n        <div role=\"status\">Loading form fields...</div>\n      )}\n      {fieldDefinitions.map((fieldDef) => (\n        <FieldBridge\n          key={fieldDef.fieldKey}\n          fieldDef={fieldDef}\n          control={control}\n          onExternalChange={onFieldValueChange}\n        />\n      ))}\n      <button\n        type=\"submit\"\n        disabled={isSubmitDisabled || isPending}\n      >\n        {isPending ? \"Submitting...\" : \"Submit\"}\n      </button>\n    </form>\n  );\n});\n\nfunction buildDefaultValues(\n  fieldDefinitions: ReadonlyArray<RendererFieldDefinition>,\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {};\n  for (const def of fieldDefinitions) {\n    values[def.fieldKey] = def.defaultValue;\n  }\n  return values;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,IAAI,EAAEC,WAAW,EAAEC,OAAO,QAAQ,OAAO;AACzD,SAASC,OAAO,QAAQ,iBAAiB;AAEzC,SAASC,WAAW,QAAQ,yBAAyB;AAGrD,OAAO,MAAMC,QAAiC,gBAAGL,IAAI,CAAC,UAAoB;EACxEM,SAAS;EACTC,gBAAgB;EAChBC,SAAS,EAAEC,mBAAmB;EAC9BC,kBAAkB;EAClBC,QAAQ;EACRC,gBAAgB,GAAG,KAAK;EACxBC,SAAS,GAAG,KAAK;EACjBC,SAAS,GAAG;AACC,CAAC,EAAsB;EAGpC,MAAMC,aAAa,GAAGb,OAAO,CAC3B,MAAMc,kBAAkB,CAACT,gBAAgB,CAAC,EAC1C,CAACA,gBAAgB,CACnB,CAAC;EAED,MAAM;IAAEU,OAAO;IAAEC,YAAY,EAAEC;EAAgB,CAAC,GAAGhB,OAAO,CAExD;IACA,IAVmBM,mBAAmB,IAAI,IAAI,GAU3B;MAAEW,MAAM,EAAEX;IAAoB,CAAC,GAAG;MAAEM;IAAc,CAAC;EACxE,CAAC,CAAC;EAEF,MAAMM,YAAY,GAAGpB,WAAW,CAC7BqB,SAAkC,IAAK;IACtC;IACA;IACA;IACA;IACA;IACAX,QAAQ,CAACF,mBAAmB,IAAIa,SAAS,CAAC;EAC5C,CAAC,EACD,CAACX,QAAQ,EAAEF,mBAAmB,CAChC,CAAC;EAED,oBACEV,KAAA,CAAAwB,aAAA;IAAMZ,QAAQ,EAAEQ,eAAe,CAACE,YAAY;EAAE,GAC3Cf,SAAS,IAAI,IAAI,iBAAIP,KAAA,CAAAwB,aAAA,aAAKjB,SAAc,CAAC,EACzCQ,SAAS,IAAIP,gBAAgB,CAACiB,MAAM,KAAK,CAAC,iBACzCzB,KAAA,CAAAwB,aAAA;IAAKE,IAAI,EAAC;EAAQ,GAAC,wBAA2B,CAC/C,EACAlB,gBAAgB,CAACmB,GAAG,CAAEC,QAAQ,iBAC7B5B,KAAA,CAAAwB,aAAA,CAACnB,WAAW;IACVwB,GAAG,EAAED,QAAQ,CAACE,QAAS;IACvBF,QAAQ,EAAEA,QAAS;IACnBV,OAAO,EAAEA,OAAQ;IACjBa,gBAAgB,EAAEpB;EAAmB,CACtC,CACF,CAAC,eACFX,KAAA,CAAAwB,aAAA;IACEQ,IAAI,EAAC,QAAQ;IACbC,QAAQ,EAAEpB,gBAAgB,IAAIC;EAAU,GAEvCA,SAAS,GAAG,eAAe,GAAG,QACzB,CACJ,CAAC;AAEX,CAAC,CAAC;AAEF,SAASG,kBAAkBA,CACzBT,gBAAwD,EAC/B;EACzB,MAAMa,MAA+B,GAAG,CAAC,CAAC;EAC1C,KAAK,MAAMa,GAAG,IAAI1B,gBAAgB,EAAE;IAClCa,MAAM,CAACa,GAAG,CAACJ,QAAQ,CAAC,GAAGI,GAAG,CAACC,YAAY;EACzC;EACA,OAAOd,MAAM;AACf","ignoreList":[]}
+{"version":3,"file":"BaseForm.js","names":["classNames","React","memo","useCallback","useMemo","useForm","ActionButton","styles","FieldBridge","FormHeader","BaseForm","formTitle","fieldDefinitions","formState","controlledFormState","onFieldValueChange","onSubmit","isSubmitDisabled","isPending","isLoading","className","defaultValues","buildDefaultValues","control","handleSubmit","rhfHandleSubmit","values","onFormSubmit","rhfValues","createElement","osdkForm","title","length","role","osdkFormFields","map","fieldDef","key","fieldKey","onExternalChange","osdkFormFooter","type","variant","disabled","def","defaultValue"],"sources":["BaseForm.tsx"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport classNames from \"classnames\";\nimport React, { memo, useCallback, useMemo } from \"react\";\nimport { useForm } from \"react-hook-form\";\nimport { ActionButton } from \"../base-components/action-button/ActionButton.js\";\nimport type { BaseFormProps } from \"./ActionFormApi.js\";\nimport styles from \"./BaseForm.module.css\";\nimport { FieldBridge } from \"./fields/FieldBridge.js\";\nimport type { RendererFieldDefinition } from \"./FormFieldApi.js\";\nimport { FormHeader } from \"./FormHeader.js\";\n\nexport const BaseForm: React.FC<BaseFormProps> = memo(function BaseFormFn({\n  formTitle,\n  fieldDefinitions,\n  formState: controlledFormState,\n  onFieldValueChange,\n  onSubmit,\n  isSubmitDisabled = false,\n  isPending = false,\n  isLoading = false,\n  className,\n}: BaseFormProps): React.ReactElement {\n  const isControlled = controlledFormState != null;\n\n  const defaultValues = useMemo(\n    () => buildDefaultValues(fieldDefinitions),\n    [fieldDefinitions],\n  );\n\n  const { control, handleSubmit: rhfHandleSubmit } = useForm<\n    Record<string, unknown>\n  >({\n    ...(isControlled ? { values: controlledFormState } : { defaultValues }),\n  });\n\n  const onFormSubmit = useCallback(\n    (rhfValues: Record<string, unknown>) => {\n      // In controlled mode, always submit the controlled state, not RHF's\n      // internal state. Between a user keystroke and the parent re-rendering,\n      // RHF's store may hold the user-typed value rather than the parent's\n      // value. Using controlledFormState directly preserves the existing\n      // guarantee that controlled mode submits the parent's state.\n      onSubmit(controlledFormState ?? rhfValues);\n    },\n    [onSubmit, controlledFormState],\n  );\n\n  return (\n    <form\n      className={classNames(styles.osdkForm, className)}\n      onSubmit={rhfHandleSubmit(onFormSubmit)}\n    >\n      {formTitle != null && <FormHeader title={formTitle} />}\n      {isLoading && fieldDefinitions.length === 0 && (\n        <div role=\"status\">Loading form fields...</div>\n      )}\n      <div className={styles.osdkFormFields}>\n        {fieldDefinitions.map((fieldDef) => (\n          <FieldBridge\n            key={fieldDef.fieldKey}\n            fieldDef={fieldDef}\n            control={control}\n            onExternalChange={onFieldValueChange}\n          />\n        ))}\n      </div>\n      <div className={styles.osdkFormFooter}>\n        <ActionButton\n          type=\"submit\"\n          variant=\"primary\"\n          disabled={isSubmitDisabled || isPending}\n        >\n          {isPending ? \"Submitting…\" : \"Submit\"}\n        </ActionButton>\n      </div>\n    </form>\n  );\n});\n\nfunction buildDefaultValues(\n  fieldDefinitions: ReadonlyArray<RendererFieldDefinition>,\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {};\n  for (const def of fieldDefinitions) {\n    values[def.fieldKey] = def.defaultValue;\n  }\n  return values;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,UAAU,MAAM,YAAY;AACnC,OAAOC,KAAK,IAAIC,IAAI,EAAEC,WAAW,EAAEC,OAAO,QAAQ,OAAO;AACzD,SAASC,OAAO,QAAQ,iBAAiB;AACzC,SAASC,YAAY,QAAQ,kDAAkD;AAE/E,OAAOC,MAAM,MAAM,uBAAuB;AAC1C,SAASC,WAAW,QAAQ,yBAAyB;AAErD,SAASC,UAAU,QAAQ,iBAAiB;AAE5C,OAAO,MAAMC,QAAiC,gBAAGR,IAAI,CAAC,UAAoB;EACxES,SAAS;EACTC,gBAAgB;EAChBC,SAAS,EAAEC,mBAAmB;EAC9BC,kBAAkB;EAClBC,QAAQ;EACRC,gBAAgB,GAAG,KAAK;EACxBC,SAAS,GAAG,KAAK;EACjBC,SAAS,GAAG,KAAK;EACjBC;AACa,CAAC,EAAsB;EAGpC,MAAMC,aAAa,GAAGjB,OAAO,CAC3B,MAAMkB,kBAAkB,CAACV,gBAAgB,CAAC,EAC1C,CAACA,gBAAgB,CACnB,CAAC;EAED,MAAM;IAAEW,OAAO;IAAEC,YAAY,EAAEC;EAAgB,CAAC,GAAGpB,OAAO,CAExD;IACA,IAVmBS,mBAAmB,IAAI,IAAI,GAU3B;MAAEY,MAAM,EAAEZ;IAAoB,CAAC,GAAG;MAAEO;IAAc,CAAC;EACxE,CAAC,CAAC;EAEF,MAAMM,YAAY,GAAGxB,WAAW,CAC7ByB,SAAkC,IAAK;IACtC;IACA;IACA;IACA;IACA;IACAZ,QAAQ,CAACF,mBAAmB,IAAIc,SAAS,CAAC;EAC5C,CAAC,EACD,CAACZ,QAAQ,EAAEF,mBAAmB,CAChC,CAAC;EAED,oBACEb,KAAA,CAAA4B,aAAA;IACET,SAAS,EAAEpB,UAAU,CAACO,MAAM,CAACuB,QAAQ,EAAEV,SAAS,CAAE;IAClDJ,QAAQ,EAAES,eAAe,CAACE,YAAY;EAAE,GAEvChB,SAAS,IAAI,IAAI,iBAAIV,KAAA,CAAA4B,aAAA,CAACpB,UAAU;IAACsB,KAAK,EAAEpB;EAAU,CAAE,CAAC,EACrDQ,SAAS,IAAIP,gBAAgB,CAACoB,MAAM,KAAK,CAAC,iBACzC/B,KAAA,CAAA4B,aAAA;IAAKI,IAAI,EAAC;EAAQ,GAAC,wBAA2B,CAC/C,eACDhC,KAAA,CAAA4B,aAAA;IAAKT,SAAS,EAAEb,MAAM,CAAC2B;EAAe,GACnCtB,gBAAgB,CAACuB,GAAG,CAAEC,QAAQ,iBAC7BnC,KAAA,CAAA4B,aAAA,CAACrB,WAAW;IACV6B,GAAG,EAAED,QAAQ,CAACE,QAAS;IACvBF,QAAQ,EAAEA,QAAS;IACnBb,OAAO,EAAEA,OAAQ;IACjBgB,gBAAgB,EAAExB;EAAmB,CACtC,CACF,CACE,CAAC,eACNd,KAAA,CAAA4B,aAAA;IAAKT,SAAS,EAAEb,MAAM,CAACiC;EAAe,gBACpCvC,KAAA,CAAA4B,aAAA,CAACvB,YAAY;IACXmC,IAAI,EAAC,QAAQ;IACbC,OAAO,EAAC,SAAS;IACjBC,QAAQ,EAAE1B,gBAAgB,IAAIC;EAAU,GAEvCA,SAAS,GAAG,aAAa,GAAG,QACjB,CACX,CACD,CAAC;AAEX,CAAC,CAAC;AAEF,SAASI,kBAAkBA,CACzBV,gBAAwD,EAC/B;EACzB,MAAMc,MAA+B,GAAG,CAAC,CAAC;EAC1C,KAAK,MAAMkB,GAAG,IAAIhC,gBAAgB,EAAE;IAClCc,MAAM,CAACkB,GAAG,CAACN,QAAQ,CAAC,GAAGM,GAAG,CAACC,YAAY;EACzC;EACA,OAAOnB,MAAM;AACf","ignoreList":[]}

package/build/esm/action-form/BaseForm.module.css

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+.osdkForm {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+}
+
+.osdkFormFields {
+  display: flex;
+  flex-direction: column;
+  gap: var(--osdk-form-field-gap);
+  padding: var(--osdk-form-content-padding);
+}
+
+.osdkFormFooter {
+  display: flex;
+  flex-direction: row;
+  justify-content: flex-end;
+  border-top: var(--osdk-surface-border-width) solid
+    var(--osdk-form-footer-border-color);
+  padding-block: var(--osdk-form-content-padding);
+  padding-inline: var(--osdk-form-content-padding);
+}

package/build/esm/action-form/FormField.js

@@ -0,0 +1,42 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React, { memo } from "react";
+import styles from "./FormField.module.css";
+export const FormField = /*#__PURE__*/memo(function ({
+  fieldKey,
+  label,
+  isRequired,
+  helperText,
+  error,
+  children
+}) {
+  return /*#__PURE__*/React.createElement("div", {
+    className: styles.osdkFormField
+  }, label != null && /*#__PURE__*/React.createElement("label", {
+    className: styles.osdkFormFieldLabel,
+    htmlFor: fieldKey
+  }, label, isRequired === true && /*#__PURE__*/React.createElement("span", {
+    className: styles.osdkFormFieldRequired,
+    "aria-label": "required"
+  }, " ", "*")), children, error != null && /*#__PURE__*/React.createElement("div", {
+    className: styles.osdkFormFieldError,
+    role: "alert"
+  }, error), helperText != null && /*#__PURE__*/React.createElement("div", {
+    className: styles.osdkFormFieldHelperText
+  }, helperText));
+});
+//# sourceMappingURL=FormField.js.map