@wordpress/annotations 3.43.1-next.v.202604091042.0 → 3.44.1-next.v.202604201441.0

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+## 3.44.0 (2026-04-15)
+
 ## 3.43.0 (2026-04-01)
 
 ## 3.42.0 (2026-03-18)

package/build/block/index.cjs

@@ -1,16 +1,17 @@
-// packages/annotations/src/block/index.js
+"use strict";
+
+// packages/annotations/src/block/index.ts
 var import_hooks = require("@wordpress/hooks");
 var import_data = require("@wordpress/data");
-var import_constants = require("../store/constants.cjs");
+var import_store = require("../store/index.cjs");
 var addAnnotationClassName = (OriginalComponent) => {
-  return (0, import_data.withSelect)((select, { clientId, className }) => {
-    const annotations = select(import_constants.STORE_NAME).__experimentalGetAnnotationsForBlock(
-      clientId
-    );
+  return (0, import_data.withSelect)((select, ownProps) => {
+    const { clientId, className } = ownProps;
+    const annotations = select(import_store.store).__experimentalGetAnnotationsForBlock(clientId);
     return {
       className: annotations.map((annotation) => {
         return "is-annotated-by-" + annotation.source;
-      }).concat(className).filter(Boolean).join(" ")
+      }).concat(className || "").filter(Boolean).join(" ")
     };
   })(OriginalComponent);
 };

package/build/block/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/block/index.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { addFilter } from '@wordpress/hooks';\nimport { withSelect } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport { STORE_NAME } from '../store/constants';\n/**\n * Adds annotation className to the block-list-block component.\n *\n * @param {Object} OriginalComponent The original BlockListBlock component.\n * @return {Object} The enhanced component.\n */\nconst addAnnotationClassName = ( OriginalComponent ) => {\n\treturn withSelect( ( select, { clientId, className } ) => {\n\t\tconst annotations =\n\t\t\tselect( STORE_NAME ).__experimentalGetAnnotationsForBlock(\n\t\t\t\tclientId\n\t\t\t);\n\n\t\treturn {\n\t\t\tclassName: annotations\n\t\t\t\t.map( ( annotation ) => {\n\t\t\t\t\treturn 'is-annotated-by-' + annotation.source;\n\t\t\t\t} )\n\t\t\t\t.concat( className )\n\t\t\t\t.filter( Boolean )\n\t\t\t\t.join( ' ' ),\n\t\t};\n\t} )( OriginalComponent );\n};\n\naddFilter(\n\t'editor.BlockListBlock',\n\t'core/annotations',\n\taddAnnotationClassName\n);\n"],
-  "mappings": ";AAGA,mBAA0B;AAC1B,kBAA2B;AAK3B,uBAA2B;AAO3B,IAAM,yBAAyB,CAAE,sBAAuB;AACvD,aAAO,wBAAY,CAAE,QAAQ,EAAE,UAAU,UAAU,MAAO;AACzD,UAAM,cACL,OAAQ,2BAAW,EAAE;AAAA,MACpB;AAAA,IACD;AAED,WAAO;AAAA,MACN,WAAW,YACT,IAAK,CAAE,eAAgB;AACvB,eAAO,qBAAqB,WAAW;AAAA,MACxC,CAAE,EACD,OAAQ,SAAU,EAClB,OAAQ,OAAQ,EAChB,KAAM,GAAI;AAAA,IACb;AAAA,EACD,CAAE,EAAG,iBAAkB;AACxB;AAAA,IAEA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACD;",
+  "sources": ["../../src/block/index.ts"],
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport type { ComponentType } from 'react';\n\n/**\n * WordPress dependencies\n */\nimport { addFilter } from '@wordpress/hooks';\nimport { withSelect } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport { store } from '../store';\nimport type { Annotation } from '../types';\n\ninterface BlockListBlockProps {\n\tclientId: string;\n\tclassName?: string;\n\t[ key: string ]: unknown;\n}\n\n/**\n * Adds annotation className to the block-list-block component.\n *\n * @param OriginalComponent The original BlockListBlock component.\n * @return The enhanced component.\n */\nconst addAnnotationClassName = ( OriginalComponent: ComponentType< any > ) => {\n\treturn withSelect( ( select, ownProps ) => {\n\t\tconst { clientId, className } = ownProps as BlockListBlockProps;\n\t\tconst annotations: Annotation[] =\n\t\t\tselect( store ).__experimentalGetAnnotationsForBlock( clientId );\n\n\t\treturn {\n\t\t\tclassName: annotations\n\t\t\t\t.map( ( annotation ) => {\n\t\t\t\t\treturn 'is-annotated-by-' + annotation.source;\n\t\t\t\t} )\n\t\t\t\t.concat( className || '' )\n\t\t\t\t.filter( Boolean )\n\t\t\t\t.join( ' ' ),\n\t\t};\n\t} )( OriginalComponent );\n};\n\naddFilter(\n\t'editor.BlockListBlock',\n\t'core/annotations',\n\taddAnnotationClassName\n);\n"],
+  "mappings": ";;;AAQA,mBAA0B;AAC1B,kBAA2B;AAK3B,mBAAsB;AAetB,IAAM,yBAAyB,CAAE,sBAA6C;AAC7E,aAAO,wBAAY,CAAE,QAAQ,aAAc;AAC1C,UAAM,EAAE,UAAU,UAAU,IAAI;AAChC,UAAM,cACL,OAAQ,kBAAM,EAAE,qCAAsC,QAAS;AAEhE,WAAO;AAAA,MACN,WAAW,YACT,IAAK,CAAE,eAAgB;AACvB,eAAO,qBAAqB,WAAW;AAAA,MACxC,CAAE,EACD,OAAQ,aAAa,EAAG,EACxB,OAAQ,OAAQ,EAChB,KAAM,GAAI;AAAA,IACb;AAAA,EACD,CAAE,EAAG,iBAAkB;AACxB;AAAA,IAEA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACD;",
   "names": []
 }

package/build/format/annotation.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/format/annotation.js
+// packages/annotations/src/format/annotation.ts
 var annotation_exports = {};
 __export(annotation_exports, {
   annotation: () => annotation,
@@ -32,6 +33,9 @@ var ANNOTATION_ATTRIBUTE_PREFIX = "annotation-text-";
 function applyAnnotations(record, annotations = []) {
   annotations.forEach((annotation2) => {
     let { start, end } = annotation2;
+    if (typeof start !== "number" || typeof end !== "number") {
+      return;
+    }
     if (start > record.text.length) {
       start = record.text.length;
     }
@@ -78,7 +82,10 @@ function retrieveAnnotationPositions(formats) {
   });
   return positions;
 }
-function updateAnnotationsWithPositions(annotations, positions, { removeAnnotation, updateAnnotationRange }) {
+function updateAnnotationsWithPositions(annotations, positions, {
+  removeAnnotation,
+  updateAnnotationRange
+}) {
   annotations.forEach((currentAnnotation) => {
     const position = positions[currentAnnotation.id];
     if (!position) {
@@ -86,11 +93,11 @@ function updateAnnotationsWithPositions(annotations, positions, { removeAnnotati
       return;
     }
     const { start, end } = currentAnnotation;
-    if (start !== position.start || end !== position.end) {
+    if (typeof start === "number" && typeof end === "number" && (start !== position.start || end !== (position.end ?? position.start))) {
       updateAnnotationRange(
         currentAnnotation.id,
         position.start,
-        position.end
+        position.end ?? position.start
       );
     }
   });
@@ -104,10 +111,12 @@ var annotation = {
     className: "class",
     id: "id"
   },
-  edit() {
+  interactive: false,
+  object: false,
+  edit: () => {
     return null;
   },
-  __experimentalGetPropsForEditableTreePreparation(select, { richTextIdentifier, blockClientId }) {
+  __experimentalGetPropsForEditableTreePreparation: (select, { richTextIdentifier, blockClientId }) => {
     return {
       annotations: select(
         import_constants.STORE_NAME
@@ -117,23 +126,29 @@ var annotation = {
       )
     };
   },
-  __experimentalCreatePrepareEditableTree({ annotations }) {
+  __experimentalCreatePrepareEditableTree: ({ annotations }) => {
     return (formats, text) => {
       if (annotations.length === 0) {
         return formats;
       }
-      let record = { formats, text };
+      let record = {
+        formats,
+        text,
+        replacements: [],
+        start: 0,
+        end: 0
+      };
       record = applyAnnotations(record, annotations);
       return record.formats;
     };
   },
-  __experimentalGetPropsForEditableTreeChangeHandler(dispatch) {
+  __experimentalGetPropsForEditableTreeChangeHandler: (dispatch) => {
     return {
       removeAnnotation: dispatch(import_constants.STORE_NAME).__experimentalRemoveAnnotation,
       updateAnnotationRange: dispatch(import_constants.STORE_NAME).__experimentalUpdateAnnotationRange
     };
   },
-  __experimentalCreateOnChangeEditableValue(props) {
+  __experimentalCreateOnChangeEditableValue: (props) => {
     return (formats) => {
       const positions = retrieveAnnotationPositions(formats);
       const { removeAnnotation, updateAnnotationRange, annotations } = props;

package/build/format/annotation.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/format/annotation.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { __ } from '@wordpress/i18n';\nimport { applyFormat, removeFormat } from '@wordpress/rich-text';\n\nconst FORMAT_NAME = 'core/annotation';\n\nconst ANNOTATION_ATTRIBUTE_PREFIX = 'annotation-text-';\n/**\n * Internal dependencies\n */\nimport { STORE_NAME } from '../store/constants';\n\n/**\n * Applies given annotations to the given record.\n *\n * @param {Object} record      The record to apply annotations to.\n * @param {Array}  annotations The annotation to apply.\n * @return {Object} A record with the annotations applied.\n */\nexport function applyAnnotations( record, annotations = [] ) {\n\tannotations.forEach( ( annotation ) => {\n\t\tlet { start, end } = annotation;\n\n\t\tif ( start > record.text.length ) {\n\t\t\tstart = record.text.length;\n\t\t}\n\n\t\tif ( end > record.text.length ) {\n\t\t\tend = record.text.length;\n\t\t}\n\n\t\tconst className = ANNOTATION_ATTRIBUTE_PREFIX + annotation.source;\n\t\tconst id = ANNOTATION_ATTRIBUTE_PREFIX + annotation.id;\n\n\t\trecord = applyFormat(\n\t\t\trecord,\n\t\t\t{\n\t\t\t\ttype: FORMAT_NAME,\n\t\t\t\tattributes: {\n\t\t\t\t\tclassName,\n\t\t\t\t\tid,\n\t\t\t\t},\n\t\t\t},\n\t\t\tstart,\n\t\t\tend\n\t\t);\n\t} );\n\n\treturn record;\n}\n\n/**\n * Removes annotations from the given record.\n *\n * @param {Object} record Record to remove annotations from.\n * @return {Object} The cleaned record.\n */\nexport function removeAnnotations( record ) {\n\treturn removeFormat( record, 'core/annotation', 0, record.text.length );\n}\n\n/**\n * Retrieves the positions of annotations inside an array of formats.\n *\n * @param {Array} formats Formats with annotations in there.\n * @return {Object} ID keyed positions of annotations.\n */\nfunction retrieveAnnotationPositions( formats ) {\n\tconst positions = {};\n\n\tformats.forEach( ( characterFormats, i ) => {\n\t\tcharacterFormats = characterFormats || [];\n\t\tcharacterFormats = characterFormats.filter(\n\t\t\t( format ) => format.type === FORMAT_NAME\n\t\t);\n\t\tcharacterFormats.forEach( ( format ) => {\n\t\t\tlet { id } = format.attributes;\n\t\t\tid = id.replace( ANNOTATION_ATTRIBUTE_PREFIX, '' );\n\n\t\t\tif ( ! positions.hasOwnProperty( id ) ) {\n\t\t\t\tpositions[ id ] = {\n\t\t\t\t\tstart: i,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Annotations refer to positions between characters.\n\t\t\t// Formats refer to the character themselves.\n\t\t\t// So we need to adjust for that here.\n\t\t\tpositions[ id ].end = i + 1;\n\t\t} );\n\t} );\n\n\treturn positions;\n}\n\n/**\n * Updates annotations in the state based on positions retrieved from RichText.\n *\n * @param {Array}    annotations                   The annotations that are currently applied.\n * @param {Array}    positions                     The current positions of the given annotations.\n * @param {Object}   actions\n * @param {Function} actions.removeAnnotation      Function to remove an annotation from the state.\n * @param {Function} actions.updateAnnotationRange Function to update an annotation range in the state.\n */\nfunction updateAnnotationsWithPositions(\n\tannotations,\n\tpositions,\n\t{ removeAnnotation, updateAnnotationRange }\n) {\n\tannotations.forEach( ( currentAnnotation ) => {\n\t\tconst position = positions[ currentAnnotation.id ];\n\t\t// If we cannot find an annotation, delete it.\n\t\tif ( ! position ) {\n\t\t\t// Apparently the annotation has been removed, so remove it from the state:\n\t\t\t// Remove...\n\t\t\tremoveAnnotation( currentAnnotation.id );\n\t\t\treturn;\n\t\t}\n\n\t\tconst { start, end } = currentAnnotation;\n\t\tif ( start !== position.start || end !== position.end ) {\n\t\t\tupdateAnnotationRange(\n\t\t\t\tcurrentAnnotation.id,\n\t\t\t\tposition.start,\n\t\t\t\tposition.end\n\t\t\t);\n\t\t}\n\t} );\n}\n\nexport const annotation = {\n\tname: FORMAT_NAME,\n\ttitle: __( 'Annotation' ),\n\ttagName: 'mark',\n\tclassName: 'annotation-text',\n\tattributes: {\n\t\tclassName: 'class',\n\t\tid: 'id',\n\t},\n\tedit() {\n\t\treturn null;\n\t},\n\t__experimentalGetPropsForEditableTreePreparation(\n\t\tselect,\n\t\t{ richTextIdentifier, blockClientId }\n\t) {\n\t\treturn {\n\t\t\tannotations: select(\n\t\t\t\tSTORE_NAME\n\t\t\t).__experimentalGetAnnotationsForRichText(\n\t\t\t\tblockClientId,\n\t\t\t\trichTextIdentifier\n\t\t\t),\n\t\t};\n\t},\n\t__experimentalCreatePrepareEditableTree( { annotations } ) {\n\t\treturn ( formats, text ) => {\n\t\t\tif ( annotations.length === 0 ) {\n\t\t\t\treturn formats;\n\t\t\t}\n\n\t\t\tlet record = { formats, text };\n\t\t\trecord = applyAnnotations( record, annotations );\n\t\t\treturn record.formats;\n\t\t};\n\t},\n\t__experimentalGetPropsForEditableTreeChangeHandler( dispatch ) {\n\t\treturn {\n\t\t\tremoveAnnotation:\n\t\t\t\tdispatch( STORE_NAME ).__experimentalRemoveAnnotation,\n\t\t\tupdateAnnotationRange:\n\t\t\t\tdispatch( STORE_NAME ).__experimentalUpdateAnnotationRange,\n\t\t};\n\t},\n\t__experimentalCreateOnChangeEditableValue( props ) {\n\t\treturn ( formats ) => {\n\t\t\tconst positions = retrieveAnnotationPositions( formats );\n\t\t\tconst { removeAnnotation, updateAnnotationRange, annotations } =\n\t\t\t\tprops;\n\n\t\t\tupdateAnnotationsWithPositions( annotations, positions, {\n\t\t\t\tremoveAnnotation,\n\t\t\t\tupdateAnnotationRange,\n\t\t\t} );\n\t\t};\n\t},\n};\n"],
-  "mappings": "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",
+  "sources": ["../../src/format/annotation.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { __ } from '@wordpress/i18n';\nimport { applyFormat, removeFormat } from '@wordpress/rich-text';\nimport type { RichTextValue } from '@wordpress/rich-text';\n\n/**\n * Internal dependencies\n */\nimport { STORE_NAME } from '../store/constants';\nimport type { Annotation, AnnotationFormat } from '../types';\n\nconst FORMAT_NAME = 'core/annotation';\n\nconst ANNOTATION_ATTRIBUTE_PREFIX = 'annotation-text-';\n\n/**\n * Applies given annotations to the given record.\n *\n * @param record      The record to apply annotations to.\n * @param annotations The annotation to apply.\n * @return A record with the annotations applied.\n */\nexport function applyAnnotations(\n\trecord: RichTextValue,\n\tannotations: Annotation[] = []\n): RichTextValue {\n\tannotations.forEach( ( annotation ) => {\n\t\tlet { start, end } = annotation;\n\n\t\tif ( typeof start !== 'number' || typeof end !== 'number' ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( start > record.text.length ) {\n\t\t\tstart = record.text.length;\n\t\t}\n\n\t\tif ( end > record.text.length ) {\n\t\t\tend = record.text.length;\n\t\t}\n\n\t\tconst className = ANNOTATION_ATTRIBUTE_PREFIX + annotation.source;\n\t\tconst id = ANNOTATION_ATTRIBUTE_PREFIX + annotation.id;\n\n\t\trecord = applyFormat(\n\t\t\trecord,\n\t\t\t{\n\t\t\t\ttype: FORMAT_NAME,\n\t\t\t\tattributes: {\n\t\t\t\t\tclassName,\n\t\t\t\t\tid,\n\t\t\t\t},\n\t\t\t} as any,\n\t\t\tstart,\n\t\t\tend\n\t\t);\n\t} );\n\n\treturn record;\n}\n\n/**\n * Removes annotations from the given record.\n *\n * @param record Record to remove annotations from.\n * @return The cleaned record.\n */\nexport function removeAnnotations( record: RichTextValue ): RichTextValue {\n\treturn removeFormat( record, 'core/annotation', 0, record.text.length );\n}\n\n/**\n * Retrieves the positions of annotations inside an array of formats.\n *\n * @param formats Formats with annotations in there.\n * @return ID keyed positions of annotations.\n */\nfunction retrieveAnnotationPositions(\n\tformats: any[][]\n): Record< string, { start: number; end?: number } > {\n\tconst positions: Record< string, { start: number; end?: number } > = {};\n\n\tformats.forEach( ( characterFormats, i ) => {\n\t\tcharacterFormats = characterFormats || [];\n\t\tcharacterFormats = characterFormats.filter(\n\t\t\t( format ) => format.type === FORMAT_NAME\n\t\t);\n\t\tcharacterFormats.forEach( ( format ) => {\n\t\t\tlet { id } = format.attributes;\n\t\t\tid = id.replace( ANNOTATION_ATTRIBUTE_PREFIX, '' );\n\n\t\t\tif ( ! positions.hasOwnProperty( id ) ) {\n\t\t\t\tpositions[ id ] = {\n\t\t\t\t\tstart: i,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Annotations refer to positions between characters.\n\t\t\t// Formats refer to the character themselves.\n\t\t\t// So we need to adjust for that here.\n\t\t\tpositions[ id ].end = i + 1;\n\t\t} );\n\t} );\n\n\treturn positions;\n}\n\n/**\n * Updates annotations in the state based on positions retrieved from RichText.\n *\n * @param annotations                   The annotations that are currently applied.\n * @param positions                     The current positions of the given annotations.\n * @param actions\n * @param actions.removeAnnotation      Function to remove an annotation from the state.\n * @param actions.updateAnnotationRange Function to update an annotation range in the state.\n */\nfunction updateAnnotationsWithPositions(\n\tannotations: Annotation[],\n\tpositions: Record< string, { start: number; end?: number } >,\n\t{\n\t\tremoveAnnotation,\n\t\tupdateAnnotationRange,\n\t}: {\n\t\tremoveAnnotation: ( annotationId: string ) => void;\n\t\tupdateAnnotationRange: (\n\t\t\tannotationId: string,\n\t\t\tstart: number,\n\t\t\tend: number\n\t\t) => void;\n\t}\n): void {\n\tannotations.forEach( ( currentAnnotation ) => {\n\t\tconst position = positions[ currentAnnotation.id ];\n\t\t// If we cannot find an annotation, delete it.\n\t\tif ( ! position ) {\n\t\t\t// Apparently the annotation has been removed, so remove it from the state:\n\t\t\t// Remove...\n\t\t\tremoveAnnotation( currentAnnotation.id );\n\t\t\treturn;\n\t\t}\n\n\t\tconst { start, end } = currentAnnotation;\n\t\tif (\n\t\t\ttypeof start === 'number' &&\n\t\t\ttypeof end === 'number' &&\n\t\t\t( start !== position.start ||\n\t\t\t\tend !== ( position.end ?? position.start ) )\n\t\t) {\n\t\t\tupdateAnnotationRange(\n\t\t\t\tcurrentAnnotation.id,\n\t\t\t\tposition.start,\n\t\t\t\tposition.end ?? position.start\n\t\t\t);\n\t\t}\n\t} );\n}\n\nexport const annotation: AnnotationFormat = {\n\tname: FORMAT_NAME,\n\ttitle: __( 'Annotation' ),\n\ttagName: 'mark',\n\tclassName: 'annotation-text',\n\tattributes: {\n\t\tclassName: 'class',\n\t\tid: 'id',\n\t},\n\tinteractive: false,\n\tobject: false,\n\tedit: () => {\n\t\treturn null;\n\t},\n\t__experimentalGetPropsForEditableTreePreparation: (\n\t\tselect,\n\t\t{ richTextIdentifier, blockClientId }\n\t) => {\n\t\treturn {\n\t\t\tannotations: select(\n\t\t\t\tSTORE_NAME\n\t\t\t).__experimentalGetAnnotationsForRichText(\n\t\t\t\tblockClientId,\n\t\t\t\trichTextIdentifier\n\t\t\t),\n\t\t};\n\t},\n\t__experimentalCreatePrepareEditableTree: ( { annotations } ) => {\n\t\treturn ( formats, text ) => {\n\t\t\tif ( annotations.length === 0 ) {\n\t\t\t\treturn formats;\n\t\t\t}\n\n\t\t\tlet record: RichTextValue = {\n\t\t\t\tformats,\n\t\t\t\ttext,\n\t\t\t\treplacements: [],\n\t\t\t\tstart: 0,\n\t\t\t\tend: 0,\n\t\t\t};\n\t\t\trecord = applyAnnotations( record, annotations );\n\t\t\treturn record.formats;\n\t\t};\n\t},\n\t__experimentalGetPropsForEditableTreeChangeHandler: ( dispatch ) => {\n\t\treturn {\n\t\t\tremoveAnnotation:\n\t\t\t\tdispatch( STORE_NAME ).__experimentalRemoveAnnotation,\n\t\t\tupdateAnnotationRange:\n\t\t\t\tdispatch( STORE_NAME ).__experimentalUpdateAnnotationRange,\n\t\t};\n\t},\n\t__experimentalCreateOnChangeEditableValue: ( props ) => {\n\t\treturn ( formats ) => {\n\t\t\tconst positions = retrieveAnnotationPositions( formats );\n\t\t\tconst { removeAnnotation, updateAnnotationRange, annotations } =\n\t\t\t\tprops;\n\n\t\t\tupdateAnnotationsWithPositions( annotations, positions, {\n\t\t\t\tremoveAnnotation,\n\t\t\t\tupdateAnnotationRange,\n\t\t\t} );\n\t\t};\n\t},\n};\n"],
+  "mappings": "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",
   "names": ["annotation"]
 }

package/build/format/index.cjs

@@ -1,4 +1,6 @@
-// packages/annotations/src/format/index.js
+"use strict";
+
+// packages/annotations/src/format/index.ts
 var import_rich_text = require("@wordpress/rich-text");
 var import_annotation = require("./annotation.cjs");
 var { name, ...settings } = import_annotation.annotation;

package/build/format/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/format/index.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { registerFormatType } from '@wordpress/rich-text';\n\n/**\n * Internal dependencies\n */\nimport { annotation } from './annotation';\n\nconst { name, ...settings } = annotation;\n\nregisterFormatType( name, settings );\n"],
-  "mappings": ";AAGA,uBAAmC;AAKnC,wBAA2B;AAE3B,IAAM,EAAE,MAAM,GAAG,SAAS,IAAI;AAAA,IAE9B,qCAAoB,MAAM,QAAS;",
+  "sources": ["../../src/format/index.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { registerFormatType } from '@wordpress/rich-text';\n\n/**\n * Internal dependencies\n */\nimport { annotation } from './annotation';\n\nconst { name, ...settings } = annotation;\n\nregisterFormatType( name, settings as any );\n"],
+  "mappings": ";;;AAGA,uBAAmC;AAKnC,wBAA2B;AAE3B,IAAM,EAAE,MAAM,GAAG,SAAS,IAAI;AAAA,IAE9B,qCAAoB,MAAM,QAAgB;",
   "names": []
 }

package/build/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/index.js
+// packages/annotations/src/index.ts
 var index_exports = {};
 __export(index_exports, {
   store: () => import_store.store

package/build/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/index.js"],
+  "sources": ["../src/index.ts"],
   "sourcesContent": ["/**\n * Internal dependencies\n */\nimport './format';\nimport './block';\n\nexport { store } from './store';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAO;AACP,mBAAO;AAEP,mBAAsB;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAO;AACP,mBAAO;AAEP,mBAAsB;",
   "names": []
 }

package/build/store/actions.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/store/actions.js
+// packages/annotations/src/store/actions.ts
 var actions_exports = {};
 __export(actions_exports, {
   __experimentalAddAnnotation: () => __experimentalAddAnnotation,
@@ -42,7 +43,7 @@ function __experimentalAddAnnotation({
     source,
     selector
   };
-  if (selector === "range") {
+  if (selector === "range" && range !== null) {
     action.range = range;
   }
   return action;

package/build/store/actions.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/actions.js"],
-  "sourcesContent": ["/**\n * External dependencies\n */\nimport { v4 as uuid } from 'uuid';\n\n/**\n * @typedef WPAnnotationRange\n *\n * @property {number} start The offset where the annotation should start.\n * @property {number} end   The offset where the annotation should end.\n */\n\n/**\n * Adds an annotation to a block.\n *\n * The `block` attribute refers to a block ID that needs to be annotated.\n * `isBlockAnnotation` controls whether or not the annotation is a block\n * annotation. The `source` is the source of the annotation, this will be used\n * to identity groups of annotations.\n *\n * The `range` property is only relevant if the selector is 'range'.\n *\n * @param {Object}            annotation                    The annotation to add.\n * @param {string}            annotation.blockClientId      The blockClientId to add the annotation to.\n * @param {string}            annotation.richTextIdentifier Identifier for the RichText instance the annotation applies to.\n * @param {WPAnnotationRange} annotation.range              The range at which to apply this annotation.\n * @param {string}            [annotation.selector=\"range\"] The way to apply this annotation.\n * @param {string}            [annotation.source=\"default\"] The source that added the annotation.\n * @param {string}            [annotation.id]               The ID the annotation should have. Generates a UUID by default.\n *\n * @return {Object} Action object.\n */\nexport function __experimentalAddAnnotation( {\n\tblockClientId,\n\trichTextIdentifier = null,\n\trange = null,\n\tselector = 'range',\n\tsource = 'default',\n\tid = uuid(),\n} ) {\n\tconst action = {\n\t\ttype: 'ANNOTATION_ADD',\n\t\tid,\n\t\tblockClientId,\n\t\trichTextIdentifier,\n\t\tsource,\n\t\tselector,\n\t};\n\n\tif ( selector === 'range' ) {\n\t\taction.range = range;\n\t}\n\n\treturn action;\n}\n\n/**\n * Removes an annotation with a specific ID.\n *\n * @param {string} annotationId The annotation to remove.\n *\n * @return {Object} Action object.\n */\nexport function __experimentalRemoveAnnotation( annotationId ) {\n\treturn {\n\t\ttype: 'ANNOTATION_REMOVE',\n\t\tannotationId,\n\t};\n}\n\n/**\n * Updates the range of an annotation.\n *\n * @param {string} annotationId ID of the annotation to update.\n * @param {number} start        The start of the new range.\n * @param {number} end          The end of the new range.\n *\n * @return {Object} Action object.\n */\nexport function __experimentalUpdateAnnotationRange(\n\tannotationId,\n\tstart,\n\tend\n) {\n\treturn {\n\t\ttype: 'ANNOTATION_UPDATE_RANGE',\n\t\tannotationId,\n\t\tstart,\n\t\tend,\n\t};\n}\n\n/**\n * Removes all annotations of a specific source.\n *\n * @param {string} source The source to remove.\n *\n * @return {Object} Action object.\n */\nexport function __experimentalRemoveAnnotationsBySource( source ) {\n\treturn {\n\t\ttype: 'ANNOTATION_REMOVE_SOURCE',\n\t\tsource,\n\t};\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA2B;AA6BpB,SAAS,4BAA6B;AAAA,EAC5C;AAAA,EACA,qBAAqB;AAAA,EACrB,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAK,YAAAA,IAAK;AACX,GAAI;AACH,QAAM,SAAS;AAAA,IACd,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AAEA,MAAK,aAAa,SAAU;AAC3B,WAAO,QAAQ;AAAA,EAChB;AAEA,SAAO;AACR;AASO,SAAS,+BAAgC,cAAe;AAC9D,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;AAWO,SAAS,oCACf,cACA,OACA,KACC;AACD,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;AASO,SAAS,wCAAyC,QAAS;AACjE,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;",
+  "sources": ["../../src/store/actions.ts"],
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport { v4 as uuid } from 'uuid';\n\n/**\n * Internal dependencies\n */\nimport type { AddAnnotationParameters, AnnotationAction } from '../types';\n\n/**\n * Adds an annotation to a block.\n *\n * The `block` attribute refers to a block ID that needs to be annotated.\n * `isBlockAnnotation` controls whether or not the annotation is a block\n * annotation. The `source` is the source of the annotation, this will be used\n * to identify groups of annotations.\n *\n * The `range` property is only relevant if the selector is 'range'.\n *\n * @param annotation                    The annotation to add.\n * @param annotation.blockClientId      The blockClientId to add the annotation to.\n * @param annotation.richTextIdentifier Identifier for the RichText instance the annotation applies to.\n * @param annotation.range              The range at which to apply this annotation.\n * @param annotation.selector           The way to apply this annotation.\n * @param annotation.source             The source that added the annotation.\n * @param annotation.id                 The ID the annotation should have. Generates a UUID by default.\n * @return Action object.\n */\nexport function __experimentalAddAnnotation( {\n\tblockClientId,\n\trichTextIdentifier = null,\n\trange = null,\n\tselector = 'range',\n\tsource = 'default',\n\tid = uuid(),\n}: AddAnnotationParameters ): AnnotationAction {\n\tconst action: AnnotationAction = {\n\t\ttype: 'ANNOTATION_ADD',\n\t\tid,\n\t\tblockClientId,\n\t\trichTextIdentifier,\n\t\tsource,\n\t\tselector,\n\t};\n\n\tif ( selector === 'range' && range !== null ) {\n\t\t(\n\t\t\taction as Extract< AnnotationAction, { type: 'ANNOTATION_ADD' } >\n\t\t ).range = range;\n\t}\n\n\treturn action;\n}\n\n/**\n * Removes an annotation with a specific ID.\n *\n * @param annotationId The annotation to remove.\n * @return Action object.\n */\nexport function __experimentalRemoveAnnotation(\n\tannotationId: string\n): AnnotationAction {\n\treturn {\n\t\ttype: 'ANNOTATION_REMOVE',\n\t\tannotationId,\n\t};\n}\n\n/**\n * Updates the range of an annotation.\n *\n * @param annotationId ID of the annotation to update.\n * @param start        The start of the new range.\n * @param end          The end of the new range.\n * @return Action object.\n */\nexport function __experimentalUpdateAnnotationRange(\n\tannotationId: string,\n\tstart: number,\n\tend: number\n): AnnotationAction {\n\treturn {\n\t\ttype: 'ANNOTATION_UPDATE_RANGE',\n\t\tannotationId,\n\t\tstart,\n\t\tend,\n\t};\n}\n\n/**\n * Removes all annotations of a specific source.\n *\n * @param source The source to remove.\n * @return Action object.\n */\nexport function __experimentalRemoveAnnotationsBySource(\n\tsource: string\n): AnnotationAction {\n\treturn {\n\t\ttype: 'ANNOTATION_REMOVE_SOURCE',\n\t\tsource,\n\t};\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA2B;AA0BpB,SAAS,4BAA6B;AAAA,EAC5C;AAAA,EACA,qBAAqB;AAAA,EACrB,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAK,YAAAA,IAAK;AACX,GAA+C;AAC9C,QAAM,SAA2B;AAAA,IAChC,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AAEA,MAAK,aAAa,WAAW,UAAU,MAAO;AAC7C,IACC,OACE,QAAQ;AAAA,EACZ;AAEA,SAAO;AACR;AAQO,SAAS,+BACf,cACmB;AACnB,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;AAUO,SAAS,oCACf,cACA,OACA,KACmB;AACnB,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;AAQO,SAAS,wCACf,QACmB;AACnB,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;",
   "names": ["uuid"]
 }

package/build/store/constants.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/store/constants.js
+// packages/annotations/src/store/constants.ts
 var constants_exports = {};
 __export(constants_exports, {
   STORE_NAME: () => STORE_NAME

package/build/store/constants.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/constants.js"],
-  "sourcesContent": ["/**\n * The identifier for the data store.\n *\n * @type {string}\n */\nexport const STORE_NAME = 'core/annotations';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,IAAM,aAAa;",
+  "sources": ["../../src/store/constants.ts"],
+  "sourcesContent": ["/**\n * The identifier for the data store.\n */\nexport const STORE_NAME = 'core/annotations';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,IAAM,aAAa;",
   "names": []
 }

package/build/store/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -26,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/store/index.js
+// packages/annotations/src/store/index.ts
 var store_exports = {};
 __export(store_exports, {
   store: () => store

package/build/store/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/index.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { register, createReduxStore } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport reducer from './reducer';\nimport * as selectors from './selectors';\nimport * as actions from './actions';\n\n/**\n * Module Constants\n */\nimport { STORE_NAME } from './constants';\n\n/**\n * Store definition for the annotations namespace.\n *\n * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#createReduxStore\n *\n * @type {Object}\n */\nexport const store = createReduxStore( STORE_NAME, {\n\treducer,\n\tselectors,\n\tactions,\n} );\n\nregister( store );\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA2C;AAK3C,qBAAoB;AACpB,gBAA2B;AAC3B,cAAyB;AAKzB,uBAA2B;AASpB,IAAM,YAAQ,8BAAkB,6BAAY;AAAA,EAClD,wBAAAA;AAAA,EACA;AAAA,EACA;AACD,CAAE;AAAA,IAEF,sBAAU,KAAM;",
+  "sources": ["../../src/store/index.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { register, createReduxStore } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport reducer from './reducer';\nimport * as selectors from './selectors';\nimport * as actions from './actions';\n\n/**\n * Module Constants\n */\nimport { STORE_NAME } from './constants';\n\n/**\n * Store definition for the annotations namespace.\n *\n * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#createReduxStore\n */\nexport const store = createReduxStore( STORE_NAME, {\n\treducer,\n\tselectors,\n\tactions,\n} );\n\nregister( store );\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA2C;AAK3C,qBAAoB;AACpB,gBAA2B;AAC3B,cAAyB;AAKzB,uBAA2B;AAOpB,IAAM,YAAQ,8BAAkB,6BAAY;AAAA,EAClD,wBAAAA;AAAA,EACA;AAAA,EACA;AACD,CAAE;AAAA,IAEF,sBAAU,KAAM;",
   "names": ["reducer"]
 }

package/build/store/reducer.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/store/reducer.js
+// packages/annotations/src/store/reducer.ts
 var reducer_exports = {};
 __export(reducer_exports, {
   annotations: () => annotations,
@@ -27,15 +28,19 @@ function filterWithReference(collection, predicate) {
   const filteredCollection = collection.filter(predicate);
   return collection.length === filteredCollection.length ? collection : filteredCollection;
 }
-var mapValues = (obj, callback) => Object.entries(obj).reduce(
-  (acc, [key, value]) => ({
+var mapValues = (obj, callback) => Object.entries(obj).reduce((acc, [key, value]) => {
+  if (value === void 0) {
+    return acc;
+  }
+  return {
     ...acc,
     [key]: callback(value)
-  }),
-  {}
-);
+  };
+}, {});
 function isValidAnnotationRange(annotation) {
-  return typeof annotation.start === "number" && typeof annotation.end === "number" && annotation.start <= annotation.end;
+  return Boolean(
+    annotation.range && typeof annotation.range.start === "number" && typeof annotation.range.end === "number" && annotation.range.start <= annotation.range.end
+  );
 }
 function annotations(state = {}, action) {
   switch (action.type) {
@@ -49,7 +54,7 @@ function annotations(state = {}, action) {
         selector: action.selector,
         range: action.range
       };
-      if (newAnnotation.selector === "range" && !isValidAnnotationRange(newAnnotation.range)) {
+      if (newAnnotation.selector === "range" && !isValidAnnotationRange(newAnnotation)) {
         return state;
       }
       const previousAnnotationsForBlock = state?.[blockClientId] ?? [];

package/build/store/reducer.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/reducer.js"],
-  "sourcesContent": ["/**\n * Filters an array based on the predicate, but keeps the reference the same if\n * the array hasn't changed.\n *\n * @param {Array}    collection The collection to filter.\n * @param {Function} predicate  Function that determines if the item should stay\n *                              in the array.\n * @return {Array} Filtered array.\n */\nfunction filterWithReference( collection, predicate ) {\n\tconst filteredCollection = collection.filter( predicate );\n\n\treturn collection.length === filteredCollection.length\n\t\t? collection\n\t\t: filteredCollection;\n}\n\n/**\n * Creates a new object with the same keys, but with `callback()` called as\n * a transformer function on each of the values.\n *\n * @param {Object}   obj      The object to transform.\n * @param {Function} callback The function to transform each object value.\n * @return {Array} Transformed object.\n */\nconst mapValues = ( obj, callback ) =>\n\tObject.entries( obj ).reduce(\n\t\t( acc, [ key, value ] ) => ( {\n\t\t\t...acc,\n\t\t\t[ key ]: callback( value ),\n\t\t} ),\n\t\t{}\n\t);\n\n/**\n * Verifies whether the given annotations is a valid annotation.\n *\n * @param {Object} annotation The annotation to verify.\n * @return {boolean} Whether the given annotation is valid.\n */\nfunction isValidAnnotationRange( annotation ) {\n\treturn (\n\t\ttypeof annotation.start === 'number' &&\n\t\ttypeof annotation.end === 'number' &&\n\t\tannotation.start <= annotation.end\n\t);\n}\n\n/**\n * Reducer managing annotations.\n *\n * @param {Object} state  The annotations currently shown in the editor.\n * @param {Object} action Dispatched action.\n *\n * @return {Array} Updated state.\n */\nexport function annotations( state = {}, action ) {\n\tswitch ( action.type ) {\n\t\tcase 'ANNOTATION_ADD':\n\t\t\tconst blockClientId = action.blockClientId;\n\t\t\tconst newAnnotation = {\n\t\t\t\tid: action.id,\n\t\t\t\tblockClientId,\n\t\t\t\trichTextIdentifier: action.richTextIdentifier,\n\t\t\t\tsource: action.source,\n\t\t\t\tselector: action.selector,\n\t\t\t\trange: action.range,\n\t\t\t};\n\n\t\t\tif (\n\t\t\t\tnewAnnotation.selector === 'range' &&\n\t\t\t\t! isValidAnnotationRange( newAnnotation.range )\n\t\t\t) {\n\t\t\t\treturn state;\n\t\t\t}\n\n\t\t\tconst previousAnnotationsForBlock = state?.[ blockClientId ] ?? [];\n\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\t[ blockClientId ]: [\n\t\t\t\t\t...previousAnnotationsForBlock,\n\t\t\t\t\tnewAnnotation,\n\t\t\t\t],\n\t\t\t};\n\n\t\tcase 'ANNOTATION_REMOVE':\n\t\t\treturn mapValues( state, ( annotationsForBlock ) => {\n\t\t\t\treturn filterWithReference(\n\t\t\t\t\tannotationsForBlock,\n\t\t\t\t\t( annotation ) => {\n\t\t\t\t\t\treturn annotation.id !== action.annotationId;\n\t\t\t\t\t}\n\t\t\t\t);\n\t\t\t} );\n\n\t\tcase 'ANNOTATION_UPDATE_RANGE':\n\t\t\treturn mapValues( state, ( annotationsForBlock ) => {\n\t\t\t\tlet hasChangedRange = false;\n\n\t\t\t\tconst newAnnotations = annotationsForBlock.map(\n\t\t\t\t\t( annotation ) => {\n\t\t\t\t\t\tif ( annotation.id === action.annotationId ) {\n\t\t\t\t\t\t\thasChangedRange = true;\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t...annotation,\n\t\t\t\t\t\t\t\trange: {\n\t\t\t\t\t\t\t\t\tstart: action.start,\n\t\t\t\t\t\t\t\t\tend: action.end,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\treturn annotation;\n\t\t\t\t\t}\n\t\t\t\t);\n\n\t\t\t\treturn hasChangedRange ? newAnnotations : annotationsForBlock;\n\t\t\t} );\n\n\t\tcase 'ANNOTATION_REMOVE_SOURCE':\n\t\t\treturn mapValues( state, ( annotationsForBlock ) => {\n\t\t\t\treturn filterWithReference(\n\t\t\t\t\tannotationsForBlock,\n\t\t\t\t\t( annotation ) => {\n\t\t\t\t\t\treturn annotation.source !== action.source;\n\t\t\t\t\t}\n\t\t\t\t);\n\t\t\t} );\n\t}\n\n\treturn state;\n}\n\nexport default annotations;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,SAAS,oBAAqB,YAAY,WAAY;AACrD,QAAM,qBAAqB,WAAW,OAAQ,SAAU;AAExD,SAAO,WAAW,WAAW,mBAAmB,SAC7C,aACA;AACJ;AAUA,IAAM,YAAY,CAAE,KAAK,aACxB,OAAO,QAAS,GAAI,EAAE;AAAA,EACrB,CAAE,KAAK,CAAE,KAAK,KAAM,OAAS;AAAA,IAC5B,GAAG;AAAA,IACH,CAAE,GAAI,GAAG,SAAU,KAAM;AAAA,EAC1B;AAAA,EACA,CAAC;AACF;AAQD,SAAS,uBAAwB,YAAa;AAC7C,SACC,OAAO,WAAW,UAAU,YAC5B,OAAO,WAAW,QAAQ,YAC1B,WAAW,SAAS,WAAW;AAEjC;AAUO,SAAS,YAAa,QAAQ,CAAC,GAAG,QAAS;AACjD,UAAS,OAAO,MAAO;AAAA,IACtB,KAAK;AACJ,YAAM,gBAAgB,OAAO;AAC7B,YAAM,gBAAgB;AAAA,QACrB,IAAI,OAAO;AAAA,QACX;AAAA,QACA,oBAAoB,OAAO;AAAA,QAC3B,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,QACjB,OAAO,OAAO;AAAA,MACf;AAEA,UACC,cAAc,aAAa,WAC3B,CAAE,uBAAwB,cAAc,KAAM,GAC7C;AACD,eAAO;AAAA,MACR;AAEA,YAAM,8BAA8B,QAAS,aAAc,KAAK,CAAC;AAEjE,aAAO;AAAA,QACN,GAAG;AAAA,QACH,CAAE,aAAc,GAAG;AAAA,UAClB,GAAG;AAAA,UACH;AAAA,QACD;AAAA,MACD;AAAA,IAED,KAAK;AACJ,aAAO,UAAW,OAAO,CAAE,wBAAyB;AACnD,eAAO;AAAA,UACN;AAAA,UACA,CAAE,eAAgB;AACjB,mBAAO,WAAW,OAAO,OAAO;AAAA,UACjC;AAAA,QACD;AAAA,MACD,CAAE;AAAA,IAEH,KAAK;AACJ,aAAO,UAAW,OAAO,CAAE,wBAAyB;AACnD,YAAI,kBAAkB;AAEtB,cAAM,iBAAiB,oBAAoB;AAAA,UAC1C,CAAE,eAAgB;AACjB,gBAAK,WAAW,OAAO,OAAO,cAAe;AAC5C,gCAAkB;AAClB,qBAAO;AAAA,gBACN,GAAG;AAAA,gBACH,OAAO;AAAA,kBACN,OAAO,OAAO;AAAA,kBACd,KAAK,OAAO;AAAA,gBACb;AAAA,cACD;AAAA,YACD;AAEA,mBAAO;AAAA,UACR;AAAA,QACD;AAEA,eAAO,kBAAkB,iBAAiB;AAAA,MAC3C,CAAE;AAAA,IAEH,KAAK;AACJ,aAAO,UAAW,OAAO,CAAE,wBAAyB;AACnD,eAAO;AAAA,UACN;AAAA,UACA,CAAE,eAAgB;AACjB,mBAAO,WAAW,WAAW,OAAO;AAAA,UACrC;AAAA,QACD;AAAA,MACD,CAAE;AAAA,EACJ;AAEA,SAAO;AACR;AAEA,IAAO,kBAAQ;",
+  "sources": ["../../src/store/reducer.ts"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport type {\n\tAnnotationAction,\n\tAnnotationsState,\n\tAnnotation,\n\tAnnotationRange,\n} from '../types';\n\n/**\n * Filters an array based on the predicate, but keeps the reference the same if\n * the array hasn't changed.\n *\n * @param collection The collection to filter.\n * @param predicate  Function that determines if the item should stay\n *                   in the array.\n * @return Filtered array.\n */\nfunction filterWithReference< T >(\n\tcollection: T[],\n\tpredicate: ( item: T ) => boolean\n): T[] {\n\tconst filteredCollection = collection.filter( predicate );\n\n\treturn collection.length === filteredCollection.length\n\t\t? collection\n\t\t: filteredCollection;\n}\n\n/**\n * Creates a new object with the same keys, but with `callback()` called as\n * a transformer function on each of the values.\n *\n * @param obj      The object to transform.\n * @param callback The function to transform each object value.\n * @return Transformed object.\n */\nconst mapValues = < T, U >(\n\tobj: Partial< Record< string, T > >,\n\tcallback: ( value: T ) => U\n): Partial< Record< string, U > > =>\n\tObject.entries( obj ).reduce( ( acc, [ key, value ] ) => {\n\t\tif ( value === undefined ) {\n\t\t\treturn acc;\n\t\t}\n\t\treturn {\n\t\t\t...acc,\n\t\t\t[ key ]: callback( value ),\n\t\t};\n\t}, {} );\n\n/**\n * Verifies whether the given annotations is a valid annotation.\n *\n * @param annotation       The annotation to verify.\n * @param annotation.range The range property of the annotation.\n * @return Whether the given annotation is valid.\n */\nfunction isValidAnnotationRange( annotation: {\n\trange?: AnnotationRange | null;\n} ): boolean {\n\treturn Boolean(\n\t\tannotation.range &&\n\t\t\ttypeof annotation.range.start === 'number' &&\n\t\t\ttypeof annotation.range.end === 'number' &&\n\t\t\tannotation.range.start <= annotation.range.end\n\t);\n}\n\n/**\n * Reducer managing annotations.\n *\n * @param state  The annotations currently shown in the editor.\n * @param action Dispatched action.\n * @return Updated state.\n */\nexport function annotations(\n\tstate: AnnotationsState = {},\n\taction: AnnotationAction\n): AnnotationsState {\n\tswitch ( action.type ) {\n\t\tcase 'ANNOTATION_ADD':\n\t\t\tconst blockClientId = action.blockClientId;\n\t\t\tconst newAnnotation: Annotation = {\n\t\t\t\tid: action.id,\n\t\t\t\tblockClientId,\n\t\t\t\trichTextIdentifier: action.richTextIdentifier,\n\t\t\t\tsource: action.source,\n\t\t\t\tselector: action.selector,\n\t\t\t\trange: action.range,\n\t\t\t};\n\n\t\t\tif (\n\t\t\t\tnewAnnotation.selector === 'range' &&\n\t\t\t\t! isValidAnnotationRange( newAnnotation )\n\t\t\t) {\n\t\t\t\treturn state;\n\t\t\t}\n\n\t\t\tconst previousAnnotationsForBlock = state?.[ blockClientId ] ?? [];\n\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\t[ blockClientId ]: [\n\t\t\t\t\t...previousAnnotationsForBlock,\n\t\t\t\t\tnewAnnotation,\n\t\t\t\t],\n\t\t\t};\n\n\t\tcase 'ANNOTATION_REMOVE':\n\t\t\treturn mapValues( state, ( annotationsForBlock: Annotation[] ) => {\n\t\t\t\treturn filterWithReference(\n\t\t\t\t\tannotationsForBlock,\n\t\t\t\t\t( annotation: Annotation ) => {\n\t\t\t\t\t\treturn annotation.id !== action.annotationId;\n\t\t\t\t\t}\n\t\t\t\t);\n\t\t\t} );\n\n\t\tcase 'ANNOTATION_UPDATE_RANGE':\n\t\t\treturn mapValues( state, ( annotationsForBlock: Annotation[] ) => {\n\t\t\t\tlet hasChangedRange = false;\n\n\t\t\t\tconst newAnnotations = annotationsForBlock.map(\n\t\t\t\t\t( annotation: Annotation ) => {\n\t\t\t\t\t\tif ( annotation.id === action.annotationId ) {\n\t\t\t\t\t\t\thasChangedRange = true;\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t...annotation,\n\t\t\t\t\t\t\t\trange: {\n\t\t\t\t\t\t\t\t\tstart: action.start,\n\t\t\t\t\t\t\t\t\tend: action.end,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\treturn annotation;\n\t\t\t\t\t}\n\t\t\t\t);\n\n\t\t\t\treturn hasChangedRange ? newAnnotations : annotationsForBlock;\n\t\t\t} );\n\n\t\tcase 'ANNOTATION_REMOVE_SOURCE':\n\t\t\treturn mapValues( state, ( annotationsForBlock: Annotation[] ) => {\n\t\t\t\treturn filterWithReference(\n\t\t\t\t\tannotationsForBlock,\n\t\t\t\t\t( annotation: Annotation ) => {\n\t\t\t\t\t\treturn annotation.source !== action.source;\n\t\t\t\t\t}\n\t\t\t\t);\n\t\t\t} );\n\t}\n\n\treturn state;\n}\n\nexport default annotations;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,SAAS,oBACR,YACA,WACM;AACN,QAAM,qBAAqB,WAAW,OAAQ,SAAU;AAExD,SAAO,WAAW,WAAW,mBAAmB,SAC7C,aACA;AACJ;AAUA,IAAM,YAAY,CACjB,KACA,aAEA,OAAO,QAAS,GAAI,EAAE,OAAQ,CAAE,KAAK,CAAE,KAAK,KAAM,MAAO;AACxD,MAAK,UAAU,QAAY;AAC1B,WAAO;AAAA,EACR;AACA,SAAO;AAAA,IACN,GAAG;AAAA,IACH,CAAE,GAAI,GAAG,SAAU,KAAM;AAAA,EAC1B;AACD,GAAG,CAAC,CAAE;AASP,SAAS,uBAAwB,YAEpB;AACZ,SAAO;AAAA,IACN,WAAW,SACV,OAAO,WAAW,MAAM,UAAU,YAClC,OAAO,WAAW,MAAM,QAAQ,YAChC,WAAW,MAAM,SAAS,WAAW,MAAM;AAAA,EAC7C;AACD;AASO,SAAS,YACf,QAA0B,CAAC,GAC3B,QACmB;AACnB,UAAS,OAAO,MAAO;AAAA,IACtB,KAAK;AACJ,YAAM,gBAAgB,OAAO;AAC7B,YAAM,gBAA4B;AAAA,QACjC,IAAI,OAAO;AAAA,QACX;AAAA,QACA,oBAAoB,OAAO;AAAA,QAC3B,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,QACjB,OAAO,OAAO;AAAA,MACf;AAEA,UACC,cAAc,aAAa,WAC3B,CAAE,uBAAwB,aAAc,GACvC;AACD,eAAO;AAAA,MACR;AAEA,YAAM,8BAA8B,QAAS,aAAc,KAAK,CAAC;AAEjE,aAAO;AAAA,QACN,GAAG;AAAA,QACH,CAAE,aAAc,GAAG;AAAA,UAClB,GAAG;AAAA,UACH;AAAA,QACD;AAAA,MACD;AAAA,IAED,KAAK;AACJ,aAAO,UAAW,OAAO,CAAE,wBAAuC;AACjE,eAAO;AAAA,UACN;AAAA,UACA,CAAE,eAA4B;AAC7B,mBAAO,WAAW,OAAO,OAAO;AAAA,UACjC;AAAA,QACD;AAAA,MACD,CAAE;AAAA,IAEH,KAAK;AACJ,aAAO,UAAW,OAAO,CAAE,wBAAuC;AACjE,YAAI,kBAAkB;AAEtB,cAAM,iBAAiB,oBAAoB;AAAA,UAC1C,CAAE,eAA4B;AAC7B,gBAAK,WAAW,OAAO,OAAO,cAAe;AAC5C,gCAAkB;AAClB,qBAAO;AAAA,gBACN,GAAG;AAAA,gBACH,OAAO;AAAA,kBACN,OAAO,OAAO;AAAA,kBACd,KAAK,OAAO;AAAA,gBACb;AAAA,cACD;AAAA,YACD;AAEA,mBAAO;AAAA,UACR;AAAA,QACD;AAEA,eAAO,kBAAkB,iBAAiB;AAAA,MAC3C,CAAE;AAAA,IAEH,KAAK;AACJ,aAAO,UAAW,OAAO,CAAE,wBAAuC;AACjE,eAAO;AAAA,UACN;AAAA,UACA,CAAE,eAA4B;AAC7B,mBAAO,WAAW,WAAW,OAAO;AAAA,UACrC;AAAA,QACD;AAAA,MACD,CAAE;AAAA,EACJ;AAEA,SAAO;AACR;AAEA,IAAO,kBAAQ;",
   "names": []
 }

package/build/store/selectors.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/annotations/src/store/selectors.js
+// packages/annotations/src/store/selectors.ts
 var selectors_exports = {};
 __export(selectors_exports, {
   __experimentalGetAllAnnotationsForBlock: () => __experimentalGetAllAnnotationsForBlock,
@@ -33,7 +34,9 @@ var __experimentalGetAnnotationsForBlock = (0, import_data.createSelector)(
       return annotation.selector === "block";
     });
   },
-  (state, blockClientId) => [state?.[blockClientId] ?? EMPTY_ARRAY]
+  (state, blockClientId) => [
+    state?.[blockClientId] ?? EMPTY_ARRAY
+  ]
 );
 function __experimentalGetAllAnnotationsForBlock(state, blockClientId) {
   return state?.[blockClientId] ?? EMPTY_ARRAY;
@@ -50,10 +53,12 @@ var __experimentalGetAnnotationsForRichText = (0, import_data.createSelector)(
       };
     });
   },
-  (state, blockClientId) => [state?.[blockClientId] ?? EMPTY_ARRAY]
+  (state, blockClientId) => [
+    state?.[blockClientId] ?? EMPTY_ARRAY
+  ]
 );
 function __experimentalGetAnnotations(state) {
-  return Object.values(state).flat();
+  return Object.values(state).filter((arr) => Boolean(arr)).flat();
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/build/store/selectors.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/selectors.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createSelector } from '@wordpress/data';\n\n/**\n * Shared reference to an empty array for cases where it is important to avoid\n * returning a new array reference on every invocation, as in a connected or\n * other pure component which performs `shouldComponentUpdate` check on props.\n * This should be used as a last resort, since the normalized data should be\n * maintained by the reducer result in state.\n *\n * @type {Array}\n */\nconst EMPTY_ARRAY = [];\n\n/**\n * Returns the annotations for a specific client ID.\n *\n * @param {Object} state    Editor state.\n * @param {string} clientId The ID of the block to get the annotations for.\n *\n * @return {Array} The annotations applicable to this block.\n */\nexport const __experimentalGetAnnotationsForBlock = createSelector(\n\t( state, blockClientId ) => {\n\t\treturn ( state?.[ blockClientId ] ?? [] ).filter( ( annotation ) => {\n\t\t\treturn annotation.selector === 'block';\n\t\t} );\n\t},\n\t( state, blockClientId ) => [ state?.[ blockClientId ] ?? EMPTY_ARRAY ]\n);\n\nexport function __experimentalGetAllAnnotationsForBlock(\n\tstate,\n\tblockClientId\n) {\n\treturn state?.[ blockClientId ] ?? EMPTY_ARRAY;\n}\n\n/**\n * Returns the annotations that apply to the given RichText instance.\n *\n * Both a blockClientId and a richTextIdentifier are required. This is because\n * a block might have multiple `RichText` components. This does mean that every\n * block needs to implement annotations itself.\n *\n * @param {Object} state              Editor state.\n * @param {string} blockClientId      The client ID for the block.\n * @param {string} richTextIdentifier Unique identifier that identifies the given RichText.\n * @return {Array} All the annotations relevant for the `RichText`.\n */\nexport const __experimentalGetAnnotationsForRichText = createSelector(\n\t( state, blockClientId, richTextIdentifier ) => {\n\t\treturn ( state?.[ blockClientId ] ?? [] )\n\t\t\t.filter( ( annotation ) => {\n\t\t\t\treturn (\n\t\t\t\t\tannotation.selector === 'range' &&\n\t\t\t\t\trichTextIdentifier === annotation.richTextIdentifier\n\t\t\t\t);\n\t\t\t} )\n\t\t\t.map( ( annotation ) => {\n\t\t\t\tconst { range, ...other } = annotation;\n\n\t\t\t\treturn {\n\t\t\t\t\t...range,\n\t\t\t\t\t...other,\n\t\t\t\t};\n\t\t\t} );\n\t},\n\t( state, blockClientId ) => [ state?.[ blockClientId ] ?? EMPTY_ARRAY ]\n);\n\n/**\n * Returns all annotations in the editor state.\n *\n * @param {Object} state Editor state.\n * @return {Array} All annotations currently applied.\n */\nexport function __experimentalGetAnnotations( state ) {\n\treturn Object.values( state ).flat();\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA+B;AAW/B,IAAM,cAAc,CAAC;AAUd,IAAM,2CAAuC;AAAA,EACnD,CAAE,OAAO,kBAAmB;AAC3B,YAAS,QAAS,aAAc,KAAK,CAAC,GAAI,OAAQ,CAAE,eAAgB;AACnE,aAAO,WAAW,aAAa;AAAA,IAChC,CAAE;AAAA,EACH;AAAA,EACA,CAAE,OAAO,kBAAmB,CAAE,QAAS,aAAc,KAAK,WAAY;AACvE;AAEO,SAAS,wCACf,OACA,eACC;AACD,SAAO,QAAS,aAAc,KAAK;AACpC;AAcO,IAAM,8CAA0C;AAAA,EACtD,CAAE,OAAO,eAAe,uBAAwB;AAC/C,YAAS,QAAS,aAAc,KAAK,CAAC,GACpC,OAAQ,CAAE,eAAgB;AAC1B,aACC,WAAW,aAAa,WACxB,uBAAuB,WAAW;AAAA,IAEpC,CAAE,EACD,IAAK,CAAE,eAAgB;AACvB,YAAM,EAAE,OAAO,GAAG,MAAM,IAAI;AAE5B,aAAO;AAAA,QACN,GAAG;AAAA,QACH,GAAG;AAAA,MACJ;AAAA,IACD,CAAE;AAAA,EACJ;AAAA,EACA,CAAE,OAAO,kBAAmB,CAAE,QAAS,aAAc,KAAK,WAAY;AACvE;AAQO,SAAS,6BAA8B,OAAQ;AACrD,SAAO,OAAO,OAAQ,KAAM,EAAE,KAAK;AACpC;",
+  "sources": ["../../src/store/selectors.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createSelector } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport type { AnnotationsState, Annotation } from '../types';\n\n/**\n * Shared reference to an empty array for cases where it is important to avoid\n * returning a new array reference on every invocation, as in a connected or\n * other pure component which performs `shouldComponentUpdate` check on props.\n * This should be used as a last resort, since the normalized data should be\n * maintained by the reducer result in state.\n */\nconst EMPTY_ARRAY: Annotation[] = [];\n\n/**\n * Returns the annotations for a specific client ID.\n *\n * @param state         Editor state.\n * @param blockClientId The ID of the block to get the annotations for.\n * @return The annotations applicable to this block.\n */\nexport const __experimentalGetAnnotationsForBlock = createSelector(\n\t( state: AnnotationsState, blockClientId: string ): Annotation[] => {\n\t\treturn ( state?.[ blockClientId ] ?? [] ).filter( ( annotation ) => {\n\t\t\treturn annotation.selector === 'block';\n\t\t} );\n\t},\n\t( state: AnnotationsState, blockClientId: string ) => [\n\t\tstate?.[ blockClientId ] ?? EMPTY_ARRAY,\n\t]\n);\n\nexport function __experimentalGetAllAnnotationsForBlock(\n\tstate: AnnotationsState,\n\tblockClientId: string\n): Annotation[] {\n\treturn state?.[ blockClientId ] ?? EMPTY_ARRAY;\n}\n\n/**\n * Returns the annotations that apply to the given RichText instance.\n *\n * Both a blockClientId and a richTextIdentifier are required. This is because\n * a block might have multiple `RichText` components. This does mean that every\n * block needs to implement annotations itself.\n *\n * @param state              Editor state.\n * @param blockClientId      The client ID for the block.\n * @param richTextIdentifier Unique identifier that identifies the given RichText.\n * @return All the annotations relevant for the `RichText`.\n */\nexport const __experimentalGetAnnotationsForRichText = createSelector(\n\t(\n\t\tstate: AnnotationsState,\n\t\tblockClientId: string,\n\t\trichTextIdentifier: string\n\t): Annotation[] => {\n\t\treturn ( state?.[ blockClientId ] ?? [] )\n\t\t\t.filter( ( annotation ) => {\n\t\t\t\treturn (\n\t\t\t\t\tannotation.selector === 'range' &&\n\t\t\t\t\trichTextIdentifier === annotation.richTextIdentifier\n\t\t\t\t);\n\t\t\t} )\n\t\t\t.map( ( annotation ) => {\n\t\t\t\tconst { range, ...other } = annotation;\n\n\t\t\t\treturn {\n\t\t\t\t\t...range,\n\t\t\t\t\t...other,\n\t\t\t\t};\n\t\t\t} );\n\t},\n\t( state: AnnotationsState, blockClientId: string ) => [\n\t\tstate?.[ blockClientId ] ?? EMPTY_ARRAY,\n\t]\n);\n\n/**\n * Returns all annotations in the editor state.\n *\n * @param state Editor state.\n * @return All annotations currently applied.\n */\nexport function __experimentalGetAnnotations(\n\tstate: AnnotationsState\n): Annotation[] {\n\treturn Object.values( state )\n\t\t.filter( ( arr ): arr is Annotation[] => Boolean( arr ) )\n\t\t.flat();\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA+B;AAc/B,IAAM,cAA4B,CAAC;AAS5B,IAAM,2CAAuC;AAAA,EACnD,CAAE,OAAyB,kBAAyC;AACnE,YAAS,QAAS,aAAc,KAAK,CAAC,GAAI,OAAQ,CAAE,eAAgB;AACnE,aAAO,WAAW,aAAa;AAAA,IAChC,CAAE;AAAA,EACH;AAAA,EACA,CAAE,OAAyB,kBAA2B;AAAA,IACrD,QAAS,aAAc,KAAK;AAAA,EAC7B;AACD;AAEO,SAAS,wCACf,OACA,eACe;AACf,SAAO,QAAS,aAAc,KAAK;AACpC;AAcO,IAAM,8CAA0C;AAAA,EACtD,CACC,OACA,eACA,uBACkB;AAClB,YAAS,QAAS,aAAc,KAAK,CAAC,GACpC,OAAQ,CAAE,eAAgB;AAC1B,aACC,WAAW,aAAa,WACxB,uBAAuB,WAAW;AAAA,IAEpC,CAAE,EACD,IAAK,CAAE,eAAgB;AACvB,YAAM,EAAE,OAAO,GAAG,MAAM,IAAI;AAE5B,aAAO;AAAA,QACN,GAAG;AAAA,QACH,GAAG;AAAA,MACJ;AAAA,IACD,CAAE;AAAA,EACJ;AAAA,EACA,CAAE,OAAyB,kBAA2B;AAAA,IACrD,QAAS,aAAc,KAAK;AAAA,EAC7B;AACD;AAQO,SAAS,6BACf,OACe;AACf,SAAO,OAAO,OAAQ,KAAM,EAC1B,OAAQ,CAAE,QAA8B,QAAS,GAAI,CAAE,EACvD,KAAK;AACR;",
   "names": []
 }

package/build/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/annotations/src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/build/types.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["/**\n * Represents a range in text content.\n */\nexport interface AnnotationRange {\n\t/** The offset where the annotation should start. */\n\tstart: number;\n\t/** The offset where the annotation should end. */\n\tend: number;\n}\n\n/**\n * Represents an annotation selector type.\n */\nexport type AnnotationSelector = 'range' | 'block';\n\n/**\n * Base annotation interface.\n */\nexport interface Annotation {\n\t/** Unique identifier for the annotation. */\n\tid: string;\n\t/** The block client ID this annotation applies to. */\n\tblockClientId: string;\n\t/** The source that created this annotation. */\n\tsource: string;\n\t/** The type of selector used for this annotation. */\n\tselector: AnnotationSelector;\n\t/** Rich text identifier for range annotations. */\n\trichTextIdentifier?: string | null;\n\t/** Range for range-based annotations. */\n\trange?: AnnotationRange | null;\n\t/** Start position for annotations returned from selectors. */\n\tstart?: number;\n\t/** End position for annotations returned from selectors. */\n\tend?: number;\n}\n\n/**\n * Parameters for adding an annotation.\n */\nexport interface AddAnnotationParameters {\n\t/** The blockClientId to add the annotation to. */\n\tblockClientId: string;\n\t/** Identifier for the RichText instance the annotation applies to. */\n\trichTextIdentifier?: string | null;\n\t/** The range at which to apply this annotation. */\n\trange?: AnnotationRange | null;\n\t/** The way to apply this annotation. */\n\tselector?: AnnotationSelector;\n\t/** The source that added the annotation. */\n\tsource?: string;\n\t/** The ID the annotation should have. Generates a UUID by default. */\n\tid?: string;\n}\n\n/**\n * Store state interface.\n */\nexport type AnnotationsState = Partial< Record< string, Annotation[] > >;\n\n/**\n * Action types.\n */\nexport type AnnotationAction =\n\t| {\n\t\t\ttype: 'ANNOTATION_ADD';\n\t\t\tid: string;\n\t\t\tblockClientId: string;\n\t\t\trichTextIdentifier: string | null;\n\t\t\tsource: string;\n\t\t\tselector: AnnotationSelector;\n\t\t\trange?: AnnotationRange;\n\t  }\n\t| {\n\t\t\ttype: 'ANNOTATION_REMOVE';\n\t\t\tannotationId: string;\n\t  }\n\t| {\n\t\t\ttype: 'ANNOTATION_UPDATE_RANGE';\n\t\t\tannotationId: string;\n\t\t\tstart: number;\n\t\t\tend: number;\n\t  }\n\t| {\n\t\t\ttype: 'ANNOTATION_REMOVE_SOURCE';\n\t\t\tsource: string;\n\t  };\n\n/**\n * Format registration interface for annotations.\n */\nexport interface AnnotationFormat {\n\tname: string;\n\ttitle: string;\n\ttagName: string;\n\tclassName: string;\n\tattributes: {\n\t\tclassName: string;\n\t\tid: string;\n\t};\n\tinteractive: boolean;\n\tobject: boolean;\n\tedit: () => null;\n\t__experimentalGetPropsForEditableTreePreparation: (\n\t\tselect: any,\n\t\tprops: {\n\t\t\trichTextIdentifier: string;\n\t\t\tblockClientId: string;\n\t\t}\n\t) => {\n\t\tannotations: Annotation[];\n\t};\n\t__experimentalCreatePrepareEditableTree: ( props: {\n\t\tannotations: Annotation[];\n\t} ) => ( formats: any[], text: string ) => any[];\n\t__experimentalGetPropsForEditableTreeChangeHandler: ( dispatch: any ) => {\n\t\tremoveAnnotation: ( annotationId: string ) => void;\n\t\tupdateAnnotationRange: (\n\t\t\tannotationId: string,\n\t\t\tstart: number,\n\t\t\tend: number\n\t\t) => void;\n\t};\n\t__experimentalCreateOnChangeEditableValue: ( props: {\n\t\tremoveAnnotation: ( annotationId: string ) => void;\n\t\tupdateAnnotationRange: (\n\t\t\tannotationId: string,\n\t\t\tstart: number,\n\t\t\tend: number\n\t\t) => void;\n\t\tannotations: Annotation[];\n\t} ) => ( formats: any[] ) => void;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build-module/block/index.mjs

@@ -1,16 +1,15 @@
-// packages/annotations/src/block/index.js
+// packages/annotations/src/block/index.ts
 import { addFilter } from "@wordpress/hooks";
 import { withSelect } from "@wordpress/data";
-import { STORE_NAME } from "../store/constants.mjs";
+import { store } from "../store/index.mjs";
 var addAnnotationClassName = (OriginalComponent) => {
-  return withSelect((select, { clientId, className }) => {
-    const annotations = select(STORE_NAME).__experimentalGetAnnotationsForBlock(
-      clientId
-    );
+  return withSelect((select, ownProps) => {
+    const { clientId, className } = ownProps;
+    const annotations = select(store).__experimentalGetAnnotationsForBlock(clientId);
     return {
       className: annotations.map((annotation) => {
         return "is-annotated-by-" + annotation.source;
-      }).concat(className).filter(Boolean).join(" ")
+      }).concat(className || "").filter(Boolean).join(" ")
     };
   })(OriginalComponent);
 };

package/build-module/block/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/block/index.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { addFilter } from '@wordpress/hooks';\nimport { withSelect } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport { STORE_NAME } from '../store/constants';\n/**\n * Adds annotation className to the block-list-block component.\n *\n * @param {Object} OriginalComponent The original BlockListBlock component.\n * @return {Object} The enhanced component.\n */\nconst addAnnotationClassName = ( OriginalComponent ) => {\n\treturn withSelect( ( select, { clientId, className } ) => {\n\t\tconst annotations =\n\t\t\tselect( STORE_NAME ).__experimentalGetAnnotationsForBlock(\n\t\t\t\tclientId\n\t\t\t);\n\n\t\treturn {\n\t\t\tclassName: annotations\n\t\t\t\t.map( ( annotation ) => {\n\t\t\t\t\treturn 'is-annotated-by-' + annotation.source;\n\t\t\t\t} )\n\t\t\t\t.concat( className )\n\t\t\t\t.filter( Boolean )\n\t\t\t\t.join( ' ' ),\n\t\t};\n\t} )( OriginalComponent );\n};\n\naddFilter(\n\t'editor.BlockListBlock',\n\t'core/annotations',\n\taddAnnotationClassName\n);\n"],
-  "mappings": ";AAGA,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAK3B,SAAS,kBAAkB;AAO3B,IAAM,yBAAyB,CAAE,sBAAuB;AACvD,SAAO,WAAY,CAAE,QAAQ,EAAE,UAAU,UAAU,MAAO;AACzD,UAAM,cACL,OAAQ,UAAW,EAAE;AAAA,MACpB;AAAA,IACD;AAED,WAAO;AAAA,MACN,WAAW,YACT,IAAK,CAAE,eAAgB;AACvB,eAAO,qBAAqB,WAAW;AAAA,MACxC,CAAE,EACD,OAAQ,SAAU,EAClB,OAAQ,OAAQ,EAChB,KAAM,GAAI;AAAA,IACb;AAAA,EACD,CAAE,EAAG,iBAAkB;AACxB;AAEA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACD;",
+  "sources": ["../../src/block/index.ts"],
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport type { ComponentType } from 'react';\n\n/**\n * WordPress dependencies\n */\nimport { addFilter } from '@wordpress/hooks';\nimport { withSelect } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport { store } from '../store';\nimport type { Annotation } from '../types';\n\ninterface BlockListBlockProps {\n\tclientId: string;\n\tclassName?: string;\n\t[ key: string ]: unknown;\n}\n\n/**\n * Adds annotation className to the block-list-block component.\n *\n * @param OriginalComponent The original BlockListBlock component.\n * @return The enhanced component.\n */\nconst addAnnotationClassName = ( OriginalComponent: ComponentType< any > ) => {\n\treturn withSelect( ( select, ownProps ) => {\n\t\tconst { clientId, className } = ownProps as BlockListBlockProps;\n\t\tconst annotations: Annotation[] =\n\t\t\tselect( store ).__experimentalGetAnnotationsForBlock( clientId );\n\n\t\treturn {\n\t\t\tclassName: annotations\n\t\t\t\t.map( ( annotation ) => {\n\t\t\t\t\treturn 'is-annotated-by-' + annotation.source;\n\t\t\t\t} )\n\t\t\t\t.concat( className || '' )\n\t\t\t\t.filter( Boolean )\n\t\t\t\t.join( ' ' ),\n\t\t};\n\t} )( OriginalComponent );\n};\n\naddFilter(\n\t'editor.BlockListBlock',\n\t'core/annotations',\n\taddAnnotationClassName\n);\n"],
+  "mappings": ";AAQA,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAK3B,SAAS,aAAa;AAetB,IAAM,yBAAyB,CAAE,sBAA6C;AAC7E,SAAO,WAAY,CAAE,QAAQ,aAAc;AAC1C,UAAM,EAAE,UAAU,UAAU,IAAI;AAChC,UAAM,cACL,OAAQ,KAAM,EAAE,qCAAsC,QAAS;AAEhE,WAAO;AAAA,MACN,WAAW,YACT,IAAK,CAAE,eAAgB;AACvB,eAAO,qBAAqB,WAAW;AAAA,MACxC,CAAE,EACD,OAAQ,aAAa,EAAG,EACxB,OAAQ,OAAQ,EAChB,KAAM,GAAI;AAAA,IACb;AAAA,EACD,CAAE,EAAG,iBAAkB;AACxB;AAEA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AACD;",
   "names": []
 }