@airtable/blocks 0.0.0-experimental-28533a19d-20251016 → 0.0.0-experimental-a1a13b445-20251124

package/dist/esm/base/models/record.js

@@ -1,7 +1,7 @@
 /** @module @airtable/blocks/models: Record */ /** */
 
-import { RecordCore, WatchableRecordKeysCore } from '../../shared/models/record_core';
-import { isEnumValue, isObjectEmpty } from '../../shared/private_utils';
+import { RecordCore, WatchableCellValueInFieldKeyPrefix, WatchableRecordKeysCore } from '../../shared/models/record_core';
+import { isEnumValue } from '../../shared/private_utils';
 import { invariant } from '../../shared/error_utils';
 import colorUtils from '../../shared/color_utils';
 import LinkedRecordsQueryResult from './linked_records_query_result';
@@ -11,11 +11,9 @@ const WatchableRecordKeys = Object.freeze({
   ...WatchableRecordKeysCore,
   commentCount: 'commentCount'
 });
-// TODO: load cell values in field when this is watched? This will
-// cause the CellRenderer component to load cell values, which seems okay,
-// but needs a little more thought.
-const WatchableCellValueInFieldKeyPrefix = 'cellValueInField:';
-// TODO: load view data when this is watched. see previous comment.
+
+// TODO: Should we load view data when this is watched?
+// See comment on WatchableCellValueInFieldKeyPrefix.
 const WatchableColorInViewKeyPrefix = 'colorInView:';
 /**
  * Any key within record that can be watched:
@@ -210,14 +208,8 @@ class Record extends RecordCore {
   __triggerOnChangeForDirtyPaths(dirtyPaths) {
     super.__triggerOnChangeForDirtyPaths(dirtyPaths);
     const {
-      cellValuesByFieldId,
       commentCount
     } = dirtyPaths;
-    if (cellValuesByFieldId && !isObjectEmpty(cellValuesByFieldId)) {
-      for (const fieldId of Object.keys(cellValuesByFieldId)) {
-        this._onChange(WatchableCellValueInFieldKeyPrefix + fieldId, fieldId);
-      }
-    }
     if (commentCount) {
       this._onChange(WatchableRecordKeys.commentCount);
     }

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

@@ -1,5 +1,6 @@
 import { spawnError } from '../../shared/error_utils';
-import { RecordCore, WatchableRecordKeysCore } from '../../shared/models/record_core';
+import { RecordCore, WatchableCellValueInFieldKeyPrefix, WatchableRecordKeysCore } from '../../shared/models/record_core';
+import { isEnumValue } from '../../shared/private_utils';
 import { FieldType } from '../../shared/types/field_core';
 const WatchableRecordKeys = Object.freeze({
   ...WatchableRecordKeysCore
@@ -8,6 +9,7 @@ const WatchableRecordKeys = Object.freeze({
  * Any key within record that can be watched:
  * - `'name'`
  * - `'cellValues'`
+ * - `'cellValueInField:' + someFieldId`
  */
 
 /**
@@ -20,6 +22,10 @@ const WatchableRecordKeys = Object.freeze({
 export class Record extends RecordCore {
   /** @internal */
   static _className = 'Record';
+  /** @internal */
+  static _isWatchableKey(key) {
+    return isEnumValue(WatchableRecordKeys, key) || key.startsWith(WatchableCellValueInFieldKeyPrefix);
+  }
 
   /**
    * Fetch foreign records for a field. Subsequent calls to this method will

package/dist/esm/interface/sdk.js

@@ -68,4 +68,25 @@ export class InterfaceBlockSdk extends BlockSdkCore {
   setCustomPropertiesAsync(properties) {
     return this.__airtableInterface.setCustomPropertiesAsync(properties);
   }
+
+  /**
+   * @internal
+   */
+  setSelectedSubElementAsync(selectedSubElement) {
+    return this.__airtableInterface.setSelectedSubElementAsync(selectedSubElement);
+  }
+
+  /**
+   * @internal
+   */
+  fetchAndSubscribeToSelectionDataAsync(callback) {
+    return this.__airtableInterface.fetchAndSubscribeToSelectionDataAsync(callback);
+  }
+
+  /**
+   * @internal
+   */
+  unsubscribeFromSelectionData() {
+    return this.__airtableInterface.unsubscribeFromSelectionData();
+  }
 }

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

@@ -30,6 +30,10 @@ export let BlockInstallationPageElementCustomPropertyTypeForAirtableInterface =
 // 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 */
 
+/** @hidden */
+
+/** @hidden */
+
 /**
  * AirtableInterface is designed as the communication interface between the
  * Block SDK and Airtable.

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

@@ -0,0 +1,409 @@
+/** @module @airtable/blocks/interface/ui: SelectableWrapper */ /** */
+import React, { useContext, useEffect, useMemo, useRef, useState } from 'react';
+import ReactDOM from 'react-dom';
+import { useSdk } from '../../shared/ui/sdk_context';
+import { useRunInfo } from './use_run_info';
+
+/**
+ * Context to track the nesting depth of SelectableWrapper components.
+ * Used to ensure child overlays render above parent overlays via z-index.
+ *
+ * @internal
+ */
+const NestingDepthContext = /*#__PURE__*/React.createContext(0);
+
+/** @hidden */
+
+/**
+ * A wrapper component that makes its child selectable with a click overlay.
+ * When clicked, the child component is marked as selected. If already selected,
+ * the overlay becomes click-through. Selected elements display a blue border.
+ *
+ * @component
+ * @hidden
+ */
+export function SelectableWrapper(_ref) {
+  let {
+    children,
+    sourceLocation,
+    name
+  } = _ref;
+  const runInfo = useRunInfo();
+  if (runInfo.isPageElementInEditMode) {
+    return /*#__PURE__*/React.createElement(SelectableWrapperInEditMode, {
+      sourceLocation: sourceLocation,
+      name: name
+    }, children);
+  } else {
+    return /*#__PURE__*/React.createElement(SelectableWrapperInViewMode, {
+      name: name
+    }, children);
+  }
+}
+
+/** @internal */
+function SelectableWrapperInViewMode(_ref2) {
+  let {
+    children
+  } = _ref2;
+  return children;
+}
+
+/** @internal */
+function SelectableWrapperInEditMode(_ref3) {
+  let {
+    children,
+    sourceLocation,
+    name
+  } = _ref3;
+  const id = useUniqueId();
+  const [ref, setRef] = useState(null);
+  const sdk = useSdk();
+
+  // Get the current nesting depth from context
+  const nestingDepth = useContext(NestingDepthContext);
+
+  // Check if this wrapper is currently selected
+  const selectionData = useSelectedSubElementId();
+  const isSelected = selectionData.selectedSubElementId === id;
+
+  // Handle overlay click
+  const handleOverlayClick = async event => {
+    event.preventDefault();
+    event.stopPropagation();
+
+    // Only handle selection if not already selected
+    if (!isSelected) {
+      await sdk.setSelectedSubElementAsync({
+        subElementId: id,
+        sourceLocation,
+        name
+      });
+    }
+  };
+  useEffect(() => {
+    if (!isSelected) {
+      return () => {};
+    }
+
+    // Add a global click listener to deselect this SelectableWrapper if there
+    // is a click outside it
+    const globalClickListener = async event => {
+      // Check if the click is outside this SelectableWrapper div
+      const isClickOutside = event.target instanceof Node && ref && !ref.contains(event.target);
+
+      // Check if the click is on another SelectableWrapper's overlay
+      const isClickOnOtherWrapper = event.target instanceof HTMLElement && event.target.dataset.selectableWrapperOverlay === 'true';
+      if (isClickOutside && !isClickOnOtherWrapper) {
+        // In this case, notify liveapp to deselect this sub element. The deselection
+        // originated from the SDK.
+        await sdk.setSelectedSubElementAsync(null);
+      }
+    };
+    const globalClickListenerOptions = {
+      // Use capture phase to ensure the click is handled even if stopPropagation is called.
+      // This is necessary because the click event is triggered by a click on some other overlay,
+      // the overlay calls stopPropagation.
+      capture: true
+    };
+    document.addEventListener('click', globalClickListener, globalClickListenerOptions);
+    return () => {
+      document.removeEventListener('click', globalClickListener, globalClickListenerOptions);
+    };
+  }, [sdk, isSelected, ref]);
+
+  // Track the latest isSelected value in a ref for use in unmount cleanup
+  const isSelectedRef = useRef(isSelected);
+  // Keep the ref in sync with isSelected
+  useEffect(() => {
+    isSelectedRef.current = isSelected;
+  }, [isSelected]);
+  // If the component unmounts while selected, deselect it. We use a ref to track
+  // isSelected so that changes to isSelected don't cause this effect to re-run.
+  // This effect should only run its cleanup when the component actually unmounts.
+  useEffect(() => {
+    return () => {
+      if (isSelectedRef.current) {
+        sdk.setSelectedSubElementAsync(null);
+      }
+    };
+  }, [sdk]);
+  return /*#__PURE__*/React.createElement(NestingDepthContext.Provider, {
+    value: nestingDepth + 1
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: setRef,
+    style: {
+      display: 'contents'
+    }
+  }, children, /*#__PURE__*/React.createElement(Overlay, {
+    wrapperDiv: ref,
+    isSelected: isSelected,
+    ariaLabel: `Select ${name || 'element'}`,
+    onClick: handleOverlayClick,
+    nestingDepth: nestingDepth
+  })));
+}
+
+/**
+ * Traverses ancestors once to gather both z-index and scrollable containers.
+ * Returns the effective z-index and an array of scrollable ancestor elements.
+ *
+ * @internal
+ */
+function getAncestorInfo(element) {
+  const scrollableAncestors = [];
+  let effectiveZIndex = 0;
+  let current = element.parentElement;
+  while (current && current !== document.body) {
+    const style = window.getComputedStyle(current);
+
+    // Check for effective z-index (only if we haven't found one yet)
+    if (effectiveZIndex === 0) {
+      const zIndex = parseInt(style.zIndex, 10);
+      if (!isNaN(zIndex) && style.position !== 'static') {
+        effectiveZIndex = zIndex;
+      }
+    }
+
+    // Check if this ancestor is scrollable
+    const isScrollable = [style.overflow, style.overflowX, style.overflowY].some(overflow => overflow === 'auto' || overflow === 'scroll');
+    if (isScrollable) {
+      scrollableAncestors.push(current);
+    }
+    current = current.parentElement;
+  }
+  return {
+    effectiveZIndex,
+    scrollableAncestors
+  };
+}
+
+/** @internal */
+function Overlay(_ref4) {
+  let {
+    wrapperDiv,
+    isSelected,
+    ariaLabel,
+    onClick,
+    nestingDepth
+  } = _ref4;
+  const [boundingClientRect, setBoundingClientRect] = useState(null);
+
+  // Limitation: We currently only compute this once (for a given identity
+  // of wrapperDiv), which means that
+  // - if wrapperDiv or an ancestor is reparented, or
+  // - if the z-index or scrollability of an ancestor changes
+  // then these values will be stale.
+  // In practice, reparenting DOM elements is rare in React apps.
+  // TBD how common z-index or scrollability changes are in practice - it's
+  // something we should keep an eye on.
+  const {
+    baseZIndex,
+    scrollableAncestors
+  } = useMemo(() => {
+    if (!wrapperDiv) {
+      return {
+        baseZIndex: 0,
+        scrollableAncestors: []
+      };
+    }
+    const {
+      effectiveZIndex,
+      scrollableAncestors
+    } = getAncestorInfo(wrapperDiv);
+    return {
+      baseZIndex: effectiveZIndex,
+      scrollableAncestors
+    };
+  }, [wrapperDiv]);
+  useEffect(() => {
+    if (!wrapperDiv) {
+      return () => {};
+    }
+
+    // Function to compute the aggregate bounding client rect
+    const computeBoundingRect = () => {
+      if (!wrapperDiv) {
+        return null;
+      }
+      let aggregateBoundingClientRect = null;
+      for (const child of wrapperDiv.children) {
+        const boundingClientRect = child.getBoundingClientRect();
+        const scrollLeft = window.pageXOffset || document.documentElement.scrollLeft;
+        const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
+        if (!aggregateBoundingClientRect) {
+          aggregateBoundingClientRect = {
+            left: boundingClientRect.left + scrollLeft,
+            top: boundingClientRect.top + scrollTop,
+            right: boundingClientRect.right + scrollLeft,
+            bottom: boundingClientRect.bottom + scrollTop
+          };
+          continue;
+        }
+        if (boundingClientRect.left + scrollLeft < aggregateBoundingClientRect.left) {
+          aggregateBoundingClientRect.left = boundingClientRect.left + scrollLeft;
+        }
+        if (boundingClientRect.top + scrollTop < aggregateBoundingClientRect.top) {
+          aggregateBoundingClientRect.top = boundingClientRect.top + scrollTop;
+        }
+        if (boundingClientRect.right + scrollLeft > aggregateBoundingClientRect.right) {
+          aggregateBoundingClientRect.right = boundingClientRect.right + scrollLeft;
+        }
+        if (boundingClientRect.bottom + scrollTop > aggregateBoundingClientRect.bottom) {
+          aggregateBoundingClientRect.bottom = boundingClientRect.bottom + scrollTop;
+        }
+      }
+      return aggregateBoundingClientRect;
+    };
+
+    // Initial computation
+    const rect = computeBoundingRect();
+    setBoundingClientRect(rect);
+
+    // Debounce helper
+    let resizeTimeoutId = null;
+    const debouncedUpdateRect = () => {
+      // Immediately reset the bounding client rect to null when the window is resized
+      // to avoid the overlay being in the wrong position as the resize is happening.
+      // Then debounce the actual measurement with setTimeout for performance.
+      setBoundingClientRect(null);
+      if (resizeTimeoutId !== null) {
+        clearTimeout(resizeTimeoutId);
+      }
+      resizeTimeoutId = setTimeout(() => {
+        const updatedRect = computeBoundingRect();
+        setBoundingClientRect(updatedRect);
+        resizeTimeoutId = null;
+      }, 16); // ~60fps
+    };
+
+    // Set up ResizeObserver to watch for size changes (debounced)
+    const resizeObserver = new ResizeObserver(debouncedUpdateRect);
+
+    // Observe resize on the wrapper element and all its children
+    resizeObserver.observe(wrapperDiv);
+    for (const child of wrapperDiv.children) {
+      resizeObserver.observe(child);
+    }
+
+    // Set up MutationObserver to watch for changes to children
+    const mutationObserver = new MutationObserver(() => {
+      const updatedRect = computeBoundingRect();
+      setBoundingClientRect(updatedRect);
+
+      // Re-observe all children with the ResizeObserver in case new children were added
+      // This ensures dynamically added children are also observed for resize events
+      resizeObserver.disconnect();
+      resizeObserver.observe(wrapperDiv);
+      for (const child of wrapperDiv.children) {
+        resizeObserver.observe(child);
+      }
+    });
+
+    // Observe changes to child list and subtree (e.g., attributes, content)
+    mutationObserver.observe(wrapperDiv, {
+      childList: true,
+      subtree: true,
+      attributes: true,
+      characterData: true
+    });
+
+    // Listen for window resize events to catch viewport changes (debounced)
+    window.addEventListener('resize', debouncedUpdateRect);
+
+    // Listen for scroll events on scrollable ancestor containers
+    // Note: We don't need to listen to window scroll because the overlay and wrapped
+    // element are both positioned relative to the document, so they scroll together naturally.
+    // We only need to listen to scrollable containers because the overlay is portaled
+    // outside them to document.body, so it won't scroll with them automatically.
+    // Use passive: true for better scroll performance
+    scrollableAncestors.forEach(scrollable => {
+      scrollable.addEventListener('scroll', debouncedUpdateRect, {
+        passive: true
+      });
+    });
+    return () => {
+      if (resizeTimeoutId !== null) {
+        clearTimeout(resizeTimeoutId);
+      }
+      mutationObserver.disconnect();
+      resizeObserver.disconnect();
+      window.removeEventListener('resize', debouncedUpdateRect);
+      scrollableAncestors.forEach(scrollable => {
+        scrollable.removeEventListener('scroll', debouncedUpdateRect);
+      });
+    };
+  }, [wrapperDiv, scrollableAncestors]);
+  const [isHovered, setIsHovered] = useState(false);
+  const handleMouseEnter = () => {
+    setIsHovered(true);
+  };
+  const handleMouseLeave = () => {
+    setIsHovered(false);
+  };
+  if (!boundingClientRect) {
+    return null;
+  }
+  return /*#__PURE__*/ReactDOM.createPortal( /*#__PURE__*/React.createElement("div", {
+    onClick: onClick,
+    role: "button"
+    // Prevent keyboard focus. This is consistent with the behavior of native interface elements
+    // in interface designer. See tk tk
+    ,
+    tabIndex: -1,
+    "data-selectable-wrapper-overlay": "true",
+    onMouseEnter: handleMouseEnter,
+    onMouseLeave: handleMouseLeave,
+    "aria-label": ariaLabel,
+    style: {
+      position: 'absolute',
+      left: boundingClientRect.left,
+      top: boundingClientRect.top,
+      height: boundingClientRect.bottom - boundingClientRect.top,
+      width: boundingClientRect.right - boundingClientRect.left,
+      backgroundColor: isSelected ? 'transparent' : isHovered ? 'rgba(22, 110, 225, 0.05)' : 'transparent',
+      cursor: isSelected ? 'default' : 'pointer',
+      pointerEvents: isSelected ? 'none' : 'auto',
+      outline: isSelected ? '2px solid #3b82f6' : undefined,
+      outlineOffset: isSelected ? '-2px' : undefined,
+      // borderRadius: isSelected ? '4px' : undefined,
+      // Use base z-index from ancestors + 1 to be above the wrapper + nestingDepth for nested overlays
+      zIndex: baseZIndex + 1 + nestingDepth
+    }
+  }), document.body);
+}
+
+/** @internal */
+function useUniqueId() {
+  return useMemo(() => Math.random().toString(36).substring(2, 15), []);
+}
+
+/** @internal */
+function useSelectedSubElementId() {
+  const sdk = useSdk();
+  const [selectedSubElementId, setSelectedSubElementId] = useState(null);
+  useEffect(() => {
+    let isCancelled = false;
+    // Subscribe to selection data updates
+    const handleSelectionUpdate = data => {
+      setSelectedSubElementId(data.selectedSubElementId);
+    };
+
+    // Fetch initial selection data and subscribe to updates
+
+    sdk.fetchAndSubscribeToSelectionDataAsync(handleSelectionUpdate).then(initialData => {
+      if (!isCancelled) {
+        setSelectedSubElementId(initialData.selectedSubElementId ?? null);
+      }
+    });
+
+    // Cleanup: unsubscribe when component unmounts
+    return () => {
+      isCancelled = true;
+      sdk.unsubscribeFromSelectionData();
+    };
+  }, [sdk]);
+  return {
+    selectedSubElementId
+  };
+}

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

@@ -6,6 +6,7 @@ import '..';
 export { CellRenderer } from './cell_renderer';
 export { expandRecord } from './expand_record';
 export { initializeBlock } from './initialize_block';
+export { SelectableWrapper } from './selectable_wrapper';
 export { useBase } from './use_base';
 export { useColorScheme } from '../../shared/ui/use_color_scheme';
 export { useCustomProperties } from './use_custom_properties';

package/dist/esm/shared/models/record_core.js

@@ -1,4 +1,4 @@
-import { cloneDeep, isEnumValue, isObjectEmpty } from '../private_utils';
+import { cloneDeep, isObjectEmpty } from '../private_utils';
 import { invariant } from '../error_utils';
 import { FieldType } from '../types/field_core';
 import AbstractModel from './abstract_model';
@@ -9,6 +9,10 @@ export const WatchableRecordKeysCore = Object.freeze({
   // it's just inconsistent...)
   cellValues: 'cellValues'
 });
+// TODO: load cell values in field when this is watched? This will
+// cause the CellRenderer component to load cell values, which seems okay,
+// but needs a little more thought.
+export const WatchableCellValueInFieldKeyPrefix = 'cellValueInField:';
 
 /** @hidden */
 
@@ -17,10 +21,6 @@ export class RecordCore extends AbstractModel {
   /** @internal */
   static _className = 'RecordCore';
   /** @internal */
-  static _isWatchableKey(key) {
-    return isEnumValue(WatchableRecordKeysCore, key);
-  }
-  /** @internal */
 
   /** @internal */
 
@@ -199,6 +199,9 @@ export class RecordCore extends AbstractModel {
       // that we're not subscribed to).
 
       this._onChange(WatchableRecordKeysCore.cellValues, Object.keys(cellValuesByFieldId));
+      for (const fieldId of Object.keys(cellValuesByFieldId)) {
+        this._onChange(WatchableCellValueInFieldKeyPrefix + fieldId, fieldId);
+      }
       if (cellValuesByFieldId[this.parentTable.primaryField.id]) {
         this._onChange(WatchableRecordKeysCore.name);
       }

package/dist/esm/shared/sdk_core.js

@@ -24,7 +24,7 @@ export class BlockSdkCore {
    * @hidden
    */
   // @ts-ignore
-  static VERSION = "0.0.0-experimental-28533a19d-20251016";
+  static VERSION = "0.0.0-experimental-a1a13b445-20251124";
 
   /** Storage for this block installation's configuration. */
 

package/dist/esm/testing/interface/abstract_mock_airtable_interface.js

@@ -98,6 +98,16 @@ export class AbstractMockAirtableInterface extends EventEmitter {
   setCustomPropertiesAsync(properties) {
     return Promise.resolve(true);
   }
+  setSelectedSubElementAsync(selectedSubElement) {
+    return Promise.resolve(true);
+  }
+  fetchAndSubscribeToSelectionDataAsync(callback) {
+    this.on('selectedSubElementIdUpdates', callback);
+    return Promise.resolve({
+      selectedSubElementId: null
+    });
+  }
+  unsubscribeFromSelectionData() {}
   subscribeToModelUpdates(fn) {
     this.on('modelupdates', fn);
   }

package/dist/types/src/base/models/record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/record.ts"],"names":[],"mappings":"AAAA,8CAA8C,CAAC,MAAM;AACrD,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAC,UAAU,EAA0B,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAC,KAAK,MAAM,EAAE,KAAK,OAAO,EAAC,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAC,KAAK,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAEH,KAAK,YAAY,EAGpB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAC,KAAK,SAAS,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAA0B,EAAC,KAAK,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAEpF,QAAA,MAAM,mBAAmB;;;;EAGvB,CAAC;AAOH;;;;;;;GAOG;AACH,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAAC;AAE5E;;;;;;;GAOG;AACH,cAAM,MAAO,SAAQ,UAAU,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAoC5D;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;IASjF,gBAAgB,CAAC,KAAK,EAAE;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAC,GAAG,OAAO;IAShE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sCAAsC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAS3F;;;;;;;OAOG;IACH,cAAc,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAK5E;;;;;;;OAOG;IACH,iBAAiB,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvE;;;;;;;OAOG;IACH,2BAA2B,CACvB,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,wBAAwB;IAoB3B;;;;;;;;;OASG;IACG,gCAAgC,CAClC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAKpC;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,MAAM,CAKhB;IACD;;;;;;;;;;;OAWG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;CAsBJ;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/record.ts"],"names":[],"mappings":"AAAA,8CAA8C,CAAC,MAAM;AACrD,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACH,UAAU,EAGb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAC,KAAK,MAAM,EAAE,KAAK,OAAO,EAAC,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAC,KAAK,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAc,KAAK,YAAY,EAAqB,MAAM,4BAA4B,CAAC;AAI9F,OAAO,EAAC,KAAK,SAAS,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAA0B,EAAC,KAAK,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAEpF,QAAA,MAAM,mBAAmB;;;;EAGvB,CAAC;AAKH;;;;;;;GAOG;AACH,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAAC;AAE5E;;;;;;;GAOG;AACH,cAAM,MAAO,SAAQ,UAAU,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAoC5D;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;IASjF,gBAAgB,CAAC,KAAK,EAAE;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAC,GAAG,OAAO;IAShE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,sCAAsC,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAS3F;;;;;;;OAOG;IACH,cAAc,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAK5E;;;;;;;OAOG;IACH,iBAAiB,CAAC,sBAAsB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvE;;;;;;;OAOG;IACH,2BAA2B,CACvB,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,wBAAwB;IAoB3B;;;;;;;;;OASG;IACG,gCAAgC,CAClC,yBAAyB,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACnD,IAAI,GAAE,qBAA0B,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAKpC;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,MAAM,CAKhB;IACD;;;;;;;;;;;OAWG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;CAiBJ;AAED,eAAe,MAAM,CAAC"}

package/dist/types/src/interface/models/record.d.ts

@@ -11,6 +11,7 @@ declare const WatchableRecordKeys: Readonly<{
  * Any key within record that can be watched:
  * - `'name'`
  * - `'cellValues'`
+ * - `'cellValueInField:' + someFieldId`
  */
 type WatchableRecordKey = ObjectValues<typeof WatchableRecordKeys> | string;
 /**

package/dist/types/src/interface/models/record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../../src/interface/models/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAC,UAAU,EAA0B,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAC,KAAK,YAAY,EAAC,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,SAAS,CAAC;AAEnC,QAAA,MAAM,mBAAmB;;;EAEvB,CAAC;AACH;;;;GAIG;AACH,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAAC;AAE5E;;;;;;GAMG;AACH,qBAAa,MAAO,SAAQ,UAAU,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAIxE;;;;;;;;OAQG;IACH,wBAAwB,CACpB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QACP,OAAO,EAAE,aAAa,CAAC;YAAC,EAAE,EAAE,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KACxD,CAAC;CAgBL"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../../src/interface/models/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAErD,OAAO,EACH,UAAU,EAGb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAc,KAAK,YAAY,EAAC,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAC,KAAK,KAAK,EAAC,MAAM,SAAS,CAAC;AAEnC,QAAA,MAAM,mBAAmB;;;EAEvB,CAAC;AACH;;;;;GAKG;AACH,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAAC;AAE5E;;;;;;GAMG;AACH,qBAAa,MAAO,SAAQ,UAAU,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAWxE;;;;;;;;OAQG;IACH,wBAAwB,CACpB,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QACP,OAAO,EAAE,aAAa,CAAC;YAAC,EAAE,EAAE,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KACxD,CAAC;CAgBL"}

package/dist/types/src/interface/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../../src/interface/sdk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,KAAK,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAKlD,OAAO,EAEH,KAAK,eAAe,EACvB,MAAM,4BAA4B,CAAC;AAEpC,cAAc;AACd,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,gBAAgB,CAAC;gBACrD,iBAAiB,EAAE,gBAAgB,CAAC,oBAAoB,CAAC;IAsDrE,cAAc;IACd,kBAAkB,IAAI,eAAe;CAYxC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../../src/interface/sdk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,KAAK,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAKlD,OAAO,EAGH,KAAK,eAAe,EACvB,MAAM,4BAA4B,CAAC;AAEpC,cAAc;AACd,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,gBAAgB,CAAC;gBACrD,iBAAiB,EAAE,gBAAgB,CAAC,oBAAoB,CAAC;IAsDrE,cAAc;IACd,kBAAkB,IAAI,eAAe;CAqCxC"}

package/dist/types/src/interface/types/airtable_interface.d.ts

@@ -57,6 +57,18 @@ export type BlockInstallationPageElementCustomPropertyForAirtableInterface = {
     type: BlockInstallationPageElementCustomPropertyTypeForAirtableInterface.TABLE_ID;
     defaultValue?: TableId;
 });
+/** @hidden */
+export interface SubElementSelectionState {
+    subElementId: string;
+    sourceLocation?: SourceLocation;
+    name?: string;
+}
+/** @hidden */
+interface SourceLocation {
+    filePath: string;
+    lineNumber: number;
+    columnNumber?: number;
+}
 /**
  * AirtableInterface is designed as the communication interface between the
  * Block SDK and Airtable.
@@ -73,5 +85,13 @@ export interface AirtableInterface extends AirtableInterfaceCore<InterfaceSdkMod
         }>;
     }>;
     setCustomPropertiesAsync(properties: Array<BlockInstallationPageElementCustomPropertyForAirtableInterface>): Promise<boolean>;
+    setSelectedSubElementAsync(selectedSubElement: SubElementSelectionState | null): Promise<boolean>;
+    fetchAndSubscribeToSelectionDataAsync(callback: (data: {
+        selectedSubElementId: string | null;
+    }) => void): Promise<{
+        selectedSubElementId: string | null;
+    }>;
+    unsubscribeFromSelectionData(): void;
 }
+export {};
 //# sourceMappingURL=airtable_interface.d.ts.map

package/dist/types/src/interface/types/airtable_interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airtable_interface.d.ts","sourceRoot":"","sources":["../../../../../src/interface/types/airtable_interface.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAC,KAAK,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAC,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AACpG,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAIrC,cAAc;AACd,oBAAY,mBAAmB;IAC3B,+BAA+B,gCAAgC;CAClE;AAED,cAAc;AACd,MAAM,WAAW,8CAA8C;IAC3D,IAAI,EAAE,mBAAmB,CAAC,+BAA+B,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB,EAAE,OAAO,CAAC;CACpC;AAED,cAAc;AACd,MAAM,MAAM,eAAe,GAAG,8CAA8C,CAAC;AAE7E,cAAc;AACd,MAAM,WAAW,WAAY,SAAQ,eAAe;IAChD,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED,cAAc;AACd,MAAM,WAAW,WAAW;IACxB,gBAAgB,IAAI,MAAM,CAAC;CAC9B;AAID,cAAc;AACd,oBAAY,kEAAkE;IAC1E,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,YAAY;IACpB,QAAQ,YAAY;CACvB;AAID,cAAc;AACd,MAAM,MAAM,8DAA8D,GAAG;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB,GAAG,CACE;IACI,IAAI,EAAE,kEAAkE,CAAC,OAAO,CAAC;IACjF,YAAY,EAAE,OAAO,CAAC;CACzB,GACD;IACI,IAAI,EAAE,kEAAkE,CAAC,MAAM,CAAC;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACI,IAAI,EAAE,kEAAkE,CAAC,IAAI,CAAC;IAC9E,cAAc,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACI,IAAI,EAAE,kEAAkE,CAAC,QAAQ,CAAC;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,GACD;IACI,IAAI,EAAE,kEAAkE,CAAC,QAAQ,CAAC;IAClF,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CACN,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB,CAAC,gBAAgB,CAAC;IAC9E,WAAW,EAAE,WAAW,CAAC;IAEzB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,wBAAwB,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;YAAC,EAAE,EAAE,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC,CAAA;KAAC,CAAC,CAAC;IACnE,wBAAwB,CACpB,UAAU,EAAE,KAAK,CAAC,8DAA8D,CAAC,GAClF,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB"}
+{"version":3,"file":"airtable_interface.d.ts","sourceRoot":"","sources":["../../../../../src/interface/types/airtable_interface.ts"],"names":[],"mappings":"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"}

package/dist/types/src/interface/ui/selectable_wrapper.d.ts

@@ -0,0 +1,19 @@
+/** @module @airtable/blocks/interface/ui: SelectableWrapper */ /** */
+import React from 'react';
+/** @hidden */
+export interface SelectableWrapperProps {
+    /** The child component to wrap with selection functionality */
+    children: React.ReactNode;
+    /** The name of this selectable element, to be shown in the properties panel */
+    name?: string;
+}
+/**
+ * A wrapper component that makes its child selectable with a click overlay.
+ * When clicked, the child component is marked as selected. If already selected,
+ * the overlay becomes click-through. Selected elements display a blue border.
+ *
+ * @component
+ * @hidden
+ */
+export declare function SelectableWrapper({ children, sourceLocation, name }: SelectableWrapperProps): React.JSX.Element;
+//# sourceMappingURL=selectable_wrapper.d.ts.map

package/dist/types/src/interface/ui/selectable_wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectable_wrapper.d.ts","sourceRoot":"","sources":["../../../../../src/interface/ui/selectable_wrapper.tsx"],"names":[],"mappings":"AAAA,+DAA+D,CAAC,MAAM;AACtE,OAAO,KAAyD,MAAM,OAAO,CAAC;AAc9E,cAAc;AACd,MAAM,WAAW,sBAAsB;IACnC,+DAA+D;IAC/D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAQ1B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAC,EAAE,sBAAsB,qBAWzF"}

package/dist/types/src/interface/ui/ui.d.ts

@@ -3,6 +3,7 @@ import '..';
 export { CellRenderer } from './cell_renderer';
 export { expandRecord } from './expand_record';
 export { initializeBlock } from './initialize_block';
+export { SelectableWrapper } from './selectable_wrapper';
 export { useBase } from './use_base';
 export { useColorScheme } from '../../shared/ui/use_color_scheme';
 export { useCustomProperties } from './use_custom_properties';

package/dist/types/src/interface/ui/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../../src/interface/ui/ui.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAI/B,OAAO,IAAI,CAAC;AAEZ,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAC,OAAO,EAAC,MAAM,YAAY,CAAC;AACnC,OAAO,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAC,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACzB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../../src/interface/ui/ui.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAI/B,OAAO,IAAI,CAAC;AAEZ,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAC,OAAO,EAAC,MAAM,YAAY,CAAC;AACnC,OAAO,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAC,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACzB,MAAM,8BAA8B,CAAC"}

package/dist/types/src/shared/models/record_core.d.ts

@@ -6,8 +6,9 @@ export declare const WatchableRecordKeysCore: Readonly<{
     name: "name";
     cellValues: "cellValues";
 }>;
+export declare const WatchableCellValueInFieldKeyPrefix = "cellValueInField:";
 /** @hidden */
-type WatchableRecordKeyCore = ObjectValues<typeof WatchableRecordKeysCore>;
+type WatchableRecordKeyCore = ObjectValues<typeof WatchableRecordKeysCore> | string;
 /** @hidden */
 export declare abstract class RecordCore<SdkModeT extends SdkMode, WatchableKeys extends string = WatchableRecordKeyCore> extends AbstractModel<SdkModeT, SdkModeT['RecordDataT'], WatchableRecordKeyCore | WatchableKeys> {
     /**

package/dist/types/src/shared/models/record_core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record_core.d.ts","sourceRoot":"","sources":["../../../../../src/shared/models/record_core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAKH,KAAK,YAAY,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAC,KAAK,OAAO,EAAgB,MAAM,oBAAoB,CAAC;AAE/D,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAG7C,eAAO,MAAM,uBAAuB;;;EAKlC,CAAC;AAEH,cAAc;AACd,KAAK,sBAAsB,GAAG,YAAY,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE3E,cAAc;AACd,8BAAsB,UAAU,CAC5B,QAAQ,SAAS,OAAO,EACxB,aAAa,SAAS,MAAM,GAAG,sBAAsB,CACvD,SAAQ,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAAC;IAyF9F;;;;;;;;;;OAUG;IACH,YAAY,CAAC,yBAAyB,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAoCvF;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,yBAAyB,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;IAiB9F;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD;;;;;;;;;OASG;IACH,IAAI,WAAW,IAAI,IAAI,CAEtB;CAmBJ"}
+{"version":3,"file":"record_core.d.ts","sourceRoot":"","sources":["../../../../../src/shared/models/record_core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAA+C,KAAK,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAEjG,OAAO,EAAC,KAAK,OAAO,EAAgB,MAAM,oBAAoB,CAAC;AAE/D,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAG7C,eAAO,MAAM,uBAAuB;;;EAKlC,CAAC;AAIH,eAAO,MAAM,kCAAkC,sBAAsB,CAAC;AAEtE,cAAc;AACd,KAAK,sBAAsB,GACrB,YAAY,CAAC,OAAO,uBAAuB,CAAC,GAE5C,MAAM,CAAC;AAEb,cAAc;AACd,8BAAsB,UAAU,CAC5B,QAAQ,SAAS,OAAO,EACxB,aAAa,SAAS,MAAM,GAAG,sBAAsB,CACvD,SAAQ,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAAC;IAqF9F;;;;;;;;;;OAUG;IACH,YAAY,CAAC,yBAAyB,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAoCvF;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,yBAAyB,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;IAiB9F;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD;;;;;;;;;OASG;IACH,IAAI,WAAW,IAAI,IAAI,CAEtB;CAuBJ"}

package/dist/types/src/testing/interface/abstract_mock_airtable_interface.d.ts

@@ -1,6 +1,6 @@
 import EventEmitter from 'events';
 import { type FieldTypeProviderCore, type GlobalConfigHelpers } from '../../shared/types/airtable_interface_core';
-import { type AirtableInterface, type SdkInitData, type IdGenerator, type BlockInstallationPageElementCustomPropertyForAirtableInterface } from '../../interface/types/airtable_interface';
+import { type AirtableInterface, type SdkInitData, type IdGenerator, type BlockInstallationPageElementCustomPropertyForAirtableInterface, type SubElementSelectionState } from '../../interface/types/airtable_interface';
 import { type RecordId } from '../../shared/types/hyper_ids';
 import { type ModelChange } from '../../shared/types/base_core';
 import { type PermissionCheckResult } from '../../shared/types/mutations_core';
@@ -37,6 +37,13 @@ export declare abstract class AbstractMockAirtableInterface extends EventEmitter
         }>;
     }>;
     setCustomPropertiesAsync(properties: Array<BlockInstallationPageElementCustomPropertyForAirtableInterface>): Promise<boolean>;
+    setSelectedSubElementAsync(selectedSubElement: SubElementSelectionState | null): Promise<boolean>;
+    fetchAndSubscribeToSelectionDataAsync(callback: (data: {
+        selectedSubElementId: string | null;
+    }) => void): Promise<{
+        selectedSubElementId: string | null;
+    }>;
+    unsubscribeFromSelectionData(): void;
     subscribeToModelUpdates(fn: (...args: any[]) => void): void;
     subscribeToGlobalConfigUpdates(): void;
     triggerModelUpdates(changes: ReadonlyArray<ModelChange>): void;

package/dist/types/src/testing/interface/abstract_mock_airtable_interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstract_mock_airtable_interface.d.ts","sourceRoot":"","sources":["../../../../../src/testing/interface/abstract_mock_airtable_interface.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAGH,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAC3B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,8DAA8D,EACtE,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAe,KAAK,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AAGzE,OAAO,EAAC,KAAK,WAAW,EAAC,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAC,KAAK,qBAAqB,EAAC,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,iCAAiC,CAAC;AAwD9D;;;;;GAKG;AACH,8BAAsB,6BAClB,SAAQ,YACR,YAAW,iBAAiB;IAE5B,WAAW,EAAG,WAAW,CAAC;IAE1B,OAAO,CAAC,SAAS,CAAc;gBAEnB,QAAQ,EAAE,WAAW;IAMjC;;;;;OAKG;IACH,KAAK;IAKL,IAAI,iBAAiB,0BAEpB;IAED,IAAI,mBAAmB,wBAEtB;IAED,IAAI,WAAW,gBAEd;IAED,8BAA8B;IAE9B,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,qBAAqB;IAMtE,wBAAwB,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;YAAC,EAAE,EAAE,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC,CAAA;KAAC,CAAC;IAIlE,wBAAwB,CACpB,UAAU,EAAE,KAAK,CAAC,8DAA8D,CAAC,GAClF,OAAO,CAAC,OAAO,CAAC;IAInB,uBAAuB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;IAKpD,8BAA8B;IAE9B,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC;IAKvD,0BAA0B;IAE1B,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAC9D,QAAQ,CAAC,WAAW,IAAI,IAAI;IAC5B,QAAQ,CAAC,UAAU,IAAI,IAAI;IAC3B,QAAQ,CAAC,aAAa,IAAI,IAAI;IAC9B,QAAQ,CAAC,QAAQ,IAAI,IAAI;CAC5B"}
+{"version":3,"file":"abstract_mock_airtable_interface.d.ts","sourceRoot":"","sources":["../../../../../src/testing/interface/abstract_mock_airtable_interface.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAGH,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAC3B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,8DAA8D,EACnE,KAAK,wBAAwB,EAChC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAe,KAAK,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AAGzE,OAAO,EAAC,KAAK,WAAW,EAAC,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAC,KAAK,qBAAqB,EAAC,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,iCAAiC,CAAC;AAwD9D;;;;;GAKG;AACH,8BAAsB,6BAClB,SAAQ,YACR,YAAW,iBAAiB;IAE5B,WAAW,EAAG,WAAW,CAAC;IAE1B,OAAO,CAAC,SAAS,CAAc;gBAEnB,QAAQ,EAAE,WAAW;IAMjC;;;;;OAKG;IACH,KAAK;IAKL,IAAI,iBAAiB,0BAEpB;IAED,IAAI,mBAAmB,wBAEtB;IAED,IAAI,WAAW,gBAEd;IAED,8BAA8B;IAE9B,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,qBAAqB;IAMtE,wBAAwB,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;YAAC,EAAE,EAAE,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC,CAAA;KAAC,CAAC;IAIlE,wBAAwB,CACpB,UAAU,EAAE,KAAK,CAAC,8DAA8D,CAAC,GAClF,OAAO,CAAC,OAAO,CAAC;IAInB,0BAA0B,CACtB,kBAAkB,EAAE,wBAAwB,GAAG,IAAI,GACpD,OAAO,CAAC,OAAO,CAAC;IAInB,qCAAqC,CACjC,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,KAAK,IAAI,GAChE,OAAO,CAAC;QACP,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KACvC,CAAC;IAKF,4BAA4B,IAAI,IAAI;IAEpC,uBAAuB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;IAKpD,8BAA8B;IAE9B,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC;IAKvD,0BAA0B;IAE1B,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAC9D,QAAQ,CAAC,WAAW,IAAI,IAAI;IAC5B,QAAQ,CAAC,UAAU,IAAI,IAAI;IAC3B,QAAQ,CAAC,aAAa,IAAI,IAAI;IAC9B,QAAQ,CAAC,QAAQ,IAAI,IAAI;CAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@airtable/blocks",
-    "version": "0.0.0-experimental-28533a19d-20251016",
+    "version": "0.0.0-experimental-a1a13b445-20251124",
     "description": "Airtable Blocks SDK",
     "type": "module",
     "repository": {