@osdk/react-components 0.2.0-beta.9 → 0.2.1-main-20260407074313

package/build/cjs/public/primitives.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+var chunkMRRRZN44_cjs = require('../chunk-MRRRZN44.cjs');
+require('../chunk-HMQTYQEX.cjs');
+
+
+
+Object.defineProperty(exports, "ActionButton", {
+  enumerable: true,
+  get: function () { return chunkMRRRZN44_cjs.ActionButton; }
+});
+Object.defineProperty(exports, "Dialog", {
+  enumerable: true,
+  get: function () { return chunkMRRRZN44_cjs.Dialog; }
+});
+Object.defineProperty(exports, "Tooltip", {
+  enumerable: true,
+  get: function () { return chunkMRRRZN44_cjs.Tooltip; }
+});
+Object.defineProperty(exports, "TooltipArrow", {
+  enumerable: true,
+  get: function () { return chunkMRRRZN44_cjs.TooltipArrow; }
+});
+//# sourceMappingURL=primitives.cjs.map
+//# sourceMappingURL=primitives.cjs.map

package/build/cjs/public/primitives.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"primitives.cjs"}

package/build/cjs/public/primitives.css

@@ -0,0 +1,154 @@
+/* src/base-components/action-button/ActionButton.module.css */
+.button {
+  padding: calc(var(--osdk-surface-spacing) * 2) calc(var(--osdk-surface-spacing) * 4);
+  border-radius: var(--osdk-surface-border-radius);
+  font-size: var(--osdk-typography-size-body-medium);
+  cursor: pointer;
+  &:focus-visible {
+    outline: var(--osdk-focus-outline);
+    outline-offset: var(--osdk-focus-visible-outline-offset);
+  }
+}
+.secondaryButton {
+  background-color: var(--osdk-button-secondary-bg);
+  border: var(--osdk-surface-border);
+  color: var(--osdk-button-secondary-color);
+  &:hover:not(:disabled) {
+    background-color: var(--osdk-button-secondary-bg-hover);
+  }
+  &:active:not(:disabled) {
+    background-color: var(--osdk-button-secondary-bg-active);
+  }
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+}
+.primaryButton {
+  background-color: var(--osdk-button-primary-bg);
+  border: none;
+  color: var(--osdk-button-primary-color);
+  &:hover:not(:disabled) {
+    background-color: var(--osdk-button-primary-bg-hover);
+  }
+  &:active:not(:disabled) {
+    background-color: var(--osdk-button-primary-bg-active);
+  }
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+}
+
+/* src/base-components/dialog/Dialog.module.css */
+.backdrop {
+  position: fixed;
+  inset: 0;
+  background-color: var(--osdk-dialog-backdrop-bg);
+  z-index: var(--osdk-surface-z-index-1);
+}
+.popup {
+  position: fixed;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  min-width: var(--osdk-dialog-min-width);
+  max-width: var(--osdk-dialog-max-width);
+  min-height: var(--osdk-dialog-min-height);
+  max-height: var(--osdk-dialog-max-height);
+  background-color: var(--osdk-dialog-bg);
+  border-radius: var(--osdk-surface-border-radius);
+  box-shadow: var(--osdk-dialog-shadow);
+  z-index: var(--osdk-surface-z-index-2);
+  display: flex;
+  flex-direction: column;
+}
+.header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: var(--osdk-dialog-header-padding);
+  border-bottom: var(--osdk-surface-border);
+}
+.title {
+  font-size: var(--osdk-dialog-title-font-size);
+  font-weight: var(--osdk-dialog-title-font-weight);
+}
+.body {
+  display: flex;
+  padding: var(--osdk-dialog-body-padding);
+  overflow-y: auto;
+  flex: 1;
+}
+.footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: calc(var(--osdk-surface-spacing) * 2);
+  padding: var(--osdk-dialog-footer-padding);
+  border-top: var(--osdk-surface-border);
+}
+.closeButton {
+  background: none;
+  border: none;
+  padding: calc(var(--osdk-surface-spacing) * 0.5);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: var(--osdk-surface-border-radius);
+  &:hover {
+    background-color: var(--osdk-surface-background-color-default-hover);
+  }
+  &:focus-visible {
+    outline: var(--osdk-focus-outline);
+    outline-offset: var(--osdk-focus-visible-outline-offset);
+  }
+}
+.closeIcon {
+  width: var(--osdk-iconography-size-small);
+  height: var(--osdk-iconography-size-small);
+  color: var(--osdk-typography-color-muted);
+}
+
+/* src/base-components/tooltip/Tooltip.module.css */
+.osdkTooltipTrigger {
+  border: none;
+  background: inherit;
+}
+.osdkTooltipPositioner {
+  z-index: var(--osdk-tooltip-z-index);
+}
+.osdkTooltipPopup {
+  padding: var(--osdk-tooltip-padding);
+  background-color: var(--osdk-tooltip-bg);
+  border-radius: var(--osdk-surface-border-radius);
+  box-shadow: var(--osdk-tooltip-shadow);
+  max-width: var(--osdk-tooltip-max-width);
+  font-size: var(--osdk-tooltip-font-size);
+}
+.osdkTooltipArrow {
+  display: flex;
+  &[data-side=top] {
+    bottom: -8px;
+    rotate: 180deg;
+  }
+  &[data-side=bottom] {
+    top: -8px;
+    rotate: 0deg;
+  }
+  &[data-side=left] {
+    right: -13px;
+    rotate: 90deg;
+  }
+  &[data-side=right] {
+    left: -13px;
+    rotate: -90deg;
+  }
+}
+.tooltipArrowFill {
+  fill: var(--osdk-tooltip-bg);
+}
+.tooltipArrowOuterStroke {
+  fill: var(--osdk-tooltip-border-color);
+}
+/*# sourceMappingURL=primitives.css.map */

package/build/cjs/public/primitives.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/base-components/action-button/ActionButton.module.css","../../../src/base-components/dialog/Dialog.module.css","../../../src/base-components/tooltip/Tooltip.module.css"],"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\n.button {\n  padding: calc(var(--osdk-surface-spacing) * 2)\n    calc(var(--osdk-surface-spacing) * 4);\n  border-radius: var(--osdk-surface-border-radius);\n  font-size: var(--osdk-typography-size-body-medium);\n  cursor: pointer;\n\n  &:focus-visible {\n    outline: var(--osdk-focus-outline);\n    outline-offset: var(--osdk-focus-visible-outline-offset);\n  }\n}\n\n.secondaryButton {\n  background-color: var(--osdk-button-secondary-bg);\n  border: var(--osdk-surface-border);\n  color: var(--osdk-button-secondary-color);\n\n  &:hover:not(:disabled) {\n    background-color: var(--osdk-button-secondary-bg-hover);\n  }\n\n  &:active:not(:disabled) {\n    background-color: var(--osdk-button-secondary-bg-active);\n  }\n\n  &:disabled {\n    opacity: 0.5;\n    cursor: not-allowed;\n  }\n}\n\n.primaryButton {\n  background-color: var(--osdk-button-primary-bg);\n  border: none;\n  color: var(--osdk-button-primary-color);\n\n  &:hover:not(:disabled) {\n    background-color: var(--osdk-button-primary-bg-hover);\n  }\n\n  &:active:not(:disabled) {\n    background-color: var(--osdk-button-primary-bg-active);\n  }\n\n  &:disabled {\n    opacity: 0.5;\n    cursor: not-allowed;\n  }\n}\n","/*\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\n.backdrop {\n  position: fixed;\n  inset: 0;\n  background-color: var(--osdk-dialog-backdrop-bg);\n  z-index: var(--osdk-surface-z-index-1);\n}\n\n.popup {\n  position: fixed;\n  top: 50%;\n  left: 50%;\n  transform: translate(-50%, -50%);\n  min-width: var(--osdk-dialog-min-width);\n  max-width: var(--osdk-dialog-max-width);\n  min-height: var(--osdk-dialog-min-height);\n  max-height: var(--osdk-dialog-max-height);\n  background-color: var(--osdk-dialog-bg);\n  border-radius: var(--osdk-surface-border-radius);\n  box-shadow: var(--osdk-dialog-shadow);\n  z-index: var(--osdk-surface-z-index-2);\n  display: flex;\n  flex-direction: column;\n}\n\n.header {\n  display: flex;\n  justify-content: space-between;\n  align-items: center;\n  padding: var(--osdk-dialog-header-padding);\n  border-bottom: var(--osdk-surface-border);\n}\n\n.title {\n  font-size: var(--osdk-dialog-title-font-size);\n  font-weight: var(--osdk-dialog-title-font-weight);\n}\n\n.body {\n  display: flex;\n  padding: var(--osdk-dialog-body-padding);\n  overflow-y: auto;\n  flex: 1;\n}\n\n.footer {\n  display: flex;\n  justify-content: flex-end;\n  gap: calc(var(--osdk-surface-spacing) * 2);\n  padding: var(--osdk-dialog-footer-padding);\n  border-top: var(--osdk-surface-border);\n}\n\n.closeButton {\n  background: none;\n  border: none;\n  padding: calc(var(--osdk-surface-spacing) * 0.5);\n  cursor: pointer;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  border-radius: var(--osdk-surface-border-radius);\n\n  &:hover {\n    background-color: var(--osdk-surface-background-color-default-hover);\n  }\n\n  &:focus-visible {\n    outline: var(--osdk-focus-outline);\n    outline-offset: var(--osdk-focus-visible-outline-offset);\n  }\n}\n\n.closeIcon {\n  width: var(--osdk-iconography-size-small);\n  height: var(--osdk-iconography-size-small);\n  color: var(--osdk-typography-color-muted);\n}\n","/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n.osdkTooltipTrigger {\n  border: none;\n  background: inherit;\n}\n\n.osdkTooltipPositioner {\n  z-index: var(--osdk-tooltip-z-index);\n}\n\n.osdkTooltipPopup {\n  padding: var(--osdk-tooltip-padding);\n  background-color: var(--osdk-tooltip-bg);\n  border-radius: var(--osdk-surface-border-radius);\n  box-shadow: var(--osdk-tooltip-shadow);\n  max-width: var(--osdk-tooltip-max-width);\n  font-size: var(--osdk-tooltip-font-size);\n}\n\n/* \n * Hardcoded values are copied from base ui example \n * https://base-ui.com/react/components/tooltip \n *\n * */\n.osdkTooltipArrow {\n  display: flex;\n\n  &[data-side=\"top\"] {\n    bottom: -8px;\n    rotate: 180deg;\n  }\n\n  &[data-side=\"bottom\"] {\n    top: -8px;\n    rotate: 0deg;\n  }\n\n  &[data-side=\"left\"] {\n    right: -13px;\n    rotate: 90deg;\n  }\n\n  &[data-side=\"right\"] {\n    left: -13px;\n    rotate: -90deg;\n  }\n}\n\n.tooltipArrowFill {\n  fill: var(--osdk-tooltip-bg);\n}\n\n.tooltipArrowOuterStroke {\n  fill: var(--osdk-tooltip-border-color);\n}\n"],"mappings":";AAgBA,CAAC;AACC,WAAS,KAAK,IAAI,wBAAwB,EAAE,GAC1C,KAAK,IAAI,wBAAwB,EAAE;AACrC,iBAAe,IAAI;AACnB,aAAW,IAAI;AACf,UAAQ;AAER,GAAC;AACC,aAAS,IAAI;AACb,oBAAgB,IAAI;AACtB;AACF;AAEA,CAAC;AACC,oBAAkB,IAAI;AACtB,UAAQ,IAAI;AACZ,SAAO,IAAI;AAEX,GAAC,MAAM,KAAK;AACV,sBAAkB,IAAI;AACxB;AAEA,GAAC,OAAO,KAAK;AACX,sBAAkB,IAAI;AACxB;AAEA,GAAC;AACC,aAAS;AACT,YAAQ;AACV;AACF;AAEA,CAAC;AACC,oBAAkB,IAAI;AACtB,UAAQ;AACR,SAAO,IAAI;AAEX,GAAC,MAAM,KAAK;AACV,sBAAkB,IAAI;AACxB;AAEA,GAAC,OAAO,KAAK;AACX,sBAAkB,IAAI;AACxB;AAEA,GAAC;AACC,aAAS;AACT,YAAQ;AACV;AACF;;;ACjDA,CAAC;AACC,YAAU;AACV,SAAO;AACP,oBAAkB,IAAI;AACtB,WAAS,IAAI;AACf;AAEA,CAAC;AACC,YAAU;AACV,OAAK;AACL,QAAM;AACN,aAAW,UAAU,IAAI,EAAE;AAC3B,aAAW,IAAI;AACf,aAAW,IAAI;AACf,cAAY,IAAI;AAChB,cAAY,IAAI;AAChB,oBAAkB,IAAI;AACtB,iBAAe,IAAI;AACnB,cAAY,IAAI;AAChB,WAAS,IAAI;AACb,WAAS;AACT,kBAAgB;AAClB;AAEA,CAAC;AACC,WAAS;AACT,mBAAiB;AACjB,eAAa;AACb,WAAS,IAAI;AACb,iBAAe,IAAI;AACrB;AAEA,CAAC;AACC,aAAW,IAAI;AACf,eAAa,IAAI;AACnB;AAEA,CAAC;AACC,WAAS;AACT,WAAS,IAAI;AACb,cAAY;AACZ,QAAM;AACR;AAEA,CAAC;AACC,WAAS;AACT,mBAAiB;AACjB,OAAK,KAAK,IAAI,wBAAwB,EAAE;AACxC,WAAS,IAAI;AACb,cAAY,IAAI;AAClB;AAEA,CAAC;AACC,cAAY;AACZ,UAAQ;AACR,WAAS,KAAK,IAAI,wBAAwB,EAAE;AAC5C,UAAQ;AACR,WAAS;AACT,eAAa;AACb,mBAAiB;AACjB,iBAAe,IAAI;AAEnB,GAAC;AACC,sBAAkB,IAAI;AACxB;AAEA,GAAC;AACC,aAAS,IAAI;AACb,oBAAgB,IAAI;AACtB;AACF;AAEA,CAAC;AACC,SAAO,IAAI;AACX,UAAQ,IAAI;AACZ,SAAO,IAAI;AACb;;;AC5EA,CAAC;AACC,UAAQ;AACR,cAAY;AACd;AAEA,CAAC;AACC,WAAS,IAAI;AACf;AAEA,CAAC;AACC,WAAS,IAAI;AACb,oBAAkB,IAAI;AACtB,iBAAe,IAAI;AACnB,cAAY,IAAI;AAChB,aAAW,IAAI;AACf,aAAW,IAAI;AACjB;AAOA,CAAC;AACC,WAAS;AAET,GAAC,CAAC;AACA,YAAQ;AACR,YAAQ;AACV;AAEA,GAAC,CAAC;AACA,SAAK;AACL,YAAQ;AACV;AAEA,GAAC,CAAC;AACA,WAAO;AACP,YAAQ;AACV;AAEA,GAAC,CAAC;AACA,UAAM;AACN,YAAQ;AACV;AACF;AAEA,CAAC;AACC,QAAM,IAAI;AACZ;AAEA,CAAC;AACC,QAAM,IAAI;AACZ;","names":[]}

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

@@ -0,0 +1,50 @@
+import React__default from 'react';
+import { TooltipRootProps, TooltipProviderProps, TooltipTriggerProps, Tooltip as Tooltip$1, TooltipPositionerProps, TooltipPopupProps } from '@base-ui/react/tooltip';
+
+interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: "primary" | "secondary";
+}
+declare function ActionButton({ variant, className, ...rest }: ButtonProps): React__default.ReactElement;
+
+interface DialogProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: React__default.ReactNode;
+    children: React__default.ReactNode;
+    footer?: React__default.ReactNode;
+    className?: string;
+    disablePointerDismissal?: boolean;
+}
+declare function Dialog({ isOpen, onOpenChange, title, children, footer, className, disablePointerDismissal, }: DialogProps): React__default.ReactElement;
+
+interface TooltipProps extends Omit<TooltipRootProps, "className"> {
+}
+declare function TooltipRoot({ children, ...rest }: TooltipProps): React__default.ReactElement;
+interface TooltipProviderComponentProps extends Omit<TooltipProviderProps, "className"> {
+    className?: string;
+}
+declare function TooltipProvider({ children, ...rest }: TooltipProviderComponentProps): React__default.ReactElement;
+interface TooltipTriggerComponentProps extends Omit<TooltipTriggerProps, "className"> {
+    className?: string;
+}
+declare function TooltipTrigger({ className, children, ...rest }: TooltipTriggerComponentProps): React__default.ReactElement;
+interface TooltipPositionerComponentProps extends Omit<TooltipPositionerProps, "className"> {
+    className?: string;
+}
+declare function TooltipPositioner({ className, children, sideOffset, ...rest }: TooltipPositionerComponentProps): React__default.ReactElement;
+interface TooltipPopupComponentProps extends Omit<TooltipPopupProps, "className"> {
+    className?: string;
+}
+declare function TooltipPopup({ className, children, ...rest }: TooltipPopupComponentProps): React__default.ReactElement;
+declare function TooltipArrow(): React__default.ReactElement;
+declare const Tooltip: {
+    Root: typeof TooltipRoot;
+    Provider: typeof TooltipProvider;
+    Trigger: typeof TooltipTrigger;
+    Portal: typeof Tooltip$1.Portal;
+    Positioner: typeof TooltipPositioner;
+    Popup: typeof TooltipPopup;
+    Arrow: typeof TooltipArrow;
+};
+
+export { ActionButton, type ButtonProps, Dialog, type DialogProps, Tooltip, TooltipArrow, type TooltipProps };

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

@@ -0,0 +1,117 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useOsdkMetadata } from "@osdk/react";
+import { useOsdkAction } from "@osdk/react/experimental";
+import React, { useCallback, useEffect, useMemo } from "react";
+import { typedReactMemo } from "../shared/typedMemo.js";
+import { BaseForm } from "./BaseForm.js";
+import { coerceFieldValue } from "./utils/coerceFieldValue.js";
+import { getDefaultFieldDefinitions } from "./utils/getDefaultFieldDefinitions.js";
+const EMPTY_FIELD_DEFINITIONS = [];
+export const ActionForm = typedReactMemo(function ({
+  actionDefinition,
+  formTitle,
+  formFieldDefinitions,
+  formState: controlledFormState,
+  onFormStateChange,
+  isSubmitDisabled,
+  onSubmit,
+  onValidationResponse: _onValidationResponse,
+  onSuccess,
+  onError
+}) {
+  const {
+    applyAction: osdkApplyAction,
+    isPending
+  } = useOsdkAction(actionDefinition);
+  const {
+    metadata,
+    loading: metadataLoading,
+    error: metadataError
+  } = useOsdkMetadata(actionDefinition);
+  useEffect(function () {
+    if (metadataError != null) {
+      onError?.({
+        type: "unknown",
+        error: metadataError
+      });
+    }
+  }, [metadataError, onError]);
+  const parameters = metadata?.parameters;
+  const customFieldDefinitions = useMemo(() => {
+    if (formFieldDefinitions == null) {
+      return null;
+    }
+    // RendererFieldDefinition is a discriminated union keyed by fieldComponent.
+    // TypeScript can't verify that the spread preserves the fieldComponent ↔
+    // fieldComponentProps pairing, but FormFieldDefinition guarantees it.
+    return formFieldDefinitions.map(def => ({
+      ...def,
+      fieldKey: String(def.fieldKey),
+      fieldType: parameters?.[String(def.fieldKey)]?.type,
+      defaultValue: def.defaultValue
+    }));
+  }, [formFieldDefinitions, parameters]);
+  const rendererFieldDefinitions = useMemo(() => customFieldDefinitions ?? (metadata != null ? getDefaultFieldDefinitions(metadata) : EMPTY_FIELD_DEFINITIONS), [customFieldDefinitions, metadata]);
+  const coerceFormState = useCallback(rawState => {
+    const coerced = {};
+    for (const [key, value] of Object.entries(rawState)) {
+      coerced[key] = coerceFieldValue(parameters?.[key]?.type, value);
+    }
+    return coerced;
+  }, [parameters]);
+  const handleSubmit = useCallback(async rawFormState => {
+    const formState = coerceFormState(rawFormState);
+    try {
+      if (onSubmit != null) {
+        await onSubmit(formState, osdkApplyAction);
+      } else {
+        const result = await osdkApplyAction(formState);
+        onSuccess?.(result);
+      }
+    } catch (e) {
+      onError?.({
+        type: "submission",
+        error: e
+      });
+    }
+  }, [coerceFormState, onSubmit, osdkApplyAction, onSuccess, onError]);
+  const handleFieldValueChange = useCallback((fieldKey, value) => {
+    onFormStateChange?.(prev => ({
+      ...prev,
+      [fieldKey]: value
+    }));
+  }, [onFormStateChange]);
+  const resolvedTitle = formTitle ?? metadata?.displayName ?? actionDefinition.apiName;
+  const commonProps = {
+    formTitle: resolvedTitle,
+    fieldDefinitions: rendererFieldDefinitions,
+    onSubmit: handleSubmit,
+    isSubmitDisabled,
+    isPending,
+    isLoading: metadataLoading,
+    onFieldValueChange: handleFieldValueChange
+  };
+  if (!(controlledFormState != null)) {
+    return /*#__PURE__*/React.createElement(BaseForm, commonProps);
+  }
+  return /*#__PURE__*/React.createElement(BaseForm, _extends({}, commonProps, {
+    formState: controlledFormState
+  }));
+});
+//# sourceMappingURL=ActionForm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionForm.js","names":["useOsdkMetadata","useOsdkAction","React","useCallback","useEffect","useMemo","typedReactMemo","BaseForm","coerceFieldValue","getDefaultFieldDefinitions","EMPTY_FIELD_DEFINITIONS","ActionForm","actionDefinition","formTitle","formFieldDefinitions","formState","controlledFormState","onFormStateChange","isSubmitDisabled","onSubmit","onValidationResponse","_onValidationResponse","onSuccess","onError","applyAction","osdkApplyAction","isPending","metadata","loading","metadataLoading","error","metadataError","type","parameters","customFieldDefinitions","map","def","fieldKey","String","fieldType","defaultValue","rendererFieldDefinitions","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 customFieldDefinitions: ReadonlyArray<RendererFieldDefinition> | null =\n    useMemo(() => {\n      if (formFieldDefinitions == null) {\n        return null;\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      return formFieldDefinitions.map(\n        (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    }, [formFieldDefinitions, parameters]);\n\n  const rendererFieldDefinitions = useMemo(\n    () =>\n      customFieldDefinitions\n        ?? (metadata != null\n          ? getDefaultFieldDefinitions(metadata)\n          : EMPTY_FIELD_DEFINITIONS),\n    [customFieldDefinitions, metadata],\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/ActionFormApi.js.map

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

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

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

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

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

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

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

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

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

package/build/esm/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/esm/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);
+}