@atlaskit/editor-plugin-paste-options-toolbar 11.2.3 → 11.3.0

package/dist/types/ui/utils/paste-menu-rules/types.d.ts

@@ -60,14 +60,53 @@ export interface PasteMenuRuleFactories {
      * names appear in the ancestor list at the insertion point.
      */
     excludedAncestorRule: (excludedNames: string[]) => PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content contains more than
+     * one node type.
+     */
+    hideIfMixedNodesRule: PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content contains only a
+     * single node type.
+     */
+    hideIfSingleNodeRule: PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content IS a single
+     * standalone link (the inverse of `notSingleLinkRule`).
+     *
+     * Use this to hide buttons that should NOT appear for single-link pastes,
+     * e.g. Improve Writing, Fix Spelling — leaving only Ask Rovo visible.
+     */
+    isSingleLinkRule: PasteMenuRule;
+    /**
+     * Returns a rule that hides the button when the pasted plain-text is
+     * longer than `maxChars` characters.
+     */
+    maxCharsRule: (maxChars: number) => PasteMenuRule;
     /**
      * Returns a rule that hides the button when the pasted plain-text is
      * shorter than `minChars` characters.
      */
     minCharsRule: (minChars: number) => PasteMenuRule;
+    /**
+     * A rule that hides the button when the paste source is NOT an external
+     * application (i.e. the content was pasted from within the Fabric editor
+     * or renderer rather than from a third-party source).
+     */
+    notExternalPasteRule: PasteMenuRule;
     /**
      * A rule that hides the button when the pasted content is plain text
      * (i.e. not rich-text / prose).
      */
     notProseRule: PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content is a single
+     * standalone link — i.e. a bare URL link (text equals href) alone in a
+     * paragraph, or a single inline card (smartlink) alone in a paragraph.
+     *
+     * Returns `true` (hidden) when the paste is NOT a single link — e.g. a
+     * link with a custom label, a link with sibling text or nodes, or
+     * multiple paragraphs.
+     */
+    notSingleLinkRule: PasteMenuRule;
 }

package/dist/types-ts4.5/pasteOptionsToolbarPluginType.d.ts

@@ -2,6 +2,7 @@ import type { NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/t
 import type { AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { PastePlugin } from '@atlaskit/editor-plugin-paste';
 import type { UiControlRegistryPlugin } from '@atlaskit/editor-plugin-ui-control-registry';
+import type { RegisterComponent } from '@atlaskit/editor-ui-control-model';
 import type { ToolbarDropdownOption } from './types/types';
 import type { PasteMenuRuleFactories } from './ui/utils/paste-menu-rules/types';
 export type PasteOptionsToolbarPluginDependencies = [
@@ -35,6 +36,22 @@ export type PasteOptionsToolbarPlugin = NextEditorPlugin<'pasteOptionsToolbarPlu
     };
     dependencies: PasteOptionsToolbarPluginDependencies;
     pluginConfiguration?: {
+        /**
+         * Optional factory for composing product-specific paste menu buttons.
+         * Called with the pre-bound rule factories so products can compose
+         * `isHidden` callbacks before plugin setup.
+         *
+         * @example
+         * pasteMenuButtonsFactory: (rules) => [
+         *   {
+         *     type: 'menu-item',
+         *     key: 'my-product-button',
+         *     isHidden: rules.allRules(rules.notProseRule, rules.minCharsRule(100)),
+         *     component: () => <MyProductButton />,
+         *   },
+         * ]
+         */
+        pasteMenuButtonsFactory?: (rules: PasteMenuRuleFactories) => RegisterComponent[];
         usePopupBasedPasteActionsMenu?: boolean;
     };
     sharedState: PasteOptionsToolbarSharedState;

package/dist/types-ts4.5/ui/utils/paste-menu-rules/hasMixedNodes.d.ts

@@ -0,0 +1,10 @@
+import type { Slice } from '@atlaskit/editor-prosemirror/model';
+/**
+ * Returns true if the slice contains sibling block nodes of different types
+ * at the same level anywhere in the document tree.
+ *
+ * Structural container nodes (bulletList, orderedList, taskList, decisionList,
+ * table, tableRow) are excluded from the sibling check because their children
+ * are typed by structure, not content. All other container nodes are checked.
+ */
+export declare const hasMixedNodes: (slice: Slice | undefined) => boolean;

package/dist/types-ts4.5/ui/utils/paste-menu-rules/isNotSingleLink.d.ts

@@ -0,0 +1,17 @@
+import type { Slice } from '@atlaskit/editor-prosemirror/model';
+/**
+ * Returns `true` when the pasted content is NOT a single standalone link.
+ *
+ * A paste is considered a "single link" (returns `false`) when:
+ *  - The slice contains exactly one paragraph with one text node whose text
+ *    equals its `link` mark href (bare URL link, no custom label), OR
+ *  - The slice contains exactly one paragraph with a single `inlineCard` node
+ *    (smartlink from the renderer or editor).
+ *
+ * Returns `true` (not a single link) when:
+ *  - The pasted link has a custom label (text ≠ href)
+ *  - There are multiple paragraphs or sibling nodes
+ *  - There is additional text alongside the link in the same paragraph
+ *  - The slice is absent (plain-text paste)
+ */
+export declare const isNotSingleLink: (slice: Slice | undefined) => boolean;

package/dist/types-ts4.5/ui/utils/paste-menu-rules/types.d.ts

@@ -60,14 +60,53 @@ export interface PasteMenuRuleFactories {
      * names appear in the ancestor list at the insertion point.
      */
     excludedAncestorRule: (excludedNames: string[]) => PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content contains more than
+     * one node type.
+     */
+    hideIfMixedNodesRule: PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content contains only a
+     * single node type.
+     */
+    hideIfSingleNodeRule: PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content IS a single
+     * standalone link (the inverse of `notSingleLinkRule`).
+     *
+     * Use this to hide buttons that should NOT appear for single-link pastes,
+     * e.g. Improve Writing, Fix Spelling — leaving only Ask Rovo visible.
+     */
+    isSingleLinkRule: PasteMenuRule;
+    /**
+     * Returns a rule that hides the button when the pasted plain-text is
+     * longer than `maxChars` characters.
+     */
+    maxCharsRule: (maxChars: number) => PasteMenuRule;
     /**
      * Returns a rule that hides the button when the pasted plain-text is
      * shorter than `minChars` characters.
      */
     minCharsRule: (minChars: number) => PasteMenuRule;
+    /**
+     * A rule that hides the button when the paste source is NOT an external
+     * application (i.e. the content was pasted from within the Fabric editor
+     * or renderer rather than from a third-party source).
+     */
+    notExternalPasteRule: PasteMenuRule;
     /**
      * A rule that hides the button when the pasted content is plain text
      * (i.e. not rich-text / prose).
      */
     notProseRule: PasteMenuRule;
+    /**
+     * A rule that hides the button when the pasted content is a single
+     * standalone link — i.e. a bare URL link (text equals href) alone in a
+     * paragraph, or a single inline card (smartlink) alone in a paragraph.
+     *
+     * Returns `true` (hidden) when the paste is NOT a single link — e.g. a
+     * link with a custom label, a link with sibling text or nodes, or
+     * multiple paragraphs.
+     */
+    notSingleLinkRule: PasteMenuRule;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-paste-options-toolbar",
-	"version": "11.2.3",
+	"version": "11.3.0",
 	"description": "Paste options toolbar for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -37,25 +37,27 @@
 		"@atlaskit/editor-plugin-ui-control-registry": "^4.1.0",
 		"@atlaskit/editor-prosemirror": "^7.3.0",
 		"@atlaskit/editor-shared-styles": "^3.11.0",
-		"@atlaskit/editor-toolbar": "^1.6.0",
+		"@atlaskit/editor-toolbar": "^1.7.0",
 		"@atlaskit/editor-ui-control-model": "^1.2.0",
-		"@atlaskit/icon": "^35.0.0",
+		"@atlaskit/icon": "^35.1.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/primitives": "^19.0.0",
-		"@atlaskit/tmp-editor-statsig": "^82.0.0",
+		"@atlaskit/tmp-editor-statsig": "^83.0.0",
 		"@atlaskit/tokens": "^13.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.20.0",
 		"@emotion/react": "^11.7.1"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^114.36.0",
+		"@atlaskit/editor-common": "^114.46.0",
 		"react": "^18.2.0",
 		"react-dom": "^18.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"
 	},
 	"devDependencies": {
 		"@testing-library/react": "^16.3.0",
+		"react": "^18.2.0",
+		"react-dom": "^18.2.0",
 		"react-intl": "^6.6.2",
 		"wait-for-expect": "^1.2.0"
 	},