@green-on-grey/ui-kit 1.3.0 → 1.5.0

package/dist/chat/Attachments.d.ts

@@ -1,5 +1,6 @@
+import { type IconName } from "../components/Icon";
 import type { ChatAttachment } from "./types";
-export type PreviewKind = "image" | "pdf" | "markdown" | "table" | "text";
+export type PreviewKind = "image" | "pdf" | "markdown" | "table" | "html" | "text";
 /** Loads the content of an attachment: the product fetches it with its session. */
 export type LoadAttachment = (a: ChatAttachment) => Promise<Blob>;
 /** Text, tables and Markdown larger than this are downloaded, not drawn. */
@@ -8,8 +9,18 @@ export declare const TEXT_PREVIEW_MAX: number;
 export declare const TABLE_ROWS = 500;
 /** How an attachment is previewed, or null when it is only downloaded. */
 export declare function previewKind(a: Pick<ChatAttachment, "fileName" | "mimeType">): PreviewKind | null;
+/** The icon of a kind of preview: the tiles of the chat and the products' own lists of files show it. */
+export declare const previewIcon: (kind: PreviewKind) => IconName;
 /** The size of a file in the units of the language. */
 export declare function fileSize(bytes: number, language: string): string;
+/** The document of a previewed HTML page. In a browser the page is parsed inert (a DOMParser loads nothing) and
+ * cleaned of everything that would load or lead anywhere: scripts, frames, plug-ins, links of the head, its own
+ * `http-equiv` (a refresh), and every address that is not `data:`, `blob:` or an anchor — a relative one would go to
+ * the site with the session. The policy is put first into the head, after the doctype of the file, so the page keeps
+ * its mode. The policy alone is not enough: a browser may fetch a picture before it applies a policy of a meta. */
+export declare function htmlDocument(text: string): string;
+/** The type a preview draws a file with: its own, else the one of its extension. */
+export declare function previewType(a: Pick<ChatAttachment, "fileName" | "mimeType">): string | undefined;
 /** The rows of CSV (quotes by RFC 4180) or TSV. */
 export declare function parseTable(text: string, tab: boolean): string[][];
 /** The files of a message: thumbnails of images and tiles; without `load` every file downloads. */
@@ -18,6 +29,9 @@ export declare function AttachmentList({ items, load, onOpen }: {
     load?: LoadAttachment;
     onOpen?: (a: ChatAttachment) => void;
 }): import("react").JSX.Element;
+/** The width a previewed page is laid out at: the one of a desktop. A narrower frame shows it scaled down, so a
+ * page made for a screen (a deck of slides) is seen whole instead of cut. */
+export declare const PAGE_WIDTH = 1280;
 /** The preview of an attachment: an image, the browser's PDF viewer, drawn Markdown, a table or text. */
 export declare function AttachmentPreview({ a, load, onClose }: {
     a: ChatAttachment;

package/dist/chat/index.d.ts

@@ -1,6 +1,6 @@
 export { Chat, VoiceButton } from "./Chat";
 export { ChatLayout, ConversationList, NewTopicModal } from "./ConversationList";
-export { AttachmentList, AttachmentPreview, fileSize, parseTable, previewKind, type LoadAttachment, type PreviewKind } from "./Attachments";
+export { AttachmentList, AttachmentPreview, fileSize, parseTable, previewIcon, previewKind, type LoadAttachment, type PreviewKind } from "./Attachments";
 export { AgentButton, AgentMenu, type AgentModelOption, type AgentModels, type AgentOption } from "./AgentMenu";
 export { CommandPalette } from "./CommandPalette";
 export { ContextMeter, tokens } from "./ContextMeter";