@promptbook/cli 0.113.0-9 → 0.114.0-0

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

@@ -0,0 +1,195 @@
+import type { string_language } from '../../types/string_token';
+/**
+ * One chapter of the standalone Book language manual.
+ *
+ * The heading anchors are intentionally **not** part of the dictionary, so deep
+ * links stay stable across languages.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageManualChapter = {
+    /**
+     * Translated chapter heading.
+     */
+    readonly title: string;
+    /**
+     * Translated chapter body as markdown.
+     */
+    readonly body: string;
+};
+/**
+ * Translated prose of one end-to-end example.
+ *
+ * The Book source of an example is language-neutral and therefore stays in
+ * `bookLanguageDocumentationExamples`.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageManualExampleText = {
+    /**
+     * Translated example heading.
+     */
+    readonly title: string;
+    /**
+     * Translated one-line goal of the example.
+     */
+    readonly goal: string;
+    /**
+     * Translated walkthrough steps explaining the example source.
+     */
+    readonly walkthrough: ReadonlyArray<string>;
+};
+/**
+ * One practical "don't vs do" pitfall item for Book language authoring.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageManualPitfall = {
+    /**
+     * Short pitfall title.
+     */
+    readonly title: string;
+    /**
+     * Description of what to avoid.
+     */
+    readonly dont: string;
+    /**
+     * Practical corrective action.
+     */
+    readonly doInstead: string;
+};
+/**
+ * Every translatable string of the standalone Book language manual.
+ *
+ * Commitment reference bodies are deliberately excluded, because they are the
+ * canonical English specification maintained next to each commitment in
+ * `src/commitments`.
+ *
+ * @private internal type of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageManualDictionary = {
+    /**
+     * Language code this dictionary is written in.
+     */
+    readonly language: string_language;
+    /**
+     * Manual title used as the top-level heading.
+     */
+    readonly title: string;
+    /**
+     * Blockquote lines rendered directly under the manual title.
+     */
+    readonly introLines: ReadonlyArray<string>;
+    /**
+     * Labels of the generated manual metadata bullets.
+     */
+    readonly metadataLabels: {
+        readonly bookLanguageVersion: string;
+        readonly generatedAt: string;
+        readonly commitmentGroups: string;
+        readonly implementedCommitments: string;
+        readonly placeholderCommitments: string;
+    };
+    /**
+     * Heading of the table of contents.
+     */
+    readonly tableOfContentsTitle: string;
+    /**
+     * Chapters rendered in their canonical order.
+     */
+    readonly chapters: {
+        readonly whatIs: BookLanguageManualChapter;
+        readonly mentalModel: BookLanguageManualChapter;
+        readonly howToStructure: BookLanguageManualChapter;
+        readonly primitives: BookLanguageManualChapter;
+        readonly commitmentCatalog: BookLanguageManualChapter;
+        readonly examples: Pick<BookLanguageManualChapter, 'title'>;
+        readonly pitfalls: Pick<BookLanguageManualChapter, 'title'>;
+        readonly tutorial: BookLanguageManualChapter;
+        readonly lowLevelCommitments: BookLanguageManualChapter;
+    };
+    /**
+     * Sub-sections of the "Mental model of an agent" chapter.
+     */
+    readonly mentalModelSections: {
+        readonly detectedIntro: string;
+        readonly detectedProfileLabel: string;
+        readonly detectedBehaviorLabel: string;
+        readonly detectedToolingLabel: string;
+        readonly detectedCompositionLabel: string;
+        readonly meta: BookLanguageManualChapter;
+        readonly inheritance: BookLanguageManualChapter;
+        readonly composition: BookLanguageManualChapter;
+        readonly capabilities: BookLanguageManualChapter;
+    };
+    /**
+     * Sub-sections of the "Primitives and constructs reference" chapter.
+     */
+    readonly primitivesSections: {
+        readonly coreSyntax: BookLanguageManualChapter;
+        readonly references: BookLanguageManualChapter;
+        readonly keywordsTitle: string;
+    };
+    /**
+     * Suffixes distinguishing a server-specific catalog from the portable one.
+     */
+    readonly commitmentCatalogTitleSuffixes: {
+        readonly usedFirst: string;
+        readonly all: string;
+    };
+    /**
+     * Labels used in every commitment catalog entry.
+     */
+    readonly commitmentLabels: {
+        readonly status: string;
+        readonly aliases: string;
+        readonly semantics: string;
+        readonly typeSchema: string;
+        readonly blockSchema: string;
+        readonly lowLevelNotice: string;
+        readonly usage: string;
+        readonly usageOccurrence: string;
+        readonly usageOccurrences: string;
+        readonly statusImplemented: string;
+        readonly statusPlaceholder: string;
+        readonly noAliases: string;
+    };
+    /**
+     * Labels used by end-to-end example sections.
+     */
+    readonly exampleLabels: {
+        readonly commitmentsUsed: string;
+        readonly fullSource: string;
+        readonly goal: string;
+        readonly walkthrough: string;
+        readonly noCommitments: string;
+    };
+    /**
+     * Translated prose of the portable examples, keyed by example id.
+     */
+    readonly exampleTexts: Readonly<Record<string, BookLanguageManualExampleText>>;
+    /**
+     * Labels used by the "Do nots and common pitfalls" chapter.
+     */
+    readonly pitfallLabels: {
+        readonly dont: string;
+        readonly doInstead: string;
+    };
+    /**
+     * Translated pitfall entries.
+     */
+    readonly pitfalls: ReadonlyArray<BookLanguageManualPitfall>;
+    /**
+     * Closing parts of the "Build an agent from scratch" chapter.
+     */
+    readonly tutorialSections: {
+        readonly serverAgentsHint: string;
+        readonly templateIntro: string;
+        readonly checklistTitle: string;
+        readonly checklistBody: string;
+    };
+    /**
+     * Closing "Generated from" block of the manual.
+     */
+    readonly footer: BookLanguageManualChapter;
+};

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

@@ -3,7 +3,8 @@ import type { BookLanguageDocumentationExample } from './BookLanguageDocumentati
  * End-to-end examples used by the standalone Book language documentation.
  *
  * These are intentionally compact but complete, so they can be copy-pasted and
- * used as practical starting points.
+ * used as practical starting points. Their prose lives in the manual
+ * dictionaries, keyed by the `id` of each example.
  *
  * @private internal utility of `createStandaloneBookLanguageMarkdown`
  */

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

@@ -1,4 +1,46 @@
+import type { string_book } from '../agent-source/string_book';
 import type { string_markdown } from '../../types/string_markdown';
+import type { string_language } from '../../types/string_token';
+/**
+ * Agent source incorporated into a server-specific Book language manual.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type BookLanguageDocumentationAgent = {
+    /**
+     * Human-readable title shown above the baked example.
+     */
+    readonly agentName: string;
+    /**
+     * Current Book source used both as an example and to detect used commitments.
+     */
+    readonly agentSource: string_book;
+};
+/**
+ * Optional context used to tailor a standalone Book language manual.
+ *
+ * An empty `agents` array deliberately has the same effect as omitting this
+ * option, which keeps the non-customized manual portable between servers.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type CreateStandaloneBookLanguageMarkdownOptions = {
+    /**
+     * Server agents whose sources should be baked into examples and usage priority.
+     */
+    readonly agents?: ReadonlyArray<BookLanguageDocumentationAgent>;
+    /**
+     * Language the manual should be written in, English is used as the fallback.
+     */
+    readonly language?: string_language;
+    /**
+     * Whether the closing chapter with low-level commitments should be generated.
+     *
+     * Low-level commitments are intended for advanced use only, so they are
+     * omitted unless they are explicitly requested.
+     */
+    readonly isLowLevelCommitmentsIncluded?: boolean;
+};
 /**
  * Creates one standalone markdown guide for Book language (Book 2.0 / agent language).
  *
@@ -11,4 +53,4 @@ import type { string_markdown } from '../../types/string_markdown';
  *
  * @public exported from `@promptbook/core`
  */
-export declare function createStandaloneBookLanguageMarkdown(): string_markdown;
+export declare function createStandaloneBookLanguageMarkdown(options?: CreateStandaloneBookLanguageMarkdownOptions): string_markdown;

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/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/Chat/Chat/ChatCitationModal.d.ts

@@ -13,6 +13,11 @@ export type ChatCitationModalProps = {
     participants: ReadonlyArray<ChatParticipant>;
     resolveCitationLabel?: CitationLabelResolver;
     soundSystem?: ChatSoundSystem;
+    /**
+     * Optional agent identifier (name or permanent id) scoping the live browser fallback
+     * to the agent's persistent server-side browser profile.
+     */
+    agentIdentifier?: string;
     onClose: () => void;
 };
 /**

package/esm/src/book-components/Chat/Chat/ChatCitationModal.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/Chat/ChatFeedbackStar.d.ts

@@ -0,0 +1,37 @@
+import type { MouseEventHandler } from 'react';
+/**
+ * Star values available in the chat feedback UI.
+ *
+ * @private constant of `<Chat/>`
+ */
+export declare const CHAT_FEEDBACK_STAR_RATINGS: readonly [1, 2, 3, 4, 5];
+/**
+ * Props for the shared chat feedback star icon.
+ *
+ * @private type of `<Chat/>`
+ */
+type ChatFeedbackStarProps = {
+    readonly isActive: boolean;
+    readonly inactiveColor: string;
+    readonly className?: string;
+    readonly onClick?: MouseEventHandler<HTMLSpanElement>;
+    readonly onMouseEnter?: MouseEventHandler<HTMLSpanElement>;
+    readonly onMouseLeave?: MouseEventHandler<HTMLSpanElement>;
+};
+/**
+ * Resolves the inactive color for stars in the feedback controls.
+ *
+ * @param mode Current chat color mode.
+ * @param tone Visual weight for the inactive star.
+ * @returns Hex color for an inactive star.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function resolveChatFeedbackStarInactiveColor(mode: 'LIGHT' | 'DARK', tone?: 'subtle' | 'muted'): "#888" | "#666" | "#ccc" | "#555";
+/**
+ * Renders one CSS-colored feedback star.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatFeedbackStar({ isActive, inactiveColor, className, onClick, onMouseEnter, onMouseLeave, }: ChatFeedbackStarProps): import("react/jsx-runtime").JSX.Element;
+export {};