@airtable/blocks 0.0.0-experimental-f52bc4e5e-20250709 → 0.0.0-experimental-3649c7162-20250904

package/dist/esm/interface/models/record_store.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RecordStore = void 0;
+var _record_store_core = _interopRequireWildcard(require("../../shared/models/record_store_core"));
+var _private_utils = require("../../shared/private_utils");
+var _record = require("./record");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const WatchableRecordStoreKeys = Object.freeze({
+  ..._record_store_core.WatchableRecordStoreKeysCore,
+  recordOrder: 'recordOrder'
+});
+
+/**
+ * The string case is to accommodate prefix keys
+ *
+ * @internal
+ */
+
+/**
+ * One RecordStore exists per table, and contains all the record data associated with that table.
+ * Table itself is for schema information only, so isn't the appropriate place for this data.
+ *
+ * @internal
+ */
+class RecordStore extends _record_store_core.default {
+  static _className = 'RecordStore';
+  static _isWatchableKey(key) {
+    return (0, _private_utils.isEnumValue)(WatchableRecordStoreKeys, key) || key.startsWith(_record_store_core.WatchableCellValuesInFieldKeyPrefix);
+  }
+  _constructRecord(recordId, parentTable) {
+    return new _record.Record(this._sdk, this, parentTable, recordId);
+  }
+
+  /**
+   * The record Ids in this table.
+   */
+  get recordIds() {
+    return this._data.recordOrder;
+  }
+  triggerOnChangeForDirtyPaths(dirtyPaths) {
+    super.triggerOnChangeForDirtyPaths(dirtyPaths);
+    if (dirtyPaths.recordOrder) {
+      this._onChange(WatchableRecordStoreKeys.recordOrder);
+    }
+  }
+}
+exports.RecordStore = RecordStore;

package/dist/esm/interface/models/session.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Session = void 0;
+var _session_core = require("../../shared/models/session_core");
+/**
+ * Model class representing the current user's session.
+ *
+ * @example
+ * ```js
+ * import {useSession} from '@airtable/blocks/interface/ui';
+ *
+ * function Username() {
+ *     const session = useSession();
+ *
+ *     if (session.currentUser !== null) {
+ *         return <span>The current user's name is {session.currentUser.name}</span>;
+ *     } else {
+ *         return <span>This extension is being viewed in a public share</span>;
+ *     }
+ * }
+ * ```
+ * @docsPath models/Session
+ */
+class Session extends _session_core.SessionCore {}
+exports.Session = Session;

package/dist/esm/interface/models/table.js

@@ -0,0 +1,97 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Table = void 0;
+var _table_core = require("../../shared/models/table_core");
+var _field_core = require("../../shared/types/field_core");
+var _field = require("./field");
+/**
+ * Model class representing a table. Every {@link Base} has one or more tables.
+ *
+ * @example
+ * ```js
+ * import {useBase} from '@airtable/blocks/interface/ui';
+ *
+ * function App() {
+ *     const base = useBase();
+ *     const table = base.getTables()[0];
+ *     if (table) {
+ *         console.log('The name of this table is', table.name);
+ *     }
+ * }
+ * ```
+ * @docsPath models/Table
+ */
+class Table extends _table_core.TableCore {
+  /** @internal */
+  _constructField(fieldId) {
+    return new _field.Field(this.parentBase.__sdk, this, fieldId);
+  }
+
+  /**
+   * Checks whether records in this table can be expanded.
+   *
+   * Returns `{hasPermission: true}` if records can be expanded,
+   * `{hasPermission: false, reasonDisplayString: string}` otherwise.
+   *
+   * @example
+   * ```js
+   * const expandRecordsCheckResult = table.checkPermissionToExpandRecords();
+   * if (!expandRecordsCheckResult.hasPermission) {
+   *     alert(expandRecordsCheckResult.reasonDisplayString);
+   * }
+   * ```
+   */
+  checkPermissionToExpandRecords() {
+    const canExpand = this._baseData.tablesById[this.id].isRecordExpansionEnabled;
+    return canExpand ? {
+      hasPermission: true
+    } : {
+      hasPermission: false,
+      reasonDisplayString: 'Record expansion is not enabled for this table'
+    };
+  }
+
+  /**
+   * An alias for `checkPermissionsForExpandRecords().hasPermission`.
+   *
+   * Whether records in this table can be expanded.
+   *
+   * @example
+   * ```js
+   * const isRecordExpansionEnabled = table.hasPermissionToExpandRecords();
+   * if (isRecordExpansionEnabled) {
+   *     expandRecord(record);
+   * }
+   * ```
+   */
+  hasPermissionToExpandRecords() {
+    return this.checkPermissionToExpandRecords().hasPermission;
+  }
+
+  /** @internal */
+  _adjustCellValueForFieldIfNecessary(field, cellValue, onGenerateIdForNewForeignRecord) {
+    if (field.type !== _field_core.FieldType.MULTIPLE_RECORD_LINKS || !Array.isArray(cellValue)) {
+      return cellValue;
+    }
+    return cellValue.map(item => {
+      if (typeof item !== 'object' || item === null) {
+        // This would be a malformed cellValue, so just return it as is and then the
+        // schema validation of the mutation will fail.
+        return item;
+      }
+      if (!item.id) {
+        const newForeignRecordId = this.parentBase.__sdk.__airtableInterface.idGenerator.generateRecordId();
+        onGenerateIdForNewForeignRecord(newForeignRecordId);
+        return {
+          ...item,
+          id: newForeignRecordId
+        };
+      }
+      return item;
+    });
+  }
+}
+exports.Table = Table;

package/dist/esm/interface/sdk.js

@@ -0,0 +1,78 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.InterfaceBlockSdk = void 0;
+var _sdk_core = require("../shared/sdk_core");
+var _session = require("./models/session");
+var _mutations = require("./models/mutations");
+var _base = require("./models/base");
+/** @hidden */
+class InterfaceBlockSdk extends _sdk_core.BlockSdkCore {
+  constructor(airtableInterface) {
+    super(airtableInterface);
+    this._registerHandlers();
+  }
+  /** @internal */
+  _constructSession() {
+    return new _session.Session(this);
+  }
+  /** @internal */
+  _constructBase() {
+    return new _base.Base(this);
+  }
+  /** @internal */
+  _constructMutations() {
+    return new _mutations.Mutations(this, this.session, this.base, changes => this.__applyModelChanges(changes), updates => this.__applyGlobalConfigUpdates(updates));
+  }
+  /** @internal */
+  _registerHandlers() {
+    // base
+    this.__airtableInterface.subscribeToModelUpdates(_ref => {
+      let {
+        changes
+      } = _ref;
+      this.__applyModelChanges(changes);
+    });
+
+    // global config
+    this.__airtableInterface.subscribeToGlobalConfigUpdates(_ref2 => {
+      let {
+        updates
+      } = _ref2;
+      this.__applyGlobalConfigUpdates(updates);
+    });
+  }
+  /** @internal */
+  __applyModelChanges(changes) {
+    const changedBasePaths = this.base.__applyChangesWithoutTriggeringEvents(changes);
+    const changedSessionKeys = this.session.__applyChangesWithoutTriggeringEvents(changes);
+    this.base.__triggerOnChangeForChangedPaths(changedBasePaths);
+    this.session.__triggerOnChangeForChangedKeys(changedSessionKeys);
+  }
+  /** @internal */
+  __applyGlobalConfigUpdates(updates) {
+    this.globalConfig.__setMultipleKvPaths(updates);
+  }
+
+  /**
+   * @internal
+   */
+  get __appInterface() {
+    return this.base._baseData.appInterface;
+  }
+
+  /** @hidden */
+  getBlockRunContext() {
+    return this.__airtableInterface.sdkInitData.runContext;
+  }
+
+  /**
+   * @internal
+   */
+  setCustomPropertiesAsync(properties) {
+    return this.__airtableInterface.setCustomPropertiesAsync(properties);
+  }
+}
+exports.InterfaceBlockSdk = InterfaceBlockSdk;

package/dist/{cjs → esm}/interface/types/airtable_interface.js

@@ -7,7 +7,7 @@ exports.BlockRunContextType = exports.BlockInstallationPageElementCustomProperty
 // BlockRunContextType, BlockInstallationPageBlockRunContext, BlockRunContext
 // must be kept in sync with block_run_context.tsx in hyperbase repo
 /** @hidden */
-var BlockRunContextType = exports.BlockRunContextType = /*#__PURE__*/function (BlockRunContextType) {
+let BlockRunContextType = exports.BlockRunContextType = /*#__PURE__*/function (BlockRunContextType) {
   BlockRunContextType["PAGE_ELEMENT_IN_QUERY_CONTAINER"] = "pageElementInQueryContainer";
   return BlockRunContextType;
 }({});
@@ -18,7 +18,7 @@ var BlockRunContextType = exports.BlockRunContextType = /*#__PURE__*/function (B
 // Keep in sync with enum in hyperbase repo:
 // https://github.com/Hyperbase/hyperbase/blob/2c0e2ef2cbc6bce7ab33fd913ef3572a83c3892d/client_server_shared/pages/types/block_installation_page_elements/block_installation_page_element_custom_properties_types.tsx
 /** @hidden */
-var BlockInstallationPageElementCustomPropertyTypeForAirtableInterface = exports.BlockInstallationPageElementCustomPropertyTypeForAirtableInterface = /*#__PURE__*/function (BlockInstallationPageElementCustomPropertyTypeForAirtableInterface) {
+let BlockInstallationPageElementCustomPropertyTypeForAirtableInterface = exports.BlockInstallationPageElementCustomPropertyTypeForAirtableInterface = /*#__PURE__*/function (BlockInstallationPageElementCustomPropertyTypeForAirtableInterface) {
   BlockInstallationPageElementCustomPropertyTypeForAirtableInterface["BOOLEAN"] = "boolean";
   BlockInstallationPageElementCustomPropertyTypeForAirtableInterface["STRING"] = "string";
   BlockInstallationPageElementCustomPropertyTypeForAirtableInterface["ENUM"] = "enum";

package/dist/esm/interface/types/mutations.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MutationTypes = void 0;
+var _mutations_core = require("../../shared/types/mutations_core");
+/** @hidden */
+const MutationTypes = exports.MutationTypes = Object.freeze({
+  ..._mutations_core.MutationTypesCore
+});
+
+/** @hidden */
+
+/** @hidden */
+
+/** @hidden */

package/dist/esm/interface/ui/block_wrapper.js

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BlockWrapper = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _emotion = require("emotion");
+var _loader = _interopRequireDefault(require("../../shared/ui/loader"));
+var _sdk_context = require("../../shared/ui/sdk_context");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/** @hidden */ /** */
+
+const suspenseFallbackClassName = (0, _emotion.css)`
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    display: -webkit-box;
+    display: -webkit-flex;
+    display: -ms-flexbox;
+    display: flex;
+    -webkit-box-align: center;
+    -webkit-align-items: center;
+    -ms-flex-align: center;
+    -ms-grid-row-align: center;
+    align-items: center;
+    -webkit-box-pack: center;
+    -webkit-justify-content: center;
+    -ms-flex-pack: center;
+    justify-content: center;
+`;
+const spinScale = (0, _emotion.keyframes)`
+    0% {
+        transform: rotate(0) scale(1);
+    }
+    50% {
+        transform: rotate(360deg) scale(0.9);
+    }
+    100% {
+        transform: rotate(720deg) scale(1);
+    }
+`;
+const animateSpinnerClassName = (0, _emotion.css)`
+    animation-iteration-count: infinite;
+    animation-name: ${spinScale};
+    animation-duration: 1800ms;
+    animation-timing-function: cubic-bezier(0.785, 0.135, 0.15, 0.86);
+`;
+class BlockWrapper extends React.Component {
+  /** @internal */
+  _minSizeBeforeRender = null;
+  /** @hidden */
+  render() {
+    return /*#__PURE__*/React.createElement(_sdk_context.SdkContext.Provider, {
+      value: this.props.sdk
+    }, /*#__PURE__*/React.createElement(React.Suspense, {
+      fallback: /*#__PURE__*/React.createElement("div", {
+        className: suspenseFallbackClassName
+      }, /*#__PURE__*/React.createElement(_loader.default, {
+        className: animateSpinnerClassName
+      }))
+    }, this.props.children));
+  }
+}
+exports.BlockWrapper = BlockWrapper;

package/dist/{cjs → esm}/interface/ui/initialize_block.js

@@ -1,10 +1,5 @@
 "use strict";
 
-require("core-js/modules/es.array.iterator.js");
-require("core-js/modules/es.object.to-string.js");
-require("core-js/modules/es.weak-map.js");
-require("core-js/modules/web.dom-collections.iterator.js");
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -12,16 +7,17 @@ exports.__injectSdkIntoInitializeBlock = __injectSdkIntoInitializeBlock;
 exports.__resetHasBeenInitialized = __resetHasBeenInitialized;
 exports.initializeBlock = initializeBlock;
 var React = _interopRequireWildcard(require("react"));
-var _reactDom = _interopRequireDefault(require("react-dom"));
+var _client = require("react-dom/client");
 var _error_utils = require("../../shared/error_utils");
 var _airtable_interface = _interopRequireDefault(require("../../injected/airtable_interface"));
 var _airtable_interface2 = require("../types/airtable_interface");
 var _block_wrapper = require("./block_wrapper");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /** @module @airtable/blocks/ui: initializeBlock */ /** */
 
-var hasBeenInitialized = false;
+let hasBeenInitialized = false;
 
 /** */
 
@@ -48,7 +44,7 @@ var hasBeenInitialized = false;
  * @docsPath UI/utils/initializeBlock
  */
 function initializeBlock(entryPoints) {
-  var body = typeof document !== 'undefined' ? document.body : null;
+  const body = typeof document !== 'undefined' ? document.body : null;
   if (!body) {
     throw (0, _error_utils.spawnError)('initializeBlock should only be called from browser environments');
   }
@@ -56,9 +52,9 @@ function initializeBlock(entryPoints) {
     throw (0, _error_utils.spawnError)('initializeBlock should only be called once');
   }
   hasBeenInitialized = true;
-  var airtableInterface = (0, _airtable_interface.default)();
-  var entryElement;
-  var runContext = airtableInterface.sdkInitData.runContext;
+  const airtableInterface = (0, _airtable_interface.default)();
+  let entryElement;
+  const runContext = airtableInterface.sdkInitData.runContext;
   switch (runContext.type) {
     case _airtable_interface2.BlockRunContextType.PAGE_ELEMENT_IN_QUERY_CONTAINER:
       {
@@ -77,26 +73,15 @@ function initializeBlock(entryPoints) {
   if (! /*#__PURE__*/React.isValidElement(entryElement)) {
     throw (0, _error_utils.spawnError)("The first argument to initializeBlock didn't return a valid React element");
   }
-  var container = document.createElement('div');
+  const container = document.createElement('div');
   container.style.height = '100%';
   container.style.width = '100%';
   body.appendChild(container);
-
-  // Try to use createRoot API (React 18+)
-  try {
-    var _require = require('react-dom/client'),
-      createRoot = _require.createRoot;
-    createRoot(container).render( /*#__PURE__*/React.createElement(_block_wrapper.BlockWrapper, {
-      sdk: sdk
-    }, entryElement));
-  } catch (e) {
-    // Fallback to legacy render for React 16/17
-    _reactDom.default.render( /*#__PURE__*/React.createElement(_block_wrapper.BlockWrapper, {
-      sdk: sdk
-    }, entryElement), container);
-  }
+  (0, _client.createRoot)(container).render( /*#__PURE__*/React.createElement(_block_wrapper.BlockWrapper, {
+    sdk: sdk
+  }, entryElement));
 }
-var sdk;
+let sdk;
 
 // The application-level Sdk instance must be injected dynamically to avoid
 // circular dependencies at the time of module resolution.

package/dist/{cjs → esm}/interface/ui/ui.js

@@ -1,111 +1,111 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 Object.defineProperty(exports, "colorUtils", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _color_utils.default;
   }
 });
 Object.defineProperty(exports, "colors", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _colors.default;
   }
 });
 Object.defineProperty(exports, "expandRecord", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _expand_record.expandRecord;
   }
 });
 Object.defineProperty(exports, "initializeBlock", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _initialize_block.initializeBlock;
   }
 });
 Object.defineProperty(exports, "loadCSSFromString", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _remote_utils.loadCSSFromString;
   }
 });
 Object.defineProperty(exports, "loadCSSFromURLAsync", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _remote_utils.loadCSSFromURLAsync;
   }
 });
 Object.defineProperty(exports, "loadScriptFromURLAsync", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _remote_utils.loadScriptFromURLAsync;
   }
 });
 Object.defineProperty(exports, "useBase", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_base.useBase;
   }
 });
 Object.defineProperty(exports, "useColorScheme", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_color_scheme.useColorScheme;
   }
 });
 Object.defineProperty(exports, "useCustomProperties", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_custom_properties.useCustomProperties;
   }
 });
 Object.defineProperty(exports, "useGlobalConfig", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_global_config.default;
   }
 });
 Object.defineProperty(exports, "useRecords", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_records.useRecords;
   }
 });
 Object.defineProperty(exports, "useRunInfo", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_run_info.useRunInfo;
   }
 });
 Object.defineProperty(exports, "useSession", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_session.useSession;
   }
 });
 Object.defineProperty(exports, "useSynced", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_synced.default;
   }
 });
 Object.defineProperty(exports, "useWatchable", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _use_watchable.default;
   }
 });
 Object.defineProperty(exports, "withHooks", {
   enumerable: true,
-  get: function get() {
+  get: function () {
     return _with_hooks.default;
   }
 });
+require("../assert_run_context");
 require("..");
 var _expand_record = require("./expand_record");
 var _initialize_block = require("./initialize_block");
@@ -121,4 +121,5 @@ var _use_watchable = _interopRequireDefault(require("../../shared/ui/use_watchab
 var _with_hooks = _interopRequireDefault(require("../../shared/ui/with_hooks"));
 var _colors = _interopRequireDefault(require("../../shared/colors"));
 var _color_utils = _interopRequireDefault(require("../../shared/color_utils"));
-var _remote_utils = require("../../shared/ui/remote_utils");
+var _remote_utils = require("../../shared/ui/remote_utils");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/dist/{cjs → esm}/interface/ui/use_base.js

@@ -1,11 +1,11 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useBase = useBase;
 var _use_base = _interopRequireDefault(require("../../shared/ui/use_base"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /** @module @airtable/blocks/interface/ui: useBase */ /** */
 
 /**