npm - @osdk/react-components - Versions diffs - 0.2.0-beta.19 → 0.2.0-beta.20 - Mend

@osdk/react-components 0.2.0-beta.19 → 0.2.0-beta.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (316) hide show

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

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode, ReactElement } from 'react';
-import { ObjectTypeDefinition, ObjectSet, WhereClause, PropertyKeys, LinkNames, LinkedType, WirePropertyTypes, CompileTimeMetadata, ObjectOrInterfaceDefinition, SimplePropertyDef, QueryDefinition, DerivedProperty, Osdk, PrimaryKeyType } from '@osdk/api';
+import { ObjectTypeDefinition, ObjectSet, WhereClause, PropertyKeys, LinkNames, LinkedType, WirePropertyTypes, CompileTimeMetadata, ObjectOrInterfaceDefinition, SimplePropertyDef, QueryDefinition, QueryMetadata, Osdk, DerivedProperty, PrimaryKeyType, Media } from '@osdk/api';
 import { RowData, Table, Cell, VisibilityState, ColumnOrderState } from '@tanstack/react-table';
 /**
@@ -440,16 +440,33 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
      */
     onFilterStateChanged?: (definition: FilterDefinitionUnion<Q>, newState: FilterState) => void;
     /**
-     * Called when a filter is added
-     * If provided, user will be allowed to add filters
+     * Controls how filter visibility (add/remove) is managed.
+     *
+     * - `"controlled"` (default): The consumer manages which filters are
+     *   visible via `filterDefinitions`. Filters with `isVisible: false` are
+     *   excluded from the rendered list.
+     * - `"uncontrolled"`: FilterList manages visibility internally. An "Add
+     *   filter" popover is rendered for filters with `isVisible: false`, and
+     *   each visible filter shows a remove button.
+     *
+     * @default "controlled"
+     */
+    addFilterMode?: "controlled" | "uncontrolled";
+    /**
+     * Called when a filter is added (shown).
+     *
+     * In uncontrolled mode, this fires when a user selects a hidden filter
+     * from the "Add filter" popover.
      *
      * @param filterKey The key of the added filter
-     * @param newDefinitions The filter list with the new filter added
+     * @param newDefinitions The current filter definitions array
      */
     onFilterAdded?: (filterKey: FilterKey<Q>, newDefinitions: Array<FilterDefinitionUnion<Q>>) => void;
     /**
-     * Called when a filter is removed
-     * If provided, user will be allowed to remove filters
+     * Called when a filter is removed (hidden).
+     *
+     * In uncontrolled mode, this fires as a notification after the filter
+     * is hidden internally.
      *
      * @param filterKey The key of the removed filter
      */
@@ -493,7 +510,8 @@ interface FilterListProps<Q extends ObjectTypeDefinition> {
     className?: string;
     /**
      * Custom render function for the "Add filter" button.
-     * When not provided, a default button is shown if onFilterAdded is set.
+     * Only used in controlled mode. In uncontrolled mode, the built-in
+     * AddFilterPopover is rendered automatically.
      */
     renderAddFilterButton?: () => React__default.ReactNode;
 }
@@ -577,20 +595,49 @@ type ColumnDefinition<Q extends ObjectOrInterfaceDefinition, RDPs extends Record
      */
     renderHeader?: () => React.ReactNode;
 };
-type ColumnDefinitionLocator<Q extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = Record<string, never>, FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<string, never>> = {
+type ExtractQueryParameters<TQueryDef extends QueryDefinition> = TQueryDef["__DefinitionMetadata"] extends QueryMetadata ? TQueryDef["__DefinitionMetadata"]["parameters"] : never;
+interface PropertyColumnLocator<Q extends ObjectOrInterfaceDefinition> {
     type: "property";
     id: PropertyKeys<Q>;
-} | {
+}
+interface FunctionColumnLocator<Q extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = Record<string, never>, FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<string, never>> {
+    /**
+     * This is equivalent to workshop's function-backed columns.
+     * The function needs to meet the specifications stated in https://www.palantir.com/docs/foundry/workshop/widgets-object-table/#function-backed-columns
+     */
     type: "function";
     id: keyof FunctionColumns;
-} | {
+    queryDefinition: FunctionColumns[keyof FunctionColumns];
+    /**
+     * The function will be called with the current object set to get the input parameters for the function query.
+     * @param objectSet - The current object set.
+     * @returns - The function's input parameters including the object set.
+     */
+    getFunctionParams: (objectSet: ObjectSet<Q>) => ExtractQueryParameters<FunctionColumns[keyof FunctionColumns]>;
+    /**
+     * Function to generate keys for looking up results in the FunctionsMap.
+     * @param object - The object instance
+     * @returns - The key to use for looking up this object's result in the FunctionsMap
+     */
+    getKey: (object: Osdk.Instance<Q, "$allBaseProperties", PropertyKeys<Q>, RDPs>) => string;
+    /**
+     * Function to extract the cell value from the raw cell data returned by the function.
+     * This is useful when functions return custom types with multiple properties.
+     * @param cellData - The raw data returned by the function for this object
+     * @returns - The value to display in the cell
+     */
+    getValue?: (cellData: unknown) => unknown;
+}
+interface RdpColumnLocator<Q extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = Record<string, never>> {
     type: "rdp";
     id: keyof RDPs;
     creator: DerivedProperty.Creator<Q, RDPs[keyof RDPs]>;
-} | {
+}
+interface CustomColumnLocator {
     type: "custom";
     id: string;
-};
+}
+type ColumnDefinitionLocator<Q extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = Record<string, never>, FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<string, never>> = PropertyColumnLocator<Q> | FunctionColumnLocator<Q, RDPs, FunctionColumns> | RdpColumnLocator<Q, RDPs> | CustomColumnLocator;
 interface ObjectTableProps<Q extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = Record<string, never>, FunctionColumns extends Record<string, QueryDefinition<{}>> = Record<string, never>> {
     /**
      * The object or interface type of the object
@@ -819,6 +866,7 @@ interface HeaderMenuFeatureFlags {
 declare module "@tanstack/react-table" {
     interface ColumnMeta<TData extends RowData = unknown, TValue = unknown> {
         columnName?: string;
+        isAsyncColumn?: boolean;
         isVisible?: boolean;
         editable?: boolean;
         dataType?: string;
@@ -863,4 +911,57 @@ interface ColumnConfigDialogProps {
 }
 declare function ColumnConfigDialog({ isOpen, onClose, columnOptions, currentVisibility, currentColumnOrder, onApply, isValidConfig, }: ColumnConfigDialogProps): React__default.ReactElement | null;
-export { BaseFilterList, type BaseFilterListProps, BaseTable, type BaseTableProps, type CellEditInfo, ColumnConfigDialog, type ColumnConfigDialogProps, type ColumnConfigOptions, type ColumnDefinition, type ColumnDefinitionLocator, type FilterComponentType, type FilterDefinitionUnion, FilterList, type FilterListItemProps, type FilterListProps, type FilterState, ObjectTable, type ObjectTableProps, type PropertyFilterDefinition, type RenderFilterInput, deserializeFilterStates, serializeFilterStates };
+/** The visual style of an annotation rendered on the PDF. */
+type AnnotationType = "highlight" | "underline" | "comment" | "pin";
+/** A single annotation positioned on a specific page of the PDF. */
+interface PdfAnnotation {
+    /** Unique identifier for this annotation */
+    id: string;
+    /** The type of annotation to render */
+    type: AnnotationType;
+    /** Page number (1-indexed) */
+    page: number;
+    /** Coordinates in PDF points (origin: bottom-left of page) */
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Optional label or tooltip text */
+    label?: string;
+    /** Optional color override (CSS color string) */
+    color?: string;
+}
+/** Props for the {@link PdfViewer} component. */
+interface PdfViewerProps {
+    /** PDF source — URL string or ArrayBuffer */
+    src: string | ArrayBuffer;
+    /** Annotations to overlay on the PDF, keyed by page number (1-indexed) */
+    annotations?: Record<number, PdfAnnotation[]>;
+    /**
+     * Callback fired when an annotation is clicked.
+     *
+     * @param annotation - The annotation that was clicked
+     * @returns void
+     */
+    onAnnotationClick?: (annotation: PdfAnnotation) => void;
+    /** Initial page number (1-indexed, default 1) */
+    initialPage?: number;
+    /** Initial zoom scale (default 1.0) */
+    initialScale?: number;
+    /** Whether the sidebar is initially open (default false) */
+    initialSidebarOpen?: boolean;
+    /** Additional CSS class name for the root element */
+    className?: string;
+}
+declare function BasePdfViewer({ src, annotations, onAnnotationClick, initialPage, initialScale, initialSidebarOpen, className, }: PdfViewerProps): React__default.ReactElement;
+interface PdfRendererProps extends Omit<PdfViewerProps, "src"> {
+    /** The Media object to fetch PDF contents from */
+    media: Media;
+}
+declare function PdfRenderer({ media, className, ...pdfViewerProps }: PdfRendererProps): React__default.ReactElement;
+export { type AnnotationType, BaseFilterList, type BaseFilterListProps, BasePdfViewer, BaseTable, type BaseTableProps, type CellEditInfo, ColumnConfigDialog, type ColumnConfigDialogProps, type ColumnConfigOptions, type ColumnDefinition, type ColumnDefinitionLocator, type CustomColumnLocator, type FilterComponentType, type FilterDefinitionUnion, FilterList, type FilterListItemProps, type FilterListProps, type FilterState, type FunctionColumnLocator, ObjectTable, type ObjectTableProps, type PdfAnnotation, PdfRenderer, type PdfRendererProps, type PdfViewerProps, type PropertyColumnLocator, type PropertyFilterDefinition, type RdpColumnLocator, type RenderFilterInput, deserializeFilterStates, serializeFilterStates };

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

@@ -54,7 +54,11 @@ export const ActionForm = typedReactMemo(function ({
   }, [metadataError, onError]);
   const parameters = metadata?.parameters;
   const resolvedFieldDefinitions = useMemo(() => formFieldDefinitions ?? (metadata != null ? getDefaultFieldDefinitions(metadata) : EMPTY_FIELD_DEFINITIONS), [formFieldDefinitions, metadata]);
-  const rendererFieldDefinitions = useMemo(() => resolvedFieldDefinitions.map(def => ({
+  const rendererFieldDefinitions = useMemo(() =>
+  // RendererFieldDefinition is a discriminated union keyed by fieldComponent.
+  // TypeScript can't verify that the spread preserves the fieldComponent ↔
+  // fieldComponentProps pairing, but FormFieldDefinition guarantees it.
+  resolvedFieldDefinitions.map(def => ({
     ...def,
     fieldKey: String(def.fieldKey),
     fieldType: parameters?.[String(def.fieldKey)]?.type,

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

	@@ -1 +1 @@
1	- {"version":3,"file":"ActionForm.js","names":["useOsdkMetadata","useOsdkAction","React","useCallback","useEffect","useMemo","typedReactMemo","BaseForm","coerceFieldValue","getDefaultFieldDefinitions","EMPTY_FIELD_DEFINITIONS","ActionForm","actionDefinition","formTitle","formFieldDefinitions","formState","controlledFormState","onFormStateChange","isSubmitDisabled","onSubmit","onValidationResponse","_onValidationResponse","onSuccess","onError","applyAction","osdkApplyAction","isPending","metadata","loading","metadataLoading","error","metadataError","type","parameters","resolvedFieldDefinitions","rendererFieldDefinitions","map","def","fieldKey","String","fieldType","defaultValue","coerceFormState","rawState","coerced","key","value","Object","entries","handleSubmit","rawFormState","result","e","handleFieldValueChange","prev","resolvedTitle","displayName","apiName","commonProps","fieldDefinitions","isLoading","onFieldValueChange","createElement","_extends"],"sources":["ActionForm.tsx"],"sourcesContent":["/\n Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ActionDefinition } from \"@osdk/api\";\nimport { useOsdkMetadata } from \"@osdk/react\";\nimport { useOsdkAction } from \"@osdk/react/experimental\";\nimport React, { useCallback, useEffect, useMemo } from \"react\";\nimport { typedReactMemo } from \"../shared/typedMemo.js\";\nimport type { ActionFormProps, FormState } from \"./ActionFormApi.js\";\nimport { BaseForm } from \"./BaseForm.js\";\nimport type { RendererFieldDefinition } from \"./FormFieldApi.js\";\nimport { coerceFieldValue } from \"./utils/coerceFieldValue.js\";\nimport { getDefaultFieldDefinitions } from \"./utils/getDefaultFieldDefinitions.js\";\n\nconst EMPTY_FIELD_DEFINITIONS: readonly [] = [];\n\nexport const ActionForm: <Q extends ActionDefinition<unknown>>(\n props: ActionFormProps<Q>,\n) => React.ReactElement = typedReactMemo(function ActionFormFn<\n Q extends ActionDefinition<unknown>,\n>({\n actionDefinition,\n formTitle,\n formFieldDefinitions,\n formState: controlledFormState,\n onFormStateChange,\n isSubmitDisabled,\n onSubmit,\n onValidationResponse: _onValidationResponse,\n onSuccess,\n onError,\n}: ActionFormProps<Q>): React.ReactElement {\n const { applyAction: osdkApplyAction, isPending } = useOsdkAction(\n actionDefinition,\n );\n const {\n metadata,\n loading: metadataLoading,\n error: metadataError,\n } = useOsdkMetadata(actionDefinition);\n\n useEffect(\n function saveMetadataError() {\n if (metadataError != null) {\n onError?.({ type: \"unknown\", error: metadataError });\n }\n },\n [metadataError, onError],\n );\n\n const parameters = metadata?.parameters;\n\n const resolvedFieldDefinitions = useMemo(\n () =>\n formFieldDefinitions\n ?? (metadata != null\n ? getDefaultFieldDefinitions<Q>(metadata)\n : EMPTY_FIELD_DEFINITIONS),\n [formFieldDefinitions, metadata],\n );\n\n const rendererFieldDefinitions: ReadonlyArray<RendererFieldDefinition> =\n useMemo(\n () =>\n resolvedFieldDefinitions.map((def) => ({\n ...def,\n fieldKey: String(def.fieldKey),\n fieldType: parameters?.[String(def.fieldKey)]?.type,\n defaultValue: def.defaultValue,\n })),\n [resolvedFieldDefinitions, parameters],\n );\n\n const coerceFormState = useCallback(\n (rawState: Record<string, unknown>): Record<string, unknown> => {\n const coerced: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(rawState)) {\n coerced[key] = coerceFieldValue(parameters?.[key]?.type, value);\n }\n return coerced;\n },\n [parameters],\n );\n\n const handleSubmit = useCallback(\n async (rawFormState: Record<string, unknown>) => {\n const formState = coerceFormState(rawFormState) as FormState<Q>;\n try {\n if (onSubmit != null) {\n await onSubmit(formState, osdkApplyAction);\n } else {\n const result = await osdkApplyAction(formState);\n onSuccess?.(result);\n }\n } catch (e) {\n onError?.({ type: \"submission\", error: e });\n }\n },\n [coerceFormState, onSubmit, osdkApplyAction, onSuccess, onError],\n );\n\n const handleFieldValueChange = useCallback(\n (fieldKey: string, value: unknown) => {\n onFormStateChange?.(\n (prev) =>\n ({\n ...prev,\n [fieldKey]: value,\n }) as FormState<Q>,\n );\n },\n [onFormStateChange],\n );\n\n const resolvedTitle = formTitle ?? metadata?.displayName\n ?? actionDefinition.apiName;\n\n const isControlled = controlledFormState != null;\n\n const commonProps = {\n formTitle: resolvedTitle,\n fieldDefinitions: rendererFieldDefinitions,\n onSubmit: handleSubmit,\n isSubmitDisabled,\n isPending,\n isLoading: metadataLoading,\n onFieldValueChange: handleFieldValueChange,\n };\n\n if (!isControlled) {\n return <BaseForm {...commonProps} />;\n }\n\n return <BaseForm {...commonProps} formState={controlledFormState} />;\n});\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,eAAe,QAAQ,aAAa;AAC7C,SAASC,aAAa,QAAQ,0BAA0B;AACxD,OAAOC,KAAK,IAAIC,WAAW,EAAEC,SAAS,EAAEC,OAAO,QAAQ,OAAO;AAC9D,SAASC,cAAc,QAAQ,wBAAwB;AAEvD,SAASC,QAAQ,QAAQ,eAAe;AAExC,SAASC,gBAAgB,QAAQ,6BAA6B;AAC9D,SAASC,0BAA0B,QAAQ,uCAAuC;AAElF,MAAMC,uBAAoC,GAAG,EAAE;AAE/C,OAAO,MAAMC,UAEU,GAAGL,cAAc,CAAC,UAEvC;EACAM,gBAAgB;EAChBC,SAAS;EACTC,oBAAoB;EACpBC,SAAS,EAAEC,mBAAmB;EAC9BC,iBAAiB;EACjBC,gBAAgB;EAChBC,QAAQ;EACRC,oBAAoB,EAAEC,qBAAqB;EAC3CC,SAAS;EACTC;AACkB,CAAC,EAAsB;EACzC,MAAM;IAAEC,WAAW,EAAEC,eAAe;IAAEC;EAAU,CAAC,GAAGzB,aAAa,CAC/DW,gBACF,CAAC;EACD,MAAM;IACJe,QAAQ;IACRC,OAAO,EAAEC,eAAe;IACxBC,KAAK,EAAEC;EACT,CAAC,GAAG/B,eAAe,CAACY,gBAAgB,CAAC;EAErCR,SAAS,CACP,YAA6B;IAC3B,IAAI2B,aAAa,IAAI,IAAI,EAAE;MACzBR,OAAO,GAAG;QAAES,IAAI,EAAE,SAAS;QAAEF,KAAK,EAAEC;MAAc,CAAC,CAAC;IACtD;EACF,CAAC,EACD,CAACA,aAAa,EAAER,OAAO,CACzB,CAAC;EAED,MAAMU,UAAU,GAAGN,QAAQ,EAAEM,UAAU;EAEvC,MAAMC,wBAAwB,GAAG7B,OAAO,CACtC,MACES,oBAAoB,KACda,QAAQ,IAAI,IAAI,GAChBlB,0BAA0B,CAAIkB,QAAQ,CAAC,GACvCjB,uBAAuB,CAAC,EAChC,CAACI,oBAAoB,EAAEa,QAAQ,CACjC,CAAC;EAED,MAAMQ,wBAAgE,GACpE9B,OAAO,CACL,~~MACE6B,~~wBAAwB,CAACE,GAAG,CAAEC,GAAG,~~KAAM~~;~~IACrC~~,GAAGA,GAAG;IACNC,QAAQ,EAAEC,MAAM,CAACF,GAAG,CAACC,QAAQ,CAAC;IAC9BE,SAAS,EAAEP,UAAU,GAAGM,MAAM,CAACF,GAAG,CAACC,QAAQ,CAAC,CAAC,EAAEN,IAAI;IACnDS,YAAY,EAAEJ,GAAG,CAACI;EACpB,CAAC,~~CAAC~~,CAAC,~~EACL~~,CAACP,wBAAwB,EAAED,UAAU,CACvC,CAAC;EAEH,MAAMS,eAAe,GAAGvC,WAAW,CAChCwC,QAAiC,IAA8B;IAC9D,MAAMC,OAAgC,GAAG,CAAC,CAAC;IAC3C,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACL,QAAQ,CAAC,EAAE;MACnDC,OAAO,CAACC,GAAG,CAAC,GAAGrC,gBAAgB,CAACyB,UAAU,GAAGY,GAAG,CAAC,EAAEb,IAAI,EAAEc,KAAK,CAAC;IACjE;IACA,OAAOF,OAAO;EAChB,CAAC,EACD,CAACX,UAAU,CACb,CAAC;EAED,MAAMgB,YAAY,GAAG9C,WAAW,CAC9B,MAAO+C,YAAqC,IAAK;IAC/C,MAAMnC,SAAS,GAAG2B,eAAe,CAACQ,YAAY,CAAiB;IAC/D,IAAI;MACF,IAAI/B,QAAQ,IAAI,IAAI,EAAE;QACpB,MAAMA,QAAQ,CAACJ,SAAS,EAAEU,eAAe,CAAC;MAC5C,CAAC,MAAM;QACL,MAAM0B,MAAM,GAAG,MAAM1B,eAAe,CAACV,SAAS,CAAC;QAC/CO,SAAS,GAAG6B,MAAM,CAAC;MACrB;IACF,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV7B,OAAO,GAAG;QAAES,IAAI,EAAE,YAAY;QAAEF,KAAK,EAAEsB;MAAE,CAAC,CAAC;IAC7C;EACF,CAAC,EACD,CAACV,eAAe,EAAEvB,QAAQ,EAAEM,eAAe,EAAEH,SAAS,EAAEC,OAAO,CACjE,CAAC;EAED,MAAM8B,sBAAsB,GAAGlD,WAAW,CACxC,CAACmC,QAAgB,EAAEQ,KAAc,KAAK;IACpC7B,iBAAiB,GACdqC,IAAI,KACF;MACC,GAAGA,IAAI;MACP,CAAChB,QAAQ,GAAGQ;IACd,CAAC,CACL,CAAC;EACH,CAAC,EACD,CAAC7B,iBAAiB,CACpB,CAAC;EAED,MAAMsC,aAAa,GAAG1C,SAAS,IAAIc,QAAQ,EAAE6B,WAAW,IACnD5C,gBAAgB,CAAC6C,OAAO;EAI7B,MAAMC,WAAW,GAAG;IAClB7C,SAAS,EAAE0C,aAAa;IACxBI,gBAAgB,EAAExB,wBAAwB;IAC1ChB,QAAQ,EAAE8B,YAAY;IACtB/B,gBAAgB;IAChBQ,SAAS;IACTkC,SAAS,EAAE/B,eAAe;IAC1BgC,kBAAkB,EAAER;EACtB,CAAC;EAED,IAAI,EAZiBrC,mBAAmB,IAAI,IAAI,CAY/B,EAAE;IACjB,oBAAOd,KAAA,CAAA4D,aAAA,CAACvD,QAAQ,EAAKmD,WAAc,CAAC;EACtC;EAEA,oBAAOxD,KAAA,CAAA4D,aAAA,CAACvD,QAAQ,EAAAwD,QAAA,KAAKL,WAAW;IAAE3C,SAAS,EAAEC;EAAoB,EAAE,CAAC;AACtE,CAAC,CAAC","ignoreList":[]}
1	+ {"version":3,"file":"ActionForm.js","names":["useOsdkMetadata","useOsdkAction","React","useCallback","useEffect","useMemo","typedReactMemo","BaseForm","coerceFieldValue","getDefaultFieldDefinitions","EMPTY_FIELD_DEFINITIONS","ActionForm","actionDefinition","formTitle","formFieldDefinitions","formState","controlledFormState","onFormStateChange","isSubmitDisabled","onSubmit","onValidationResponse","_onValidationResponse","onSuccess","onError","applyAction","osdkApplyAction","isPending","metadata","loading","metadataLoading","error","metadataError","type","parameters","resolvedFieldDefinitions","rendererFieldDefinitions","map","def","fieldKey","String","fieldType","defaultValue","coerceFormState","rawState","coerced","key","value","Object","entries","handleSubmit","rawFormState","result","e","handleFieldValueChange","prev","resolvedTitle","displayName","apiName","commonProps","fieldDefinitions","isLoading","onFieldValueChange","createElement","_extends"],"sources":["ActionForm.tsx"],"sourcesContent":["/\n Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ActionDefinition } from \"@osdk/api\";\nimport { useOsdkMetadata } from \"@osdk/react\";\nimport { useOsdkAction } from \"@osdk/react/experimental\";\nimport React, { useCallback, useEffect, useMemo } from \"react\";\nimport { typedReactMemo } from \"../shared/typedMemo.js\";\nimport type { ActionFormProps, FormState } from \"./ActionFormApi.js\";\nimport { BaseForm } from \"./BaseForm.js\";\nimport type { RendererFieldDefinition } from \"./FormFieldApi.js\";\nimport { coerceFieldValue } from \"./utils/coerceFieldValue.js\";\nimport { getDefaultFieldDefinitions } from \"./utils/getDefaultFieldDefinitions.js\";\n\nconst EMPTY_FIELD_DEFINITIONS: readonly [] = [];\n\nexport const ActionForm: <Q extends ActionDefinition<unknown>>(\n props: ActionFormProps<Q>,\n) => React.ReactElement = typedReactMemo(function ActionFormFn<\n Q extends ActionDefinition<unknown>,\n>({\n actionDefinition,\n formTitle,\n formFieldDefinitions,\n formState: controlledFormState,\n onFormStateChange,\n isSubmitDisabled,\n onSubmit,\n onValidationResponse: _onValidationResponse,\n onSuccess,\n onError,\n}: ActionFormProps<Q>): React.ReactElement {\n const { applyAction: osdkApplyAction, isPending } = useOsdkAction(\n actionDefinition,\n );\n const {\n metadata,\n loading: metadataLoading,\n error: metadataError,\n } = useOsdkMetadata(actionDefinition);\n\n useEffect(\n function saveMetadataError() {\n if (metadataError != null) {\n onError?.({ type: \"unknown\", error: metadataError });\n }\n },\n [metadataError, onError],\n );\n\n const parameters = metadata?.parameters;\n\n const resolvedFieldDefinitions = useMemo(\n () =>\n formFieldDefinitions\n ?? (metadata != null\n ? getDefaultFieldDefinitions<Q>(metadata)\n : EMPTY_FIELD_DEFINITIONS),\n [formFieldDefinitions, metadata],\n );\n\n const rendererFieldDefinitions: ReadonlyArray<RendererFieldDefinition> =\n useMemo(\n () =>\n // RendererFieldDefinition is a discriminated union keyed by fieldComponent.\n // TypeScript can't verify that the spread preserves the fieldComponent ↔\n // fieldComponentProps pairing, but FormFieldDefinition guarantees it.\n resolvedFieldDefinitions.map((def) =>\n ({\n ...def,\n fieldKey: String(def.fieldKey),\n fieldType: parameters?.[String(def.fieldKey)]?.type,\n defaultValue: def.defaultValue,\n }) as RendererFieldDefinition\n ),\n [resolvedFieldDefinitions, parameters],\n );\n\n const coerceFormState = useCallback(\n (rawState: Record<string, unknown>): Record<string, unknown> => {\n const coerced: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(rawState)) {\n coerced[key] = coerceFieldValue(parameters?.[key]?.type, value);\n }\n return coerced;\n },\n [parameters],\n );\n\n const handleSubmit = useCallback(\n async (rawFormState: Record<string, unknown>) => {\n const formState = coerceFormState(rawFormState) as FormState<Q>;\n try {\n if (onSubmit != null) {\n await onSubmit(formState, osdkApplyAction);\n } else {\n const result = await osdkApplyAction(formState);\n onSuccess?.(result);\n }\n } catch (e) {\n onError?.({ type: \"submission\", error: e });\n }\n },\n [coerceFormState, onSubmit, osdkApplyAction, onSuccess, onError],\n );\n\n const handleFieldValueChange = useCallback(\n (fieldKey: string, value: unknown) => {\n onFormStateChange?.(\n (prev) =>\n ({\n ...prev,\n [fieldKey]: value,\n }) as FormState<Q>,\n );\n },\n [onFormStateChange],\n );\n\n const resolvedTitle = formTitle ?? metadata?.displayName\n ?? actionDefinition.apiName;\n\n const isControlled = controlledFormState != null;\n\n const commonProps = {\n formTitle: resolvedTitle,\n fieldDefinitions: rendererFieldDefinitions,\n onSubmit: handleSubmit,\n isSubmitDisabled,\n isPending,\n isLoading: metadataLoading,\n onFieldValueChange: handleFieldValueChange,\n };\n\n if (!isControlled) {\n return <BaseForm {...commonProps} />;\n }\n\n return <BaseForm {...commonProps} formState={controlledFormState} />;\n});\n"],"mappings":"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","ignoreList":[]}

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

@@ -47,12 +47,9 @@ export const BaseForm = /*#__PURE__*/memo(function ({
     onSubmit(controlledFormState ?? rhfValues);
   }, [onSubmit, controlledFormState]);
   return /*#__PURE__*/React.createElement("form", {
-    onSubmit: rhfHandleSubmit(onFormSubmit),
-    "data-testid": "action-form"
-  }, formTitle != null && /*#__PURE__*/React.createElement("h2", {
-    "data-testid": "form-title"
-  }, formTitle), isLoading && fieldDefinitions.length === 0 && /*#__PURE__*/React.createElement("div", {
-    "data-testid": "form-loading"
+    onSubmit: rhfHandleSubmit(onFormSubmit)
+  }, formTitle != null && /*#__PURE__*/React.createElement("h2", null, formTitle), isLoading && fieldDefinitions.length === 0 && /*#__PURE__*/React.createElement("div", {
+    role: "status"
   }, "Loading form fields..."), fieldDefinitions.map(fieldDef => /*#__PURE__*/React.createElement(FieldBridge, {
     key: fieldDef.fieldKey,
     fieldDef: fieldDef,
@@ -60,8 +57,7 @@ export const BaseForm = /*#__PURE__*/memo(function ({
     onExternalChange: onFieldValueChange
   })), /*#__PURE__*/React.createElement("button", {
     type: "submit",
-    disabled: isSubmitDisabled || isPending,
-    "data-testid": "submit-button"
+    disabled: isSubmitDisabled || isPending
   }, isPending ? "Submitting..." : "Submit"));
 });
 function buildDefaultValues(fieldDefinitions) {

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

	@@ -1 +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","map","fieldDef","key","fieldKey","onExternalChange","type","disabled","def","defaultValue"],"sources":["BaseForm.tsx"],"sourcesContent":["/\n Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { memo, useCallback, useMemo } from \"react\";\nimport { useForm } from \"react-hook-form\";\nimport type { BaseFormProps } from \"./ActionFormApi.js\";\nimport { FieldBridge } from \"./fields/FieldBridge.js\";\nimport type { RendererFieldDefinition } from \"./FormFieldApi.js\";\n\nexport const BaseForm: React.FC<BaseFormProps> = memo(function BaseFormFn({\n formTitle,\n fieldDefinitions,\n formState: controlledFormState,\n onFieldValueChange,\n onSubmit,\n isSubmitDisabled = false,\n isPending = false,\n isLoading = false,\n}: BaseFormProps): React.ReactElement {\n const isControlled = controlledFormState != null;\n\n const defaultValues = useMemo(\n () => buildDefaultValues(fieldDefinitions),\n [fieldDefinitions],\n );\n\n const { control, handleSubmit: rhfHandleSubmit } = useForm<\n Record<string, unknown>\n >({\n ...(isControlled ? { values: controlledFormState } : { defaultValues }),\n });\n\n const onFormSubmit = useCallback(\n (rhfValues: Record<string, unknown>) => {\n // In controlled mode, always submit the controlled state, not RHF's\n // internal state. Between a user keystroke and the parent re-rendering,\n // RHF's store may hold the user-typed value rather than the parent's\n // value. Using controlledFormState directly preserves the existing\n // guarantee that controlled mode submits the parent's state.\n onSubmit(controlledFormState ?? rhfValues);\n },\n [onSubmit, controlledFormState],\n );\n\n return (\n <form onSubmit={rhfHandleSubmit(onFormSubmit)} ~~data-testid=\"action-form\"~~>\n {formTitle != null && <h2 ~~data-testid=\"form-title\"~~>{formTitle}</h2>}\n {isLoading && fieldDefinitions.length === 0 && (\n <div ~~data-testid~~=\"~~form-loading~~\">Loading form fields...</div>\n )}\n {fieldDefinitions.map((fieldDef) => (\n <FieldBridge\n key={fieldDef.fieldKey}\n fieldDef={fieldDef}\n control={control}\n onExternalChange={onFieldValueChange}\n />\n ))}\n <button\n type=\"submit\"\n disabled={isSubmitDisabled \|\| isPending}\n ~~data-testid=\"submit-button\"\n~~ >\n {isPending ? \"Submitting...\" : \"Submit\"}\n </button>\n </form>\n );\n});\n\nfunction buildDefaultValues(\n fieldDefinitions: ReadonlyArray<RendererFieldDefinition>,\n): Record<string, unknown> {\n const values: Record<string, unknown> = {};\n for (const def of fieldDefinitions) {\n values[def.fieldKey] = def.defaultValue;\n }\n return values;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,IAAI,EAAEC,WAAW,EAAEC,OAAO,QAAQ,OAAO;AACzD,SAASC,OAAO,QAAQ,iBAAiB;AAEzC,SAASC,WAAW,QAAQ,yBAAyB;AAGrD,OAAO,MAAMC,QAAiC,gBAAGL,IAAI,CAAC,UAAoB;EACxEM,SAAS;EACTC,gBAAgB;EAChBC,SAAS,EAAEC,mBAAmB;EAC9BC,kBAAkB;EAClBC,QAAQ;EACRC,gBAAgB,GAAG,KAAK;EACxBC,SAAS,GAAG,KAAK;EACjBC,SAAS,GAAG;AACC,CAAC,EAAsB;EAGpC,MAAMC,aAAa,GAAGb,OAAO,CAC3B,MAAMc,kBAAkB,CAACT,gBAAgB,CAAC,EAC1C,CAACA,gBAAgB,CACnB,CAAC;EAED,MAAM;IAAEU,OAAO;IAAEC,YAAY,EAAEC;EAAgB,CAAC,GAAGhB,OAAO,CAExD;IACA,IAVmBM,mBAAmB,IAAI,IAAI,GAU3B;MAAEW,MAAM,EAAEX;IAAoB,CAAC,GAAG;MAAEM;IAAc,CAAC;EACxE,CAAC,CAAC;EAEF,MAAMM,YAAY,GAAGpB,WAAW,CAC7BqB,SAAkC,IAAK;IACtC;IACA;IACA;IACA;IACA;IACAX,QAAQ,CAACF,mBAAmB,IAAIa,SAAS,CAAC;EAC5C,CAAC,EACD,CAACX,QAAQ,EAAEF,mBAAmB,CAChC,CAAC;EAED,oBACEV,KAAA,CAAAwB,aAAA;IAAMZ,QAAQ,EAAEQ,eAAe,CAACE,YAAY~~,CAAE~~;~~IAAC~~,~~eAAY;EAAa~~,~~GACrEf,~~SAAS,IAAI,IAAI,iBAAIP,KAAA,CAAAwB,aAAA~~;IAAI~~,~~eAAY;EAAY~~,~~GAAEjB,~~SAAc,CAAC,~~EAClEQ~~,SAAS,IAAIP,gBAAgB,CAACiB,MAAM,KAAK,CAAC,iBACzCzB,KAAA,CAAAwB,aAAA;~~IAAK~~,~~eAAY~~;~~EAAc~~,GAAC,wBAA2B,~~CAC5D~~,~~EACAhB~~,gBAAgB,~~CAACkB~~,GAAG,CAAEC,QAAQ,~~iBAC7B3B~~,KAAA,CAAAwB,aAAA,CAACnB,WAAW;~~IACVuB~~,GAAG,EAAED,QAAQ,CAACE,QAAS;IACvBF,QAAQ,EAAEA,QAAS;~~IACnBT~~,OAAO,EAAEA,OAAQ;~~IACjBY~~,gBAAgB,~~EAAEnB~~;EAAmB,CACtC,CACF,CAAC,eACFX,KAAA,CAAAwB,aAAA;~~IACEO~~,IAAI,EAAC,QAAQ;IACbC,QAAQ,~~EAAEnB~~,gBAAgB,IAAIC~~,SAAU~~;~~IACxC~~,~~eAAY;EAAe~~,~~GAE1BA,~~SAAS,GAAG,eAAe,GAAG,QACzB,CACJ,CAAC;AAEX,CAAC,CAAC;AAEF,SAASG,kBAAkBA,CACzBT,gBAAwD,EAC/B;EACzB,MAAMa,MAA+B,GAAG,CAAC,CAAC;EAC1C,KAAK,~~MAAMY~~,GAAG,~~IAAIzB~~,gBAAgB,EAAE;IAClCa,MAAM,~~CAACY~~,GAAG,CAACJ,QAAQ,CAAC,GAAGI,GAAG,CAACC,YAAY;EACzC;EACA,~~OAAOb~~,MAAM;AACf","ignoreList":[]}
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":[]}

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

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

package/build/esm/action-form/fields/DropdownField.js ADDED Viewed

@@ -0,0 +1,104 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import React, { useCallback } from "react";
+import { Combobox } from "../../base-components/combobox/Combobox.js";
+import { Select } from "../../base-components/select/Select.js";
+import { typedReactMemo } from "../../shared/typedMemo.js";
+export function DropdownField({
+  isSearchable = false,
+  itemToStringLabel,
+  itemToKey,
+  ...rest
+}) {
+  const resolvedItemToStringLabel = itemToStringLabel ?? defaultItemToStringLabel;
+  const getKey = useCallback(item => itemToKey?.(item) ?? resolvedItemToStringLabel(item), [itemToKey, resolvedItemToStringLabel]);
+  if (isSearchable) {
+    return /*#__PURE__*/React.createElement(ComboboxDropdown, _extends({}, rest, {
+      itemToStringLabel: resolvedItemToStringLabel,
+      getKey: getKey
+    }));
+  }
+  return /*#__PURE__*/React.createElement(SelectDropdown, _extends({}, rest, {
+    itemToStringLabel: resolvedItemToStringLabel,
+    getKey: getKey
+  }));
+}
+const SelectDropdown = typedReactMemo(function ({
+  value,
+  onChange,
+  items,
+  itemToStringLabel,
+  getKey,
+  isItemEqual,
+  isMultiple,
+  placeholder
+}) {
+  return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement(Select.Root, {
+    value: value,
+    onValueChange: onChange,
+    multiple: isMultiple,
+    isItemEqualToValue: isItemEqual,
+    itemToStringLabel: itemToStringLabel
+  }, /*#__PURE__*/React.createElement(Select.Trigger, {
+    placeholder: placeholder
+  }), /*#__PURE__*/React.createElement(Select.Portal, null, /*#__PURE__*/React.createElement(Select.Positioner, null, /*#__PURE__*/React.createElement(Select.Popup, null, items.map(item => /*#__PURE__*/React.createElement(Select.Item, {
+    key: getKey(item),
+    value: item
+  }, itemToStringLabel(item))))))));
+});
+const ComboboxDropdown = typedReactMemo(function ({
+  value,
+  onChange,
+  items,
+  itemToStringLabel,
+  getKey,
+  isItemEqual,
+  isMultiple,
+  placeholder
+}) {
+  const renderChips = useCallback(selectedValues => /*#__PURE__*/React.createElement(React.Fragment, null, selectedValues.map(item => /*#__PURE__*/React.createElement(Combobox.Chip, {
+    key: getKey(item),
+    "aria-label": itemToStringLabel(item)
+  }, itemToStringLabel(item), /*#__PURE__*/React.createElement(Combobox.ChipRemove, null))), /*#__PURE__*/React.createElement(Combobox.Input, {
+    placeholder: selectedValues.length > 0 ? "" : placeholder ?? "Search…"
+  })), [getKey, itemToStringLabel, placeholder]);
+  const renderItem = useCallback(item => /*#__PURE__*/React.createElement(Combobox.Item, {
+    key: getKey(item),
+    value: item
+  }, itemToStringLabel(item)), [getKey, itemToStringLabel]);
+  return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement(Combobox.Root, {
+    value: value,
+    onValueChange: onChange,
+    multiple: isMultiple,
+    itemToStringLabel: itemToStringLabel,
+    isItemEqualToValue: isItemEqual,
+    items: items
+  }, isMultiple ? /*#__PURE__*/React.createElement(Combobox.Chips, null, /*#__PURE__*/React.createElement(Combobox.Value, null, renderChips)) : /*#__PURE__*/React.createElement(Combobox.Input, {
+    placeholder: placeholder
+  }), /*#__PURE__*/React.createElement(Combobox.Portal, null, /*#__PURE__*/React.createElement(Combobox.Positioner, null, /*#__PURE__*/React.createElement(Combobox.Popup, null, /*#__PURE__*/React.createElement(Combobox.Empty, null, "No results"), /*#__PURE__*/React.createElement(Combobox.List, null, renderItem))))));
+});
+function defaultItemToStringLabel(item) {
+  if (item == null || typeof item !== "object") {
+    return String(item);
+  }
+  if ("label" in item && item.label != null && typeof item.label === "string") {
+    return item.label;
+  }
+  return String(item);
+}
+//# sourceMappingURL=DropdownField.js.map

package/build/esm/action-form/fields/DropdownField.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"DropdownField.js","names":["React","useCallback","Combobox","Select","typedReactMemo","DropdownField","isSearchable","itemToStringLabel","itemToKey","rest","resolvedItemToStringLabel","defaultItemToStringLabel","getKey","item","createElement","ComboboxDropdown","_extends","SelectDropdown","value","onChange","items","isItemEqual","isMultiple","placeholder","Root","onValueChange","multiple","isItemEqualToValue","Trigger","Portal","Positioner","Popup","map","Item","key","renderChips","selectedValues","Fragment","Chip","ChipRemove","Input","length","renderItem","Chips","Value","Empty","List","String","label"],"sources":["DropdownField.tsx"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React, { useCallback } from \"react\";\nimport { Combobox } from \"../../base-components/combobox/Combobox.js\";\nimport { Select } from \"../../base-components/select/Select.js\";\nimport { typedReactMemo } from \"../../shared/typedMemo.js\";\nimport type { DropdownFieldProps } from \"../FormFieldApi.js\";\n\ninterface InnerDropdownProps<V, Multiple extends boolean>\n extends Omit<DropdownFieldProps<V, Multiple>, \"isSearchable\">\n{\n itemToStringLabel: (item: V) => string;\n getKey: (item: V) => string;\n}\n\nexport function DropdownField<V, Multiple extends boolean = false>({\n isSearchable = false,\n itemToStringLabel,\n itemToKey,\n ...rest\n}: DropdownFieldProps<V, Multiple>): React.ReactElement {\n const resolvedItemToStringLabel = itemToStringLabel\n ?? defaultItemToStringLabel;\n\n const getKey = useCallback(\n (item: V) => itemToKey?.(item) ?? resolvedItemToStringLabel(item),\n [itemToKey, resolvedItemToStringLabel],\n );\n\n if (isSearchable) {\n return (\n <ComboboxDropdown\n {...rest}\n itemToStringLabel={resolvedItemToStringLabel}\n getKey={getKey}\n />\n );\n }\n\n return (\n <SelectDropdown\n {...rest}\n itemToStringLabel={resolvedItemToStringLabel}\n getKey={getKey}\n />\n );\n}\n\nconst SelectDropdown = typedReactMemo(function SelectDropdownFn<\n V,\n Multiple extends boolean,\n>({\n value,\n onChange,\n items,\n itemToStringLabel,\n getKey,\n isItemEqual,\n isMultiple,\n placeholder,\n}: InnerDropdownProps<V, Multiple>): React.ReactElement {\n return (\n <div>\n <Select.Root\n value={value}\n onValueChange={onChange}\n multiple={isMultiple}\n isItemEqualToValue={isItemEqual}\n itemToStringLabel={itemToStringLabel}\n >\n <Select.Trigger placeholder={placeholder} />\n <Select.Portal>\n <Select.Positioner>\n <Select.Popup>\n {items.map((item) => (\n <Select.Item key={getKey(item)} value={item}>\n {itemToStringLabel(item)}\n </Select.Item>\n ))}\n </Select.Popup>\n </Select.Positioner>\n </Select.Portal>\n </Select.Root>\n </div>\n );\n});\n\nconst ComboboxDropdown = typedReactMemo(function ComboboxDropdownFn<\n V,\n Multiple extends boolean,\n>({\n value,\n onChange,\n items,\n itemToStringLabel,\n getKey,\n isItemEqual,\n isMultiple,\n placeholder,\n}: InnerDropdownProps<V, Multiple>): React.ReactElement {\n const renderChips = useCallback(\n (selectedValues: V[]) => (\n <>\n {selectedValues.map((item) => (\n <Combobox.Chip\n key={getKey(item)}\n aria-label={itemToStringLabel(item)}\n >\n {itemToStringLabel(item)}\n <Combobox.ChipRemove />\n </Combobox.Chip>\n ))}\n <Combobox.Input\n placeholder={selectedValues.length > 0\n ? \"\"\n : (placeholder ?? \"Search…\")}\n />\n </>\n ),\n [getKey, itemToStringLabel, placeholder],\n );\n\n const renderItem = useCallback(\n (item: V) => (\n <Combobox.Item key={getKey(item)} value={item}>\n {itemToStringLabel(item)}\n </Combobox.Item>\n ),\n [getKey, itemToStringLabel],\n );\n\n return (\n <div>\n <Combobox.Root\n value={value}\n onValueChange={onChange}\n multiple={isMultiple}\n itemToStringLabel={itemToStringLabel}\n isItemEqualToValue={isItemEqual}\n items={items}\n >\n {isMultiple\n ? (\n <Combobox.Chips>\n <Combobox.Value>{renderChips}</Combobox.Value>\n </Combobox.Chips>\n )\n : <Combobox.Input placeholder={placeholder} />}\n <Combobox.Portal>\n <Combobox.Positioner>\n <Combobox.Popup>\n <Combobox.Empty>No results</Combobox.Empty>\n <Combobox.List>{renderItem}</Combobox.List>\n </Combobox.Popup>\n </Combobox.Positioner>\n </Combobox.Portal>\n </Combobox.Root>\n </div>\n );\n});\n\nfunction defaultItemToStringLabel<V>(item: V): string {\n if (item == null || typeof item !== \"object\") {\n return String(item);\n }\n if (\"label\" in item && item.label != null && typeof item.label === \"string\") {\n return item.label;\n }\n return String(item);\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1,3 +1,4 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 /*
  * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
  *
@@ -15,7 +16,9 @@
  */
 import React, { memo } from "react";
+import { DropdownField } from "./DropdownField.js";
 import { TextInputField } from "./TextInputField.js";
+const EMPTY_ITEMS = [];
 export const FormFieldRenderer = /*#__PURE__*/memo(function ({
   fieldDefinition,
   value,
@@ -27,13 +30,11 @@ export const FormFieldRenderer = /*#__PURE__*/memo(function ({
     helperText,
     helperTextPlacement
   } = fieldDefinition;
-  return /*#__PURE__*/React.createElement("div", {
-    "data-testid": `form-field-${fieldDefinition.fieldKey}`
-  }, label != null && /*#__PURE__*/React.createElement("label", null, label, isRequired === true && /*#__PURE__*/React.createElement("span", {
+  return /*#__PURE__*/React.createElement("div", null, label != null && /*#__PURE__*/React.createElement("label", {
+    htmlFor: fieldDefinition.fieldKey
+  }, label, isRequired === true && /*#__PURE__*/React.createElement("span", {
     "aria-label": "required"
-  }, "*")), renderFieldComponent(fieldDefinition, value, onFieldValueChange), helperText != null && helperTextPlacement !== "tooltip" && /*#__PURE__*/React.createElement("div", {
-    "data-testid": "helper-text"
-  }, helperText));
+  }, "*")), renderFieldComponent(fieldDefinition, value, onFieldValueChange), helperText != null && helperTextPlacement !== "tooltip" && /*#__PURE__*/React.createElement("div", null, helperText));
 });
 function renderFieldComponent(fieldDefinition, value, onChange) {
   switch (fieldDefinition.fieldComponent) {
@@ -41,25 +42,35 @@ function renderFieldComponent(fieldDefinition, value, onChange) {
     // TODO: Render a <textarea> for TEXT_AREA instead of falling through
     case "TEXT_AREA":
       return /*#__PURE__*/React.createElement(TextInputField, {
-        fieldComponent: "TEXT_INPUT"
+        id: fieldDefinition.fieldKey
         // TODO: Use coerceFieldValue
         ,
         value: value != null ? String(value) : "",
         onChange: onChange,
         placeholder: fieldDefinition.placeholder
       });
-    case "NUMBER_INPUT":
     case "DROPDOWN":
+      {
+        const {
+          items = EMPTY_ITEMS,
+          ...dropdownProps
+        } = fieldDefinition.fieldComponentProps ?? {};
+        return /*#__PURE__*/React.createElement(DropdownField, _extends({
+          value: value,
+          onChange: onChange,
+          items: items,
+          placeholder: fieldDefinition.placeholder
+        }, dropdownProps));
+      }
+    case "NUMBER_INPUT":
     case "RADIO_BUTTONS":
     case "DATETIME_PICKER":
     case "FILE_PICKER":
     case "OBJECT_SET":
     case "CUSTOM":
-      return /*#__PURE__*/React.createElement("div", {
-        "data-testid": "unsupported-field"
-      }, "Unsupported field type: ", fieldDefinition.fieldComponent);
+      return /*#__PURE__*/React.createElement("div", null, "Unsupported field type: ", fieldDefinition.fieldComponent);
     default:
-      return assertUnreachableFieldComponent(fieldDefinition.fieldComponent);
+      return assertUnreachableFieldComponent(fieldDefinition);
   }
 }
 function assertUnreachableFieldComponent(value) {

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

	@@ -1 +1 @@
1	- {"version":3,"file":"FormFieldRenderer.js","names":["React","memo","TextInputField","FormFieldRenderer","fieldDefinition","value","onFieldValueChange","label","isRequired","helperText","helperTextPlacement","createElement","fieldKey","renderFieldComponent","onChange","fieldComponent","String","placeholder","assertUnreachableFieldComponent","Error"],"sources":["FormFieldRenderer.tsx"],"sourcesContent":["/\n Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport React, { memo } from \"react\";\nimport type { RendererFieldDefinition } from \"../FormFieldApi.js\";\nimport { TextInputField } from \"./TextInputField.js\";\n\nexport interface FormFieldRendererProps {\n fieldDefinition: RendererFieldDefinition;\n value: unknown;\n onFieldValueChange: (value: unknown) => void;\n}\n\nexport const FormFieldRenderer: React.FC<FormFieldRendererProps> = memo(\n function FormFieldRendererFn({\n fieldDefinition,\n value,\n onFieldValueChange,\n }: FormFieldRendererProps): React.ReactElement {\n const { label, isRequired, helperText, helperTextPlacement } =\n fieldDefinition;\n\n return (\n <div ~~data-testid={`form-field-${fieldDefinition.fieldKey}`}~~>\n {label != null && (\n <label>\n {label}\n {isRequired === true && <span aria-label=\"required\"></span>}\n </label>\n )}\n {renderFieldComponent(fieldDefinition, value, onFieldValueChange)}\n {helperText != null && helperTextPlacement !== \"tooltip\" && (\n <div ~~data-testid=\"helper-text\"~~>{helperText}</div>\n )}\n </div>\n );\n },\n);\n\nfunction renderFieldComponent(\n fieldDefinition: RendererFieldDefinition,\n value: unknown,\n onChange: (value: unknown) => void,\n): React.ReactElement {\n switch (fieldDefinition.fieldComponent) {\n case \"TEXT_INPUT\":\n // TODO: Render a <textarea> for TEXT_AREA instead of falling through\n case \"TEXT_AREA\":\n return (\n <TextInputField\n ~~fieldComponent=\"TEXT_INPUT~~\"\n // TODO: Use coerceFieldValue\n value={value != null ? String(value) : \"\"}\n onChange={onChange}\n placeholder={fieldDefinition.placeholder}\n />\n );\n case \"~~NUMBER_INPUT~~\":\n case \"~~DROPDOWN~~\":\n case \"RADIO_BUTTONS\":\n case \"DATETIME_PICKER\":\n case \"FILE_PICKER\":\n case \"OBJECT_SET\":\n case \"CUSTOM\":\n return (\n <div ~~data-testid=\"unsupported-field\"~~>\n Unsupported field type: {fieldDefinition.fieldComponent}\n </div>\n );\n default:\n return assertUnreachableFieldComponent(fieldDefinition~~.fieldComponent~~);\n }\n}\n\nfunction assertUnreachableFieldComponent(value: never): never {\n throw new Error(`Unhandled field component: ${String(value)}`);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,IAAI,QAAQ,OAAO;AAEnC,SAASC,cAAc,QAAQ,qBAAqB;~~AAQpD~~,OAAO,MAAMC,iBAAmD,~~gBAAGF~~,IAAI,CACrE,UAA6B;~~EAC3BG~~,eAAe;EACfC,KAAK;EACLC;AACsB,CAAC,EAAsB;EAC7C,MAAM;IAAEC,KAAK;IAAEC,UAAU;IAAEC,UAAU;IAAEC;EAAoB,CAAC,GAC1DN,eAAe;EAEjB,~~oBACEJ~~,KAAA,~~CAAAW~~,aAAA~~;IAAK~~,~~eAAa~~,~~cAAcP,eAAe,CAACQ,QAAQ;EAAG,GACxDL,~~KAAK,IAAI,IAAI,~~iBACZP~~,KAAA,~~CAAAW~~,aAAA,~~gBACGJ~~,KAAK,EACLC,UAAU,KAAK,IAAI,~~iBAAIR~~,KAAA,~~CAAAW~~,aAAA;IAAM,cAAW;EAAU,GAAC,GAAO,CACtD,CACR,~~EACAE~~,oBAAoB,~~CAACT~~,eAAe,EAAEC,KAAK,EAAEC,kBAAkB,CAAC,EAChEG,UAAU,IAAI,IAAI,IAAIC,mBAAmB,KAAK,SAAS,~~iBACtDV~~,KAAA,~~CAAAW~~,aAAA~~;IAAK~~,~~eAAY;EAAa~~,~~GAAEF,~~UAAgB,~~CAE/C~~,CAAC;AAEV,CACF,CAAC;AAED,~~SAASI~~,oBAAoBA,~~CAC3BT~~,eAAwC,EACxCC,KAAc,~~EACdS~~,QAAkC,EACd;EACpB,~~QAAQV~~,eAAe,~~CAACW~~,cAAc;IACpC,KAAK,YAAY;IACjB;IACA,KAAK,WAAW;MACd,~~oBACEf~~,KAAA,~~CAAAW~~,aAAA,~~CAACT~~,cAAc;~~QACba~~,~~cAAc~~,~~EAAC~~;~~QACf~~;QAAA;~~QACAV~~,KAAK,EAAEA,KAAK,IAAI,IAAI,~~GAAGW~~,MAAM,~~CAACX~~,KAAK,CAAC,GAAG,EAAG;~~QAC1CS~~,QAAQ,EAAEA,QAAS;~~QACnBG~~,WAAW,~~EAAEb~~,eAAe,~~CAACa~~;MAAY,CAC1C,CAAC;IAEN,KAAK,~~cAAc~~;~~IACnB~~,KAAK,~~UAAU~~;~~IACf~~,KAAK,eAAe;IACpB,KAAK,iBAAiB;IACtB,KAAK,aAAa;IAClB,KAAK,YAAY;IACjB,KAAK,QAAQ;MACX,~~oBACEjB~~,KAAA,~~CAAAW~~,aAAA~~;QAAK~~,~~eAAY;MAAmB~~,~~GAAC~~,~~0BACX,~~EAACP,eAAe,~~CAACW~~,cACtC,CAAC;IAEV;MACE,~~OAAOG~~,+BAA+B,~~CAACd~~,eAAe,~~CAACW,cAAc,~~CAAC;~~EAC1E~~;AACF;AAEA,~~SAASG~~,+BAA+BA,~~CAACb~~,KAAY,EAAS;EAC5D,MAAM,~~IAAIc~~,KAAK,CAAC,~~8BAA8BH~~,MAAM,~~CAACX~~,KAAK,CAAC,EAAE,CAAC;AAChE","ignoreList":[]}
1	+ {"version":3,"file":"FormFieldRenderer.js","names":["React","memo","DropdownField","TextInputField","EMPTY_ITEMS","FormFieldRenderer","fieldDefinition","value","onFieldValueChange","label","isRequired","helperText","helperTextPlacement","createElement","htmlFor","fieldKey","renderFieldComponent","onChange","fieldComponent","id","String","placeholder","items","dropdownProps","fieldComponentProps","_extends","assertUnreachableFieldComponent","Error"],"sources":["FormFieldRenderer.tsx"],"sourcesContent":["/\n Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n \n Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n \n http://www.apache.org/licenses/LICENSE-2.0\n \n Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport React, { memo } from \"react\";\nimport type { RendererFieldDefinition } from \"../FormFieldApi.js\";\nimport { DropdownField } from \"./DropdownField.js\";\nimport { TextInputField } from \"./TextInputField.js\";\n\nconst EMPTY_ITEMS: unknown[] = [];\n\nexport interface FormFieldRendererProps {\n fieldDefinition: RendererFieldDefinition;\n value: unknown;\n onFieldValueChange: (value: unknown) => void;\n}\n\nexport const FormFieldRenderer: React.FC<FormFieldRendererProps> = memo(\n function FormFieldRendererFn({\n fieldDefinition,\n value,\n onFieldValueChange,\n }: FormFieldRendererProps): React.ReactElement {\n const { label, isRequired, helperText, helperTextPlacement } =\n fieldDefinition;\n\n return (\n <div>\n {label != null && (\n <label htmlFor={fieldDefinition.fieldKey}>\n {label}\n {isRequired === true && <span aria-label=\"required\"></span>}\n </label>\n )}\n {renderFieldComponent(fieldDefinition, value, onFieldValueChange)}\n {helperText != null && helperTextPlacement !== \"tooltip\" && (\n <div>{helperText}</div>\n )}\n </div>\n );\n },\n);\n\nfunction renderFieldComponent(\n fieldDefinition: RendererFieldDefinition,\n value: unknown,\n onChange: (value: unknown) => void,\n): React.ReactElement {\n switch (fieldDefinition.fieldComponent) {\n case \"TEXT_INPUT\":\n // TODO: Render a <textarea> for TEXT_AREA instead of falling through\n case \"TEXT_AREA\":\n return (\n <TextInputField\n id={fieldDefinition.fieldKey}\n // TODO: Use coerceFieldValue\n value={value != null ? String(value) : \"\"}\n onChange={onChange}\n placeholder={fieldDefinition.placeholder}\n />\n );\n case \"DROPDOWN\": {\n const { items = EMPTY_ITEMS, ...dropdownProps } =\n fieldDefinition.fieldComponentProps ?? {};\n return (\n <DropdownField\n value={value}\n onChange={onChange}\n items={items}\n placeholder={fieldDefinition.placeholder}\n {...dropdownProps}\n />\n );\n }\n case \"NUMBER_INPUT\":\n case \"RADIO_BUTTONS\":\n case \"DATETIME_PICKER\":\n case \"FILE_PICKER\":\n case \"OBJECT_SET\":\n case \"CUSTOM\":\n return (\n <div>\n Unsupported field type: {fieldDefinition.fieldComponent}\n </div>\n );\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":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAIC,IAAI,QAAQ,OAAO;AAEnC,SAASC,aAAa,QAAQ,oBAAoB;AAClD,SAASC,cAAc,QAAQ,qBAAqB;AAEpD,MAAMC,WAAsB,GAAG,EAAE;AAQjC,OAAO,MAAMC,iBAAmD,gBAAGJ,IAAI,CACrE,UAA6B;EAC3BK,eAAe;EACfC,KAAK;EACLC;AACsB,CAAC,EAAsB;EAC7C,MAAM;IAAEC,KAAK;IAAEC,UAAU;IAAEC,UAAU;IAAEC;EAAoB,CAAC,GAC1DN,eAAe;EAEjB,oBACEN,KAAA,CAAAa,aAAA,cACGJ,KAAK,IAAI,IAAI,iBACZT,KAAA,CAAAa,aAAA;IAAOC,OAAO,EAAER,eAAe,CAACS;EAAS,GACtCN,KAAK,EACLC,UAAU,KAAK,IAAI,iBAAIV,KAAA,CAAAa,aAAA;IAAM,cAAW;EAAU,GAAC,GAAO,CACtD,CACR,EACAG,oBAAoB,CAACV,eAAe,EAAEC,KAAK,EAAEC,kBAAkB,CAAC,EAChEG,UAAU,IAAI,IAAI,IAAIC,mBAAmB,KAAK,SAAS,iBACtDZ,KAAA,CAAAa,aAAA,cAAMF,UAAgB,CAErB,CAAC;AAEV,CACF,CAAC;AAED,SAASK,oBAAoBA,CAC3BV,eAAwC,EACxCC,KAAc,EACdU,QAAkC,EACd;EACpB,QAAQX,eAAe,CAACY,cAAc;IACpC,KAAK,YAAY;IACjB;IACA,KAAK,WAAW;MACd,oBACElB,KAAA,CAAAa,aAAA,CAACV,cAAc;QACbgB,EAAE,EAAEb,eAAe,CAACS;QACpB;QAAA;QACAR,KAAK,EAAEA,KAAK,IAAI,IAAI,GAAGa,MAAM,CAACb,KAAK,CAAC,GAAG,EAAG;QAC1CU,QAAQ,EAAEA,QAAS;QACnBI,WAAW,EAAEf,eAAe,CAACe;MAAY,CAC1C,CAAC;IAEN,KAAK,UAAU;MAAE;QACf,MAAM;UAAEC,KAAK,GAAGlB,WAAW;UAAE,GAAGmB;QAAc,CAAC,GAC7CjB,eAAe,CAACkB,mBAAmB,IAAI,CAAC,CAAC;QAC3C,oBACExB,KAAA,CAAAa,aAAA,CAACX,aAAa,EAAAuB,QAAA;UACZlB,KAAK,EAAEA,KAAM;UACbU,QAAQ,EAAEA,QAAS;UACnBK,KAAK,EAAEA,KAAM;UACbD,WAAW,EAAEf,eAAe,CAACe;QAAY,GACrCE,aAAa,CAClB,CAAC;MAEN;IACA,KAAK,cAAc;IACnB,KAAK,eAAe;IACpB,KAAK,iBAAiB;IACtB,KAAK,aAAa;IAClB,KAAK,YAAY;IACjB,KAAK,QAAQ;MACX,oBACEvB,KAAA,CAAAa,aAAA,cAAK,0BACqB,EAACP,eAAe,CAACY,cACtC,CAAC;IAEV;MACE,OAAOQ,+BAA+B,CAACpB,eAAe,CAAC;EAC3D;AACF;AAEA,SAASoB,+BAA+BA,CAACnB,KAAY,EAAS;EAC5D,MAAM,IAAIoB,KAAK,CAAC,8BAA8BP,MAAM,CAACb,KAAK,CAAC,EAAE,CAAC;AAChE","ignoreList":[]}