@osdk/react-components 0.2.0-beta.16 → 0.2.0-beta.18

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

@@ -513,11 +513,11 @@ interface CellIdentifier {
     columnId: string;
 }
 interface CellEditInfo<TData extends RowData = unknown, CellValue = unknown> extends CellIdentifier {
-    newValue: CellValue;
-    oldValue: CellValue;
+    newValue: CellValue | null;
+    oldValue: CellValue | null;
     originalRowData: TData;
 }
-type EditMode = {
+type EditModeState = {
     type: "always";
     isActive: true;
 } | {
@@ -530,7 +530,10 @@ interface EditableConfig<TData extends RowData = unknown, CellValue = unknown> {
     onCellEdit: (cellId: string, info: CellEditInfo<TData, CellValue>) => void;
     onSubmitEdits?: () => Promise<boolean>;
     clearEdits: () => void;
-    editMode: EditMode;
+    editModeState: EditModeState;
+    onCellValidationError: (cellId: string, error: string) => void;
+    validationErrors: Map<string, string>;
+    clearCellValidationError: (cellId: string) => void;
 }
 
 type ColumnDefinition<Q extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = Record<string, never>, FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<string, never>> = {
@@ -550,6 +553,13 @@ type ColumnDefinition<Q extends ObjectOrInterfaceDefinition, RDPs extends Record
     orderable?: boolean;
     filterable?: boolean;
     editable?: boolean;
+    /**
+     * Additional function to validate the cell value during edit
+     *
+     * @param value the current cell value
+     * @returns a promise that resolves to an error message string if validation fails, or undefined if validation succeeds
+     */
+    validateEdit?: (value: unknown) => Promise<string | undefined>;
     renderCell?: (object: Osdk.Instance<Q, "$allBaseProperties", PropertyKeys<Q>, RDPs>, locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>) => React.ReactNode;
     /**
      * If provided, this will be used in the column header.
@@ -812,11 +822,15 @@ declare module "@tanstack/react-table" {
         isVisible?: boolean;
         editable?: boolean;
         dataType?: string;
+        validateEdit?: (value: unknown) => Promise<string | undefined>;
     }
     interface TableMeta<TData extends RowData = unknown> {
         onCellEdit?: (cellId: string, info: CellEditInfo<TData, unknown>) => void;
+        onCellValidationError?: (cellId: string, error: string) => void;
+        clearCellValidationError?: (cellId: string) => void;
         cellEdits?: Record<string, CellEditInfo<TData, unknown>>;
         isInEditMode?: boolean;
+        validationErrors?: Map<string, string>;
     }
 }
 interface BaseTableProps<TData extends RowData> {

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

@@ -0,0 +1,109 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+/*
+ * 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 { useOsdkMetadata } from "@osdk/react";
+import { useOsdkAction } from "@osdk/react/experimental";
+import React, { useCallback, useEffect, useMemo } from "react";
+import { typedReactMemo } from "../shared/typedMemo.js";
+import { BaseForm } from "./BaseForm.js";
+import { coerceFieldValue } from "./utils/coerceFieldValue.js";
+import { getDefaultFieldDefinitions } from "./utils/getDefaultFieldDefinitions.js";
+const EMPTY_FIELD_DEFINITIONS = [];
+export const ActionForm = typedReactMemo(function ({
+  actionDefinition,
+  formTitle,
+  formFieldDefinitions,
+  formState: controlledFormState,
+  onFormStateChange,
+  isSubmitDisabled,
+  onSubmit,
+  onValidationResponse: _onValidationResponse,
+  onSuccess,
+  onError
+}) {
+  const {
+    applyAction: osdkApplyAction,
+    isPending
+  } = useOsdkAction(actionDefinition);
+  const {
+    metadata,
+    loading: metadataLoading,
+    error: metadataError
+  } = useOsdkMetadata(actionDefinition);
+  useEffect(function () {
+    if (metadataError != null) {
+      onError?.({
+        type: "unknown",
+        error: metadataError
+      });
+    }
+  }, [metadataError, onError]);
+  const parameters = metadata?.parameters;
+  const resolvedFieldDefinitions = useMemo(() => formFieldDefinitions ?? (metadata != null ? getDefaultFieldDefinitions(metadata) : EMPTY_FIELD_DEFINITIONS), [formFieldDefinitions, metadata]);
+  const rendererFieldDefinitions = useMemo(() => resolvedFieldDefinitions.map(def => ({
+    ...def,
+    fieldKey: String(def.fieldKey),
+    fieldType: parameters?.[String(def.fieldKey)]?.type,
+    defaultValue: def.defaultValue
+  })), [resolvedFieldDefinitions, parameters]);
+  const coerceFormState = useCallback(rawState => {
+    const coerced = {};
+    for (const [key, value] of Object.entries(rawState)) {
+      coerced[key] = coerceFieldValue(parameters?.[key]?.type, value);
+    }
+    return coerced;
+  }, [parameters]);
+  const handleSubmit = useCallback(async rawFormState => {
+    const formState = coerceFormState(rawFormState);
+    try {
+      if (onSubmit != null) {
+        await onSubmit(formState, osdkApplyAction);
+      } else {
+        const result = await osdkApplyAction(formState);
+        onSuccess?.(result);
+      }
+    } catch (e) {
+      onError?.({
+        type: "submission",
+        error: e
+      });
+    }
+  }, [coerceFormState, onSubmit, osdkApplyAction, onSuccess, onError]);
+  const handleFieldValueChange = useCallback((fieldKey, value) => {
+    onFormStateChange?.(prev => ({
+      ...prev,
+      [fieldKey]: value
+    }));
+  }, [onFormStateChange]);
+  const resolvedTitle = formTitle ?? metadata?.displayName ?? actionDefinition.apiName;
+  const commonProps = {
+    formTitle: resolvedTitle,
+    fieldDefinitions: rendererFieldDefinitions,
+    onSubmit: handleSubmit,
+    isSubmitDisabled,
+    isPending,
+    isLoading: metadataLoading
+  };
+  if (controlledFormState != null) {
+    return /*#__PURE__*/React.createElement(BaseForm, _extends({}, commonProps, {
+      formState: controlledFormState,
+      onFieldValueChange: handleFieldValueChange
+    }));
+  }
+  return /*#__PURE__*/React.createElement(BaseForm, commonProps);
+});
+//# sourceMappingURL=ActionForm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionForm.js","names":["useOsdkMetadata","useOsdkAction","React","useCallback","useEffect","useMemo","typedReactMemo","BaseForm","coerceFieldValue","getDefaultFieldDefinitions","EMPTY_FIELD_DEFINITIONS","ActionForm","actionDefinition","formTitle","formFieldDefinitions","formState","controlledFormState","onFormStateChange","isSubmitDisabled","onSubmit","onValidationResponse","_onValidationResponse","onSuccess","onError","applyAction","osdkApplyAction","isPending","metadata","loading","metadataLoading","error","metadataError","type","parameters","resolvedFieldDefinitions","rendererFieldDefinitions","map","def","fieldKey","String","fieldType","defaultValue","coerceFormState","rawState","coerced","key","value","Object","entries","handleSubmit","rawFormState","result","e","handleFieldValueChange","prev","resolvedTitle","displayName","apiName","commonProps","fieldDefinitions","isLoading","createElement","_extends","onFieldValueChange"],"sources":["ActionForm.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 type { ActionDefinition } from \"@osdk/api\";\nimport { useOsdkMetadata } from \"@osdk/react\";\nimport { useOsdkAction } from \"@osdk/react/experimental\";\nimport React, { useCallback, useEffect, useMemo } from \"react\";\nimport { typedReactMemo } from \"../shared/typedMemo.js\";\nimport type { ActionFormProps, FormState } from \"./ActionFormApi.js\";\nimport { BaseForm } from \"./BaseForm.js\";\nimport type { RendererFieldDefinition } from \"./FormFieldApi.js\";\nimport { coerceFieldValue } from \"./utils/coerceFieldValue.js\";\nimport { getDefaultFieldDefinitions } from \"./utils/getDefaultFieldDefinitions.js\";\n\nconst EMPTY_FIELD_DEFINITIONS: readonly [] = [];\n\nexport const ActionForm: <Q extends ActionDefinition<unknown>>(\n  props: ActionFormProps<Q>,\n) => React.ReactElement = typedReactMemo(function ActionFormFn<\n  Q extends ActionDefinition<unknown>,\n>({\n  actionDefinition,\n  formTitle,\n  formFieldDefinitions,\n  formState: controlledFormState,\n  onFormStateChange,\n  isSubmitDisabled,\n  onSubmit,\n  onValidationResponse: _onValidationResponse,\n  onSuccess,\n  onError,\n}: ActionFormProps<Q>): React.ReactElement {\n  const { applyAction: osdkApplyAction, isPending } = useOsdkAction(\n    actionDefinition,\n  );\n  const {\n    metadata,\n    loading: metadataLoading,\n    error: metadataError,\n  } = useOsdkMetadata(actionDefinition);\n\n  useEffect(\n    function saveMetadataError() {\n      if (metadataError != null) {\n        onError?.({ type: \"unknown\", error: metadataError });\n      }\n    },\n    [metadataError, onError],\n  );\n\n  const parameters = metadata?.parameters;\n\n  const resolvedFieldDefinitions = useMemo(\n    () =>\n      formFieldDefinitions\n        ?? (metadata != null\n          ? getDefaultFieldDefinitions<Q>(metadata)\n          : EMPTY_FIELD_DEFINITIONS),\n    [formFieldDefinitions, metadata],\n  );\n\n  const rendererFieldDefinitions: ReadonlyArray<RendererFieldDefinition> =\n    useMemo(\n      () =>\n        resolvedFieldDefinitions.map((def) => ({\n          ...def,\n          fieldKey: String(def.fieldKey),\n          fieldType: parameters?.[String(def.fieldKey)]?.type,\n          defaultValue: def.defaultValue,\n        })),\n      [resolvedFieldDefinitions, parameters],\n    );\n\n  const coerceFormState = useCallback(\n    (rawState: Record<string, unknown>): Record<string, unknown> => {\n      const coerced: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(rawState)) {\n        coerced[key] = coerceFieldValue(parameters?.[key]?.type, value);\n      }\n      return coerced;\n    },\n    [parameters],\n  );\n\n  const handleSubmit = useCallback(\n    async (rawFormState: Record<string, unknown>) => {\n      const formState = coerceFormState(rawFormState) as FormState<Q>;\n      try {\n        if (onSubmit != null) {\n          await onSubmit(formState, osdkApplyAction);\n        } else {\n          const result = await osdkApplyAction(formState);\n          onSuccess?.(result);\n        }\n      } catch (e) {\n        onError?.({ type: \"submission\", error: e });\n      }\n    },\n    [coerceFormState, onSubmit, osdkApplyAction, onSuccess, onError],\n  );\n\n  const handleFieldValueChange = useCallback(\n    (fieldKey: string, value: unknown) => {\n      onFormStateChange?.(\n        (prev) =>\n          ({\n            ...prev,\n            [fieldKey]: value,\n          }) as FormState<Q>,\n      );\n    },\n    [onFormStateChange],\n  );\n\n  const resolvedTitle = formTitle ?? metadata?.displayName\n    ?? actionDefinition.apiName;\n\n  const isControlled = controlledFormState != null;\n\n  const commonProps = {\n    formTitle: resolvedTitle,\n    fieldDefinitions: rendererFieldDefinitions,\n    onSubmit: handleSubmit,\n    isSubmitDisabled,\n    isPending,\n    isLoading: metadataLoading,\n  };\n\n  if (isControlled) {\n    return (\n      <BaseForm\n        {...commonProps}\n        formState={controlledFormState}\n        onFieldValueChange={handleFieldValueChange}\n      />\n    );\n  }\n\n  return <BaseForm {...commonProps} />;\n});\n"],"mappings":"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","ignoreList":[]}

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  ActionReturnTypeForOptions,\n  ActionValidationResponse,\n} from \"@osdk/api\";\nimport type { ActionValidationError, ApplyActionOptions } from \"@osdk/client\";\nimport type {\n  ActionParameters,\n  FieldKey,\n  FieldValueType,\n  FormFieldDefinition,\n} from \"./FormFieldApi.js\";\n\n/**\n * Props for the ActionForm component\n */\nexport interface ActionFormProps<Q extends ActionDefinition<unknown>> {\n  actionDefinition: Q;\n\n  /**\n   * If not supplied, defaults to actionDef.displayName\n   */\n  formTitle?: string;\n\n  /**\n   * If not supplied, this will be constructed from ActionParameters\n   */\n  formFieldDefinition?: Array<FormFieldDefinition<Q>>;\n\n  /**\n   * Called when a field value changed.\n   * Required when a field is in controlled mode, i.e. value is provided via formFieldDefinition.\n   *\n   * @param fieldKey The key of the changed field\n   * @param value the updated value of the field\n   */\n  onFieldValueChanged?: <K extends FieldKey<Q>>(\n    fieldKey: K,\n    value: FieldValueType<Q, K>,\n  ) => void;\n\n  /**\n   * Override to disable submit button\n   * If not provided, button is disabled when form is submitting or has validation errors\n   *\n   * @default false\n   */\n  isSubmitDisabled?: boolean;\n\n  /**\n   * If supplied, this will override the default submit action\n   * By default, the action's applyAction will be called with $validateOnly: false\n   *\n   * @param formState all field values when onSubmit is called\n   * @param applyAction the function to execute the action. Call it with $validateOnly: true options to run validation mode onSubmit.\n   * @returns a promise of the submission response\n   */\n  onSubmit?: <OP extends ApplyActionOptions>(\n    formState: FormState<Q>,\n    applyAction: (\n      args: ActionParameters<Q>,\n      options?: OP,\n    ) => Promise<ActionReturnTypeForOptions<OP>>,\n  ) => Promise<ActionReturnTypeForOptions<OP>> | 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) => 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: Error }\n  | { type: \"unknown\"; error: unknown };\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}\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,74 @@
+/*
+ * 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, useCallback, useMemo } from "react";
+import { useForm } from "react-hook-form";
+import { FieldBridge } from "./fields/FieldBridge.js";
+export const BaseForm = /*#__PURE__*/memo(function ({
+  formTitle,
+  fieldDefinitions,
+  formState: controlledFormState,
+  onFieldValueChange,
+  onSubmit,
+  isSubmitDisabled = false,
+  isPending = false,
+  isLoading = false
+}) {
+  const defaultValues = useMemo(() => buildDefaultValues(fieldDefinitions), [fieldDefinitions]);
+  const {
+    control,
+    handleSubmit: rhfHandleSubmit
+  } = useForm({
+    ...(controlledFormState != null ? {
+      values: controlledFormState
+    } : {
+      defaultValues
+    })
+  });
+  const onFormSubmit = useCallback(rhfValues => {
+    // In controlled mode, always submit the controlled state, not RHF's
+    // internal state. Between a user keystroke and the parent re-rendering,
+    // RHF's store may hold the user-typed value rather than the parent's
+    // value. Using controlledFormState directly preserves the existing
+    // guarantee that controlled mode submits the parent's state.
+    onSubmit(controlledFormState ?? rhfValues);
+  }, [onSubmit, controlledFormState]);
+  return /*#__PURE__*/React.createElement("form", {
+    onSubmit: rhfHandleSubmit(onFormSubmit),
+    "data-testid": "action-form"
+  }, formTitle != null && /*#__PURE__*/React.createElement("h2", {
+    "data-testid": "form-title"
+  }, formTitle), isLoading && fieldDefinitions.length === 0 && /*#__PURE__*/React.createElement("div", {
+    "data-testid": "form-loading"
+  }, "Loading form fields..."), fieldDefinitions.map(fieldDef => /*#__PURE__*/React.createElement(FieldBridge, {
+    key: fieldDef.fieldKey,
+    fieldDef: fieldDef,
+    control: control,
+    onExternalChange: onFieldValueChange
+  })), /*#__PURE__*/React.createElement("button", {
+    type: "submit",
+    disabled: isSubmitDisabled || isPending,
+    "data-testid": "submit-button"
+  }, isPending ? "Submitting..." : "Submit"));
+});
+function buildDefaultValues(fieldDefinitions) {
+  const values = {};
+  for (const def of fieldDefinitions) {
+    values[def.fieldKey] = def.defaultValue;
+  }
+  return values;
+}
+//# sourceMappingURL=BaseForm.js.map

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

@@ -0,0 +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","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)} data-testid=\"action-form\">\n      {formTitle != null && <h2 data-testid=\"form-title\">{formTitle}</h2>}\n      {isLoading && fieldDefinitions.length === 0 && (\n        <div data-testid=\"form-loading\">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        data-testid=\"submit-button\"\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,CAAE;IAAC,eAAY;EAAa,GACrEf,SAAS,IAAI,IAAI,iBAAIP,KAAA,CAAAwB,aAAA;IAAI,eAAY;EAAY,GAAEjB,SAAc,CAAC,EAClEQ,SAAS,IAAIP,gBAAgB,CAACiB,MAAM,KAAK,CAAC,iBACzCzB,KAAA,CAAAwB,aAAA;IAAK,eAAY;EAAc,GAAC,wBAA2B,CAC5D,EACAhB,gBAAgB,CAACkB,GAAG,CAAEC,QAAQ,iBAC7B3B,KAAA,CAAAwB,aAAA,CAACnB,WAAW;IACVuB,GAAG,EAAED,QAAQ,CAACE,QAAS;IACvBF,QAAQ,EAAEA,QAAS;IACnBT,OAAO,EAAEA,OAAQ;IACjBY,gBAAgB,EAAEnB;EAAmB,CACtC,CACF,CAAC,eACFX,KAAA,CAAAwB,aAAA;IACEO,IAAI,EAAC,QAAQ;IACbC,QAAQ,EAAEnB,gBAAgB,IAAIC,SAAU;IACxC,eAAY;EAAe,GAE1BA,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,MAAMY,GAAG,IAAIzB,gBAAgB,EAAE;IAClCa,MAAM,CAACY,GAAG,CAACJ,QAAQ,CAAC,GAAGI,GAAG,CAACC,YAAY;EACzC;EACA,OAAOb,MAAM;AACf","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"FormFieldApi.js","names":[],"sources":["FormFieldApi.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  CompileTimeMetadata,\n  ObjectSet,\n  ObjectTypeDefinition,\n} from \"@osdk/api\";\nimport type React from \"react\";\n\n/**\n * A form field definition specifies configuration for a single field\n */\nexport interface FormFieldDefinition<\n  Q extends ActionDefinition<unknown>,\n  K extends FieldKey<Q> = FieldKey<Q>,\n  V extends FieldValueType<Q, K> = FieldValueType<Q, K>,\n  C extends ValidFormFieldForPropertyType<V> = ValidFormFieldForPropertyType<V>,\n> {\n  /**\n   * The field's unique key\n   */\n  fieldKey: K;\n\n  /**\n   * Display label for the field\n   * If not provided, the form field will not show any label.\n   */\n  label?: string;\n\n  /**\n   * Current value of the field\n   * If provided, the field operates in controlled mode\n   */\n  value?: V;\n\n  /**\n   * Default value of the field\n   */\n  defaultValue?: V;\n\n  /**\n   * The form field component type to render\n   */\n  fieldComponent: C;\n\n  /**\n   * Whether the field is required\n   */\n  isRequired?: boolean;\n\n  /**\n   * Placeholder text\n   */\n  placeholder?: string;\n\n  /**\n   * Additional information to display on this field\n   * The placement of helper text depends on the value of helperTextPlacement prop\n   */\n  helperText?: string;\n\n  /**\n   * The placement of the helper text either below the field or in a tooltip\n   *\n   * @default \"tooltip\"\n   */\n  helperTextPlacement?: \"bottom\" | \"tooltip\";\n\n  /**\n   * Whether the field is disabled\n   */\n  isDisabled?: boolean;\n\n  /**\n   * A callback to return a custom error message if validation failed\n   *\n   * @param validationRule the validation rule that failed with the error message\n   * @returns the error message to display\n   */\n  onValidationError?: (error: ValidationError) => string;\n\n  /**\n   * Additional function to validate the field\n   *\n   * @param value the current field value\n   * @returns a boolean promise indicating whether the value is valid\n   */\n  validate?: (value: V) => Promise<boolean>;\n\n  /**\n   * The component props for the form field\n   * Excludes runtime props (key, onChange) which are managed by ActionForm\n   */\n  fieldComponentProps?: Omit<FormFieldPropsByType[C], \"key\" | \"onChange\">;\n}\n\ntype ValidationError = { type: ValidationRule; error: string };\n\ntype ValidationRule =\n  | \"required\"\n  | \"min\"\n  | \"max\"\n  | \"minLength\"\n  | \"maxLength\"\n  | \"pattern\"\n  | \"validate\";\n\n/**\n * Maps field types to their corresponding props\n */\nexport interface FormFieldPropsByType {\n  DATETIME_PICKER: DatetimePickerFieldProps;\n  DROPDOWN: DropdownFieldProps<unknown>;\n  FILE_PICKER: FilePickerProps;\n  NUMBER_INPUT: NumberInputFieldProps;\n  OBJECT_SET: ObjectSetFieldProps<ObjectTypeDefinition>;\n  RADIO_BUTTONS: RadioButtonsFieldProps<unknown>;\n  TEXT_AREA: TextAreaFieldProps;\n  TEXT_INPUT: TextInputFieldProps;\n  CUSTOM: CustomFieldProps<unknown>;\n}\n\n/**\n * Datetime picker field props\n */\nexport interface DatetimePickerFieldProps extends BaseFormFieldProps<Date> {\n  fieldComponent: \"DATETIME_PICKER\";\n\n  /**\n   * The earliest date the user can select\n   * If provided, this will be added to the field validation\n   */\n  min?: Date;\n\n  /**\n   * The latest date the user can select\n   * If provided, this will be added to the field validation\n   */\n  max?: Date;\n\n  /**\n   * Whether to show time picker\n   */\n  showTime?: boolean;\n\n  /**\n   * Function to format the date string\n   */\n  formatDate?: (date: Date) => string;\n}\n\n/**\n * Dropdown field props with selectable options\n */\nexport interface DropdownFieldProps<V, IsMulti extends boolean = false>\n  extends BaseFormFieldProps<IsMulti extends true ? V[] : V>\n{\n  fieldComponent: \"DROPDOWN\";\n\n  /**\n   * Available options for the dropdown\n   */\n  options: Option<V>[];\n\n  /**\n   * Whether the dropdown allows searching/filtering\n   */\n  isSearchable?: boolean;\n\n  /**\n   * Whether multiple values can be selected\n   */\n  isMulti?: boolean;\n}\n\nexport interface FilePickerProps extends BaseFormFieldProps<File | File[]> {\n  fieldComponent: \"FILE_PICKER\";\n\n  /**\n   * Whether multiple files can be selected\n   */\n  isMulti?: boolean;\n\n  /**\n   * Accepted file types (e.g., \"image/*\", \".pdf\")\n   */\n  accept?: string | string[];\n\n  /**\n   * Maximum file size in bytes\n   */\n  maxSize?: number;\n}\n\n/**\n * Text area field props\n */\nexport interface TextAreaFieldProps extends\n  BaseFormFieldProps<string>,\n  Pick<\n    React.TextareaHTMLAttributes<HTMLTextAreaElement>,\n    | \"rows\"\n    | \"wrap\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"minLength\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"maxLength\"\n  >\n{\n  fieldComponent: \"TEXT_AREA\";\n}\n\nexport interface TextInputFieldProps extends\n  BaseFormFieldProps<string>,\n  Pick<\n    React.InputHTMLAttributes<HTMLInputElement>,\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"minLength\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"maxLength\"\n  >\n{\n  fieldComponent: \"TEXT_INPUT\";\n}\n\n/**\n * Number input field props\n */\nexport interface NumberInputFieldProps extends\n  BaseFormFieldProps<number>,\n  Pick<\n    React.InputHTMLAttributes<HTMLInputElement>,\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"min\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"max\"\n    | \"step\"\n  >\n{\n  fieldComponent: \"NUMBER_INPUT\";\n}\n\n/**\n * Radio buttons field props\n */\nexport interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {\n  fieldComponent: \"RADIO_BUTTONS\";\n\n  /**\n   * Available options for radio buttons\n   */\n  options: Option<V>[];\n}\n\n/**\n * Option interface for dropdown and radio options\n */\nexport interface Option<V> {\n  label: string;\n  value: V;\n}\n\n/**\n * Object set field displays the summary of the count of the given object set\n */\nexport interface ObjectSetFieldProps<T extends ObjectTypeDefinition>\n  extends BaseFormFieldProps<ObjectSet<T>>\n{\n  fieldComponent: \"OBJECT_SET\";\n}\n\n/**\n * Custom field props for user-defined renderers\n */\nexport interface CustomFieldProps<V> extends BaseFormFieldProps<V> {\n  fieldComponent: \"CUSTOM\";\n\n  /**\n   * Custom renderer function\n   */\n  customRenderer: (props: BaseFormFieldProps<V>) => React.ReactNode;\n}\n\nexport interface BaseFormFieldProps<V> {\n  fieldComponent: FieldComponent;\n\n  /**\n   * Called when the field value changed.\n   *\n   * ActionForm internally wraps this to pass the key to onFieldValueChanged:\n   * ```\n   * <DropdownField\n   *   {...fieldDef}\n   *   onChange={(value) => onFieldValueChanged(fieldDef.key, value)}\n   * />\n   * ```\n   *\n   * @param value The new value of the form field\n   */\n  onChange?: (value?: V) => void;\n}\n\nexport type FieldKey<Q extends ActionDefinition<unknown>> =\n  keyof ActionParameters<Q>;\n\n/**\n * Extracts parameters from an ActionDefinition\n */\nexport type ActionParameters<Q extends ActionDefinition<unknown>> =\n  CompileTimeMetadata<Q>[\"parameters\"];\n\n/**\n * Extracts the value type for a specific parameter\n */\nexport type FieldValueType<\n  Q extends ActionDefinition<unknown> = ActionDefinition<unknown>,\n  K extends keyof ActionParameters<Q> = keyof ActionParameters<Q>,\n> = ActionParameters<Q>[K][\"type\"];\n\n/**\n * Available form field component types\n */\nexport type FieldComponent =\n  | \"DATETIME_PICKER\"\n  | \"DROPDOWN\"\n  | \"FILE_PICKER\"\n  | \"NUMBER_INPUT\"\n  | \"RADIO_BUTTONS\"\n  | \"OBJECT_SET\"\n  | \"TEXT_AREA\"\n  | \"TEXT_INPUT\"\n  | \"CUSTOM\";\n\n/**\n * Gets valid form field types for a given property type\n */\nexport type ValidFormFieldForPropertyType<P extends FieldValueType> = P extends\n  \"objectSet\" ? \"OBJECT_SET\"\n  : P extends \"object\" ? \"DROPDOWN\"\n  : P extends \"mediaReference\" | \"attachment\" ? \"FILE_PICKER\"\n  : P extends \"boolean\" ? \"RADIO_BUTTONS\" | \"DROPDOWN\"\n  : P extends \"string\" ? \"TEXT_INPUT\" | \"TEXT_AREA\"\n  : P extends \"datetime\" | \"timestamp\" ? \"DATETIME_PICKER\"\n  : P extends\n    | \"double\"\n    | \"integer\"\n    | \"long\"\n    | \"float\"\n    | \"short\"\n    | \"byte\"\n    | \"decimal\" ? \"NUMBER_INPUT\"\n  : never;\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"FormFieldApi.js","names":[],"sources":["FormFieldApi.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  ActionMetadata,\n  ActionParam,\n  CompileTimeMetadata,\n  DataValueClientToWire,\n  ObjectSet,\n  ObjectTypeDefinition,\n} from \"@osdk/api\";\nimport type React from \"react\";\n\n/**\n * A form field definition specifies configuration for a single field\n */\nexport interface FormFieldDefinition<\n  Q extends ActionDefinition<unknown>,\n  K extends FieldKey<Q> = FieldKey<Q>,\n> {\n  /**\n   * The field's unique key\n   */\n  fieldKey: K;\n\n  /**\n   * Display label for the field\n   * If not provided, the form field will not show any label.\n   */\n  label?: string;\n\n  /**\n   * Default value of the field\n   */\n  defaultValue?: FieldValueType<Q, K>;\n\n  /**\n   * The form field component type to render\n   */\n  fieldComponent: ValidFormFieldForPropertyType<FieldDescriptorType<Q, K>>;\n\n  /**\n   * Whether the field is required\n   */\n  isRequired?: boolean;\n\n  /**\n   * Placeholder text\n   */\n  placeholder?: string;\n\n  /**\n   * Additional information to display on this field\n   * The placement of helper text depends on the value of helperTextPlacement prop\n   */\n  helperText?: string;\n\n  /**\n   * The placement of the helper text either below the field or in a tooltip\n   *\n   * @default \"tooltip\"\n   */\n  helperTextPlacement?: \"bottom\" | \"tooltip\";\n\n  /**\n   * Whether the field is disabled\n   */\n  isDisabled?: boolean;\n\n  /**\n   * A callback to return a custom error message if validation failed\n   *\n   * @param validationRule the validation rule that failed with the error message\n   * @returns the error message to display\n   */\n  onValidationError?: (error: ValidationError) => string;\n\n  /**\n   * Additional function to validate the field\n   *\n   * @param value the current field value\n   * @returns a boolean promise indicating whether the value is valid\n   */\n  validate?: (value: FieldValueType<Q, K>) => Promise<boolean>;\n\n  /**\n   * The component props for the form field\n   * Excludes runtime props (key, onChange) which are managed by ActionForm\n   */\n  fieldComponentProps?: Omit<\n    FormFieldPropsByType[\n      ValidFormFieldForPropertyType<FieldDescriptorType<Q, K>>\n    ],\n    \"key\" | \"onChange\"\n  >;\n}\n\ntype ValidationError = { type: ValidationRule; error: string };\n\ntype ValidationRule =\n  | \"required\"\n  | \"min\"\n  | \"max\"\n  | \"minLength\"\n  | \"maxLength\"\n  | \"pattern\"\n  | \"validate\";\n\n/**\n * Maps field types to their corresponding props\n */\nexport interface FormFieldPropsByType {\n  DATETIME_PICKER: DatetimePickerFieldProps;\n  DROPDOWN: DropdownFieldProps<unknown>;\n  FILE_PICKER: FilePickerProps;\n  NUMBER_INPUT: NumberInputFieldProps;\n  OBJECT_SET: ObjectSetFieldProps<ObjectTypeDefinition>;\n  RADIO_BUTTONS: RadioButtonsFieldProps<unknown>;\n  TEXT_AREA: TextAreaFieldProps;\n  TEXT_INPUT: TextInputFieldProps;\n  CUSTOM: CustomFieldProps<unknown>;\n}\n\n/**\n * Datetime picker field props\n */\nexport interface DatetimePickerFieldProps extends BaseFormFieldProps<Date> {\n  fieldComponent: \"DATETIME_PICKER\";\n\n  /**\n   * The earliest date the user can select\n   * If provided, this will be added to the field validation\n   */\n  min?: Date;\n\n  /**\n   * The latest date the user can select\n   * If provided, this will be added to the field validation\n   */\n  max?: Date;\n\n  /**\n   * Whether to show time picker\n   */\n  showTime?: boolean;\n\n  /**\n   * Function to format the date string\n   */\n  formatDate?: (date: Date) => string;\n}\n\n/**\n * Dropdown field props with selectable options\n */\nexport interface DropdownFieldProps<V, IsMulti extends boolean = false>\n  extends BaseFormFieldProps<IsMulti extends true ? V[] : V>\n{\n  fieldComponent: \"DROPDOWN\";\n\n  /**\n   * Available options for the dropdown\n   */\n  options: Option<V>[];\n\n  /**\n   * Whether the dropdown allows searching/filtering\n   */\n  isSearchable?: boolean;\n\n  /**\n   * Whether multiple values can be selected\n   */\n  isMulti?: boolean;\n}\n\nexport interface FilePickerProps extends BaseFormFieldProps<File | File[]> {\n  fieldComponent: \"FILE_PICKER\";\n\n  /**\n   * Whether multiple files can be selected\n   */\n  isMulti?: boolean;\n\n  /**\n   * Accepted file types (e.g., \"image/*\", \".pdf\")\n   */\n  accept?: string | string[];\n\n  /**\n   * Maximum file size in bytes\n   */\n  maxSize?: number;\n}\n\n/**\n * Text area field props\n */\nexport interface TextAreaFieldProps extends\n  BaseFormFieldProps<string>,\n  Pick<\n    React.TextareaHTMLAttributes<HTMLTextAreaElement>,\n    | \"rows\"\n    | \"wrap\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"minLength\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"maxLength\"\n  >\n{\n  fieldComponent: \"TEXT_AREA\";\n}\n\nexport interface TextInputFieldProps extends\n  BaseFormFieldProps<string>,\n  Pick<\n    React.InputHTMLAttributes<HTMLInputElement>,\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"minLength\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"maxLength\"\n  >\n{\n  fieldComponent: \"TEXT_INPUT\";\n  placeholder?: string;\n}\n\n/**\n * Number input field props\n */\nexport interface NumberInputFieldProps extends\n  BaseFormFieldProps<number>,\n  Pick<\n    React.InputHTMLAttributes<HTMLInputElement>,\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"min\"\n    /**\n     * If provided, this will be added to the field validation\n     */\n    | \"max\"\n    | \"step\"\n  >\n{\n  fieldComponent: \"NUMBER_INPUT\";\n}\n\n/**\n * Radio buttons field props\n */\nexport interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {\n  fieldComponent: \"RADIO_BUTTONS\";\n\n  /**\n   * Available options for radio buttons\n   */\n  options: Option<V>[];\n}\n\n/**\n * Option interface for dropdown and radio options\n */\nexport interface Option<V> {\n  label: string;\n  value: V;\n}\n\n/**\n * Object set field displays the summary of the count of the given object set\n */\nexport interface ObjectSetFieldProps<T extends ObjectTypeDefinition>\n  extends BaseFormFieldProps<ObjectSet<T>>\n{\n  fieldComponent: \"OBJECT_SET\";\n}\n\n/**\n * Custom field props for user-defined renderers\n */\nexport interface CustomFieldProps<V> extends BaseFormFieldProps<V> {\n  fieldComponent: \"CUSTOM\";\n\n  /**\n   * Custom renderer function\n   */\n  customRenderer: (props: BaseFormFieldProps<V>) => React.ReactNode;\n}\n\nexport interface BaseFormFieldProps<V> {\n  /**\n   * The value of the form field\n   */\n  value: V;\n  /**\n   * Called when the field value changes.\n   *\n   * ActionForm internally wraps this to pass the key to `onFieldValueChange`:\n   * ```\n   * <DropdownField\n   *   {...fieldDef}\n   *   onChange={(value) => onFieldValueChange(fieldDef.key, value)}\n   * />\n   * ```\n   *\n   * @param value The new value of the form field\n   */\n  onChange?: (value?: V) => void;\n}\n\nexport type FieldKey<Q extends ActionDefinition<unknown>> =\n  keyof ActionParameters<Q>;\n\n/**\n * Extracts parameters from an ActionDefinition\n */\nexport type ActionParameters<Q extends ActionDefinition<unknown>> =\n  CompileTimeMetadata<Q>[\"parameters\"];\n\n/**\n * Extracts the value type for a specific parameter\n *\n * TODO: Re-use `BaseType`\n */\nexport type FieldValueType<\n  Q extends ActionDefinition<unknown>,\n  K extends keyof ActionParameters<Q> = keyof ActionParameters<Q>,\n> = ActionParameters<Q>[K][\"type\"] extends\n  ActionMetadata.DataType.Object<infer T> ? ActionParam.ObjectType<T>\n  : ActionParameters<Q>[K][\"type\"] extends\n    ActionMetadata.DataType.ObjectSet<infer T> ? ActionParam.ObjectSetType<T>\n  : ActionParameters<Q>[K][\"type\"] extends\n    ActionMetadata.DataType.Struct<infer T> ? ActionParam.StructType<T>\n  : ActionParameters<Q>[K][\"type\"] extends keyof DataValueClientToWire\n    ? DataValueClientToWire[ActionParameters<Q>[K][\"type\"]]\n  : never;\n\n/**\n * Extracts the parameter type descriptor for a specific action parameter.\n */\nexport type FieldDescriptorType<\n  Q extends ActionDefinition<unknown> = ActionDefinition<unknown>,\n  K extends keyof ActionParameters<Q> = keyof ActionParameters<Q>,\n> = ActionParameters<Q>[K][\"type\"];\n\n/**\n * Available form field component types\n */\nexport type FieldComponent =\n  | \"DATETIME_PICKER\"\n  | \"DROPDOWN\"\n  | \"FILE_PICKER\"\n  | \"NUMBER_INPUT\"\n  | \"RADIO_BUTTONS\"\n  | \"OBJECT_SET\"\n  | \"TEXT_AREA\"\n  | \"TEXT_INPUT\"\n  | \"CUSTOM\";\n\n/**\n * Describes the data type of a form field, independent of OSDK.\n * Mirrors ActionMetadata.DataType to keep the rendering layer OSDK-agnostic.\n */\nexport type FieldType =\n  | \"boolean\"\n  | \"string\"\n  | \"integer\"\n  | \"long\"\n  | \"double\"\n  | \"datetime\"\n  | \"timestamp\"\n  | \"attachment\"\n  | \"marking\"\n  | \"mediaReference\"\n  | \"objectType\"\n  | \"geoshape\"\n  | \"geohash\"\n  | { type: \"object\"; object: string }\n  | { type: \"objectSet\"; objectSet: string }\n  | { type: \"interface\"; interface: string }\n  | { type: \"struct\"; struct: Record<string, string> };\n\n/**\n * An OSDK-agnostic field definition used by BaseForm and FormFieldRenderer.\n * Contains only the information needed to render a single field — no generics,\n * no compile-time parameter constraints.\n */\nexport interface RendererFieldDefinition {\n  fieldKey: string;\n  fieldComponent: FieldComponent;\n  fieldType?: FieldType;\n  label?: string;\n  defaultValue?: unknown;\n  isRequired?: boolean;\n  placeholder?: string;\n  helperText?: string;\n  helperTextPlacement?: \"bottom\" | \"tooltip\";\n  fieldComponentProps?: Record<string, unknown>;\n}\n\n/**\n * Gets valid form field types for a given property type\n */\nexport type ValidFormFieldForPropertyType<P extends FieldDescriptorType> =\n  P extends \"objectSet\" ? \"OBJECT_SET\"\n    : P extends \"object\" ? \"DROPDOWN\"\n    : P extends \"mediaReference\" | \"attachment\" ? \"FILE_PICKER\"\n    : P extends \"boolean\" ? \"RADIO_BUTTONS\" | \"DROPDOWN\"\n    : P extends \"string\" ? \"TEXT_INPUT\" | \"TEXT_AREA\"\n    : P extends \"datetime\" | \"timestamp\" ? \"DATETIME_PICKER\"\n    : P extends\n      | \"double\"\n      | \"integer\"\n      | \"long\"\n      | \"float\"\n      | \"short\"\n      | \"byte\"\n      | \"decimal\" ? \"NUMBER_INPUT\"\n    : never;\n"],"mappings":"","ignoreList":[]}

package/build/esm/action-form/fields/FieldBridge.js

@@ -0,0 +1,45 @@
+/*
+ * 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, useCallback } from "react";
+import { useController } from "react-hook-form";
+import { FormFieldRenderer } from "./FormFieldRenderer.js";
+export const FieldBridge = /*#__PURE__*/memo(function ({
+  fieldDef,
+  control,
+  onExternalChange
+}) {
+  const {
+    field: {
+      onChange,
+      value
+    }
+  } = useController({
+    name: fieldDef.fieldKey,
+    control,
+    defaultValue: fieldDef.defaultValue
+  });
+  const handleChange = useCallback(newValue => {
+    onChange(newValue);
+    onExternalChange?.(fieldDef.fieldKey, newValue);
+  }, [onChange, onExternalChange, fieldDef.fieldKey]);
+  return /*#__PURE__*/React.createElement(FormFieldRenderer, {
+    value: value,
+    fieldDefinition: fieldDef,
+    onFieldValueChange: handleChange
+  });
+});
+//# sourceMappingURL=FieldBridge.js.map

package/build/esm/action-form/fields/FieldBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldBridge.js","names":["React","memo","useCallback","useController","FormFieldRenderer","FieldBridge","fieldDef","control","onExternalChange","field","onChange","value","name","fieldKey","defaultValue","handleChange","newValue","createElement","fieldDefinition","onFieldValueChange"],"sources":["FieldBridge.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 } from \"react\";\nimport type { Control } from \"react-hook-form\";\nimport { useController } from \"react-hook-form\";\nimport type { RendererFieldDefinition } from \"../FormFieldApi.js\";\nimport { FormFieldRenderer } from \"./FormFieldRenderer.js\";\n\nexport interface FieldBridgeProps {\n  fieldDef: RendererFieldDefinition;\n  control: Control<Record<string, unknown>>;\n  onExternalChange?: (fieldKey: string, value: unknown) => void;\n}\nexport const FieldBridge: React.FC<FieldBridgeProps> = memo(\n  function FieldBridgeFn({\n    fieldDef,\n    control,\n    onExternalChange,\n  }: FieldBridgeProps): React.ReactElement {\n    const {\n      field: { onChange, value },\n    } = useController({\n      name: fieldDef.fieldKey,\n      control,\n      defaultValue: fieldDef.defaultValue,\n    });\n\n    const handleChange = useCallback(\n      (newValue: unknown) => {\n        onChange(newValue);\n        onExternalChange?.(fieldDef.fieldKey, newValue);\n      },\n      [onChange, onExternalChange, fieldDef.fieldKey],\n    );\n\n    return (\n      <FormFieldRenderer\n        value={value}\n        fieldDefinition={fieldDef}\n        onFieldValueChange={handleChange}\n      />\n    );\n  },\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,QAAQ,OAAO;AAEhD,SAASC,aAAa,QAAQ,iBAAiB;AAE/C,SAASC,iBAAiB,QAAQ,wBAAwB;AAO1D,OAAO,MAAMC,WAAuC,gBAAGJ,IAAI,CACzD,UAAuB;EACrBK,QAAQ;EACRC,OAAO;EACPC;AACgB,CAAC,EAAsB;EACvC,MAAM;IACJC,KAAK,EAAE;MAAEC,QAAQ;MAAEC;IAAM;EAC3B,CAAC,GAAGR,aAAa,CAAC;IAChBS,IAAI,EAAEN,QAAQ,CAACO,QAAQ;IACvBN,OAAO;IACPO,YAAY,EAAER,QAAQ,CAACQ;EACzB,CAAC,CAAC;EAEF,MAAMC,YAAY,GAAGb,WAAW,CAC7Bc,QAAiB,IAAK;IACrBN,QAAQ,CAACM,QAAQ,CAAC;IAClBR,gBAAgB,GAAGF,QAAQ,CAACO,QAAQ,EAAEG,QAAQ,CAAC;EACjD,CAAC,EACD,CAACN,QAAQ,EAAEF,gBAAgB,EAAEF,QAAQ,CAACO,QAAQ,CAChD,CAAC;EAED,oBACEb,KAAA,CAAAiB,aAAA,CAACb,iBAAiB;IAChBO,KAAK,EAAEA,KAAM;IACbO,eAAe,EAAEZ,QAAS;IAC1Ba,kBAAkB,EAAEJ;EAAa,CAClC,CAAC;AAEN,CACF,CAAC","ignoreList":[]}

package/build/esm/action-form/fields/FormFieldRenderer.js

@@ -0,0 +1,68 @@
+/*
+ * 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 { TextInputField } from "./TextInputField.js";
+export const FormFieldRenderer = /*#__PURE__*/memo(function ({
+  fieldDefinition,
+  value,
+  onFieldValueChange
+}) {
+  const {
+    label,
+    isRequired,
+    helperText,
+    helperTextPlacement
+  } = fieldDefinition;
+  return /*#__PURE__*/React.createElement("div", {
+    "data-testid": `form-field-${fieldDefinition.fieldKey}`
+  }, label != null && /*#__PURE__*/React.createElement("label", null, label, isRequired === true && /*#__PURE__*/React.createElement("span", {
+    "aria-label": "required"
+  }, "*")), renderFieldComponent(fieldDefinition, value, onFieldValueChange), helperText != null && helperTextPlacement !== "tooltip" && /*#__PURE__*/React.createElement("div", {
+    "data-testid": "helper-text"
+  }, helperText));
+});
+function renderFieldComponent(fieldDefinition, value, onChange) {
+  switch (fieldDefinition.fieldComponent) {
+    case "TEXT_INPUT":
+    // TODO: Render a <textarea> for TEXT_AREA instead of falling through
+    case "TEXT_AREA":
+      return /*#__PURE__*/React.createElement(TextInputField, {
+        fieldComponent: "TEXT_INPUT"
+        // TODO: Use coerceFieldValue
+        ,
+        value: value != null ? String(value) : "",
+        onChange: onChange,
+        placeholder: fieldDefinition.placeholder
+      });
+    case "NUMBER_INPUT":
+    case "DROPDOWN":
+    case "RADIO_BUTTONS":
+    case "DATETIME_PICKER":
+    case "FILE_PICKER":
+    case "OBJECT_SET":
+    case "CUSTOM":
+      return /*#__PURE__*/React.createElement("div", {
+        "data-testid": "unsupported-field"
+      }, "Unsupported field type: ", fieldDefinition.fieldComponent);
+    default:
+      return assertUnreachableFieldComponent(fieldDefinition.fieldComponent);
+  }
+}
+function assertUnreachableFieldComponent(value) {
+  throw new Error(`Unhandled field component: ${String(value)}`);
+}
+//# sourceMappingURL=FormFieldRenderer.js.map

package/build/esm/action-form/fields/FormFieldRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldRenderer.js","names":["React","memo","TextInputField","FormFieldRenderer","fieldDefinition","value","onFieldValueChange","label","isRequired","helperText","helperTextPlacement","createElement","fieldKey","renderFieldComponent","onChange","fieldComponent","String","placeholder","assertUnreachableFieldComponent","Error"],"sources":["FormFieldRenderer.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 } from \"react\";\nimport type { RendererFieldDefinition } from \"../FormFieldApi.js\";\nimport { TextInputField } from \"./TextInputField.js\";\n\nexport interface FormFieldRendererProps {\n  fieldDefinition: RendererFieldDefinition;\n  value: unknown;\n  onFieldValueChange: (value: unknown) => void;\n}\n\nexport const FormFieldRenderer: React.FC<FormFieldRendererProps> = memo(\n  function FormFieldRendererFn({\n    fieldDefinition,\n    value,\n    onFieldValueChange,\n  }: FormFieldRendererProps): React.ReactElement {\n    const { label, isRequired, helperText, helperTextPlacement } =\n      fieldDefinition;\n\n    return (\n      <div data-testid={`form-field-${fieldDefinition.fieldKey}`}>\n        {label != null && (\n          <label>\n            {label}\n            {isRequired === true && <span aria-label=\"required\">*</span>}\n          </label>\n        )}\n        {renderFieldComponent(fieldDefinition, value, onFieldValueChange)}\n        {helperText != null && helperTextPlacement !== \"tooltip\" && (\n          <div data-testid=\"helper-text\">{helperText}</div>\n        )}\n      </div>\n    );\n  },\n);\n\nfunction renderFieldComponent(\n  fieldDefinition: RendererFieldDefinition,\n  value: unknown,\n  onChange: (value: unknown) => void,\n): React.ReactElement {\n  switch (fieldDefinition.fieldComponent) {\n    case \"TEXT_INPUT\":\n    // TODO: Render a <textarea> for TEXT_AREA instead of falling through\n    case \"TEXT_AREA\":\n      return (\n        <TextInputField\n          fieldComponent=\"TEXT_INPUT\"\n          // TODO: Use coerceFieldValue\n          value={value != null ? String(value) : \"\"}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n        />\n      );\n    case \"NUMBER_INPUT\":\n    case \"DROPDOWN\":\n    case \"RADIO_BUTTONS\":\n    case \"DATETIME_PICKER\":\n    case \"FILE_PICKER\":\n    case \"OBJECT_SET\":\n    case \"CUSTOM\":\n      return (\n        <div data-testid=\"unsupported-field\">\n          Unsupported field type: {fieldDefinition.fieldComponent}\n        </div>\n      );\n    default:\n      return assertUnreachableFieldComponent(fieldDefinition.fieldComponent);\n  }\n}\n\nfunction assertUnreachableFieldComponent(value: never): never {\n  throw new Error(`Unhandled field component: ${String(value)}`);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,IAAI,QAAQ,OAAO;AAEnC,SAASC,cAAc,QAAQ,qBAAqB;AAQpD,OAAO,MAAMC,iBAAmD,gBAAGF,IAAI,CACrE,UAA6B;EAC3BG,eAAe;EACfC,KAAK;EACLC;AACsB,CAAC,EAAsB;EAC7C,MAAM;IAAEC,KAAK;IAAEC,UAAU;IAAEC,UAAU;IAAEC;EAAoB,CAAC,GAC1DN,eAAe;EAEjB,oBACEJ,KAAA,CAAAW,aAAA;IAAK,eAAa,cAAcP,eAAe,CAACQ,QAAQ;EAAG,GACxDL,KAAK,IAAI,IAAI,iBACZP,KAAA,CAAAW,aAAA,gBACGJ,KAAK,EACLC,UAAU,KAAK,IAAI,iBAAIR,KAAA,CAAAW,aAAA;IAAM,cAAW;EAAU,GAAC,GAAO,CACtD,CACR,EACAE,oBAAoB,CAACT,eAAe,EAAEC,KAAK,EAAEC,kBAAkB,CAAC,EAChEG,UAAU,IAAI,IAAI,IAAIC,mBAAmB,KAAK,SAAS,iBACtDV,KAAA,CAAAW,aAAA;IAAK,eAAY;EAAa,GAAEF,UAAgB,CAE/C,CAAC;AAEV,CACF,CAAC;AAED,SAASI,oBAAoBA,CAC3BT,eAAwC,EACxCC,KAAc,EACdS,QAAkC,EACd;EACpB,QAAQV,eAAe,CAACW,cAAc;IACpC,KAAK,YAAY;IACjB;IACA,KAAK,WAAW;MACd,oBACEf,KAAA,CAAAW,aAAA,CAACT,cAAc;QACba,cAAc,EAAC;QACf;QAAA;QACAV,KAAK,EAAEA,KAAK,IAAI,IAAI,GAAGW,MAAM,CAACX,KAAK,CAAC,GAAG,EAAG;QAC1CS,QAAQ,EAAEA,QAAS;QACnBG,WAAW,EAAEb,eAAe,CAACa;MAAY,CAC1C,CAAC;IAEN,KAAK,cAAc;IACnB,KAAK,UAAU;IACf,KAAK,eAAe;IACpB,KAAK,iBAAiB;IACtB,KAAK,aAAa;IAClB,KAAK,YAAY;IACjB,KAAK,QAAQ;MACX,oBACEjB,KAAA,CAAAW,aAAA;QAAK,eAAY;MAAmB,GAAC,0BACX,EAACP,eAAe,CAACW,cACtC,CAAC;IAEV;MACE,OAAOG,+BAA+B,CAACd,eAAe,CAACW,cAAc,CAAC;EAC1E;AACF;AAEA,SAASG,+BAA+BA,CAACb,KAAY,EAAS;EAC5D,MAAM,IAAIc,KAAK,CAAC,8BAA8BH,MAAM,CAACX,KAAK,CAAC,EAAE,CAAC;AAChE","ignoreList":[]}

package/build/esm/action-form/fields/TextInputField.js

@@ -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.
+ */
+
+import React, { useCallback } from "react";
+export function TextInputField({
+  value,
+  onChange,
+  placeholder,
+  minLength,
+  maxLength
+}) {
+  const handleChange = useCallback(e => {
+    onChange?.(e.target.value);
+  }, [onChange]);
+  return /*#__PURE__*/React.createElement("input", {
+    type: "text",
+    value: value,
+    onChange: handleChange,
+    placeholder: placeholder,
+    minLength: minLength,
+    maxLength: maxLength,
+    "data-testid": "text-input-field"
+  });
+}
+//# sourceMappingURL=TextInputField.js.map

package/build/esm/action-form/fields/TextInputField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextInputField.js","names":["React","useCallback","TextInputField","value","onChange","placeholder","minLength","maxLength","handleChange","e","target","createElement","type"],"sources":["TextInputField.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, { useCallback } from \"react\";\nimport type { TextInputFieldProps } from \"../FormFieldApi.js\";\n\nexport function TextInputField({\n  value,\n  onChange,\n  placeholder,\n  minLength,\n  maxLength,\n}: TextInputFieldProps): React.ReactElement {\n  const handleChange = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      onChange?.(e.target.value);\n    },\n    [onChange],\n  );\n\n  return (\n    <input\n      type=\"text\"\n      value={value}\n      onChange={handleChange}\n      placeholder={placeholder}\n      minLength={minLength}\n      maxLength={maxLength}\n      data-testid=\"text-input-field\"\n    />\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,WAAW,QAAQ,OAAO;AAG1C,OAAO,SAASC,cAAcA,CAAC;EAC7BC,KAAK;EACLC,QAAQ;EACRC,WAAW;EACXC,SAAS;EACTC;AACmB,CAAC,EAAsB;EAC1C,MAAMC,YAAY,GAAGP,WAAW,CAC7BQ,CAAsC,IAAK;IAC1CL,QAAQ,GAAGK,CAAC,CAACC,MAAM,CAACP,KAAK,CAAC;EAC5B,CAAC,EACD,CAACC,QAAQ,CACX,CAAC;EAED,oBACEJ,KAAA,CAAAW,aAAA;IACEC,IAAI,EAAC,MAAM;IACXT,KAAK,EAAEA,KAAM;IACbC,QAAQ,EAAEI,YAAa;IACvBH,WAAW,EAAEA,WAAY;IACzBC,SAAS,EAAEA,SAAU;IACrBC,SAAS,EAAEA,SAAU;IACrB,eAAY;EAAkB,CAC/B,CAAC;AAEN","ignoreList":[]}

package/build/esm/action-form/utils/coerceFieldValue.js

@@ -0,0 +1,93 @@
+/*
+ * 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.
+ */
+
+/**
+ * Coerces a raw form field value to match the expected type for the given
+ * field type. Returns `undefined` when coercion fails
+ * (e.g. non-numeric string for a number field).
+ *
+ * Complex types (object, objectSet, struct, interface) are passed through
+ * unchanged since they cannot be meaningfully coerced.
+ */
+export function coerceFieldValue(parameterType, rawValue) {
+  if (rawValue == null) {
+    return undefined;
+  }
+  if (parameterType == null) {
+    return rawValue;
+  }
+
+  // TODO: Handle complex object types later
+  if (typeof parameterType === "object") {
+    return rawValue;
+  }
+  switch (parameterType) {
+    case "string":
+    case "marking":
+    case "geohash":
+    case "geoshape":
+    case "objectType":
+      return typeof rawValue === "string" ? rawValue : String(rawValue);
+    case "integer":
+    case "long":
+      {
+        const maybeNumber = extractNumber(rawValue);
+        return maybeNumber != null ? Math.trunc(maybeNumber) : undefined;
+      }
+    case "double":
+      {
+        return extractNumber(rawValue);
+      }
+    case "boolean":
+      {
+        if (typeof rawValue === "boolean") {
+          return rawValue;
+        }
+        if (rawValue === "true") return true;
+        if (rawValue === "false") return false;
+        return undefined;
+      }
+    case "datetime":
+    case "timestamp":
+      {
+        if (typeof rawValue === "string") {
+          return Number.isNaN(Date.parse(rawValue)) ? undefined : rawValue;
+        }
+        if (rawValue instanceof Date) {
+          return rawValue.toISOString();
+        }
+        return undefined;
+      }
+    case "attachment":
+    case "mediaReference":
+      return rawValue;
+    default:
+      return rawValue;
+  }
+}
+function extractNumber(rawValue) {
+  if (typeof rawValue === "number") {
+    return rawValue;
+  }
+  if (typeof rawValue === "string") {
+    const trimmed = rawValue.trim();
+    if (trimmed === "") return undefined;
+    const parsed = Number(trimmed);
+    return Number.isNaN(parsed) ? undefined : parsed;
+  }
+  return undefined;
+}
+//# sourceMappingURL=coerceFieldValue.js.map