@lexical/selection 0.2.0 → 0.2.3

package/LexicalSelection.dev.js

@@ -459,7 +459,7 @@ function $removeParentEmptyElements(startingNode) {
     const parentNode = node.getParent();
 
     if (latest.__children.length === 0) {
-      node.remove();
+      node.remove(true);
     }
 
     node = parentNode;
@@ -605,7 +605,9 @@ function $wrapLeafNodesInElements(selection, createElement, wrappingElement) {
   const prevSelection = lexical.$getPreviousSelection();
 
   if (lexical.$isRangeSelection(prevSelection) && isPointAttached(prevSelection.anchor) && isPointAttached(prevSelection.focus)) {
-    lexical.$setSelection(prevSelection);
+    const clonedSelection = prevSelection.clone();
+    clonedSelection.dirty = true;
+    lexical.$setSelection(clonedSelection);
   } else {
     selection.dirty = true;
   }

package/LexicalSelection.prod.js

@@ -10,7 +10,7 @@ e.__children.indexOf(a.getKey()):a.getIndexWithinParent();a=c}}
 function x(a){if(l.$isRangeSelection(a)){var c=a.anchor,b=a.focus,g=c.getCharacterOffset();const n=b.getCharacterOffset();var h=c.getNode(),e=b.getNode(),d=h.getParentOrThrow();if(h===e&&l.$isTextNode(h)&&(d.canBeEmpty()||1<d.getChildrenSize()))return a=u(h),h=n>g,a.__text=a.__text.slice(h?g:n,h?n:g),g=a.getKey(),{nodeMap:[[g,a]],range:[g]};a=a.getNodes();if(0===a.length)return{nodeMap:[],range:[]};h=a.length;e=a[0];d=e.getParent();if(null!==d&&(!d.canBeEmpty()||l.$isRootNode(d))){var f=d.__children;
 if(f.length===h){var k=!0;for(var m=0;m<f.length;m++)if(f[m]!==a[m].__key){k=!1;break}k&&(h++,a.push(d))}}d=a[h-1];c=c.isBefore(b);b=new Map;f=[];w(e,c?g:n,!0,f,b);for(e=0;e<h;e++)if(k=a[e],m=k.getKey(),!(b.has(m)||l.$isElementNode(k)&&k.excludeFromCopy())){const r=u(k);l.$isRootNode(k.getParent())&&f.push(k.getKey());b.set(m,r)}w(d,c?n:g,!1,f,b);return{nodeMap:Array.from(b.entries()),range:f}}if(l.$isGridSelection(a))return{nodeMap:a.getNodes().map(n=>{const r=n.getKey();n=u(n);return[r,n]}),range:[a.gridKey]};
 throw Error("Minified Lexical error #68; see codes.json for the full message or use the non-minified dev environment for full errors and additional helpful warnings.");}function y(a){return t.get(a)||null}function z(a,c){var b=y(a.getStyle());c=b?{...b,...c}:c;b="";for(g in c)g&&(b+=`${g}: ${c[g]};`);var g=b;a.setStyle(g);t.set(g,c)}function A(a,c,b,g){a.modify(c?"extend":"move",b,g)}function B(a){a=a.anchor.getNode();return"rtl"===(l.$isRootNode(a)?a:a.getParentOrThrow()).getDirection()}
-function C(a){for(;null!==a&&!l.$isRootNode(a);){const c=a.getLatest(),b=a.getParent();0===c.__children.length&&a.remove();a=b}}exports.$cloneContents=function(a){return x(a)};
+function C(a){for(;null!==a&&!l.$isRootNode(a);){const c=a.getLatest(),b=a.getParent();0===c.__children.length&&a.remove(!0);a=b}}exports.$cloneContents=function(a){return x(a)};
 exports.$getSelectionStyleValueForProperty=function(a,c,b=""){let g=null;const h=a.getNodes();var e=a.anchor,d=a.focus,f=a.isBackward();a=f?d.offset:e.offset;e=f?d.getNode():e.getNode();for(d=0;d<h.length;d++){var k=h[d];if((0===d||0!==a||!k.is(e))&&l.$isTextNode(k)){f=c;var m=b;k=k.getStyle();k=y(k);f=null!==k?k[f]||m:m;if(null===g)g=f;else if(g!==f){g="";break}}}return null===g?b:g};exports.$isAtNodeEnd=function(a){return"text"===a.type?a.offset===a.getNode().getTextContentSize():a.offset===a.getNode().getChildrenSize()};
 exports.$isParentElementRTL=B;exports.$moveCaretSelection=A;exports.$moveCharacter=function(a,c,b){const g=B(a);A(a,c,b?!g:g,"character")};
 exports.$patchStyleText=function(a,c){var b=a.getNodes();const g=b.length-1;let h=b[0],e=b[g];if(!a.isCollapsed()){var d=a.anchor,f=a.focus;a=h.getTextContent().length;var k=f.offset,m=d.offset;d=(f=d.isBefore(f))?m:k;f=f?k:m;if(d===h.getTextContentSize()){const n=h.getNextSibling();l.$isTextNode(n)&&(d=m=0,h=n)}if(h.is(e))l.$isTextNode(h)&&(d=m>k?k:m,f=m>k?m:k,d!==f&&(0===d&&f===a?(z(h,c),h.select(d,f)):(b=h.splitText(d,f),b=0===d?b[0]:b[1],z(b,c),b.select(0,f-d))));else for(l.$isTextNode(h)&&(0!==
@@ -19,4 +19,4 @@ exports.$selectAll=function(a){const c=a.anchor;a=a.focus;var b=c.getNode().getT
 exports.$shouldOverrideDefaultCharacterSelection=function(a,c){a=l.$getDecoratorNode(a.focus,c);return l.$isDecoratorNode(a)&&!a.isIsolated()};
 exports.$wrapLeafNodesInElements=function(a,c,b){const g=a.getNodes(),h=g.length;if(0===h){a=a.anchor;a="text"===a.type?a.getNode().getParentOrThrow():a.getNode();var e=a.getChildren();let p=c();e.forEach(v=>p.append(v));b&&(p=b.append(p));a.replace(p)}else{var d=g[0],f=new Map;e=[];d=l.$isElementNode(d)?d:d.getParentOrThrow();for(d.isInline()&&(d=d.getParentOrThrow());null!==d;){var k=d.getPreviousSibling();if(null!==k){d=k;break}d=d.getParentOrThrow();if(l.$isRootNode(d))break}k=new Set;for(var m=
 0;m<h;m++){var n=g[m];l.$isElementNode(n)&&0===n.getChildrenSize()&&k.add(n.getKey())}var r=new Set;for(m=0;m<h;m++){var q=g[m];n=q.getParent();null!==n&&n.isInline()&&(n=n.getParent());if(null!==n&&l.$isLeafNode(q)&&!r.has(q.getKey())){if(q=n.getKey(),void 0===f.get(q)){const p=c();e.push(p);f.set(q,p);n.getChildren().forEach(v=>{p.append(v);r.add(v.getKey())});C(n)}}else k.has(q.getKey())&&(e.push(c()),q.remove())}if(b)for(c=0;c<e.length;c++)b.append(e[c]);if(l.$isRootNode(d))if(c=d.getFirstChild(),
-l.$isElementNode(c)&&(d=c),null===c)if(b)d.append(b);else for(b=0;b<e.length;b++)d.append(e[b]);else if(b)c.insertBefore(b);else for(b=0;b<e.length;b++)c.insertBefore(e[b]);else if(b)d.insertAfter(b);else for(b=e.length-1;0<=b;b--)d.insertAfter(e[b]);b=l.$getPreviousSelection();l.$isRangeSelection(b)&&b.anchor.getNode().isAttached()&&b.focus.getNode().isAttached()?l.$setSelection(b):a.dirty=!0}};exports.getStyleObjectFromCSS=y;
+l.$isElementNode(c)&&(d=c),null===c)if(b)d.append(b);else for(b=0;b<e.length;b++)d.append(e[b]);else if(b)c.insertBefore(b);else for(b=0;b<e.length;b++)c.insertBefore(e[b]);else if(b)d.insertAfter(b);else for(b=e.length-1;0<=b;b--)d.insertAfter(e[b]);b=l.$getPreviousSelection();l.$isRangeSelection(b)&&b.anchor.getNode().isAttached()&&b.focus.getNode().isAttached()?(a=b.clone(),a.dirty=!0,l.$setSelection(a)):a.dirty=!0}};exports.getStyleObjectFromCSS=y;

package/README.md

@@ -1,3 +1,127 @@
 # `@lexical/selection`
 
-This package contains utilities and helpers for handling Lexical selection.
+This package contains selection helpers for Lexical.
+
+### Methods
+
+#### `$cloneContents`
+
+Clones the Lexical nodes in the selection, returning a map of Key -> LexicalNode and a list containing the keys
+of all direct children of the RootNode. Useful for insertion/transfer operations, such as copy and paste.
+
+```ts
+export function $cloneContents(
+  selection: RangeSelection | NodeSelection | GridSelection,
+): {
+  nodeMap: Array<[NodeKey, LexicalNode]>;
+  range: Array<NodeKey>;
+};
+```
+
+#### `getStyleObjectFromCSS`
+
+Given a CSS string, returns an object from the style cache.
+
+```ts
+export function getStyleObjectFromCSS(css: string): {
+  [key: string]: string;
+} | null;
+```
+
+#### `$patchStyleText`
+
+Applies the provided styles to the TextNodes in the provided Selection. Key names in the patch argument should be
+the valid CSS properties (i.e., kebab-case).
+
+```ts
+export function $patchStyleText(
+  selection: RangeSelection | GridSelection,
+  patch: {
+    [key: string]: string;
+  },
+): void;
+```
+
+#### `$getSelectionStyleValueForProperty`
+
+Given a selection and a valid CSS property name, returns the current value of that property for TextNodes in the Selection, if set. If not set, it returns the defaultValue. If all TextNodes do not have the same value, it returns an empty string.
+
+```ts
+export function $getSelectionStyleValueForProperty(
+  selection: RangeSelection,
+  styleProperty: string,
+  defaultValue: string,
+): string;
+```
+
+#### `$moveCaretSelection`
+
+Moves the selection according to the arguments.
+
+```ts
+export function $moveCaretSelection(
+  selection: RangeSelection,
+  isHoldingShift: boolean,
+  isBackward: boolean,
+  granularity: 'character' | 'word' | 'lineboundary',
+): void;
+```
+
+#### `$isParentElementRTL`
+
+Returns true if the parent of the Selection anchor node is in Right-To-Left mode, false if not.
+
+```ts
+export function $isParentElementRTL(selection: RangeSelection): boolean;
+```
+
+#### `$moveCharacter`
+
+Wraps $moveCaretSelection, using character granularity and accounting for RTL mode.
+
+```ts
+export function $moveCharacter(
+  selection: RangeSelection,
+  isHoldingShift: boolean,
+  isBackward: boolean,
+): void;
+```
+
+#### `$selectAll`
+
+Expands the current Selection to cover all of the content in the editor.
+
+```ts
+export function $selectAll(selection: RangeSelection): void;
+```
+
+#### `$wrapLeafNodesInElements`
+
+Attempts to wrap all leaf nodes in the Selection in ElementNodes returned from createElement. If wrappingElement is provided, all of the wrapped leaves are appended to the wrappingElement. It attempts to append the resulting sub-tree to the nearest safe insertion target.
+
+```ts
+export function $wrapLeafNodesInElements(
+  selection: RangeSelection,
+  createElement: () => ElementNode,
+  wrappingElement?: ElementNode,
+): void;
+```
+
+#### `$isAtNodeEnd`
+
+Returns true if the provided point offset is in the last possible position.
+
+```ts
+export function $isAtNodeEnd(point: Point): boolean;
+```
+
+#### `$shouldOverrideDefaultCharacterSelection`
+
+Returns true if default character selection should be overridden, false if not. Used with DecoratorNodes
+
+```ts
+export function $shouldOverrideDefaultCharacterSelection(
+  selection: RangeSelection,
+  isBackward: boolean,
+): boolean;
+```

package/package.json

@@ -9,10 +9,10 @@
     "selection"
   ],
   "license": "MIT",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "main": "LexicalSelection.js",
   "peerDependencies": {
-    "lexical": "0.2.0"
+    "lexical": "0.2.3"
   },
   "repository": {
     "type": "git",