@particle-academy/react-fancy 5.67.0 → 5.69.0

package/dist/json-editor.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkU5LKNGHU_cjs = require('./chunk-U5LKNGHU.cjs');
+var chunk2PSHIUM7_cjs = require('./chunk-2PSHIUM7.cjs');
 require('./chunk-2O5UXH5R.cjs');
 require('./chunk-TLRFXSPA.cjs');
-require('./chunk-6CAXLP7D.cjs');
+require('./chunk-J5TFVYYM.cjs');
 require('./chunk-WKPBCB67.cjs');
 require('./chunk-MAZEX4EZ.cjs');
 require('./chunk-MRZXTL46.cjs');
@@ -12,7 +12,7 @@ require('./chunk-QF7CD4JH.cjs');
 require('./chunk-O3F6DYWR.cjs');
 require('./chunk-4XMBXG4K.cjs');
 require('./chunk-GKLETY7D.cjs');
-require('./chunk-HFK5SBNM.cjs');
+require('./chunk-YJETQ76J.cjs');
 require('./chunk-MKGWHSNV.cjs');
 require('./chunk-KJ22KE56.cjs');
 require('./chunk-L3V3BYVS.cjs');
@@ -33,47 +33,47 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "JsonEditor", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.JsonEditor; }
+  get: function () { return chunk2PSHIUM7_cjs.JsonEditor; }
 });
 Object.defineProperty(exports, "applyJsonEdit", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.applyJsonEdit; }
+  get: function () { return chunk2PSHIUM7_cjs.applyJsonEdit; }
 });
 Object.defineProperty(exports, "describeEdit", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.describeEdit; }
+  get: function () { return chunk2PSHIUM7_cjs.describeEdit; }
 });
 Object.defineProperty(exports, "findJsonConflicts", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.findJsonConflicts; }
+  get: function () { return chunk2PSHIUM7_cjs.findJsonConflicts; }
 });
 Object.defineProperty(exports, "getAtPath", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.getAtPath; }
+  get: function () { return chunk2PSHIUM7_cjs.getAtPath; }
 });
 Object.defineProperty(exports, "inferType", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.inferType; }
+  get: function () { return chunk2PSHIUM7_cjs.inferType; }
 });
 Object.defineProperty(exports, "parseKeyMap", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.parseKeyMap; }
+  get: function () { return chunk2PSHIUM7_cjs.parseKeyMap; }
 });
 Object.defineProperty(exports, "parsePath", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.parsePath; }
+  get: function () { return chunk2PSHIUM7_cjs.parsePath; }
 });
 Object.defineProperty(exports, "pathToString", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.pathToString; }
+  get: function () { return chunk2PSHIUM7_cjs.pathToString; }
 });
 Object.defineProperty(exports, "resolveKeyRule", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.resolveKeyRule; }
+  get: function () { return chunk2PSHIUM7_cjs.resolveKeyRule; }
 });
 Object.defineProperty(exports, "typeMatches", {
   enumerable: true,
-  get: function () { return chunkU5LKNGHU_cjs.typeMatches; }
+  get: function () { return chunk2PSHIUM7_cjs.typeMatches; }
 });
 //# sourceMappingURL=json-editor.cjs.map
 //# sourceMappingURL=json-editor.cjs.map

package/dist/json-editor.js

@@ -1,7 +1,7 @@
-export { JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-DCAD2JPP.js';
+export { JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-U4PWNLOH.js';
 import './chunk-DXZCKDYS.js';
 import './chunk-2UTN3EFK.js';
-import './chunk-B4LVQ4QI.js';
+import './chunk-YEGFOMJB.js';
 import './chunk-FVI4JDLA.js';
 import './chunk-UVUBV4VZ.js';
 import './chunk-KXYMMNNV.js';
@@ -10,7 +10,7 @@ import './chunk-5WQ6FPSP.js';
 import './chunk-USWQAMI3.js';
 import './chunk-XM3V3RSU.js';
 import './chunk-SVSQXKFL.js';
-import './chunk-YIKXJWO4.js';
+import './chunk-4WIPWJYD.js';
 import './chunk-QTS4Q2NK.js';
 import './chunk-OL53XYHF.js';
 import './chunk-NRXK42LO.js';

package/dist/paste-pills.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkHFK5SBNM_cjs = require('./chunk-HFK5SBNM.cjs');
+var chunkYJETQ76J_cjs = require('./chunk-YJETQ76J.cjs');
 require('./chunk-MKGWHSNV.cjs');
 require('./chunk-J2DI6RMR.cjs');
 require('./chunk-MKHYENKR.cjs');
@@ -14,55 +14,55 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "HOST_ATTR", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.HOST_ATTR; }
+  get: function () { return chunkYJETQ76J_cjs.HOST_ATTR; }
 });
 Object.defineProperty(exports, "InlinePasteEditor", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.InlinePasteEditor; }
+  get: function () { return chunkYJETQ76J_cjs.InlinePasteEditor; }
 });
 Object.defineProperty(exports, "InlinePill", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.InlinePill; }
+  get: function () { return chunkYJETQ76J_cjs.InlinePill; }
 });
 Object.defineProperty(exports, "PILL_MARK", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.PILL_MARK; }
+  get: function () { return chunkYJETQ76J_cjs.PILL_MARK; }
 });
 Object.defineProperty(exports, "PastedFilesInput", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.PastedFilesInput; }
+  get: function () { return chunkYJETQ76J_cjs.PastedFilesInput; }
 });
 Object.defineProperty(exports, "endsOf", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.endsOf; }
+  get: function () { return chunkYJETQ76J_cjs.endsOf; }
 });
 Object.defineProperty(exports, "expandMarkers", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.expandMarkers; }
+  get: function () { return chunkYJETQ76J_cjs.expandMarkers; }
 });
 Object.defineProperty(exports, "markedIds", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.markedIds; }
+  get: function () { return chunkYJETQ76J_cjs.markedIds; }
 });
 Object.defineProperty(exports, "pasteMarker", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.pasteMarker; }
+  get: function () { return chunkYJETQ76J_cjs.pasteMarker; }
 });
 Object.defineProperty(exports, "segmentValue", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.segmentValue; }
+  get: function () { return chunkYJETQ76J_cjs.segmentValue; }
 });
 Object.defineProperty(exports, "useInlinePaste", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.useInlinePaste; }
+  get: function () { return chunkYJETQ76J_cjs.useInlinePaste; }
 });
 Object.defineProperty(exports, "usePastePills", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.usePastePills; }
+  get: function () { return chunkYJETQ76J_cjs.usePastePills; }
 });
 Object.defineProperty(exports, "withSeparators", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.withSeparators; }
+  get: function () { return chunkYJETQ76J_cjs.withSeparators; }
 });
 //# sourceMappingURL=paste-pills.cjs.map
 //# sourceMappingURL=paste-pills.cjs.map

package/dist/paste-pills.d.cts

@@ -1,6 +1,6 @@
 import { C as ComposerPastePreview, a as ComposerPasteClassNames } from './PastePills.types-CpXzsuwJ.cjs';
 export { H as HeldImage, b as HeldPaste, P as PILL_MARK, c as PasteClassNames, d as PasteEventLike, e as PastePreview, U as UsePastePillsOptions, f as UsePastePillsResult, V as ValueSegment, g as expandMarkers, m as markedIds, p as pasteMarker, s as segmentValue, u as usePastePills } from './PastePills.types-CpXzsuwJ.cjs';
-export { H as HOST_ATTR, I as InlinePasteEditor, a as InlinePasteEditorHandle, P as PastedFilesInput, b as PastedFilesInputProps, c as PillToInsert, U as UseInlinePasteOptions, u as useInlinePaste } from './PastedFilesInput-CUQeOeOA.cjs';
+export { H as HOST_ATTR, I as InlinePasteEditor, a as InlinePasteEditorHandle, P as PastedFilesInput, b as PastedFilesInputProps, c as PillToInsert, U as UseInlinePasteOptions, u as useInlinePaste } from './PastedFilesInput-Cd4k6a38.cjs';
 import * as react from 'react';
 import { ReactNode } from 'react';
 

package/dist/paste-pills.d.ts

@@ -1,6 +1,6 @@
 import { C as ComposerPastePreview, a as ComposerPasteClassNames } from './PastePills.types-CpXzsuwJ.js';
 export { H as HeldImage, b as HeldPaste, P as PILL_MARK, c as PasteClassNames, d as PasteEventLike, e as PastePreview, U as UsePastePillsOptions, f as UsePastePillsResult, V as ValueSegment, g as expandMarkers, m as markedIds, p as pasteMarker, s as segmentValue, u as usePastePills } from './PastePills.types-CpXzsuwJ.js';
-export { H as HOST_ATTR, I as InlinePasteEditor, a as InlinePasteEditorHandle, P as PastedFilesInput, b as PastedFilesInputProps, c as PillToInsert, U as UseInlinePasteOptions, u as useInlinePaste } from './PastedFilesInput-Bt3KSTVN.js';
+export { H as HOST_ATTR, I as InlinePasteEditor, a as InlinePasteEditorHandle, P as PastedFilesInput, b as PastedFilesInputProps, c as PillToInsert, U as UseInlinePasteOptions, u as useInlinePaste } from './PastedFilesInput-BT5y95sb.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 

package/dist/paste-pills.js

@@ -1,4 +1,4 @@
-export { HOST_ATTR, InlinePasteEditor, InlinePill, PILL_MARK, PastedFilesInput, endsOf, expandMarkers, markedIds, pasteMarker, segmentValue, useInlinePaste, usePastePills, withSeparators } from './chunk-YIKXJWO4.js';
+export { HOST_ATTR, InlinePasteEditor, InlinePill, PILL_MARK, PastedFilesInput, endsOf, expandMarkers, markedIds, pasteMarker, segmentValue, useInlinePaste, usePastePills, withSeparators } from './chunk-4WIPWJYD.js';
 import './chunk-QTS4Q2NK.js';
 import './chunk-MQ6VGG62.js';
 import './chunk-5VMILVWD.js';

package/dist/prompt-input.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkSAG6DHQK_cjs = require('./chunk-SAG6DHQK.cjs');
+var chunkISNS4GAW_cjs = require('./chunk-ISNS4GAW.cjs');
 require('./chunk-OASSZI6M.cjs');
 require('./chunk-I27K6NLX.cjs');
 require('./chunk-AIA5UNQ5.cjs');
-require('./chunk-HFK5SBNM.cjs');
+require('./chunk-YJETQ76J.cjs');
 require('./chunk-MKGWHSNV.cjs');
 require('./chunk-J2DI6RMR.cjs');
 require('./chunk-MKHYENKR.cjs');
@@ -22,15 +22,15 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "PromptInput", {
   enumerable: true,
-  get: function () { return chunkSAG6DHQK_cjs.PromptInput; }
+  get: function () { return chunkISNS4GAW_cjs.PromptInput; }
 });
 Object.defineProperty(exports, "promptDataUrlToFile", {
   enumerable: true,
-  get: function () { return chunkSAG6DHQK_cjs.promptDataUrlToFile; }
+  get: function () { return chunkISNS4GAW_cjs.promptDataUrlToFile; }
 });
 Object.defineProperty(exports, "promptFileToDataUrl", {
   enumerable: true,
-  get: function () { return chunkSAG6DHQK_cjs.promptFileToDataUrl; }
+  get: function () { return chunkISNS4GAW_cjs.promptFileToDataUrl; }
 });
 //# sourceMappingURL=prompt-input.cjs.map
 //# sourceMappingURL=prompt-input.cjs.map

package/dist/prompt-input.d.cts

@@ -1,3 +1,3 @@
-export { a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptInput, g as PromptInputHandle, h as PromptInputProps, i as PromptMention, j as PromptSetDraftOptions, p as promptDataUrlToFile, n as promptFileToDataUrl } from './index-DWtSViJ3.cjs';
+export { a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptFocusOptions, g as PromptInput, h as PromptInputHandle, i as PromptInputProps, j as PromptMention, k as PromptSetDraftOptions, p as promptDataUrlToFile, o as promptFileToDataUrl } from './index-n_4_OZK_.cjs';
 import 'react';
 import './PastePills.types-CpXzsuwJ.cjs';

package/dist/prompt-input.d.ts

@@ -1,3 +1,3 @@
-export { a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptInput, g as PromptInputHandle, h as PromptInputProps, i as PromptMention, j as PromptSetDraftOptions, p as promptDataUrlToFile, n as promptFileToDataUrl } from './index-XR5t8bTq.js';
+export { a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptFocusOptions, g as PromptInput, h as PromptInputHandle, i as PromptInputProps, j as PromptMention, k as PromptSetDraftOptions, p as promptDataUrlToFile, o as promptFileToDataUrl } from './index-BQi_n6eS.js';
 import 'react';
 import './PastePills.types-CpXzsuwJ.js';

package/dist/prompt-input.js

@@ -1,8 +1,8 @@
-export { PromptInput, promptDataUrlToFile, promptFileToDataUrl } from './chunk-23AVEYUP.js';
+export { PromptInput, promptDataUrlToFile, promptFileToDataUrl } from './chunk-HRZDEZSE.js';
 import './chunk-GR2WKBER.js';
 import './chunk-SV5BW3IA.js';
 import './chunk-TJ66S5K6.js';
-import './chunk-YIKXJWO4.js';
+import './chunk-4WIPWJYD.js';
 import './chunk-QTS4Q2NK.js';
 import './chunk-MQ6VGG62.js';
 import './chunk-5VMILVWD.js';

package/docs/ContentRenderer.md

@@ -27,7 +27,7 @@ import { ContentRenderer } from "@particle-academy/react-fancy";
 | copyButtons | `boolean \| { code?: boolean; table?: boolean }` | `true` | Copy buttons on code blocks and tables. See **Copy buttons**. |
 | onCopy | `(event: ContentCopyEvent) => void` | - | Called after every copy attempt, successful or not |
 | clipboardWriter | `ContentClipboardWriter` | - | Host-supplied clipboard writer. See **Clipboard writer**. |
-| streaming | `boolean` | `false` | The value is still arriving: hold back an unfinished trailing tag or fence. See **Streaming**. |
+| streaming | `boolean \| "progressive"` | `false` | The value is still arriving. `true` holds back an unfinished trailing tag or fence; `"progressive"` shows it as it fills. See **Streaming**. |
 
 ## Copy buttons
 
@@ -43,7 +43,10 @@ Every code block and table gets a react-fancy `Button` (icon `copy`, then
   survives a paste into a spreadsheet.
 
 Each copy is announced as `Copied` or `Copy failed` through a polite
-`aria-live` region (`[data-react-fancy-content-renderer-live]`).
+`aria-live` region (`[data-react-fancy-content-renderer-live]`). The region is
+visually hidden with inline sr-only styles, so it needs nothing from your
+Tailwind build. It is `position: absolute`, so the root is `position: relative`
+unless your `className` already positions it.
 
 ```tsx
 <ContentRenderer value={reply} copyButtons={false} />          // none
@@ -89,7 +92,8 @@ than state. Copy follows that:
 | `data-copy-state="idle" \| "copied" \| "failed"` | the copy button |
 | `data-react-fancy-content-copy-block="code" \| "table"` | the wrapper around the block |
 | `data-react-fancy-content-renderer-live` | the live region |
-| `data-streaming="true"` | the root, while `streaming` |
+| `data-streaming="true"` | the root, while `streaming` (either mode) |
+| `data-streaming-mode="progressive"` | the root, while `streaming="progressive"` |
 
 `onCopy` receives `{ kind, index, text, html, ok }`, where `index` is the
 button's position among this renderer's copy buttons in document order. Wire it
@@ -117,6 +121,50 @@ A `<` that cannot become a registered tag is prose and always renders
 A lone `<` at the very end is held for one chunk, because it may be the start of
 a tag. When `streaming` goes back to `false`, everything renders.
 
+### Progressive streaming
+
+`streaming={true}` hides an open block until it closes. Pass
+`streaming="progressive"` to show it as it fills instead:
+
+```tsx
+<ContentRenderer
+  value={partial}
+  streaming={done ? false : "progressive"}
+  extensions={[resultTag]}
+/>
+```
+
+- An open tag of a registered extension whose **opening tag is complete**
+  renders its component straight away, with the body that has arrived so far.
+  A `markdown` extension gets that body as `content` and rendered as
+  `children`, through the same pipeline as the final render: converted,
+  sanitised, nested extensions, copy buttons on finished blocks.
+- An open code fence renders as a code block of what has arrived, in its
+  language. It gets **no copy button until it closes**; copying half a block
+  is never what anyone means, and a disabled button would still invite the
+  click. Finished code blocks and tables before it keep theirs.
+- Still held back, exactly as in `streaming={true}`: a **partial opening tag**
+  (`<`, `<res`, `<result title="Do`), so it never flashes raw; a partial
+  closing tag (`</res`), with the body above it still showing; a fence marker
+  still arriving (` `` `). Also held: a fence opener line with no newline yet
+  (` ```ja `), because its language may be cut off.
+- Inside an open fence, `<` is code and is never held.
+
+It works by closing what is open: the open fence gets its own closing marker
+and every open registered tag gets its closing tag, innermost first, and the
+result renders normally. So the rendered body is the same one the final render
+produces once the real closing tags arrive; only what is still to come is
+missing.
+
+The lifting rules below do not change in this mode. A `markdown` tag whose
+opening tag is mid-line is not lifted while streaming, any more than it is once
+it closes: it is matched in the HTML, as the final render will match it.
+
+**Why a value of `streaming` rather than a second prop:** progressive is a way
+of streaming, not something separate, and a separate boolean would add a
+combination that means nothing (progressive while not streaming). A host that
+already writes `streaming={!done}` changes one expression.
+
 ## Sanitization
 
 Since v2.5.0, `ContentRenderer` sanitizes its rendered output by default:
@@ -208,11 +256,20 @@ const resultTag: RenderExtension = {
 - `content` is the raw markdown body; `children` is that body rendered through
   the same pipeline as everything else: sanitised, with nested extensions and
   copy buttons. **Render `children`, not `content`.**
-- A tag is lifted when its opening tag starts a line and it has a matching
-  closing tag. Same-name nesting is balanced, other markdown tags nest inside
-  it, and a tag inside a code fence or inline code is left alone.
+- A tag is lifted **only** when its opening tag starts a line (after at most
+  three spaces) **and** it has a matching closing tag. Same-name nesting is
+  balanced, other markdown tags nest inside it, and a tag inside a code fence
+  or inline code is left alone.
 - Anywhere else (mid-line, unclosed, or in HTML content) it is matched in the
   HTML as before, and `children` renders that HTML body.
+- **Both conditions are deliberate and will stay.** A tag that starts a line
+  and closes is an unambiguous block. A mid-line `<result>` is text that
+  happens to contain a tag name, and an unclosed one has no end to its body, so
+  lifting either would turn prose (or a model quoting the tag) into a
+  component. To get a block, put the opening tag on its own line and close it.
+  `streaming="progressive"` renders an open block early, but it does so by
+  supplying the close the final render will see; it does not relax either
+  rule.
 - Nesting stops at depth 8: deeper bodies render as plain sanitised content.
 
 Sanitisation is unchanged by lifting. Every piece of markdown, including each

package/docs/Editor.md

@@ -29,6 +29,7 @@ import { Editor } from "@particle-academy/react-fancy";
 | outputFormat | `"html" \| "markdown"` | `"html"` | Output format for the onChange value |
 | lineSpacing | `number` | `1.6` | Line height for content area |
 | placeholder | `string` | - | Placeholder text |
+| mode | `"edit" \| "view"` | `"edit"` | `"view"` renders the value read-only through `ContentRenderer`. Resolution: this prop, then the nearest `<Form>` context, then `"edit"`. See **View mode** |
 | extensions | `RenderExtension[]` | - | Per-instance render extensions (merged with global) |
 | showSource | `boolean` | - | Controlled source-view flag. When `true`, the content area shows the raw `value` (in `outputFormat`) in an editable `<textarea>` |
 | defaultShowSource | `boolean` | `false` | Initial source-view flag when uncontrolled |
@@ -37,6 +38,9 @@ import { Editor } from "@particle-academy/react-fancy";
 | defaultFullScreen | `boolean` | `false` | Initial full-screen flag when uncontrolled |
 | onFullScreenChange | `(fullScreen: boolean) => void` | - | Fired by the toggle, Escape, an agent, or the user leaving the browser's full screen |
 | fullScreenMode | `"overlay" \| "native"` | `"overlay"` | `overlay` covers the viewport in place and always works; `native` uses the browser Fullscreen API and falls back to the overlay. See [FullScreen](./FullScreen.md) |
+| copyButtons | `boolean \| { code?: boolean; table?: boolean }` | `true` | View mode only. Copy buttons on code blocks and tables, forwarded to `ContentRenderer`. `false` turns them off; `{ table: false }` keeps code only. See **View mode** |
+| clipboardWriter | `ContentClipboardWriter` | - | View mode only. Host-supplied clipboard writer, forwarded to `ContentRenderer` (e.g. Electron's `clipboard` in a sandboxed window) |
+| onCopy | `(event: ContentCopyEvent) => void` | - | View mode only. Called after every copy attempt, successful or not, forwarded to `ContentRenderer` |
 | className | `string` | - | Additional CSS classes |
 
 ### Editor.Toolbar
@@ -129,6 +133,40 @@ A host's own actions belong in `toolbarExtra`, not in `children`: children repla
 </Editor>
 ```
 
+## View mode
+
+`mode="view"` (or a `<Form mode="view">` around the editor) renders the value
+read-only through [`ContentRenderer`](./ContentRenderer.md) instead of the
+toolbar and editable surface. `extensions`, `unsafe` and `lineSpacing` reach the
+renderer, and so do the copy props:
+
+| Editor prop | ContentRenderer prop | Default |
+|-------------|----------------------|---------|
+| `copyButtons` | `copyButtons` | `true`: a copy button on every code block and table |
+| `clipboardWriter` | `clipboardWriter` | text/html + text/plain via `ClipboardItem`, falling back to `writeText` |
+| `onCopy` | `onCopy` | - |
+
+Same types and same defaults as on `ContentRenderer`; leaving them out changes
+nothing. They have no effect in edit mode.
+
+```tsx
+import { clipboard } from "electron";
+
+<Editor
+  value={doc}
+  mode="view"
+  outputFormat="markdown"
+  clipboardWriter={({ text, html }) => clipboard.write({ text, html })}
+  onCopy={(e) => activity.push({ type: "copy", kind: e.kind, ok: e.ok })}
+>
+  <Editor.Content />
+</Editor>
+
+<Editor value={doc} mode="view" copyButtons={false}>  {/* no buttons */}
+  <Editor.Content />
+</Editor>
+```
+
 ## Source View
 
 The default toolbar includes a **Source** toggle (`</>`) on the right. Clicking it

package/docs/PromptInput.md

@@ -83,6 +83,7 @@ if (saved) composer.current!.setDraft(JSON.parse(saved));
 ```
 
 - `setDraft(draft, { focus?: false })` does **not** focus unless you pass `{ focus: true }`. It never moves the caret of whatever does have focus.
+- Focus from `focus()` or `setDraft(draft, { focus: true })` never scrolls the page or any ancestor (it passes `{ preventScroll: true }`). To let the browser scroll the composer into view, pass `{ preventScroll: false }` to either.
 - `setDraft` does not call `onChange` / `onDraftChange`. You set the draft yourself, so you already have it.
 - A draft with an unknown `v` is refused with a console warning.
 
@@ -151,8 +152,8 @@ interface PromptDraft { v: 1; text: string; pills: PromptDraftPill[]; attachment
 
 interface PromptInputHandle {
   getDraft(): PromptDraft;
-  setDraft(draft: PromptDraft, options?: { focus?: boolean }): void;
-  focus(): void;
+  setDraft(draft: PromptDraft, options?: { focus?: boolean; preventScroll?: boolean }): void;
+  focus(options?: { preventScroll?: boolean }): void; // preventScroll defaults to true
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/react-fancy",
-  "version": "5.67.0",
+  "version": "5.69.0",
   "description": "React UI component library for Human+ UX — controlled, agent-bridgeable primitives",
   "repository": {
     "type": "git",