@wordpress/block-library 9.36.1-next.6deb34194.0 → 9.36.1-next.738bb1424.0

package/build/navigation-link/shared/update-attributes.cjs

@@ -0,0 +1,145 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/block-library/src/navigation-link/shared/update-attributes.js
+var update_attributes_exports = {};
+__export(update_attributes_exports, {
+  updateAttributes: () => updateAttributes
+});
+module.exports = __toCommonJS(update_attributes_exports);
+var import_escape_html = require("@wordpress/escape-html");
+var import_url = require("@wordpress/url");
+var shouldSeverEntityLink = (originalUrl, newUrl) => {
+  if (!originalUrl || !newUrl) {
+    return false;
+  }
+  const normalizePath = (path) => {
+    if (!path) {
+      return "";
+    }
+    return path.replace(/\/+$/, "");
+  };
+  const createUrlObject = (url, baseUrl = null) => {
+    try {
+      const base = baseUrl || (typeof window !== "undefined" ? window.location.origin : "https://wordpress.org");
+      return new URL(url, base);
+    } catch (error) {
+      return null;
+    }
+  };
+  const originalUrlObj = createUrlObject(originalUrl);
+  if (!originalUrlObj) {
+    return true;
+  }
+  const newUrlObj = createUrlObject(newUrl, originalUrl);
+  if (!newUrlObj) {
+    return true;
+  }
+  const originalHostname = originalUrlObj.hostname;
+  const newHostname = newUrlObj.hostname;
+  const originalPath = normalizePath((0, import_url.getPath)(originalUrlObj.toString()));
+  const newPath = normalizePath((0, import_url.getPath)(newUrlObj.toString()));
+  if (originalHostname !== newHostname || originalPath !== newPath) {
+    return true;
+  }
+  const originalP = originalUrlObj.searchParams.get("p");
+  const newP = newUrlObj.searchParams.get("p");
+  if (originalP && newP && originalP !== newP) {
+    return true;
+  }
+  const originalPageId = originalUrlObj.searchParams.get("page_id");
+  const newPageId = newUrlObj.searchParams.get("page_id");
+  if (originalPageId && newPageId && originalPageId !== newPageId) {
+    return true;
+  }
+  if (originalP && newPageId || originalPageId && newP) {
+    return true;
+  }
+  return false;
+};
+var updateAttributes = (updatedValue = {}, setAttributes, blockAttributes = {}) => {
+  const {
+    label: originalLabel = "",
+    kind: originalKind = "",
+    type: originalType = ""
+  } = blockAttributes;
+  const {
+    title: newLabel = "",
+    // the title of any provided Post.
+    label: newLabelFromLabel = "",
+    // alternative to title
+    url: newUrl,
+    opensInNewTab,
+    id: newID,
+    kind: newKind = originalKind,
+    type: newType = originalType
+  } = updatedValue;
+  const finalNewLabel = newLabel || newLabelFromLabel;
+  const newLabelWithoutHttp = finalNewLabel.replace(/http(s?):\/\//gi, "");
+  const newUrlWithoutHttp = newUrl?.replace(/http(s?):\/\//gi, "") ?? "";
+  const useNewLabel = finalNewLabel && finalNewLabel !== originalLabel && // LinkControl without the title field relies
+  // on the check below. Specifically, it assumes that
+  // the URL is the same as a title.
+  // This logic a) looks suspicious and b) should really
+  // live in the LinkControl and not here. It's a great
+  // candidate for future refactoring.
+  newLabelWithoutHttp !== newUrlWithoutHttp;
+  const label = useNewLabel ? (0, import_escape_html.escapeHTML)(finalNewLabel) : originalLabel || (0, import_escape_html.escapeHTML)(newUrlWithoutHttp);
+  const type = newType === "post_tag" ? "tag" : newType.replace("-", "_");
+  const isBuiltInType = ["post", "page", "tag", "category"].indexOf(type) > -1;
+  const isCustomLink = !newKind && !isBuiltInType || newKind === "custom";
+  const kind = isCustomLink ? "custom" : newKind;
+  const attributes = {
+    // Passed `url` may already be encoded. To prevent double encoding, decodeURI is executed to revert to the original string.
+    ...newUrl !== void 0 ? { url: newUrl ? encodeURI((0, import_url.safeDecodeURI)(newUrl)) : newUrl } : {},
+    ...label && { label },
+    ...void 0 !== opensInNewTab && { opensInNewTab },
+    ...kind && { kind },
+    ...type && type !== "URL" && { type }
+  };
+  if (newUrl && !newID && blockAttributes.id) {
+    const shouldSever = shouldSeverEntityLink(
+      blockAttributes.url,
+      newUrl
+    );
+    if (shouldSever) {
+      attributes.id = void 0;
+      attributes.kind = "custom";
+      attributes.type = "custom";
+    }
+  } else if (newID && Number.isInteger(newID)) {
+    attributes.id = newID;
+  } else if (blockAttributes.id) {
+    attributes.kind = kind;
+    attributes.type = type;
+  }
+  setAttributes(attributes);
+  const finalId = "id" in attributes ? attributes.id : blockAttributes.id;
+  const finalKind = "kind" in attributes ? attributes.kind : blockAttributes.kind;
+  return {
+    isEntityLink: !!finalId && finalKind !== "custom",
+    attributes
+    // Return the computed attributes object
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  updateAttributes
+});
+//# sourceMappingURL=update-attributes.cjs.map

package/build/navigation-link/shared/use-entity-binding.cjs

@@ -0,0 +1,125 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/block-library/src/navigation-link/shared/use-entity-binding.js
+var use_entity_binding_exports = {};
+__export(use_entity_binding_exports, {
+  buildNavigationLinkEntityBinding: () => buildNavigationLinkEntityBinding,
+  useEntityBinding: () => useEntityBinding
+});
+module.exports = __toCommonJS(use_entity_binding_exports);
+var import_element = require("@wordpress/element");
+var import_block_editor = require("@wordpress/block-editor");
+var import_data = require("@wordpress/data");
+var import_core_data = require("@wordpress/core-data");
+function buildNavigationLinkEntityBinding(kind) {
+  if (kind === void 0) {
+    throw new Error(
+      'buildNavigationLinkEntityBinding requires a kind parameter. Only "post-type" and "taxonomy" are supported.'
+    );
+  }
+  if (kind !== "post-type" && kind !== "taxonomy") {
+    throw new Error(
+      `Invalid kind "${kind}" provided to buildNavigationLinkEntityBinding. Only 'post-type' and 'taxonomy' are supported.`
+    );
+  }
+  const source = kind === "taxonomy" ? "core/term-data" : "core/post-data";
+  return {
+    url: {
+      source,
+      args: {
+        field: "link"
+      }
+    }
+  };
+}
+function useEntityBinding({ clientId, attributes }) {
+  const { updateBlockBindings } = (0, import_block_editor.useBlockBindingsUtils)(clientId);
+  const { metadata, id, kind, type } = attributes;
+  const blockEditingMode = (0, import_block_editor.useBlockEditingMode)();
+  const hasUrlBinding = !!metadata?.bindings?.url && !!id;
+  const expectedSource = kind === "post-type" ? "core/post-data" : "core/term-data";
+  const hasCorrectBinding = hasUrlBinding && metadata?.bindings?.url?.source === expectedSource;
+  const { isBoundEntityAvailable, entityRecord } = (0, import_data.useSelect)(
+    (select) => {
+      if (!hasCorrectBinding || !id) {
+        return { isBoundEntityAvailable: false, entityRecord: null };
+      }
+      const isPostType = kind === "post-type";
+      const isTaxonomy = kind === "taxonomy";
+      if (!isPostType && !isTaxonomy) {
+        return { isBoundEntityAvailable: false, entityRecord: null };
+      }
+      if (blockEditingMode === "disabled") {
+        return { isBoundEntityAvailable: true, entityRecord: null };
+      }
+      const { getEntityRecord, hasFinishedResolution } = select(import_core_data.store);
+      const entityType = isTaxonomy ? "taxonomy" : "postType";
+      const typeForAPI = type === "tag" ? "post_tag" : type;
+      const record = getEntityRecord(entityType, typeForAPI, id);
+      const hasResolved = hasFinishedResolution("getEntityRecord", [
+        entityType,
+        typeForAPI,
+        id
+      ]);
+      const isAvailable = hasResolved ? record !== void 0 : true;
+      return {
+        isBoundEntityAvailable: isAvailable,
+        entityRecord: record || null
+      };
+    },
+    [kind, type, id, hasCorrectBinding, blockEditingMode]
+  );
+  const clearBinding = (0, import_element.useCallback)(() => {
+    if (hasUrlBinding) {
+      updateBlockBindings({ url: void 0 });
+    }
+  }, [updateBlockBindings, hasUrlBinding]);
+  const createBinding = (0, import_element.useCallback)(
+    (updatedAttributes) => {
+      const kindToUse = updatedAttributes?.kind ?? kind;
+      if (!kindToUse) {
+        return;
+      }
+      try {
+        const binding = buildNavigationLinkEntityBinding(kindToUse);
+        updateBlockBindings(binding);
+      } catch (error) {
+        console.warn(
+          "Failed to create entity binding:",
+          error.message
+        );
+      }
+    },
+    [updateBlockBindings, kind]
+  );
+  return {
+    hasUrlBinding: hasCorrectBinding,
+    isBoundEntityAvailable,
+    entityRecord,
+    clearBinding,
+    createBinding
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildNavigationLinkEntityBinding,
+  useEntityBinding
+});
+//# sourceMappingURL=use-entity-binding.cjs.map

package/build/navigation-link/shared/use-entity-binding.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/navigation-link/shared/use-entity-binding.js"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useCallback } from '@wordpress/element';\nimport {\n\tuseBlockBindingsUtils,\n\tuseBlockEditingMode,\n} from '@wordpress/block-editor';\nimport { useSelect } from '@wordpress/data';\nimport { store as coreStore } from '@wordpress/core-data';\n\n/**\n * Builds entity binding configuration for navigation link URLs.\n * This function generates the structure used to bind navigation link URLs to their entity sources.\n *\n * Using a function instead of a constant allows for future enhancements where the binding\n * might need dynamic data (e.g., entity ID, context-specific arguments).\n *\n * @param {('post-type'|'taxonomy')} kind - The kind of entity. Only 'post-type' and 'taxonomy' are supported.\n * @return {Object} Entity binding configuration object\n * @throws {Error} If kind is not 'post-type' or 'taxonomy'\n */\nexport function buildNavigationLinkEntityBinding( kind ) {\n\t// Validate kind parameter exists.\n\tif ( kind === undefined ) {\n\t\tthrow new Error(\n\t\t\t'buildNavigationLinkEntityBinding requires a kind parameter. ' +\n\t\t\t\t'Only \"post-type\" and \"taxonomy\" are supported.'\n\t\t);\n\t}\n\n\t// Validate kind parameter value.\n\tif ( kind !== 'post-type' && kind !== 'taxonomy' ) {\n\t\tthrow new Error(\n\t\t\t`Invalid kind \"${ kind }\" provided to buildNavigationLinkEntityBinding. ` +\n\t\t\t\t`Only 'post-type' and 'taxonomy' are supported.`\n\t\t);\n\t}\n\n\tconst source = kind === 'taxonomy' ? 'core/term-data' : 'core/post-data';\n\n\treturn {\n\t\turl: {\n\t\t\tsource,\n\t\t\targs: {\n\t\t\t\tfield: 'link',\n\t\t\t},\n\t\t},\n\t};\n}\n\n/**\n * Shared hook for entity binding functionality in Navigation blocks.\n *\n * This hook provides common entity binding logic that can be used by both\n * Navigation Link and Navigation Submenu blocks to maintain feature parity.\n *\n * @param {Object} props            - Hook parameters\n * @param {string} props.clientId   - Block client ID\n * @param {Object} props.attributes - Block attributes\n * @return {Object} Hook return value\n */\nexport function useEntityBinding( { clientId, attributes } ) {\n\tconst { updateBlockBindings } = useBlockBindingsUtils( clientId );\n\tconst { metadata, id, kind, type } = attributes;\n\tconst blockEditingMode = useBlockEditingMode();\n\n\tconst hasUrlBinding = !! metadata?.bindings?.url && !! id;\n\tconst expectedSource =\n\t\tkind === 'post-type' ? 'core/post-data' : 'core/term-data';\n\tconst hasCorrectBinding =\n\t\thasUrlBinding && metadata?.bindings?.url?.source === expectedSource;\n\n\t// Check if the bound entity is available (not deleted) and return the entity record.\n\tconst { isBoundEntityAvailable, entityRecord } = useSelect(\n\t\t( select ) => {\n\t\t\t// First check: metadata/binding must exist\n\t\t\tif ( ! hasCorrectBinding || ! id ) {\n\t\t\t\treturn { isBoundEntityAvailable: false, entityRecord: null };\n\t\t\t}\n\n\t\t\tconst isPostType = kind === 'post-type';\n\t\t\tconst isTaxonomy = kind === 'taxonomy';\n\n\t\t\t// Only check entity availability for post types and taxonomies.\n\t\t\tif ( ! isPostType && ! isTaxonomy ) {\n\t\t\t\treturn { isBoundEntityAvailable: false, entityRecord: null };\n\t\t\t}\n\n\t\t\t// Skip check in disabled contexts to avoid unnecessary requests.\n\t\t\tif ( blockEditingMode === 'disabled' ) {\n\t\t\t\treturn { isBoundEntityAvailable: true, entityRecord: null };\n\t\t\t}\n\n\t\t\t// Second check: entity must exist\n\t\t\tconst { getEntityRecord, hasFinishedResolution } =\n\t\t\t\tselect( coreStore );\n\n\t\t\t// Use the correct entity type based on kind.\n\t\t\tconst entityType = isTaxonomy ? 'taxonomy' : 'postType';\n\t\t\t// Convert 'tag' back to 'post_tag' for the API call\n\t\t\t// (it was converted from 'post_tag' to 'tag' for storage in updateAttributes)\n\t\t\tconst typeForAPI = type === 'tag' ? 'post_tag' : type;\n\t\t\tconst record = getEntityRecord( entityType, typeForAPI, id );\n\t\t\tconst hasResolved = hasFinishedResolution( 'getEntityRecord', [\n\t\t\t\tentityType,\n\t\t\t\ttypeForAPI,\n\t\t\t\tid,\n\t\t\t] );\n\n\t\t\t// If resolution has finished and entityRecord is undefined, the entity was deleted.\n\t\t\t// Return true if entity exists, false if deleted.\n\t\t\tconst isAvailable = hasResolved ? record !== undefined : true;\n\t\t\treturn {\n\t\t\t\tisBoundEntityAvailable: isAvailable,\n\t\t\t\tentityRecord: record || null,\n\t\t\t};\n\t\t},\n\t\t[ kind, type, id, hasCorrectBinding, blockEditingMode ]\n\t);\n\n\tconst clearBinding = useCallback( () => {\n\t\tif ( hasUrlBinding ) {\n\t\t\tupdateBlockBindings( { url: undefined } );\n\t\t}\n\t}, [ updateBlockBindings, hasUrlBinding ] );\n\n\tconst createBinding = useCallback(\n\t\t( updatedAttributes ) => {\n\t\t\t// Use updated attributes if provided, otherwise fall back to closure attributes.\n\t\t\t// updatedAttributes needed to access the most up-to-date data when called synchronously.\n\t\t\tconst kindToUse = updatedAttributes?.kind ?? kind;\n\n\t\t\t// Avoid creating binding if no kind is provided.\n\t\t\tif ( ! kindToUse ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst binding = buildNavigationLinkEntityBinding( kindToUse );\n\t\t\t\tupdateBlockBindings( binding );\n\t\t\t} catch ( error ) {\n\t\t\t\t// eslint-disable-next-line no-console\n\t\t\t\tconsole.warn(\n\t\t\t\t\t'Failed to create entity binding:',\n\t\t\t\t\terror.message\n\t\t\t\t);\n\t\t\t\t// Don't create binding if validation fails.\n\t\t\t}\n\t\t},\n\t\t[ updateBlockBindings, kind ]\n\t);\n\n\treturn {\n\t\thasUrlBinding: hasCorrectBinding,\n\t\tisBoundEntityAvailable,\n\t\tentityRecord,\n\t\tclearBinding,\n\t\tcreateBinding,\n\t};\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAA4B;AAC5B,0BAGO;AACP,kBAA0B;AAC1B,uBAAmC;AAa5B,SAAS,iCAAkC,MAAO;AAExD,MAAK,SAAS,QAAY;AACzB,UAAM,IAAI;AAAA,MACT;AAAA,IAED;AAAA,EACD;AAGA,MAAK,SAAS,eAAe,SAAS,YAAa;AAClD,UAAM,IAAI;AAAA,MACT,iBAAkB,IAAK;AAAA,IAExB;AAAA,EACD;AAEA,QAAM,SAAS,SAAS,aAAa,mBAAmB;AAExD,SAAO;AAAA,IACN,KAAK;AAAA,MACJ;AAAA,MACA,MAAM;AAAA,QACL,OAAO;AAAA,MACR;AAAA,IACD;AAAA,EACD;AACD;AAaO,SAAS,iBAAkB,EAAE,UAAU,WAAW,GAAI;AAC5D,QAAM,EAAE,oBAAoB,QAAI,2CAAuB,QAAS;AAChE,QAAM,EAAE,UAAU,IAAI,MAAM,KAAK,IAAI;AACrC,QAAM,uBAAmB,yCAAoB;AAE7C,QAAM,gBAAgB,CAAC,CAAE,UAAU,UAAU,OAAO,CAAC,CAAE;AACvD,QAAM,iBACL,SAAS,cAAc,mBAAmB;AAC3C,QAAM,oBACL,iBAAiB,UAAU,UAAU,KAAK,WAAW;AAGtD,QAAM,EAAE,wBAAwB,aAAa,QAAI;AAAA,IAChD,CAAE,WAAY;AAEb,UAAK,CAAE,qBAAqB,CAAE,IAAK;AAClC,eAAO,EAAE,wBAAwB,OAAO,cAAc,KAAK;AAAA,MAC5D;AAEA,YAAM,aAAa,SAAS;AAC5B,YAAM,aAAa,SAAS;AAG5B,UAAK,CAAE,cAAc,CAAE,YAAa;AACnC,eAAO,EAAE,wBAAwB,OAAO,cAAc,KAAK;AAAA,MAC5D;AAGA,UAAK,qBAAqB,YAAa;AACtC,eAAO,EAAE,wBAAwB,MAAM,cAAc,KAAK;AAAA,MAC3D;AAGA,YAAM,EAAE,iBAAiB,sBAAsB,IAC9C,OAAQ,iBAAAA,KAAU;AAGnB,YAAM,aAAa,aAAa,aAAa;AAG7C,YAAM,aAAa,SAAS,QAAQ,aAAa;AACjD,YAAM,SAAS,gBAAiB,YAAY,YAAY,EAAG;AAC3D,YAAM,cAAc,sBAAuB,mBAAmB;AAAA,QAC7D;AAAA,QACA;AAAA,QACA;AAAA,MACD,CAAE;AAIF,YAAM,cAAc,cAAc,WAAW,SAAY;AACzD,aAAO;AAAA,QACN,wBAAwB;AAAA,QACxB,cAAc,UAAU;AAAA,MACzB;AAAA,IACD;AAAA,IACA,CAAE,MAAM,MAAM,IAAI,mBAAmB,gBAAiB;AAAA,EACvD;AAEA,QAAM,mBAAe,4BAAa,MAAM;AACvC,QAAK,eAAgB;AACpB,0BAAqB,EAAE,KAAK,OAAU,CAAE;AAAA,IACzC;AAAA,EACD,GAAG,CAAE,qBAAqB,aAAc,CAAE;AAE1C,QAAM,oBAAgB;AAAA,IACrB,CAAE,sBAAuB;AAGxB,YAAM,YAAY,mBAAmB,QAAQ;AAG7C,UAAK,CAAE,WAAY;AAClB;AAAA,MACD;AAEA,UAAI;AACH,cAAM,UAAU,iCAAkC,SAAU;AAC5D,4BAAqB,OAAQ;AAAA,MAC9B,SAAU,OAAQ;AAEjB,gBAAQ;AAAA,UACP;AAAA,UACA,MAAM;AAAA,QACP;AAAA,MAED;AAAA,IACD;AAAA,IACA,CAAE,qBAAqB,IAAK;AAAA,EAC7B;AAEA,SAAO;AAAA,IACN,eAAe;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
+  "names": ["coreStore"]
+}

package/build/navigation-link/shared/use-handle-link-change.cjs

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/block-library/src/navigation-link/shared/use-handle-link-change.js
+var use_handle_link_change_exports = {};
+__export(use_handle_link_change_exports, {
+  useHandleLinkChange: () => useHandleLinkChange
+});
+module.exports = __toCommonJS(use_handle_link_change_exports);
+var import_element = require("@wordpress/element");
+var import_data = require("@wordpress/data");
+var import_block_editor = require("@wordpress/block-editor");
+var import_update_attributes = require("./update-attributes.cjs");
+var import_use_entity_binding = require("./use-entity-binding.cjs");
+function useHandleLinkChange({ clientId, attributes, setAttributes }) {
+  const { updateBlockAttributes } = (0, import_data.useDispatch)(import_block_editor.store);
+  const { hasUrlBinding, createBinding, clearBinding } = (0, import_use_entity_binding.useEntityBinding)({
+    clientId,
+    attributes
+  });
+  return (0, import_element.useCallback)(
+    (updatedLink) => {
+      if (!updatedLink) {
+        return;
+      }
+      const attrs = {
+        url: updatedLink.url,
+        kind: updatedLink.kind,
+        type: updatedLink.type,
+        id: updatedLink.id
+      };
+      if (!attributes.label || attributes.label === "") {
+        attrs.title = updatedLink.title;
+      }
+      const willBeCustomLink = !updatedLink.id && hasUrlBinding;
+      if (willBeCustomLink) {
+        clearBinding();
+        updateBlockAttributes(clientId, {
+          url: updatedLink.url,
+          kind: "custom",
+          type: "custom",
+          id: void 0
+        });
+      } else {
+        const { isEntityLink, attributes: updatedAttributes } = (0, import_update_attributes.updateAttributes)(attrs, setAttributes, attributes);
+        if (isEntityLink) {
+          createBinding(updatedAttributes);
+        } else {
+          clearBinding();
+        }
+      }
+    },
+    [
+      attributes,
+      clientId,
+      hasUrlBinding,
+      createBinding,
+      clearBinding,
+      setAttributes,
+      updateBlockAttributes
+    ]
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useHandleLinkChange
+});
+//# sourceMappingURL=use-handle-link-change.cjs.map

package/build/navigation-link/shared/use-handle-link-change.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/navigation-link/shared/use-handle-link-change.js"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useCallback } from '@wordpress/element';\nimport { useDispatch } from '@wordpress/data';\nimport { store as blockEditorStore } from '@wordpress/block-editor';\n\n/**\n * Internal dependencies\n */\nimport { updateAttributes } from './update-attributes';\nimport { useEntityBinding } from './use-entity-binding';\n\n/**\n * Custom hook that returns a callback for handling link selection/change.\n * Manages the transition between entity links and custom links,\n * including proper binding creation and cleanup.\n *\n * @param {Object}   options               - Configuration options\n * @param {string}   options.clientId      - Block client ID\n * @param {Object}   options.attributes    - Current block attributes\n * @param {Function} options.setAttributes - Standard setAttribute function\n * @return {Function} Callback function to handle link changes\n */\nexport function useHandleLinkChange( { clientId, attributes, setAttributes } ) {\n\tconst { updateBlockAttributes } = useDispatch( blockEditorStore );\n\tconst { hasUrlBinding, createBinding, clearBinding } = useEntityBinding( {\n\t\tclientId,\n\t\tattributes,\n\t} );\n\n\treturn useCallback(\n\t\t( updatedLink ) => {\n\t\t\tif ( ! updatedLink ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst attrs = {\n\t\t\t\turl: updatedLink.url,\n\t\t\t\tkind: updatedLink.kind,\n\t\t\t\ttype: updatedLink.type,\n\t\t\t\tid: updatedLink.id,\n\t\t\t};\n\n\t\t\t// Only include title when there's no existing label\n\t\t\t// This preserves user-customized labels when updating links\n\t\t\tif ( ! attributes.label || attributes.label === '' ) {\n\t\t\t\tattrs.title = updatedLink.title;\n\t\t\t}\n\n\t\t\t// Check if transitioning from entity to custom link\n\t\t\tconst willBeCustomLink = ! updatedLink.id && hasUrlBinding;\n\n\t\t\tif ( willBeCustomLink ) {\n\t\t\t\t// Clear the binding first\n\t\t\t\tclearBinding();\n\n\t\t\t\t// Use direct store dispatch to bypass setBoundAttributes wrapper\n\t\t\t\t// which prevents updates to bound attributes.\n\t\t\t\tupdateBlockAttributes( clientId, {\n\t\t\t\t\turl: updatedLink.url,\n\t\t\t\t\tkind: 'custom',\n\t\t\t\t\ttype: 'custom',\n\t\t\t\t\tid: undefined,\n\t\t\t\t} );\n\t\t\t} else {\n\t\t\t\t// Normal flow for entity links or unbound custom links\n\t\t\t\tconst { isEntityLink, attributes: updatedAttributes } =\n\t\t\t\t\tupdateAttributes( attrs, setAttributes, attributes );\n\n\t\t\t\t// Handle URL binding based on the final computed state\n\t\t\t\t// Only create bindings for entity links (posts, pages, taxonomies)\n\t\t\t\t// Never create bindings for custom links (manual URLs)\n\t\t\t\tif ( isEntityLink ) {\n\t\t\t\t\tcreateBinding( updatedAttributes );\n\t\t\t\t} else {\n\t\t\t\t\tclearBinding();\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t[\n\t\t\tattributes,\n\t\t\tclientId,\n\t\t\thasUrlBinding,\n\t\t\tcreateBinding,\n\t\t\tclearBinding,\n\t\t\tsetAttributes,\n\t\t\tupdateBlockAttributes,\n\t\t]\n\t);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAA4B;AAC5B,kBAA4B;AAC5B,0BAA0C;AAK1C,+BAAiC;AACjC,gCAAiC;AAa1B,SAAS,oBAAqB,EAAE,UAAU,YAAY,cAAc,GAAI;AAC9E,QAAM,EAAE,sBAAsB,QAAI,yBAAa,oBAAAA,KAAiB;AAChE,QAAM,EAAE,eAAe,eAAe,aAAa,QAAI,4CAAkB;AAAA,IACxE;AAAA,IACA;AAAA,EACD,CAAE;AAEF,aAAO;AAAA,IACN,CAAE,gBAAiB;AAClB,UAAK,CAAE,aAAc;AACpB;AAAA,MACD;AAEA,YAAM,QAAQ;AAAA,QACb,KAAK,YAAY;AAAA,QACjB,MAAM,YAAY;AAAA,QAClB,MAAM,YAAY;AAAA,QAClB,IAAI,YAAY;AAAA,MACjB;AAIA,UAAK,CAAE,WAAW,SAAS,WAAW,UAAU,IAAK;AACpD,cAAM,QAAQ,YAAY;AAAA,MAC3B;AAGA,YAAM,mBAAmB,CAAE,YAAY,MAAM;AAE7C,UAAK,kBAAmB;AAEvB,qBAAa;AAIb,8BAAuB,UAAU;AAAA,UAChC,KAAK,YAAY;AAAA,UACjB,MAAM;AAAA,UACN,MAAM;AAAA,UACN,IAAI;AAAA,QACL,CAAE;AAAA,MACH,OAAO;AAEN,cAAM,EAAE,cAAc,YAAY,kBAAkB,QACnD,2CAAkB,OAAO,eAAe,UAAW;AAKpD,YAAK,cAAe;AACnB,wBAAe,iBAAkB;AAAA,QAClC,OAAO;AACN,uBAAa;AAAA,QACd;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD;AACD;",
+  "names": ["blockEditorStore"]
+}

package/build/navigation-link/shared/use-link-preview.cjs

@@ -0,0 +1,127 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/block-library/src/navigation-link/shared/use-link-preview.js
+var use_link_preview_exports = {};
+__export(use_link_preview_exports, {
+  useLinkPreview: () => useLinkPreview
+});
+module.exports = __toCommonJS(use_link_preview_exports);
+var import_i18n = require("@wordpress/i18n");
+var import_url = require("@wordpress/url");
+var import_block_editor = require("@wordpress/block-editor");
+var import_lock_unlock = require("../../lock-unlock.cjs");
+var { useRemoteUrlData } = (0, import_lock_unlock.unlock)(import_block_editor.privateApis);
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function computeDisplayUrl(url) {
+  if (!url) {
+    return { displayUrl: "", isExternal: false };
+  }
+  let displayUrl = (0, import_url.safeDecodeURI)(url);
+  let isExternal = false;
+  try {
+    const linkUrl = new URL(url);
+    const siteUrl = window.location.origin;
+    if (linkUrl.origin === siteUrl) {
+      let path = linkUrl.pathname + linkUrl.search + linkUrl.hash;
+      if (path.endsWith("/") && path.length > 1) {
+        path = path.slice(0, -1);
+      }
+      displayUrl = path;
+    } else {
+      isExternal = true;
+    }
+  } catch (e) {
+    displayUrl = (0, import_url.safeDecodeURI)(url);
+  }
+  return { displayUrl, isExternal };
+}
+function computeBadges({
+  url,
+  type,
+  isExternal,
+  entityStatus,
+  hasBinding,
+  isEntityAvailable
+}) {
+  const badges = [];
+  if (url) {
+    if (isExternal) {
+      badges.push({
+        label: (0, import_i18n.__)("External link"),
+        intent: "default"
+      });
+    } else if (type) {
+      badges.push({ label: capitalize(type), intent: "default" });
+    }
+  }
+  if (!url) {
+    badges.push({ label: (0, import_i18n.__)("No link selected"), intent: "error" });
+  } else if (hasBinding && !isEntityAvailable) {
+    badges.push({ label: (0, import_i18n.__)("Deleted"), intent: "error" });
+  } else if (entityStatus) {
+    const statusMap = {
+      publish: { label: (0, import_i18n.__)("Published"), intent: "success" },
+      future: { label: (0, import_i18n.__)("Scheduled"), intent: "warning" },
+      draft: { label: (0, import_i18n.__)("Draft"), intent: "warning" },
+      pending: { label: (0, import_i18n.__)("Pending"), intent: "warning" },
+      private: { label: (0, import_i18n.__)("Private"), intent: "default" },
+      trash: { label: (0, import_i18n.__)("Trash"), intent: "error" }
+    };
+    const badge = statusMap[entityStatus];
+    if (badge) {
+      badges.push(badge);
+    }
+  }
+  return badges;
+}
+function useLinkPreview({
+  url,
+  title,
+  image,
+  type,
+  entityStatus,
+  hasBinding,
+  isEntityAvailable
+}) {
+  const { richData } = useRemoteUrlData(title ? null : url);
+  const { displayUrl, isExternal } = computeDisplayUrl(url);
+  const badges = computeBadges({
+    url,
+    type,
+    isExternal,
+    entityStatus,
+    hasBinding,
+    isEntityAvailable
+  });
+  const displayTitle = url ? title || richData?.title || (0, import_url.safeDecodeURI)(url) : (0, import_i18n.__)("Add link");
+  return {
+    title: displayTitle,
+    url: displayUrl,
+    image,
+    badges
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useLinkPreview
+});
+//# sourceMappingURL=use-link-preview.cjs.map

package/build/navigation-link/shared/use-link-preview.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/navigation-link/shared/use-link-preview.js"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { __ } from '@wordpress/i18n';\nimport { safeDecodeURI } from '@wordpress/url';\nimport { privateApis as blockEditorPrivateApis } from '@wordpress/block-editor';\n\n/**\n * Internal dependencies\n */\nimport { unlock } from '../../lock-unlock';\n\nconst { useRemoteUrlData } = unlock( blockEditorPrivateApis );\n\n/**\n * Capitalize the first letter of a string.\n *\n * @param {string} str - The string to capitalize\n * @return {string} Capitalized string\n */\nfunction capitalize( str ) {\n\treturn str.charAt( 0 ).toUpperCase() + str.slice( 1 );\n}\n\n/**\n * Compute display URL - strips site URL if internal, shows full URL if external.\n *\n * @param {string} url - The URL to process\n * @return {Object} Object with displayUrl and isExternal flag\n */\nfunction computeDisplayUrl( url ) {\n\tif ( ! url ) {\n\t\treturn { displayUrl: '', isExternal: false };\n\t}\n\n\tlet displayUrl = safeDecodeURI( url );\n\tlet isExternal = false;\n\n\ttry {\n\t\tconst linkUrl = new URL( url );\n\t\tconst siteUrl = window.location.origin;\n\t\tif ( linkUrl.origin === siteUrl ) {\n\t\t\t// Show only the pathname (and search/hash if present)\n\t\t\tlet path = linkUrl.pathname + linkUrl.search + linkUrl.hash;\n\t\t\t// Remove trailing slash\n\t\t\tif ( path.endsWith( '/' ) && path.length > 1 ) {\n\t\t\t\tpath = path.slice( 0, -1 );\n\t\t\t}\n\t\t\tdisplayUrl = path;\n\t\t} else {\n\t\t\tisExternal = true;\n\t\t}\n\t} catch ( e ) {\n\t\t// If URL parsing fails, use the original URL\n\t\tdisplayUrl = safeDecodeURI( url );\n\t}\n\n\treturn { displayUrl, isExternal };\n}\n\n/**\n * Compute badges for the link preview.\n *\n * @param {Object}  options                   - Options object\n * @param {string}  options.url               - Link URL\n * @param {string}  options.type              - Entity type (page, post, etc.)\n * @param {boolean} options.isExternal        - Whether link is external\n * @param {string}  options.entityStatus      - Entity status (publish, draft, etc.)\n * @param {boolean} options.hasBinding        - Whether link has entity binding\n * @param {boolean} options.isEntityAvailable - Whether bound entity exists\n * @return {Array} Array of badge objects with label and intent\n */\nfunction computeBadges( {\n\turl,\n\ttype,\n\tisExternal,\n\tentityStatus,\n\thasBinding,\n\tisEntityAvailable,\n} ) {\n\tconst badges = [];\n\n\t// Kind badge\n\tif ( url ) {\n\t\tif ( isExternal ) {\n\t\t\tbadges.push( {\n\t\t\t\tlabel: __( 'External link' ),\n\t\t\t\tintent: 'default',\n\t\t\t} );\n\t\t} else if ( type ) {\n\t\t\tbadges.push( { label: capitalize( type ), intent: 'default' } );\n\t\t}\n\t}\n\n\t// Status badge\n\tif ( ! url ) {\n\t\tbadges.push( { label: __( 'No link selected' ), intent: 'error' } );\n\t} else if ( hasBinding && ! isEntityAvailable ) {\n\t\tbadges.push( { label: __( 'Deleted' ), intent: 'error' } );\n\t} else if ( entityStatus ) {\n\t\tconst statusMap = {\n\t\t\tpublish: { label: __( 'Published' ), intent: 'success' },\n\t\t\tfuture: { label: __( 'Scheduled' ), intent: 'warning' },\n\t\t\tdraft: { label: __( 'Draft' ), intent: 'warning' },\n\t\t\tpending: { label: __( 'Pending' ), intent: 'warning' },\n\t\t\tprivate: { label: __( 'Private' ), intent: 'default' },\n\t\t\ttrash: { label: __( 'Trash' ), intent: 'error' },\n\t\t};\n\t\tconst badge = statusMap[ entityStatus ];\n\t\tif ( badge ) {\n\t\t\tbadges.push( badge );\n\t\t}\n\t}\n\n\treturn badges;\n}\n\n/**\n * Hook to compute link preview data for display.\n *\n * This hook takes raw link data and entity information and computes\n * presentation-ready preview data including formatted title, URL, and badges.\n *\n * @param {Object}  options                   - Options object\n * @param {string}  options.url               - Link URL\n * @param {string}  options.title             - Link title (from entity or rich data)\n * @param {string}  options.image             - Link image URL\n * @param {string}  options.type              - Entity type (page, post, etc.)\n * @param {string}  options.entityStatus      - Entity status (publish, draft, etc.)\n * @param {boolean} options.hasBinding        - Whether link has entity binding\n * @param {boolean} options.isEntityAvailable - Whether bound entity exists\n * @return {Object} Preview data object with title, url, image, and badges\n */\nexport function useLinkPreview( {\n\turl,\n\ttitle,\n\timage,\n\ttype,\n\tentityStatus,\n\thasBinding,\n\tisEntityAvailable,\n} ) {\n\t// Fetch rich URL data if we don't have a title. Internal links should have passed a title.\n\tconst { richData } = useRemoteUrlData( title ? null : url );\n\n\t// Compute display URL and external flag\n\tconst { displayUrl, isExternal } = computeDisplayUrl( url );\n\n\t// Compute badges\n\tconst badges = computeBadges( {\n\t\turl,\n\t\ttype,\n\t\tisExternal,\n\t\tentityStatus,\n\t\thasBinding,\n\t\tisEntityAvailable,\n\t} );\n\n\t// Get display title - use provided title, fallback to rich data, or URL\n\tconst displayTitle = url\n\t\t? title || richData?.title || safeDecodeURI( url )\n\t\t: __( 'Add link' );\n\n\treturn {\n\t\ttitle: displayTitle,\n\t\turl: displayUrl,\n\t\timage,\n\t\tbadges,\n\t};\n}\n"],
+  "mappings": "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",
+  "names": ["blockEditorPrivateApis"]
+}