hazo_ui 6.7.0 → 6.8.0

package/CHANGE_LOG.md

@@ -5,6 +5,61 @@ 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.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v6.8.0 (2026-08-03)
+
+### Added — text prefixes: `PrefixConfig.insert_as_text` + `CommandItem.insert_text`
+
+A prefix can now be a snippet menu rather than an entity reference. With
+`insert_as_text: true`, picking a command inserts plain editable characters
+(`CommandItem.insert_text`, falling back to `action`) and consumes the trigger
+character with the query — no pill node, no `InsertedCommand`, nothing for the
+consumer to strip back out.
+
+```tsx
+<HazoUiTextbox
+  prefixes={[
+    { char: "@", commands: variables },                       // pills, unchanged
+    {
+      char: "/",
+      insert_as_text: true,
+      commands: [{ action: "SUM", action_label: "SUM(column)", insert_text: "SUM(" }],
+    },
+  ]}
+/>
+```
+
+Motivated by hazo_collab_forms' formula editor, where `/` offers the grammar's
+functions: what lands in the text has to be `SUM(`, valid formula source, not a
+`/SUM` pill.
+
+`parse_commands_from_text` (and therefore `text_to_tiptap_content`) now skips
+text prefixes entirely. Without that, a controlled-value sync would re-read
+`a/SUM(b)` and turn the division into a `/SUM` pill. Both `HazoUiTextbox` and
+`HazoUiTextarea` honour the flag. New export: `insert_text_at_position`.
+
+## v6.7.1 (2026-08-03)
+
+### Fixed — `HazoUiTextbox` no longer warns "flushSync was called from inside a lifecycle method"
+
+The controlled-value sync effect called `editor.commands.setContent(...)`
+synchronously. That dispatches a ProseMirror transaction, and `@tiptap/react`
+flushes the resulting re-render with `flushSync` — which, when the effect runs
+while React is still rendering the owning tree, React reports as
+
+```
+flushSync was called from inside a lifecycle method. React cannot flush when
+React is already rendering.
+```
+
+and then discards. Reported from a consumer that renders `HazoUiTextbox`
+inside a large form tree (hazo_collab_forms' `TransformEditor`).
+
+The write is now deferred to a `queueMicrotask` — after the commit, before
+paint. The guard conditions (`isFocused`, value-still-differs, plus a new
+`isDestroyed` check) are re-evaluated inside the microtask, because focus or
+the controlled value can move between the effect and the flush. Behaviour is
+otherwise unchanged; a cancelled/unmounted effect drops the pending write.
+
 ## v6.7.0 (2026-08-02)
 
 ### Added — `data-column-key` / `data-lane-key` on the kanban DOM

package/dist/index.cjs

@@ -5655,6 +5655,9 @@ var insert_command_at_position = (editor, command, prefix, range, variant = "def
     color: color2
   }).run();
 };
+var insert_text_at_position = (editor, command, range) => {
+  editor.chain().focus().deleteRange(range).insertContent(command.insert_text ?? command.action).run();
+};
 var get_variant_classes2 = (variant = "default") => {
   switch (variant) {
     case "outline":
@@ -5857,7 +5860,9 @@ var CommandPopover = ({
 CommandPopover.displayName = "CommandPopover";
 
 // src/components/hazo_ui_command/index.tsx
-var parse_commands_from_text = (text, prefixes) => {
+var parse_commands_from_text = (text, all_prefixes) => {
+  const prefixes = all_prefixes.filter((p) => !p.insert_as_text);
+  if (prefixes.length === 0) return [];
   const result = [];
   const action_to_label = /* @__PURE__ */ new Map();
   for (const prefix_config of prefixes) {
@@ -6167,13 +6172,18 @@ var HazoUiTextbox = ({
     }
   }, [suggestion_state, editor]);
   React27__namespace.useEffect(() => {
-    if (is_controlled && editor && !editor.isFocused) {
-      const current_text = editor.getText();
-      if (value !== current_text) {
-        const content = text_to_tiptap_content(value || "", prefixes, pill_variant);
-        editor.commands.setContent(content, { emitUpdate: false });
-      }
-    }
+    if (!is_controlled || !editor || editor.isFocused) return;
+    if (value === editor.getText()) return;
+    let cancelled = false;
+    queueMicrotask(() => {
+      if (cancelled || editor.isDestroyed || editor.isFocused) return;
+      if (value === editor.getText()) return;
+      const content = text_to_tiptap_content(value || "", prefixes, pill_variant);
+      editor.commands.setContent(content, { emitUpdate: false });
+    });
+    return () => {
+      cancelled = true;
+    };
   }, [value, editor, is_controlled, prefixes, pill_variant]);
   React27__namespace.useEffect(() => {
     if (editor) {
@@ -6185,6 +6195,11 @@ var HazoUiTextbox = ({
       if (!editor || !suggestion_state) return;
       const prefix_config = prefixes.find((p) => p.char === suggestion_state.prefix);
       const prefix_color = prefix_config?.color;
+      if (prefix_config?.insert_as_text) {
+        insert_text_at_position(editor, command, suggestion_state.range);
+        set_suggestion_state(null);
+        return;
+      }
       insert_command_at_position(
         editor,
         command,
@@ -6735,6 +6750,11 @@ var HazoUiTextarea = ({
       if (!editor || !suggestion_state) return;
       const prefix_config = prefixes.find((p) => p.char === suggestion_state.prefix);
       const prefix_color = prefix_config?.color;
+      if (prefix_config?.insert_as_text) {
+        insert_text_at_position(editor, command, suggestion_state.range);
+        set_suggestion_state(null);
+        return;
+      }
       insert_command_at_position(
         editor,
         command,