@jackuait/blok 0.23.3 → 0.23.5

package/README.md

@@ -62,11 +62,11 @@ new Blok({
 - `@jackuait/blok/react` — React 18/19 adapter. The recommended entry point is `<BlokEditor>`, an all-in-one component that forwards a ref to the live `Blok` instance:
 
   ```tsx
-  const ref = useRef<Blok | null>(null);
-  <BlokEditor ref={ref} tools={tools} data={initialData} theme={theme} onReady={(editor) => {/* editor ready */}} />;
+  const [data, setData] = useState(initialData);
+  <BlokEditor tools={tools} data={data} onSave={setData} theme={theme} />;
   ```
 
-  `data` is the **initial content only** — the editor owns the document after mount. Read content via `onChange` or `ref.current.save()`; replace it via `ref.current.render(newData)`; passing a new `data` reference does not reload content.
+  `data` + `onSave` make `<BlokEditor>` a true **controlled component**. `data` is reactive: passing new content re-renders the editor in place (deep-equal–deduped, so identical content never clobbers the caret). `onSave` is the output half: it fires — debounced — with the full serialized `OutputData` on every content change, so you no longer poll `ref.current.save()` by hand. Wiring `onSave={setData}` is safe and caret-stable: the adapter records the editor's own emitted output as the content baseline, so echoing it back deep-equal–dedupes to a no-op (no re-render) while genuine external `data` changes still render. (You can still forward a ref and call `ref.current.render(newData)` for ad-hoc reloads, or use the lower-level `onChange(api, event)` for mutation events.)
 
   Reactive props (`readOnly`, `theme`, `width`, `autofocus`) sync without remounting. When structural config like `tools` needs to change, pass a `deps` array — the editor is destroyed and recreated whenever any dep value changes. Keep each value inside `deps` referentially stable: pass primitives or `useMemo`-stable objects, since a dep value whose identity changes every render recreates the editor each time. (The individual values are compared, not the array wrapper, so a fresh `[a, b]` literal each render is fine when `a` and `b` are stable; omitting `deps` creates the editor once.)
 

package/dist/blok.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`./chunks/blok-J3Lfa_bK.cjs`),t=require(`./chunks/constants-BZUc1kAY.cjs`);exports.BlockRendered=e.o,exports.BlocksRendered=e.a,exports.Blok=e.t,exports.EditorJS=e.t,exports.default=e.t,exports.DATA_ATTR=t.Ma,exports.TEST_ID=t.Fi,exports.version=e.n,exports.wrapLegacyInlineTool=e.r;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`./chunks/blok-DixLFA0K.cjs`),t=require(`./chunks/constants-Bze_TXgc.cjs`);exports.BlockRendered=e.o,exports.BlocksRendered=e.a,exports.Blok=e.t,exports.EditorJS=e.t,exports.default=e.t,exports.DATA_ATTR=t.Ma,exports.TEST_ID=t.Fi,exports.version=e.n,exports.wrapLegacyInlineTool=e.r;