@atlaskit/editor-common 111.11.7 → 111.11.9

package/dist/esm/block-menu/scroll-to-block-utils.js

@@ -0,0 +1,322 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * Shared utilities for scrolling to block elements with expand node support.
+ * Used by both Confluence's useScrollOnUrlChange and platform renderer's useScrollToBlock.
+ */
+
+/**
+ * Timing constants for expand animation and DOM update delays.
+ * These values are tuned for the expand component's behavior and React's update cycle.
+ */
+export var SCROLL_TO_BLOCK_TIMING = {
+  /** Minimal delay for DOM/React updates after expanding (no animation in expand component). */
+  DOM_UPDATE_DELAY: 50,
+  /** Delay when expand operation fails and needs retry. */
+  RETRY_DELAY: 100,
+  /** Maximum number of retry attempts before giving up and scrolling anyway. */
+  MAX_ATTEMPTS: 5,
+  /** Maximum depth of nested expands to search (prevents infinite loops). */
+  MAX_EXPAND_DEPTH: 2
+};
+/**
+ * Find a node by its localId in an ADF document and determine if it has expand or nestedExpand parents.
+ * This is used to identify nodes that may be hidden inside collapsed expands.
+ *
+ * @param adfDoc - The ADF document to search
+ * @param targetLocalId - The localId to search for
+ * @returns NodeWithExpandParents if found, undefined otherwise
+ */
+export function findNodeWithExpandParents(adfDoc, targetLocalId) {
+  var result;
+
+  /**
+   * Recursive helper to traverse the ADF document and track expand ancestors.
+   * We use recursion to properly maintain the expand ancestor stack.
+   */
+  var _traverse = function traverse(node, expandAncestors) {
+    var _node$attrs, _node$attrs2;
+    // If we already found the target, stop traversing
+    if (result) {
+      return false;
+    }
+
+    // Check if this is the target node by localId
+    if ((node === null || node === void 0 || (_node$attrs = node.attrs) === null || _node$attrs === void 0 ? void 0 : _node$attrs.localId) === targetLocalId) {
+      result = {
+        expandParentLocalIds: _toConsumableArray(expandAncestors) // Copy the array
+      };
+      return false; // Stop traversing
+    }
+
+    // Check if this node is an expand or nestedExpand
+    var isExpand = (node === null || node === void 0 ? void 0 : node.type) === 'expand' || (node === null || node === void 0 ? void 0 : node.type) === 'nestedExpand';
+    var newExpandAncestors = isExpand && node !== null && node !== void 0 && (_node$attrs2 = node.attrs) !== null && _node$attrs2 !== void 0 && _node$attrs2.localId ? [].concat(_toConsumableArray(expandAncestors), [node.attrs.localId]) : expandAncestors;
+
+    // Traverse children if they exist
+    if (node !== null && node !== void 0 && node.content && Array.isArray(node.content)) {
+      var _iterator = _createForOfIteratorHelper(node.content),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var child = _step.value;
+          if (result || !child) {
+            break;
+          }
+          _traverse(child, newExpandAncestors);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+    return !result; // Continue if we haven't found it yet
+  };
+
+  // Start traversal from the root
+  _traverse(adfDoc, []);
+  return result;
+}
+
+/**
+ * Find all parent expand elements that contain the target element.
+ * Searches up the DOM tree to find expand or nestedExpand containers.
+ *
+ * This function limits the search depth to prevent infinite loops and performance issues.
+ * The default maxDepth of 2 is chosen because:
+ * - Most use cases have 0-2 levels of nesting
+ * - Searching deeper can impact performance
+ * - Users rarely nest expands more than 2 levels deep
+ *
+ * @param element - The target element to find parents for.
+ * @param maxDepth - Maximum depth to search (default: 2). This is the maximum number of
+ *                   expand ancestors to find, starting from the target element.
+ * @returns Array of expand containers ordered from outermost to innermost.
+ *          For example, if element is inside expand B which is inside expand A,
+ *          this returns [expandA, expandB].
+ */
+export var findParentExpands = function findParentExpands(element) {
+  var maxDepth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : SCROLL_TO_BLOCK_TIMING.MAX_EXPAND_DEPTH;
+  var expands = [];
+  var currentElement = element;
+  var depth = 0;
+  while (currentElement && depth < maxDepth) {
+    // Look for expand container - handles both "expand" and "nestedExpand" types
+    var expandContainer = currentElement.closest('[data-node-type="expand"], [data-node-type="nestedExpand"]');
+    if (!expandContainer || expands.includes(expandContainer)) {
+      break;
+    }
+    expands.push(expandContainer);
+    currentElement = expandContainer.parentElement;
+    depth++;
+  }
+
+  // Return in reverse order so we expand from outermost to innermost
+  return expands.reverse();
+};
+
+/**
+ * Check if an expand node is currently collapsed.
+ *
+ * Uses two methods to determine collapse state:
+ * 1. First checks aria-expanded attribute on the toggle button (most reliable).
+ * 2. Falls back to checking content div visibility via computed styles.
+ *
+ * @param expandContainer - The expand container element.
+ * @returns True if the expand is collapsed, false if expanded or state cannot be determined.
+ */
+export var isExpandCollapsed = function isExpandCollapsed(expandContainer) {
+  // Check for aria-expanded attribute on the toggle button
+  var toggleButton = expandContainer.querySelector('[aria-expanded]');
+  if (toggleButton && toggleButton instanceof HTMLElement) {
+    return toggleButton.getAttribute('aria-expanded') === 'false';
+  }
+
+  // Fallback: check if content div is hidden using the actual class name
+  var contentDiv = expandContainer.querySelector('.ak-editor-expand__content');
+  if (contentDiv && contentDiv instanceof HTMLElement) {
+    var computedStyle = window.getComputedStyle(contentDiv);
+    return computedStyle.display === 'none' || computedStyle.visibility === 'hidden' || contentDiv.hidden;
+  }
+  return false;
+};
+
+/**
+ * Expand a collapsed expand node by clicking its toggle button.
+ *
+ * This function finds the toggle button with aria-expanded="false" and programmatically
+ * clicks it to expand the node. It does not wait for the expansion to complete.
+ *
+ * @param expandContainer - The expand container element.
+ * @returns True if the toggle button was found and clicked, false otherwise.
+ */
+export var expandElement = function expandElement(expandContainer) {
+  // Find and click the toggle button
+  var toggleButton = expandContainer.querySelector('[aria-expanded="false"]');
+  if (toggleButton && toggleButton instanceof HTMLElement) {
+    toggleButton.click();
+    return true;
+  }
+  return false;
+};
+
+/**
+ * Expand all parent expands then scroll to the element.
+ *
+ * This is the main entry point for scrolling to elements that may be hidden inside collapsed expands.
+ * It handles nested expands by expanding them one at a time from outermost to innermost,
+ * waiting for DOM updates between each expansion.
+ *
+ * The function uses a recursive approach with retry logic to handle:
+ * - Nested expands that need sequential expansion
+ * - DOM updates that may take time to reflect
+ * - Failed expand operations (e.g., if toggle button is temporarily unavailable)
+ * - Disconnected elements (removed from DOM)
+ *
+ * After all parent expands are open (or max attempts reached), scrolls the element into view
+ * with smooth behavior and centered in the viewport.
+ *
+ * @param element - The target element to scroll to.
+ * @param attempt - Current attempt number (used internally for retry logic, starts at 0).
+ * @returns A cleanup function that cancels any pending timeouts. Call this when the operation
+ *          should be aborted (e.g., component unmount, navigation, or new scroll request).
+ */
+var _expandAllParentsThenScroll = function expandAllParentsThenScroll(element) {
+  var attempt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  var MAX_EXPAND_DEPTH = SCROLL_TO_BLOCK_TIMING.MAX_EXPAND_DEPTH,
+    MAX_ATTEMPTS = SCROLL_TO_BLOCK_TIMING.MAX_ATTEMPTS,
+    DOM_UPDATE_DELAY = SCROLL_TO_BLOCK_TIMING.DOM_UPDATE_DELAY,
+    RETRY_DELAY = SCROLL_TO_BLOCK_TIMING.RETRY_DELAY;
+
+  // Store timeout ID and nested cleanup function so they can be cancelled.
+  var timeoutId = null;
+  var nestedCleanup = null;
+
+  // Cleanup function that cancels pending timeout and any nested operations.
+  var cleanup = function cleanup() {
+    if (timeoutId !== null) {
+      clearTimeout(timeoutId);
+      timeoutId = null;
+    }
+    if (nestedCleanup) {
+      nestedCleanup();
+      nestedCleanup = null;
+    }
+  };
+
+  // Guard against element being disconnected from DOM or exceeding max attempts.
+  if (attempt >= MAX_ATTEMPTS || !element.isConnected) {
+    // Max attempts reached or element disconnected, scroll anyway.
+    if (element.isConnected) {
+      element.scrollIntoView({
+        behavior: 'smooth',
+        block: 'center'
+      });
+    }
+    return cleanup;
+  }
+  try {
+    // Step 1: Find all parent expands (outermost to innermost).
+    var parentExpands = findParentExpands(element, MAX_EXPAND_DEPTH);
+
+    // Step 2: Find any collapsed expands (filter out disconnected elements).
+    var collapsedExpands = parentExpands.filter(function (expandContainer) {
+      return expandContainer.isConnected && isExpandCollapsed(expandContainer);
+    });
+    if (collapsedExpands.length === 0) {
+      // All expands are open (or there are no expands), scroll to element.
+      element.scrollIntoView({
+        behavior: 'smooth',
+        block: 'center'
+      });
+      return cleanup;
+    }
+
+    // Step 3: Expand ONLY the outermost collapsed expand first.
+    // This is critical for nested expands - we must expand parent before child.
+    var outermostCollapsed = collapsedExpands[0];
+    try {
+      var expanded = expandElement(outermostCollapsed);
+      if (expanded) {
+        // Successfully expanded, wait briefly for DOM update then recurse to handle any nested expands.
+        // Note: There's no animation, but we need a minimal delay for DOM/React updates.
+        timeoutId = setTimeout(function () {
+          try {
+            // Verify element is still connected before proceeding.
+            if (!element.isConnected) {
+              return;
+            }
+
+            // Recurse to handle any nested collapsed expands or retry if still collapsed.
+            nestedCleanup = _expandAllParentsThenScroll(element, attempt + 1);
+          } catch (_unused) {
+            // Fallback to simple scroll on error.
+            if (element.isConnected) {
+              element.scrollIntoView({
+                behavior: 'smooth',
+                block: 'center'
+              });
+            }
+          }
+        }, DOM_UPDATE_DELAY);
+      } else {
+        // Failed to expand, retry with longer delay.
+        timeoutId = setTimeout(function () {
+          if (element.isConnected) {
+            nestedCleanup = _expandAllParentsThenScroll(element, attempt + 1);
+          }
+        }, RETRY_DELAY);
+      }
+    } catch (_unused2) {
+      // Retry on error.
+      timeoutId = setTimeout(function () {
+        if (element.isConnected) {
+          nestedCleanup = _expandAllParentsThenScroll(element, attempt + 1);
+        }
+      }, RETRY_DELAY);
+    }
+  } catch (_unused3) {
+    // Fallback to simple scroll on error.
+    if (element.isConnected) {
+      element.scrollIntoView({
+        behavior: 'smooth',
+        block: 'center'
+      });
+    }
+  }
+  return cleanup;
+};
+export { _expandAllParentsThenScroll as expandAllParentsThenScroll };
+export var getLocalIdSelector = function getLocalIdSelector(localId, container) {
+  // Check if the element with data-local-id exists
+  var element = container.querySelector("[data-local-id=\"".concat(localId, "\"]"));
+  if (element) {
+    return element;
+  }
+
+  // Special case for decision lists and task lists which already have localId
+  element = container.querySelector("[data-decision-list-local-id=\"".concat(localId, "\"]"));
+  if (element) {
+    return element;
+  }
+  element = container.querySelector("[data-task-list-local-id=\"".concat(localId, "\"]"));
+  if (element) {
+    return element;
+  }
+
+  // Special case for tables which use data-table-local-id
+  element = container.querySelector("[data-table-local-id=\"".concat(localId, "\"]"));
+  if (element) {
+    return element;
+  }
+
+  // Special case for extension, smart cards and media which use lowercase localid
+  element = container.querySelector("[localid=\"".concat(localId, "\"]"));
+  if (element) {
+    return element;
+  }
+  return null;
+};

package/dist/types/analytics/types/enums.d.ts

@@ -104,6 +104,8 @@ export declare enum ACTION {
     REACT_NODEVIEW_RENDERED = "reactNodeViewRendered",
     REFERENCE_SYNCED_BLOCK_DELETE = "referenceSyncedBlockDelete",
     REFERENCE_SYNCED_BLOCK_UPDATE = "referenceSyncedBlockUpdate",
+    REFERENCE_SYNCED_BLOCK_UNSYNC = "referenceSyncedBlockUnsync",
+    REFERENCE_SYNCED_BLOCK_COPY = "referenceSyncedBlockCopy",
     REPLACED_ALL = "replacedAll",
     REPLACED_ONE = "replacedOne",
     RESOLVED = "resolved",
@@ -121,6 +123,9 @@ export declare enum ACTION {
     SYNCED_BLOCK_FETCH_REFERENCES = "syncedBlockFetchReferences",
     SYNCED_BLOCK_DELETE = "syncedBlockDelete",
     SYNCED_BLOCK_GET_SOURCE_INFO = "syncedBlockGetSourceInfo",
+    SYNCED_BLOCK_UNSYNC = "syncedBlockUnsync",
+    SYNCED_BLOCK_EDIT_SOURCE = "syncedBlockEditSource",
+    SYNCED_BLOCK_VIEW_SYNCED_LOCATIONS = "syncedBlockViewSyncedLocations",
     SYNCHRONY_DISCONNECTED = "synchronyDisconnected",
     SYNCHRONY_ENTITY_ERROR = "synchronyEntityError",
     SYNCHRONY_ERROR = "synchronyError",
@@ -247,6 +252,7 @@ export declare enum INPUT_METHOD {
     DOUBLE_CLICK = "doubleClick",
     META_CLICK = "metaClick",
     INLINE_SUGGESTION_FLOATING_TB = "inlineSuggestionFloatingToolbar",
+    SYNCED_BLOCK_TB = "syncedBlockToolbar",
     BLOCK_MENU = "blockMenu",
     SMART_LINK = "smartLink"
 }
@@ -527,6 +533,7 @@ export declare enum ACTION_SUBJECT_ID {
     EDITOR_PLUGIN_SELECTION_EXTENSION_COMPONENT = "editorPluginSelectionExtensionComponent",
     TRANSFORM = "transform",
     SYNCED_BLOCK_TOOLBAR = "syncedBlockToolbar",
+    SYNCED_BLOCK_COPY = "syncedBlockCopy",
     SYNCED_BLOCK_SOURCE_URL = "syncedBlockSourceUrl",
     SYNCED_BLOCK_UPDATE_CACHE = "syncedBlockUpdateCache",
     SYNCED_BLOCK_UPDATE = "syncedBlockUpdate",
@@ -538,6 +545,7 @@ export declare enum ACTION_SUBJECT_ID {
     SYNCED_BLOCK_GET_SOURCE_INFO = "syncedBlockGetSourceInfo",
     SYNCED_BLOCK_FETCH = "syncedBlockFetch",
     SYNCED_BLOCK_FETCH_REFERENCES = "syncedBlockFetchReferences",
+    SYNCED_BLOCK_CLICK_SYNCED_LOCATION = "syncedBlockClickSyncedLocation",
     TABLE_STICKY_HEADER = "tableStickyHeader"
 }
 export declare enum FLOATING_CONTROLS_TITLE {

package/dist/types/analytics/types/sync-block-events.d.ts

@@ -1,4 +1,4 @@
-import type { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID } from './enums';
+import type { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, INPUT_METHOD } from './enums';
 import type { ExperienceEventPayload } from './experience-events';
 import type { OperationalAEP } from './utils';
 type SyncedBlockErrorAttributes = {
@@ -12,6 +12,12 @@ type SyncedBlockSuccessAttributes = {
 type FetchSyncedBlockSuccessAttributes = SyncedBlockSuccessAttributes & {
     sourceProduct?: string;
 };
+type SyncedBlockCopySuccessAttributes = SyncedBlockSuccessAttributes & {
+    inputMethod: INPUT_METHOD;
+};
+type SyncedBlockCopyErrorAttributes = SyncedBlockErrorAttributes & {
+    inputMethod: INPUT_METHOD;
+};
 export type SyncedBlockSourceURLErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_SOURCE_URL, SyncedBlockErrorAttributes>;
 export type SyncedBlockUpdateCacheErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE_CACHE, SyncedBlockErrorAttributes>;
 export type SyncedBlockUpdateErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, SyncedBlockErrorAttributes>;
@@ -27,6 +33,10 @@ export type SyncedBlockUpdateSuccessAEP = OperationalAEP<ACTION.UPDATED, ACTION_
 export type SyncedBlockDeleteSuccessAEP = OperationalAEP<ACTION.DELETED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, SyncedBlockSuccessAttributes>;
 export type ReferenceSyncedBlockCreateSuccessAEP = OperationalAEP<ACTION.INSERTED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_CREATE, SyncedBlockSuccessAttributes>;
 export type ReferenceSyncedBlockDeleteSuccessAEP = OperationalAEP<ACTION.DELETED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_DELETE, SyncedBlockSuccessAttributes>;
-export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP;
+export type SyncedBlockEditSourceAEP = OperationalAEP<ACTION.SYNCED_BLOCK_EDIT_SOURCE, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_SOURCE_URL, SyncedBlockSuccessAttributes>;
+export type SyncedBlockCopyAEP = OperationalAEP<ACTION.COPIED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopySuccessAttributes>;
+export type SyncedBlockCopyErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopyErrorAttributes>;
+export type SyncedLocationClickAEP = OperationalAEP<ACTION.CLICKED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_CLICK_SYNCED_LOCATION, SyncedBlockSuccessAttributes>;
+export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP | SyncedBlockEditSourceAEP | SyncedBlockCopyAEP | SyncedBlockCopyErrorAEP | SyncedLocationClickAEP;
 export type RendererSyncBlockEventPayload = SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | ExperienceEventPayload;
 export {};

package/dist/types/block-menu/block-link.d.ts

@@ -1,25 +1,37 @@
 export declare const DEFAULT_BLOCK_LINK_HASH_PREFIX = "block-";
 /**
- * Matches hashes that start with the block link prefix followed by a UUID
+ * Matches hashes that start with the block link prefix followed by either:
+ * - A UUID (e.g., '123e4567-e89b-12d3-a456-426614174000')
+ * - A short hex ID (e.g., 'ab2366c43b52')
  *
- * @param hash The hash string to check (e.g., '#block-123e4567-e89b-12d3-a456-426614174000' or 'block-123e4567-e89b-12d3-a456-426614174000')
- * @param prefix The prefix to look for (default is 'block-')
- * @returns True if the hash matches the block link pattern, false otherwise
+ * Short hex IDs are 12-character hexadecimal strings without dashes, used in some contexts
+ * as a compact alternative to full UUIDs. Both formats are valid block identifiers.
+ *
+ * Note: The short ID pattern matches exactly 12 hex characters. While this could theoretically
+ * match heading IDs or other anchors, block links are typically generated programmatically
+ * with known ID formats, minimizing collision risk.
+ *
+ * @param hash - The hash string to check (e.g., '#block-123e4567-e89b-12d3-a456-426614174000', '#block-ab2366c43b52', or without '#').
+ * @param prefix - The prefix to look for (default is 'block-').
+ * @returns True if the hash matches the block link pattern, false otherwise.
  */
 export declare const isBlockLinkHash: (hash: string, prefix?: string) => boolean;
 /**
  * Extracts the block ID from a block link hash.
  *
- * @param hash The hash string to extract the block ID from (e.g., '#block-123e4567-e89b-12d3-a456-426614174000' or 'block-123e4567-e89b-12d3-a456-426614174000')
- * @param prefix The prefix to look for (default is 'block-')
- * @returns The extracted block ID if the hash is valid, null otherwise
+ * Supports both UUID format (e.g., '123e4567-e89b-12d3-a456-426614174000') and
+ * short hex ID format (e.g., 'ab2366c43b52').
+ *
+ * @param hash - The hash string to extract the block ID from (e.g., '#block-123e4567-e89b-12d3-a456-426614174000', '#block-ab2366c43b52', or without '#').
+ * @param prefix - The prefix to look for (default is 'block-').
+ * @returns The extracted block ID if the hash is valid, null otherwise.
  */
 export declare const extractBlockIdFromLinkHash: (hash: string, prefix?: string) => string | null;
 /**
  * Creates a block link hash from a given block ID.
  *
- * @param blockId The block ID to create the hash from (e.g., '123e4567-e89b-12d3-a456-426614174000')
- * @param prefix The prefix to use (default is 'block-')
- * @returns The constructed block link hash value (e.g., 'block-123e4567-e89b-12d3-a456-426614174000')
+ * @param blockId - The block ID to create the hash from (e.g., '123e4567-e89b-12d3-a456-426614174000').
+ * @param prefix - The prefix to use (default is 'block-').
+ * @returns The constructed block link hash value (e.g., 'block-123e4567-e89b-12d3-a456-426614174000').
  */
 export declare const createBlockLinkHashValue: (blockId: string, prefix?: string) => string;

package/dist/types/block-menu/index.d.ts

@@ -4,4 +4,6 @@ export { FORMAT_HEADING_1_MENU_ITEM, FORMAT_HEADING_2_MENU_ITEM, FORMAT_HEADING_
 export { MAIN_BLOCK_MENU_SECTION_RANK, TRANSFORM_MENU_SECTION_RANK, TRANSFORM_MENU_ITEM_RANK, TRANSFORM_HEADINGS_MENU_SECTION_RANK, TRANSFORM_STRUCTURE_MENU_SECTION_RANK, TRANSFORM_CLEAR_MENU_SECTION_RANK, BLOCK_ACTIONS_MENU_SECTION_RANK, POSITION_MENU_SECTION_RANK, DELETE_MENU_SECTION_RANK, TRANSFORM_SUGGESTED_MENU_SECTION_RANK, TRANSFORM_CREATE_MENU_SECTION_RANK, } from './rank';
 export { FORMAT_NESTED_MENU_RANK, FORMAT_NESTED_MENU_RANK_REVISED, BLOCK_MENU_SECTION_RANK, PRIMARY_MENU_SECTION_RANK, COPY_MENU_SECTION_RANK, DELETE_SECTION_RANK, MOVE_BLOCK_SECTION_RANK, ADD_BLOCKS_MENU_SECTION_RANK, } from './rank-deprecated';
 export { createBlockLinkHashValue, DEFAULT_BLOCK_LINK_HASH_PREFIX, extractBlockIdFromLinkHash, isBlockLinkHash, } from './block-link';
+export { expandAllParentsThenScroll, findParentExpands, isExpandCollapsed, expandElement, findNodeWithExpandParents, SCROLL_TO_BLOCK_TIMING, getLocalIdSelector, } from './scroll-to-block-utils';
+export type { NodeWithExpandParents } from './scroll-to-block-utils';
 export type { BlockMenuPlacement } from './placement';

package/dist/types/block-menu/scroll-to-block-utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared utilities for scrolling to block elements with expand node support.
+ * Used by both Confluence's useScrollOnUrlChange and platform renderer's useScrollToBlock.
+ */
+import type { DocNode } from '@atlaskit/adf-schema';
+/**
+ * Timing constants for expand animation and DOM update delays.
+ * These values are tuned for the expand component's behavior and React's update cycle.
+ */
+export declare const SCROLL_TO_BLOCK_TIMING: {
+    /** Minimal delay for DOM/React updates after expanding (no animation in expand component). */
+    readonly DOM_UPDATE_DELAY: 50;
+    /** Delay when expand operation fails and needs retry. */
+    readonly RETRY_DELAY: 100;
+    /** Maximum number of retry attempts before giving up and scrolling anyway. */
+    readonly MAX_ATTEMPTS: 5;
+    /** Maximum depth of nested expands to search (prevents infinite loops). */
+    readonly MAX_EXPAND_DEPTH: 2;
+};
+export type NodeWithExpandParents = {
+    /** Array of expand parent localIds (empty if no expand parents, ordered from outermost to innermost). */
+    expandParentLocalIds: string[];
+};
+/**
+ * Find a node by its localId in an ADF document and determine if it has expand or nestedExpand parents.
+ * This is used to identify nodes that may be hidden inside collapsed expands.
+ *
+ * @param adfDoc - The ADF document to search
+ * @param targetLocalId - The localId to search for
+ * @returns NodeWithExpandParents if found, undefined otherwise
+ */
+export declare function findNodeWithExpandParents(adfDoc: DocNode, targetLocalId: string): NodeWithExpandParents | undefined;
+/**
+ * Find all parent expand elements that contain the target element.
+ * Searches up the DOM tree to find expand or nestedExpand containers.
+ *
+ * This function limits the search depth to prevent infinite loops and performance issues.
+ * The default maxDepth of 2 is chosen because:
+ * - Most use cases have 0-2 levels of nesting
+ * - Searching deeper can impact performance
+ * - Users rarely nest expands more than 2 levels deep
+ *
+ * @param element - The target element to find parents for.
+ * @param maxDepth - Maximum depth to search (default: 2). This is the maximum number of
+ *                   expand ancestors to find, starting from the target element.
+ * @returns Array of expand containers ordered from outermost to innermost.
+ *          For example, if element is inside expand B which is inside expand A,
+ *          this returns [expandA, expandB].
+ */
+export declare const findParentExpands: (element: HTMLElement, maxDepth?: number) => HTMLElement[];
+/**
+ * Check if an expand node is currently collapsed.
+ *
+ * Uses two methods to determine collapse state:
+ * 1. First checks aria-expanded attribute on the toggle button (most reliable).
+ * 2. Falls back to checking content div visibility via computed styles.
+ *
+ * @param expandContainer - The expand container element.
+ * @returns True if the expand is collapsed, false if expanded or state cannot be determined.
+ */
+export declare const isExpandCollapsed: (expandContainer: HTMLElement) => boolean;
+/**
+ * Expand a collapsed expand node by clicking its toggle button.
+ *
+ * This function finds the toggle button with aria-expanded="false" and programmatically
+ * clicks it to expand the node. It does not wait for the expansion to complete.
+ *
+ * @param expandContainer - The expand container element.
+ * @returns True if the toggle button was found and clicked, false otherwise.
+ */
+export declare const expandElement: (expandContainer: HTMLElement) => boolean;
+/**
+ * Expand all parent expands then scroll to the element.
+ *
+ * This is the main entry point for scrolling to elements that may be hidden inside collapsed expands.
+ * It handles nested expands by expanding them one at a time from outermost to innermost,
+ * waiting for DOM updates between each expansion.
+ *
+ * The function uses a recursive approach with retry logic to handle:
+ * - Nested expands that need sequential expansion
+ * - DOM updates that may take time to reflect
+ * - Failed expand operations (e.g., if toggle button is temporarily unavailable)
+ * - Disconnected elements (removed from DOM)
+ *
+ * After all parent expands are open (or max attempts reached), scrolls the element into view
+ * with smooth behavior and centered in the viewport.
+ *
+ * @param element - The target element to scroll to.
+ * @param attempt - Current attempt number (used internally for retry logic, starts at 0).
+ * @returns A cleanup function that cancels any pending timeouts. Call this when the operation
+ *          should be aborted (e.g., component unmount, navigation, or new scroll request).
+ */
+export declare const expandAllParentsThenScroll: (element: HTMLElement, attempt?: number) => (() => void);
+export declare const getLocalIdSelector: (localId: string, container: HTMLElement) => HTMLElement | null;

package/dist/types-ts4.5/analytics/types/enums.d.ts

@@ -104,6 +104,8 @@ export declare enum ACTION {
     REACT_NODEVIEW_RENDERED = "reactNodeViewRendered",
     REFERENCE_SYNCED_BLOCK_DELETE = "referenceSyncedBlockDelete",
     REFERENCE_SYNCED_BLOCK_UPDATE = "referenceSyncedBlockUpdate",
+    REFERENCE_SYNCED_BLOCK_UNSYNC = "referenceSyncedBlockUnsync",
+    REFERENCE_SYNCED_BLOCK_COPY = "referenceSyncedBlockCopy",
     REPLACED_ALL = "replacedAll",
     REPLACED_ONE = "replacedOne",
     RESOLVED = "resolved",
@@ -121,6 +123,9 @@ export declare enum ACTION {
     SYNCED_BLOCK_FETCH_REFERENCES = "syncedBlockFetchReferences",
     SYNCED_BLOCK_DELETE = "syncedBlockDelete",
     SYNCED_BLOCK_GET_SOURCE_INFO = "syncedBlockGetSourceInfo",
+    SYNCED_BLOCK_UNSYNC = "syncedBlockUnsync",
+    SYNCED_BLOCK_EDIT_SOURCE = "syncedBlockEditSource",
+    SYNCED_BLOCK_VIEW_SYNCED_LOCATIONS = "syncedBlockViewSyncedLocations",
     SYNCHRONY_DISCONNECTED = "synchronyDisconnected",
     SYNCHRONY_ENTITY_ERROR = "synchronyEntityError",
     SYNCHRONY_ERROR = "synchronyError",
@@ -247,6 +252,7 @@ export declare enum INPUT_METHOD {
     DOUBLE_CLICK = "doubleClick",
     META_CLICK = "metaClick",
     INLINE_SUGGESTION_FLOATING_TB = "inlineSuggestionFloatingToolbar",
+    SYNCED_BLOCK_TB = "syncedBlockToolbar",
     BLOCK_MENU = "blockMenu",
     SMART_LINK = "smartLink"
 }
@@ -527,6 +533,7 @@ export declare enum ACTION_SUBJECT_ID {
     EDITOR_PLUGIN_SELECTION_EXTENSION_COMPONENT = "editorPluginSelectionExtensionComponent",
     TRANSFORM = "transform",
     SYNCED_BLOCK_TOOLBAR = "syncedBlockToolbar",
+    SYNCED_BLOCK_COPY = "syncedBlockCopy",
     SYNCED_BLOCK_SOURCE_URL = "syncedBlockSourceUrl",
     SYNCED_BLOCK_UPDATE_CACHE = "syncedBlockUpdateCache",
     SYNCED_BLOCK_UPDATE = "syncedBlockUpdate",
@@ -538,6 +545,7 @@ export declare enum ACTION_SUBJECT_ID {
     SYNCED_BLOCK_GET_SOURCE_INFO = "syncedBlockGetSourceInfo",
     SYNCED_BLOCK_FETCH = "syncedBlockFetch",
     SYNCED_BLOCK_FETCH_REFERENCES = "syncedBlockFetchReferences",
+    SYNCED_BLOCK_CLICK_SYNCED_LOCATION = "syncedBlockClickSyncedLocation",
     TABLE_STICKY_HEADER = "tableStickyHeader"
 }
 export declare enum FLOATING_CONTROLS_TITLE {

package/dist/types-ts4.5/analytics/types/sync-block-events.d.ts

@@ -1,4 +1,4 @@
-import type { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID } from './enums';
+import type { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, INPUT_METHOD } from './enums';
 import type { ExperienceEventPayload } from './experience-events';
 import type { OperationalAEP } from './utils';
 type SyncedBlockErrorAttributes = {
@@ -12,6 +12,12 @@ type SyncedBlockSuccessAttributes = {
 type FetchSyncedBlockSuccessAttributes = SyncedBlockSuccessAttributes & {
     sourceProduct?: string;
 };
+type SyncedBlockCopySuccessAttributes = SyncedBlockSuccessAttributes & {
+    inputMethod: INPUT_METHOD;
+};
+type SyncedBlockCopyErrorAttributes = SyncedBlockErrorAttributes & {
+    inputMethod: INPUT_METHOD;
+};
 export type SyncedBlockSourceURLErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_SOURCE_URL, SyncedBlockErrorAttributes>;
 export type SyncedBlockUpdateCacheErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE_CACHE, SyncedBlockErrorAttributes>;
 export type SyncedBlockUpdateErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, SyncedBlockErrorAttributes>;
@@ -27,6 +33,10 @@ export type SyncedBlockUpdateSuccessAEP = OperationalAEP<ACTION.UPDATED, ACTION_
 export type SyncedBlockDeleteSuccessAEP = OperationalAEP<ACTION.DELETED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, SyncedBlockSuccessAttributes>;
 export type ReferenceSyncedBlockCreateSuccessAEP = OperationalAEP<ACTION.INSERTED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_CREATE, SyncedBlockSuccessAttributes>;
 export type ReferenceSyncedBlockDeleteSuccessAEP = OperationalAEP<ACTION.DELETED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_DELETE, SyncedBlockSuccessAttributes>;
-export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP;
+export type SyncedBlockEditSourceAEP = OperationalAEP<ACTION.SYNCED_BLOCK_EDIT_SOURCE, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_SOURCE_URL, SyncedBlockSuccessAttributes>;
+export type SyncedBlockCopyAEP = OperationalAEP<ACTION.COPIED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopySuccessAttributes>;
+export type SyncedBlockCopyErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopyErrorAttributes>;
+export type SyncedLocationClickAEP = OperationalAEP<ACTION.CLICKED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_CLICK_SYNCED_LOCATION, SyncedBlockSuccessAttributes>;
+export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP | SyncedBlockEditSourceAEP | SyncedBlockCopyAEP | SyncedBlockCopyErrorAEP | SyncedLocationClickAEP;
 export type RendererSyncBlockEventPayload = SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | ExperienceEventPayload;
 export {};