Merge pull request #3744 from udecode/feat/scroll-id

Cursor Overlay plugin

.changeset/ai.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-ai': patch
+---
+
+- `CopilotPlugin`: reset on mouse down
+- `CopilotPlugin`: auto trigger only on selection change

.changeset/column.md

@@ -0,0 +1,10 @@
+---
+'@udecode/plate-layout': minor
+---
+
+- `ColumnPlugin`:
+  - unwrap columns when there is only one column
+  - remove column group when it has no column children
+  - remove column when it has no children
+- Add `insertColumnGroup`
+- Add `toggleColumnGroup`

.changeset/core-major.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-slate-react': major
+---
+
+- Add `slate-dom` as a peer dependency
+- Update `slate-react` peer dependency to `>=0.111.0`

.changeset/core.md

@@ -0,0 +1,19 @@
+---
+'@udecode/plate-core': patch
+---
+
+- `Plate` store: add `containerRef`. This is used by some plugins like `CursorOverlay`.
+- Add `useEditorContainerRef` selector hook. You can pass the returned ref to your editor scroll container.
+- `usePlateEditor` options: `value` can now be a callback function to get the value from the editor
+- `editor.key` is now using `nanoid()`
+- `editor.uid`: new property added by `Plate` to uniquely identify the editor. The difference with `editor.key` is that `uid` supports SSR hydration. This can be passed to the editor container as `id` prop.
+- `Plate` now warns if multiple instances of `@udecode/plate-core` are detected. Use `suppressInstanceWarning` to suppress the warning.
+- `render.aboveNodes` and `render.belowNodes` now support `useElement`
+- `PlatePlugin.inject` new properties:
+  - `excludePlugins?: string[]`
+  - `excludeBelowPlugins?: string[]`
+  - `maxLevel?: number`
+  - `isLeaf?: boolean`
+  - `isBlock?: boolean`
+  - `isElement?: boolean`
+- Add `getInjectMatch(editor, plugin)` to get a plugin inject match function.

.changeset/cursor copy.md

@@ -0,0 +1,5 @@
+---
+'@udecode/plate-cursor': patch
+---
+
+Deprecated, use `@udecode/plate-selection` instead.

.changeset/cursor.md

@@ -0,0 +1,9 @@
+---
+'@udecode/plate-selection': minor
+---
+
+- New plugin `CursorOverlayPlugin`
+- `useCursorOverlay` now supports collapsed selection using `minSelectionWidth = 1`
+- selectable depends now on `data-block-id` instead of `data-key`
+- Fix a bug when deleting selected blocks without id
+- Fix `useBlockSelected`: use `id` parameter if defined

.changeset/dnd.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-dnd': minor
+---
+
+- Dragging `dropEffect` is now `move` instead of `copy`
+- Fix drag bug when dragging an element without id

.changeset/heading.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-heading': major
+'@udecode/plate-ai': major
+---
+
+- Remove `scrollContainerSelector` option in favor of `useEditorContainerRef`

.changeset/html.md

@@ -0,0 +1,5 @@
+---
+'@udecode/plate-html': patch
+---
+
+Sync with `@udecode/plate-core`

.changeset/hyper.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-test-utils': patch
+---
+
+- Strip (potentially injected by the compiler) attributes starting with `__`.
+- Remove internal functions from exports.

.changeset/id.md

@@ -0,0 +1,11 @@
+---
+'@udecode/plate-node-id': minor
+---
+
+- `idCreator` default is now `nanoid(10)`
+- New option `filterInline` to filter inline elements. Default is `true`.
+- `NodeIdPlugin`:
+  - add `normalizeInitialValue` that set node ids when missing, called before mount
+  - default behavior will normalize only the first and last node if missing id to avoid traversing the entire document
+  - you can disable it with `NodeIdPlugin.configure({ normalizeInitialValue: null })`
+  - you can force check all nodes with `NodeIdPlugin.configure({ options: { normalizeInitialValue: true } })`

.changeset/layout-major.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-layout': major
+---
+
+- Remove `toggleColumns` in favor of `toggleColumnGroup`
+- Remove `insertEmptyColumn` in favor of `insertColumn`

.changeset/md.md

@@ -0,0 +1,6 @@
+---
+'@udecode/plate-markdown': minor
+---
+
+- `api.markdown.deserialize`: add second argument option: `processor?: (processor: Processor) => Processor`. You could use this to add other remark plugins like `remark-gfm`.
+- Add `delete` text rule. This does not add support for strikethrough yet.

.changeset/misc.md

@@ -0,0 +1,7 @@
+---
+'@udecode/plate-line-height': patch
+'@udecode/plate-alignment': patch
+'@udecode/plate-indent': patch
+---
+
+Use `getInjectMatch(editor, plugin)`

.changeset/table.md

@@ -0,0 +1,5 @@
+---
+'@udecode/plate-table': patch
+---
+
+Fix: remove tables without any rows

.changeset/utils.md

@@ -0,0 +1,5 @@
+---
+'@udecode/plate-utils': patch
+---
+
+- `PlateElement` add `data-block-id` if `element.id` is defined, after editor mount to support SSR hydration.

apps/www/content/docs/ai.mdx

@@ -172,7 +172,6 @@ const plugins = [
             ? PROMPT_TEMPLATES.userSelecting
             : PROMPT_TEMPLATES.userDefault;
       },
-      scrollContainerSelector: '#scroll_container',
       systemTemplate: ({ isBlockSelecting, isSelecting }) => {
         return isBlockSelecting
           ? PROMPT_TEMPLATES.systemBlockSelecting
@@ -183,18 +182,11 @@ const plugins = [
     },
     render: { afterEditable: () => <AIMenu /> },
   }),
-  SelectionOverlayPlugin,
 ];
 ```
 
 - [AIMenu](/docs/components/ai-menu)
 
-The [SelectionOverlayPlugin](https://pro.platejs.org/docs/components/cursor-overlay):
-
-- Maintains selection highlight when editor loses focus
-- Essential for AI menu and other external input interactions
-- Prevents double selection with `data-plate-prevent-overlay` attribute
-
 ### AI SDK
 
 This plugin is depending on the [ai](https://npmjs.com/package/ai) package:
@@ -278,14 +270,6 @@ Template for generating prompts. Supports placeholders:
 
 </APIItem>
 
-<APIItem name="scrollContainerSelector" type="string" optional>
-
-CSS selector for scrollable container.
-
-- **Default:** `'#scroll_container'`
-
-</APIItem>
-
 <APIItem name="systemTemplate" type="(props: EditorPromptParams) => string | void" optional>
 
 Template for system messages. Supports same placeholders as `promptTemplate`.

apps/www/content/docs/api/core/plate-plugin.mdx

@@ -63,6 +63,28 @@ Defines how the plugin injects functionality into other plugins or the editor.
 <APISubListItem parent="inject" name="nodeProps" type="InjectNodeProps<WithAnyKey<C>>" optional>
 Properties used by Plate to inject props into any node component.
 </APISubListItem>
+
+
+<APISubListItem parent="inject" name="excludePlugins" type="string[]" optional>
+An array of plugin keys to exclude from node prop injection.
+</APISubListItem>
+
+<APISubListItem parent="inject" name="excludeBelowPlugins" type="string[]" optional>
+An array of plugin keys. Node prop injection will be excluded for any nodes that are descendants of elements with these plugin types.
+</APISubListItem>
+<APISubListItem parent="inject" name="isBlock" type="boolean" optional>
+If true, only matches block elements. Used to restrict prop injection to block-level nodes.
+</APISubListItem>
+
+<APISubListItem parent="inject" name="isElement" type="boolean" optional>
+If true, only matches element nodes. Used to restrict prop injection to element nodes.
+</APISubListItem>
+<APISubListItem parent="inject" name="isLeaf" type="boolean" optional>
+If true, only matches leaf nodes. Used to restrict prop injection to leaf nodes.
+</APISubListItem>
+<APISubListItem parent="inject" name="maxLevel" type="number" optional>
+Maximum nesting level for node prop injection. Nodes deeper than this level will not receive injected props.
+</APISubListItem>
 <APISubListItem parent="inject" name="plugins" type="Record<string, Partial<EditorPlatePlugin<AnyPluginConfig>>>" optional>
 Property that can be used by a plugin to allow other plugins to inject code.
 </APISubListItem>

apps/www/content/docs/api/core/store.mdx

@@ -29,6 +29,10 @@ A unique ID used as a provider scope. Use it if you have multiple `Plate` in the
 - **Default:** random id
 </APIItem>
 
+<APIItem name="containerRef" type="React.RefObject<HTMLDivElement>">
+A reference to the editor container element.
+</APIItem>
+
 <APIItem name="decorate" type="function" optional>
 Function used to decorate ranges in the editor.
 

apps/www/content/docs/block-menu.mdx

@@ -13,7 +13,7 @@ docs:
 
 ---
 
-<ComponentPreview name="playground-demo" id="blockmenu" />
+<ComponentPreview name="playground-demo" id="block-menu" />
 
 <PackageInfo>
 
@@ -52,10 +52,6 @@ const plugins = [
           },
           startThreshold: 10,
         },
-        boundaries: '#scroll_container',
-        container: '#scroll_container',
-        selectables: '#scroll_container .slate-selectable',
-        selectionAreaClass: 'slate-selection-area',
       },
       enableContextMenu: true,
     },