@osdk/react-components 0.2.0 → 0.3.0-main-20260407112212

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @osdk/react-components
 
+## 0.3.0-main-20260407112212
+
+### Minor Changes
+
+- f8b9f12: Cache results from useOsdkFunctions
+
+### Patch Changes
+
+- 79b001e: Add FilePickerField component for attachment and media reference form fields
+- Updated dependencies [f8b9f12]
+- Updated dependencies [bcf359f]
+- Updated dependencies [51ccca8]
+  - @osdk/client@2.9.0-main-20260407112212
+  - @osdk/react@0.11.0-main-20260407112212
+  - @osdk/api@2.9.0-main-20260407112212
+
 ## 0.2.0
 
 ### Minor Changes

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

@@ -1 +1 @@
-{"version":3,"file":"FormFieldApi.js","names":[],"sources":["FormFieldApi.ts"],"sourcesContent":["/*\n * Copyright 2026 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   */\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 (value, onChange) which are managed by ActionForm\n   */\n  fieldComponentProps: Omit<\n    FormFieldPropsByType[\n      ValidFormFieldForPropertyType<\n        FieldDescriptorType<Q, K>\n      >\n    ],\n    \"value\" | \"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, boolean>;\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 *\n * When `formatDate` is omitted, ISO-like format is used (YYYY-MM-DD / YYYY-MM-DD HH:mm).\n */\nexport interface DatetimePickerFieldProps extends BaseFormFieldProps<Date> {\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   * Whether to close the popover after selecting a date.\n   * @default true when `showTime` is false, false when `showTime` is true\n   */\n  closeOnSelection?: boolean;\n\n  /**\n   * Placeholder text shown when no value is selected.\n   */\n  placeholder?: string;\n\n  /** Formats a Date for display in the trigger button. */\n  formatDate?: (date: Date) => string;\n}\n\n/**\n * Dropdown field props with selectable items\n */\nexport interface DropdownFieldProps<V, Multiple extends boolean = false>\n  extends BaseFormFieldProps<Multiple extends true ? V[] : V>\n{\n  /**\n   * Available items for the dropdown\n   */\n  items: V[];\n\n  /**\n   * Converts an item to a display string. Defaults to `String()`.\n   */\n  itemToStringLabel?: (item: V) => string;\n\n  /**\n   * Returns a unique string key for a list item. Used as the React `key`.\n   * Falls back to the item's index when not provided.\n   */\n  itemToKey?: (item: V) => string;\n\n  /**\n   * Custom equality check for item values. Defaults to `Object.is`.\n   * Required when items are objects to ensure correct selection matching.\n   */\n  isItemEqual?: (a: V, b: V) => boolean;\n\n  /**\n   * Whether the dropdown allows searching/filtering.\n   * When true, renders a Combobox with a search input.\n   * When false (default), renders a Select dropdown.\n   */\n  isSearchable?: boolean;\n\n  /**\n   * Placeholder text shown when no value is selected.\n   */\n  placeholder?: string;\n\n  /**\n   * Whether multiple values can be selected\n   */\n  isMultiple?: Multiple;\n}\n\nexport interface FilePickerProps extends BaseFormFieldProps<File | File[]> {\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  placeholder?: string;\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  placeholder?: string;\n}\n\n/**\n * Number input field props\n */\nexport interface NumberInputFieldProps extends BaseFormFieldProps<number> {\n  /**\n   * Minimum allowed value.\n   */\n  min?: number;\n\n  /**\n   * Maximum allowed value.\n   */\n  max?: number;\n\n  /**\n   * Step increment for the input. Used by the stepper buttons and ArrowUp/ArrowDown keyboard stepping.\n   *\n   * @default 1\n   */\n  step?: number;\n\n  /**\n   * Placeholder text shown when the input is empty.\n   */\n  placeholder?: string;\n}\n\n/**\n * Radio buttons field props\n */\nexport interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {\n  /**\n   * Available options for radio buttons.\n   *\n   * Values are compared by reference equality (`===`). When options contain\n   * non-primitive values, pass the same object references for `value` and\n   * the corresponding option entry.\n   */\n  options: Option<V>[];\n}\n\n/**\n * Option interface for radio button 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\n/**\n * Custom field props for user-defined renderers\n */\nexport interface CustomFieldProps<V> extends BaseFormFieldProps<V> {\n  /**\n   * Custom renderer function\n   */\n  customRenderer: (props: BaseFormFieldProps<V>) => React.ReactNode;\n}\n\nexport interface BaseFormFieldProps<V> {\n  /**\n   * The HTML `id` attribute for the field input element.\n   * Used for `<label htmlFor>` association.\n   */\n  id?: string;\n\n  /**\n   * The value of the form field\n   */\n  value: V | null;\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 | null) => 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 ActionMetadata.DataType.ObjectSet<\n    infer T\n  > ? ActionParam.ObjectSetType<T>\n  : ActionParameters<Q>[K][\"type\"] extends ActionMetadata.DataType.Struct<\n    infer T\n  > ? 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 *\n * Implemented as a distributed mapped type: switching on `fieldComponent`\n * narrows `fieldComponentProps` to the correct props type automatically.\n */\nexport type RendererFieldDefinition = {\n  [K in FieldComponent]: {\n    fieldKey: string;\n    fieldComponent: K;\n    fieldType?: FieldType;\n    label: string;\n    defaultValue?: unknown;\n    isRequired?: boolean;\n    placeholder?: string;\n    helperText?: string;\n    helperTextPlacement?: \"bottom\" | \"tooltip\";\n    fieldComponentProps: Omit<FormFieldPropsByType[K], \"value\" | \"onChange\">;\n  };\n}[FieldComponent];\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":[]}
+{"version":3,"file":"FormFieldApi.js","names":[],"sources":["FormFieldApi.ts"],"sourcesContent":["/*\n * Copyright 2026 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   */\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 (value, onChange) which are managed by ActionForm\n   */\n  fieldComponentProps: Omit<\n    FormFieldPropsByType[\n      ValidFormFieldForPropertyType<\n        FieldDescriptorType<Q, K>\n      >\n    ],\n    \"value\" | \"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, boolean>;\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 *\n * When `formatDate` is omitted, ISO-like format is used (YYYY-MM-DD / YYYY-MM-DD HH:mm).\n */\nexport interface DatetimePickerFieldProps extends BaseFormFieldProps<Date> {\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   * Whether to close the popover after selecting a date.\n   * @default true when `showTime` is false, false when `showTime` is true\n   */\n  closeOnSelection?: boolean;\n\n  /**\n   * Placeholder text shown when no value is selected.\n   */\n  placeholder?: string;\n\n  /** Formats a Date for display in the trigger button. */\n  formatDate?: (date: Date) => string;\n}\n\n/**\n * Dropdown field props with selectable items\n */\nexport interface DropdownFieldProps<V, Multiple extends boolean = false>\n  extends BaseFormFieldProps<Multiple extends true ? V[] : V>\n{\n  /**\n   * Available items for the dropdown\n   */\n  items: V[];\n\n  /**\n   * Converts an item to a display string. Defaults to `String()`.\n   */\n  itemToStringLabel?: (item: V) => string;\n\n  /**\n   * Returns a unique string key for a list item. Used as the React `key`.\n   * Falls back to the item's index when not provided.\n   */\n  itemToKey?: (item: V) => string;\n\n  /**\n   * Custom equality check for item values. Defaults to `Object.is`.\n   * Required when items are objects to ensure correct selection matching.\n   */\n  isItemEqual?: (a: V, b: V) => boolean;\n\n  /**\n   * Whether the dropdown allows searching/filtering.\n   * When true, renders a Combobox with a search input.\n   * When false (default), renders a Select dropdown.\n   */\n  isSearchable?: boolean;\n\n  /**\n   * Placeholder text shown when no value is selected.\n   */\n  placeholder?: string;\n\n  /**\n   * Whether multiple values can be selected\n   */\n  isMultiple?: Multiple;\n}\n\nexport interface FilePickerProps extends BaseFormFieldProps<File | File[]> {\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   * The text displayed when no file is selected.\n   *\n   * @default \"No file chosen\"\n   */\n  text?: string;\n\n  /**\n   * The text displayed on the browse button.\n   *\n   * @default \"Browse\"\n   */\n  buttonText?: string;\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  placeholder?: string;\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  placeholder?: string;\n}\n\n/**\n * Number input field props\n */\nexport interface NumberInputFieldProps extends BaseFormFieldProps<number> {\n  /**\n   * Minimum allowed value.\n   */\n  min?: number;\n\n  /**\n   * Maximum allowed value.\n   */\n  max?: number;\n\n  /**\n   * Step increment for the input. Used by the stepper buttons and ArrowUp/ArrowDown keyboard stepping.\n   *\n   * @default 1\n   */\n  step?: number;\n\n  /**\n   * Placeholder text shown when the input is empty.\n   */\n  placeholder?: string;\n}\n\n/**\n * Radio buttons field props\n */\nexport interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {\n  /**\n   * Available options for radio buttons.\n   *\n   * Values are compared by reference equality (`===`). When options contain\n   * non-primitive values, pass the same object references for `value` and\n   * the corresponding option entry.\n   */\n  options: Option<V>[];\n}\n\n/**\n * Option interface for radio button 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\n/**\n * Custom field props for user-defined renderers\n */\nexport interface CustomFieldProps<V> extends BaseFormFieldProps<V> {\n  /**\n   * Custom renderer function\n   */\n  customRenderer: (props: BaseFormFieldProps<V>) => React.ReactNode;\n}\n\nexport interface BaseFormFieldProps<V> {\n  /**\n   * The HTML `id` attribute for the field input element.\n   * Used for `<label htmlFor>` association.\n   */\n  id?: string;\n\n  /**\n   * The value of the form field\n   */\n  value: V | null;\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 | null) => 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 ActionMetadata.DataType.ObjectSet<\n    infer T\n  > ? ActionParam.ObjectSetType<T>\n  : ActionParameters<Q>[K][\"type\"] extends ActionMetadata.DataType.Struct<\n    infer T\n  > ? 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 *\n * Implemented as a distributed mapped type: switching on `fieldComponent`\n * narrows `fieldComponentProps` to the correct props type automatically.\n */\nexport type RendererFieldDefinition = {\n  [K in FieldComponent]: {\n    fieldKey: string;\n    fieldComponent: K;\n    fieldType?: FieldType;\n    label: string;\n    defaultValue?: unknown;\n    isRequired?: boolean;\n    placeholder?: string;\n    helperText?: string;\n    helperTextPlacement?: \"bottom\" | \"tooltip\";\n    fieldComponentProps: Omit<FormFieldPropsByType[K], \"value\" | \"onChange\">;\n  };\n}[FieldComponent];\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/browser/action-form/fields/FilePickerField.js

@@ -0,0 +1,119 @@
+/*
+ * Copyright 2026 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 { Button } from "@base-ui/react/button";
+import { Cross } from "@blueprintjs/icons";
+import classnames from "classnames";
+import React, { memo, useCallback, useRef } from "react";
+import styles from "./FilePickerField.module.css.js";
+export const FilePickerField = /*#__PURE__*/memo(function ({
+  id,
+  value,
+  onChange,
+  isMulti,
+  accept,
+  // TODO: implement maxSize validation in a follow-up
+  maxSize: _maxSize,
+  text = "No file chosen",
+  buttonText = "Browse"
+}) {
+  const inputRef = useRef(null);
+  const openFileDialog = useCallback(() => {
+    inputRef.current?.click();
+  }, []);
+  const handleInputChange = useCallback(event => {
+    const files = event.target.files;
+    if (files == null || files.length === 0) {
+      onChange?.(null);
+      return;
+    }
+    if (isMulti) {
+      onChange?.(Array.from(files));
+    } else {
+      onChange?.(files[0] ?? null);
+    }
+  }, [onChange, isMulti]);
+  const handleClear = useCallback(event => {
+    event.stopPropagation();
+    event.preventDefault();
+    onChange?.(null);
+    if (inputRef.current != null) {
+      inputRef.current.value = "";
+    }
+  }, [onChange]);
+  const handleKeyDown = useCallback(event => {
+    if (event.key === "Enter" || event.key === " ") {
+      event.preventDefault();
+      openFileDialog();
+    }
+  }, [openFileDialog]);
+  const displayText = getDisplayText(value);
+  const hasValue = displayText != null;
+  const acceptString = normalizeAccept(accept);
+  return (
+    /*#__PURE__*/
+    // The entire component is a single tab stop (tabIndex={0}).
+    // Text and Browse are <span>s (not buttons) so they don't create
+    // extra tab stops — clicks on them bubble up to the container's onClick.
+    // The clear button is the only inner interactive element and gets its
+    // own tab stop so keyboard users can clear the selection.
+    React.createElement("div", {
+      id: id,
+      className: styles.osdkFilePickerTrigger,
+      tabIndex: 0,
+      role: "button",
+      onClick: openFileDialog,
+      onKeyDown: handleKeyDown
+    }, /*#__PURE__*/React.createElement("input", {
+      ref: inputRef,
+      type: "file",
+      className: styles.osdkFilePickerHiddenInput,
+      multiple: isMulti,
+      accept: acceptString,
+      onChange: handleInputChange,
+      "aria-hidden": "true",
+      tabIndex: -1
+    }), /*#__PURE__*/React.createElement("span", {
+      className: classnames(styles.osdkFilePickerText, !hasValue && styles.osdkFilePickerPlaceholder)
+    }, displayText ?? text), hasValue &&
+    /*#__PURE__*/
+    // stopPropagation + preventDefault prevent the click from
+    // bubbling to the container's onClick which opens the file dialog.
+    React.createElement(Button, {
+      className: styles.osdkFilePickerClear,
+      onClick: handleClear,
+      "aria-label": "Clear selection"
+    }, /*#__PURE__*/React.createElement(Cross, null)), /*#__PURE__*/React.createElement("span", {
+      className: styles.osdkFilePickerBrowse
+    }, buttonText))
+  );
+});
+function normalizeAccept(accept) {
+  if (accept == null) {
+    return undefined;
+  }
+  return Array.isArray(accept) ? accept.join(",") : accept;
+}
+function getDisplayText(value) {
+  if (value == null) {
+    return undefined;
+  }
+  if (Array.isArray(value)) {
+    return value.map(f => f.name).join(", ");
+  }
+  return value.name;
+}
+//# sourceMappingURL=FilePickerField.js.map

package/build/browser/action-form/fields/FilePickerField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePickerField.js","names":["Button","Cross","classnames","React","memo","useCallback","useRef","styles","FilePickerField","id","value","onChange","isMulti","accept","maxSize","_maxSize","text","buttonText","inputRef","openFileDialog","current","click","handleInputChange","event","files","target","length","Array","from","handleClear","stopPropagation","preventDefault","handleKeyDown","key","displayText","getDisplayText","hasValue","acceptString","normalizeAccept","createElement","className","osdkFilePickerTrigger","tabIndex","role","onClick","onKeyDown","ref","type","osdkFilePickerHiddenInput","multiple","osdkFilePickerText","osdkFilePickerPlaceholder","osdkFilePickerClear","osdkFilePickerBrowse","undefined","isArray","join","map","f","name"],"sources":["FilePickerField.tsx"],"sourcesContent":["/*\n * Copyright 2026 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 { Button } from \"@base-ui/react/button\";\nimport { Cross } from \"@blueprintjs/icons\";\nimport classnames from \"classnames\";\nimport React, { memo, useCallback, useRef } from \"react\";\nimport type { FilePickerProps } from \"../FormFieldApi.js\";\nimport styles from \"./FilePickerField.module.css\";\n\nexport const FilePickerField: React.FC<FilePickerProps> = memo(\n  function FilePickerFieldFn({\n    id,\n    value,\n    onChange,\n    isMulti,\n    accept,\n    // TODO: implement maxSize validation in a follow-up\n    maxSize: _maxSize,\n    text = \"No file chosen\",\n    buttonText = \"Browse\",\n  }): React.ReactElement {\n    const inputRef = useRef<HTMLInputElement>(null);\n\n    const openFileDialog = useCallback(() => {\n      inputRef.current?.click();\n    }, []);\n\n    const handleInputChange = useCallback(\n      (event: React.ChangeEvent<HTMLInputElement>) => {\n        const files = event.target.files;\n        if (files == null || files.length === 0) {\n          onChange?.(null);\n          return;\n        }\n\n        if (isMulti) {\n          onChange?.(Array.from(files));\n        } else {\n          onChange?.(files[0] ?? null);\n        }\n      },\n      [onChange, isMulti],\n    );\n\n    const handleClear = useCallback(\n      (event: React.MouseEvent) => {\n        event.stopPropagation();\n        event.preventDefault();\n        onChange?.(null);\n        if (inputRef.current != null) {\n          inputRef.current.value = \"\";\n        }\n      },\n      [onChange],\n    );\n\n    const handleKeyDown = useCallback(\n      (event: React.KeyboardEvent) => {\n        if (event.key === \"Enter\" || event.key === \" \") {\n          event.preventDefault();\n          openFileDialog();\n        }\n      },\n      [openFileDialog],\n    );\n\n    const displayText = getDisplayText(value);\n    const hasValue = displayText != null;\n    const acceptString = normalizeAccept(accept);\n    return (\n      // The entire component is a single tab stop (tabIndex={0}).\n      // Text and Browse are <span>s (not buttons) so they don't create\n      // extra tab stops — clicks on them bubble up to the container's onClick.\n      // The clear button is the only inner interactive element and gets its\n      // own tab stop so keyboard users can clear the selection.\n      <div\n        id={id}\n        className={styles.osdkFilePickerTrigger}\n        tabIndex={0}\n        role=\"button\"\n        onClick={openFileDialog}\n        onKeyDown={handleKeyDown}\n      >\n        <input\n          ref={inputRef}\n          type=\"file\"\n          className={styles.osdkFilePickerHiddenInput}\n          multiple={isMulti}\n          accept={acceptString}\n          onChange={handleInputChange}\n          aria-hidden=\"true\"\n          tabIndex={-1}\n        />\n        <span\n          className={classnames(\n            styles.osdkFilePickerText,\n            !hasValue && styles.osdkFilePickerPlaceholder,\n          )}\n        >\n          {displayText ?? text}\n        </span>\n        {hasValue && (\n          // stopPropagation + preventDefault prevent the click from\n          // bubbling to the container's onClick which opens the file dialog.\n          <Button\n            className={styles.osdkFilePickerClear}\n            onClick={handleClear}\n            aria-label=\"Clear selection\"\n          >\n            <Cross />\n          </Button>\n        )}\n        <span className={styles.osdkFilePickerBrowse}>{buttonText}</span>\n      </div>\n    );\n  },\n);\n\nfunction normalizeAccept(\n  accept: string | string[] | undefined,\n): string | undefined {\n  if (accept == null) {\n    return undefined;\n  }\n  return Array.isArray(accept) ? accept.join(\",\") : accept;\n}\n\nfunction getDisplayText(value: File | File[] | null): string | undefined {\n  if (value == null) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((f) => f.name).join(\", \");\n  }\n  return value.name;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/action-form/fields/FilePickerField.module.css

@@ -0,0 +1,132 @@
+/*
+ * Copyright 2026 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.
+ */
+
+/* Outer wrapper — looks like an input field */
+.osdkFilePickerTrigger {
+  display: flex;
+  align-items: center;
+  width: 100%;
+  height: var(--osdk-file-picker-trigger-min-height);
+  border: var(--osdk-file-picker-trigger-border);
+  border-radius: var(--osdk-file-picker-trigger-border-radius);
+  background: var(--osdk-file-picker-trigger-bg);
+  font-family: var(--osdk-file-picker-trigger-font-family);
+  font-size: var(--osdk-file-picker-trigger-font-size);
+  box-sizing: border-box;
+  overflow: hidden;
+  transition:
+    background-color var(--osdk-file-picker-transition-duration)
+      var(--osdk-file-picker-transition-ease),
+    border-color var(--osdk-file-picker-transition-duration)
+      var(--osdk-file-picker-transition-ease);
+
+  &:hover {
+    background: var(--osdk-file-picker-trigger-bg-hover);
+  }
+
+  &:focus-visible {
+    border-color: var(--osdk-file-picker-trigger-border-color-focus);
+    outline: var(--osdk-file-picker-trigger-focus-width) solid
+      var(--osdk-file-picker-trigger-focus-color);
+    outline-offset: var(--osdk-file-picker-trigger-focus-offset);
+  }
+}
+
+/* Visually hidden file input */
+.osdkFilePickerHiddenInput {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* File name text (left section) */
+.osdkFilePickerText {
+  flex: 1;
+  padding: var(--osdk-file-picker-trigger-padding);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  text-align: left;
+  color: var(--osdk-file-picker-trigger-color);
+  cursor: pointer;
+  background: none;
+  border: none;
+  font-family: inherit;
+  font-size: inherit;
+}
+
+.osdkFilePickerPlaceholder {
+  color: var(--osdk-file-picker-trigger-placeholder-color);
+}
+
+/* Clear ✕ button */
+.osdkFilePickerClear {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: var(--osdk-file-picker-clear-size);
+  height: var(--osdk-file-picker-clear-size);
+  margin: var(--osdk-file-picker-clear-margin);
+  padding: 0;
+  border: none;
+  background: none;
+  color: var(--osdk-file-picker-clear-color);
+  cursor: pointer;
+  transition: color var(--osdk-file-picker-transition-duration)
+    var(--osdk-file-picker-transition-ease);
+
+  &:hover {
+    color: var(--osdk-file-picker-clear-color-hover);
+  }
+
+  &:focus-visible {
+    outline: var(--osdk-file-picker-trigger-focus-width) solid
+      var(--osdk-file-picker-trigger-focus-color);
+    border-radius: var(--osdk-surface-border-radius);
+  }
+}
+
+/* Browse label (right section) */
+.osdkFilePickerBrowse {
+  flex-shrink: 0;
+  align-self: stretch;
+  display: flex;
+  align-items: center;
+  padding: var(--osdk-file-picker-browse-padding);
+  border-left: var(--osdk-file-picker-browse-border-left);
+  background: var(--osdk-file-picker-browse-bg);
+  color: var(--osdk-file-picker-browse-color);
+  font-family: var(--osdk-file-picker-trigger-font-family);
+  font-size: var(--osdk-file-picker-trigger-font-size);
+  pointer-events: none;
+  transition: background-color var(--osdk-file-picker-transition-duration)
+    var(--osdk-file-picker-transition-ease);
+}
+
+.osdkFilePickerTrigger:hover .osdkFilePickerBrowse {
+  background-color: var(--osdk-file-picker-browse-bg-hover);
+}
+
+.osdkFilePickerTrigger:active .osdkFilePickerBrowse {
+  background-color: var(--osdk-file-picker-browse-bg-active);
+}

package/build/browser/action-form/fields/FilePickerField.module.css.js

@@ -0,0 +1,11 @@
+// CSS Module proxy for FilePickerField.module.css
+const styles = {
+  "osdkFilePickerTrigger": "FilePickerField-module__osdkFilePickerTrigger___xiODCPnX",
+  "osdkFilePickerHiddenInput": "FilePickerField-module__osdkFilePickerHiddenInput___HiJGgrUM",
+  "osdkFilePickerText": "FilePickerField-module__osdkFilePickerText___VbLe9-Bb",
+  "osdkFilePickerPlaceholder": "FilePickerField-module__osdkFilePickerPlaceholder___ntQ09iNR",
+  "osdkFilePickerClear": "FilePickerField-module__osdkFilePickerClear___SOf8mcYq",
+  "osdkFilePickerBrowse": "FilePickerField-module__osdkFilePickerBrowse___XurnxfvY"
+};
+
+export default styles;

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

@@ -20,6 +20,7 @@ import { FormField } from "../FormField.js";
 import { CustomField } from "./CustomField.js";
 import { DatetimePickerField } from "./DatetimePickerField.js";
 import { DropdownField } from "./DropdownField.js";
+import { FilePickerField } from "./FilePickerField.js";
 import { NumberInputField } from "./NumberInputField.js";
 import { RadioButtonsField } from "./RadioButtonsField.js";
 import { TextAreaField } from "./TextAreaField.js";
@@ -96,12 +97,31 @@ function renderFieldComponent(fieldDefinition, value, onChange) {
         placeholder: fieldDefinition.placeholder
       }, fieldDefinition.fieldComponentProps));
     case "FILE_PICKER":
+      return /*#__PURE__*/React.createElement(FilePickerField, _extends({
+        id: fieldDefinition.fieldKey,
+        value: coerceToFileValue(value),
+        onChange: onChange
+      }, fieldDefinition.fieldComponentProps));
     case "OBJECT_SET":
       return /*#__PURE__*/React.createElement("div", null, "Unsupported field type: ", fieldDefinition.fieldComponent);
     default:
       return assertUnreachableFieldComponent(fieldDefinition);
   }
 }
+
+// TODO: Move and share with `coerceFieldValue`
+function isFileArray(value) {
+  return value.every(v => v instanceof File);
+}
+function coerceToFileValue(value) {
+  if (value instanceof File) {
+    return value;
+  }
+  if (Array.isArray(value) && isFileArray(value)) {
+    return value;
+  }
+  return null;
+}
 function assertUnreachableFieldComponent(value) {
   throw new Error(`Unhandled field component: ${String(value)}`);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"FormFieldRenderer.js","names":["React","memo","FormField","CustomField","DatetimePickerField","DropdownField","NumberInputField","RadioButtonsField","TextAreaField","TextInputField","FormFieldRenderer","fieldDefinition","value","onFieldValueChange","label","isRequired","helperText","helperTextPlacement","createElement","fieldKey","undefined","renderFieldComponent","onChange","fieldComponent","_extends","id","String","placeholder","fieldComponentProps","Date","assertUnreachableFieldComponent","Error"],"sources":["FormFieldRenderer.tsx"],"sourcesContent":["/*\n * Copyright 2026 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 { FormField } from \"../FormField.js\";\nimport type { RendererFieldDefinition } from \"../FormFieldApi.js\";\nimport { CustomField } from \"./CustomField.js\";\nimport { DatetimePickerField } from \"./DatetimePickerField.js\";\nimport { DropdownField } from \"./DropdownField.js\";\nimport { NumberInputField } from \"./NumberInputField.js\";\nimport { RadioButtonsField } from \"./RadioButtonsField.js\";\nimport { TextAreaField } from \"./TextAreaField.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      <FormField\n        label={label}\n        isRequired={isRequired}\n        fieldKey={fieldDefinition.fieldKey}\n        helperText={helperTextPlacement !== \"tooltip\" ? helperText : undefined}\n      >\n        {renderFieldComponent(fieldDefinition, value, onFieldValueChange)}\n      </FormField>\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      return (\n        <TextInputField\n          id={fieldDefinition.fieldKey}\n          value={value != null ? String(value) : \"\"}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"TEXT_AREA\":\n      return (\n        <TextAreaField\n          id={fieldDefinition.fieldKey}\n          value={value != null ? String(value) : \"\"}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"DROPDOWN\": {\n      return (\n        <DropdownField\n          value={value}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    }\n    case \"DATETIME_PICKER\":\n      return (\n        <DatetimePickerField\n          id={fieldDefinition.fieldKey}\n          placeholder={fieldDefinition.placeholder}\n          // TODO: Use coerceFieldValue\n          value={value instanceof Date ? value : null}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"RADIO_BUTTONS\":\n      return (\n        <RadioButtonsField\n          id={fieldDefinition.fieldKey}\n          value={value}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"CUSTOM\":\n      return (\n        <CustomField\n          id={fieldDefinition.fieldKey}\n          value={value}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"NUMBER_INPUT\":\n      // TODO: Use coerceFieldValue\n      return (\n        <NumberInputField\n          id={fieldDefinition.fieldKey}\n          value={typeof value === \"number\" ? value : null}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"FILE_PICKER\":\n    case \"OBJECT_SET\":\n      return <div>Unsupported field type: {fieldDefinition.fieldComponent}\n      </div>;\n    default:\n      return assertUnreachableFieldComponent(fieldDefinition);\n  }\n}\n\nfunction assertUnreachableFieldComponent(value: never): never {\n  throw new Error(`Unhandled field component: ${String(value)}`);\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"FormFieldRenderer.js","names":["React","memo","FormField","CustomField","DatetimePickerField","DropdownField","FilePickerField","NumberInputField","RadioButtonsField","TextAreaField","TextInputField","FormFieldRenderer","fieldDefinition","value","onFieldValueChange","label","isRequired","helperText","helperTextPlacement","createElement","fieldKey","undefined","renderFieldComponent","onChange","fieldComponent","_extends","id","String","placeholder","fieldComponentProps","Date","coerceToFileValue","assertUnreachableFieldComponent","isFileArray","every","v","File","Array","isArray","Error"],"sources":["FormFieldRenderer.tsx"],"sourcesContent":["/*\n * Copyright 2026 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 { FormField } from \"../FormField.js\";\nimport type { RendererFieldDefinition } from \"../FormFieldApi.js\";\nimport { CustomField } from \"./CustomField.js\";\nimport { DatetimePickerField } from \"./DatetimePickerField.js\";\nimport { DropdownField } from \"./DropdownField.js\";\nimport { FilePickerField } from \"./FilePickerField.js\";\nimport { NumberInputField } from \"./NumberInputField.js\";\nimport { RadioButtonsField } from \"./RadioButtonsField.js\";\nimport { TextAreaField } from \"./TextAreaField.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      <FormField\n        label={label}\n        isRequired={isRequired}\n        fieldKey={fieldDefinition.fieldKey}\n        helperText={helperTextPlacement !== \"tooltip\" ? helperText : undefined}\n      >\n        {renderFieldComponent(fieldDefinition, value, onFieldValueChange)}\n      </FormField>\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      return (\n        <TextInputField\n          id={fieldDefinition.fieldKey}\n          value={value != null ? String(value) : \"\"}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"TEXT_AREA\":\n      return (\n        <TextAreaField\n          id={fieldDefinition.fieldKey}\n          value={value != null ? String(value) : \"\"}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"DROPDOWN\": {\n      return (\n        <DropdownField\n          value={value}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    }\n    case \"DATETIME_PICKER\":\n      return (\n        <DatetimePickerField\n          id={fieldDefinition.fieldKey}\n          placeholder={fieldDefinition.placeholder}\n          // TODO: Use coerceFieldValue\n          value={value instanceof Date ? value : null}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"RADIO_BUTTONS\":\n      return (\n        <RadioButtonsField\n          id={fieldDefinition.fieldKey}\n          value={value}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"CUSTOM\":\n      return (\n        <CustomField\n          id={fieldDefinition.fieldKey}\n          value={value}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"NUMBER_INPUT\":\n      // TODO: Use coerceFieldValue\n      return (\n        <NumberInputField\n          id={fieldDefinition.fieldKey}\n          value={typeof value === \"number\" ? value : null}\n          onChange={onChange}\n          placeholder={fieldDefinition.placeholder}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"FILE_PICKER\":\n      return (\n        <FilePickerField\n          id={fieldDefinition.fieldKey}\n          value={coerceToFileValue(value)}\n          onChange={onChange}\n          {...fieldDefinition.fieldComponentProps}\n        />\n      );\n    case \"OBJECT_SET\":\n      return <div>Unsupported field type: {fieldDefinition.fieldComponent}\n      </div>;\n    default:\n      return assertUnreachableFieldComponent(fieldDefinition);\n  }\n}\n\n// TODO: Move and share with `coerceFieldValue`\nfunction isFileArray(value: unknown[]): value is File[] {\n  return value.every((v) => v instanceof File);\n}\n\nfunction coerceToFileValue(value: unknown): File | File[] | null {\n  if (value instanceof File) {\n    return value;\n  }\n  if (Array.isArray(value) && isFileArray(value)) {\n    return value;\n  }\n  return null;\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;AACnC,SAASC,SAAS,QAAQ,iBAAiB;AAE3C,SAASC,WAAW,QAAQ,kBAAkB;AAC9C,SAASC,mBAAmB,QAAQ,0BAA0B;AAC9D,SAASC,aAAa,QAAQ,oBAAoB;AAClD,SAASC,eAAe,QAAQ,sBAAsB;AACtD,SAASC,gBAAgB,QAAQ,uBAAuB;AACxD,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,aAAa,QAAQ,oBAAoB;AAClD,SAASC,cAAc,QAAQ,qBAAqB;AAQpD,OAAO,MAAMC,iBAAmD,gBAAGV,IAAI,CACrE,UAA6B;EAC3BW,eAAe;EACfC,KAAK;EACLC;AACsB,CAAC,EAAsB;EAC7C,MAAM;IAAEC,KAAK;IAAEC,UAAU;IAAEC,UAAU;IAAEC;EAAoB,CAAC,GAC1DN,eAAe;EAEjB,oBACEZ,KAAA,CAAAmB,aAAA,CAACjB,SAAS;IACRa,KAAK,EAAEA,KAAM;IACbC,UAAU,EAAEA,UAAW;IACvBI,QAAQ,EAAER,eAAe,CAACQ,QAAS;IACnCH,UAAU,EAAEC,mBAAmB,KAAK,SAAS,GAAGD,UAAU,GAAGI;EAAU,GAEtEC,oBAAoB,CAACV,eAAe,EAAEC,KAAK,EAAEC,kBAAkB,CACvD,CAAC;AAEhB,CACF,CAAC;AAED,SAASQ,oBAAoBA,CAC3BV,eAAwC,EACxCC,KAAc,EACdU,QAAkC,EACd;EACpB,QAAQX,eAAe,CAACY,cAAc;IACpC,KAAK,YAAY;MACf,oBACExB,KAAA,CAAAmB,aAAA,CAACT,cAAc,EAAAe,QAAA;QACbC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BP,KAAK,EAAEA,KAAK,IAAI,IAAI,GAAGc,MAAM,CAACd,KAAK,CAAC,GAAG,EAAG;QAC1CU,QAAQ,EAAEA,QAAS;QACnBK,WAAW,EAAEhB,eAAe,CAACgB;MAAY,GACrChB,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,WAAW;MACd,oBACE7B,KAAA,CAAAmB,aAAA,CAACV,aAAa,EAAAgB,QAAA;QACZC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BP,KAAK,EAAEA,KAAK,IAAI,IAAI,GAAGc,MAAM,CAACd,KAAK,CAAC,GAAG,EAAG;QAC1CU,QAAQ,EAAEA,QAAS;QACnBK,WAAW,EAAEhB,eAAe,CAACgB;MAAY,GACrChB,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,UAAU;MAAE;QACf,oBACE7B,KAAA,CAAAmB,aAAA,CAACd,aAAa,EAAAoB,QAAA;UACZZ,KAAK,EAAEA,KAAM;UACbU,QAAQ,EAAEA,QAAS;UACnBK,WAAW,EAAEhB,eAAe,CAACgB;QAAY,GACrChB,eAAe,CAACiB,mBAAmB,CACxC,CAAC;MAEN;IACA,KAAK,iBAAiB;MACpB,oBACE7B,KAAA,CAAAmB,aAAA,CAACf,mBAAmB,EAAAqB,QAAA;QAClBC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BQ,WAAW,EAAEhB,eAAe,CAACgB;QAC7B;QAAA;QACAf,KAAK,EAAEA,KAAK,YAAYiB,IAAI,GAAGjB,KAAK,GAAG,IAAK;QAC5CU,QAAQ,EAAEA;MAAS,GACfX,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,eAAe;MAClB,oBACE7B,KAAA,CAAAmB,aAAA,CAACX,iBAAiB,EAAAiB,QAAA;QAChBC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BP,KAAK,EAAEA,KAAM;QACbU,QAAQ,EAAEA;MAAS,GACfX,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,QAAQ;MACX,oBACE7B,KAAA,CAAAmB,aAAA,CAAChB,WAAW,EAAAsB,QAAA;QACVC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BP,KAAK,EAAEA,KAAM;QACbU,QAAQ,EAAEA;MAAS,GACfX,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,cAAc;MACjB;MACA,oBACE7B,KAAA,CAAAmB,aAAA,CAACZ,gBAAgB,EAAAkB,QAAA;QACfC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BP,KAAK,EAAE,OAAOA,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAG,IAAK;QAChDU,QAAQ,EAAEA,QAAS;QACnBK,WAAW,EAAEhB,eAAe,CAACgB;MAAY,GACrChB,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,aAAa;MAChB,oBACE7B,KAAA,CAAAmB,aAAA,CAACb,eAAe,EAAAmB,QAAA;QACdC,EAAE,EAAEd,eAAe,CAACQ,QAAS;QAC7BP,KAAK,EAAEkB,iBAAiB,CAAClB,KAAK,CAAE;QAChCU,QAAQ,EAAEA;MAAS,GACfX,eAAe,CAACiB,mBAAmB,CACxC,CAAC;IAEN,KAAK,YAAY;MACf,oBAAO7B,KAAA,CAAAmB,aAAA,cAAK,0BAAwB,EAACP,eAAe,CAACY,cAChD,CAAC;IACR;MACE,OAAOQ,+BAA+B,CAACpB,eAAe,CAAC;EAC3D;AACF;;AAEA;AACA,SAASqB,WAAWA,CAACpB,KAAgB,EAAmB;EACtD,OAAOA,KAAK,CAACqB,KAAK,CAAEC,CAAC,IAAKA,CAAC,YAAYC,IAAI,CAAC;AAC9C;AAEA,SAASL,iBAAiBA,CAAClB,KAAc,EAAwB;EAC/D,IAAIA,KAAK,YAAYuB,IAAI,EAAE;IACzB,OAAOvB,KAAK;EACd;EACA,IAAIwB,KAAK,CAACC,OAAO,CAACzB,KAAK,CAAC,IAAIoB,WAAW,CAACpB,KAAK,CAAC,EAAE;IAC9C,OAAOA,KAAK;EACd;EACA,OAAO,IAAI;AACb;AAEA,SAASmB,+BAA+BA,CAACnB,KAAY,EAAS;EAC5D,MAAM,IAAI0B,KAAK,CAAC,8BAA8BZ,MAAM,CAACd,KAAK,CAAC,EAAE,CAAC;AAChE","ignoreList":[]}

package/build/browser/object-table/ObjectTableApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectTableApi.js","names":[],"sources":["ObjectTableApi.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  CompileTimeMetadata,\n  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { QueryParameterType } from \"@osdk/client/unstable-do-not-use\";\nimport type * as React from \"react\";\nimport type { CellEditInfo } from \"./utils/types.js\";\n\nexport type ColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> = {\n  locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>;\n\n  /**\n   * @default true\n   */\n  isVisible?: boolean;\n\n  /**\n   * @default none\n   */\n  pinned?: \"left\" | \"right\" | \"none\";\n  width?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  resizable?: boolean;\n  orderable?: boolean;\n  filterable?: boolean;\n  editable?: boolean;\n\n  /**\n   * Additional function to validate the cell value during edit\n   *\n   * @param value the current cell value\n   * @returns a promise that resolves to an error message string if validation fails, or undefined if validation succeeds\n   */\n  validateEdit?: (\n    value: unknown,\n  ) => Promise<string | undefined>;\n\n  renderCell?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>,\n  ) => React.ReactNode;\n\n  /**\n   * If provided, this will be used in the column header.\n   * If both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   * columnName will still be used in other parts where the column name is displayed.\n   *\n   * If not provided,\n   * for a property column, the property displayName will be used\n   * for other columns, the id will be used.\n   */\n  columnName?: string;\n\n  /**\n   * If provided, this will be used to render the header component.\n   * When both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   */\n  renderHeader?: () => React.ReactNode;\n};\n\nexport type ExtractQueryParameters<\n  Q extends QueryDefinition,\n> = CompileTimeMetadata<Q>[\"parameters\"] extends Record<string, never>\n  ? undefined\n  : QueryParameterType<CompileTimeMetadata<Q>[\"parameters\"]>;\n\nexport interface PropertyColumnLocator<Q extends ObjectOrInterfaceDefinition> {\n  type: \"property\";\n  id: PropertyKeys<Q>;\n}\n\nexport interface FunctionColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * This is equivalent to workshop's function-backed columns.\n   * The function needs to meet the specifications stated in https://www.palantir.com/docs/foundry/workshop/widgets-object-table/#function-backed-columns\n   */\n  type: \"function\";\n  id: keyof FunctionColumns;\n  queryDefinition: FunctionColumns[keyof FunctionColumns];\n\n  /**\n   * The function will be called with the current object set to get the input parameters for the function query.\n   * @param objectSet - The current object set.\n   * @returns - The function's input parameters including the object set.\n   */\n  getFunctionParams: (\n    objectSet: ObjectSet<Q, RDPs>,\n  ) => ExtractQueryParameters<FunctionColumns[keyof FunctionColumns]>;\n\n  /**\n   * Function to generate keys for looking up results in the FunctionsMap.\n   * @param object - The object instance\n   * @returns - The key to use for looking up this object's result in the FunctionsMap\n   */\n  getKey: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => string;\n\n  /**\n   * Function to extract the cell value from the raw cell data returned by the function.\n   * This is useful when functions return custom types with multiple properties.\n   * @param cellData - The raw data returned by the function for this object\n   * @returns - The value to display in the cell\n   */\n  getValue?: (cellData: unknown) => unknown;\n}\n\nexport interface RdpColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  type: \"rdp\";\n  id: keyof RDPs;\n  creator: DerivedProperty.Creator<Q, RDPs[keyof RDPs]>;\n}\n\nexport interface CustomColumnLocator {\n  type: \"custom\";\n  id: string;\n}\n\nexport type ColumnDefinitionLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> =\n  | PropertyColumnLocator<Q>\n  | FunctionColumnLocator<Q, RDPs, FunctionColumns>\n  | RdpColumnLocator<Q, RDPs>\n  | CustomColumnLocator;\n\nexport interface ObjectTableProps<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * The object or interface type of the object\n   * If objectSet is not provided, objects will be fetched based on this type.\n   */\n  objectType: Q;\n\n  /**\n   * The set of objects to show in the table.\n   * If provided and the objectType is not an interface, the table will use objectSet to fetch objects instead of fetching based on objectType.\n   */\n  objectSet?: ObjectSet<Q>;\n\n  objectSetOptions?: ObjectSetOptions<Q>;\n\n  /**\n   * Ordered list of column definitions to show in the table\n   *\n   * If not provided, all of the properties of the object type will be shown in default order.\n   */\n  columnDefinitions?: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>;\n\n  /**\n   * Whether the table is filterable by the user.\n   *\n   * @default true\n   */\n  enableFiltering?: boolean;\n\n  /**\n   * The current where clause to filter the objects in the table.\n   * If provided, the filter is controlled.\n   */\n  filter?: WhereClause<Q, RDPs>;\n\n  /**\n   * Called when the where clause is changed.\n   * Required when filter is controlled.\n   *\n   * @param newWhere The new where clause\n   */\n  onFilterChanged?: (newWhere: WhereClause<Q, RDPs>) => void;\n\n  /**\n   * Whether the table is sortable by the user.\n   *\n   * @default true\n   */\n  enableOrdering?: boolean;\n\n  /**\n   * Whether columns can be pinned by the user.\n   *\n   * @default true\n   */\n  enableColumnPinning?: boolean;\n\n  /**\n   * Whether columns can be resized by the user.\n   *\n   * @default true\n   */\n  enableColumnResizing?: boolean;\n\n  /**\n   * Whether the column configuration dialog for column visibility and ordering is available to the user.\n   *\n   * @default true\n   */\n  enableColumnConfig?: boolean;\n\n  /**\n   * Controls the edit mode behavior of the table.\n   * - \"always\": Editable cells are immediately in edit mode on row clicked.\n   * - \"manual\": User can toggle edit mode on/off via the Edit Table button.\n   *\n   * @default \"manual\"\n   */\n  editMode?: \"always\" | \"manual\";\n\n  /**\n   * The default order by clause to sort the objects in the table.\n   * If provided without orderBy prop, the sorting is uncontrolled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  defaultOrderBy?: Array<{\n    property: PropertyKeys<Q>;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * The current order by clause to sort the objects in the table.\n   * If provided, the sorting is controlled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  orderBy?: Array<{\n    property: PropertyKeys<Q>;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * Called when the order by clause is changed.\n   * Required when sorting is controlled.\n   *\n   * @param newOrderBy The new order by clause\n   */\n  onOrderByChanged?: (\n    newOrderBy: Array<{\n      property: PropertyKeys<Q>;\n      direction: \"asc\" | \"desc\";\n    }>,\n  ) => void;\n\n  /**\n   * Called after the value of a cell is edited and committed by the user.\n   *\n   * @param info An object containing details about the cell that was edited,\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   */\n  onCellValueChanged?: (\n    info: CellEditInfo<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      unknown\n    >,\n  ) => void;\n\n  /**\n   * If provided, the button Submit Edits will be shown in the table\n   *\n   * @param edits an array of edit info containing details about the edited cells\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   * @return a promise that resolves to true if the edits were successfully submitted\n   */\n  onSubmitEdits?: (edits: CellEditInfo<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    unknown\n  >[]) => Promise<boolean>;\n\n  /**\n   * Called when the column visibility or ordering changed.\n   *\n   * If provided, the table will allow the user to show/hide columns.\n   *\n   * @param newStates The columns sorted in their display order in the table and their visibility state.\n   */\n  onColumnVisibilityChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      isVisible: boolean;\n    }>,\n  ) => void;\n\n  /**\n   * Called when the pinned columns change.\n   *\n   * If provided, the table will allow the user to pin/unpin columns.\n   *\n   * @param newStates The new list of column pin states\n   */\n  onColumnsPinnedChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      pinned: \"left\" | \"right\" | \"none\";\n    }>,\n  ) => void;\n\n  /**\n   * Called when a column is resized.\n   *\n   * @param columnId The ID of the resized column\n   * @param newWidth The new width of the column. When newWidth = null, the column size is reset.\n   */\n  onColumnResize?: (\n    columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns,\n    newWidth: number | null,\n  ) => void;\n\n  /**\n   * Called when a row is clicked.\n   *\n   * @param object The object representing the clicked row\n   */\n  onRowClick?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => void;\n\n  /**\n   * Selection mode for the table rows.\n   *\n   * If multiple, a checkbox will be shown for each row to allow selecting multiple rows\n   * as well as a top-level checkbox in the header to select all rows.\n   *\n   * @default \"none\"\n   */\n  selectionMode?: \"single\" | \"multiple\" | \"none\";\n\n  /**\n   * The currently selected rows in the table.\n   * If provided, the row selection is controlled.\n   */\n  selectedRows?: PrimaryKeyType<Q>[];\n\n  /**\n   * Indicates whether all rows are selected in controlled mode.\n   * When true, the table will show all rows as selected regardless of the selectedRows array.\n   */\n  isAllSelected?: boolean;\n\n  /**\n   * Called when the row selection changes.\n   * Required when row selection is controlled.\n   *\n   * @param selectedRowIds The primary keys of currently selected rows\n   * @param isSelectAll Whether the change was triggered by a \"select all\" action. Defaults to false\n   */\n  onRowSelection?: (\n    selectedRowIds: PrimaryKeyType<Q>[],\n    isSelectAll?: boolean,\n  ) => void;\n  /**\n   * If provided, will render this context menu when right clicking on a cell\n   */\n  renderCellContextMenu?: (\n    row: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    cellValue: unknown,\n  ) => React.ReactNode;\n\n  /**\n   * The height of each row in pixels.\n   *\n   * @default 40\n   */\n  rowHeight?: number;\n\n  className?: string;\n}\n\nexport interface ObjectSetOptions<\n  Q extends ObjectOrInterfaceDefinition,\n> {\n  /**\n   * Object sets to union with\n   */\n  union?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to intersect with\n   */\n  intersect?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to subtract from\n   */\n  subtract?: ObjectSet<Q>[];\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ObjectTableApi.js","names":[],"sources":["ObjectTableApi.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  CompileTimeMetadata,\n  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  ObjectSet,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n  QueryDefinition,\n  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { QueryParameterType } from \"@osdk/client/unstable-do-not-use\";\nimport type * as React from \"react\";\nimport type { CellEditInfo } from \"./utils/types.js\";\n\nexport type ColumnDefinition<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> = {\n  locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>;\n\n  /**\n   * @default true\n   */\n  isVisible?: boolean;\n\n  /**\n   * @default none\n   */\n  pinned?: \"left\" | \"right\" | \"none\";\n  width?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  resizable?: boolean;\n  orderable?: boolean;\n  filterable?: boolean;\n  editable?: boolean;\n\n  /**\n   * Additional function to validate the cell value during edit\n   *\n   * @param value the current cell value\n   * @returns a promise that resolves to an error message string if validation fails, or undefined if validation succeeds\n   */\n  validateEdit?: (\n    value: unknown,\n  ) => Promise<string | undefined>;\n\n  renderCell?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    locator: ColumnDefinitionLocator<Q, RDPs, FunctionColumns>,\n  ) => React.ReactNode;\n\n  /**\n   * If provided, this will be used in the column header.\n   * If both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   * columnName will still be used in other parts where the column name is displayed.\n   *\n   * If not provided,\n   * for a property column, the property displayName will be used\n   * for other columns, the id will be used.\n   */\n  columnName?: string;\n\n  /**\n   * If provided, this will be used to render the header component.\n   * When both columnName and renderHeader are provided, renderHeader will take precedence in the table header.\n   */\n  renderHeader?: () => React.ReactNode;\n};\n\nexport type ExtractQueryParameters<\n  Q extends QueryDefinition,\n> = CompileTimeMetadata<Q>[\"parameters\"] extends Record<string, never>\n  ? undefined\n  : QueryParameterType<CompileTimeMetadata<Q>[\"parameters\"]>;\n\nexport interface PropertyColumnLocator<Q extends ObjectOrInterfaceDefinition> {\n  type: \"property\";\n  id: PropertyKeys<Q>;\n}\n\nexport interface FunctionColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * This is equivalent to workshop's function-backed columns.\n   * The function needs to meet the specifications stated in https://www.palantir.com/docs/foundry/workshop/widgets-object-table/#function-backed-columns\n   */\n  type: \"function\";\n  id: keyof FunctionColumns;\n  queryDefinition: FunctionColumns[keyof FunctionColumns];\n\n  /**\n   * The function will be called with the current object set to get the input parameters for the function query.\n   * @param objectSet - The current object set.\n   * @returns - The function's input parameters including the object set.\n   */\n  getFunctionParams: (\n    objectSet: ObjectSet<Q, RDPs>,\n  ) => ExtractQueryParameters<FunctionColumns[keyof FunctionColumns]>;\n\n  /**\n   * Function to generate keys for looking up results in the FunctionsMap.\n   * @param object - The object instance\n   * @returns - The key to use for looking up this object's result in the FunctionsMap\n   */\n  getKey: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => string;\n\n  /**\n   * Function to extract the cell value from the raw cell data returned by the function.\n   * This is useful when functions return custom types with multiple properties.\n   * @param cellData - The raw data returned by the function for this object\n   * @returns - The value to display in the cell\n   */\n  getValue?: (cellData?: unknown) => unknown;\n\n  /**\n   * Minimum time between re-fetches of the same function with the same parameters, in milliseconds.\n   * Defaults to 5 minutes to maximize cache hits\n   * @default 300_000 (5 minutes)\n   */\n  dedupeIntervalMs?: number;\n}\n\nexport interface RdpColumnLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n> {\n  type: \"rdp\";\n  id: keyof RDPs;\n  creator: DerivedProperty.Creator<Q, RDPs[keyof RDPs]>;\n}\n\nexport interface CustomColumnLocator {\n  type: \"custom\";\n  id: string;\n}\n\nexport type ColumnDefinitionLocator<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> =\n  | PropertyColumnLocator<Q>\n  | FunctionColumnLocator<Q, RDPs, FunctionColumns>\n  | RdpColumnLocator<Q, RDPs>\n  | CustomColumnLocator;\n\nexport interface ObjectTableProps<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = Record<string, never>,\n  FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<\n    string,\n    never\n  >,\n> {\n  /**\n   * The object or interface type of the object\n   * If objectSet is not provided, objects will be fetched based on this type.\n   */\n  objectType: Q;\n\n  /**\n   * The set of objects to show in the table.\n   * If provided and the objectType is not an interface, the table will use objectSet to fetch objects instead of fetching based on objectType.\n   */\n  objectSet?: ObjectSet<Q>;\n\n  objectSetOptions?: ObjectSetOptions<Q>;\n\n  /**\n   * Ordered list of column definitions to show in the table\n   *\n   * If not provided, all of the properties of the object type will be shown in default order.\n   */\n  columnDefinitions?: Array<ColumnDefinition<Q, RDPs, FunctionColumns>>;\n\n  /**\n   * Whether the table is filterable by the user.\n   *\n   * @default true\n   */\n  enableFiltering?: boolean;\n\n  /**\n   * The current where clause to filter the objects in the table.\n   * If provided, the filter is controlled.\n   */\n  filter?: WhereClause<Q, RDPs>;\n\n  /**\n   * Called when the where clause is changed.\n   * Required when filter is controlled.\n   *\n   * @param newWhere The new where clause\n   */\n  onFilterChanged?: (newWhere: WhereClause<Q, RDPs>) => void;\n\n  /**\n   * Whether the table is sortable by the user.\n   *\n   * @default true\n   */\n  enableOrdering?: boolean;\n\n  /**\n   * Whether columns can be pinned by the user.\n   *\n   * @default true\n   */\n  enableColumnPinning?: boolean;\n\n  /**\n   * Whether columns can be resized by the user.\n   *\n   * @default true\n   */\n  enableColumnResizing?: boolean;\n\n  /**\n   * Whether the column configuration dialog for column visibility and ordering is available to the user.\n   *\n   * @default true\n   */\n  enableColumnConfig?: boolean;\n\n  /**\n   * Controls the edit mode behavior of the table.\n   * - \"always\": Editable cells are immediately in edit mode on row clicked.\n   * - \"manual\": User can toggle edit mode on/off via the Edit Table button.\n   *\n   * @default \"manual\"\n   */\n  editMode?: \"always\" | \"manual\";\n\n  /**\n   * The default order by clause to sort the objects in the table.\n   * If provided without orderBy prop, the sorting is uncontrolled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  defaultOrderBy?: Array<{\n    property: PropertyKeys<Q>;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * The current order by clause to sort the objects in the table.\n   * If provided, the sorting is controlled.\n   * If both orderBy and defaultOrderBy are provided, orderBy takes precedence.\n   */\n  orderBy?: Array<{\n    property: PropertyKeys<Q>;\n    direction: \"asc\" | \"desc\";\n  }>;\n\n  /**\n   * Called when the order by clause is changed.\n   * Required when sorting is controlled.\n   *\n   * @param newOrderBy The new order by clause\n   */\n  onOrderByChanged?: (\n    newOrderBy: Array<{\n      property: PropertyKeys<Q>;\n      direction: \"asc\" | \"desc\";\n    }>,\n  ) => void;\n\n  /**\n   * Called after the value of a cell is edited and committed by the user.\n   *\n   * @param info An object containing details about the cell that was edited,\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   */\n  onCellValueChanged?: (\n    info: CellEditInfo<\n      Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n      unknown\n    >,\n  ) => void;\n\n  /**\n   * If provided, the button Submit Edits will be shown in the table\n   *\n   * @param edits an array of edit info containing details about the edited cells\n   * including the rowId, columnId, new and old values, and the row data before the edit\n   * @return a promise that resolves to true if the edits were successfully submitted\n   */\n  onSubmitEdits?: (edits: CellEditInfo<\n    Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    unknown\n  >[]) => Promise<boolean>;\n\n  /**\n   * Called when the column visibility or ordering changed.\n   *\n   * If provided, the table will allow the user to show/hide columns.\n   *\n   * @param newStates The columns sorted in their display order in the table and their visibility state.\n   */\n  onColumnVisibilityChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      isVisible: boolean;\n    }>,\n  ) => void;\n\n  /**\n   * Called when the pinned columns change.\n   *\n   * If provided, the table will allow the user to pin/unpin columns.\n   *\n   * @param newStates The new list of column pin states\n   */\n  onColumnsPinnedChanged?: (\n    newStates: Array<{\n      columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns;\n      pinned: \"left\" | \"right\" | \"none\";\n    }>,\n  ) => void;\n\n  /**\n   * Called when a column is resized.\n   *\n   * @param columnId The ID of the resized column\n   * @param newWidth The new width of the column. When newWidth = null, the column size is reset.\n   */\n  onColumnResize?: (\n    columnId: PropertyKeys<Q> | keyof RDPs | keyof FunctionColumns,\n    newWidth: number | null,\n  ) => void;\n\n  /**\n   * Called when a row is clicked.\n   *\n   * @param object The object representing the clicked row\n   */\n  onRowClick?: (\n    object: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n  ) => void;\n\n  /**\n   * Selection mode for the table rows.\n   *\n   * If multiple, a checkbox will be shown for each row to allow selecting multiple rows\n   * as well as a top-level checkbox in the header to select all rows.\n   *\n   * @default \"none\"\n   */\n  selectionMode?: \"single\" | \"multiple\" | \"none\";\n\n  /**\n   * The currently selected rows in the table.\n   * If provided, the row selection is controlled.\n   */\n  selectedRows?: PrimaryKeyType<Q>[];\n\n  /**\n   * Indicates whether all rows are selected in controlled mode.\n   * When true, the table will show all rows as selected regardless of the selectedRows array.\n   */\n  isAllSelected?: boolean;\n\n  /**\n   * Called when the row selection changes.\n   * Required when row selection is controlled.\n   *\n   * @param selectedRowIds The primary keys of currently selected rows\n   * @param isSelectAll Whether the change was triggered by a \"select all\" action. Defaults to false\n   */\n  onRowSelection?: (\n    selectedRowIds: PrimaryKeyType<Q>[],\n    isSelectAll?: boolean,\n  ) => void;\n  /**\n   * If provided, will render this context menu when right clicking on a cell\n   */\n  renderCellContextMenu?: (\n    row: Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>,\n    cellValue: unknown,\n  ) => React.ReactNode;\n\n  /**\n   * The height of each row in pixels.\n   *\n   * @default 40\n   */\n  rowHeight?: number;\n\n  className?: string;\n}\n\nexport interface ObjectSetOptions<\n  Q extends ObjectOrInterfaceDefinition,\n> {\n  /**\n   * Object sets to union with\n   */\n  union?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to intersect with\n   */\n  intersect?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to subtract from\n   */\n  subtract?: ObjectSet<Q>[];\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/object-table/hooks/useFunctionColumnsData.js

@@ -14,9 +14,13 @@
  * limitations under the License.
  */
 
-import { useOsdkFunctions } from "@osdk/react/unstable-do-not-use";
+import { useOsdkFunctions } from "@osdk/react/experimental";
 import { useMemo } from "react";
 import { createAsyncCellData } from "../utils/AsyncCellData.js";
+// Function column data is readOnly and can be cached aggressively,
+// so we set a longer dedupe interval to maximize cache hits
+export const DEFAULT_DEDUPE_INTERVAL_MS = 300_000; // 5 minutes
+
 export function useFunctionColumnsData(objectSet, objects, columnDefinitions) {
   // Function column configurations grouped by unique query definition
   const functionColumnConfigs = useMemo(() => getFunctionColumnConfigs(columnDefinitions), [columnDefinitions]);
@@ -35,7 +39,8 @@ export function useFunctionColumnsData(objectSet, objects, columnDefinitions) {
     return functionColumnConfigs.map(config => ({
       queryDefinition: config.queryDefinition,
       options: {
-        params: config.getParams(stableObjectSet)
+        params: config.getParams(stableObjectSet),
+        dedupeIntervalMs: config.dedupeIntervalMs ?? DEFAULT_DEDUPE_INTERVAL_MS
       }
     }));
   }, [disabled, functionColumnConfigs, stableObjectSet]);
@@ -102,6 +107,10 @@ function getFunctionColumnConfigs(columnDefinitions) {
           getValue: locator.getValue,
           getKey: locator.getKey
         });
+        // When multiple columns share a query, use the shortest dedupe interval
+        if (locator.dedupeIntervalMs != null) {
+          existingConfig.dedupeIntervalMs = existingConfig.dedupeIntervalMs != null ? Math.min(existingConfig.dedupeIntervalMs, locator.dedupeIntervalMs) : locator.dedupeIntervalMs;
+        }
       } else {
         // Create new config
         configsByApiName.set(apiName, {
@@ -111,7 +120,8 @@ function getFunctionColumnConfigs(columnDefinitions) {
             columnId: String(locator.id),
             getValue: locator.getValue,
             getKey: locator.getKey
-          }]
+          }],
+          dedupeIntervalMs: locator.dedupeIntervalMs
         });
       }
     }