testomatio-editor-blocks 0.4.23 → 0.4.24

package/package/editor/blocks/step.d.ts

@@ -1,4 +1,13 @@
 export declare const isEmptyParagraph: (b: any) => boolean;
+/**
+ * Check whether a step or snippet can be inserted at / after the given block.
+ * Returns true only when walking backwards from `referenceBlockId` (skipping
+ * other steps, snippets, and empty paragraphs) reaches a heading whose text
+ * is "steps".
+ */
+export declare function canInsertStepOrSnippet(editor: {
+    document: any[];
+}, referenceBlockId: string): boolean;
 export declare const stepBlock: {
     config: {
         readonly type: "testStep";

package/package/editor/blocks/step.js

@@ -47,6 +47,36 @@ export const isEmptyParagraph = (b) => b.type === "paragraph" &&
     (!Array.isArray(b.content) ||
         b.content.length === 0 ||
         b.content.every((n) => { var _a; return n.type === "text" && !((_a = n.text) === null || _a === void 0 ? void 0 : _a.trim()); }));
+/**
+ * Check whether a step or snippet can be inserted at / after the given block.
+ * Returns true only when walking backwards from `referenceBlockId` (skipping
+ * other steps, snippets, and empty paragraphs) reaches a heading whose text
+ * is "steps".
+ */
+export function canInsertStepOrSnippet(editor, referenceBlockId) {
+    const allBlocks = editor.document;
+    const blockIndex = allBlocks.findIndex((b) => b.id === referenceBlockId);
+    if (blockIndex < 0)
+        return false;
+    for (let i = blockIndex; i >= 0; i--) {
+        const b = allBlocks[i];
+        if (b.type === "testStep" || b.type === "snippet" || isEmptyParagraph(b)) {
+            continue;
+        }
+        if (b.type === "heading") {
+            const text = (Array.isArray(b.content) ? b.content : [])
+                .filter((n) => n.type === "text")
+                .map((n) => { var _a; return (_a = n.text) !== null && _a !== void 0 ? _a : ""; })
+                .join("")
+                .trim()
+                .toLowerCase()
+                .replace(/[:\-–—]$/, "");
+            return text === "steps";
+        }
+        return false;
+    }
+    return false;
+}
 export const stepBlock = createReactBlockSpec({
     type: "testStep",
     content: "none",

package/package/editor/snippetAutocomplete.js

@@ -1,24 +1,31 @@
 import { useEffect, useState } from "react";
 let globalFetcher = null;
 let cachedSuggestions = [];
+let inflightPromise = null;
 export function setSnippetFetcher(fetcher) {
     globalFetcher = fetcher;
     cachedSuggestions = [];
+    inflightPromise = null;
 }
 export function useSnippetAutocomplete() {
     const [suggestions, setSuggestions] = useState(() => {
-        if (cachedSuggestions.length > 0) {
+        if (cachedSuggestions.length > 0)
             return cachedSuggestions;
-        }
-        if (globalFetcher) {
-            const result = globalFetcher();
-            if (!result || typeof result.then !== "function") {
-                const normalized = normalizeSnippetSuggestions(result);
-                cachedSuggestions = normalized;
-                return normalized;
+        if (!globalFetcher)
+            return [];
+        const result = globalFetcher();
+        if (result && typeof result.then === "function") {
+            if (!inflightPromise) {
+                inflightPromise = result
+                    .then((r) => normalizeSnippetSuggestions(r))
+                    .then((items) => { cachedSuggestions = items; inflightPromise = null; return items; })
+                    .catch((error) => { inflightPromise = null; console.error("Failed to fetch snippet suggestions", error); return []; });
             }
+            return [];
         }
-        return [];
+        const normalized = normalizeSnippetSuggestions(result);
+        cachedSuggestions = normalized;
+        return normalized;
     });
     useEffect(() => {
         if (suggestions.length > 0) {
@@ -28,15 +35,24 @@ export function useSnippetAutocomplete() {
             return;
         }
         let cancelled = false;
-        Promise.resolve(globalFetcher())
-            .then((result) => normalizeSnippetSuggestions(result))
-            .then((items) => {
-            if (cancelled)
-                return;
-            cachedSuggestions = items;
-            setSuggestions(items);
-        })
-            .catch((error) => console.error("Failed to fetch snippet suggestions", error));
+        if (!inflightPromise) {
+            inflightPromise = Promise.resolve(globalFetcher())
+                .then((result) => normalizeSnippetSuggestions(result))
+                .then((items) => {
+                cachedSuggestions = items;
+                inflightPromise = null;
+                return items;
+            })
+                .catch((error) => {
+                inflightPromise = null;
+                console.error("Failed to fetch snippet suggestions", error);
+                return [];
+            });
+        }
+        inflightPromise.then((items) => {
+            if (!cancelled)
+                setSuggestions(items);
+        });
         return () => {
             cancelled = true;
         };

package/package/editor/stepAutocomplete.js

@@ -1,24 +1,31 @@
 import { useEffect, useState } from "react";
 let globalFetcher = null;
 let cachedSuggestions = [];
+let inflightPromise = null;
 export function setStepsFetcher(fetcher) {
     globalFetcher = fetcher;
     cachedSuggestions = [];
+    inflightPromise = null;
 }
 export function useStepAutocomplete() {
     const [suggestions, setSuggestions] = useState(() => {
-        if (cachedSuggestions.length > 0) {
+        if (cachedSuggestions.length > 0)
             return cachedSuggestions;
-        }
-        if (globalFetcher) {
-            const result = globalFetcher();
-            if (!result || typeof result.then !== "function") {
-                const normalized = normalizeStepSuggestions(result);
-                cachedSuggestions = normalized;
-                return normalized;
+        if (!globalFetcher)
+            return [];
+        const result = globalFetcher();
+        if (result && typeof result.then === "function") {
+            if (!inflightPromise) {
+                inflightPromise = result
+                    .then((r) => normalizeStepSuggestions(r))
+                    .then((items) => { cachedSuggestions = items; inflightPromise = null; return items; })
+                    .catch((error) => { inflightPromise = null; console.error("Failed to fetch step suggestions", error); return []; });
             }
+            return [];
         }
-        return [];
+        const normalized = normalizeStepSuggestions(result);
+        cachedSuggestions = normalized;
+        return normalized;
     });
     useEffect(() => {
         if (suggestions.length > 0) {
@@ -28,15 +35,24 @@ export function useStepAutocomplete() {
             return;
         }
         let cancelled = false;
-        Promise.resolve(globalFetcher())
-            .then((result) => normalizeStepSuggestions(result))
-            .then((items) => {
-            if (cancelled)
-                return;
-            cachedSuggestions = items;
-            setSuggestions(items);
-        })
-            .catch((error) => console.error("Failed to fetch step suggestions", error));
+        if (!inflightPromise) {
+            inflightPromise = Promise.resolve(globalFetcher())
+                .then((result) => normalizeStepSuggestions(result))
+                .then((items) => {
+                cachedSuggestions = items;
+                inflightPromise = null;
+                return items;
+            })
+                .catch((error) => {
+                inflightPromise = null;
+                console.error("Failed to fetch step suggestions", error);
+                return [];
+            });
+        }
+        inflightPromise.then((items) => {
+            if (!cancelled)
+                setSuggestions(items);
+        });
         return () => {
             cancelled = true;
         };

package/package/styles.css

@@ -515,7 +515,6 @@ html.dark .bn-step-image-preview__content {
   display: flex;
   flex-direction: column;
   gap: 4px;
-  overflow: hidden;
 }
 
 .bn-teststep__horizontal-col .bn-step-field__top {
@@ -1212,6 +1211,12 @@ html.dark .bn-step-image-preview__content {
   border-radius: 999px;
   width: 1.35rem;
   height: 1.35rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  font-size: 0.85rem;
+  line-height: 1;
   background: var(--overlay-dark);
   color: var(--color-white);
   cursor: pointer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testomatio-editor-blocks",
-  "version": "0.4.23",
+  "version": "0.4.24",
   "description": "Custom BlockNote schema, markdown conversion helpers, and UI for Testomatio-style test cases and steps.",
   "type": "module",
   "main": "./package/index.js",

package/src/App.tsx

@@ -21,6 +21,7 @@ import { customSchema, type CustomEditor } from "./editor/customSchema";
 import { setStepsFetcher, type StepJsonApiDocument } from "./editor/stepAutocomplete";
 import { setSnippetFetcher, type SnippetJsonApiDocument } from "./editor/snippetAutocomplete";
 import { setImageUploadHandler } from "./editor/stepImageUpload";
+import { canInsertStepOrSnippet } from "./editor/blocks/step";
 import "./App.css";
 
 const focusStepField = (
@@ -333,7 +334,11 @@ function CustomSlashMenu() {
       },
     };
 
-    return filterSuggestionItems([...defaultItems, stepItem, snippetItem], query);
+    const cursorBlock = editor.getTextCursorPosition()?.block;
+    const canInsert = cursorBlock ? canInsertStepOrSnippet(editor, cursorBlock.id) : false;
+    const customItems = canInsert ? [stepItem, snippetItem] : [];
+
+    return filterSuggestionItems([...defaultItems, ...customItems], query);
   };
 
   return <SuggestionMenuController triggerCharacter="/" getItems={getItems} />;
@@ -519,7 +524,7 @@ function App() {
     const fallbackBlock = documentBlocks[documentBlocks.length - 1];
     const referenceId = selectedBlock?.id ?? fallbackBlock?.id;
 
-    if (!referenceId) {
+    if (!referenceId || !canInsertStepOrSnippet(editor, referenceId)) {
       return;
     }
 

package/src/editor/blocks/step.tsx

@@ -53,6 +53,40 @@ export const isEmptyParagraph = (b: any): boolean =>
     b.content.length === 0 ||
     b.content.every((n: any) => n.type === "text" && !n.text?.trim()));
 
+/**
+ * Check whether a step or snippet can be inserted at / after the given block.
+ * Returns true only when walking backwards from `referenceBlockId` (skipping
+ * other steps, snippets, and empty paragraphs) reaches a heading whose text
+ * is "steps".
+ */
+export function canInsertStepOrSnippet(
+  editor: { document: any[] },
+  referenceBlockId: string,
+): boolean {
+  const allBlocks = editor.document;
+  const blockIndex = allBlocks.findIndex((b: any) => b.id === referenceBlockId);
+  if (blockIndex < 0) return false;
+
+  for (let i = blockIndex; i >= 0; i--) {
+    const b = allBlocks[i];
+    if (b.type === "testStep" || b.type === "snippet" || isEmptyParagraph(b)) {
+      continue;
+    }
+    if (b.type === "heading") {
+      const text = (Array.isArray(b.content) ? b.content : [])
+        .filter((n: any) => n.type === "text")
+        .map((n: any) => n.text ?? "")
+        .join("")
+        .trim()
+        .toLowerCase()
+        .replace(/[:\-–—]$/, "");
+      return text === "steps";
+    }
+    return false;
+  }
+  return false;
+}
+
 export const stepBlock = createReactBlockSpec(
   {
     type: "testStep",

package/src/editor/snippetAutocomplete.ts

@@ -33,26 +33,31 @@ type SnippetInput = SnippetSuggestion[] | SnippetJsonApiDocument | SnippetJsonAp
 
 let globalFetcher: SnippetSuggestionsFetcher | null = null;
 let cachedSuggestions: SnippetSuggestion[] = [];
+let inflightPromise: Promise<SnippetSuggestion[]> | null = null;
 
 export function setSnippetFetcher(fetcher: SnippetSuggestionsFetcher | null) {
   globalFetcher = fetcher;
   cachedSuggestions = [];
+  inflightPromise = null;
 }
 
 export function useSnippetAutocomplete(): SnippetSuggestion[] {
   const [suggestions, setSuggestions] = useState<SnippetSuggestion[]>(() => {
-    if (cachedSuggestions.length > 0) {
-      return cachedSuggestions;
-    }
-    if (globalFetcher) {
-      const result = globalFetcher();
-      if (!result || typeof (result as Promise<unknown>).then !== "function") {
-        const normalized = normalizeSnippetSuggestions(result as SnippetInput);
-        cachedSuggestions = normalized;
-        return normalized;
+    if (cachedSuggestions.length > 0) return cachedSuggestions;
+    if (!globalFetcher) return [];
+    const result = globalFetcher();
+    if (result && typeof (result as Promise<unknown>).then === "function") {
+      if (!inflightPromise) {
+        inflightPromise = (result as Promise<SnippetInput>)
+          .then((r) => normalizeSnippetSuggestions(r))
+          .then((items) => { cachedSuggestions = items; inflightPromise = null; return items; })
+          .catch((error) => { inflightPromise = null; console.error("Failed to fetch snippet suggestions", error); return [] as SnippetSuggestion[]; });
       }
+      return [];
     }
-    return [];
+    const normalized = normalizeSnippetSuggestions(result as SnippetInput);
+    cachedSuggestions = normalized;
+    return normalized;
   });
 
   useEffect(() => {
@@ -64,14 +69,23 @@ export function useSnippetAutocomplete(): SnippetSuggestion[] {
     }
 
     let cancelled = false;
-    Promise.resolve(globalFetcher())
-      .then((result) => normalizeSnippetSuggestions(result))
-      .then((items) => {
-        if (cancelled) return;
-        cachedSuggestions = items;
-        setSuggestions(items);
-      })
-      .catch((error) => console.error("Failed to fetch snippet suggestions", error));
+    if (!inflightPromise) {
+      inflightPromise = Promise.resolve(globalFetcher())
+        .then((result) => normalizeSnippetSuggestions(result))
+        .then((items) => {
+          cachedSuggestions = items;
+          inflightPromise = null;
+          return items;
+        })
+        .catch((error) => {
+          inflightPromise = null;
+          console.error("Failed to fetch snippet suggestions", error);
+          return [] as SnippetSuggestion[];
+        });
+    }
+    inflightPromise.then((items) => {
+      if (!cancelled) setSuggestions(items);
+    });
 
     return () => {
       cancelled = true;

package/src/editor/stepAutocomplete.tsx

@@ -39,26 +39,31 @@ type StepInput = StepSuggestion[] | StepJsonApiDocument | StepJsonApiResource[]
 
 let globalFetcher: StepSuggestionsFetcher | null = null;
 let cachedSuggestions: StepSuggestion[] = [];
+let inflightPromise: Promise<StepSuggestion[]> | null = null;
 
 export function setStepsFetcher(fetcher: StepSuggestionsFetcher | null) {
   globalFetcher = fetcher;
   cachedSuggestions = [];
+  inflightPromise = null;
 }
 
 export function useStepAutocomplete(): StepSuggestion[] {
   const [suggestions, setSuggestions] = useState<StepSuggestion[]>(() => {
-    if (cachedSuggestions.length > 0) {
-      return cachedSuggestions;
-    }
-    if (globalFetcher) {
-      const result = globalFetcher();
-      if (!result || typeof (result as Promise<unknown>).then !== "function") {
-        const normalized = normalizeStepSuggestions(result as StepInput);
-        cachedSuggestions = normalized;
-        return normalized;
+    if (cachedSuggestions.length > 0) return cachedSuggestions;
+    if (!globalFetcher) return [];
+    const result = globalFetcher();
+    if (result && typeof (result as Promise<unknown>).then === "function") {
+      if (!inflightPromise) {
+        inflightPromise = (result as Promise<StepInput>)
+          .then((r) => normalizeStepSuggestions(r))
+          .then((items) => { cachedSuggestions = items; inflightPromise = null; return items; })
+          .catch((error) => { inflightPromise = null; console.error("Failed to fetch step suggestions", error); return [] as StepSuggestion[]; });
       }
+      return [];
     }
-    return [];
+    const normalized = normalizeStepSuggestions(result as StepInput);
+    cachedSuggestions = normalized;
+    return normalized;
   });
 
   useEffect(() => {
@@ -70,14 +75,23 @@ export function useStepAutocomplete(): StepSuggestion[] {
     }
 
     let cancelled = false;
-    Promise.resolve(globalFetcher())
-      .then((result) => normalizeStepSuggestions(result))
-      .then((items) => {
-        if (cancelled) return;
-        cachedSuggestions = items;
-        setSuggestions(items);
-      })
-      .catch((error) => console.error("Failed to fetch step suggestions", error));
+    if (!inflightPromise) {
+      inflightPromise = Promise.resolve(globalFetcher())
+        .then((result) => normalizeStepSuggestions(result))
+        .then((items) => {
+          cachedSuggestions = items;
+          inflightPromise = null;
+          return items;
+        })
+        .catch((error) => {
+          inflightPromise = null;
+          console.error("Failed to fetch step suggestions", error);
+          return [] as StepSuggestion[];
+        });
+    }
+    inflightPromise.then((items) => {
+      if (!cancelled) setSuggestions(items);
+    });
 
     return () => {
       cancelled = true;

package/src/editor/styles.css

@@ -515,7 +515,6 @@ html.dark .bn-step-image-preview__content {
   display: flex;
   flex-direction: column;
   gap: 4px;
-  overflow: hidden;
 }
 
 .bn-teststep__horizontal-col .bn-step-field__top {
@@ -1212,6 +1211,12 @@ html.dark .bn-step-image-preview__content {
   border-radius: 999px;
   width: 1.35rem;
   height: 1.35rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  font-size: 0.85rem;
+  line-height: 1;
   background: var(--overlay-dark);
   color: var(--color-white);
   cursor: pointer;