@june-ai/june-ui 0.2.2 → 0.2.4

package/dist/index.d.cts

@@ -1,8 +1,11 @@
 import * as react from 'react';
 import { ComponentProps, Component, ReactNode, ErrorInfo, CSSProperties } from 'react';
-import { Renderer, createLibrary, defineComponent } from '@openuidev/react-lang';
+import * as _openuidev_react_lang from '@openuidev/react-lang';
+import { Renderer, createLibrary, defineComponent, Library } from '@openuidev/react-lang';
+import * as _openuidev_lang_core from '@openuidev/lang-core';
+import { z } from 'zod/v4';
 
-type JuneErrorCode = "PARSE_ERROR" | "RENDER_ERROR" | "STREAM_ERROR" | "STREAM_ABORTED" | "STREAM_EMPTY" | "NETWORK_ERROR" | "ACTION_ERROR" | "ACTION_VALIDATION_ERROR" | "ACTION_REJECTED" | "LIBRARY_ERROR";
+type JuneErrorCode = "PARSE_ERROR" | "RENDER_ERROR" | "STREAM_ERROR" | "STREAM_ABORTED" | "STREAM_EMPTY" | "NETWORK_ERROR" | "ACTION_ERROR" | "ACTION_VALIDATION_ERROR" | "ACTION_REJECTED" | "LIBRARY_ERROR" | "DOCUMENT_ERROR" | "EXPORT_ERROR";
 interface JuneErrorOptions {
     cause?: unknown;
     details?: unknown;
@@ -88,6 +91,138 @@ interface RunActionOptions {
 declare function runAction(event: OpenUIActionEvent, options: RunActionOptions): Promise<ActionOutcome>;
 declare function createActionHandler(options: RunActionOptions): (event: OpenUIActionEvent) => void;
 
+interface PendingUpdate {
+    json: DocJSON;
+    title: string;
+    /** AI changes merged in, with the user's version kept where both changed the same blocks. */
+    merged: DocJSON;
+    conflicts: number;
+}
+interface DocumentRecord {
+    id: string;
+    title: string;
+    documentType?: string;
+    status?: string;
+    /** What the user currently sees. */
+    json: DocJSON;
+    /** The last AI version that was accepted. Used as the merge base. */
+    baseJson: DocJSON;
+    baseTitle: string;
+    lastIncomingKey: string;
+    /** Increments whenever `json` changes. */
+    revision: number;
+    /** Which editor (or "external") produced the latest change. */
+    origin: string;
+    pending: PendingUpdate | null;
+    updatedAt: number;
+}
+interface IncomingDocument {
+    id: string;
+    title: string;
+    json: DocJSON;
+    documentType?: string;
+    status?: string;
+}
+type ReceiveOutcome = "created" | "unchanged" | "applied" | "merged" | "conflict";
+type ResolveChoice = "merge" | "replace" | "keep";
+interface DocumentStore {
+    get(id: string): DocumentRecord | undefined;
+    list(): DocumentRecord[];
+    subscribe(listener: () => void): () => void;
+    /** An AI version arrived. Applies it, merges it with user edits, or records a conflict. */
+    receive(incoming: IncomingDocument): ReceiveOutcome;
+    /** Seed or replace a document, for example from your database. */
+    hydrate(doc: IncomingDocument): void;
+    edit(id: string, json: DocJSON, origin: string): void;
+    setTitle(id: string, title: string): void;
+    resolve(id: string, choice: ResolveChoice): void;
+    remove(id: string): void;
+}
+declare function createDocumentStore(): DocumentStore;
+/** The shared in-memory store used when none is provided. Documents are keyed by documentId. */
+declare function getDefaultDocumentStore(): DocumentStore;
+
+/** Structural type of a Tiptap / ProseMirror JSON node. Dependency-free on purpose. */
+interface DocNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: DocNode[];
+    marks?: {
+        type: string;
+        attrs?: Record<string, unknown>;
+    }[];
+    text?: string;
+}
+/** Canonical document format: a Tiptap JSON document. */
+interface DocJSON {
+    type: "doc";
+    content?: DocNode[];
+}
+type DocumentExportFormat = "html" | "markdown" | "txt" | "docx" | "pdf";
+declare const ALL_EXPORT_FORMATS: readonly DocumentExportFormat[];
+interface DocumentSnapshot {
+    documentId: string;
+    title: string;
+    documentType?: string;
+    status?: string;
+    json: DocJSON;
+}
+interface DocumentChange extends DocumentSnapshot {
+    /** user = typed in the editor, ai = new AI version applied, merge = AI merged with user edits, resolve = conflict resolved. */
+    source: "user" | "ai" | "merge" | "resolve";
+}
+interface DocumentSavePayload extends DocumentSnapshot {
+    html: string;
+    markdown: string;
+}
+interface DocumentExportEvent {
+    documentId: string;
+    format: string;
+    filename: string;
+    mimeType: string;
+    blob?: Blob;
+    text?: string;
+    /** True when the exporter delivered the file itself (for example the PDF print dialog). */
+    handled?: boolean;
+}
+interface DocumentConflict {
+    documentId: string;
+    title: string;
+    /** Number of regions that both the user and the assistant changed. */
+    conflicts: number;
+}
+interface JuneDocumentOptions {
+    /** Share one store across editors. Defaults to a global in-memory store, keyed by documentId. */
+    store?: DocumentStore;
+    /** Debounce for autosave in ms (default 1500). 0 or less disables autosave. */
+    autosaveDelay?: number;
+    onDocumentChange?: (change: DocumentChange) => void;
+    /** Persist the document. Called by autosave, the Save button and Ctrl/Cmd+S. */
+    onSave?: (payload: DocumentSavePayload) => void | Promise<void>;
+    onExport?: (event: DocumentExportEvent) => void;
+    onDocumentReady?: (snapshot: DocumentSnapshot) => void;
+    onConflict?: (conflict: DocumentConflict) => void;
+    onError?: (error: JuneError) => void;
+}
+interface DocumentEditorProps {
+    documentId: string;
+    title?: string;
+    /** Markdown, a Tiptap JSON string, or a Tiptap JSON object. */
+    content?: string | DocJSON;
+    documentType?: string;
+    /** Default "draft". Drafts show an "AI draft" badge. */
+    status?: string;
+    editable?: boolean;
+    exportFormats?: string[];
+    /** "auto" follows the June theme context. */
+    theme?: "auto" | "light" | "dark";
+    className?: string;
+    /** Show the drafting placeholder instead of the editor (use while content is streaming). */
+    generating?: boolean;
+    /** Callbacks and store. Merged over the values provided through JuneUI's `documents` prop. */
+    options?: JuneDocumentOptions;
+}
+
 type JuneThemeVars = Record<string, string>;
 /** Colors only. June never sets fonts, radii or backgrounds. */
 declare const lightTheme: JuneThemeVars;
@@ -120,14 +255,17 @@ type JuneRendererProps = Omit<OpenUIRendererProps, "library" | "response" | "isS
     /** Accumulated model output. OpenUI does the incremental parsing. */
     response: string | null;
     isStreaming?: boolean;
-    /**
-     * Render prose around OpenUI statements (default true). The response may be
-     * plain OpenUI Lang, or prose + OpenUI Lang, optionally inside ``` fences.
-     * Set false to hand the response to OpenUI untouched.
-     */
+    /** Allow prose around OpenUI statements (default true). */
     mixedContent?: boolean;
     /** Custom renderer for prose segments. Default: <p className="june-text">. */
     renderText?: (text: string, index: number) => ReactNode;
+    /**
+     * Rewrite common model mistakes after streaming ends (default true):
+     * Grid and shorthand Card calls, and charts or tables left off root.
+     * Set false to hand the program to OpenUI unchanged.
+     */
+    repair?: boolean;
+    /** Omit to inherit the host app's look. "light" | "dark" | "system" opt in to June's colors. */
     theme?: JuneThemeMode;
     themeVars?: JuneThemeVars;
     className?: string;
@@ -139,8 +277,10 @@ type JuneRendererProps = Omit<OpenUIRendererProps, "library" | "response" | "isS
     onAction?: (event: OpenUIActionEvent) => void;
     /** Raw OpenUI errors (called with [] when they resolve). */
     onError?: (errors: unknown[]) => void;
-    /** Structured errors: parse, render, and action failures. */
+    /** Structured errors: parse, render, action, document and export failures. */
     onJuneError?: (error: JuneError) => void;
+    /** Document editor callbacks and store. Memoize this object. */
+    documents?: JuneDocumentOptions;
     loadingFallback?: ReactNode;
     emptyFallback?: ReactNode;
     errorFallback?: ReactNode | ((args: FallbackArgs) => ReactNode);
@@ -170,6 +310,12 @@ interface JuneContextValue {
     theme: JuneResolvedTheme;
 }
 declare function useJuneTheme(): JuneContextValue;
+interface JuneRuntimeValue {
+    /** True while the response is still streaming. Custom components use it to defer heavy work. */
+    isStreaming: boolean;
+}
+declare const JuneRuntimeContext: react.Context<JuneRuntimeValue>;
+declare function useJuneRuntime(): JuneRuntimeValue;
 
 /** Re-export of OpenUI's component definer under a June name. */
 declare const defineJuneComponent: typeof defineComponent;
@@ -252,10 +398,107 @@ declare function sseToText(source: StreamSource, options?: SseOptions & {
  */
 declare function jsonFieldExtractor(path: string): (data: string) => string | null;
 
+/** Standalone editor. While a June response is still streaming, shows a placeholder instead of mounting Tiptap. */
+declare function DocumentEditor(props: DocumentEditorProps): react.JSX.Element;
+declare const JuneDocumentEditorComponent: _openuidev_react_lang.DefinedComponent<z.ZodObject<{
+    documentId: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodString;
+    documentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    editable: z.ZodOptional<z.ZodBoolean>;
+    exportFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+type Extendable = Library & {
+    extend: NonNullable<Library["extend"]>;
+};
+/**
+ * Returns a library that contains every component of `library` plus DocumentEditor,
+ * and allows DocumentEditor inside Card (Stack already accepts any child).
+ * The library must include Card, which both OpenUI libraries do.
+ */
+declare function withDocumentEditor(library: Extendable): Required<_openuidev_lang_core.Library<_openuidev_react_lang.ComponentRenderer<any>, _openuidev_lang_core.DefinedAction<any, string>>>;
+
+declare const JuneDocumentContext: react.Context<JuneDocumentOptions>;
+declare function useDocumentOptions(): JuneDocumentOptions;
+
+declare function mergeDocuments(base: DocJSON, local: DocJSON, incoming: DocJSON): {
+    doc: DocJSON;
+    conflicts: number;
+};
+
+interface ExportContext {
+    documentId: string;
+    title: string;
+    json: DocJSON;
+    /** File name without extension. */
+    basename: string;
+}
+interface ExportResult {
+    filename: string;
+    mimeType: string;
+    blob?: Blob;
+    text?: string;
+    /** True when the exporter delivered the file itself, for example the print dialog for PDF. */
+    handled?: boolean;
+}
+type DocumentExporter = (context: ExportContext) => ExportResult | Promise<ExportResult>;
+/** Adds or replaces an export format. */
+declare function registerDocumentExporter(format: string, exporter: DocumentExporter): void;
+declare function listDocumentExporters(): string[];
+declare function exportDocument(format: string, doc: {
+    documentId: string;
+    title: string;
+    json: DocJSON;
+}): Promise<ExportResult>;
+/** Starts a browser download for results that carry a Blob. */
+declare function downloadResult(result: ExportResult): void;
+/** Copies rich text and plain text. Returns false if the browser refuses. */
+declare function copyDocumentToClipboard(doc: {
+    title: string;
+    json: DocJSON;
+}): Promise<boolean>;
+
+interface DocumentInstructionOptions {
+    /** Examples of document types for your product. Default covers common business documents. */
+    documentTypes?: string[];
+    /** Extra rules appended after the built-in ones (tone, legal disclaimers, language, ...). */
+    extraRules?: string[];
+    /** Name of the component in your library. Default "DocumentEditor". */
+    componentName?: string;
+}
+/** Rules for the model. Pass them through your backend to any agent. */
+declare function getDocumentEditorRules(options?: DocumentInstructionOptions): string[];
+/** Text block you can paste into any agent's system prompt. */
+declare function getDocumentEditorInstructions(options?: DocumentInstructionOptions): string;
+/**
+ * Options for OpenUI's `library.prompt(options)`. Merge these with your own PromptOptions.
+ * Example: library.prompt({ ...documentPromptOptions(), preamble: "..." })
+ */
+declare function documentPromptOptions(options?: DocumentInstructionOptions): {
+    additionalRules: string[];
+    examples: string[];
+};
+
+/**
+ * Serialises the documents the user currently has (including their edits) as Markdown,
+ * ready to attach to the next message so the agent can edit the right text.
+ */
+declare function serializeDocumentsForAgent(options?: {
+    store?: DocumentStore;
+    ids?: string[];
+}): Promise<string>;
+
 type JuneUIProps = Omit<JuneRendererProps, "library"> & {
-    /** Defaults to OpenUI's built-in library (same behaviour as 0.1.0). */
+    /** Defaults to June's library: OpenUI's components plus DocumentEditor. */
     library?: OpenUILibrary;
 };
 declare function JuneUI({ library, ...props }: JuneUIProps): react.JSX.Element;
 
-export { type ActionEventParser, type ActionOutcome, type ConfirmAction, type ConsumeStreamOptions, type FallbackArgs, type FetchStreamOptions, type JuneAction, type JuneActionContext, type JuneActionDefinition, type JuneActionMap, JuneError, JuneErrorBoundary, type JuneErrorBoundaryProps, type JuneErrorCode, type JuneErrorOptions, type JuneLibraryOptions, JuneRenderer, type JuneRendererProps, type JuneResolvedTheme, type JuneStreamState, type JuneThemeMode, JuneThemeProvider, type JuneThemeProviderProps, type JuneThemeVars, JuneUI, type JuneUIProps, type OpenUIActionEvent, type OpenUILibrary, type OpenUIRendererProps, type ParsedActionEvent, type RunActionOptions, type SchemaLike, type SseOptions, type StreamChunk, type StreamSource, type StreamStarter, type StreamStatus, type UseJuneStreamOptions, type UseJuneStreamResult, consumeStream, createActionHandler, createJuneLibrary, darkTheme, defaultParseActionEvent, defineJuneAction, defineJuneComponent, fetchStream, isJuneError, jsonFieldExtractor, lightTheme, runAction, sseToText, toJuneError, useJuneStream, useJuneTheme, useResolvedTheme };
+/**
+ * June's default library: every OpenUI component plus DocumentEditor.
+ * Created once so its reference stays stable.
+ */
+declare const juneLibrary: Required<_openuidev_lang_core.Library<_openuidev_react_lang.ComponentRenderer<any>, _openuidev_lang_core.DefinedAction<any, string>>>;
+
+export { ALL_EXPORT_FORMATS, type ActionEventParser, type ActionOutcome, type ConfirmAction, type ConsumeStreamOptions, type DocJSON, type DocNode, type DocumentChange, type DocumentConflict, DocumentEditor, type DocumentEditorProps, type DocumentExportEvent, type DocumentExportFormat, type DocumentExporter, type DocumentInstructionOptions, type DocumentRecord, type DocumentSavePayload, type DocumentSnapshot, type DocumentStore, type ExportContext, type ExportResult, type FallbackArgs, type FetchStreamOptions, type JuneAction, type JuneActionContext, type JuneActionDefinition, type JuneActionMap, JuneDocumentContext, JuneDocumentEditorComponent, type JuneDocumentOptions, JuneError, JuneErrorBoundary, type JuneErrorBoundaryProps, type JuneErrorCode, type JuneErrorOptions, type JuneLibraryOptions, JuneRenderer, type JuneRendererProps, type JuneResolvedTheme, JuneRuntimeContext, type JuneStreamState, type JuneThemeMode, JuneThemeProvider, type JuneThemeProviderProps, type JuneThemeVars, JuneUI, type JuneUIProps, type OpenUIActionEvent, type OpenUILibrary, type OpenUIRendererProps, type ParsedActionEvent, type RunActionOptions, type SchemaLike, type SseOptions, type StreamChunk, type StreamSource, type StreamStarter, type StreamStatus, type UseJuneStreamOptions, type UseJuneStreamResult, consumeStream, copyDocumentToClipboard, createActionHandler, createDocumentStore, createJuneLibrary, darkTheme, defaultParseActionEvent, defineJuneAction, defineJuneComponent, documentPromptOptions, downloadResult, exportDocument, fetchStream, getDefaultDocumentStore, getDocumentEditorInstructions, getDocumentEditorRules, isJuneError, jsonFieldExtractor, juneLibrary, lightTheme, listDocumentExporters, mergeDocuments, registerDocumentExporter, runAction, serializeDocumentsForAgent, sseToText, toJuneError, useDocumentOptions, useJuneRuntime, useJuneStream, useJuneTheme, useResolvedTheme, withDocumentEditor };

package/dist/index.d.ts

@@ -1,8 +1,11 @@
 import * as react from 'react';
 import { ComponentProps, Component, ReactNode, ErrorInfo, CSSProperties } from 'react';
-import { Renderer, createLibrary, defineComponent } from '@openuidev/react-lang';
+import * as _openuidev_react_lang from '@openuidev/react-lang';
+import { Renderer, createLibrary, defineComponent, Library } from '@openuidev/react-lang';
+import * as _openuidev_lang_core from '@openuidev/lang-core';
+import { z } from 'zod/v4';
 
-type JuneErrorCode = "PARSE_ERROR" | "RENDER_ERROR" | "STREAM_ERROR" | "STREAM_ABORTED" | "STREAM_EMPTY" | "NETWORK_ERROR" | "ACTION_ERROR" | "ACTION_VALIDATION_ERROR" | "ACTION_REJECTED" | "LIBRARY_ERROR";
+type JuneErrorCode = "PARSE_ERROR" | "RENDER_ERROR" | "STREAM_ERROR" | "STREAM_ABORTED" | "STREAM_EMPTY" | "NETWORK_ERROR" | "ACTION_ERROR" | "ACTION_VALIDATION_ERROR" | "ACTION_REJECTED" | "LIBRARY_ERROR" | "DOCUMENT_ERROR" | "EXPORT_ERROR";
 interface JuneErrorOptions {
     cause?: unknown;
     details?: unknown;
@@ -88,6 +91,138 @@ interface RunActionOptions {
 declare function runAction(event: OpenUIActionEvent, options: RunActionOptions): Promise<ActionOutcome>;
 declare function createActionHandler(options: RunActionOptions): (event: OpenUIActionEvent) => void;
 
+interface PendingUpdate {
+    json: DocJSON;
+    title: string;
+    /** AI changes merged in, with the user's version kept where both changed the same blocks. */
+    merged: DocJSON;
+    conflicts: number;
+}
+interface DocumentRecord {
+    id: string;
+    title: string;
+    documentType?: string;
+    status?: string;
+    /** What the user currently sees. */
+    json: DocJSON;
+    /** The last AI version that was accepted. Used as the merge base. */
+    baseJson: DocJSON;
+    baseTitle: string;
+    lastIncomingKey: string;
+    /** Increments whenever `json` changes. */
+    revision: number;
+    /** Which editor (or "external") produced the latest change. */
+    origin: string;
+    pending: PendingUpdate | null;
+    updatedAt: number;
+}
+interface IncomingDocument {
+    id: string;
+    title: string;
+    json: DocJSON;
+    documentType?: string;
+    status?: string;
+}
+type ReceiveOutcome = "created" | "unchanged" | "applied" | "merged" | "conflict";
+type ResolveChoice = "merge" | "replace" | "keep";
+interface DocumentStore {
+    get(id: string): DocumentRecord | undefined;
+    list(): DocumentRecord[];
+    subscribe(listener: () => void): () => void;
+    /** An AI version arrived. Applies it, merges it with user edits, or records a conflict. */
+    receive(incoming: IncomingDocument): ReceiveOutcome;
+    /** Seed or replace a document, for example from your database. */
+    hydrate(doc: IncomingDocument): void;
+    edit(id: string, json: DocJSON, origin: string): void;
+    setTitle(id: string, title: string): void;
+    resolve(id: string, choice: ResolveChoice): void;
+    remove(id: string): void;
+}
+declare function createDocumentStore(): DocumentStore;
+/** The shared in-memory store used when none is provided. Documents are keyed by documentId. */
+declare function getDefaultDocumentStore(): DocumentStore;
+
+/** Structural type of a Tiptap / ProseMirror JSON node. Dependency-free on purpose. */
+interface DocNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: DocNode[];
+    marks?: {
+        type: string;
+        attrs?: Record<string, unknown>;
+    }[];
+    text?: string;
+}
+/** Canonical document format: a Tiptap JSON document. */
+interface DocJSON {
+    type: "doc";
+    content?: DocNode[];
+}
+type DocumentExportFormat = "html" | "markdown" | "txt" | "docx" | "pdf";
+declare const ALL_EXPORT_FORMATS: readonly DocumentExportFormat[];
+interface DocumentSnapshot {
+    documentId: string;
+    title: string;
+    documentType?: string;
+    status?: string;
+    json: DocJSON;
+}
+interface DocumentChange extends DocumentSnapshot {
+    /** user = typed in the editor, ai = new AI version applied, merge = AI merged with user edits, resolve = conflict resolved. */
+    source: "user" | "ai" | "merge" | "resolve";
+}
+interface DocumentSavePayload extends DocumentSnapshot {
+    html: string;
+    markdown: string;
+}
+interface DocumentExportEvent {
+    documentId: string;
+    format: string;
+    filename: string;
+    mimeType: string;
+    blob?: Blob;
+    text?: string;
+    /** True when the exporter delivered the file itself (for example the PDF print dialog). */
+    handled?: boolean;
+}
+interface DocumentConflict {
+    documentId: string;
+    title: string;
+    /** Number of regions that both the user and the assistant changed. */
+    conflicts: number;
+}
+interface JuneDocumentOptions {
+    /** Share one store across editors. Defaults to a global in-memory store, keyed by documentId. */
+    store?: DocumentStore;
+    /** Debounce for autosave in ms (default 1500). 0 or less disables autosave. */
+    autosaveDelay?: number;
+    onDocumentChange?: (change: DocumentChange) => void;
+    /** Persist the document. Called by autosave, the Save button and Ctrl/Cmd+S. */
+    onSave?: (payload: DocumentSavePayload) => void | Promise<void>;
+    onExport?: (event: DocumentExportEvent) => void;
+    onDocumentReady?: (snapshot: DocumentSnapshot) => void;
+    onConflict?: (conflict: DocumentConflict) => void;
+    onError?: (error: JuneError) => void;
+}
+interface DocumentEditorProps {
+    documentId: string;
+    title?: string;
+    /** Markdown, a Tiptap JSON string, or a Tiptap JSON object. */
+    content?: string | DocJSON;
+    documentType?: string;
+    /** Default "draft". Drafts show an "AI draft" badge. */
+    status?: string;
+    editable?: boolean;
+    exportFormats?: string[];
+    /** "auto" follows the June theme context. */
+    theme?: "auto" | "light" | "dark";
+    className?: string;
+    /** Show the drafting placeholder instead of the editor (use while content is streaming). */
+    generating?: boolean;
+    /** Callbacks and store. Merged over the values provided through JuneUI's `documents` prop. */
+    options?: JuneDocumentOptions;
+}
+
 type JuneThemeVars = Record<string, string>;
 /** Colors only. June never sets fonts, radii or backgrounds. */
 declare const lightTheme: JuneThemeVars;
@@ -120,14 +255,17 @@ type JuneRendererProps = Omit<OpenUIRendererProps, "library" | "response" | "isS
     /** Accumulated model output. OpenUI does the incremental parsing. */
     response: string | null;
     isStreaming?: boolean;
-    /**
-     * Render prose around OpenUI statements (default true). The response may be
-     * plain OpenUI Lang, or prose + OpenUI Lang, optionally inside ``` fences.
-     * Set false to hand the response to OpenUI untouched.
-     */
+    /** Allow prose around OpenUI statements (default true). */
     mixedContent?: boolean;
     /** Custom renderer for prose segments. Default: <p className="june-text">. */
     renderText?: (text: string, index: number) => ReactNode;
+    /**
+     * Rewrite common model mistakes after streaming ends (default true):
+     * Grid and shorthand Card calls, and charts or tables left off root.
+     * Set false to hand the program to OpenUI unchanged.
+     */
+    repair?: boolean;
+    /** Omit to inherit the host app's look. "light" | "dark" | "system" opt in to June's colors. */
     theme?: JuneThemeMode;
     themeVars?: JuneThemeVars;
     className?: string;
@@ -139,8 +277,10 @@ type JuneRendererProps = Omit<OpenUIRendererProps, "library" | "response" | "isS
     onAction?: (event: OpenUIActionEvent) => void;
     /** Raw OpenUI errors (called with [] when they resolve). */
     onError?: (errors: unknown[]) => void;
-    /** Structured errors: parse, render, and action failures. */
+    /** Structured errors: parse, render, action, document and export failures. */
     onJuneError?: (error: JuneError) => void;
+    /** Document editor callbacks and store. Memoize this object. */
+    documents?: JuneDocumentOptions;
     loadingFallback?: ReactNode;
     emptyFallback?: ReactNode;
     errorFallback?: ReactNode | ((args: FallbackArgs) => ReactNode);
@@ -170,6 +310,12 @@ interface JuneContextValue {
     theme: JuneResolvedTheme;
 }
 declare function useJuneTheme(): JuneContextValue;
+interface JuneRuntimeValue {
+    /** True while the response is still streaming. Custom components use it to defer heavy work. */
+    isStreaming: boolean;
+}
+declare const JuneRuntimeContext: react.Context<JuneRuntimeValue>;
+declare function useJuneRuntime(): JuneRuntimeValue;
 
 /** Re-export of OpenUI's component definer under a June name. */
 declare const defineJuneComponent: typeof defineComponent;
@@ -252,10 +398,107 @@ declare function sseToText(source: StreamSource, options?: SseOptions & {
  */
 declare function jsonFieldExtractor(path: string): (data: string) => string | null;
 
+/** Standalone editor. While a June response is still streaming, shows a placeholder instead of mounting Tiptap. */
+declare function DocumentEditor(props: DocumentEditorProps): react.JSX.Element;
+declare const JuneDocumentEditorComponent: _openuidev_react_lang.DefinedComponent<z.ZodObject<{
+    documentId: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodString;
+    documentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    editable: z.ZodOptional<z.ZodBoolean>;
+    exportFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+type Extendable = Library & {
+    extend: NonNullable<Library["extend"]>;
+};
+/**
+ * Returns a library that contains every component of `library` plus DocumentEditor,
+ * and allows DocumentEditor inside Card (Stack already accepts any child).
+ * The library must include Card, which both OpenUI libraries do.
+ */
+declare function withDocumentEditor(library: Extendable): Required<_openuidev_lang_core.Library<_openuidev_react_lang.ComponentRenderer<any>, _openuidev_lang_core.DefinedAction<any, string>>>;
+
+declare const JuneDocumentContext: react.Context<JuneDocumentOptions>;
+declare function useDocumentOptions(): JuneDocumentOptions;
+
+declare function mergeDocuments(base: DocJSON, local: DocJSON, incoming: DocJSON): {
+    doc: DocJSON;
+    conflicts: number;
+};
+
+interface ExportContext {
+    documentId: string;
+    title: string;
+    json: DocJSON;
+    /** File name without extension. */
+    basename: string;
+}
+interface ExportResult {
+    filename: string;
+    mimeType: string;
+    blob?: Blob;
+    text?: string;
+    /** True when the exporter delivered the file itself, for example the print dialog for PDF. */
+    handled?: boolean;
+}
+type DocumentExporter = (context: ExportContext) => ExportResult | Promise<ExportResult>;
+/** Adds or replaces an export format. */
+declare function registerDocumentExporter(format: string, exporter: DocumentExporter): void;
+declare function listDocumentExporters(): string[];
+declare function exportDocument(format: string, doc: {
+    documentId: string;
+    title: string;
+    json: DocJSON;
+}): Promise<ExportResult>;
+/** Starts a browser download for results that carry a Blob. */
+declare function downloadResult(result: ExportResult): void;
+/** Copies rich text and plain text. Returns false if the browser refuses. */
+declare function copyDocumentToClipboard(doc: {
+    title: string;
+    json: DocJSON;
+}): Promise<boolean>;
+
+interface DocumentInstructionOptions {
+    /** Examples of document types for your product. Default covers common business documents. */
+    documentTypes?: string[];
+    /** Extra rules appended after the built-in ones (tone, legal disclaimers, language, ...). */
+    extraRules?: string[];
+    /** Name of the component in your library. Default "DocumentEditor". */
+    componentName?: string;
+}
+/** Rules for the model. Pass them through your backend to any agent. */
+declare function getDocumentEditorRules(options?: DocumentInstructionOptions): string[];
+/** Text block you can paste into any agent's system prompt. */
+declare function getDocumentEditorInstructions(options?: DocumentInstructionOptions): string;
+/**
+ * Options for OpenUI's `library.prompt(options)`. Merge these with your own PromptOptions.
+ * Example: library.prompt({ ...documentPromptOptions(), preamble: "..." })
+ */
+declare function documentPromptOptions(options?: DocumentInstructionOptions): {
+    additionalRules: string[];
+    examples: string[];
+};
+
+/**
+ * Serialises the documents the user currently has (including their edits) as Markdown,
+ * ready to attach to the next message so the agent can edit the right text.
+ */
+declare function serializeDocumentsForAgent(options?: {
+    store?: DocumentStore;
+    ids?: string[];
+}): Promise<string>;
+
 type JuneUIProps = Omit<JuneRendererProps, "library"> & {
-    /** Defaults to OpenUI's built-in library (same behaviour as 0.1.0). */
+    /** Defaults to June's library: OpenUI's components plus DocumentEditor. */
     library?: OpenUILibrary;
 };
 declare function JuneUI({ library, ...props }: JuneUIProps): react.JSX.Element;
 
-export { type ActionEventParser, type ActionOutcome, type ConfirmAction, type ConsumeStreamOptions, type FallbackArgs, type FetchStreamOptions, type JuneAction, type JuneActionContext, type JuneActionDefinition, type JuneActionMap, JuneError, JuneErrorBoundary, type JuneErrorBoundaryProps, type JuneErrorCode, type JuneErrorOptions, type JuneLibraryOptions, JuneRenderer, type JuneRendererProps, type JuneResolvedTheme, type JuneStreamState, type JuneThemeMode, JuneThemeProvider, type JuneThemeProviderProps, type JuneThemeVars, JuneUI, type JuneUIProps, type OpenUIActionEvent, type OpenUILibrary, type OpenUIRendererProps, type ParsedActionEvent, type RunActionOptions, type SchemaLike, type SseOptions, type StreamChunk, type StreamSource, type StreamStarter, type StreamStatus, type UseJuneStreamOptions, type UseJuneStreamResult, consumeStream, createActionHandler, createJuneLibrary, darkTheme, defaultParseActionEvent, defineJuneAction, defineJuneComponent, fetchStream, isJuneError, jsonFieldExtractor, lightTheme, runAction, sseToText, toJuneError, useJuneStream, useJuneTheme, useResolvedTheme };
+/**
+ * June's default library: every OpenUI component plus DocumentEditor.
+ * Created once so its reference stays stable.
+ */
+declare const juneLibrary: Required<_openuidev_lang_core.Library<_openuidev_react_lang.ComponentRenderer<any>, _openuidev_lang_core.DefinedAction<any, string>>>;
+
+export { ALL_EXPORT_FORMATS, type ActionEventParser, type ActionOutcome, type ConfirmAction, type ConsumeStreamOptions, type DocJSON, type DocNode, type DocumentChange, type DocumentConflict, DocumentEditor, type DocumentEditorProps, type DocumentExportEvent, type DocumentExportFormat, type DocumentExporter, type DocumentInstructionOptions, type DocumentRecord, type DocumentSavePayload, type DocumentSnapshot, type DocumentStore, type ExportContext, type ExportResult, type FallbackArgs, type FetchStreamOptions, type JuneAction, type JuneActionContext, type JuneActionDefinition, type JuneActionMap, JuneDocumentContext, JuneDocumentEditorComponent, type JuneDocumentOptions, JuneError, JuneErrorBoundary, type JuneErrorBoundaryProps, type JuneErrorCode, type JuneErrorOptions, type JuneLibraryOptions, JuneRenderer, type JuneRendererProps, type JuneResolvedTheme, JuneRuntimeContext, type JuneStreamState, type JuneThemeMode, JuneThemeProvider, type JuneThemeProviderProps, type JuneThemeVars, JuneUI, type JuneUIProps, type OpenUIActionEvent, type OpenUILibrary, type OpenUIRendererProps, type ParsedActionEvent, type RunActionOptions, type SchemaLike, type SseOptions, type StreamChunk, type StreamSource, type StreamStarter, type StreamStatus, type UseJuneStreamOptions, type UseJuneStreamResult, consumeStream, copyDocumentToClipboard, createActionHandler, createDocumentStore, createJuneLibrary, darkTheme, defaultParseActionEvent, defineJuneAction, defineJuneComponent, documentPromptOptions, downloadResult, exportDocument, fetchStream, getDefaultDocumentStore, getDocumentEditorInstructions, getDocumentEditorRules, isJuneError, jsonFieldExtractor, juneLibrary, lightTheme, listDocumentExporters, mergeDocuments, registerDocumentExporter, runAction, serializeDocumentsForAgent, sseToText, toJuneError, useDocumentOptions, useJuneRuntime, useJuneStream, useJuneTheme, useResolvedTheme, withDocumentEditor };