@webority/ui-elements 0.29.0 → 0.31.0

package/dist/{fileViewerPdf-C02nR-30.js → fileViewerPdf-BnIsj-J-.js}

@@ -15140,15 +15140,45 @@ function na(e) {
 	}
 	ta ??= URL.createObjectURL(new Blob([Fi], { type: "text/javascript" })), jn.workerSrc = ta;
 }
-var ra = (e) => {
+function ra(e) {
+	let t = e ? e.replace(/\/?$/, "/") : null;
+	return {
+		isEvalSupported: !1,
+		...t && {
+			cMapUrl: `${t}cmaps/`,
+			cMapPacked: !0,
+			standardFontDataUrl: `${t}standard_fonts/`,
+			wasmUrl: `${t}wasm/`
+		}
+	};
+}
+async function ia(e, { workerSrc: t, assetBase: n, width: r = 640 } = {}) {
+	na(t);
+	let i = hr({
+		...e instanceof Blob ? { data: new Uint8Array(await e.arrayBuffer()) } : { url: e.url },
+		...ra(n)
+	});
+	try {
+		let e = await (await i.promise).getPage(1), t = e.getViewport({ scale: r / e.getViewport({ scale: 1 }).width }), n = document.createElement("canvas");
+		return n.width = Math.floor(t.width), n.height = Math.floor(t.height), await e.render({
+			canvas: n,
+			viewport: t
+		}).promise, await new Promise((e, t) => {
+			n.toBlob((n) => n ? e(n) : t(/* @__PURE__ */ Error("The first page could not be drawn.")), "image/png");
+		});
+	} finally {
+		await i.destroy();
+	}
+}
+var aa = (e) => {
 	if (Wi.some((t) => t.key === e)) return e;
 	let t = Number(e);
 	return Hi.includes(t) ? t : "fit-width";
-}, ia = (e) => e instanceof Element && e.closest("input, textarea, select, [contenteditable='true'], .dropdown-menu"), aa = (e) => /^(https?:|mailto:)/i.test(e), oa = class {
+}, oa = (e) => e instanceof Element && e.closest("input, textarea, select, [contenteditable='true'], .dropdown-menu"), sa = (e) => /^(https?:|mailto:)/i.test(e), ca = class {
 	constructor(e, t) {
 		this.shell = e, this.source = t;
 		let n = e.prefs;
-		this.zoom = ra(n.zoom), this.twoPage = n.twoPage === !0, this.showThumbs = n.thumbnails === !0, this.pdf = null, this.sizes = [], this.rows = [], this.rowOf = [], this.scale = 0, this.drawnScale = 0, this.pages = /* @__PURE__ */ new Map(), this.thumbsDrawn = /* @__PURE__ */ new Set(), this.area = {
+		this.zoom = aa(n.zoom), this.twoPage = n.twoPage === !0, this.showThumbs = n.thumbnails === !0, this.pdf = null, this.sizes = [], this.rows = [], this.rowOf = [], this.scale = 0, this.drawnScale = 0, this.pages = /* @__PURE__ */ new Map(), this.thumbsDrawn = /* @__PURE__ */ new Set(), this.area = {
 			width: 0,
 			height: 0
 		}, this.scrollPos = {
@@ -15165,32 +15195,24 @@ var ra = (e) => {
 		}, this.printRun = null, this.destroyed = !1, this._timers = /* @__PURE__ */ new Set();
 	}
 	async load() {
-		na(this.source.workerSrc);
-		let e = this.source.assetBase ? this.source.assetBase.replace(/\/?$/, "/") : null;
-		this.task = hr({
+		na(this.source.workerSrc), this.task = hr({
 			url: this.source.src,
-			isEvalSupported: !1,
-			...e && {
-				cMapUrl: `${e}cmaps/`,
-				cMapPacked: !0,
-				standardFontDataUrl: `${e}standard_fonts/`,
-				wasmUrl: `${e}wasm/`
-			}
+			...ra(this.source.assetBase)
 		});
-		let t;
+		let e;
 		try {
-			t = await this.task.promise;
+			e = await this.task.promise;
 		} catch (e) {
 			this.destroyed || this.shell.fail(e);
 			return;
 		}
 		if (this.destroyed) {
-			t.destroy();
+			e.destroy();
 			return;
 		}
-		this.pdf = t;
-		let n = await Promise.all(Array.from({ length: t.numPages }, (e, n) => t.getPage(n + 1)));
-		this.destroyed || (this.sizes = n.map((e) => {
+		this.pdf = e;
+		let t = await Promise.all(Array.from({ length: e.numPages }, (t, n) => e.getPage(n + 1)));
+		this.destroyed || (this.sizes = t.map((e) => {
 			let t = e.getViewport({ scale: Gi });
 			return {
 				width: t.width,
@@ -15198,7 +15220,7 @@ var ra = (e) => {
 			};
 		}), this._buildToolbar(), this._buildBody(), this._layout(), this.shell.loaded({
 			kind: "pdf",
-			pages: t.numPages
+			pages: e.numPages
 		}));
 	}
 	destroy() {
@@ -15236,7 +15258,7 @@ var ra = (e) => {
 					checked: this.zoom === e.key
 				}))
 			],
-			onPick: (e) => this._setZoom(ra(e))
+			onPick: (e) => this._setZoom(aa(e))
 		}), this.zoomInButton = r("zoom-in", "Zoom in"), this.zoomInButton.addEventListener("click", () => this._stepZoom(1));
 		let c = document.createElement("span");
 		c.className = "wui-file-viewer-divider", this.twoPageButton = r("two-page", "Two-page view"), this.twoPageButton.addEventListener("click", () => this._setTwoPage(!this.twoPage)), this.printButton = r("printer", "Print"), this.printButton.addEventListener("click", () => this.print()), i.prepend(this.searchButton, this.zoomOutButton, this.zoomButton, this.zoomInButton, c, this.twoPageButton, this.printButton), this._buildSearchRow(), this._syncToolbar();
@@ -15291,7 +15313,7 @@ var ra = (e) => {
 	}
 	_targetScale() {
 		if (typeof this.zoom == "number") return this.zoom;
-		let e = this.cols(), t = ua(this.sizes.map((e) => e.width)), n = ua(this.sizes.map((e) => e.height)), r = (this.area.width - 2 * Ki - (e - 1) * qi) / (t * e);
+		let e = this.cols(), t = fa(this.sizes.map((e) => e.width)), n = fa(this.sizes.map((e) => e.height)), r = (this.area.width - 2 * Ki - (e - 1) * qi) / (t * e);
 		return this.zoom === "fit-page" && (r = Math.min(r, (this.area.height - 2 * Ki) / n)), Math.max(r, .1);
 	}
 	_layout() {
@@ -15465,7 +15487,7 @@ var ra = (e) => {
 	async _drawLinks(e) {
 		let t = await this.pdf.getPage(e.n), n = await t.getAnnotations({ intent: "display" });
 		if (e.released || this.destroyed) return;
-		let r = n.filter((e) => e.subtype === "Link" && (e.dest || e.url && aa(e.url))), i = (await Promise.all(r.map(async (e) => e.url ? { link: e } : {
+		let r = n.filter((e) => e.subtype === "Link" && (e.dest || e.url && sa(e.url))), i = (await Promise.all(r.map(async (e) => e.url ? { link: e } : {
 			link: e,
 			target: await this._destPage(e.dest)
 		}))).filter(({ link: e, target: t }) => e.url || t);
@@ -15494,7 +15516,7 @@ var ra = (e) => {
 			window.clearTimeout(this._jumpTimer), this.scroller.removeEventListener("scrollend", this._endJump), this.jumpTarget = null, this._syncToolbar();
 		}, Math.abs(n - this.scroller.scrollTop) >= 1 && (this.jumpTarget = t, this.scroller.addEventListener("scrollend", this._endJump), this._jumpTimer = window.setTimeout(this._endJump, Zi), this._timers.add(this._jumpTimer), this.scroller.scrollTo({
 			top: n,
-			behavior: da()
+			behavior: pa()
 		})), this._syncToolbar();
 	}
 	_commitPageInput() {
@@ -15569,7 +15591,7 @@ var ra = (e) => {
 	_followThumb() {
 		let e = this.current();
 		e === this._activeThumb || !this.thumbEls || (this.thumbEls[this._activeThumb]?.classList.remove("active"), this._activeThumb = e, this.thumbEls[e]?.classList.add("active"), this.thumbEls[e]?.scrollIntoView({
-			behavior: da(),
+			behavior: pa(),
 			block: "nearest"
 		}));
 	}
@@ -15616,7 +15638,7 @@ var ra = (e) => {
 		let r = this.search.index?.[e - 1]?.items, i = this.search.open ? this.search.byPage?.get(e) ?? [] : [], a = this.search.marked.get(e) ?? /* @__PURE__ */ new Set(), o = /* @__PURE__ */ new Set();
 		r && i.length && r.forEach((e, t) => {
 			let r = Vi(e, i);
-			!r.length || !n[t] || (o.add(t), ca(n[t], r, this.search.current));
+			!r.length || !n[t] || (o.add(t), ua(n[t], r, this.search.current));
 		});
 		for (let e of a) !o.has(e) && n[e] && n[e].replaceChildren(n[e].textContent);
 		o.size ? this.search.marked.set(e, o) : this.search.marked.delete(e);
@@ -15650,7 +15672,7 @@ var ra = (e) => {
 			e.preventDefault();
 			return;
 		}
-		if (e.shiftKey || ia(e.target)) return;
+		if (e.shiftKey || oa(e.target)) return;
 		let t = this.cols();
 		if (e.key === "PageDown") this.goToPage(this.current() + t);
 		else if (e.key === "PageUp") this.goToPage(this.current() - t);
@@ -15710,7 +15732,7 @@ var ra = (e) => {
 				}), this.printRun !== e) throw new DOMException("Print replaced", "AbortError");
 			}
 			let n = document.createElement("iframe");
-			n.className = "wui-file-viewer-print-frame", n.title = "Document for printing", n.tabIndex = -1, n.setAttribute("aria-hidden", "true"), e.frame = n, n.srcdoc = sa(this.shell.name(), t), n.addEventListener("load", () => {
+			n.className = "wui-file-viewer-print-frame", n.title = "Document for printing", n.tabIndex = -1, n.setAttribute("aria-hidden", "true"), e.frame = n, n.srcdoc = la(this.shell.name(), t), n.addEventListener("load", () => {
 				if (this.printRun === e) {
 					e.ready = !0, this._syncToolbar();
 					try {
@@ -15745,12 +15767,12 @@ var ra = (e) => {
 		console.warn(`[wui-file-viewer] ${e}:`, t?.message ?? t);
 	}
 };
-function sa(e, t) {
+function la(e, t) {
 	let n = [...new Set(t.map((e) => `${e.width.toFixed(2)}mm ${e.height.toFixed(2)}mm`))], r = n.map((e, t) => `@page s${t} { size: ${e}; margin: 0; }`).join("\n"), i = t.map((e) => {
 		let t = `s${n.indexOf(`${e.width.toFixed(2)}mm ${e.height.toFixed(2)}mm`)}`;
 		return `<img src="${e.url}" alt="" style="page:${t};width:${e.width}mm;height:${e.height}mm">`;
 	}).join("");
-	return `<!doctype html><html><head><title>${la(e)}</title><style>
+	return `<!doctype html><html><head><title>${da(e)}</title><style>
 @page { margin: 0; }
 ${r}
 html, body { margin: 0; padding: 0; }
@@ -15758,7 +15780,7 @@ img { display: block; break-after: page; }
 img:last-child { break-after: auto; }
 </style></head><body>${i}</body></html>`;
 }
-function ca(e, t, n) {
+function ua(e, t, n) {
 	let r = e.textContent, i = [], a = 0;
 	for (let { from: e, to: o, n: s } of t) {
 		e > a && i.push(document.createTextNode(r.slice(a, e)));
@@ -15767,11 +15789,11 @@ function ca(e, t, n) {
 	}
 	a < r.length && i.push(document.createTextNode(r.slice(a))), e.replaceChildren(...i);
 }
-var la = (e) => String(e ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-function ua(e) {
+var da = (e) => String(e ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+function fa(e) {
 	let t = [...e].sort((e, t) => e - t);
 	return t[Math.floor(t.length / 2)];
 }
-var da = () => window.matchMedia?.("(prefers-reduced-motion: reduce)").matches ? "auto" : "smooth";
+var pa = () => window.matchMedia?.("(prefers-reduced-motion: reduce)").matches ? "auto" : "smooth";
 //#endregion
-export { oa as PdfView };
+export { ca as PdfView, ia as renderFirstPage };

package/dist/types/chatClient.d.ts

@@ -0,0 +1,208 @@
+/**
+ * A failed chat request. `message` is written for the person and is safe to show as-is.
+ */
+export declare class ChatApiError extends Error {
+    code: string;
+    status: number;
+    resetsAtUtc: string;
+    /**
+     * @param {string} code Machine-readable reason: the server's code (`daily-limit`,
+     *   `assistant-unavailable`, ...), "network" when no response arrived, "aborted" when the
+     *   request was cancelled, or "unknown".
+     * @param {string} message The sentence to show the person.
+     * @param {number} [status] HTTP status, when a response arrived.
+     * @param {string|null} [resetsAtUtc] For `daily-limit`: when the allowance comes back, in UTC.
+     */
+    constructor(code: string, message: string, status?: number, resetsAtUtc?: string | null);
+}
+export type ChatHttp = {
+    get: (url: string, config?: object) => Promise<{
+        data: any;
+    }>;
+    post: (url: string, data?: any, config?: object) => Promise<{
+        data: any;
+    }>;
+    put: (url: string, data?: any, config?: object) => Promise<{
+        data: any;
+    }>;
+    delete: (url: string, config?: object) => Promise<{
+        data: any;
+    }>;
+};
+export type SupportAction = {
+    /**
+     * Sent back by the confirm button; nothing happens without it.
+     */
+    token: string;
+    kind: "RaiseTicket" | "Reply" | "Reopen";
+    ticketId: string | null;
+    ticketNumber: string | null;
+    category: string | null;
+    subject: string | null;
+    body: string | null;
+    expiresDateTimeUtc: string;
+};
+export type ChatTurnInput = {
+    /**
+     * The person's question.
+     */
+    message: string;
+    /**
+     * The conversation to continue; left out to start one.
+     */
+    conversationId?: string | null;
+    /**
+     * Product-defined context about the screen, passed through as-is.
+     */
+    pageContext?: any;
+};
+export type ChatStreamOptions = {
+    /**
+     * Cancels the request.
+     */
+    signal?: AbortSignal;
+    /**
+     * Called for each event
+     * before the end of the turn: `delta { text }` to append, `reset {}` to discard what was shown,
+     * `actions { actions }` for support cards.
+     */
+    onEvent?: (name: "delta" | "reset" | "actions", data: any) => void;
+};
+export type ChatTurnResult = {
+    conversationId: string;
+    /**
+     * The stored reply's id, for rating; null when storing failed.
+     */
+    messageId: string | null;
+    /**
+     * The reply of record. It replaces whatever was streamed.
+     */
+    reply: string;
+    /**
+     * Null when the person has no daily limit.
+     */
+    messagesLeftToday: number | null;
+};
+export type ConversationSummary = {
+    publicId: string;
+    title: string | null;
+    createdDateTimeUtc: string;
+    lastMessageDateTimeUtc: string;
+};
+export type ConversationMessage = {
+    publicId: string;
+    role: "User" | "Assistant";
+    content: string;
+    /**
+     * The support actions offered with an assistant reply, as a JSON array.
+     */
+    actionsJson: string | null;
+    rating: "Up" | "Down" | null;
+    ratingNote: string | null;
+    createdDateTimeUtc: string;
+};
+export type Conversation = {
+    publicId: string;
+    title: string | null;
+    messages: ConversationMessage[];
+};
+export type ChatClient = {
+    sendMessage: (input: ChatTurnInput, options?: ChatStreamOptions) => Promise<ChatTurnResult>;
+    getAllowance: () => Promise<{
+        messagesLeftToday: number | null;
+    }>;
+    listConversations: (query?: {
+        skip?: number;
+        take?: number;
+    }) => Promise<ConversationSummary[]>;
+    getConversation: (id: string) => Promise<Conversation>;
+    deleteConversation: (id: string) => Promise<void>;
+    rateMessage: (conversationId: string, messageId: string, input: {
+        rating: "Up" | "Down";
+        note?: string | null;
+    }) => Promise<void>;
+};
+/**
+ * @typedef {object} ChatHttp An axios instance (or axios-compatible) that already carries the
+ *   bearer token, tenant headers and refresh. The streamed turn needs axios's XHR adapter (the
+ *   browser default) to read the reply as it arrives.
+ * @property {(url: string, config?: object) => Promise<{ data: any }>} get
+ * @property {(url: string, data?: any, config?: object) => Promise<{ data: any }>} post
+ * @property {(url: string, data?: any, config?: object) => Promise<{ data: any }>} put
+ * @property {(url: string, config?: object) => Promise<{ data: any }>} delete
+ */
+/**
+ * @typedef {object} SupportAction An action the assistant prepared for the person to confirm.
+ * @property {string} token Sent back by the confirm button; nothing happens without it.
+ * @property {"RaiseTicket"|"Reply"|"Reopen"} kind
+ * @property {string|null} ticketId
+ * @property {string|null} ticketNumber
+ * @property {string|null} category
+ * @property {string|null} subject
+ * @property {string|null} body
+ * @property {string} expiresDateTimeUtc
+ */
+/**
+ * @typedef {object} ChatTurnInput
+ * @property {string} message The person's question.
+ * @property {string|null} [conversationId] The conversation to continue; left out to start one.
+ * @property {any} [pageContext] Product-defined context about the screen, passed through as-is.
+ */
+/**
+ * @typedef {object} ChatStreamOptions
+ * @property {AbortSignal} [signal] Cancels the request.
+ * @property {(name: "delta"|"reset"|"actions", data: any) => void} [onEvent] Called for each event
+ *   before the end of the turn: `delta { text }` to append, `reset {}` to discard what was shown,
+ *   `actions { actions }` for support cards.
+ */
+/**
+ * @typedef {object} ChatTurnResult The `done` event: the turn's outcome of record.
+ * @property {string} conversationId
+ * @property {string|null} messageId The stored reply's id, for rating; null when storing failed.
+ * @property {string} reply The reply of record. It replaces whatever was streamed.
+ * @property {number|null} messagesLeftToday Null when the person has no daily limit.
+ */
+/**
+ * @typedef {object} ConversationSummary
+ * @property {string} publicId
+ * @property {string|null} title
+ * @property {string} createdDateTimeUtc
+ * @property {string} lastMessageDateTimeUtc
+ */
+/**
+ * @typedef {object} ConversationMessage
+ * @property {string} publicId
+ * @property {"User"|"Assistant"} role
+ * @property {string} content
+ * @property {string|null} actionsJson The support actions offered with an assistant reply, as a JSON array.
+ * @property {"Up"|"Down"|null} rating
+ * @property {string|null} ratingNote
+ * @property {string} createdDateTimeUtc
+ */
+/**
+ * @typedef {object} Conversation
+ * @property {string} publicId
+ * @property {string|null} title
+ * @property {ConversationMessage[]} messages
+ */
+/**
+ * @typedef {object} ChatClient
+ * @property {(input: ChatTurnInput, options?: ChatStreamOptions) => Promise<ChatTurnResult>} sendMessage
+ * @property {() => Promise<{ messagesLeftToday: number|null }>} getAllowance
+ * @property {(query?: { skip?: number, take?: number }) => Promise<ConversationSummary[]>} listConversations
+ * @property {(id: string) => Promise<Conversation>} getConversation
+ * @property {(id: string) => Promise<void>} deleteConversation
+ * @property {(conversationId: string, messageId: string, input: { rating: "Up"|"Down", note?: string|null }) => Promise<void>} rateMessage
+ */
+/**
+ * Binds the chat HTTP contract to the product's own authenticated axios instance. The package
+ * never handles auth: tokens, tenant headers and refresh stay in the instance.
+ *
+ * @param {ChatHttp} http
+ * @param {{ base: string }} options `base` is the prefix the API maps the chat endpoints under,
+ *   e.g. "/api/assistant" for `POST /api/assistant/chat`.
+ * @returns {ChatClient}
+ */
+export declare function createChatClient(http: ChatHttp, { base }: {
+    base: string;
+}): ChatClient;

package/dist/types/chatCore.d.ts

@@ -0,0 +1,4 @@
+export { ChatApiError, createChatClient } from "./chatClient.js";
+export { DEFAULT_CHAT_LABELS, mergeLabels } from "./chatLabels.js";
+export { linkRoute, parseBlocks, parseInline } from "./markdownParse.js";
+export { createSseParser } from "./sse.js";

package/dist/types/chatLabels.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Every word the chat components show, in English. Pass a `labels` object with any subset to a
+ * component to change its wording; the rest keep these defaults. The few that take a value are
+ * functions.
+ */
+export declare const DEFAULT_CHAT_LABELS: Readonly<{
+    launcher: "Ask the assistant";
+    panelTitle: "Assistant";
+    newChat: "New chat";
+    close: "Close";
+    thread: "Conversation";
+    you: "You";
+    assistant: "Assistant";
+    thinking: "Thinking";
+    emptyTitle: "How can I help?";
+    emptyText: "Ask a question about what you see on this page.";
+    composer: "Your question";
+    placeholder: "Ask a question";
+    send: "Send";
+    composerHint: "Press Enter to send, Shift and Enter for a new line.";
+    /** @type {(count: number) => string} */
+    allowance: (count: number) => string;
+    disclaimer: "Answers are written by AI and can be wrong. Check anything important.";
+    loadingConversation: "Loading the conversation";
+    rateUp: "Helpful";
+    rateDown: "Not helpful";
+    rated: "Thanks for the feedback.";
+    ratingNote: "What was wrong with this answer?";
+    ratingNoteHint: "Optional.";
+    ratingNoteSend: "Send";
+    ratingNoteSkip: "Skip";
+    ratingFailed: "Your rating did not save. Please try again.";
+    actionRaiseTicket: "New support ticket";
+    /** @type {(ticketNumber: string) => string} */
+    actionReply: (ticketNumber: string) => string;
+    /** @type {(ticketNumber: string) => string} */
+    actionReopen: (ticketNumber: string) => string;
+    actionNote: "Nothing is sent until you confirm.";
+    actionConfirm: "Confirm";
+    actionDismiss: "Not now";
+    actionDismissed: "Not sent.";
+    actionExpired: "This request expired and was not sent. Ask again if you still need it.";
+    actionFailed: "We could not send this. Please try again.";
+    /** @type {(ticketNumber: string) => string} */
+    actionDoneRaiseTicket: (ticketNumber: string) => string;
+    /** @type {(ticketNumber: string) => string} */
+    actionDoneReply: (ticketNumber: string) => string;
+    /** @type {(ticketNumber: string) => string} */
+    actionDoneReopen: (ticketNumber: string) => string;
+    viewTicket: "View ticket";
+    conversations: "Past chats";
+    conversationsEmptyTitle: "No past chats";
+    conversationsEmptyText: "Your conversations with the assistant show here.";
+    untitled: "Untitled chat";
+    deleteConversation: "Delete chat";
+    deleteConfirmTitle: "Delete this chat?";
+    deleteConfirmMessage: "The conversation is removed for good.";
+    deleteConfirm: "Delete";
+    deleteFailed: "We could not delete this chat. Please try again.";
+    cancel: "Cancel";
+    loadMore: "Show more";
+    loadFailed: "We could not load your chats. Please try again.";
+    retry: "Try again";
+}>;
+/**
+ * @param {Partial<typeof DEFAULT_CHAT_LABELS>} [labels]
+ * @returns {typeof DEFAULT_CHAT_LABELS}
+ */
+export declare function mergeLabels(labels?: Partial<typeof DEFAULT_CHAT_LABELS>): typeof DEFAULT_CHAT_LABELS;

package/dist/types/markdownParse.d.ts

@@ -0,0 +1,77 @@
+export type MarkdownBlockShape = {
+    type: "paragraph";
+    lines: string[];
+} | {
+    type: "heading";
+    text: string;
+} | {
+    type: "list";
+    ordered: boolean;
+    start: number;
+    items: string[];
+} | {
+    type: "table";
+    header: string[];
+    rows: string[][];
+} | {
+    type: "code";
+    text: string;
+} | {
+    type: "rule";
+};
+export type MarkdownBlock = MarkdownBlockShape & {
+    key: number;
+};
+/**
+ * @typedef {{ type: "paragraph", lines: string[] }
+ *   | { type: "heading", text: string }
+ *   | { type: "list", ordered: boolean, start: number, items: string[] }
+ *   | { type: "table", header: string[], rows: string[][] }
+ *   | { type: "code", text: string }
+ *   | { type: "rule" }} MarkdownBlockShape
+ * @typedef {MarkdownBlockShape & { key: number }} MarkdownBlock
+ */
+/**
+ * Splits reply text into blocks. Each block's `key` is its position, so text arriving at the end
+ * of a streaming reply updates the last block in place and never remounts the ones before it.
+ *
+ * @param {string} text
+ * @returns {MarkdownBlock[]}
+ */
+export declare function parseBlocks(text: string): MarkdownBlock[];
+export type InlineToken = {
+    type: "text";
+    text: string;
+    key: number;
+} | {
+    type: "code";
+    text: string;
+    key: number;
+} | {
+    type: "strong" | "em";
+    children: InlineToken[];
+    key: number;
+} | {
+    type: "link";
+    href: string;
+    children: InlineToken[];
+    key: number;
+};
+/**
+ * Reads bold (`**` or `__`), italics (`*` or `_`), inline code and `[label](href)` links. A marker
+ * with no partner yet (a reply still streaming) shows as the characters typed.
+ *
+ * @param {string} text
+ * @returns {InlineToken[]}
+ */
+export declare function parseInline(text: string): InlineToken[];
+/**
+ * The in-app route a reply link may open, or null when it may not open one. Only
+ * `scheme:kind/id` hrefs reach `resolveLink`, and only a route it returns that starts with a
+ * single "/" is used.
+ *
+ * @param {string} href
+ * @param {((href: string) => string|null|undefined)|undefined} resolveLink
+ * @returns {string|null}
+ */
+export declare function linkRoute(href: string, resolveLink: ((href: string) => string | null | undefined) | undefined): string | null;

package/dist/types/sse.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @typedef {object} SseEvent
+ * @property {string} name The `event:` field, or "message" when the block names none.
+ * @property {any} data The `data:` lines joined by newlines and parsed as JSON.
+ */
+export type SseEvent = {
+    /**
+     * The `event:` field, or "message" when the block names none.
+     */
+    name: string;
+    /**
+     * The `data:` lines joined by newlines and parsed as JSON.
+     */
+    data: any;
+};
+/**
+ * An incremental reader for a `text/event-stream` body that arrives in pieces. Each `push` takes
+ * the next piece of text; only complete events (ended by a blank line) are handed on, and the
+ * incomplete tail waits for the next piece. `end` flushes a final event the stream closed
+ * without a blank line after.
+ *
+ * Line endings may be `\n`, `\r\n` or `\r`, and a `\r\n` pair may be split across two pieces.
+ * Comment lines (`:`), `id` and `retry` are ignored. A block whose data is not JSON is reported
+ * as an `error` event with the code `invalid-response`, so a caller ends the turn instead of
+ * hanging on it.
+ *
+ * @param {(event: SseEvent) => void} onEvent
+ * @returns {{ push: (text: string) => void, end: () => void }}
+ */
+export declare function createSseParser(onEvent: (event: SseEvent) => void): {
+    push: (text: string) => void;
+    end: () => void;
+};