@airtable/blocks 0.0.0-experimental-20e3506bd-20250428

package/dist/types/src/base/ui/confirmation_dialog.d.ts

@@ -0,0 +1,83 @@
+/** @module @airtable/blocks/ui: Dialog */ /** */
+import PropTypes from 'prop-types';
+import * as React from 'react';
+import { DialogStyleProps } from './dialog';
+/**
+ * Props for the {@link ConfirmationDialog} component. Also accepts:
+ * * {@link DialogStyleProps}
+ *
+ * @noInheritDoc
+ * @docsPath UI/components/ConfirmationDialog
+ */
+interface ConfirmationDialogProps extends DialogStyleProps {
+    /** Extra styles to apply to the dialog element. */
+    style?: React.CSSProperties;
+    /** The title of the dialog. */
+    title: string;
+    /** The label for the cancel button. Defaults to 'Cancel'. */
+    cancelButtonText?: string;
+    /** The label for the confirm button. Defaults to 'Confirm'. */
+    confirmButtonText?: string;
+    /** Whether the action is dangerous (potentially destructive or not easily reversible). Defaults to `false`. */
+    isConfirmActionDangerous: boolean;
+    /** Extra `className`s to apply to the dialog element, separated by spaces. */
+    className?: string;
+    /** The body of the dialog. When it’s a string it will automatically be wrapped in a Text component. */
+    body?: React.ReactNode | string;
+    /** Extra `className`s to apply to the background element, separated by spaces. */
+    backgroundClassName?: string;
+    /** Extra styles to apply to the background element. */
+    backgroundStyle?: React.CSSProperties;
+    /** Cancel button event handler. Handles click events and Space/Enter keypress events. */
+    onCancel: () => unknown;
+    /** Confirm button event handler. Handles click events and Space/Enter keypress events. */
+    onConfirm: () => unknown;
+    /** Whether the cancel button can be interacted with. Defaults to `false`. */
+    isCancelButtonDisabled?: boolean;
+    /** Whether the confirm button can be interacted with. Defaults to `false`. */
+    isConfirmButtonDisabled?: boolean;
+}
+/**
+ * A styled modal dialog component that prompts the user to confirm or cancel an action.
+ *
+ * [[ Story id="confirmationdialog--example" title="Confirmation dialog example" ]]
+ *
+ * By default, this component will focus the "Confirm" button on mount, so that pressing
+ * the Enter key will confirm the action.
+ *
+ * @component
+ * @docsPath UI/components/ConfirmationDialog
+ */
+declare class ConfirmationDialog extends React.Component<ConfirmationDialogProps> {
+    /** @hidden */
+    static propTypes: {
+        title: PropTypes.Validator<string>;
+        body: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        cancelButtonText: PropTypes.Requireable<string>;
+        confirmButtonText: PropTypes.Requireable<string>;
+        isConfirmActionDangerous: PropTypes.Requireable<boolean>;
+        className: PropTypes.Requireable<string>;
+        style: PropTypes.Requireable<object>;
+        backgroundClassName: PropTypes.Requireable<string>;
+        backgroundStyle: PropTypes.Requireable<object>;
+        onCancel: PropTypes.Validator<(...args: any[]) => any>;
+        onConfirm: PropTypes.Validator<(...args: any[]) => any>;
+        isCancelButtonDisabled: PropTypes.Requireable<boolean>;
+        isConfirmButtonDisabled: PropTypes.Requireable<boolean>;
+    };
+    /** @hidden */
+    static defaultProps: {
+        cancelButtonText: string;
+        confirmButtonText: string;
+        isConfirmActionDangerous: boolean;
+        isCancelButtonDisabled: boolean;
+        isConfirmButtonDisabled: boolean;
+        width: string;
+    };
+    /** @hidden */
+    componentDidMount(): void;
+    /** @hidden */
+    render(): React.JSX.Element;
+}
+export default ConfirmationDialog;
+//# sourceMappingURL=confirmation_dialog.d.ts.map

package/dist/types/src/base/ui/confirmation_dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation_dialog.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/confirmation_dialog.tsx"],"names":[],"mappings":"AAAA,0CAA0C,CAAC,MAAM;AACjD,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAe,EAAC,gBAAgB,EAAuB,MAAM,UAAU,CAAC;AAMxE;;;;;;GAMG;AACH,UAAU,uBAAwB,SAAQ,gBAAgB;IACtD,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+GAA+G;IAC/G,wBAAwB,EAAE,OAAO,CAAC;IAClC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;IAChC,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACtC,yFAAyF;IACzF,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,8EAA8E;IAC9E,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,cAAM,kBAAmB,SAAQ,KAAK,CAAC,SAAS,CAAC,uBAAuB,CAAC;IACrE,cAAc;IACd,MAAM,CAAC,SAAS;;;;;;;;;;;;;;MAed;IACF,cAAc;IACd,MAAM,CAAC,YAAY;;;;;;;MAOjB;IAGF,cAAc;IACd,iBAAiB;IAKjB,cAAc;IACd,MAAM;CA2DT;AAED,eAAe,kBAAkB,CAAC"}

package/dist/types/src/base/ui/control_sizes.d.ts

@@ -0,0 +1,17 @@
+import { EnumType } from '../../shared/private_utils';
+import { ResponsiveProp } from './system/utils/types';
+/**
+ * Sizes for the {@link Button}, {@link Input}, {@link Select}, {@link SelectButtons}, and {@link Switch} components.
+ */
+export type ControlSize = EnumType<typeof ControlSize>;
+export declare const ControlSize: {
+    small: "small";
+    default: "default";
+    large: "large";
+};
+/**
+ * Size prop for the {@link Button}, {@link Input}, {@link Select}, {@link SelectButtons}, and {@link Switch} components.
+ */
+export type ControlSizeProp = ResponsiveProp<ControlSize>;
+export declare const controlSizePropType: import("prop-types").Validator<any>;
+//# sourceMappingURL=control_sizes.d.ts.map

package/dist/types/src/base/ui/control_sizes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control_sizes.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/control_sizes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAMpD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC;AACvD,eAAO,MAAM,WAAW;;;;CAA0C,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAC1D,eAAO,MAAM,mBAAmB,qCAAgD,CAAC"}

package/dist/types/src/base/ui/css_helpers.d.ts

@@ -0,0 +1,6 @@
+declare const cssHelpers: {
+    TRUNCATE: string;
+    VISUALLY_HIDDEN: string;
+};
+export default cssHelpers;
+//# sourceMappingURL=css_helpers.d.ts.map

package/dist/types/src/base/ui/css_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css_helpers.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/css_helpers.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,UAAU;;;CAcf,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/types/src/base/ui/dialog.d.ts

@@ -0,0 +1,80 @@
+/** @module @airtable/blocks/ui: Dialog */ /** */
+import PropTypes from 'prop-types';
+import * as React from 'react';
+import { DimensionsSetProps, FlexContainerSetProps, SpacingSetProps } from './system';
+import { OptionalResponsiveProp } from './system/utils/types';
+/**
+ * Style props shared between the {@link Dialog} and {@link ConfirmationDialog} components. Also accepts:
+ * * {@link DimensionsSetProps}
+ * * {@link FlexContainerSetProps}
+ * * {@link SpacingSetProps}
+ *
+ * @noInheritDoc
+ */
+export interface DialogStyleProps extends DimensionsSetProps, FlexContainerSetProps, SpacingSetProps {
+    /** Defines the display type of an element, which consists of the two basic qualities of how an element generates boxes — the outer display type defining how the box participates in flow layout, and the inner display type defining how the children of the box are laid out. */
+    display?: OptionalResponsiveProp<'block' | 'flex'>;
+}
+export declare const dialogStylePropTypes: {
+    [x: string]: PropTypes.Validator<any>;
+};
+/**
+ * Props for the {@link Dialog} component. Also accepts:
+ * * {@link DialogStyleProps}
+ *
+ * @noInheritDoc
+ * @docsPath UI/components/Dialog
+ */
+interface DialogProps extends DialogStyleProps {
+    /** Callback function to fire when the dialog is closed. */
+    onClose: () => unknown;
+    /** Extra `className`s to apply to the dialog element, separated by spaces. */
+    className?: string;
+    /** Extra styles to apply to the dialog element. */
+    style?: React.CSSProperties;
+    /** Extra `className`s to apply to the background element, separated by spaces. */
+    backgroundClassName?: string;
+    /** Extra styles to apply to the background element. */
+    backgroundStyle?: React.CSSProperties;
+    /** The contents of the dialog element. */
+    children: React.ReactNode;
+}
+/**
+ * A styled modal dialog component.
+ *
+ * [[ Story id="dialog--example" title="Dialog example" ]]
+ *
+ * @docsPath UI/components/Dialog
+ * @component
+ */
+declare class Dialog extends React.Component<DialogProps> {
+    /** @hidden */
+    static CloseButton: React.RefForwardingComponent<import("./dialog_close_button").DialogCloseButton, import("./dialog_close_button").DialogCloseButtonProps & import("./dialog_close_button").DialogCloseButtonStyleProps & React.RefAttributes<import("./dialog_close_button").DialogCloseButton>>;
+    /** @hidden */
+    static propTypes: {
+        onClose: PropTypes.Validator<(...args: any[]) => any>;
+        className: PropTypes.Requireable<string>;
+        style: PropTypes.Requireable<object>;
+        backgroundClassName: PropTypes.Requireable<string>;
+        backgroundStyle: PropTypes.Requireable<object>;
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+    };
+    /** @hidden */
+    static childContextTypes: {
+        onDialogClose: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    /** @hidden */
+    constructor(props: DialogProps);
+    /** @hidden */
+    getChildContext(): {
+        onDialogClose: () => unknown;
+    };
+    /** @hidden */
+    componentDidMount(): void;
+    /** @hidden */
+    componentWillUnmount(): void;
+    /** @hidden */
+    render(): React.JSX.Element;
+}
+export default Dialog;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/types/src/base/ui/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/dialog.tsx"],"names":[],"mappings":"AAAA,0CAA0C,CAAC,MAAM;AACjD,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAEH,kBAAkB,EAGlB,qBAAqB,EAErB,eAAe,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,sBAAsB,EAAC,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;GAOG;AAEH,MAAM,WAAW,gBACb,SAAQ,kBAAkB,EACtB,qBAAqB,EACrB,eAAe;IACnB,mRAAmR;IACnR,OAAO,CAAC,EAAE,sBAAsB,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;CACtD;AAED,eAAO,MAAM,oBAAoB;;CAMhC,CAAC;AAEF;;;;;;GAMG;AACH,UAAU,WAAY,SAAQ,gBAAgB;IAC1C,2DAA2D;IAC3D,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED;;;;;;;GAOG;AAEH,cAAM,MAAO,SAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;IAC7C,cAAc;IACd,MAAM,CAAC,WAAW,iRAAqB;IACvC,cAAc;IACd,MAAM,CAAC,SAAS;;;;;;;MAQd;IAEF,cAAc;IACd,MAAM,CAAC,iBAAiB;;MAEtB;IACF,cAAc;gBACF,KAAK,EAAE,WAAW;IAI9B,cAAc;IACd,eAAe;6BA9CA,OAAO;;IAmDtB,cAAc;IACd,iBAAiB;IAGjB,cAAc;IACd,oBAAoB;IASpB,cAAc;IACd,MAAM;CAwBT;AAED,eAAe,MAAM,CAAC"}

package/dist/types/src/base/ui/dialog_close_button.d.ts

@@ -0,0 +1,62 @@
+/** @module @airtable/blocks/ui: Dialog */ /** */
+import PropTypes from 'prop-types';
+import * as React from 'react';
+import { BorderRadiusProps, DimensionsSetProps, DisplayProps, FlexContainerSetProps, FlexItemSetProps, PositionSetProps, SpacingSetProps } from './system';
+import { TooltipAnchorProps } from './types/tooltip_anchor_props';
+/**
+ * Props for the {@link DialogCloseButton} component. Also accepts:
+ * * {@link DialogCloseButtonStyleProps}
+ *
+ * @noInheritDoc
+ */
+export interface DialogCloseButtonProps extends TooltipAnchorProps<HTMLDivElement> {
+    /** `className`s to apply to the close button, separated by spaces. */
+    className?: string;
+    /** Styles to apply to the close button. */
+    style?: React.CSSProperties;
+    /** Indicates if the button can be focused and if/where it participates in sequential keyboard navigation. */
+    tabIndex?: number;
+    /** The contents of the close button. */
+    children?: React.ReactNode | string;
+}
+/**
+ * Style props for the {@link DialogCloseButton} component. Accepts:
+ * * {@link BorderRadiusProps}
+ * * {@link DimensionsSetProps}
+ * * {@link DisplayProps}
+ * * {@link FlexContainerSetProps}
+ * * {@link FlexItemSetProps}
+ * * {@link PositionSetProps}
+ * * {@link SpacingSetProps}
+ *
+ * @noInheritDoc
+ */
+export interface DialogCloseButtonStyleProps extends BorderRadiusProps, DimensionsSetProps, DisplayProps, FlexContainerSetProps, FlexItemSetProps, PositionSetProps, SpacingSetProps {
+}
+/**
+ * A button that closes {@link Dialog}. Accessed via `Dialog.CloseButton`.
+ */
+export declare class DialogCloseButton extends React.Component<DialogCloseButtonProps> {
+    /** @hidden */
+    static propTypes: {
+        onMouseEnter: PropTypes.Requireable<(...args: any[]) => any>;
+        onMouseLeave: PropTypes.Requireable<(...args: any[]) => any>;
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        hasOnClick: PropTypes.Requireable<boolean>;
+        className: PropTypes.Requireable<string>;
+        style: PropTypes.Requireable<object>;
+        tabIndex: PropTypes.Requireable<number>;
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+    };
+    /** @hidden */
+    static contextTypes: {
+        onDialogClose: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    /** @hidden */
+    constructor(props: DialogCloseButtonProps);
+    /** @hidden */
+    render(): React.JSX.Element;
+}
+declare const _default: React.RefForwardingComponent<DialogCloseButton, DialogCloseButtonProps & DialogCloseButtonStyleProps & React.RefAttributes<DialogCloseButton>>;
+export default _default;
+//# sourceMappingURL=dialog_close_button.d.ts.map

package/dist/types/src/base/ui/dialog_close_button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog_close_button.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/dialog_close_button.tsx"],"names":[],"mappings":"AAAA,0CAA0C,CAAC,MAAM;AACjD,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAGH,iBAAiB,EAGjB,kBAAkB,EAGlB,YAAY,EAGZ,qBAAqB,EAGrB,gBAAgB,EAGhB,gBAAgB,EAGhB,eAAe,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAyB,kBAAkB,EAAC,MAAM,8BAA8B,CAAC;AAGxF;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB,CAAC,cAAc,CAAC;IAC9E,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;CACvC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BACb,SAAQ,iBAAiB,EACrB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe;CAAG;AAsB1B;;GAEG;AAGH,qBAAa,iBAAkB,SAAQ,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC;IAC1E,cAAc;IACd,MAAM,CAAC,SAAS;;;;;;;;;MAMd;IACF,cAAc;IACd,MAAM,CAAC,YAAY;;MAEjB;IACF,cAAc;gBACF,KAAK,EAAE,sBAAsB;IAuBzC,cAAc;IACd,MAAM;CAmBT;;AAED,wBAiBG"}

package/dist/types/src/base/ui/expand_record.d.ts

@@ -0,0 +1,27 @@
+/** @module @airtable/blocks/ui: expandRecord */ /** */
+import Record from '../models/record';
+/**
+ * Options object for expanding a record.
+ */
+export interface ExpandRecordOpts {
+    /** If `records` is provided, the list will be used to page through records from the expanded record dialog. */
+    records?: Array<Record>;
+}
+/**
+ * Expands the given record in the Airtable UI.
+ *
+ * @param record The record to expand.
+ * @param opts An optional options object.
+ *
+ * @example
+ * ```js
+ * import {expandRecord} from '@airtable/blocks/ui';
+ * expandRecord(record1, {
+ *     records: [record1, record2, record3],
+ * });
+ * ```
+ * @docsPath UI/utils/expandRecord
+ */
+declare function expandRecord(record: Record, opts?: ExpandRecordOpts): void;
+export default expandRecord;
+//# sourceMappingURL=expand_record.d.ts.map

package/dist/types/src/base/ui/expand_record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand_record.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/expand_record.ts"],"names":[],"mappings":"AAAA,gDAAgD,CAAC,MAAM;AACvD,OAAO,MAAM,MAAM,kBAAkB,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,iBAAS,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,QAe5D;AAED,eAAe,YAAY,CAAC"}

package/dist/types/src/base/ui/expand_record_list.d.ts

@@ -0,0 +1,29 @@
+import Record from '../models/record';
+import Field from '../models/field';
+/**
+ * Options object for expanding a record list.
+ */
+interface ExpandRecordListOpts {
+    /** The fields to include in the record cards. The primary field will always be shown. Duplicate fields will be removed. */
+    fields?: Array<Field>;
+}
+/**
+ * Expands a list of records in the Airtable UI.
+ *
+ * @param records The records to expand. Duplicate records will be removed.
+ * @param opts An optional options object.
+ *
+ * @example
+ * ```js
+ * import {expandRecordList} from '@airtable/blocks/ui';
+ * expandRecordList([record1, record2, record3]);
+ *
+ * expandRecordList([record1, record2], {
+ *     fields: [field1, field2],
+ * });
+ * ```
+ * @docsPath UI/utils/expandRecordList
+ */
+declare function expandRecordList(records: Array<Record>, opts?: ExpandRecordListOpts): void;
+export default expandRecordList;
+//# sourceMappingURL=expand_record_list.d.ts.map

package/dist/types/src/base/ui/expand_record_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand_record_list.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/expand_record_list.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,KAAK,MAAM,iBAAiB,CAAC;AAEpC;;GAEG;AACH,UAAU,oBAAoB;IAC1B,2HAA2H;IAC3H,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,oBAAoB,QA8B5E;AAED,eAAe,gBAAgB,CAAC"}

package/dist/types/src/base/ui/expand_record_picker_async.d.ts

@@ -0,0 +1,45 @@
+import Record from '../models/record';
+import Field from '../models/field';
+/**
+ * Options object for expanding a record picker.
+ */
+interface ExpandRecordPickerOpts {
+    /** The fields to include in the record cards. The primary field will always be shown. Duplicate fields will be removed. */
+    fields?: Array<Field>;
+    /** If set to true, the user will be able to create an empty new record from the record picker. */
+    shouldAllowCreatingRecord?: boolean;
+}
+/**
+ * Expands a list of records in the Airtable UI, and prompts the user to pick
+ * one. The selected record is returned to the extension, and the modal is
+ * automatically closed.
+ *
+ * If the user dismisses the modal, or another one is opened before this one
+ * has been closed, it will return null.
+ *
+ * Returns a promise that resolves to the record chosen by the user, or null.
+ *
+ * @param records the records the user can pick from. Duplicate records will be removed.
+ * @param opts An optional options object.
+ * @example
+ * ```js
+ * import {expandRecordPickerAsync} from '@airtable/blocks/ui';
+ *
+ * async function pickRecordsAsync() {
+ *     const recordA = await expandRecordPickerAsync([record1, record2, record3]);
+ *     if (recordA !== null) {
+ *         alert(recordA.name);
+ *     } else {
+ *         alert('no record picked');
+ *     }
+ *
+ *     const recordB = await expandRecordPickerAsync([record1, record2], {
+ *         fields: [field1, field2],
+ *     });
+ * }
+ * ```
+ * @docsPath UI/utils/expandRecordPickerAsync
+ */
+declare function expandRecordPickerAsync(records: Array<Record>, opts?: ExpandRecordPickerOpts): Promise<Record | null>;
+export default expandRecordPickerAsync;
+//# sourceMappingURL=expand_record_picker_async.d.ts.map

package/dist/types/src/base/ui/expand_record_picker_async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand_record_picker_async.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/expand_record_picker_async.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,KAAK,MAAM,iBAAiB,CAAC;AAEpC;;GAEG;AACH,UAAU,sBAAsB;IAC5B,2HAA2H;IAC3H,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,kGAAkG;IAClG,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,iBAAe,uBAAuB,CAClC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EACtB,IAAI,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB;AAED,eAAe,uBAAuB,CAAC"}

package/dist/types/src/base/ui/field_icon.d.ts

@@ -0,0 +1,41 @@
+/** @module @airtable/blocks/ui: FieldIcon */ /** */
+import PropTypes from 'prop-types';
+import * as React from 'react';
+import Field from '../models/field';
+import { SharedIconProps } from './icon';
+/**
+ * Props for the {@link FieldIcon} component. Also accepts:
+ * * {@link IconStyleProps}
+ *
+ * @docsPath UI/components/FieldIcon
+ */
+interface FieldIconProps extends SharedIconProps {
+    /** The field model to display an icon for. */
+    field: Field;
+}
+/**
+ * A vector icon for a field’s type.
+ *
+ * [[ Story id="fieldicon--example" title="FieldIcon example" ]]
+ *
+ * @docsPath UI/components/FieldIcon
+ * @component
+ */
+declare const FieldIcon: {
+    (props: FieldIconProps): React.JSX.Element;
+    propTypes: {
+        onMouseEnter: PropTypes.Requireable<(...args: any[]) => any>;
+        onMouseLeave: PropTypes.Requireable<(...args: any[]) => any>;
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        hasOnClick: PropTypes.Requireable<boolean>;
+        size: PropTypes.Requireable<NonNullable<string | number | null | undefined>>;
+        fillColor: PropTypes.Requireable<string>;
+        className: PropTypes.Requireable<string>;
+        style: PropTypes.Requireable<object>;
+        pathClassName: PropTypes.Requireable<string>;
+        pathStyle: PropTypes.Requireable<object>;
+        field: PropTypes.Validator<Field>;
+    };
+};
+export default FieldIcon;
+//# sourceMappingURL=field_icon.d.ts.map

package/dist/types/src/base/ui/field_icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_icon.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/field_icon.tsx"],"names":[],"mappings":"AAAA,6CAA6C,CAAC,MAAM;AACpD,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,MAAM,iBAAiB,CAAC;AAGpC,OAAa,EAAsB,eAAe,EAAC,MAAM,QAAQ,CAAC;AAGlE;;;;;GAKG;AAEH,UAAU,cAAe,SAAQ,eAAe;IAC5C,8CAA8C;IAC9C,KAAK,EAAE,KAAK,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,SAAS;YAAW,cAAc;;;;;;;;;;;;;;CAWvC,CAAC;AAOF,eAAe,SAAS,CAAC"}

package/dist/types/src/base/ui/field_picker.d.ts

@@ -0,0 +1,57 @@
+/** @module @airtable/blocks/ui: FieldPicker */ /** */
+import PropTypes from 'prop-types';
+import * as React from 'react';
+import Field from '../models/field';
+import Table from '../models/table';
+import { FieldType } from '../../shared/types/field';
+import { SharedSelectBaseProps } from './select';
+/**
+ * Props shared between the {@link FieldPicker} and {@link FieldPickerSynced} components.
+ */
+export interface SharedFieldPickerProps extends SharedSelectBaseProps {
+    /** The parent table model to select fields from. If `null` or `undefined`, the picker won't render. */
+    table?: Table | null;
+    /** An array indicating which field types can be selected. */
+    allowedTypes?: Array<FieldType>;
+    /** If set to `true`, the user can unset the selected field. */
+    shouldAllowPickingNone?: boolean;
+    /** The placeholder text when no field is selected. */
+    placeholder?: string;
+    /** A function to be called when the selected field changes. */
+    onChange?: (fieldModel: Field | null) => void;
+}
+export declare const sharedFieldPickerPropTypes: {
+    onMouseEnter: PropTypes.Requireable<(...args: any[]) => any>;
+    onMouseLeave: PropTypes.Requireable<(...args: any[]) => any>;
+    onClick: PropTypes.Requireable<(...args: any[]) => any>;
+    hasOnClick: PropTypes.Requireable<boolean>;
+    size: PropTypes.Validator<any>;
+    autoFocus: PropTypes.Requireable<boolean>;
+    disabled: PropTypes.Requireable<boolean>;
+    id: PropTypes.Requireable<string>;
+    name: PropTypes.Requireable<string>;
+    tabIndex: PropTypes.Requireable<number>;
+    className: PropTypes.Requireable<string>;
+    style: PropTypes.Requireable<object>;
+    'aria-label': PropTypes.Requireable<string>;
+    'aria-labelledby': PropTypes.Requireable<string>;
+    'aria-describedby': PropTypes.Requireable<string>;
+    table: PropTypes.Requireable<Table>;
+    allowedTypes: PropTypes.Requireable<NonNullable<import("../../shared/private_utils").ObjectValues<typeof FieldType>>[]>;
+    shouldAllowPickingNone: PropTypes.Requireable<boolean>;
+    placeholder: PropTypes.Requireable<string>;
+    onChange: PropTypes.Requireable<(...args: any[]) => any>;
+};
+/**
+ * Props for the {@link FieldPicker} component. Also accepts:
+ * * {@link SelectStyleProps}
+ *
+ * @docsPath UI/components/FieldPicker
+ */
+export interface FieldPickerProps extends SharedFieldPickerProps {
+    /** The selected field model. */
+    field?: Field | null;
+}
+declare const ForwardedRefFieldPicker: React.ForwardRefExoticComponent<FieldPickerProps & React.RefAttributes<HTMLSelectElement>>;
+export default ForwardedRefFieldPicker;
+//# sourceMappingURL=field_picker.d.ts.map

package/dist/types/src/base/ui/field_picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_picker.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/field_picker.tsx"],"names":[],"mappings":"AAAA,+CAA+C,CAAC,MAAM;AACtD,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,MAAM,iBAAiB,CAAC;AACpC,OAAO,KAAK,MAAM,iBAAiB,CAAC;AACpC,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AAInD,OAAO,EAAC,qBAAqB,EAA4B,MAAM,UAAU,CAAC;AAG1E;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACjE,uGAAuG;IACvG,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,+DAA+D;IAC/D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;CACjD;AAGD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAOtC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC5D,gCAAgC;IAChC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACxB;AAmFD,QAAA,MAAM,uBAAuB,4FAAqE,CAAC;AASnG,eAAe,uBAAuB,CAAC"}

package/dist/types/src/base/ui/field_picker_synced.d.ts

@@ -0,0 +1,18 @@
+/** @module @airtable/blocks/ui: FieldPicker */ /** */
+import * as React from 'react';
+import { GlobalConfigKey } from '../../shared/types/global_config';
+import { SharedFieldPickerProps } from './field_picker';
+/**
+ * Props for the {@link FieldPickerSynced} component. Also accepts:
+ * * {@link SelectStyleProps}
+ *
+ * @docsPath UI/components/FieldPickerSynced
+ * @groupPath UI/components/FieldPicker
+ */
+interface FieldPickerSyncedProps extends SharedFieldPickerProps {
+    /** A string key or array key path in {@link GlobalConfig}. The selected field will always reflect the field id stored in {@link GlobalConfig} for this key. Selecting a new field will update {@link GlobalConfig}. */
+    globalConfigKey: GlobalConfigKey;
+}
+declare const ForwardedRefFieldPickerSynced: React.ForwardRefExoticComponent<FieldPickerSyncedProps & React.RefAttributes<HTMLSelectElement>>;
+export default ForwardedRefFieldPickerSynced;
+//# sourceMappingURL=field_picker_synced.d.ts.map

package/dist/types/src/base/ui/field_picker_synced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_picker_synced.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/field_picker_synced.tsx"],"names":[],"mappings":"AAAA,+CAA+C,CAAC,MAAM;AACtD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAC,eAAe,EAAC,MAAM,kCAAkC,CAAC;AAMjE,OAAoB,EAA6B,sBAAsB,EAAC,MAAM,gBAAgB,CAAC;AAE/F;;;;;;GAMG;AACH,UAAU,sBAAuB,SAAQ,sBAAsB;IAC3D,uNAAuN;IACvN,eAAe,EAAE,eAAe,CAAC;CACpC;AA2CD,QAAA,MAAM,6BAA6B,kGAElC,CAAC;AASF,eAAe,6BAA6B,CAAC"}

package/dist/types/src/base/ui/form_field.d.ts

@@ -0,0 +1,46 @@
+/** @module @airtable/blocks/ui: FormField */ /** */
+import React from 'react';
+import PropTypes from 'prop-types';
+import { MaxWidthProps, MinWidthProps, WidthProps, FlexItemSetProps, PositionSetProps, SpacingSetProps } from './system';
+/**
+ * Style props for the {@link FormField} component. Accepts:
+ * * {@link FlexItemSetProps}
+ * * {@link MaxWidthProps}
+ * * {@link MinWidthProps}
+ * * {@link PositionSetProps}
+ * * {@link SpacingSetProps}
+ * * {@link WidthProps}
+ *
+ * @noInheritDoc
+ */
+interface FormFieldStyleProps extends MaxWidthProps, MinWidthProps, WidthProps, FlexItemSetProps, PositionSetProps, SpacingSetProps {
+}
+export declare const formFieldStylePropTypes: {
+    [x: string]: PropTypes.Validator<any>;
+};
+/**
+ * Props for the {@link FormField} component. Also accepts:
+ * * {@link FormFieldStyleProps}
+ *
+ * @noInheritDoc
+ * @docsPath UI/components/FormField
+ */
+export interface FormFieldProps extends FormFieldStyleProps {
+    /** The `id` attribute. */
+    id?: string;
+    /** Additional class names to apply to the form field. */
+    className?: string;
+    /** Additional styles to apply to the form field. */
+    style?: React.CSSProperties;
+    /** The label content for the form field. */
+    label?: React.ReactNode;
+    /** The `for` attribute to be applied to the inner label. By default, the form field will automatically generate a random ID and set it on both the label and the wrapped input/select. Only use this property if you want to override the generated ID with your own custom ID. */
+    htmlFor?: string;
+    /** The description content for the form field. Displayed beneath the label and above the wrapped control field. */
+    description?: React.ReactNode | string | null;
+    /** The contents of the form field. */
+    children?: React.ReactNode;
+}
+declare const ForwardedRefFormField: React.ForwardRefExoticComponent<FormFieldProps & React.RefAttributes<HTMLDivElement>>;
+export default ForwardedRefFormField;
+//# sourceMappingURL=form_field.d.ts.map

package/dist/types/src/base/ui/form_field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form_field.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/form_field.tsx"],"names":[],"mappings":"AAAA,6CAA6C,CAAC,MAAM;AACpD,OAAO,KAAiB,MAAM,OAAO,CAAC;AACtC,OAAO,SAAS,MAAM,YAAY,CAAC;AASnC,OAAO,EAGH,aAAa,EAGb,aAAa,EAGb,UAAU,EAGV,gBAAgB,EAGhB,gBAAgB,EAGhB,eAAe,EAClB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;GAUG;AACH,UAAU,mBACN,SAAQ,aAAa,EACjB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe;CAAG;AAI1B,eAAO,MAAM,uBAAuB;;CAOnC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACvD,0BAA0B;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,mRAAmR;IACnR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mHAAmH;IACnH,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AAqED,QAAA,MAAM,qBAAqB,uFAA8D,CAAC;AAe1F,eAAe,qBAAqB,CAAC"}

package/dist/types/src/base/ui/geometry/geometry.d.ts

@@ -0,0 +1,3 @@
+export { default as Size } from './size';
+export { default as Point } from './point';
+//# sourceMappingURL=geometry.d.ts.map

package/dist/types/src/base/ui/geometry/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/base/ui/geometry/geometry.ts"],"names":[],"mappings":"AAOA,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,SAAS,CAAC"}

package/dist/types/src/base/ui/geometry/point.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=point.d.ts.map

package/dist/types/src/base/ui/geometry/point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../../../../src/base/ui/geometry/point.ts"],"names":[],"mappings":""}

package/dist/types/src/base/ui/geometry/rect.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rect.d.ts.map

package/dist/types/src/base/ui/geometry/rect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../../../../src/base/ui/geometry/rect.ts"],"names":[],"mappings":""}

package/dist/types/src/base/ui/geometry/size.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=size.d.ts.map

package/dist/types/src/base/ui/geometry/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../../../../../src/base/ui/geometry/size.ts"],"names":[],"mappings":""}

package/dist/types/src/base/ui/global_alert.d.ts

@@ -0,0 +1,23 @@
+import { ObjectValues } from '../../shared/private_utils';
+import Watchable from '../../shared/watchable';
+declare const WatchableGlobalAlertKeys: Readonly<{
+    __alertInfo: "__alertInfo";
+}>;
+/** @hidden */
+type WatchableGlobalAlertKey = ObjectValues<typeof WatchableGlobalAlertKeys>;
+/**
+ * @hidden
+ * @example
+ * ```js
+ * import {globalAlert} from '@airtable/blocks/ui';
+ * globalAlert.showReloadPrompt();
+ * ```
+ */
+declare class GlobalAlert extends Watchable<WatchableGlobalAlertKey> {
+    /** @hidden */
+    constructor();
+    /** */
+    showReloadPrompt(): void;
+}
+export default GlobalAlert;
+//# sourceMappingURL=global_alert.d.ts.map

package/dist/types/src/base/ui/global_alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global_alert.d.ts","sourceRoot":"","sources":["../../../../../src/base/ui/global_alert.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,YAAY,EAAC,MAAM,4BAA4B,CAAC;AACrE,OAAO,SAAS,MAAM,wBAAwB,CAAC;AAI/C,QAAA,MAAM,wBAAwB;;EAE5B,CAAC;AACH,cAAc;AACd,KAAK,uBAAuB,GAAG,YAAY,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAwB7E;;;;;;;GAOG;AACH,cAAM,WAAY,SAAQ,SAAS,CAAC,uBAAuB,CAAC;IASxD,cAAc;;IAUd,MAAM;IACN,gBAAgB;CAMnB;AAED,eAAe,WAAW,CAAC"}