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

package/AGENTS.md

@@ -1,105 +1,22 @@
 # @osdk/react-components
 
-Pre-built UI components for OSDK data. Requires `@osdk/react` (see the `@osdk/react` package's `AGENTS.md` for hooks and provider setup).
+Pre-built, Ontology-aware React components. Pass in OSDK entities and they handle data loading, caching, and state management automatically. Requires `@osdk/react` (see the `@osdk/react` package's `AGENTS.md` for hooks and provider setup).
 
-## Setup
+## Components
 
-All components import from `@osdk/react-components/experimental`. Requires `OsdkProvider2` from `@osdk/react/experimental`.
+All components import from `@osdk/react-components/experimental`.
 
-### Provider (required)
+| Component              | Description                                                                                                                                 |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| **ObjectTable**        | Table for displaying OSDK object sets with sorting, filtering, inline editing, column pinning/resizing, row selection, and infinite scroll. |
+| **BaseTable**          | OSDK-agnostic base table — use when building custom data fetching on top of the table UI.                                                   |
+| **FilterList**         | Aggregation-based filter UI for object sets with draggable reordering.                                                                      |
+| **BaseFilterList**     | OSDK-agnostic base filter list — use for custom filter implementations.                                                                     |
+| **ColumnConfigDialog** | Dialog for managing column visibility and drag-and-drop reordering.                                                                         |
 
-```tsx
-import { OsdkProvider2 } from "@osdk/react/experimental";
-import { client } from "./client";
+## Documentation
 
-function App() {
-  return (
-    <OsdkProvider2 client={client}>
-      <MyApp />
-    </OsdkProvider2>
-  );
-}
-```
+Before using any component, read the relevant doc:
 
-### CSS (required)
-
-```css
-@layer osdk.tokens, osdk.components;
-@import "@osdk/react-components-styles" layer(osdk.tokens);
-@import "@osdk/react-components/styles.css" layer(osdk.components);
-
-.root {
-  isolation: isolate;
-}
-```
-
-## ObjectTable
-
-```tsx
-import { ObjectTable } from "@osdk/react-components/experimental";
-import { Employee } from "@your-osdk-package";
-
-function EmployeeDirectory() {
-  return <ObjectTable objectType={Employee} />;
-}
-```
-
-### Key Props
-
-| Prop                         | Type                                 | Description                                                         |
-| ---------------------------- | ------------------------------------ | ------------------------------------------------------------------- |
-| `objectType`                 | ObjectType                           | **Required.** The OSDK object type to display.                      |
-| `columnDefinitions`          | `ColumnDefinition[]`                 | Column config: visibility, order, custom renderers, pinning, width. |
-| `enableFiltering`            | boolean                              | Allow user filtering (default: true)                                |
-| `enableOrdering`             | boolean                              | Allow user sorting (default: true)                                  |
-| `enableColumnPinning`        | boolean                              | Allow column pinning (default: true)                                |
-| `enableColumnResizing`       | boolean                              | Allow column resizing (default: true)                               |
-| `enableColumnConfig`         | boolean                              | Show column config dialog (default: true)                           |
-| `selectionMode`              | `"single"` / `"multiple"` / `"none"` | Row selection mode (default: "none")                                |
-| `orderBy` / `defaultOrderBy` | `OrderBy<Q>[]`                       | Controlled/uncontrolled sorting                                     |
-| `filter`                     | WhereClause                          | Controlled filtering                                                |
-| `rowHeight`                  | number                               | Row height in pixels (default: 40)                                  |
-| `renderCellContextMenu`      | function                             | Custom right-click menu                                             |
-
-### Column Definition
-
-```ts
-type ColumnDefinition = {
-  locator:
-    | { type: "property"; id: PropertyKeys<Q> }
-    | {
-      type: "rdp";
-      id: keyof RDPs;
-      creator: DerivedProperty.Creator<Q, RDPs[keyof RDPs]>;
-    }
-    | { type: "function"; id: keyof FunctionColumns }
-    | { type: "custom"; id: string };
-  renderCell?: (
-    object: Osdk.Instance<Q>,
-    locator: ColumnDefinitionLocator<Q>,
-  ) => React.ReactNode;
-  renderHeader?: () => React.ReactNode;
-  width?: number;
-  pinned?: "left" | "right" | "none";
-  isVisible?: boolean;
-  orderable?: boolean;
-  columnName?: string;
-};
-```
-
-### ColumnConfigDialog
-
-Standalone dialog for column visibility/ordering:
-
-```tsx
-import { ColumnConfigDialog } from "@osdk/react-components/experimental";
-
-<ColumnConfigDialog
-  isOpen={isOpen}
-  onClose={() => setIsOpen(false)}
-  columnOptions={[{ id: "fullName", name: "Full Name" }]}
-  currentVisibility={{ fullName: true }}
-  currentColumnOrder={["fullName"]}
-  onApply={(columns) => {/* [{ columnId, isVisible }] */}}
-/>;
-```
+- **Setup & installation**: Read [README.md](https://github.com/palantir/osdk-ts/blob/main/packages/react-components/README.md) for provider, CSS layers, and peer dependencies
+- **ObjectTable**: Read [docs/ObjectTable.md](https://github.com/palantir/osdk-ts/blob/main/packages/react-components/docs/ObjectTable.md) for props, column definitions, examples, theming, and troubleshooting

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @osdk/react-components
 
+## 0.2.0-beta.23
+
+### Minor Changes
+
+- c35231f: add cbac css tokens and create cbac-components package
+- 5f52808: fix(pdf): fix issue with pdf viewer worker import
+- 336a013: refactor(pdf): rename BasePdfRenderer/PdfRenderer to BasePdfViewer/PdfViewer, rename downloadEnabled to enableDownload, expose internal hooks, add onDownload result callback for download success/failure
+- 07a6fdb: use SkeletonBar component in table loading cells instead of inline skeleton divs
+
+### Patch Changes
+
+- Updated dependencies [fceb4ce]
+  - @osdk/client@2.8.0-beta.27
+  - @osdk/api@2.8.0-beta.27
+  - @osdk/react@0.10.0-beta.11
+
+## 0.2.0-beta.22
+
+### Minor Changes
+
+- 7080b01: Add base form layout with header, footer, field components, and CSS token variables for theming
+- 08b979a: Thread objectSet through filter aggregation hooks and add FilterList documentation
+- dffac63: Fix styling nits
+- b373588: Styling fix with global border-box
+
+### Patch Changes
+
+- Updated dependencies [b1e8bba]
+- Updated dependencies [599426b]
+- Updated dependencies [60b5ffb]
+- Updated dependencies [61e33ab]
+  - @osdk/react@0.10.0-beta.11
+  - @osdk/client@2.8.0-beta.26
+  - @osdk/api@2.8.0-beta.26
+
 ## 0.2.0-beta.21
 
 ### Minor Changes

package/README.md

@@ -80,27 +80,42 @@ The components that this package will provide are:
 | Component     | Description                                                                        | Documentation                  |
 | ------------- | ---------------------------------------------------------------------------------- | ------------------------------ |
 | `ObjectTable` | Displays an Object Set as a sortable, paginated table with inline editing support  | [Guide](./docs/ObjectTable.md) |
-| `FilterList`  | Visualize a high-level summary of objects data to allow users to filter that data. | -                              |
+| `PdfViewer`   | Renders PDF documents with annotations, search, sidebar navigation, and zoom       | [Guide](./docs/PdfViewer.md)   |
+| `FilterList`  | Visualize a high-level summary of objects data to allow users to filter that data. | [Guide](./docs/FilterList.md)  |
 | `ActionForm`  | Auto-generated form for executing Ontology Actions                                 | -                              |
 
 ## Component Architecture
 
-This package follows a 2-layer architecture pattern to maximize flexibility and reusability:
+This package follows a layered architecture pattern to maximize flexibility and reusability.
 
-### Architecture Overview
+### Core layers (all components)
 
-1. **OSDK Component Layer** (e.g., `ObjectTable`)
+1. **OSDK Component Layer** (e.g., `ObjectTable`, `PdfViewer`)
    - Handles data fetching and processing using @osdk/react hooks
    - Converts OSDK types to primitive data structures
    - Manages OSDK-specific operations like filtering and actions
    - No styling or component interactions
 
-2. **Base Component Layer** (e.g., `BaseTable`)
+2. **Base Component Layer** (e.g., `BaseTable`, `BasePdfViewer`)
    - Pure component layer with no OSDK imports
    - Contains all component interactions and styling
    - Accepts primitive props like `string[]`, arrays, and objects
    - Can be reused with custom data fetching layers
 
+### Building blocks (select components)
+
+Some components also provide a **building blocks** tier — individual sub-components and hooks that can be composed into fully custom layouts. Not every component needs this; it's offered where the UI is complex enough that users may want to rearrange or replace parts of it.
+
+For example, the PDF viewer offers three levels of customization:
+
+| Tier            | What you use                                                     | What you get                                                     |
+| --------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
+| Drop-in         | `PdfViewer` / `BasePdfViewer`                                    | Full viewer with toolbar, sidebar, search — zero assembly        |
+| Building blocks | `PdfViewerToolbar`, `PdfViewerSidebar`, `PdfViewerContent`, etc. | Custom layout using standard parts                               |
+| Hooks           | `usePdfViewerState` / `usePdfViewerCore` / primitive hooks       | Build entirely custom components; hooks do all the heavy lifting |
+
+See the [PdfViewer guide](./docs/PdfViewer.md) for the full API reference.
+
 ### Example: ObjectTable and BaseTable
 
 ```tsx
@@ -111,7 +126,7 @@ This package follows a 2-layer architecture pattern to maximize flexibility and
 - Manages object property metadata
 - Passes primitive data to BaseTable
 
-// BaseTable - Component layer  
+// BaseTable - Component layer
 - Pure table component with no OSDK imports
 - Handles all UI interactions (sorting, selection, editing)
 - Manages component state
@@ -131,7 +146,8 @@ When building new components:
 1. Start with the Base component focusing on interactions and styling
 2. Create the OSDK wrapper that handles data fetching and type conversion
 3. Keep the Base component API simple using primitive types
-4. Document both layers for users who want to customize
+4. For complex components, consider a building blocks tier with sub-components and hooks
+5. Document all layers for users who want to customize
 
 ## Folder Structure
 

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

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

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

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

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

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

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

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

package/build/browser/action-form/BaseForm.module.css.js

@@ -0,0 +1,8 @@
+// CSS Module proxy for BaseForm.module.css
+const styles = {
+  "osdkForm": "BaseForm-module__osdkForm___76UCas8f",
+  "osdkFormFields": "BaseForm-module__osdkFormFields___3DthDz5L",
+  "osdkFormFooter": "BaseForm-module__osdkFormFooter___ZRbu-oda"
+};
+
+export default styles;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.js","names":["React","memo","styles","FormField","fieldKey","label","isRequired","helperText","error","children","createElement","className","osdkFormField","osdkFormFieldLabel","htmlFor","osdkFormFieldRequired","osdkFormFieldError","role","osdkFormFieldHelperText"],"sources":["FormField.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 styles from \"./FormField.module.css\";\n\ninterface FormFieldProps {\n  fieldKey: string;\n  label?: string;\n  isRequired?: boolean;\n  helperText?: string;\n  error?: string;\n  children: React.ReactNode;\n}\n\nexport const FormField: React.FC<FormFieldProps> = memo(\n  function FormFieldFn({\n    fieldKey,\n    label,\n    isRequired,\n    helperText,\n    error,\n    children,\n  }: FormFieldProps): React.ReactElement {\n    return (\n      <div className={styles.osdkFormField}>\n        {label != null && (\n          <label className={styles.osdkFormFieldLabel} htmlFor={fieldKey}>\n            {label}\n            {isRequired === true && (\n              <span\n                className={styles.osdkFormFieldRequired}\n                aria-label=\"required\"\n              >\n                {\" \"}*\n              </span>\n            )}\n          </label>\n        )}\n        {children}\n        {error != null && (\n          <div className={styles.osdkFormFieldError} role=\"alert\">\n            {error}\n          </div>\n        )}\n        {helperText != null && (\n          <div className={styles.osdkFormFieldHelperText}>{helperText}</div>\n        )}\n      </div>\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,QAAQ,OAAO;AACnC,OAAOC,MAAM,MAAM,wBAAwB;AAW3C,OAAO,MAAMC,SAAmC,gBAAGF,IAAI,CACrD,UAAqB;EACnBG,QAAQ;EACRC,KAAK;EACLC,UAAU;EACVC,UAAU;EACVC,KAAK;EACLC;AACc,CAAC,EAAsB;EACrC,oBACET,KAAA,CAAAU,aAAA;IAAKC,SAAS,EAAET,MAAM,CAACU;EAAc,GAClCP,KAAK,IAAI,IAAI,iBACZL,KAAA,CAAAU,aAAA;IAAOC,SAAS,EAAET,MAAM,CAACW,kBAAmB;IAACC,OAAO,EAAEV;EAAS,GAC5DC,KAAK,EACLC,UAAU,KAAK,IAAI,iBAClBN,KAAA,CAAAU,aAAA;IACEC,SAAS,EAAET,MAAM,CAACa,qBAAsB;IACxC,cAAW;EAAU,GAEpB,GAAG,EAAC,GACD,CAEH,CACR,EACAN,QAAQ,EACRD,KAAK,IAAI,IAAI,iBACZR,KAAA,CAAAU,aAAA;IAAKC,SAAS,EAAET,MAAM,CAACc,kBAAmB;IAACC,IAAI,EAAC;EAAO,GACpDT,KACE,CACN,EACAD,UAAU,IAAI,IAAI,iBACjBP,KAAA,CAAAU,aAAA;IAAKC,SAAS,EAAET,MAAM,CAACgB;EAAwB,GAAEX,UAAgB,CAEhE,CAAC;AAEV,CACF,CAAC","ignoreList":[]}

package/build/browser/action-form/FormField.module.css

@@ -0,0 +1,41 @@
+/*
+ * 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.
+ */
+
+.osdkFormField {
+  display: flex;
+  flex-direction: column;
+  gap: var(--osdk-form-label-field-gap);
+}
+
+.osdkFormFieldLabel {
+  font-size: var(--osdk-form-label-font-size);
+  font-weight: var(--osdk-form-label-font-weight);
+  color: var(--osdk-form-label-color);
+}
+
+.osdkFormFieldRequired {
+  color: var(--osdk-form-required-color);
+}
+
+.osdkFormFieldError {
+  font-size: var(--osdk-form-error-font-size);
+  color: var(--osdk-form-error-color);
+}
+
+.osdkFormFieldHelperText {
+  font-size: var(--osdk-typography-size-body-small);
+  color: var(--osdk-typography-color-muted);
+}

package/build/browser/action-form/FormField.module.css.js

@@ -0,0 +1,10 @@
+// CSS Module proxy for FormField.module.css
+const styles = {
+  "osdkFormField": "FormField-module__osdkFormField___K4BpO5Sn",
+  "osdkFormFieldLabel": "FormField-module__osdkFormFieldLabel___S9J-yCFD",
+  "osdkFormFieldRequired": "FormField-module__osdkFormFieldRequired___O0-L5TM8",
+  "osdkFormFieldError": "FormField-module__osdkFormFieldError___VYf8-K5I",
+  "osdkFormFieldHelperText": "FormField-module__osdkFormFieldHelperText___awLgHOsQ"
+};
+
+export default styles;

package/build/browser/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  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<\n        FieldDescriptorType<Q, K>\n      >\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  /**\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 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\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\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\n/**\n * Radio buttons field props\n */\nexport interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {\n  /**\n   * Available options for radio buttons\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 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 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<\n        FieldDescriptorType<Q, K>\n      >\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, 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\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\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\n/**\n * Radio buttons field props\n */\nexport interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {\n  /**\n   * Available options for radio buttons\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/FormHeader.js

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React, { memo } from "react";
+import styles from "./FormHeader.module.css.js";
+export const FormHeader = /*#__PURE__*/memo(function ({
+  title
+}) {
+  return /*#__PURE__*/React.createElement("h2", {
+    className: styles.osdkFormHeader
+  }, title);
+});
+//# sourceMappingURL=FormHeader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormHeader.js","names":["React","memo","styles","FormHeader","title","createElement","className","osdkFormHeader"],"sources":["FormHeader.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 styles from \"./FormHeader.module.css\";\n\ninterface FormHeaderProps {\n  title: string;\n}\n\nexport const FormHeader: React.FC<FormHeaderProps> = memo(\n  function FormHeaderFn({ title }: FormHeaderProps): React.ReactElement {\n    return (\n      <h2 className={styles.osdkFormHeader}>\n        {title}\n      </h2>\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,QAAQ,OAAO;AACnC,OAAOC,MAAM,MAAM,yBAAyB;AAM5C,OAAO,MAAMC,UAAqC,gBAAGF,IAAI,CACvD,UAAsB;EAAEG;AAAuB,CAAC,EAAsB;EACpE,oBACEJ,KAAA,CAAAK,aAAA;IAAIC,SAAS,EAAEJ,MAAM,CAACK;EAAe,GAClCH,KACC,CAAC;AAET,CACF,CAAC","ignoreList":[]}

package/build/browser/action-form/FormHeader.module.css

@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+.osdkFormHeader {
+  margin: 0;
+  padding-block: var(--osdk-form-header-block-padding);
+  padding-inline: var(--osdk-form-header-inline-padding);
+  border-bottom: var(--osdk-surface-border-width) solid
+    var(--osdk-form-header-border-color);
+  font-size: var(--osdk-form-header-font-size);
+  font-weight: var(--osdk-form-header-font-weight);
+  color: var(--osdk-form-header-color);
+}