@atlaskit/editor-common 110.15.1 → 110.15.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @atlaskit/editor-common
 
+## 110.15.2
+
+### Patch Changes
+
+- [`916133ef0c6dd`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/916133ef0c6dd) -
+  [ux] Editor experience tracking foundation
+- [`6e51d74bb2a29`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/6e51d74bb2a29) -
+  [ux] ED-29560 Use hash instead of query parameter for link to block
+- Updated dependencies
+
 ## 110.15.1
 
 ### Patch Changes

package/afm-cc/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-cc/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-cc/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-cc/tsconfig.json"
 		},

package/afm-dev-agents/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-dev-agents/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-dev-agents/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-dev-agents/tsconfig.json"
 		},

package/afm-jira/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-jira/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-jira/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-jira/tsconfig.json"
 		},

package/afm-passionfruit/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-passionfruit/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-passionfruit/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-passionfruit/tsconfig.json"
 		},

package/afm-post-office/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-post-office/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-post-office/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-post-office/tsconfig.json"
 		},

package/afm-rovo-extension/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-rovo-extension/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-rovo-extension/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-rovo-extension/tsconfig.json"
 		},

package/afm-townsquare/tsconfig.json

@@ -182,6 +182,9 @@
 		{
 			"path": "../../../design-system/tooltip/afm-townsquare/tsconfig.json"
 		},
+		{
+			"path": "../../../data/ufo-external/afm-townsquare/tsconfig.json"
+		},
 		{
 			"path": "../../../design-system/width-detector/afm-townsquare/tsconfig.json"
 		},

package/dist/cjs/block-menu/block-link.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isBlockLinkHash = exports.extractBlockIdFromLinkHash = exports.DEFAULT_BLOCK_LINK_HASH_PREFIX = void 0;
+var DEFAULT_BLOCK_LINK_HASH_PREFIX = exports.DEFAULT_BLOCK_LINK_HASH_PREFIX = 'block-';
+
+/**
+ * Matches hashes that start with the block link prefix followed by a UUID
+ *
+ * @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
+ */
+var isBlockLinkHash = exports.isBlockLinkHash = function isBlockLinkHash(hash) {
+  var prefix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DEFAULT_BLOCK_LINK_HASH_PREFIX;
+  if (!hash || !prefix) {
+    return false;
+  }
+  var regex = new RegExp("^#?".concat(prefix, "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"), 'iu');
+  return regex.test(hash);
+};
+
+/**
+ * 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
+ */
+var extractBlockIdFromLinkHash = exports.extractBlockIdFromLinkHash = function extractBlockIdFromLinkHash(hash) {
+  var prefix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DEFAULT_BLOCK_LINK_HASH_PREFIX;
+  if (!isBlockLinkHash(hash, prefix)) {
+    return null;
+  }
+  // Remove leading # if present, then remove the prefix
+  var normalized = hash.startsWith('#') ? hash.slice(1) : hash;
+  return normalized.slice(prefix.length);
+};

package/dist/cjs/block-menu/index.js

@@ -51,6 +51,12 @@ Object.defineProperty(exports, "CREATE_SYNCED_BLOCK_MENU_ITEM", {
     return _key.CREATE_SYNCED_BLOCK_MENU_ITEM;
   }
 });
+Object.defineProperty(exports, "DEFAULT_BLOCK_LINK_HASH_PREFIX", {
+  enumerable: true,
+  get: function get() {
+    return _blockLink.DEFAULT_BLOCK_LINK_HASH_PREFIX;
+  }
+});
 Object.defineProperty(exports, "DELETE_MENU_ITEM", {
   enumerable: true,
   get: function get() {
@@ -225,6 +231,18 @@ Object.defineProperty(exports, "PRIMARY_MENU_SECTION_RANK", {
     return _rank.PRIMARY_MENU_SECTION_RANK;
   }
 });
+Object.defineProperty(exports, "extractBlockIdFromLinkHash", {
+  enumerable: true,
+  get: function get() {
+    return _blockLink.extractBlockIdFromLinkHash;
+  }
+});
+Object.defineProperty(exports, "isBlockLinkHash", {
+  enumerable: true,
+  get: function get() {
+    return _blockLink.isBlockLinkHash;
+  }
+});
 Object.defineProperty(exports, "messages", {
   enumerable: true,
   get: function get() {
@@ -233,4 +251,5 @@ Object.defineProperty(exports, "messages", {
 });
 var _messages = require("./messages");
 var _key = require("./key");
-var _rank = require("./rank");
+var _rank = require("./rank");
+var _blockLink = require("./block-link");

package/dist/cjs/experiences/Experience.js

@@ -0,0 +1,110 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Experience = void 0;
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _ufo = require("@atlaskit/ufo");
+var _ExperienceCheckComposite = require("./ExperienceCheckComposite");
+var PROGRESS_STATES = [_ufo.UFOExperienceState.STARTED.id, _ufo.UFOExperienceState.IN_PROGRESS.id];
+var Experience = exports.Experience = /*#__PURE__*/function () {
+  function Experience(id) {
+    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    (0, _classCallCheck2.default)(this, Experience);
+    this.id = id;
+    this.options = options;
+    this.check = new _ExperienceCheckComposite.ExperienceCheckComposite(this.options.checks || []);
+  }
+  return (0, _createClass2.default)(Experience, [{
+    key: "ufoExperience",
+    get: function get() {
+      if (!this._ufoExperience) {
+        this._ufoExperience = new _ufo.UFOExperience(this.id, {
+          type: _ufo.ExperienceTypes.Experience,
+          performanceType: _ufo.ExperiencePerformanceTypes.InlineResult
+        });
+      }
+      return this._ufoExperience;
+    }
+  }, {
+    key: "startCheck",
+    value: function startCheck() {
+      var _this = this;
+      this.stopCheck();
+      this.check.start(function (result) {
+        if (result.status === 'success') {
+          _this.success();
+        } else {
+          _this.failure({
+            reason: result.reason
+          });
+        }
+      });
+    }
+  }, {
+    key: "stopCheck",
+    value: function stopCheck() {
+      this.check.stop();
+    }
+  }, {
+    key: "isInProgress",
+    value: function isInProgress() {
+      return PROGRESS_STATES.includes(this.ufoExperience.state.id);
+    }
+
+    /**
+     * Starts UFO experience tracking and starts all checks which monitor for completion of the experience.
+     */
+  }, {
+    key: "start",
+    value: function start() {
+      this.ufoExperience.start();
+      if (this.isInProgress()) {
+        this.startCheck();
+      }
+    }
+
+    /**
+     * Manually mark the experience as successful and stop any ongoing checks.
+     */
+  }, {
+    key: "success",
+    value: function success() {
+      this.stopCheck();
+      this.ufoExperience.success();
+    }
+
+    /**
+     * Manually abort the experience and stop any ongoing checks.
+     *
+     * Typically used when the experience did not complete due to user action and should not be marked as success or failure,
+     * for example on unmount or when navigating away from a page.
+     */
+  }, {
+    key: "abort",
+    value: function abort() {
+      this.stopCheck();
+      this.ufoExperience.abort();
+    }
+
+    /**
+     * Manually mark the experience as failed and stop any ongoing checks.
+     */
+  }, {
+    key: "failure",
+    value: function failure() {
+      var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+        _ref$reason = _ref.reason,
+        reason = _ref$reason === void 0 ? 'error' : _ref$reason;
+      this.stopCheck();
+      this.ufoExperience.failure({
+        metadata: {
+          reason: reason
+        }
+      });
+    }
+  }]);
+}();

package/dist/cjs/experiences/ExperienceCheck.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/experiences/ExperienceCheckComposite.js

@@ -0,0 +1,35 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ExperienceCheckComposite = void 0;
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+/**
+ * Composite check that combines multiple checks.
+ *
+ * Starts and stops all contained checks.
+ */
+var ExperienceCheckComposite = exports.ExperienceCheckComposite = /*#__PURE__*/function () {
+  function ExperienceCheckComposite(checks) {
+    (0, _classCallCheck2.default)(this, ExperienceCheckComposite);
+    this.checks = checks;
+  }
+  return (0, _createClass2.default)(ExperienceCheckComposite, [{
+    key: "start",
+    value: function start(callback) {
+      this.checks.forEach(function (check) {
+        return check.start(callback);
+      });
+    }
+  }, {
+    key: "stop",
+    value: function stop() {
+      this.checks.forEach(function (check) {
+        return check.stop();
+      });
+    }
+  }]);
+}();

package/dist/cjs/experiences/ExperienceCheckDomMutation.js

@@ -0,0 +1,68 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ExperienceCheckDomMutation = void 0;
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _consts = require("./consts");
+/**
+ * Check for the completion of an experience based on DOM mutations
+ *
+ * Uses a MutationObserver to monitor DOM changes and invokes the provided
+ * callback when relevant mutations are detected.
+ *
+ * Will result in success or failure based on the outcome of the callback.
+ */
+var ExperienceCheckDomMutation = exports.ExperienceCheckDomMutation = /*#__PURE__*/function () {
+  function ExperienceCheckDomMutation(_ref) {
+    var onDomMutation = _ref.onDomMutation,
+      observeConfig = _ref.observeConfig;
+    (0, _classCallCheck2.default)(this, ExperienceCheckDomMutation);
+    this.onDomMutation = onDomMutation;
+    this.observeConfig = observeConfig;
+  }
+  return (0, _createClass2.default)(ExperienceCheckDomMutation, [{
+    key: "start",
+    value: function start(callback) {
+      var _this = this;
+      this.stop();
+      var config = this.observeConfig();
+      if (!config) {
+        callback({
+          status: 'failure',
+          reason: _consts.EXPERIENCE_FAILURE_REASON.DOM_MUTATION_TARGET_NOT_FOUND
+        });
+        return;
+      }
+      this.mutationObserver = new MutationObserver(function (mutations) {
+        try {
+          var result = _this.onDomMutation({
+            mutations: mutations
+          });
+          if (result) {
+            callback(result);
+          }
+        } catch (error) {
+          callback({
+            status: 'failure',
+            reason: _consts.EXPERIENCE_FAILURE_REASON.DOM_MUTATION_CHECK_ERROR
+          });
+        }
+      });
+      var target = config.target,
+        options = config.options;
+      this.mutationObserver.observe(target, options);
+    }
+  }, {
+    key: "stop",
+    value: function stop() {
+      if (this.mutationObserver) {
+        this.mutationObserver.disconnect();
+        this.mutationObserver = undefined;
+      }
+    }
+  }]);
+}();

package/dist/cjs/experiences/ExperienceCheckTimeout.js

@@ -0,0 +1,41 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ExperienceCheckTimeout = void 0;
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _consts = require("./consts");
+/**
+ * Check for the completion of an experience based on a timeout
+ *
+ * Will always result in failure after the timeout duration
+ */
+var ExperienceCheckTimeout = exports.ExperienceCheckTimeout = /*#__PURE__*/function () {
+  function ExperienceCheckTimeout(maxDurationMs) {
+    (0, _classCallCheck2.default)(this, ExperienceCheckTimeout);
+    this.maxDurationMs = maxDurationMs;
+  }
+  return (0, _createClass2.default)(ExperienceCheckTimeout, [{
+    key: "start",
+    value: function start(callback) {
+      this.stop();
+      this.timeoutId = setTimeout(function () {
+        callback({
+          status: 'failure',
+          reason: _consts.EXPERIENCE_FAILURE_REASON.TIMEOUT
+        });
+      }, this.maxDurationMs);
+    }
+  }, {
+    key: "stop",
+    value: function stop() {
+      if (this.timeoutId) {
+        clearTimeout(this.timeoutId);
+        this.timeoutId = undefined;
+      }
+    }
+  }]);
+}();

package/dist/cjs/experiences/consts.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EXPERIENCE_FAILURE_REASON = void 0;
+/**
+ * Built-in failure reasons for experience checks
+ *
+ * These are used by the various ExperienceCheck implementations to
+ * provide consistent, well-known failure reasons for analytics and debugging.
+ */
+var EXPERIENCE_FAILURE_REASON = exports.EXPERIENCE_FAILURE_REASON = {
+  /**
+   * Experience timed out before completion
+   */
+  TIMEOUT: 'timeout',
+  /**
+   * Target element could not be found when starting DOM mutation observation
+   */
+  DOM_MUTATION_TARGET_NOT_FOUND: 'dom-mutation-target-not-found',
+  /**
+   * Error occurred during DOM mutation check execution
+   */
+  DOM_MUTATION_CHECK_ERROR: 'dom-mutation-check-error'
+};

package/dist/cjs/experiences/index.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "EXPERIENCE_FAILURE_REASON", {
+  enumerable: true,
+  get: function get() {
+    return _consts.EXPERIENCE_FAILURE_REASON;
+  }
+});
+Object.defineProperty(exports, "Experience", {
+  enumerable: true,
+  get: function get() {
+    return _Experience.Experience;
+  }
+});
+Object.defineProperty(exports, "ExperienceCheckComposite", {
+  enumerable: true,
+  get: function get() {
+    return _ExperienceCheckComposite.ExperienceCheckComposite;
+  }
+});
+Object.defineProperty(exports, "ExperienceCheckDomMutation", {
+  enumerable: true,
+  get: function get() {
+    return _ExperienceCheckDomMutation.ExperienceCheckDomMutation;
+  }
+});
+Object.defineProperty(exports, "ExperienceCheckTimeout", {
+  enumerable: true,
+  get: function get() {
+    return _ExperienceCheckTimeout.ExperienceCheckTimeout;
+  }
+});
+var _Experience = require("./Experience");
+var _consts = require("./consts");
+var _ExperienceCheckComposite = require("./ExperienceCheckComposite");
+var _ExperienceCheckDomMutation = require("./ExperienceCheckDomMutation");
+var _ExperienceCheckTimeout = require("./ExperienceCheckTimeout");

package/dist/cjs/monitoring/error.js

@@ -16,7 +16,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 var SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 var packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-var packageVersion = "110.15.0";
+var packageVersion = "0.0.0-development";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/cjs/ui/DropList/index.js

@@ -24,7 +24,7 @@ function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.
  * @jsx jsx
  */ // eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "110.15.0";
+var packageVersion = "0.0.0-development";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = (0, _react2.keyframes)({

package/dist/cjs/ui-color/ColorPalette/Palettes/highlightColorPalette.js

@@ -58,6 +58,7 @@ var EditorDiagonalLineIcon = exports.EditorDiagonalLineIcon = function EditorDia
  */
 var highlightColorPalette = exports.highlightColorPalette = [{
   value: REMOVE_HIGHLIGHT_COLOR,
+  // eslint-disable-next-line @atlassian/i18n/no-literal-string-in-object
   label: 'No color',
   // Mostly informative, only used for analytics
   border: "var(--ds-border, #091E4224)",
@@ -69,6 +70,7 @@ _adfSchema.backgroundColorPalette.forEach(function (label, color) {
 });
 var highlightColorPaletteNext = exports.highlightColorPaletteNext = [{
   value: REMOVE_HIGHLIGHT_COLOR,
+  // eslint-disable-next-line @atlassian/i18n/no-literal-string-in-object
   label: 'No color',
   // Mostly informative, only used for analytics
   border: "var(--ds-border, #091E4224)",

package/dist/cjs/ui-color/ColorPalette/Palettes/panelBackgroundPalette.js

@@ -9,7 +9,7 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _panel = require("../../../panel");
 var _common = require("./common");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /* eslint-disable @atlassian/i18n/no-literal-string-in-object */
 /** this is not new usage - old code extracted from editor-core */
 /* eslint-disable @atlaskit/design-system/ensure-design-token-usage */
 var panelBackgroundPalette = exports.panelBackgroundPalette = [{

package/dist/es2019/block-menu/block-link.js

@@ -0,0 +1,32 @@
+export const DEFAULT_BLOCK_LINK_HASH_PREFIX = 'block-';
+
+/**
+ * Matches hashes that start with the block link prefix followed by a UUID
+ *
+ * @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
+ */
+export const isBlockLinkHash = (hash, prefix = DEFAULT_BLOCK_LINK_HASH_PREFIX) => {
+  if (!hash || !prefix) {
+    return false;
+  }
+  const regex = new RegExp(`^#?${prefix}[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, 'iu');
+  return regex.test(hash);
+};
+
+/**
+ * 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
+ */
+export const extractBlockIdFromLinkHash = (hash, prefix = DEFAULT_BLOCK_LINK_HASH_PREFIX) => {
+  if (!isBlockLinkHash(hash, prefix)) {
+    return null;
+  }
+  // Remove leading # if present, then remove the prefix
+  const normalized = hash.startsWith('#') ? hash.slice(1) : hash;
+  return normalized.slice(prefix.length);
+};

package/dist/es2019/block-menu/index.js

@@ -1,4 +1,5 @@
 /* eslint-disable @atlaskit/editor/no-re-export */
 export { messages } from './messages';
 export { FORMAT_HEADING_1_MENU_ITEM, FORMAT_HEADING_2_MENU_ITEM, FORMAT_HEADING_3_MENU_ITEM, FORMAT_HEADING_4_MENU_ITEM, FORMAT_HEADING_5_MENU_ITEM, FORMAT_HEADING_6_MENU_ITEM, FORMAT_PARAGRAPH_MENU_ITEM, FORMAT_QUOTE_MENU_ITEM, FORMAT_EXPAND_MENU_ITEM, FORMAT_LAYOUT_MENU_ITEM, FORMAT_PANEL_MENU_ITEM, FORMAT_CODE_BLOCK_MENU_ITEM, FORMAT_BULLETED_LIST_MENU_ITEM, FORMAT_NUMBERED_LIST_MENU_ITEM, FORMAT_TASK_LIST_MENU_ITEM, NESTED_FORMAT_MENU_SECTION, COPY_MENU_SECTION, DELETE_MENU_SECTION, MOVE_UP_DOWN_MENU_SECTION, FORMAT_MENU_ITEM, COPY_BLOCK_MENU_ITEM, COPY_LINK_MENU_ITEM, MOVE_UP_MENU_ITEM, MOVE_DOWN_MENU_ITEM, DELETE_MENU_ITEM, NESTED_FORMAT_MENU, PRIMARY_MENU_SECTION, ADD_BLOCKS_MENU_SECTION, CREATE_SYNCED_BLOCK_MENU_ITEM } from './key';
-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';
+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';
+export { DEFAULT_BLOCK_LINK_HASH_PREFIX, isBlockLinkHash, extractBlockIdFromLinkHash } from './block-link';