@plaudit/gutenberg-api-extensions 2.91.1 → 2.92.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.92.0] - 2026-04-13
+### Added
+- `InsertSiblingOrChildBlockShortcut` and `InsertSiblingOrChildBlockShortcutButton` React components
+- Support for `support.plaudit.insertSoleAllowedBlockShortcut`
+
 ## [2.91.1] - 2026-04-09
 ### Changed
 - Quick rename

package/dist/editor/insert-sibling-or-child-block-shortcut.d.ts

@@ -0,0 +1,12 @@
+import type { BlockName } from "@plaudit/gutenberg-api-extensions";
+type InsertSoleAllowedBlockShortcutProps = {
+    clientId: string;
+    targetBlockName: BlockName;
+    addedBlockName: BlockName;
+    isSelected: boolean;
+    props?: Record<string, unknown>;
+    buttonText?: string;
+};
+export declare const InsertSiblingOrChildBlockShortcut: import("react").MemoExoticComponent<(properties: InsertSoleAllowedBlockShortcutProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const InsertSiblingOrChildBlockShortcutButton: import("react").MemoExoticComponent<(properties: InsertSoleAllowedBlockShortcutProps) => import("react/jsx-runtime").JSX.Element | undefined>;
+export {};

package/dist/editor/insert-sibling-or-child-block-shortcut.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsertSiblingOrChildBlockShortcutButton = exports.InsertSiblingOrChildBlockShortcut = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const block_editor_1 = require("@wordpress/block-editor");
+const blocks_1 = require("@wordpress/blocks");
+const components_1 = require("@wordpress/components");
+const data_1 = require("@wordpress/data");
+const i18n_1 = require("@wordpress/i18n");
+const react_1 = require("react");
+const emptyProps = {};
+exports.InsertSiblingOrChildBlockShortcut = (0, react_1.memo)(function InsertSiblingOrChildBlockShortcut(properties) {
+    return (0, jsx_runtime_1.jsx)(block_editor_1.BlockControls, { group: "other", children: (0, jsx_runtime_1.jsx)(components_1.ToolbarGroup, { children: (0, jsx_runtime_1.jsx)(exports.InsertSiblingOrChildBlockShortcutButton, { ...properties }) }) });
+});
+exports.InsertSiblingOrChildBlockShortcutButton = (0, react_1.memo)(function InsertSiblingOrChildBlockShortcutButton(properties) {
+    const { clientId, targetBlockName, addedBlockName, isSelected, props = emptyProps, buttonText = "Add {blockName}" } = properties;
+    const targetClientId = (0, data_1.useSelect)((select) => {
+        const blockEditorSelect = select(block_editor_1.store);
+        if (blockEditorSelect.getBlock(clientId)?.name === targetBlockName) {
+            return clientId;
+        }
+        return blockEditorSelect.getBlockParentsByBlockName(clientId, targetBlockName, true)[0];
+    }, [clientId, targetBlockName]);
+    if ((0, block_editor_1.useBlockEditingMode)() === "contentOnly" || !isSelected || !targetClientId) {
+        return;
+    }
+    const buttonChildren = (0, i18n_1.__)(buttonText).replaceAll("{blockName}", (0, data_1.select)(blocks_1.store).getBlockType(addedBlockName)?.title ?? (0, i18n_1.__)(`${clientId === targetClientId ? "child" : "sibling"} block`));
+    return ((0, jsx_runtime_1.jsx)(components_1.ToolbarButton, { onClick: () => {
+            let insertionIndex;
+            const blockEditorSelect = (0, data_1.select)(block_editor_1.store);
+            if (clientId && clientId !== targetClientId) {
+                const closestClients = blockEditorSelect.getBlockParents(clientId, true);
+                const targetIndex = closestClients.indexOf(targetClientId);
+                insertionIndex = blockEditorSelect.getBlockIndex(closestClients[targetIndex - 1] ?? clientId, targetClientId);
+            }
+            else {
+                insertionIndex = -1;
+            }
+            (0, data_1.dispatch)(block_editor_1.store).insertBlock((0, blocks_1.createBlock)(addedBlockName, props), insertionIndex > -1 ? insertionIndex + 1 : undefined, targetClientId);
+        }, children: buttonChildren }));
+});
+//# sourceMappingURL=insert-sibling-or-child-block-shortcut.js.map

package/dist/editor/insert-sibling-or-child-block-shortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-sibling-or-child-block-shortcut.js","sourceRoot":"","sources":["../../src/editor/insert-sibling-or-child-block-shortcut.tsx"],"names":[],"mappings":";;;;AAAA,0DAAsG;AACtG,8CAAoE;AACpE,sDAAkE;AAClE,0CAA4D;AAC5D,0CAAmC;AAInC,iCAA2B;AAE3B,MAAM,UAAU,GAA4B,EAAE,CAAC;AAWlC,QAAA,iCAAiC,GAAG,IAAA,YAAI,EAAC,SAAS,iCAAiC,CAAC,UAA+C;IAC/I,OAAO,uBAAC,4BAAa,IAAC,KAAK,EAAC,OAAO,YAClC,uBAAC,yBAAY,cACZ,uBAAC,+CAAuC,OAAK,UAAU,GAAI,GAC7C,GACA,CAAA;AACjB,CAAC,CAAC,CAAC;AAEU,QAAA,uCAAuC,GAAG,IAAA,YAAI,EAAC,SAAS,uCAAuC,CAAC,UAA+C;IAC3J,MAAM,EAAC,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,GAAG,UAAU,EAAE,UAAU,GAAG,iBAAiB,EAAC,GAAG,UAAU,CAAC;IAE/H,MAAM,cAAc,GAAG,IAAA,gBAAS,EAAC,CAAC,MAAM,EAAE,EAAE;QAC3C,MAAM,iBAAiB,GAAG,MAAM,CAAC,oBAAgB,CAAC,CAAC;QACnD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,KAAK,eAAe,EAAE,CAAC;YACpE,OAAO,QAAQ,CAAC;QACjB,CAAC;QACD,OAAO,iBAAiB,CAAC,0BAA0B,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;IAEhC,IAAI,IAAA,kCAAmB,GAAE,KAAK,aAAa,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/E,OAAO;IACR,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,SAAE,EAAC,UAAU,CAAC,CAAC,UAAU,CAAC,aAAa,EAAE,IAAA,aAAM,EAAC,cAAW,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,KAAK,IAAI,IAAA,SAAE,EAAC,GAAG,QAAQ,KAAK,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC;IAC7L,OAAO,CACN,uBAAC,0BAAa,IAAC,OAAO,EAAE,GAAG,EAAE;YAC5B,IAAI,cAAsB,CAAC;YAC3B,MAAM,iBAAiB,GAAG,IAAA,aAAM,EAAC,oBAAgB,CAAC,CAAC;YACnD,IAAI,QAAQ,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;gBAC7C,MAAM,cAAc,GAAG,iBAAiB,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACzE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;gBAC3D,cAAc,GAAG,iBAAiB,CAAC,aAAa,CAAC,cAAc,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC/G,CAAC;iBAAM,CAAC;gBACP,cAAc,GAAG,CAAC,CAAC,CAAC;YACrB,CAAC;YACD,IAAA,eAAQ,EAAC,oBAAgB,CAAC,CAAC,WAAW,CAAC,IAAA,oBAAW,EAAC,cAAc,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAClJ,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAI,CAC/B,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/editor/install-insert-sole-allowed-block-shortcut-support.d.ts

@@ -0,0 +1 @@
+export declare function installInsertSoleAllowedBlockShortcutSupport(): void;

package/dist/editor/install-insert-sole-allowed-block-shortcut-support.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installInsertSoleAllowedBlockShortcutSupport = installInsertSoleAllowedBlockShortcutSupport;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const block_editor_1 = require("@wordpress/block-editor");
+const compose_1 = require("@wordpress/compose");
+const data_1 = require("@wordpress/data");
+const hooks_1 = require("@wordpress/hooks");
+const insert_sibling_or_child_block_shortcut_1 = require("./insert-sibling-or-child-block-shortcut");
+function installInsertSoleAllowedBlockShortcutSupport() {
+    const namespace = 'plaudit/gutenberg-api-extensions/inject-insert-sole-allowed-block-support';
+    const blocksWithInsertSoleAllowedBlockShortcut = {};
+    const blocksThatMightBeAbleToInsertSiblings = {};
+    (0, hooks_1.addFilter)('blocks.registerBlockType', namespace, (atts) => {
+        if (atts.supports?.plaudit?.insertSoleAllowedBlockShortcut) {
+            const target = atts.allowedBlocks?.[0];
+            if (target) {
+                blocksWithInsertSoleAllowedBlockShortcut[atts.name] = target;
+                blocksThatMightBeAbleToInsertSiblings[target] = atts.name;
+            }
+        }
+        return atts;
+    }, 1_000 /* We have this run late to allow for dynamic injection of the supports flag */);
+    (0, hooks_1.addFilter)('editor.BlockEdit', namespace, (0, compose_1.createHigherOrderComponent)((BlockEdit) => {
+        return function InsertSoleAllowedBlockShortcutSupport(props) {
+            const potentialAddedBlockName = blocksWithInsertSoleAllowedBlockShortcut[props.name];
+            const toolbarItems = [];
+            if (potentialAddedBlockName) {
+                toolbarItems.push((0, jsx_runtime_1.jsx)(insert_sibling_or_child_block_shortcut_1.InsertSiblingOrChildBlockShortcut, { clientId: props.clientId, targetBlockName: props.name, addedBlockName: potentialAddedBlockName, isSelected: (0, data_1.select)(block_editor_1.store).getSelectedBlockClientId() === props.clientId }, "add-own-sole-allowed-block"));
+            }
+            const potentialTargetBlockName = blocksThatMightBeAbleToInsertSiblings[props.name];
+            if (potentialTargetBlockName) {
+                toolbarItems.push((0, jsx_runtime_1.jsx)(insert_sibling_or_child_block_shortcut_1.InsertSiblingOrChildBlockShortcut, { clientId: props.clientId, targetBlockName: potentialTargetBlockName, addedBlockName: props.name, isSelected: (0, data_1.select)(block_editor_1.store).getSelectedBlockClientId() === props.clientId }, "add-ancestor-sole-allowed-block"));
+            }
+            return (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(BlockEdit, { ...props }), " ", toolbarItems] });
+        };
+    }, 'plaudit/gutenberg-api-extensions/insert-sole-allowed-block-support'));
+}
+//# sourceMappingURL=install-insert-sole-allowed-block-shortcut-support.js.map

package/dist/editor/install-insert-sole-allowed-block-shortcut-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-insert-sole-allowed-block-shortcut-support.js","sourceRoot":"","sources":["../../src/editor/install-insert-sole-allowed-block-shortcut-support.tsx"],"names":[],"mappings":";;AAUA,oGAwCC;;AAlDD,0DAAoE;AACpE,gDAAgE;AAChE,0CAAyC;AACzC,4CAA6C;AAI7C,qGAA6F;AAG7F,SAAgB,4CAA4C;IAC3D,MAAM,SAAS,GAAG,2EAA2E,CAAC;IAC9F,MAAM,wCAAwC,GAA6C,EAAE,CAAC;IAC9F,MAAM,qCAAqC,GAAiC,EAAE,CAAC;IAC/E,IAAA,iBAAS,EAAC,0BAA0B,EAAE,SAAS,EAAE,CAAC,IAAwB,EAAE,EAAE;QAC7E,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,MAAM,EAAE,CAAC;gBACZ,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;gBAC7D,qCAAqC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YAC3D,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,EAAE,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAE1F,IAAA,iBAAS,EAAC,kBAAkB,EAAE,SAAS,EACtC,IAAA,oCAA0B,EAAC,CAAC,SAAkD,EAAE,EAAE;QACjF,OAAO,SAAS,qCAAqC,CAAC,KAA2B;YAChF,MAAM,uBAAuB,GAAG,wCAAwC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrF,MAAM,YAAY,GAAgB,EAAE,CAAC;YACrC,IAAI,uBAAuB,EAAE,CAAC;gBAC7B,YAAY,CAAC,IAAI,CAChB,uBAAC,0EAAiC,IACA,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,uBAAuB,EAC/H,UAAU,EAAE,IAAA,aAAM,EAAC,oBAAgB,CAAC,CAAC,wBAAwB,EAAE,KAAK,KAAK,CAAC,QAAQ,IAD9E,4BAA4B,CAE/B,CACF,CAAC;YACH,CAAC;YACD,MAAM,wBAAwB,GAAG,qCAAqC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,wBAAwB,EAAE,CAAC;gBAC9B,YAAY,CAAC,IAAI,CAChB,uBAAC,0EAAiC,IACK,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,wBAAwB,EAAE,cAAc,EAAE,KAAK,CAAC,IAAI,EACrI,UAAU,EAAE,IAAA,aAAM,EAAC,oBAAgB,CAAC,CAAC,wBAAwB,EAAE,KAAK,KAAK,CAAC,QAAQ,IAD9E,iCAAiC,CAEpC,CACF,CAAC;YACH,CAAC;YACD,OAAO,6DAAE,uBAAC,SAAS,OAAK,KAAK,GAAI,OAAE,YAAY,IAAI,CAAC;QACrD,CAAC,CAAC;IACH,CAAC,EAAE,oEAAoE,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { store as apiExtensionsStore } from "./lib/gutenberg-api-extensions-stat
 export * from "./blocks";
 export * from "./controls";
 export * from "./editor/simple-gutenberg-endpoints-api";
+export * from "./editor/insert-sibling-or-child-block-shortcut";
 export { TemporalLRUCache, useAdoptedStyleSheet } from "./lib/helpers";
 export * from "./lib/modified-fast-deep-equals";
 export * from "./lib/plaudit-icons";

package/dist/index.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.endpointsStore = exports.apiExtensionsStore = exports.SectionedCacheStore = exports.useAdoptedStyleSheet = exports.TemporalLRUCache = void 0;
 exports.installGutenbergExtensions = installGutenbergExtensions;
 const simple_native_property_impl_1 = require("./blocks/simple-native-property-impl");
+const install_insert_sole_allowed_block_shortcut_support_1 = require("./editor/install-insert-sole-allowed-block-shortcut-support");
 const simple_gutenberg_endpoints_impl_1 = require("./editor/simple-gutenberg-endpoints-impl");
 Object.defineProperty(exports, "endpointsStore", { enumerable: true, get: function () { return simple_gutenberg_endpoints_impl_1.store; } });
 const gutenberg_api_extensions_state_1 = require("./lib/gutenberg-api-extensions-state");
@@ -46,6 +47,7 @@ Object.defineProperty(exports, "apiExtensionsStore", { enumerable: true, get: fu
 __exportStar(require("./blocks"), exports);
 __exportStar(require("./controls"), exports);
 __exportStar(require("./editor/simple-gutenberg-endpoints-api"), exports);
+__exportStar(require("./editor/insert-sibling-or-child-block-shortcut"), exports);
 var helpers_1 = require("./lib/helpers");
 Object.defineProperty(exports, "TemporalLRUCache", { enumerable: true, get: function () { return helpers_1.TemporalLRUCache; } });
 Object.defineProperty(exports, "useAdoptedStyleSheet", { enumerable: true, get: function () { return helpers_1.useAdoptedStyleSheet; } });
@@ -59,6 +61,7 @@ function installGutenbergExtensions() {
         (0, gutenberg_api_extensions_state_1.registerStore)();
         (0, simple_native_property_impl_1.installSimpleNativePropertiesSupport)();
         (0, simple_gutenberg_endpoints_impl_1.installSimpleGutenbergApisSupport)();
+        (0, install_insert_sole_allowed_block_shortcut_support_1.installInsertSoleAllowedBlockShortcutSupport)();
     }
 }
 (function (installGutenbergExtensions) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,gEAOC;AAvBD,sFAA0F;AAC1F,8FAAoH;AAaxF,+FAbwB,uCAAc,OAaxB;AAZ1C,yFAAgG;AAYxF,mGAZwB,sCAAkB,OAYxB;AAV1B,2CAAyB;AACzB,6CAA2B;AAC3B,0EAAwD;AACxD,yCAAqE;AAA7D,2GAAA,gBAAgB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAC9C,kEAAgD;AAChD,sDAAoC;AACpC,mFAAmE;AACnE,iDAA+B;AAK/B,SAAgB,0BAA0B;IACzC,IAAI,CAAC,0BAA0B,CAAC,MAAM,EAAE,CAAC;QACxC,0BAA0B,CAAC,MAAM,GAAG,IAAI,CAAC;QACzC,IAAA,8CAAa,GAAE,CAAC;QAChB,IAAA,kEAAoC,GAAE,CAAC;QACvC,IAAA,mEAAiC,GAAE,CAAC;IACrC,CAAC;AACF,CAAC;AACD,WAAiB,0BAA0B;IAC/B,iCAAM,GAAY,KAAK,CAAC;AACpC,CAAC,EAFgB,0BAA0B,0CAA1B,0BAA0B,QAE1C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,gEAQC;AA1BD,sFAA0F;AAC1F,oIAAyH;AACzH,8FAAoH;AAcxF,+FAdwB,uCAAc,OAcxB;AAb1C,yFAAgG;AAaxF,mGAbwB,sCAAkB,OAaxB;AAX1B,2CAAyB;AACzB,6CAA2B;AAC3B,0EAAwD;AACxD,kFAAgE;AAChE,yCAAqE;AAA7D,2GAAA,gBAAgB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAC9C,kEAAgD;AAChD,sDAAoC;AACpC,mFAAmE;AACnE,iDAA+B;AAK/B,SAAgB,0BAA0B;IACzC,IAAI,CAAC,0BAA0B,CAAC,MAAM,EAAE,CAAC;QACxC,0BAA0B,CAAC,MAAM,GAAG,IAAI,CAAC;QACzC,IAAA,8CAAa,GAAE,CAAC;QAChB,IAAA,kEAAoC,GAAE,CAAC;QACvC,IAAA,mEAAiC,GAAE,CAAC;QACpC,IAAA,iGAA4C,GAAE,CAAC;IAChD,CAAC;AACF,CAAC;AACD,WAAiB,0BAA0B;IAC/B,iCAAM,GAAY,KAAK,CAAC;AACpC,CAAC,EAFgB,0BAA0B,0CAA1B,0BAA0B,QAE1C"}

package/dist/lib/useful-types.d.ts

@@ -47,6 +47,9 @@ export type RegisterBlockAttrs<T extends Record<string, any> = {}> = {
         group: any;
     } | BlockJsonNativePropsConfig | undefined;
     supports: BlockSupports & Record<Exclude<string, keyof BlockSupports>, any>;
+    allowedBlocks?: BlockName[];
+    ancestor?: BlockName[];
+    parent?: BlockName[];
 };
 export declare function isBlockJsonNativePropsConfig(thing: unknown): thing is BlockJsonNativePropsConfig;
 export type NonEmptyArray<T> = [T, ...T[]];

package/dist/lib/useful-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"useful-types.js","sourceRoot":"","sources":["../../src/lib/useful-types.ts"],"names":[],"mappings":";;AAiCA,oEAEC;AAGD,0CAEC;AAPD,SAAgB,4BAA4B,CAAC,KAAc;IAC1D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClG,CAAC;AAGD,SAAgB,eAAe,CAAI,GAAuB;IACzD,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"useful-types.js","sourceRoot":"","sources":["../../src/lib/useful-types.ts"],"names":[],"mappings":";;AAkCA,oEAEC;AAGD,0CAEC;AAPD,SAAgB,4BAA4B,CAAC,KAAc;IAC1D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClG,CAAC;AAGD,SAAgB,eAAe,CAAI,GAAuB;IACzD,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaudit/gutenberg-api-extensions",
-  "version": "2.91.1",
+  "version": "2.92.0",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
     "./dist",

package/src/editor/insert-sibling-or-child-block-shortcut.tsx

@@ -0,0 +1,60 @@
+import {BlockControls, store as blockEditorStore, useBlockEditingMode} from "@wordpress/block-editor";
+import {store as blocksStore, createBlock} from "@wordpress/blocks";
+import {ToolbarButton, ToolbarGroup} from "@wordpress/components";
+import {dispatch, select, useSelect} from "@wordpress/data";
+import {__} from "@wordpress/i18n";
+
+import type {BlockName} from "@plaudit/gutenberg-api-extensions";
+
+import {memo} from "react";
+
+const emptyProps: Record<string, unknown> = {};
+
+type InsertSoleAllowedBlockShortcutProps = {
+	clientId: string,
+	targetBlockName: BlockName,
+	addedBlockName: BlockName,
+	isSelected: boolean,
+	props?: Record<string, unknown>,
+	buttonText?: string
+};
+
+export const InsertSiblingOrChildBlockShortcut = memo(function InsertSiblingOrChildBlockShortcut(properties: InsertSoleAllowedBlockShortcutProps) {
+	return <BlockControls group="other">
+		<ToolbarGroup>
+			<InsertSiblingOrChildBlockShortcutButton {...properties} />
+		</ToolbarGroup>
+	</BlockControls>
+});
+
+export const InsertSiblingOrChildBlockShortcutButton = memo(function InsertSiblingOrChildBlockShortcutButton(properties: InsertSoleAllowedBlockShortcutProps) {
+	const {clientId, targetBlockName, addedBlockName, isSelected, props = emptyProps, buttonText = "Add {blockName}"} = properties;
+
+	const targetClientId = useSelect((select) => {
+		const blockEditorSelect = select(blockEditorStore);
+		if (blockEditorSelect.getBlock(clientId)?.name === targetBlockName) {
+			return clientId;
+		}
+		return blockEditorSelect.getBlockParentsByBlockName(clientId, targetBlockName, true)[0];
+	}, [clientId, targetBlockName]);
+
+	if (useBlockEditingMode() === "contentOnly" || !isSelected || !targetClientId) {
+		return;
+	}
+
+	const buttonChildren = __(buttonText).replaceAll("{blockName}", select(blocksStore).getBlockType(addedBlockName)?.title ?? __(`${clientId === targetClientId ? "child" : "sibling"} block`));
+	return (
+		<ToolbarButton onClick={() => {
+			let insertionIndex: number;
+			const blockEditorSelect = select(blockEditorStore);
+			if (clientId && clientId !== targetClientId) {
+				const closestClients = blockEditorSelect.getBlockParents(clientId, true);
+				const targetIndex = closestClients.indexOf(targetClientId);
+				insertionIndex = blockEditorSelect.getBlockIndex(closestClients[targetIndex - 1] ?? clientId, targetClientId);
+			} else {
+				insertionIndex = -1;
+			}
+			dispatch(blockEditorStore).insertBlock(createBlock(addedBlockName, props), insertionIndex > -1 ? insertionIndex + 1 : undefined, targetClientId);
+		}} children={buttonChildren} />
+	);
+});

package/src/editor/install-insert-sole-allowed-block-shortcut-support.tsx

@@ -0,0 +1,51 @@
+import { store as blockEditorStore } from "@wordpress/block-editor";
+import { createHigherOrderComponent } from "@wordpress/compose";
+import { select } from "@wordpress/data";
+import { addFilter } from "@wordpress/hooks";
+
+import type { FunctionComponent, ReactNode } from "react";
+
+import { InsertSiblingOrChildBlockShortcut } from "./insert-sibling-or-child-block-shortcut";
+import type { ActualBlockEditProps, BlockName, RegisterBlockAttrs } from "../lib/useful-types";
+
+export function installInsertSoleAllowedBlockShortcutSupport() {
+	const namespace = 'plaudit/gutenberg-api-extensions/inject-insert-sole-allowed-block-support';
+	const blocksWithInsertSoleAllowedBlockShortcut: Record<BlockName, BlockName | undefined> = {};
+	const blocksThatMightBeAbleToInsertSiblings: Record<BlockName, BlockName> = {};
+	addFilter('blocks.registerBlockType', namespace, (atts: RegisterBlockAttrs) => {
+		if (atts.supports?.plaudit?.insertSoleAllowedBlockShortcut) {
+			const target = atts.allowedBlocks?.[0];
+			if (target) {
+				blocksWithInsertSoleAllowedBlockShortcut[atts.name] = target;
+				blocksThatMightBeAbleToInsertSiblings[target] = atts.name;
+			}
+		}
+		return atts;
+	}, 1_000 /* We have this run late to allow for dynamic injection of the supports flag */);
+
+	addFilter('editor.BlockEdit', namespace,
+		createHigherOrderComponent((BlockEdit: FunctionComponent<ActualBlockEditProps>) => {
+			return function InsertSoleAllowedBlockShortcutSupport(props: ActualBlockEditProps) {
+				const potentialAddedBlockName = blocksWithInsertSoleAllowedBlockShortcut[props.name];
+				const toolbarItems: ReactNode[] = [];
+				if (potentialAddedBlockName) {
+					toolbarItems.push(
+						<InsertSiblingOrChildBlockShortcut
+							key="add-own-sole-allowed-block" clientId={props.clientId} targetBlockName={props.name} addedBlockName={potentialAddedBlockName}
+							isSelected={select(blockEditorStore).getSelectedBlockClientId() === props.clientId}
+						/>
+					);
+				}
+				const potentialTargetBlockName = blocksThatMightBeAbleToInsertSiblings[props.name];
+				if (potentialTargetBlockName) {
+					toolbarItems.push(
+						<InsertSiblingOrChildBlockShortcut
+							key="add-ancestor-sole-allowed-block" clientId={props.clientId} targetBlockName={potentialTargetBlockName} addedBlockName={props.name}
+							isSelected={select(blockEditorStore).getSelectedBlockClientId() === props.clientId}
+						/>
+					);
+				}
+				return <><BlockEdit {...props} /> {toolbarItems}</>;
+			};
+		}, 'plaudit/gutenberg-api-extensions/insert-sole-allowed-block-support'));
+}

package/src/index.ts

@@ -1,10 +1,12 @@
 import {installSimpleNativePropertiesSupport} from "./blocks/simple-native-property-impl";
+import {installInsertSoleAllowedBlockShortcutSupport} from "./editor/install-insert-sole-allowed-block-shortcut-support";
 import {installSimpleGutenbergApisSupport, store as endpointsStore} from "./editor/simple-gutenberg-endpoints-impl";
 import {registerStore, store as apiExtensionsStore} from "./lib/gutenberg-api-extensions-state";
 
 export * from "./blocks";
 export * from "./controls";
 export * from "./editor/simple-gutenberg-endpoints-api";
+export * from "./editor/insert-sibling-or-child-block-shortcut";
 export {TemporalLRUCache, useAdoptedStyleSheet} from "./lib/helpers";
 export * from "./lib/modified-fast-deep-equals";
 export * from "./lib/plaudit-icons";
@@ -20,6 +22,7 @@ export function installGutenbergExtensions() {
 		registerStore();
 		installSimpleNativePropertiesSupport();
 		installSimpleGutenbergApisSupport();
+		installInsertSoleAllowedBlockShortcutSupport();
 	}
 }
 export namespace installGutenbergExtensions {

package/src/lib/useful-types.ts

@@ -28,7 +28,8 @@ export type BlockJsonNativePropsConfig = {
 export type RegisterBlockAttrs<T extends Record<string, any> = {}> = {
 	name: BlockName, attributes: Block<T>['attributes'], usesContext?: string[],
 	plaudit?: "native"|boolean|{group: any}|BlockJsonNativePropsConfig|undefined,
-	supports: BlockSupports&Record<Exclude<string, keyof BlockSupports>, any>
+	supports: BlockSupports&Record<Exclude<string, keyof BlockSupports>, any>,
+	allowedBlocks?: BlockName[], ancestor?: BlockName[], parent?: BlockName[],
 };
 
 export function isBlockJsonNativePropsConfig(thing: unknown): thing is BlockJsonNativePropsConfig {