@aquera/nile-elements 1.9.7 → 1.9.9

package/src/nile-wysiwyg-editor/ui/table-menu.ts

@@ -3,6 +3,7 @@ import { customElement, property } from 'lit/decorators.js';
 import NileElement from '../../internal/nile-element';
 import { renderGlyph } from '../../internal/glyph';
 import type { CommandName } from '../engine/commands';
+import '../../nile-lite-tooltip/nile-lite-tooltip';
 
 interface TableOp {
   name: CommandName;
@@ -87,14 +88,15 @@ export class NileWysiwygTableMenu extends NileElement {
       <div class="menu" part="table-menu" @mousedown=${(e: Event) => e.preventDefault()}>
         ${OPS.map(
           op => html`
-            <button
-              type="button"
-              title=${op.label}
-              aria-label=${op.label}
-              @click=${() => this.emit('wysiwyg-command', { name: op.name })}
-            >
-              ${renderGlyph(op.icon, 16)}
-            </button>
+            <nile-lite-tooltip content=${op.label} placement="top">
+              <button
+                type="button"
+                aria-label=${op.label}
+                @click=${() => this.emit('wysiwyg-command', { name: op.name })}
+              >
+                ${renderGlyph(op.icon, 16)}
+              </button>
+            </nile-lite-tooltip>
           `
         )}
       </div>

package/vscode-html-custom-data.json

@@ -8114,7 +8114,7 @@
     },
     {
       "name": "nile-wysiwyg-editor",
-      "description": "WYSIWYG rich text editor powered by ProseMirror.\n\nRequires evergreen browsers: selection inside shadow DOM relies on\n`Selection.getComposedRanges()` (Safari 17+, recent Firefox) or Chrome's\n`shadowRoot.getSelection()`.\n\nEvents:\n\n  * `nile-change` {} - Debounced content change. detail: { value, json, content }\n\n  * `nile-input` {} - Every document change. detail: { value, json, content }\n\n  * `nile-focus` {} - Editor gained focus.\n\n  * `nile-blur` {} - Editor lost focus.\n\n  * `nile-selection-change` {} - detail: ToolbarState snapshot.\n\n  * `nile-image-upload-request` {} - Cancelable. detail: { file, insert(src, alt) }.\nCall preventDefault() and use insert() to fully own the upload.\n\n  * `nile-image-upload-error` {} - detail: { file, error } when uploadHandler rejects.\n\n  * `nile-mention-query` {} - detail: { trigger, query, provide(items) } for async sources.\n\n  * `nile-mention-select` {} - detail: { trigger, key, label } when a mention is inserted.\n\n  * `nile-word-count` {} - detail: { words, characters } on every document change.\n\n  * `nile-autosave` {} - detail: { value, json, content } on the autosave interval.\n\nAttributes:\n\n  * `value` {`string`} - Document content as HTML. Not reflected to the attribute.\n\n  * `placeholder` {`string`} - \n\n  * `disabled` {`boolean`} - \n\n  * `readonly` {`boolean`} - \n\n  * `toolbar` {`string`} - Toolbar config string; `\"none\"` hides the toolbar.\n\n  * `bubble-menu` {`boolean`} - Shows a balloon toolbar over text selections.\n\n  * `sanitize` {`boolean`} - Sanitizes incoming HTML (value, paste, insertHTML). Leave on.\n\n  * `singleline` {`boolean`} - Constrains content to a single paragraph.\n\n  * `name` {`string`} - Form field name.\n\n  * `required` {`boolean`} - \n\n  * `upload-from-computer` {`boolean`} - Shows an \"Upload from computer\" button in the Insert Image dialog. Off by\ndefault (URL-only, like the RTE's default); files can always be added via\ndrag & drop or paste regardless.\n\n  * `image-max-file-size` {`number`} - Max upload size (bytes) shown/enforced by the image dialog. Default 2 MB.\n\n  * `mentions` - Mention config: trigger character → items, same shape and JSON attribute\nformat as nile-rich-text-editor. For async sources, configure the\ntrigger with an empty array and listen to nile-mention-query.\n\n  * `no-slash-commands` {`boolean`} - Disables the \"/\" command menu.\n\n  * `no-emoji` {`boolean`} - Disables the \":\" emoji picker.\n\n  * `maxlength` {`number`} - Maximum character count; further input is rejected. 0 = unlimited.\n\n  * `show-counter` {`boolean`} - Always show the word/character counter footer (implied by maxlength).\n\n  * `sticky-toolbar` {`boolean`} - Keeps the toolbar pinned to the viewport while scrolling long content.\n\n  * `snippets` {`SnippetConfig[]`} - Reusable snippets surfaced in the \"/\" menu (JSON attribute).\n\n  * `merge-fields` {`MergeFieldConfig[]`} - Merge fields offered in the merge-field picker (JSON attribute).\n\n  * `templates` {`TemplateConfig[]`} - Content templates offered in the template picker (JSON attribute).\n\n  * `autosave-interval` {`number`} - Emit nile-autosave every N ms while the document has changed. 0 = off.\n\n  * `paste-as-plain-text` {`boolean`} - When on, every paste drops formatting and inserts plain text.\n\n  * `no-markdown-paste` {`boolean`} - Disables Markdown detection on plain-text pastes.\n\n  * `no-text-transform` {`boolean`} - Disables typography autocorrect (smart quotes, dashes, (c) → ©).\n\n  * `fullscreen` {`boolean`} - Expands the editor to fill the viewport. Esc exits.\n\n  * `show-blocks` {`boolean`} - Outlines block boundaries (paragraphs, headings, lists…) while editing.\n\nProperties:\n\n  * `formAssociated` {`boolean`} - \n\n  * `value` {`string`} - Document content as HTML. Not reflected to the attribute.\n\n  * `placeholder` {`string`} - \n\n  * `disabled` {`boolean`} - \n\n  * `readonly` {`boolean`} - \n\n  * `toolbar` {`string`} - Toolbar config string; `\"none\"` hides the toolbar.\n\n  * `bubbleMenu` {`boolean`} - Shows a balloon toolbar over text selections.\n\n  * `sanitize` {`boolean`} - Sanitizes incoming HTML (value, paste, insertHTML). Leave on.\n\n  * `singleLine` {`boolean`} - Constrains content to a single paragraph.\n\n  * `name` {`string`} - Form field name.\n\n  * `required` {`boolean`} - \n\n  * `uploadHandler` - Async image upload handler. When set, pasted/dropped/picked image files\nare uploaded through it (an \"Uploading…\" placeholder shows meanwhile)\nand the returned src is inserted.\n\n  * `allowBase64Images` {`boolean`} - Fallback when no uploadHandler is set and no nile-image-upload-request\nlistener takes over: embed image files as base64 data URLs.\n\n  * `uploadFromComputer` {`boolean`} - Shows an \"Upload from computer\" button in the Insert Image dialog. Off by\ndefault (URL-only, like the RTE's default); files can always be added via\ndrag & drop or paste regardless.\n\n  * `imageMaxFileSize` {`number`} - Max upload size (bytes) shown/enforced by the image dialog. Default 2 MB.\n\n  * `mentions` - Mention config: trigger character → items, same shape and JSON attribute\nformat as nile-rich-text-editor. For async sources, configure the\ntrigger with an empty array and listen to nile-mention-query.\n\n  * `noSlashCommands` {`boolean`} - Disables the \"/\" command menu.\n\n  * `noEmoji` {`boolean`} - Disables the \":\" emoji picker.\n\n  * `maxLength` {`number`} - Maximum character count; further input is rejected. 0 = unlimited.\n\n  * `showCounter` {`boolean`} - Always show the word/character counter footer (implied by maxlength).\n\n  * `stickyToolbar` {`boolean`} - Keeps the toolbar pinned to the viewport while scrolling long content.\n\n  * `snippets` {`SnippetConfig[]`} - Reusable snippets surfaced in the \"/\" menu (JSON attribute).\n\n  * `mergeFields` {`MergeFieldConfig[]`} - Merge fields offered in the merge-field picker (JSON attribute).\n\n  * `templates` {`TemplateConfig[]`} - Content templates offered in the template picker (JSON attribute).\n\n  * `mathRenderer` - Renders a math node's LaTeX to HTML (KaTeX/MathJax/MathML). When unset,\nthe raw LaTeX is shown. Same trust level as uploadHandler — output is\ninserted as HTML.\n\n  * `autosaveInterval` {`number`} - Emit nile-autosave every N ms while the document has changed. 0 = off.\n\n  * `pasteAsPlainText` {`boolean`} - When on, every paste drops formatting and inserts plain text.\n\n  * `noMarkdownPaste` {`boolean`} - Disables Markdown detection on plain-text pastes.\n\n  * `noTextTransform` {`boolean`} - Disables typography autocorrect (smart quotes, dashes, (c) → ©).\n\n  * `fullscreen` {`boolean`} - Expands the editor to fill the viewport. Esc exits.\n\n  * `showBlocks` {`boolean`} - Outlines block boundaries (paragraphs, headings, lists…) while editing.\n\n  * `toolbarState` {`ToolbarState | undefined`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `sourceMode` {`boolean`} - \n\n  * `counter` {`{ words: number; characters: number; }`} - \n\n  * `insertMenuMode` {`\"template\" | \"merge\" | null`} - Which list the shared insert-menu is showing, if open.\n\n  * `baseEl` {`HTMLElement`} - \n\n  * `toolbarEl` {`HTMLElement | undefined`} - \n\n  * `surfaceEl` {`HTMLElement`} - \n\n  * `linkEditorEl` - \n\n  * `bubbleMenuEl` - \n\n  * `imagePanelEl` - \n\n  * `tableMenuEl` - \n\n  * `suggestListEl` - \n\n  * `findBarEl` - \n\n  * `sourceViewEl` - \n\n  * `embedPanelEl` - \n\n  * `bookmarkPanelEl` - \n\n  * `codeMenuEl` - \n\n  * `shortcutHelpEl` - \n\n  * `imageMenuEl` - \n\n  * `embedMenuEl` - \n\n  * `specialCharsEl` - \n\n  * `emojiPickerEl` - \n\n  * `insertMenuEl` - \n\n  * `mathPanelEl` - \n\n  * `markdownPanelEl` - \n\n  * `view` - \n\n  * `mentionMatch` {`SuggestionMatch | null`} - \n\n  * `slashMatch` {`SuggestionMatch | null`} - \n\n  * `emojiMatch` {`SuggestionMatch | null`} - \n\n  * `activeSuggestSource` {`\"mention\" | \"slash\" | \"emoji\" | null`} - \n\n  * `suggestDismissed` {`string | null`} - \n\n  * `mentionQueryToken` {`string`} - \n\n  * `autosaveTimer` - \n\n  * `lastAutosaveValue` {`string`} - \n\n  * `internals` - \n\n  * `defaultValue` {`string`} - \n\n  * `syncingValue` {`boolean`} - \n\n  * `changeTimer` - \n\n  * `pendingChange` {`boolean`} - \n\n  * `previousBodyOverflow` {`string | null`} - Body overflow value before fullscreen locked it; null = not locked.\n\n  * `contentRoot` {`HTMLElement | null`} - The live, styled content element used as the source for exports.\n\n  * `pmView` - The underlying ProseMirror EditorView. Advanced escape hatch.\n\n  * `json` - Document as ProseMirror JSON.\n\n  * `override` - \n\n  * `floatingPanels` {`({ open: boolean; } | undefined)[]`} - The floating insert panels that should dismiss on outside interaction.\n\n  * `onOutsidePointerDown` - Closes any open insert panel when the pointer goes down outside of it —\nwhether elsewhere in the editor (e.g. the content area) or off the widget.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "WYSIWYG rich text editor powered by ProseMirror.\n\nRequires evergreen browsers: selection inside shadow DOM relies on\n`Selection.getComposedRanges()` (Safari 17+, recent Firefox) or Chrome's\n`shadowRoot.getSelection()`.\n\nEvents:\n\n  * `nile-change` {} - Debounced content change. detail: { value, json, content }\n\n  * `nile-input` {} - Every document change. detail: { value, json, content }\n\n  * `nile-focus` {} - Editor gained focus.\n\n  * `nile-blur` {} - Editor lost focus.\n\n  * `nile-selection-change` {} - detail: ToolbarState snapshot.\n\n  * `nile-image-upload-request` {} - Cancelable. detail: { file, insert(src, alt) }.\nCall preventDefault() and use insert() to fully own the upload.\n\n  * `nile-image-upload-error` {} - detail: { file, error } when uploadHandler rejects.\n\n  * `nile-mention-query` {} - detail: { trigger, query, provide(items) } for async sources.\n\n  * `nile-mention-select` {} - detail: { trigger, key, label } when a mention is inserted.\n\n  * `nile-word-count` {} - detail: { words, characters } on every document change.\n\n  * `nile-autosave` {} - detail: { value, json, content } on the autosave interval.\n\nAttributes:\n\n  * `value` {`string`} - Document content as HTML. Not reflected to the attribute.\n\n  * `placeholder` {`string`} - \n\n  * `disabled` {`boolean`} - \n\n  * `readonly` {`boolean`} - \n\n  * `toolbar` {`string`} - Toolbar config string; `\"none\"` hides the toolbar.\n\n  * `bubble-menu` {`boolean`} - Shows a balloon toolbar over text selections.\n\n  * `sanitize` {`boolean`} - Sanitizes incoming HTML (value, paste, insertHTML). Leave on.\n\n  * `singleline` {`boolean`} - Constrains content to a single paragraph.\n\n  * `name` {`string`} - Form field name.\n\n  * `required` {`boolean`} - \n\n  * `upload-from-computer` {`boolean`} - Shows an \"Upload from computer\" button in the Insert Image dialog. Off by\ndefault (URL-only, like the RTE's default); files can always be added via\ndrag & drop or paste regardless.\n\n  * `image-max-file-size` {`number`} - Max upload size (bytes) shown/enforced by the image dialog. Default 2 MB.\n\n  * `mentions` - Mention config: trigger character → items, same shape and JSON attribute\nformat as nile-rich-text-editor. For async sources, configure the\ntrigger with an empty array and listen to nile-mention-query.\n\n  * `no-slash-commands` {`boolean`} - Disables the \"/\" command menu.\n\n  * `no-emoji` {`boolean`} - Disables the \":\" emoji picker.\n\n  * `maxlength` {`number`} - Maximum character count; further input is rejected. 0 = unlimited.\n\n  * `show-counter` {`boolean`} - Always show the word/character counter footer (implied by maxlength).\n\n  * `sticky-toolbar` {`boolean`} - Keeps the toolbar pinned to the viewport while scrolling long content.\n\n  * `snippets` {`SnippetConfig[]`} - Reusable snippets surfaced in the \"/\" menu (JSON attribute).\n\n  * `merge-fields` {`MergeFieldConfig[]`} - Merge fields offered in the merge-field picker (JSON attribute).\n\n  * `templates` {`TemplateConfig[]`} - Content templates offered in the template picker (JSON attribute).\n\n  * `autosave-interval` {`number`} - Emit nile-autosave every N ms while the document has changed. 0 = off.\n\n  * `paste-as-plain-text` {`boolean`} - When on, every paste drops formatting and inserts plain text.\n\n  * `no-markdown-paste` {`boolean`} - Disables Markdown detection on plain-text pastes.\n\n  * `no-text-transform` {`boolean`} - Disables typography autocorrect (smart quotes, dashes, (c) → ©).\n\n  * `fullscreen` {`boolean`} - Expands the editor to fill the viewport. Esc exits.\n\n  * `show-blocks` {`boolean`} - Outlines block boundaries (paragraphs, headings, lists…) while editing.\n\nProperties:\n\n  * `formAssociated` {`boolean`} - \n\n  * `value` {`string`} - Document content as HTML. Not reflected to the attribute.\n\n  * `placeholder` {`string`} - \n\n  * `disabled` {`boolean`} - \n\n  * `readonly` {`boolean`} - \n\n  * `toolbar` {`string`} - Toolbar config string; `\"none\"` hides the toolbar.\n\n  * `authoredToolbar` {`AuthoredToolbarItem[] | undefined`} - Toolbar built from authored `<nile-wysiwyg-toolbar-item>` light-DOM\nchildren. When present it takes precedence over the `toolbar` string.\n\n  * `authoredBubble` {`AuthoredToolbarItem[] | undefined`} - Bubble menu built from authored `<nile-wysiwyg-bubble-item>` light-DOM\nchildren. When present it replaces the built-in bold/italic/underline/\nstrike/link set.\n\n  * `toolbarObserver` {`MutationObserver | undefined`} - Watches authored toolbar/bubble children so edits re-render them.\n\n  * `bubbleMenu` {`boolean`} - Shows a balloon toolbar over text selections.\n\n  * `sanitize` {`boolean`} - Sanitizes incoming HTML (value, paste, insertHTML). Leave on.\n\n  * `singleLine` {`boolean`} - Constrains content to a single paragraph.\n\n  * `name` {`string`} - Form field name.\n\n  * `required` {`boolean`} - \n\n  * `uploadHandler` - Async image upload handler. When set, pasted/dropped/picked image files\nare uploaded through it (an \"Uploading…\" placeholder shows meanwhile)\nand the returned src is inserted.\n\n  * `allowBase64Images` {`boolean`} - Fallback when no uploadHandler is set and no nile-image-upload-request\nlistener takes over: embed image files as base64 data URLs.\n\n  * `uploadFromComputer` {`boolean`} - Shows an \"Upload from computer\" button in the Insert Image dialog. Off by\ndefault (URL-only, like the RTE's default); files can always be added via\ndrag & drop or paste regardless.\n\n  * `imageMaxFileSize` {`number`} - Max upload size (bytes) shown/enforced by the image dialog. Default 2 MB.\n\n  * `mentions` - Mention config: trigger character → items, same shape and JSON attribute\nformat as nile-rich-text-editor. For async sources, configure the\ntrigger with an empty array and listen to nile-mention-query.\n\n  * `noSlashCommands` {`boolean`} - Disables the \"/\" command menu.\n\n  * `noEmoji` {`boolean`} - Disables the \":\" emoji picker.\n\n  * `maxLength` {`number`} - Maximum character count; further input is rejected. 0 = unlimited.\n\n  * `showCounter` {`boolean`} - Always show the word/character counter footer (implied by maxlength).\n\n  * `stickyToolbar` {`boolean`} - Keeps the toolbar pinned to the viewport while scrolling long content.\n\n  * `snippets` {`SnippetConfig[]`} - Reusable snippets surfaced in the \"/\" menu (JSON attribute).\n\n  * `mergeFields` {`MergeFieldConfig[]`} - Merge fields offered in the merge-field picker (JSON attribute).\n\n  * `templates` {`TemplateConfig[]`} - Content templates offered in the template picker (JSON attribute).\n\n  * `mathRenderer` - Renders a math node's LaTeX to HTML (KaTeX/MathJax/MathML). When unset,\nthe raw LaTeX is shown. Same trust level as uploadHandler — output is\ninserted as HTML.\n\n  * `autosaveInterval` {`number`} - Emit nile-autosave every N ms while the document has changed. 0 = off.\n\n  * `pasteAsPlainText` {`boolean`} - When on, every paste drops formatting and inserts plain text.\n\n  * `noMarkdownPaste` {`boolean`} - Disables Markdown detection on plain-text pastes.\n\n  * `noTextTransform` {`boolean`} - Disables typography autocorrect (smart quotes, dashes, (c) → ©).\n\n  * `fullscreen` {`boolean`} - Expands the editor to fill the viewport. Esc exits.\n\n  * `showBlocks` {`boolean`} - Outlines block boundaries (paragraphs, headings, lists…) while editing.\n\n  * `toolbarState` {`ToolbarState | undefined`} - \n\n  * `hasFocus` {`boolean`} - \n\n  * `sourceMode` {`boolean`} - \n\n  * `counter` {`{ words: number; characters: number; }`} - \n\n  * `insertMenuMode` {`\"template\" | \"merge\" | null`} - Which list the shared insert-menu is showing, if open.\n\n  * `baseEl` {`HTMLElement`} - \n\n  * `toolbarEl` {`HTMLElement | undefined`} - \n\n  * `surfaceEl` {`HTMLElement`} - \n\n  * `linkEditorEl` - \n\n  * `bubbleMenuEl` - \n\n  * `imagePanelEl` - \n\n  * `tableMenuEl` - \n\n  * `suggestListEl` - \n\n  * `findBarEl` - \n\n  * `sourceViewEl` - \n\n  * `embedPanelEl` - \n\n  * `bookmarkPanelEl` - \n\n  * `codeMenuEl` - \n\n  * `shortcutHelpEl` - \n\n  * `imageMenuEl` - \n\n  * `embedMenuEl` - \n\n  * `specialCharsEl` - \n\n  * `emojiPickerEl` - \n\n  * `insertMenuEl` - \n\n  * `mathPanelEl` - \n\n  * `markdownPanelEl` - \n\n  * `view` - \n\n  * `mentionMatch` {`SuggestionMatch | null`} - \n\n  * `slashMatch` {`SuggestionMatch | null`} - \n\n  * `emojiMatch` {`SuggestionMatch | null`} - \n\n  * `activeSuggestSource` {`\"mention\" | \"slash\" | \"emoji\" | null`} - \n\n  * `suggestDismissed` {`string | null`} - \n\n  * `mentionQueryToken` {`string`} - \n\n  * `autosaveTimer` - \n\n  * `lastAutosaveValue` {`string`} - \n\n  * `internals` - \n\n  * `defaultValue` {`string`} - \n\n  * `syncingValue` {`boolean`} - \n\n  * `changeTimer` - \n\n  * `pendingChange` {`boolean`} - \n\n  * `previousBodyOverflow` {`string | null`} - Body overflow value before fullscreen locked it; null = not locked.\n\n  * `painterDragActive` {`boolean`} - True while a drag-selection is in progress with the format painter armed.\nSuppresses the mid-drag auto-apply in {@link handleTransaction} so the\ncopied formatting lands on the final, complete selection (on mouse-up).\n\n  * `onPainterPointerDown` - \n\n  * `onPainterPointerUp` - \n\n  * `contentRoot` {`HTMLElement | null`} - The live, styled content element used as the source for exports.\n\n  * `pmView` - The underlying ProseMirror EditorView. Advanced escape hatch.\n\n  * `json` - Document as ProseMirror JSON.\n\n  * `override` - \n\n  * `floatingPanels` {`({ open: boolean; } | undefined)[]`} - The floating insert panels that should dismiss on outside interaction.\n\n  * `onOutsidePointerDown` - Closes any open insert panel when the pointer goes down outside of it —\nwhether elsewhere in the editor (e.g. the content area) or off the widget.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "value",
@@ -8286,9 +8286,37 @@
         }
       ]
     },
+    {
+      "name": "nile-wysiwyg-toolbar-item",
+      "description": "Declarative, light-DOM marker for a single toolbar control.\n\nAuthor these inside a `<nile-wysiwyg-toolbar>` container within a\n`<nile-wysiwyg-editor>` to build the toolbar by hand instead of (or in\naddition to) the `toolbar` config string:\n\n```html\n<nile-wysiwyg-editor>\n   <nile-wysiwyg-toolbar>\n     <nile-wysiwyg-toolbar-item name=\"bold\" label=\"Bold\"></nile-wysiwyg-toolbar-item>\n     <nile-wysiwyg-toolbar-item name=\"italic\"></nile-wysiwyg-toolbar-item>\n     <nile-wysiwyg-toolbar-item divider></nile-wysiwyg-toolbar-item>\n     <nile-wysiwyg-toolbar-item name=\"heading\"></nile-wysiwyg-toolbar-item>\n     <!-- goes into the 3-dot \"more\" menu, wherever it sits in the list -->\n     <nile-wysiwyg-toolbar-item name=\"sourceView\" overflow></nile-wysiwyg-toolbar-item>\n   </nile-wysiwyg-toolbar>\n</nile-wysiwyg-editor>\n```\n\nThe container is optional — items may also be direct children of the editor.\n\n`name` maps to a built-in control (the same keys the `toolbar` string\naccepts, e.g. `bold`, `italic`, `heading`, `textColor`, `table`). `label`\nand `icon` override that control's built-in tooltip/glyph; set `divider` to\ninsert a group separator, or `overflow` to tuck this control into the\ntoolbar's collapsible 3-dot \"more\" menu.\n\nThe element renders nothing itself — the editor discovers it and renders the\nreal control inside its own shadow DOM.\n\nAttributes:\n\n  * `name` {`string`} - Built-in control name — same keys accepted by the `toolbar` string.\n\n  * `label` {`string`} - Overrides the control's tooltip / accessible label.\n\n  * `icon` {`string`} - Overrides the control's glyph (a `nile-glyph` name).\n\n  * `divider` {`boolean`} - Renders a group divider instead of a control.\n\n  * `overflow` {`boolean`} - When set, this control is tucked into the toolbar's collapsible 3-dot\n\"more\" menu instead of the main bar — regardless of where it sits among\nthe items.\n\nProperties:\n\n  * `name` {`string`} - Built-in control name — same keys accepted by the `toolbar` string.\n\n  * `label` {`string`} - Overrides the control's tooltip / accessible label.\n\n  * `icon` {`string`} - Overrides the control's glyph (a `nile-glyph` name).\n\n  * `divider` {`boolean`} - Renders a group divider instead of a control.\n\n  * `overflow` {`boolean`} - When set, this control is tucked into the toolbar's collapsible 3-dot\n\"more\" menu instead of the main bar — regardless of where it sits among\nthe items.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "`name` {`string`} - Built-in control name — same keys accepted by the `toolbar` string.\n\nProperty: name\n\nDefault: "
+        },
+        {
+          "name": "label",
+          "description": "`label` {`string`} - Overrides the control's tooltip / accessible label.\n\nProperty: label\n\nDefault: "
+        },
+        {
+          "name": "icon",
+          "description": "`icon` {`string`} - Overrides the control's glyph (a `nile-glyph` name).\n\nProperty: icon\n\nDefault: "
+        },
+        {
+          "name": "divider",
+          "description": "`divider` {`boolean`} - Renders a group divider instead of a control.\n\nProperty: divider\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "overflow",
+          "description": "`overflow` {`boolean`} - When set, this control is tucked into the toolbar's collapsible 3-dot\n\"more\" menu instead of the main bar — regardless of where it sits among\nthe items.\n\nProperty: overflow\n\nDefault: false",
+          "valueSet": "v"
+        }
+      ]
+    },
     {
       "name": "nile-wysiwyg-toolbar",
-      "description": "Config-driven toolbar. Renders from a single immutable ToolbarState\nsnapshot; every interaction is dispatched to the host as a\n`wysiwyg-command` event — the toolbar never touches the editor directly.\n\nAttributes:\n\n  * `config` {`string`} - Space-separated item names; `|` inserts a divider.\n\n  * `disabled` {`boolean`} - \n\nProperties:\n\n  * `config` {`string`} - Space-separated item names; `|` inserts a divider.\n\n  * `disabled` {`boolean`} - \n\n  * `toolbarState` {`ToolbarState | undefined`} - \n\n  * `openMenu` {`string | null`} - Which dropdown/color panel is open (item name), if any.\n\n  * `recentColors` - Recently used colors per color command, like nile-rte-color.\n\n  * `handleOutsideClick` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Config-driven toolbar. Renders from a single immutable ToolbarState\nsnapshot; every interaction is dispatched to the host as a\n`wysiwyg-command` event — the toolbar never touches the editor directly.\n\nAttributes:\n\n  * `config` {`string`} - Space-separated item names; `|` inserts a divider.\n\n  * `disabled` {`boolean`} - \n\nProperties:\n\n  * `config` {`string`} - Space-separated item names; `|` inserts a divider.\n\n  * `items` {`AuthoredToolbarItem[] | undefined`} - Structured item list authored in light DOM (from\n`<nile-wysiwyg-toolbar-item>` children). When set and non-empty it takes\nprecedence over `config`, and each item may override the built-in\nlabel/icon.\n\n  * `disabled` {`boolean`} - \n\n  * `toolbarState` {`ToolbarState | undefined`} - \n\n  * `openMenu` {`string | null`} - Which dropdown/color panel is open (item name), if any.\n\n  * `overflowOpen` {`boolean`} - Whether the overflow (\"more\" / 3-dot) menu panel is open.\n\n  * `isAuthoringContainer` {`boolean`} - True when this instance is an author's declarative `<nile-wysiwyg-toolbar>`\ncontainer sitting in an editor's light DOM (holding\n`<nile-wysiwyg-toolbar-item>` children). Such an instance renders nothing\nand wires up no listeners — the editor reads the items and renders the real\ntoolbar in its own shadow DOM. The editor's internal instance lives inside\na shadow root, so `closest` (which stops at shadow boundaries) never\nmatches it; a standalone toolbar on a page has no editor ancestor either.\n\n  * `handleOutsideClick` - \n\n  * `toggleOverflow` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "config",
@@ -8312,9 +8340,32 @@
         }
       ]
     },
+    {
+      "name": "nile-wysiwyg-bubble-item",
+      "description": "Declarative, light-DOM marker for a single selection bubble-menu control.\n\nAuthor these as children of `<nile-wysiwyg-editor>` to build the bubble menu\nshown over a text selection by hand, instead of the built-in five\n(bold / italic / underline / strike / link) — the same pattern as\n`<nile-wysiwyg-toolbar-item>`:\n\n```html\n<nile-wysiwyg-editor bubble-menu>\n   <nile-wysiwyg-bubble-item name=\"bold\"></nile-wysiwyg-bubble-item>\n   <nile-wysiwyg-bubble-item name=\"italic\"></nile-wysiwyg-bubble-item>\n   <nile-wysiwyg-bubble-item divider></nile-wysiwyg-bubble-item>\n   <nile-wysiwyg-bubble-item name=\"link\" label=\"Add link\"></nile-wysiwyg-bubble-item>\n</nile-wysiwyg-editor>\n```\n\n`name` maps to a built-in control (`bold`, `italic`, `underline`, `strike`,\n`code`, `subscript`, `superscript`, `link`, `bulletList`, `orderedList`,\n`alignLeft`, `alignCenter`, `alignRight`, `clearFormatting`). `label` and\n`icon` override the built-in tooltip/glyph; set `divider` for a separator.\n\nAny other `name` is dispatched as a raw `wysiwyg-command` (so custom editor\ncommands work) as long as an `icon` is supplied.\n\nThe element renders nothing itself — the editor discovers it and renders the\nreal control inside the bubble menu's shadow DOM.\n\nAttributes:\n\n  * `name` {`string`} - Built-in control name, or a raw command name when paired with `icon`.\n\n  * `label` {`string`} - Overrides the control's tooltip / accessible label.\n\n  * `icon` {`string`} - Overrides the control's glyph (a `nile-glyph` name).\n\n  * `divider` {`boolean`} - Renders a separator instead of a control.\n\nProperties:\n\n  * `name` {`string`} - Built-in control name, or a raw command name when paired with `icon`.\n\n  * `label` {`string`} - Overrides the control's tooltip / accessible label.\n\n  * `icon` {`string`} - Overrides the control's glyph (a `nile-glyph` name).\n\n  * `divider` {`boolean`} - Renders a separator instead of a control.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "`name` {`string`} - Built-in control name, or a raw command name when paired with `icon`.\n\nProperty: name\n\nDefault: "
+        },
+        {
+          "name": "label",
+          "description": "`label` {`string`} - Overrides the control's tooltip / accessible label.\n\nProperty: label\n\nDefault: "
+        },
+        {
+          "name": "icon",
+          "description": "`icon` {`string`} - Overrides the control's glyph (a `nile-glyph` name).\n\nProperty: icon\n\nDefault: "
+        },
+        {
+          "name": "divider",
+          "description": "`divider` {`boolean`} - Renders a separator instead of a control.\n\nProperty: divider\n\nDefault: false",
+          "valueSet": "v"
+        }
+      ]
+    },
     {
       "name": "nile-wysiwyg-bubble-menu",
-      "description": "Balloon toolbar shown over non-empty selections. The host owns positioning\n(absolute left/top) and visibility; commands bubble up as\n`wysiwyg-command` events, same contract as the main toolbar.\n\nAttributes:\n\n  * `open` {`boolean`} - \n\nProperties:\n\n  * `open` {`boolean`} - \n\n  * `toolbarState` {`ToolbarState | undefined`} - \n\n  * `items` {`BubbleItem[]`} - Same icon set as the main toolbar, so both surfaces look identical.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Balloon toolbar shown over non-empty selections. The host owns positioning\n(absolute left/top) and visibility; commands bubble up as\n`wysiwyg-command` events, same contract as the main toolbar.\n\nAttributes:\n\n  * `open` {`boolean`} - \n\nProperties:\n\n  * `open` {`boolean`} - \n\n  * `toolbarState` {`ToolbarState | undefined`} - \n\n  * `items` {`AuthoredToolbarItem[] | undefined`} - Structured item list authored in light DOM (from\n`<nile-wysiwyg-bubble-item>` children). `'|'` is a separator. Falls back to\n{@link DEFAULT_BUBBLE} when empty.\n\n  * `isAuthoringContainer` {`boolean`} - True when this instance is an author's declarative `<nile-wysiwyg-bubble-menu>`\ncontainer in an editor's light DOM (holding `<nile-wysiwyg-bubble-item>`\nchildren). It renders nothing — the editor reads the items and renders the\nreal bubble menu in its own shadow DOM. The editor's internal instance\nlives in a shadow root, so `closest` never matches it.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "open",
@@ -8352,7 +8403,7 @@
     },
     {
       "name": "nile-wysiwyg-embed-panel",
-      "description": "Floating embed-insert panel: paste a YouTube/Vimeo/Loom link. Styled to\nmatch the image panel (nile-input + nile-button). Emits\n`wysiwyg-embed-apply` detail: { src, provider } and `wysiwyg-embed-cancel`.\n\nAttributes:\n\n  * `open` {`boolean`} - \n\nProperties:\n\n  * `open` {`boolean`} - \n\n  * `urlValue` {`string`} - \n\n  * `error` {`string`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Floating embed-insert panel: paste any https:// link (YouTube/Vimeo/Loom\nare auto-formatted; anything else embeds as a sandboxed iframe). Styled to\nmatch the image panel (nile-input + nile-button). Emits\n`wysiwyg-embed-apply` detail: { src, provider } and `wysiwyg-embed-cancel`.\n\nAttributes:\n\n  * `open` {`boolean`} - \n\nProperties:\n\n  * `open` {`boolean`} - \n\n  * `urlValue` {`string`} - \n\n  * `error` {`string`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "open",
@@ -8497,6 +8548,16 @@
         }
       ]
     },
+    {
+      "name": "nile-wysiwyg-preview",
+      "description": "Renders sanitized document HTML inside its OWN shadow root. Any author\n`<style>` block in the content is therefore scoped to this element and\ncannot leak into the surrounding source-view / editor chrome (which lives in\na different shadow root). Reuses the editor's content styles so the render\nmatches the live editor. The content wrapper is an `<article>`, not a\n`<div>`, so a blanket `div { … }` rule doesn't paint the wrapper itself.\n\nAttributes:\n\n  * `content` {`string`} - Sanitized HTML to render (already run through sanitizeHtml).\n\nProperties:\n\n  * `content` {`string`} - Sanitized HTML to render (already run through sanitizeHtml).",
+      "attributes": [
+        {
+          "name": "content",
+          "description": "`content` {`string`} - Sanitized HTML to render (already run through sanitizeHtml).\n\nProperty: content\n\nDefault: "
+        }
+      ]
+    },
     {
       "name": "nile-wysiwyg-shortcut-help",
       "description": "Keyboard shortcut reference dialog, opened from the toolbar or Mod-/.\nEmits `wysiwyg-shortcut-help-close` when dismissed (Esc, ✕ or backdrop).\n\nAttributes:\n\n  * `open` {`boolean`} - \n\nProperties:\n\n  * `open` {`boolean`} - \n\n  * `panelEl` {`HTMLElement | undefined`} - \n\n  * `previousBodyOverflow` {`string | null`} - Body overflow value before we locked it; null = not locked by us.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
@@ -8510,7 +8571,7 @@
     },
     {
       "name": "nile-wysiwyg-source-view",
-      "description": "Raw HTML source editing mode. Replaces the rich surface while open; the\nhost re-parses (and re-sanitizes) the HTML on apply. Emits\n`wysiwyg-source-apply` detail: { html } and `wysiwyg-source-cancel`.\n\nAttributes:\n\n  * `value` {`string`} - \n\nProperties:\n\n  * `value` {`string`} - \n\n  * `textarea` {`HTMLTextAreaElement | undefined`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Raw HTML source editing mode. A split view: the raw HTML on the left, a\nlive rendered preview on the right, with a draggable divider between them\nand a resizable body. The preview runs the same sanitizer the host applies\non the way back, so what you see is what the document becomes. Emits\n`wysiwyg-source-apply` detail: { html } and `wysiwyg-source-cancel`.\n\nThe code pane is a lightweight editor: a real `<textarea>` for input, with a\nhighlight.js-coloured layer painted behind it and a synced line-number\ngutter. No heavyweight code-editor dependency.\n\nAttributes:\n\n  * `value` {`string`} - \n\nProperties:\n\n  * `value` {`string`} - \n\n  * `textarea` {`HTMLTextAreaElement | undefined`} - \n\n  * `highlightEl` {`HTMLElement | undefined`} - \n\n  * `linenosEl` {`HTMLElement | undefined`} - \n\n  * `bodyEl` {`HTMLElement | undefined`} - \n\n  * `draft` {`string`} - Current source text, drives the live preview, highlight and gutter.\n\n  * `splitRatio` {`number`} - Fraction of the body width given to the code pane (the rest is preview).\nClamped while dragging the divider.\n\n  * `splitDragging` {`boolean`} - Whether the divider is currently being dragged.\n\n  * `currentValue` {`string`} - The current (possibly edited) source text — what \"Done\" would apply.\n\n  * `highlighted` {`string`} - highlight.js-coloured HTML for the current draft (falls back to escaped).\n\n  * `lineCount` {`number`} - \n\n  * `startSplitDrag` - Begins a pointer-driven resize of the split divider.\n\n  * `resetSplit` - Resets the divider to a 50/50 layout (double-click affordance).\n\n  * `onInput` - \n\n  * `onScroll` - Keeps the highlight layer and line-number gutter aligned with scroll.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "value",
@@ -8542,12 +8603,20 @@
     },
     {
       "name": "nile-wysiwyg-table-picker",
-      "description": "Toolbar item: a table button that opens an N×M hover grid. Picking a cell\nemits `wysiwyg-command` with `insertTable { rows, cols }`.\n\nAttributes:\n\n  * `disabled` {`boolean`} - \n\nProperties:\n\n  * `disabled` {`boolean`} - \n\n  * `open` {`boolean`} - \n\n  * `hoverRows` {`number`} - \n\n  * `hoverCols` {`number`} - \n\n  * `handleOutside` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Toolbar item: a table button that opens a hover grid which auto-expands as\nthe pointer reaches the last row/column (up to `maxRows`×`maxCols`), plus a\n\"Custom\" rows×cols input for larger tables. Picking a cell or confirming the\ncustom size emits `wysiwyg-command` with `insertTable { rows, cols }`.\n\nAttributes:\n\n  * `disabled` {`boolean`} - \n\n  * `max-rows` {`number`} - Hard cap on the number of rows selectable via grid or custom input.\n\n  * `max-cols` {`number`} - Hard cap on the number of columns selectable via grid or custom input.\n\nProperties:\n\n  * `disabled` {`boolean`} - \n\n  * `maxRows` {`number`} - Hard cap on the number of rows selectable via grid or custom input.\n\n  * `maxCols` {`number`} - Hard cap on the number of columns selectable via grid or custom input.\n\n  * `open` {`boolean`} - \n\n  * `hoverRows` {`number`} - \n\n  * `hoverCols` {`number`} - \n\n  * `customRows` {`string`} - \n\n  * `customCols` {`string`} - \n\n  * `handleOutside` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "disabled",
           "description": "`disabled` {`boolean`} - \n\nProperty: disabled\n\nDefault: false",
           "valueSet": "v"
+        },
+        {
+          "name": "max-rows",
+          "description": "`max-rows` {`number`} - Hard cap on the number of rows selectable via grid or custom input.\n\nProperty: maxRows\n\nDefault: 20"
+        },
+        {
+          "name": "max-cols",
+          "description": "`max-cols` {`number`} - Hard cap on the number of columns selectable via grid or custom input.\n\nProperty: maxCols\n\nDefault: 20"
         }
       ]
     },