@promptbook/node 0.113.0-8 → 0.114.0-0

package/esm/src/book-2.0/book-language-documentation/czechBookLanguageManualDictionary.d.ts

@@ -0,0 +1,10 @@
+import type { BookLanguageManualDictionary } from './BookLanguageManualDictionary';
+/**
+ * Czech translation of the standalone Book language manual.
+ *
+ * Commitment keywords are intentionally kept in English, because they are part
+ * of the Book language syntax and must be written exactly as-is.
+ *
+ * @private internal constant of `createStandaloneBookLanguageMarkdown`
+ */
+export declare const czechBookLanguageManualDictionary: BookLanguageManualDictionary;

package/esm/src/book-2.0/book-language-documentation/englishBookLanguageManualDictionary.d.ts

@@ -0,0 +1,10 @@
+import type { BookLanguageManualDictionary } from './BookLanguageManualDictionary';
+/**
+ * Canonical English wording of the standalone Book language manual.
+ *
+ * Every other language pack is a translation of this dictionary and is resolved
+ * through `getBookLanguageManualDictionary`.
+ *
+ * @private internal constant of `createStandaloneBookLanguageMarkdown`
+ */
+export declare const englishBookLanguageManualDictionary: BookLanguageManualDictionary;

package/esm/src/book-2.0/book-language-documentation/getBookLanguageManualCommitmentGroups.d.ts

@@ -0,0 +1,33 @@
+import { getGroupedCommitmentDefinitions } from '../../commitments/_common/getGroupedCommitmentDefinitions';
+/**
+ * One grouped commitment definition as returned by the runtime registry.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageManualCommitmentGroup = ReturnType<typeof getGroupedCommitmentDefinitions>[number];
+/**
+ * Commitment groups of the manual, split by how prominently they are documented.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageManualCommitmentGroups = {
+    /**
+     * Commitments documented in the main catalog.
+     */
+    readonly documented: ReadonlyArray<BookLanguageManualCommitmentGroup>;
+    /**
+     * Low-level and unfinished commitments documented in their own closing chapter.
+     */
+    readonly lowLevel: ReadonlyArray<BookLanguageManualCommitmentGroup>;
+};
+/**
+ * Splits the commitment registry into the groups documented by the manual.
+ *
+ * Deprecated commitments are intentionally left out completely, so that the
+ * manual never teaches a keyword that should no longer be written into a book.
+ *
+ * @returns Commitment groups for the main catalog and for the low-level chapter.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare function getBookLanguageManualCommitmentGroups(): BookLanguageManualCommitmentGroups;

package/esm/src/book-2.0/book-language-documentation/getBookLanguageManualDictionary.d.ts

@@ -0,0 +1,15 @@
+import type { string_language } from '../../types/string_token';
+import type { BookLanguageManualDictionary } from './BookLanguageManualDictionary';
+/**
+ * Resolves the manual dictionary for one requested language.
+ *
+ * Unknown and region-qualified codes (for example `cs-CZ`) fall back to the
+ * closest available pack and finally to English, so an export never fails
+ * because of an unsupported language.
+ *
+ * @param language - Requested language code.
+ * @returns Manual dictionary for the requested language or the English fallback.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare function getBookLanguageManualDictionary(language: string_language | null | undefined): BookLanguageManualDictionary;

package/esm/src/book-2.0/book-language-documentation/getSafeCodeBlock.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Creates a safe markdown fenced code block even when content contains backticks.
+ *
+ * @param content - Raw code content.
+ * @param language - Optional info-string language label.
+ * @returns Fenced code block.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare function getSafeCodeBlock(content: string, language?: string): string;

package/esm/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.d.ts

@@ -0,0 +1,30 @@
+import type { BookLanguageManualDictionary } from './BookLanguageManualDictionary';
+import type { BookLanguageManualCommitmentGroup } from './getBookLanguageManualCommitmentGroups';
+/**
+ * Options for rendering one commitment section of the generated catalog.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type RenderCommitmentCatalogSectionOptions = {
+    /**
+     * Grouped commitment definition with aliases.
+     */
+    readonly groupedCommitment: BookLanguageManualCommitmentGroup;
+    /**
+     * Number of uses across the selected server agents.
+     */
+    readonly usageCount: number;
+    /**
+     * Translated labels of the manual.
+     */
+    readonly dictionary: BookLanguageManualDictionary;
+};
+/**
+ * Renders one commitment section in the generated catalog.
+ *
+ * @param options - Commitment group, usage statistics, and translated labels.
+ * @returns Markdown section for a single commitment.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare function renderCommitmentCatalogSection(options: RenderCommitmentCatalogSectionOptions): string;

package/esm/src/book-2.0/book-language-documentation/renderGroupedCommitmentDocumentationMarkdown.d.ts

@@ -35,9 +35,10 @@ type GroupedCommitmentDocumentationSource = {
  * surfaces present them as one conceptual switch instead of two isolated pages.
  *
  * @param group - Grouped commitment metadata.
+ * @param headingLevelShift - How many levels the entry is nested by its host document.
  * @returns Markdown body for the docs page/catalog entry.
  *
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */
-export declare function renderGroupedCommitmentDocumentationMarkdown(group: GroupedCommitmentDocumentationSource): string;
+export declare function renderGroupedCommitmentDocumentationMarkdown(group: GroupedCommitmentDocumentationSource, headingLevelShift?: number): string;
 export {};

package/esm/src/book-2.0/book-language-documentation/toStableAnchorId.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Converts a heading label into a stable markdown anchor id.
+ *
+ * Anchors are generated from language-neutral identifiers, so deep links into
+ * the manual keep working in every translation.
+ *
+ * @param value - Raw heading/identifier text.
+ * @returns Stable lowercase anchor id.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare function toStableAnchorId(value: string): string;

package/esm/src/book-3.0/AgentMessageRunReport.d.ts

@@ -0,0 +1,78 @@
+import type { Usage } from '../execution/Usage';
+import type { CodexLoginMethod } from './codexLoginMethod';
+/**
+ * File suffix appended to one answered message book to store its run report sidecar.
+ *
+ * For example `messages/finished/2026-07-16-thread.book` is reported in
+ * `messages/finished/2026-07-16-thread.book.report.json`.
+ *
+ * @private internal constant of the agent folder convention
+ */
+export declare const AGENT_MESSAGE_RUN_REPORT_FILE_SUFFIX = ".report.json";
+/**
+ * Report describing how one queued agent message was answered by a CLI harness runner.
+ *
+ * The agent runner writes it next to the answered message book so consumers
+ * (for example the Agents Server task details) can show which runner, authentication
+ * method and usage one answer cost without re-parsing the runner output.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @private internal type of the agent folder convention
+ */
+export type AgentMessageRunReport = {
+    /**
+     * Report schema version for forward compatibility.
+     */
+    readonly version: 1;
+    /**
+     * Name of the harness runner which answered the message, for example `codex` or `claude-code`.
+     */
+    readonly runnerName: string;
+    /**
+     * Model identifier used by the runner, when known.
+     */
+    readonly modelName?: string;
+    /**
+     * Authentication method the runner used, when it can be determined.
+     *
+     * Currently only the OpenAI Codex runner reports this (its ChatGPT account vs. `OPENAI_API_KEY`);
+     * other runners leave it `undefined`.
+     */
+    readonly loginMethod?: CodexLoginMethod;
+    /**
+     * Usage statistics of the run (price, token counts, duration).
+     */
+    readonly usage: Usage;
+};
+/**
+ * Builds the run-report sidecar path for one message book path.
+ *
+ * Works for absolute and relative paths because the suffix is simply appended.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function buildAgentMessageRunReportPath(messageFilePath: string): string;
+/**
+ * Serializes one run report into the stable JSON format persisted next to the answered message book.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function serializeAgentMessageRunReport(report: AgentMessageRunReport): string;
+/**
+ * Validates one already-parsed JSON value as a run report.
+ *
+ * @returns The typed report, or `null` when the value does not match the expected shape,
+ * so consumers can silently skip malformed or foreign sidecar files.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function normalizeAgentMessageRunReport(value: unknown): AgentMessageRunReport | null;
+/**
+ * Parses one run-report sidecar file content.
+ *
+ * @returns The typed report, or `null` when the content is not valid JSON or does not match the expected shape.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function parseAgentMessageRunReport(reportFileContent: string): AgentMessageRunReport | null;

package/esm/src/book-3.0/agentFolderPaths.d.ts

@@ -28,3 +28,12 @@ export declare const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH: string;
  * @public exported from `@promptbook/node`
  */
 export declare const AGENT_FAILED_MESSAGES_DIRECTORY_PATH: string;
+/**
+ * Relative path to the agent-owned projects root used by the agent folder convention.
+ *
+ * Each direct child directory is one project — an isolated folder the agent fully controls
+ * (files, scripts, optionally its own git repository).
+ *
+ * @private internal constant of the agent folder convention, used by agent runners and the Agents Server
+ */
+export declare const AGENT_PROJECTS_DIRECTORY_PATH = "projects";

package/esm/src/book-3.0/codexLoginMethod.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Authentication method that the OpenAI Codex CLI used for one run.
+ *
+ * - `chatgpt` — the server's ChatGPT account (subscription) login was used.
+ * - `api` — `OPENAI_API_KEY` API-key authentication was used.
+ * - `unknown` — the runner could not determine which method Codex used.
+ *
+ * @private internal type of the OpenAI Codex runner and the Agents Server task details
+ */
+export type CodexLoginMethod = 'chatgpt' | 'api' | 'unknown';
+/**
+ * Stable stdout marker printed by the generated Codex runner script to report which login method it used.
+ *
+ * The marker is followed by the resolved method keyword, for example `ptbk-codex-login-method: chatgpt`,
+ * so `parseCodexLoginMethodFromOutput` can recover it from the captured runner output.
+ *
+ * @private internal constant of the OpenAI Codex runner
+ */
+export declare const CODEX_LOGIN_METHOD_MARKER = "ptbk-codex-login-method:";
+/**
+ * Substring that the `codex login status` command prints when the Codex CLI is signed in with a
+ * ChatGPT subscription account instead of an `OPENAI_API_KEY`.
+ *
+ * This is the single source of truth for detecting an active ChatGPT login, reused by the Codex runner
+ * script and by the Agents Server harness authentication status resolver.
+ *
+ * @private internal constant of the OpenAI Codex runner and the Agents Server Harness Auth
+ */
+export declare const CODEX_CHATGPT_LOGIN_STATUS_NEEDLE = "Logged in using ChatGPT";
+/**
+ * Formats one Codex login method as a short human-readable label for prompt status lines and task details.
+ *
+ * @returns The label to append to a status line, or `undefined` when there is no meaningful method to show
+ * (for example the runner is not Codex or the method could not be determined), so callers can omit the suffix.
+ *
+ * @private internal utility of the OpenAI Codex runner and the Agents Server task details
+ */
+export declare function formatCodexLoginMethod(loginMethod: CodexLoginMethod | undefined): string | undefined;

package/esm/src/book-components/BookEditor/BookEditorMonacoUploadPanel.d.ts

@@ -1,4 +1,4 @@
-import type { UploadItem, UploadStats } from './useBookEditorMonacoUploads';
+import type { UploadItem, UploadStats } from './useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
 /**
  * Props for book editor monaco upload panel.
  */

package/esm/src/book-components/BookEditor/BookEditorSyntaxTokenStyles.d.ts

@@ -0,0 +1,39 @@
+/**
+ * One token emitted while highlighting Book source.
+ *
+ * @private internal type of `BookEditor`
+ */
+export type BookEditorSyntaxTokenName = 'title' | 'commitment' | 'note-commitment' | 'todo-commitment' | 'parameter' | 'agent-reference' | 'code-block';
+/**
+ * Visual style of one Book syntax token.
+ *
+ * @private internal type of `BookEditor`
+ */
+export type BookEditorSyntaxTokenStyle = {
+    /**
+     * Token this style belongs to.
+     */
+    readonly token: BookEditorSyntaxTokenName;
+    /**
+     * Text color of the token.
+     */
+    readonly foreground: string;
+    /**
+     * Optional background color of the token.
+     */
+    readonly background?: string;
+    /**
+     * Optional space-separated font style, for example `bold underline`.
+     */
+    readonly fontStyle?: string;
+};
+/**
+ * Single source of truth for how Book source is colored.
+ *
+ * The Monaco theme of `<BookEditor/>` and every static rendering of Book source
+ * (for example the Book language manual PDF) are derived from these styles, so
+ * a book always looks the same no matter where it is displayed.
+ *
+ * @private internal constant of `BookEditor`
+ */
+export declare const BOOK_EDITOR_SYNTAX_TOKEN_STYLES: ReadonlyArray<BookEditorSyntaxTokenStyle>;

package/esm/src/book-components/BookEditor/createBookSourceHighlightStyles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Creates the CSS matching the markup of `highlightBookSourceToHtml`.
+ *
+ * Both the stylesheet and the markup are derived from the shared
+ * `BOOK_EDITOR_SYNTAX_TOKEN_STYLES`, therefore a statically rendered book keeps
+ * the exact colors of `<BookEditor/>`.
+ *
+ * @returns CSS rules for every Book syntax token.
+ *
+ * @private internal utility of `BookEditor`
+ */
+export declare function createBookSourceHighlightStyles(): string;

package/esm/src/book-components/BookEditor/highlightBookSourceToHtml.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prefix of the CSS class names emitted for highlighted Book source.
+ *
+ * @private internal constant of `BookEditor`
+ */
+export declare const BOOK_SYNTAX_TOKEN_CLASS_NAME_PREFIX = "book-syntax-";
+/**
+ * Highlights Book source into static HTML using the `<BookEditor/>` token colors.
+ *
+ * `<BookEditor/>` itself is a Monaco-based browser component and cannot run
+ * where a book has to be rendered as plain markup (server-side exports such as
+ * the Book language manual PDF). This function reuses the very same
+ * tokenization patterns and token names, so both surfaces stay in sync.
+ *
+ * @param bookSource - Raw Book source to highlight.
+ * @returns HTML with one `<span>` per highlighted token, safe to place into `<pre>`.
+ *
+ * @private internal utility of `BookEditor`
+ */
+export declare function highlightBookSourceToHtml(bookSource: string): string;

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/bookEditorMonacoUploadTypes.d.ts

@@ -0,0 +1,120 @@
+import type { MutableRefObject } from 'react';
+import type { Promisable } from 'type-fest';
+/**
+ * Type describing upload status.
+ *
+ * @private function of BookEditorMonaco
+ */
+type UploadStatus = 'queued' | 'uploading' | 'paused' | 'completed' | 'failed';
+/**
+ * Type describing upload item.
+ */
+export type UploadItem = {
+    readonly id: string;
+    readonly fileName: string;
+    readonly fileSize: number;
+    readonly status: UploadStatus;
+    readonly progress: number;
+    readonly loadedBytes: number;
+    readonly totalBytes: number;
+    readonly startedAt: number | null;
+    readonly completedAt: number | null;
+    readonly errorMessage?: string;
+};
+/**
+ * Type describing upload progress update.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadProgressUpdate = {
+    readonly progress: number;
+    readonly loadedBytes: number;
+    readonly totalBytes: number;
+};
+/**
+ * Type describing placeholder entry inserted into Monaco while the file uploads.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadPlaceholderEntry = {
+    readonly id: string;
+    readonly file: File;
+    readonly placeholder: string;
+};
+/**
+ * Type describing upload stats.
+ */
+export type UploadStats = {
+    readonly totalFiles: number;
+    readonly queuedFiles: number;
+    readonly uploadingFiles: number;
+    readonly pausedFiles: number;
+    readonly failedFiles: number;
+    readonly completedFiles: number;
+    readonly totalBytes: number;
+    readonly uploadedBytes: number;
+    readonly progress: number;
+    readonly elapsedMs: number;
+    readonly speedBytesPerSecond: number;
+};
+/**
+ * Type describing book editor monaco upload progress callback.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type BookEditorMonacoUploadProgressCallback = (progress: number, stats?: {
+    loadedBytes: number;
+    totalBytes: number;
+}) => void;
+/**
+ * Options for book editor monaco upload.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type BookEditorMonacoUploadOptions = {
+    readonly onProgress?: BookEditorMonacoUploadProgressCallback;
+    readonly abortSignal?: AbortSignal;
+};
+/**
+ * Type describing book editor monaco on file upload.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type BookEditorMonacoOnFileUpload = (file: File, options?: BookEditorMonacoUploadOptions | BookEditorMonacoUploadProgressCallback) => Promisable<string>;
+/**
+ * Setter-like updater used by upload state helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type SetUploadItems = (updater: (items: UploadItem[]) => UploadItem[]) => void;
+/**
+ * Single-upload updater used by upload state helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UpdateUploadItem = (uploadId: string, createNextUploadItem: (uploadItem: UploadItem) => UploadItem) => void;
+/**
+ * Mutable upload items reference shared across upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadItemsRef = MutableRefObject<UploadItem[]>;
+/**
+ * Mutable upload file registry reference shared across upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadFilesRef = MutableRefObject<Map<string, File>>;
+/**
+ * Mutable Monaco decoration registry reference shared across upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadDecorationIdsRef = MutableRefObject<Map<string, string>>;
+/**
+ * Type describing the callback used to enqueue debounced progress updates.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type QueueProgressUpdate = (uploadId: string, progress: number, loadedBytes: number, totalBytes: number) => void;
+export {};

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/clearScheduledTimer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Clears an optional scheduled timer when it exists.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function clearScheduledTimer(timerId: number | null): void;

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/enqueueFilesForUpload.d.ts

@@ -0,0 +1,26 @@
+import type { editor } from 'monaco-editor';
+import type { SetUploadItems, UploadPlaceholderEntry } from './bookEditorMonacoUploadTypes';
+/**
+ * Type describing monaco editor.
+ *
+ * @private function of BookEditorMonaco
+ */
+type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Props for Monaco placeholder insertion.
+ *
+ * @private function of BookEditorMonaco
+ */
+type EnqueueFilesForUploadProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly monaco: MonacoEditor | null;
+    readonly registerUploadPlaceholderResources: (placeholders: ReadonlyArray<UploadPlaceholderEntry>, decorationIds: ReadonlyArray<string>) => void;
+    readonly setUploadItems: SetUploadItems;
+};
+/**
+ * Inserts Monaco placeholders and queues matching upload items.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function enqueueFilesForUpload({ editor, monaco, registerUploadPlaceholderResources, setUploadItems, }: EnqueueFilesForUploadProps): (files: ReadonlyArray<File>) => boolean;
+export {};

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadEditorSync.d.ts

@@ -0,0 +1,23 @@
+import type { editor } from 'monaco-editor';
+import type { UploadDecorationIdsRef, UploadFilesRef, UploadPlaceholderEntry } from './bookEditorMonacoUploadTypes';
+/**
+ * Props for Monaco placeholder and replacement synchronization.
+ *
+ * @private function of BookEditorMonaco
+ */
+type UseBookEditorMonacoUploadEditorSyncProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly uploadDecorationIdsRef: UploadDecorationIdsRef;
+};
+/**
+ * Manages Monaco placeholder insertion and later replacement with uploaded URLs.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadEditorSync({ editor, uploadFilesRef, uploadDecorationIdsRef, }: UseBookEditorMonacoUploadEditorSyncProps): {
+    registerUploadPlaceholderResources: (placeholders: ReadonlyArray<UploadPlaceholderEntry>, decorationIds: ReadonlyArray<string>) => void;
+    queueEditorReplacement: (uploadId: string, replacementText: string) => void;
+    clearEditorSync: () => void;
+};
+export {};

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadItemsState.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+import type { SetUploadItems, UpdateUploadItem, UploadItem, UploadStats } from './bookEditorMonacoUploadTypes';
+/**
+ * Updates one upload item while leaving every other item untouched.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function replaceUploadItemById(uploadItems: ReadonlyArray<UploadItem>, uploadId: string, updateUploadItem: (uploadItem: UploadItem) => UploadItem): Array<UploadItem>;
+/**
+ * Internal upload item state shared by Monaco upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadItemsState(): {
+    uploadItems: UploadItem[];
+    uploadItemsRef: import("react").RefObject<UploadItem[]>;
+    setUploadItems: SetUploadItems;
+    updateUploadItem: UpdateUploadItem;
+    uploadStats: UploadStats;
+    activeUploadItems: UploadItem[];
+};

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadProgressQueue.d.ts

@@ -0,0 +1,12 @@
+import type { SetUploadItems } from './bookEditorMonacoUploadTypes';
+/**
+ * Debounces upload progress updates before they hit React state.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadProgressQueue({ setUploadItems, }: {
+    readonly setUploadItems: SetUploadItems;
+}): {
+    queueProgressUpdate: (uploadId: string, progress: number, loadedBytes: number, totalBytes: number) => void;
+    clearProgressQueue: () => void;
+};

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadQueue.d.ts

@@ -0,0 +1,27 @@
+import type { BookEditorMonacoOnFileUpload, QueueProgressUpdate, SetUploadItems, UpdateUploadItem, UploadFilesRef, UploadItemsRef } from './bookEditorMonacoUploadTypes';
+/**
+ * Props for upload queue processing and pause/resume handling.
+ *
+ * @private function of BookEditorMonaco
+ */
+type UseBookEditorMonacoUploadQueueProps = {
+    readonly onFileUpload?: BookEditorMonacoOnFileUpload;
+    readonly uploadItemsRef: UploadItemsRef;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly queueProgressUpdate: QueueProgressUpdate;
+    readonly queueEditorReplacement: (uploadId: string, replacementText: string) => void;
+    readonly setUploadItems: SetUploadItems;
+    readonly updateUploadItem: UpdateUploadItem;
+};
+/**
+ * Manages upload concurrency, retries, pausing and completion side effects.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadQueue({ onFileUpload, uploadItemsRef, uploadFilesRef, queueProgressUpdate, queueEditorReplacement, setUploadItems, updateUploadItem, }: UseBookEditorMonacoUploadQueueProps): {
+    pauseUpload: (uploadId: string) => void;
+    resumeUpload: (uploadId: string) => void;
+    queueUploadProcessing: () => void;
+    clearUploadQueue: () => void;
+};
+export {};

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads/useCompletedUploadsAutoClear.d.ts

@@ -0,0 +1,12 @@
+import type { SetUploadItems, UploadDecorationIdsRef, UploadFilesRef, UploadItem } from './bookEditorMonacoUploadTypes';
+/**
+ * Clears upload UI state shortly after all uploads finish.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useCompletedUploadsAutoClear({ uploadItems, uploadFilesRef, uploadDecorationIdsRef, setUploadItems, }: {
+    readonly uploadItems: ReadonlyArray<UploadItem>;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly uploadDecorationIdsRef: UploadDecorationIdsRef;
+    readonly setUploadItems: SetUploadItems;
+}): void;