@wix/ricos 11.25.0 → 11.26.0

package/dist/es/wix-rich-content-common/statics/styles/general-scss.js

@@ -1,6 +1,6 @@
-var styleDataHash = "da8c162b";
+var styleDataHash = "6ec0ac92";
 const injectCss = (() => {
-  var css = `.Qk9L-{margin-left:0;margin-right:auto;z-index:1}.Qk9L-:not(._2C6c6){float:left;margin-right:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){.Qk9L-:not(._2C6c6){float:none;margin-right:auto}}}@container (width < 480px){.Qk9L-:not(._2C6c6):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-right:auto}}@media (width < 480px){.Qk9L-:not(._2C6c6):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) .Qk9L-:not(._2C6c6){float:none;margin-right:auto}}._1UeUw{margin-left:auto;margin-right:0;z-index:1}._1UeUw:not(._2C6c6){float:right;margin-left:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){._1UeUw:not(._2C6c6){float:none;margin-left:auto}}}@container (width < 480px){._1UeUw:not(._2C6c6):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-left:auto}}@media (width < 480px){._1UeUw:not(._2C6c6):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) ._1UeUw:not(._2C6c6){float:none;margin-left:auto}}.eyxld{clear:both;display:block}.eyxld:not(.-kjEW){margin-left:auto;margin-right:auto;max-width:100%}.-kjEW,._2C6c6{width:100%}._19nSg .-kjEW,._19nSg ._2C6c6{margin:0 -8px;width:auto}.AVGWu{width:fit-content}.KJrtX{margin-left:auto;margin-right:auto;max-width:100%}.XGWTv{width:min(350px,100%)!important}._19nSg .XGWTv{width:50%}.McgkN{margin-left:auto;margin-right:auto}._19nSg .McgkN{width:150px}.zaqww{display:flex}`;
+  var css = `.zaJGW{margin-left:0;margin-right:auto;z-index:1}.zaJGW:not(.ARgtz){float:left;margin-right:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){.zaJGW:not(.ARgtz){float:none;margin-right:auto}}}@container (width < 480px){.zaJGW:not(.ARgtz):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-right:auto}}@media (width < 480px){.zaJGW:not(.ARgtz):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) .zaJGW:not(.ARgtz){float:none;margin-right:auto}}.-hZ4R{margin-left:auto;margin-right:0;z-index:1}.-hZ4R:not(.ARgtz){float:right;margin-left:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){.-hZ4R:not(.ARgtz){float:none;margin-left:auto}}}@container (width < 480px){.-hZ4R:not(.ARgtz):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-left:auto}}@media (width < 480px){.-hZ4R:not(.ARgtz):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) .-hZ4R:not(.ARgtz){float:none;margin-left:auto}}.X-suL{clear:both;display:block}.X-suL:not(.WnrJQ){margin-left:auto;margin-right:auto;max-width:100%}.ARgtz,.WnrJQ{width:100%}.A75as .ARgtz,.A75as .WnrJQ{margin:0 -8px;width:auto}.VoXct{width:fit-content}.D2y37{margin-left:auto;margin-right:auto;max-width:100%}.Fqmhw{width:min(350px,100%)!important}.A75as .Fqmhw{width:50%}._4b5xz{margin-left:auto;margin-right:auto}.A75as ._4b5xz{width:150px}.OkPJP{display:flex}`;
   var isTest = typeof process !== "undefined" && process.env && false;
   if (isTest || !css || typeof document === "undefined") {
     return;
@@ -21,17 +21,17 @@ const injectCss = (() => {
 });
 injectCss();
 var general_default = {
-  "alignLeft": "Qk9L-",
-  "textWrapNowrap": "_2C6c6",
-  "alignRight": "_1UeUw",
-  "alignCenter": "eyxld",
-  "sizeFullWidth": "-kjEW",
-  "renderedInTable": "_19nSg",
-  "sizeOriginal": "AVGWu",
-  "sizeContent": "KJrtX",
-  "sizeSmall": "XGWTv",
-  "sizeSmallCenter": "McgkN",
-  "flex": "zaqww"
+  "alignLeft": "zaJGW",
+  "textWrapNowrap": "ARgtz",
+  "alignRight": "-hZ4R",
+  "alignCenter": "X-suL",
+  "sizeFullWidth": "WnrJQ",
+  "renderedInTable": "A75as",
+  "sizeOriginal": "VoXct",
+  "sizeContent": "D2y37",
+  "sizeSmall": "Fqmhw",
+  "sizeSmallCenter": "_4b5xz",
+  "flex": "OkPJP"
 };
 export {
   general_default as default,

package/dist/es/wix-rich-content-common/statics/styles/general-scss.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/wix-rich-content-common/statics/styles/general.scss"],
-  "sourcesContent": ["var styleDataHash = 'da8c162b';  \nexport const injectCss = (() => {\n  var css = `.Qk9L-{margin-left:0;margin-right:auto;z-index:1}.Qk9L-:not(._2C6c6){float:left;margin-right:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){.Qk9L-:not(._2C6c6){float:none;margin-right:auto}}}@container (width < 480px){.Qk9L-:not(._2C6c6):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-right:auto}}@media (width < 480px){.Qk9L-:not(._2C6c6):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) .Qk9L-:not(._2C6c6){float:none;margin-right:auto}}._1UeUw{margin-left:auto;margin-right:0;z-index:1}._1UeUw:not(._2C6c6){float:right;margin-left:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){._1UeUw:not(._2C6c6){float:none;margin-left:auto}}}@container (width < 480px){._1UeUw:not(._2C6c6):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-left:auto}}@media (width < 480px){._1UeUw:not(._2C6c6):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) ._1UeUw:not(._2C6c6){float:none;margin-left:auto}}.eyxld{clear:both;display:block}.eyxld:not(.-kjEW){margin-left:auto;margin-right:auto;max-width:100%}.-kjEW,._2C6c6{width:100%}._19nSg .-kjEW,._19nSg ._2C6c6{margin:0 -8px;width:auto}.AVGWu{width:fit-content}.KJrtX{margin-left:auto;margin-right:auto;max-width:100%}.XGWTv{width:min(350px,100%)!important}._19nSg .XGWTv{width:50%}.McgkN{margin-left:auto;margin-right:auto}._19nSg .McgkN{width:150px}.zaqww{display:flex}`;\n  var isTest = typeof process !== 'undefined' && process.env && process.env['NODE_ENV'] === 'test';\n\n  if (isTest || !css || typeof document === 'undefined') { return; }\n  if (document.querySelector('style[data-ricos-style-hash=\"' + styleDataHash + '\"]')) { return; }\n\n  var head = document.head || document.getElementsByTagName('head')[0];\n  var style = document.createElement('style');\n  style.setAttribute('data-ricos-style-hash', styleDataHash);\n  style.type = 'text/css';\n\n  head.appendChild(style);\n\n  if (style.styleSheet) {\n    style.styleSheet.cssText = css;\n  } else {\n    style.appendChild(document.createTextNode(css));\n  }\n});\n\ninjectCss();\n\n\n\nexport default {\n  \"alignLeft\": \"Qk9L-\",\n  \"textWrapNowrap\": \"_2C6c6\",\n  \"alignRight\": \"_1UeUw\",\n  \"alignCenter\": \"eyxld\",\n  \"sizeFullWidth\": \"-kjEW\",\n  \"renderedInTable\": \"_19nSg\",\n  \"sizeOriginal\": \"AVGWu\",\n  \"sizeContent\": \"KJrtX\",\n  \"sizeSmall\": \"XGWTv\",\n  \"sizeSmallCenter\": \"McgkN\",\n  \"flex\": \"zaqww\"\n};"],
+  "sourcesContent": ["var styleDataHash = '6ec0ac92';  \nexport const injectCss = (() => {\n  var css = `.zaJGW{margin-left:0;margin-right:auto;z-index:1}.zaJGW:not(.ARgtz){float:left;margin-right:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){.zaJGW:not(.ARgtz){float:none;margin-right:auto}}}@container (width < 480px){.zaJGW:not(.ARgtz):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-right:auto}}@media (width < 480px){.zaJGW:not(.ARgtz):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) .zaJGW:not(.ARgtz){float:none;margin-right:auto}}.-hZ4R{margin-left:auto;margin-right:0;z-index:1}.-hZ4R:not(.ARgtz){float:right;margin-left:40px}@supports not (contain:inline-size){@media only screen and (max-width:480px){.-hZ4R:not(.ARgtz){float:none;margin-left:auto}}}@container (width < 480px){.-hZ4R:not(.ARgtz):where(:not([data-ricos-responsive=viewport],[data-ricos-responsive=viewport] *)){float:none;margin-left:auto}}@media (width < 480px){.-hZ4R:not(.ARgtz):where([data-ricos-responsive=viewport]),:where([data-ricos-responsive=viewport]) .-hZ4R:not(.ARgtz){float:none;margin-left:auto}}.X-suL{clear:both;display:block}.X-suL:not(.WnrJQ){margin-left:auto;margin-right:auto;max-width:100%}.ARgtz,.WnrJQ{width:100%}.A75as .ARgtz,.A75as .WnrJQ{margin:0 -8px;width:auto}.VoXct{width:fit-content}.D2y37{margin-left:auto;margin-right:auto;max-width:100%}.Fqmhw{width:min(350px,100%)!important}.A75as .Fqmhw{width:50%}._4b5xz{margin-left:auto;margin-right:auto}.A75as ._4b5xz{width:150px}.OkPJP{display:flex}`;\n  var isTest = typeof process !== 'undefined' && process.env && process.env['NODE_ENV'] === 'test';\n\n  if (isTest || !css || typeof document === 'undefined') { return; }\n  if (document.querySelector('style[data-ricos-style-hash=\"' + styleDataHash + '\"]')) { return; }\n\n  var head = document.head || document.getElementsByTagName('head')[0];\n  var style = document.createElement('style');\n  style.setAttribute('data-ricos-style-hash', styleDataHash);\n  style.type = 'text/css';\n\n  head.appendChild(style);\n\n  if (style.styleSheet) {\n    style.styleSheet.cssText = css;\n  } else {\n    style.appendChild(document.createTextNode(css));\n  }\n});\n\ninjectCss();\n\n\n\nexport default {\n  \"alignLeft\": \"zaJGW\",\n  \"textWrapNowrap\": \"ARgtz\",\n  \"alignRight\": \"-hZ4R\",\n  \"alignCenter\": \"X-suL\",\n  \"sizeFullWidth\": \"WnrJQ\",\n  \"renderedInTable\": \"A75as\",\n  \"sizeOriginal\": \"VoXct\",\n  \"sizeContent\": \"D2y37\",\n  \"sizeSmall\": \"Fqmhw\",\n  \"sizeSmallCenter\": \"_4b5xz\",\n  \"flex\": \"OkPJP\"\n};"],
   "mappings": "AAAA,IAAI,gBAAgB;AACb,MAAM,aAAa,MAAM;AAC9B,MAAI,MAAM;AACV,MAAI,SAAS,OAAO,YAAY,eAAe,QAAQ,OAAO;AAE9D,MAAI,UAAU,CAAC,OAAO,OAAO,aAAa,aAAa;AAAE;AAAA,EAAQ;AACjE,MAAI,SAAS,cAAc,kCAAkC,gBAAgB,IAAI,GAAG;AAAE;AAAA,EAAQ;AAE9F,MAAI,OAAO,SAAS,QAAQ,SAAS,qBAAqB,MAAM,EAAE,CAAC;AACnE,MAAI,QAAQ,SAAS,cAAc,OAAO;AAC1C,QAAM,aAAa,yBAAyB,aAAa;AACzD,QAAM,OAAO;AAEb,OAAK,YAAY,KAAK;AAEtB,MAAI,MAAM,YAAY;AACpB,UAAM,WAAW,UAAU;AAAA,EAC7B,OAAO;AACL,UAAM,YAAY,SAAS,eAAe,GAAG,CAAC;AAAA,EAChD;AACF;AAEA,UAAU;AAIV,IAAO,kBAAQ;AAAA,EACb,aAAa;AAAA,EACb,kBAAkB;AAAA,EAClB,cAAc;AAAA,EACd,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,QAAQ;AACV;",
   "names": []
 }

package/dist/src/_shared/dropdown-modal/dropdown-modal.d.ts

@@ -7,6 +7,8 @@ type Props = {
     onCloseButtonClick: () => void;
     className?: string;
     dataHook?: string;
+    /** Pinned under the options, outside the scrolling listbox — e.g. a prompt input. */
+    footer?: React.ReactNode;
 };
 /**
  * The surface a ricos dropdown's rows are listed on: WDS `SidePanel` on mobile,

package/dist/src/_shared/get-all-plugin-testkits.d.ts

@@ -124,6 +124,11 @@ export declare const getAllPluginsTestkits: ({ getBase }: {
             waitForElement: () => Promise<void>;
             popover: import("./dropdown-modal/dropdown-modal-uni-driver").DropdownModalUniDriver;
         };
+        menu: {
+            waitForElement: () => Promise<void>;
+            popover: import("./dropdown-modal/dropdown-modal-uni-driver").DropdownModalUniDriver;
+            promptInput: ReturnType<typeof import("@wix/design-system/dist/testkit/unidriver").InputUniDriver>;
+        };
         integrations: {
             captionTrigger: {
                 button: ReturnType<typeof import("@wix/design-system/dist/testkit/unidriver").IconButtonUniDriver>;

package/dist/src/editor-common/Components/ricos-portal.d.ts

@@ -8,6 +8,8 @@ interface Props {
     children?: ReactNode;
     languageDir?: TextDirection;
     zIndex?: number;
+    /** Defaults to having one unless a `container` is given, the static toolbar's case. */
+    withTooltipHost?: boolean;
     environment?: React.ContextType<typeof RicosContext>['environment'];
 }
 export declare const RicosPortal: React.ForwardRefExoticComponent<Props & React.RefAttributes<HTMLDivElement>>;

package/dist/src/editor-common/consts.d.ts

@@ -38,6 +38,8 @@ export declare const FORMATTING_BUTTONS: Readonly<{
     ANIMATION: "ANIMATION";
 }>;
 export declare const INSERT_PLUGIN_BUTTONS: Readonly<InsertPluginButtons>;
+/** The AI plugin's footer "Create with AI" add button; `INSERT_PLUGIN_BUTTONS.AI` maps to it. */
+export declare const AI_CREATE_ADD_BUTTON_ID = "wix-rich-content-plugin-ai.create";
 export declare const BUTTON_TYPES: Readonly<{
     BUTTON: "button";
     FILE: "file";

package/dist/src/editor-common/index.d.ts

@@ -1,7 +1,7 @@
 import type { RichContent } from '@wix/ricos/schema';
 import * as browser from './browser.js';
 export { RicosPortal } from './Components/ricos-portal.js';
-export { BUTTON_TYPES, FORMATTING_BUTTONS, INSERT_PLUGIN_BUTTONS, RICOS_TIPTAP_EDITOR_DATA_HOOK, TOOLBARS, } from './consts.js';
+export { AI_CREATE_ADD_BUTTON_ID, BUTTON_TYPES, FORMATTING_BUTTONS, INSERT_PLUGIN_BUTTONS, RICOS_TIPTAP_EDITOR_DATA_HOOK, TOOLBARS, } from './consts.js';
 export { isiOS } from './Utils/is-ios.js';
 export { isTextSelection } from './Utils/tiptap/is-text-selection.js';
 export declare const getEmptyContent: () => RichContent;

package/dist/src/index.d.ts

@@ -206,9 +206,11 @@ export interface RicosEditorAPI {
     getEditorCommands(): PublicCommands;
     /** Returns the DOM element wrapping the editor's content-editable, if mounted. */
     getEditorContainer(): HTMLElement | undefined;
-    /** Opens a built-in modal (AI image generation, inline AI, keyboard shortcuts sheet, or AI widget). */
+    /** Opens a built-in modal (AI image generation, the AI menu, inline AI, keyboard shortcuts sheet, or AI widget). */
     openModal: (options: {
-        type: 'AI_IMAGE' | 'INLINE_AI' | 'SHORTCUTS_SHEET' | 'AI_WIDGET';
+        type: 'AI_IMAGE' | 'AI_MENU' | 'INLINE_AI' | 'SHORTCUTS_SHEET' | 'AI_WIDGET';
+        /** The element `AI_MENU` opens under, such as the host's own button. Defaults to the block at the cursor. */
+        referenceElement?: HTMLElement;
     }) => void;
     /**
      * Subscribe to the reactive button list for a toolbar. Re-runs on selection
@@ -459,6 +461,11 @@ export interface RicosEditorProps {
     autofocus?: FocusPosition;
     /** HTML element or factory function that returns the container element for rendering editor popovers and modals. */
     container?: HTMLElement | (() => HTMLElement | null);
+    /**
+     * The element the editor's popovers, menus and modals are rendered into, instead of `document.body`:
+     * a host's own layer, so they stack with its panels rather than over them.
+     */
+    portalContainer?: HTMLElement | (() => HTMLElement | null);
     /** Initial content for the editor. Only used during initialization — not a controlled value. */
     initialContent?: RicosDocument;
     /** Custom keyboard shortcuts to register with the editor. */
@@ -875,8 +882,10 @@ export { pluginAiSuggestions } from './plugin-ai-suggestions/options.js';
 export { pluginBlockDragHandle } from './plugin-block-drag-handle/options.js';
 export type { BlockDragHandlePluginEditorConfig } from './plugin-block-drag-handle/types.js';
 export { pluginCollab } from './plugin-collab/options.js';
+export type { PluginCollabOptions } from './plugin-collab/editor.js';
 export { pluginAi } from './plugin-ai/index.js';
 export type { AiGeneratedImage, AiImageGeneration } from './plugin-ai/types.js';
+export type { AiMenuAction, AiMenuConfig, AiMenuContext, AiMenuItem, AiMenuMode, AiMenuPromptSubmitResult, AiMenuSubmenu, } from './plugin-ai/index.js';
 /** The available audio source button types for the toolbar insert menu. */
 export { audioButtonsTypes } from './plugin-audio/index.js';
 /** Audio source button type: `'audio'` (file upload), `'soundCloud'`, or `'spotify'`. */

package/dist/src/legacy.d.ts

@@ -2,6 +2,7 @@ export { pluginAiSuggestions } from './plugin-ai-suggestions/options.js';
 export { pluginBlockDragHandle } from './plugin-block-drag-handle/options.js';
 export type { BlockDragHandlePluginEditorConfig } from './plugin-block-drag-handle/types.js';
 export { pluginCollab } from './plugin-collab/options.js';
+export type { PluginCollabOptions } from './plugin-collab/editor.js';
 export { readYXmlFragment, writeYXmlFragment, patchYXmlFragment, type PatchYXmlFragmentResult, } from './plugin-collab/y-adapter.js';
 export { type BISettings } from './ricos-common/ricos-types.js';
 export { extractUoUParams } from './_shared/extract-uou-params.js';
@@ -65,6 +66,7 @@ export { RicosEditorApiContext, RicosEditorApiProvider, useRicosEditorApi, withR
 export { BUTTON_TYPES, FORMATTING_BUTTONS, INSERT_PLUGIN_BUTTONS, } from './editor-common/index.js';
 export { pluginAi } from './plugin-ai/index.js';
 export type { AiGeneratedImage, AiImageGeneration } from './plugin-ai/types.js';
+export type { AiMenuAction, AiMenuConfig, AiMenuContext, AiMenuItem, AiMenuMode, AiMenuPromptSubmitResult, AiMenuSubmenu, } from './plugin-ai/index.js';
 export { pluginPaywallViewer } from './plugin-paywall/plugin-paywall-viewer.js';
 export { pluginPaywall, type PaywallPluginEditorConfig, type PaywallToolbarButton, type PaywallToolbarContext, } from './plugin-paywall/plugin-paywall.js';
 export { audioButtonsTypes, type AudioPluginEditorConfig, pluginAudio, } from './plugin-audio/index.js';

package/dist/src/plugin-ai/ai-menu-modal/ai-menu-modal.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { ModalService } from '../../ricos-modals/index.js';
+import type { TiptapEditor } from '../../ricos-types/index.js';
+import type { AiMenuMode, AiPluginEditorConfig, Prompt } from '../types.js';
+type AiMenuModalProps = {
+    mode: AiMenuMode;
+    config: AiPluginEditorConfig;
+    toggleAiContentModal: (editor: TiptapEditor, modalsService: ModalService, initialPrompt?: Prompt | string) => void;
+};
+/**
+ * The "Create with AI" / "Edit with AI" menu: host actions and prompts, with submenus, above an
+ * "Ask me anything…" input. Replaces the flow-selection and actions dropdowns when the plugin is
+ * configured with `menu`.
+ */
+export declare const AiMenuModal: React.FC<AiMenuModalProps>;
+export {};

package/dist/src/plugin-ai/ai-menu-modal/submenu-flyout.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+type SubmenuFlyoutProps = {
+    /** The translated submenu title, naming the list for assistive technology. */
+    label: string;
+    anchor: HTMLElement;
+    /** Moves focus to the flyout's first row once it is positioned (opened from the keyboard). */
+    autoFocus: boolean;
+    /** Closes the flyout from inside it: Escape or ArrowLeft, focus going back to `anchor`. */
+    onClose: () => void;
+    children: React.ReactNode;
+};
+/**
+ * A submenu's items, cascading to the side of the row that opened it while the menu stays put.
+ * Rendered inside the menu's own element so clicks in it are not clicks outside the menu.
+ */
+export declare const SubmenuFlyout: React.FC<SubmenuFlyoutProps>;
+export {};

package/dist/src/plugin-ai/data-hooks.d.ts

@@ -37,3 +37,10 @@ export declare const AI_IMAGE_MODAL_ACTION_INSERT = "ai-image-modal-action-inser
 export declare const AI_IMAGE_MODAL_IMAGE_STYLE = "ai-image-modal-image-style";
 export declare const AI_IMAGE_MODAL_PROMPT_HELPER_POPOVER = "ai-image-modal-prompt-helper-popover";
 export declare const AI_IMAGE_MODAL_PROMPT_HELPER_POPOVER_CLOSE = "ai-image-modal-prompt-helper-popover-close";
+export declare const AI_MENU_POPOVER = "ai-menu-popover";
+export declare const AI_MENU_PROMPT_INPUT = "ai-menu-prompt-input";
+export declare const AI_MENU_BACK = "ai-menu-back";
+export declare const AI_MENU_SUBMENU = "ai-menu-submenu";
+export declare const AI_MENU_PROMPT_SUBMIT = "ai-menu-prompt-submit";
+export declare const AI_FOOTER_BUTTON = "footer-button-ai";
+export declare const AI_SELECTION_BUTTON = "ai-selection-button";

package/dist/src/plugin-ai/index.d.ts

@@ -1 +1,2 @@
 export { pluginAi } from './options.js';
+export type { AiMenuAction, AiMenuConfig, AiMenuContext, AiMenuItem, AiMenuMode, AiMenuPromptSubmitResult, AiMenuSubmenu, } from './types.js';

package/dist/src/plugin-ai/selection-button/edit-with-ai-button.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ModalService } from '../../ricos-modals/index.js';
+type EditWithAiButtonProps = {
+    toggleEditMenu: (modalService: ModalService, referenceElement: HTMLElement) => void;
+};
+/**
+ * "Edit with AI", floating above a text selection. Opens the AI menu's `edit` mode anchored
+ * to itself, while the toolbar buttons stay on "Create with AI".
+ */
+export declare const EditWithAiButton: React.FC<EditWithAiButtonProps>;
+export {};

package/dist/src/plugin-ai/testkit.d.ts

@@ -1,4 +1,4 @@
-import { ButtonUniDriver, CloseButtonUniDriver, IconButtonUniDriver, InputAreaUniDriver, ListItemActionUniDriver, MessageModalLayoutUniDriver, PopoverMenuUniDriver, PopoverUniDriver, TextButtonUniDriver } from '@wix/design-system/dist/testkit/unidriver.js';
+import { ButtonUniDriver, CloseButtonUniDriver, IconButtonUniDriver, InputAreaUniDriver, InputUniDriver, ListItemActionUniDriver, MessageModalLayoutUniDriver, PopoverMenuUniDriver, PopoverUniDriver, TextButtonUniDriver } from '@wix/design-system/dist/testkit/unidriver.js';
 import type { Testkit, UniDriver } from '../ricos-types/testkit.js';
 import { type DropdownModalUniDriver } from '../_shared/dropdown-modal/dropdown-modal-uni-driver.js';
 export type AiTestkit = Testkit<{
@@ -90,6 +90,12 @@ export type AiTestkit = Testkit<{
         waitForElement: () => Promise<void>;
         popover: DropdownModalUniDriver;
     };
+    /** The "Create with AI" / "Edit with AI" menu, opened when the plugin is configured with `menu`. */
+    menu: {
+        waitForElement: () => Promise<void>;
+        popover: DropdownModalUniDriver;
+        promptInput: ReturnType<typeof InputUniDriver>;
+    };
     integrations: {
         captionTrigger: {
             button: ReturnType<typeof IconButtonUniDriver>;

package/dist/src/plugin-ai/toolbar/ai-toolbar-button.d.ts

@@ -2,4 +2,6 @@ import React from 'react';
 import type { ToolbarItemProps } from '../../toolbars-v3/types.js';
 export declare const AiToolbarButton: React.FC<ToolbarItemProps & {
     showLabel?: boolean;
+    /** Overrides the label's translation key, e.g. "Create with AI" for the AI menu. */
+    labelKey?: string;
 }>;

package/dist/src/plugin-ai/toolbar/toolbar-button-small.d.ts

@@ -3,4 +3,6 @@ import type { TFunction } from '../../ricos-types/common-types.js';
 export declare const ToolbarButtonSmall: React.FC<{
     showLabel: boolean;
     t: TFunction;
+    /** Overrides the label's translation key, e.g. for the "Create with AI" / "Edit with AI" menu. */
+    labelKey?: string;
 }>;

package/dist/src/plugin-ai/types.d.ts

@@ -1,5 +1,6 @@
 import type { IconComponent } from '@wix/wix-ui-icons-common/core';
 import type { ModalService } from '../ricos-modals/index.js';
+import type { RicosDocument } from '../ricos-schema/next-schema/index.js';
 import type { EditorPluginConfig } from '../ricos-types/index.js';
 import type { JSONContent } from '../tiptap/core/index';
 import type { ImageStyle } from './ai-image-modal/slice/types.js';
@@ -10,6 +11,7 @@ export declare const AI_DISCARD_MODAL_ID = "wix-rich-content-plugin-ai.discardMo
 export declare const AI_ACTIONS_MODAL_ID = "wix-rich-content-plugin-ai.actionsModal";
 export declare const AI_FLOW_SELECTION_MODAL_ID = "wix-rich-content-plugin-ai.flowSelectionModal";
 export declare const AI_IMAGE_MODAL_ID = "wix-rich-content-plugin-ai.imageModal";
+export declare const AI_MENU_MODAL_ID = "wix-rich-content-plugin-ai.menuModal";
 export type AiGeneratedImage = {
     url: string;
     id: string;
@@ -29,7 +31,20 @@ export type AiImageGeneration = {
 export interface AiPluginEditorConfig extends EditorPluginConfig {
     type: 'ai';
     configurePrompts?: (prompts: PromptsConfiguration) => PromptsConfiguration;
+    /**
+     * @deprecated Pass `menu` and configure `menu.createItems` instead.
+     */
     configureFlowSelectionItems?: (items: FlowSelectionItem[]) => FlowSelectionItem[];
+    /**
+     * Opts into the AI menu: host actions and prompts above an "Ask me anything…" input. The
+     * toolbar button (and, with `footerButton`, the footer toolbar) opens it as "Create with AI",
+     * as does `openModal({ type: 'AI_MENU' })` on the editor's ref;
+     * a button floating over a text selection opens it as "Edit with AI" and replaces the
+     * sparkle side button. The plugin's own AI quick actions are left out, as the menu's items
+     * are all the host's. Without it the plugin keeps its previous dropdowns, side button and
+     * quick actions.
+     */
+    menu?: AiMenuConfig;
     getGatewayBaseUrl?: () => string;
     appDefId?: string;
     enableImageCaptionExport?: boolean;
@@ -73,6 +88,59 @@ export type Divider = {
     type: 'divider';
 };
 export type FlowSelectionItem = Prompt | Section | FlowAction | Divider;
+/** `create` when there is nothing under the cursor to work on, `edit` when there is. */
+export type AiMenuMode = 'create' | 'edit';
+export type AiMenuContext = {
+    mode: AiMenuMode;
+    /** The selection the menu was opened over, empty in `create` mode. */
+    selection: RicosDocument;
+    /** `selection` as attribute-free HTML, e.g. to pass to a prompt. */
+    selectionHtml: string;
+    selectionText: string;
+};
+export type AiMenuAction = {
+    type: 'action';
+    title: string;
+    icon?: IconComponent;
+    dataHook?: string;
+    onClick: (context: AiMenuContext) => void;
+};
+/**
+ * A row that opens its own list of items, e.g. "Change tone": in a flyout beside the menu on
+ * desktop, in place of the menu's rows on mobile.
+ */
+export type AiMenuSubmenu = {
+    type: 'submenu';
+    title: string;
+    icon?: IconComponent;
+    dataHook?: string;
+    items: AiMenuItem[];
+};
+export type AiMenuItem = Prompt | AiMenuAction | AiMenuSubmenu | Section | Divider;
+/**
+ * What the host does with a prompt typed into the menu's input: `stop` when it handled the
+ * prompt itself, `continue` to run it in the AI content modal.
+ */
+export type AiMenuPromptSubmitResult = 'continue' | 'stop';
+export type AiMenuConfig = {
+    /** Items of the "Create with AI" menu. Ricos adds none of its own. */
+    createItems?: AiMenuItem[];
+    /** Items of the "Edit with AI" menu, opened over a selection. Ricos adds none of its own. */
+    editItems?: AiMenuItem[];
+    onPromptSubmit?: (prompt: string, context: AiMenuContext) => AiMenuPromptSubmitResult;
+    /**
+     * Floats an "Edit with AI" button above a text selection, opening the `edit` menu.
+     *
+     * @default true
+     */
+    selectionButton?: boolean;
+    /**
+     * Adds a "Create with AI" button to the footer toolbar.
+     *
+     * @default false
+     */
+    footerButton?: boolean;
+};
 export type ResultAction = {
     name: string;
     type: 'action';
@@ -98,7 +166,8 @@ export type ResultEntry = {
 };
 export type Entry = RequestEntry | ResultEntry;
 export type InitialPromptOptions = {
-    prompt: Prompt;
+    /** A string is a free-text prompt, e.g. one typed into the AI menu's input. */
+    prompt: Prompt | string;
     placeholder?: string;
     emptyStateTitle?: string;
     emptyStateText?: string;

package/dist/src/plugin-ai-suggestions/suggestions-collab.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugin-ai-suggestions/use-suggestions-request.d.ts

@@ -1,6 +1,6 @@
 import type React from 'react';
 import type { Transaction } from '../tiptap/pm/state';
 import type { AiContentSuggestion, SuggestionsState } from './types.js';
-export declare const useSuggestionsRequest: (setState: React.Dispatch<React.SetStateAction<SuggestionsState>>) => ((tr: Transaction, allSuggestions: AiContentSuggestion[], requestId: string) => void) & {
+export declare const useSuggestionsRequest: (setState: React.Dispatch<React.SetStateAction<SuggestionsState>>, wait?: number) => ((tr: Transaction, allSuggestions: AiContentSuggestion[], requestId: string) => void) & {
     cancel: () => void;
 };

package/dist/src/plugin-collab/collab-undo-manager.d.ts

@@ -0,0 +1,3 @@
+import * as Y from 'yjs';
+import type { Schema } from '../tiptap/pm/model';
+export declare const buildCollabUndoManager: (fragment: Y.XmlFragment, getSchema: () => Schema | undefined, overrides?: Partial<ConstructorParameters<typeof Y.UndoManager>[1]>) => Y.UndoManager;

package/dist/src/plugin-collab/collab-undo-manager.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugin-collab/doc-attrs-sync.d.ts

@@ -0,0 +1,3 @@
+import type * as Y from 'yjs';
+import { Plugin } from '../tiptap/pm/state';
+export declare const createDocAttrsSyncPlugin: (docElement: Y.XmlElement) => Plugin;

package/dist/src/plugin-collab/doc-attrs-sync.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugin-collab/editor.d.ts

@@ -1,2 +1,9 @@
 import type { EditorPluginCreator } from '../ricos-types/index.js';
-export declare const pluginCollab: EditorPluginCreator;
+import type { CollaborationOptions } from '../tiptap/extension-collaboration/index';
+import type { PresenceOptions } from './presence.js';
+import type { CollabUndoEntry } from './undo-bridge.js';
+export type PluginCollabOptions = CollaborationOptions & {
+    pushToUndoStack?: (entry: CollabUndoEntry) => void;
+    cursors?: PresenceOptions;
+};
+export declare const pluginCollab: EditorPluginCreator<PluginCollabOptions>;

package/dist/src/plugin-collab/options.d.ts

@@ -1,3 +1,3 @@
 import type { EditorPluginOptions } from '../ricos-types/index.js';
-import type { CollaborationOptions } from '../tiptap/extension-collaboration/index';
-export declare const pluginCollab: (options?: CollaborationOptions) => EditorPluginOptions;
+import type { PluginCollabOptions } from './editor.js';
+export declare const pluginCollab: (options?: PluginCollabOptions) => EditorPluginOptions;

package/dist/src/plugin-collab/presence.d.ts

@@ -0,0 +1,13 @@
+import type { Awareness } from 'y-protocols/awareness';
+import { Plugin } from '../tiptap/pm/state';
+export type PresenceIdentity = {
+    name?: string;
+    color?: string;
+};
+export type PresenceOptions = {
+    awareness: Awareness;
+    user?: Required<PresenceIdentity>;
+    resolveUser?: (clientId: number) => PresenceIdentity | undefined;
+    subscribe?: (onChange: () => void) => (() => void) | void;
+};
+export declare const createPresencePlugins: ({ awareness, user, resolveUser, subscribe, }: PresenceOptions) => Plugin[];

package/dist/src/plugin-collab/presence.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugin-collab/undo-bridge.d.ts

@@ -0,0 +1,6 @@
+import { Plugin } from '../tiptap/pm/state';
+export type CollabUndoEntry = {
+    undo: () => void;
+    redo: () => void;
+};
+export declare const createUndoBridgePlugin: (pushToUndoStack: (entry: CollabUndoEntry) => void) => Plugin;

package/dist/src/plugin-collab/undo-bridge.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/plugin-collab/undo-repair.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/ricos-content/normalization/Fixtures/text-wrap-content-state-expected.d.ts

@@ -25,8 +25,8 @@ export declare const textWrapContentStateExpected: {
             key: number;
         }[];
         data: {
-            textAlignment?: undefined;
             dynamicStyles?: undefined;
+            textAlignment?: undefined;
         };
     })[];
     entityMap: {

package/dist/src/ricos-content/normalization/Fixtures/text-wrap-content-state.d.ts

@@ -25,8 +25,8 @@ export declare const textWrapContentState: {
             key: number;
         }[];
         data: {
-            dynamicStyles?: undefined;
             textAlignment?: undefined;
+            dynamicStyles?: undefined;
         };
     })[];
     entityMap: {

package/dist/src/ricos-orchestrator/ricos-editor.d.ts

@@ -19,6 +19,7 @@ type UploadTopics = [
 ];
 export declare class RicosEditor implements IRicosEditor, EventSource<Topics>, PolicySubscriber<UploadTopics>, EditorEventSource {
     private tiptapAdapter;
+    private firstEditPublished;
     id: string;
     constructor(editorProps: RicosEditorProps, services: Omit<RicosServices, 'editor' | 'zIndexService'>, isDebugMode: boolean | undefined, getToolbarStateSelectorContextValue: () => SelectorContextValue<ToolbarState>, getSelectionSelectorContextValue: () => SelectorContextValue<SelectionContextType>, getModalStateSelectorContextValue: () => SelectorContextValue<ModalState>, getPmContentSelectorContextValue: () => SelectorContextValue<PmContentContextType>, getInlineAiStateSelectorContextValue: () => SelectorContextValue<InlineAiContextType>);
     topicsToPublish: Topics;

package/dist/src/ricos-orchestrator/ricos-editor.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/ricos-schema/next-schema/version.d.ts

@@ -1 +1 @@
-export declare const RICOS_VERSION = "11.25.0";
+export declare const RICOS_VERSION = "11.26.0";

package/dist/src/ricos-styles/context/styles-context.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/ricos-styles/tests/test-cases.d.ts

@@ -9,24 +9,24 @@ export declare const decorations: ({
         background: string;
     };
 } | {
+    colorData?: {};
     italicData?: undefined;
     fontSizeData?: undefined;
-    colorData?: undefined;
     type: Decoration_Type;
     fontWeightValue: number;
 } | {
+    colorData?: {};
     fontWeightValue?: undefined;
     italicData?: undefined;
-    colorData?: undefined;
     type: Decoration_Type;
     fontSizeData: {
         unit: FontSizeData_fontType;
         value: number;
     };
 } | {
+    colorData?: {};
     fontWeightValue?: undefined;
     fontSizeData?: undefined;
-    colorData?: undefined;
     type: Decoration_Type;
     italicData: boolean;
 })[];
@@ -88,7 +88,7 @@ export declare const headingNode: {
                     foreground: string;
                 };
             } | {
-                colorData?: undefined;
+                colorData?: {};
                 type: string;
                 fontWeightValue: number;
             })[];
@@ -116,7 +116,7 @@ export declare const complexHeadingNode: {
         textData: {
             text: string;
             decorations: ({
-                colorData?: undefined;
+                colorData?: {};
                 type: string;
                 fontWeightValue: number;
             } | {

package/dist/src/ricos-types/editor-types.d.ts

@@ -61,7 +61,9 @@ type GetContentPromiseProps = {
     publishId?: string | undefined;
 } | undefined;
 export type OpenModalOptions = {
-    type: 'AI_IMAGE' | 'INLINE_AI' | 'SHORTCUTS_SHEET' | 'AI_WIDGET';
+    type: 'AI_IMAGE' | 'AI_MENU' | 'INLINE_AI' | 'SHORTCUTS_SHEET' | 'AI_WIDGET';
+    /** The element `AI_MENU` opens under, such as the host's own button. Defaults to the block at the cursor. */
+    referenceElement?: HTMLElement;
 };
 export interface RicosEditorAPI {
     focus(focusPosition?: FocusPosition): void;

package/dist/src/ricos-types/insert-plugin-buttons.d.ts

@@ -31,4 +31,5 @@ export type InsertPluginButtons = {
     LAYOUT: 'Layout_InsertButton';
     TOC: 'TocPlugin_InsertButton';
     SMART_BLOCK: 'SmartBlock_InsertButton_Label';
+    AI: 'AIPlugin_InsertButton';
 };

package/dist/src/ricos-types/next/editor-types.d.ts

@@ -57,7 +57,9 @@ type GetContentPromiseProps = {
     publishId?: string | undefined;
 } | undefined;
 export type OpenModalOptions = {
-    type: 'AI_IMAGE' | 'INLINE_AI' | 'SHORTCUTS_SHEET' | 'AI_WIDGET';
+    type: 'AI_IMAGE' | 'AI_MENU' | 'INLINE_AI' | 'SHORTCUTS_SHEET' | 'AI_WIDGET';
+    /** The element `AI_MENU` opens under, such as the host's own button. Defaults to the block at the cursor. */
+    referenceElement?: HTMLElement;
 };
 export interface RicosEditorAPI {
     focus(focusPosition?: FocusPosition): void;

package/dist/src/ricos-types/next/plugin-types.d.ts

@@ -81,6 +81,8 @@ export type AddButton = {
     shortcuts?: KeyboardShortcut[];
     /** The options this button's picker offers, when it opens one. */
     options?: PickerOption[];
+    /** Shows the translated `tooltip` as the button's visible label in the footer toolbar. */
+    showLabel?: boolean;
 };
 export type ToolbarButton<P = any> = ({
     id: string;

package/dist/src/ricos-types/next/ricos-types.d.ts

@@ -56,6 +56,11 @@ export interface EditorProps {
     onLoad?: (editor: any) => void;
     autofocus?: FocusPosition;
     container?: HTMLElement | (() => HTMLElement | null);
+    /**
+     * The element the editor's popovers, menus and modals are rendered into, instead of `document.body`:
+     * a host's own layer, so they stack with its panels rather than over them.
+     */
+    portalContainer?: HTMLElement | (() => HTMLElement | null);
     content?: RichContent;
     keyboardShortcuts?: CustomizableKeyboardShortcut[];
     /** The placeholder to be displayed while the editor is loading. */

package/dist/src/ricos-types/plugin-exports.d.ts

@@ -52,5 +52,7 @@ export type PluginExports = {
             }>;
         };
     };
-    modals?: Partial<Record<'AI_IMAGE' | 'INLINE_AI' | 'AI_WIDGET', (editor: TiptapEditor, services: PluginModalHandlerServices) => void>>;
+    modals?: Partial<Record<'AI_IMAGE' | 'AI_MENU' | 'INLINE_AI' | 'AI_WIDGET', (editor: TiptapEditor, services: PluginModalHandlerServices, options?: {
+        referenceElement?: HTMLElement;
+    }) => void>>;
 };