@bitbaum/chatkit 0.18.1 → 0.20.0

package/README.md

@@ -174,11 +174,172 @@ reopens the chat, a picture staged above the text and removed, delete, the
 queue and Stop — and checks for sideways scroll, 44px targets and cut words
 at every step.
 
+#### What a product adds to it (0.19)
+
+The first four products to adopt ChatApp (Heidi, OrangeCat, Solon,
+Substrata) each listed what it could not do. These close those gaps; every
+one is optional, and 0.18 code keeps working unchanged.
+
+**Send from the page — the handle.** `<ChatApp ref={chat}>` gives
+`ChatAppHandle`: `send(text, attachments?, { newChat?, chips? })`,
+`fill(text, files?)`, `focus()`, `newChat()`, `openConversation(id)`.
+`send` behaves exactly like the composer's Send (queued behind a running
+answer, a chat created when none is open); `File`s are read like the
+paperclip's, and if one cannot be attached nothing is sent — the words and
+files go into the box with the reason. Never click `.ck-send` from outside.
+
+```tsx
+const chat = useRef<ChatAppHandle>(null);
+<ChatApp ref={chat} transport={transport} />;
+<button onClick={() => chat.current?.send("Check this figure", [], { newChat: true })}>Check this</button>;
+```
+
+**A message the page arrives with.** `initialMessage` is sent once, in a new
+chat, after the list has loaded (StrictMode's double mount sends it once).
+`send: false` only fills the box. Clear it from your URL or state yourself.
+
+```tsx
+<ChatApp transport={transport}
+  initialMessage={handoff ? { text: handoff.text, attachments: handoff.files } : null} />
+```
+
+**`?q=` links.** `deepLinkParam="q"` reads the parameter into a new chat's
+box and takes it off the address. A link never sends for someone: only with
+`deepLinkAutoSend` too.
+
+```tsx
+<ChatApp transport={transport} deepLinkParam="q" />
+// /chat?q=How%20do%20invoices%20expire → the box says it; the person sends.
+```
+
+**Why a turn failed, per turn.** Throw `ChatTurnError(message, { kind })`
+from the transport: that bubble shows `message` and keeps `failure.kind`
+(for a footer to link the fix). Two failures in one chat keep their own
+words. Any other error shows the `failed` label, never its raw message —
+unless `failureMessage(error)` maps it.
+
+```tsx
+import { ChatTurnError } from "@bitbaum/chatkit/react";
+if (res.status === 503) throw new ChatTurnError("The model is not set up here.", { kind: "not-configured" });
+<ChatApp transport={transport} failureMessage={(e) => (navigator.onLine ? null : "You are offline.")} />;
+```
+
+**Retry sends the pictures again.** The files of a failed turn stay with it
+until its answer lands; Retry re-sends the words and the files. Nothing to
+configure.
+
+**Stop and the half answer.** Stop keeps what had arrived (as the apps do).
+`stopKeepsPartial={false}` drops it for every turn; a transport decides per
+turn with `turn.stopKeepsPartial(keep)` — `false` while the text is unchecked.
+
+```tsx
+transport={async (turn) => {
+  turn.stopKeepsPartial(false); // the gate has not checked this text yet
+  /* … stream … */ turn.stopKeepsPartial(true); return answer; }}
+```
+
+**Starters with a language.** A starter is `string | { label, prompt?, lang? }
+| { text, label?, lang? }`; `lang` goes on the button.
+
+```tsx
+<ChatApp transport={transport}
+  starters={["Explain this word", { text: "Grüezi mitenand", lang: "gsw" }]} />
+```
+
+**The chat list's own line.** `historySlot` sits under the search box, above
+the chats; `historyEmpty` replaces "No chats yet…".
+
+```tsx
+<ChatApp transport={transport}
+  historySlot={signedOut && <a href="/login">Only in this browser · Sign in to keep it</a>}
+  historyEmpty={<p>What you ask is kept here.</p>} />
+```
+
+**Product rows in the attach sheet.** `composer.attachExtras` — `{ id,
+label, detail?, icon?, onPick }[]` — are rows under Camera · Photos · Files,
+one anatomy (icon, label, second line), in the same sheet. With `attach:
+false` the paperclip opens a sheet of only these rows. (`AttachMenu rows`
+takes the same list.)
+
+```tsx
+<ChatApp transport={transport}
+  composer={{ attachExtras: [{ id: "things", label: "Your things", onPick: openThings }],
+              heldAttachments: held.length }} />
+```
+
+**The product's things on the sent message.** `chipsFor({ text, attachments
+})` returns `MessageChip[]` (`{ label, href?, kind? }`) shown on the person's
+message the moment it is sent, and kept with it (`ChatMessageData.chips`).
+`send(…, { chips })` does the same from the handle.
+
+```tsx
+<ChatApp transport={transport}
+  chipsFor={() => held.map((r) => ({ label: r.title, href: r.url }))} />
+```
+
+**A temporary chat ended.** `onTemporaryEnd(chatId)` fires once when a
+temporary chat is left (New chat, another chat, Temporary off), the page is
+hidden, or ChatApp unmounts. `turn.chatId` is the same id, so a server row
+kept for the chat can be keyed by it and deleted here.
+
+```tsx
+<ChatApp transport={(turn) => myApi.send({ ...turn, hiddenRowKey: turn.chatId })}
+  onTemporaryEnd={(chatId) => myApi.deleteHiddenRow(chatId)} />
+```
+
+**Footers that know the latest answer, and can send.** `thread.renderFooter(m,
+{ isLatest, index, send, fill })`: put "what next" only under the latest,
+and let a chip whose label differs from its sentence send in one tap.
+
+```tsx
+thread={{ renderFooter: (m, { isLatest, send }) =>
+  isLatest && <button className="ck-reply" onClick={() => send("Make it shorter.")}>Shorter</button> }}
+```
+
+**After the last turn.** `thread.after` is drawn inside the thread, after the
+last turn (a pending action, a picker), not over the composer.
+
+`demo/app.html?lab=1` is the page these are checked on: StrictMode around
+ChatApp, the handle on `window.ckChat`. `test/browser-app.mjs` drives it at
+390px and 1440px.
+
 #### Moving a product onto ChatApp
 
 Per product, from the matrix: what goes, what stays. What stays is always
 the same two things — the transport and the words.
 
+**Workarounds 0.19 makes deletable** (each was written in an adoption PR
+because ChatApp 0.18 could not do it — bitbaum/heidi#226, bitbaum/orangecat#1447,
+bitbaum/solon#309, bitbaum/substrata#262):
+
+- **Substrata** — `lib/chat/drive-composer.ts` (types into the composer and
+  presses Send) goes: `components/portal/chat/useAutoAsk.ts` and
+  `lib/chat/handoff.ts` hand their words and pictures to `initialMessage` (or
+  `ref.send(text, files, { newChat: true })`), and `/chat?q=` becomes
+  `deepLinkParam="q"`. Retry now re-sends the pictures.
+- **OrangeCat** — in `src/components/ai-chat/ModernChatPanel/index.tsx`, the
+  bridge that sets the composer value and clicks `button.ck-send` goes (`?q=`
+  and `askCat` → the handle), and so does the ephemeral-row cleanup hung on
+  the empty state mounting and `onConversationChange` (→ `onTemporaryEnd`,
+  keyed by `turn.chatId` in `hooks/useCatTransport.ts`). "Your things" moves
+  from a second button into the sheet (`composer.attachExtras`), its staged
+  refs show on the sent bubble (`chipsFor`), `CatAnswerFooter` shows the
+  create links and upgrade nudge only under `isLatest`, and pending actions
+  move from `composer.above` to `thread.after`. `TurnFailure` reads the
+  turn's own `failure.kind` (throw `ChatTurnError`).
+- **Heidi** — in `app/[locale]/_components/chat/workspace.tsx`, the
+  latest-failure state passed as `thread.labels.failed` goes (throw
+  `ChatTurnError` from `chat-app.ts`'s transport mapping), and so does
+  `turn.update({ text: "" })` before a throw on Stop (→
+  `turn.stopKeepsPartial(false)` until the variety gate has checked the
+  text). The move and learn chips and the word pick send in one tap again
+  through `renderFooter`'s `send`; the dialect starter gets `lang`; the
+  signed-out "Sign in to keep it" line moves from `startersTitle` to
+  `historySlot`.
+- **Solon** — nothing to delete. The per-answer "Answered by <model>" fits
+  `thread.renderFooter` (it existed in 0.18; it now also gets `isLatest`).
+  ChatApp's own words still come only in English: pass `labels`.
+
 - **Loki** — goes: `ThreadRail.tsx`, the history half of
   `WorkspaceDrawers.tsx` and `WorkspaceChrome.tsx`, `ThreadTitle.tsx`,
   `hooks/use-temporary-chat.ts`, `hooks/use-new-chat.ts`,
@@ -483,6 +644,45 @@ import { AttachMenu, shrinkImage } from "@bitbaum/chatkit/attach";
 maxBytes)` is the in-browser downscale the composer uses. `acceptFamilies` and
 `ATTACH_SOURCE_INPUT` are the rule itself.
 
+### PDFs — `@bitbaum/chatkit/pdf`
+
+No model on a free chain reads a PDF file. So a PDF someone attaches is read
+in the browser and handed on the way the model already understands:
+
+```ts
+import { isPdfFile, readPdf, sheetName, PDF_MAX_BYTES } from "@bitbaum/chatkit/pdf";
+
+if (isPdfFile(file) && file.size <= PDF_MAX_BYTES) {
+  const r = await readPdf(file, { maxSheets: picturesLeft, assetsUrl: "/pdfjs/" });
+  if (r.kind === "text") attachText(file.name, r.text); // "--- page 3 ---" markers kept
+  else
+    r.sheets.forEach((s) => attachImage(sheetName(file.name, s.firstPage, s.lastPage), s.dataUrl));
+  // r.pagesShown < r.pageCount → tell the person which pages went
+}
+```
+
+- **A PDF with a text layer** (Word, Docs, a typed report) comes back as text.
+- **A PDF without one** (slides exported as pictures, a scan) comes back as
+  pictures of its pages, **four to a sheet** at 784px a page — slide text stays
+  legible, and a 20-page deck is 5 pictures. Send them to a model that sees.
+- pdf.js loads only on the first PDF (its own entry point and a dynamic
+  import), and the legacy build is used so older iPhones read PDFs too.
+
+**One step per app**: pdf.js fetches its worker and image decoders by URL at
+runtime, which no bundler follows. Copy them as the first step of `dev` and
+`build` (pnpm does not run `prebuild` hooks by default):
+
+```json
+"build": "chatkit-copy-pdf-assets public/pdfjs && next build"
+```
+
+and pass `assetsUrl: "/pdfjs/"`. Keep that folder out of git. Served
+from the app's own origin they pass a strict CSP, and they include the
+decoders without which pages whose pictures are JPEG 2000 — macOS's "reduce
+file size" export — draw blank. `test/browser-pdf.mjs` checks both
+kinds in Chromium; `node test/browser-pdf.mjs your.pdf` prints what any PDF
+turns into.
+
 ### The check every app runs in CI
 
 ```sh

package/bin/chatkit-copy-pdf-assets.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// Copies pdf.js's runtime files where an app serves static files, so
+// `readPdf(file, { assetsUrl })` from @bitbaum/chatkit/pdf can fetch them.
+//
+//   chatkit-copy-pdf-assets public/pdfjs      →  readPdf(file, { assetsUrl: "/pdfjs/" })
+//
+// pdf.js loads its worker and its image decoders (JPEG 2000, JBIG2) by URL at
+// runtime, which no bundler follows. Without them a page whose pictures are
+// JPEG 2000 — macOS's "reduce file size" PDF export — draws blank (found
+// 2026-10-27 on an investor deck). Run it as the first step of the app's dev
+// and build scripts (pnpm skips `prebuild` hooks by default) so the files
+// always match the installed pdf.js; the folder stays out of git. Idempotent.
+import { cpSync, existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
+import { PDF_ASSET_DIRS, PDF_WORKER_FILE } from "../dist/pdf.js";
+
+const dest = resolve(process.argv[2] ?? "public/pdfjs");
+const require = createRequire(import.meta.url);
+const pkgJson = require.resolve("pdfjs-dist/package.json");
+const root = dirname(pkgJson);
+const { version } = require(pkgJson);
+
+rmSync(dest, { recursive: true, force: true });
+mkdirSync(dest, { recursive: true });
+cpSync(join(root, "legacy", "build", PDF_WORKER_FILE), join(dest, PDF_WORKER_FILE));
+for (const dir of PDF_ASSET_DIRS) {
+  const from = join(root, dir);
+  if (!existsSync(from)) {
+    console.error(`chatkit-copy-pdf-assets: pdfjs-dist ${version} has no ${dir}/`);
+    process.exit(1);
+  }
+  // quickjs-eval is pdf.js's sandbox for a PDF's own JavaScript, which a chat
+  // never runs. Leaving it out keeps a document's scripts from having anywhere to go.
+  cpSync(from, join(dest, dir), { recursive: true, filter: (p) => !p.includes("quickjs") });
+}
+writeFileSync(join(dest, "VERSION"), `pdfjs-dist ${version}\n`);
+console.log(`chatkit-copy-pdf-assets: pdfjs-dist ${version} → ${dest}`);

package/dist/pdf.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @bitbaum/chatkit/pdf — a PDF a person attaches, read in the browser and
+ * handed on the way a chat model already understands: as text, or as
+ * pictures of the pages.
+ *
+ *   import { isPdfFile, readPdf } from "@bitbaum/chatkit/pdf";
+ *
+ * No model on a free chain reads a PDF file, and most paid ones bill for the
+ * privilege. So the PDF never leaves the device as a PDF:
+ *
+ *   - A PDF with a text layer (exported from Word, Docs, a typed report) comes
+ *     back as `{ kind: "text" }` with page markers kept, so the model can say
+ *     "on page 4". Attach it like a .txt file.
+ *   - A PDF without one (a deck exported as slide images, a scan) comes back as
+ *     `{ kind: "pages" }`: the pages rendered and packed four to a sheet.
+ *     Attach the sheets like photos, to a model that can see. Four to a sheet
+ *     keeps each page ~780px wide — slide text stays legible — and turns a
+ *     20-page deck into 5 pictures instead of 20.
+ *
+ * Found 2026-10-27 in OrangeCat: an investor deck (17 slide images, 13.7 MB,
+ * no text layer) could not be shared with the Cat at all.
+ *
+ * Its own entry point, so a chat that never sees a PDF never loads pdf.js;
+ * `readPdf` imports it on the first PDF. The pure parts are exported for
+ * tests and for apps that word their own notices.
+ */
+/** Pages per sheet, as a grid. */
+export declare const PDF_SHEET_COLUMNS = 2;
+export declare const PDF_SHEET_ROWS = 2;
+export declare const PDF_PAGES_PER_SHEET: number;
+/** Width of one page on a sheet; a sheet is two of these side by side. */
+export declare const PDF_PAGE_WIDTH_PX = 784;
+/** A PDF this large is refused before pdf.js opens it. */
+export declare const PDF_MAX_BYTES: number;
+/**
+ * Below this many non-space characters per page, on average, the text layer
+ * is treated as absent (a slide deck's page numbers, a scanner's stamp) and
+ * the pages are looked at instead.
+ */
+export declare const PDF_MIN_TEXT_CHARS_PER_PAGE = 60;
+export type PdfReading = {
+    kind: "text";
+    text: string;
+    pageCount: number;
+} | {
+    kind: "pages";
+    sheets: PdfSheet[];
+    pageCount: number;
+    pagesShown: number;
+};
+export interface PdfSheet {
+    /** 1-based, inclusive. */
+    firstPage: number;
+    lastPage: number;
+    dataUrl: string;
+}
+export declare function isPdfFile(file: {
+    name: string;
+    type: string;
+}): boolean;
+/** True when the extracted text is the document, not a few stray labels. */
+export declare function isTextRich(pageTexts: string[]): boolean;
+/** The pages as one text, each under a marker the Cat can cite. */
+export declare function joinPageTexts(pageTexts: string[]): string;
+/**
+ * Which pages go on which sheet, for at most `maxSheets` sheets. Pages past
+ * what fits are left out, and the caller says so.
+ */
+export declare function planSheets(pageCount: number, maxSheets: number): number[][];
+/** "deck.pdf · pages 5–8", or "· page 9" for a sheet of one. */
+export declare function sheetName(fileName: string, firstPage: number, lastPage: number): string;
+/**
+ * Where pdf.js's own runtime files live — the worker, the image decoders
+ * (JPEG 2000, JBIG2), CMaps, standard fonts, ICC profiles. They are fetched by
+ * URL at runtime, which a bundler cannot follow, so an app copies them into its
+ * static folder with `chatkit-copy-pdf-assets public/pdfjs` and passes
+ * `assetsUrl: "/pdfjs/"`. Served from the app's own origin, they also pass a
+ * strict Content-Security-Policy. Missing decoders are why a page whose
+ * pictures are JPEG 2000 — macOS's "reduce file size" export, the deck this
+ * was written for — draws blank.
+ */
+export declare const PDF_ASSET_DIRS: readonly ["wasm", "cmaps", "standard_fonts", "iccs"];
+export declare const PDF_WORKER_FILE = "pdf.worker.min.mjs";
+export interface ReadPdfOptions {
+    /** How many pictures the message still has room for. A text PDF needs none. */
+    maxSheets: number;
+    /** Base URL of the files `chatkit-copy-pdf-assets` copied, e.g. "/pdfjs/". */
+    assetsUrl: string;
+}
+/**
+ * Read a picked PDF. Throws on a file pdf.js cannot open (encrypted, corrupt)
+ * — the app words that for the person. `PDF_MAX_BYTES` is checked by the app
+ * before calling, so it can say so in its own words.
+ */
+export declare function readPdf(file: Blob | Uint8Array, opts: ReadPdfOptions): Promise<PdfReading>;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,mBAAmB,QAAqC,CAAC;AAEtE,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,aAAa,QAAmB,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAI9C,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEvE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAMvD;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAKzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAW3E;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIvF;AAWD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,sDAAuD,CAAC;AACnF,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAwFpD,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BhG"}

package/dist/pdf.js

@@ -0,0 +1,212 @@
+/**
+ * @bitbaum/chatkit/pdf — a PDF a person attaches, read in the browser and
+ * handed on the way a chat model already understands: as text, or as
+ * pictures of the pages.
+ *
+ *   import { isPdfFile, readPdf } from "@bitbaum/chatkit/pdf";
+ *
+ * No model on a free chain reads a PDF file, and most paid ones bill for the
+ * privilege. So the PDF never leaves the device as a PDF:
+ *
+ *   - A PDF with a text layer (exported from Word, Docs, a typed report) comes
+ *     back as `{ kind: "text" }` with page markers kept, so the model can say
+ *     "on page 4". Attach it like a .txt file.
+ *   - A PDF without one (a deck exported as slide images, a scan) comes back as
+ *     `{ kind: "pages" }`: the pages rendered and packed four to a sheet.
+ *     Attach the sheets like photos, to a model that can see. Four to a sheet
+ *     keeps each page ~780px wide — slide text stays legible — and turns a
+ *     20-page deck into 5 pictures instead of 20.
+ *
+ * Found 2026-10-27 in OrangeCat: an investor deck (17 slide images, 13.7 MB,
+ * no text layer) could not be shared with the Cat at all.
+ *
+ * Its own entry point, so a chat that never sees a PDF never loads pdf.js;
+ * `readPdf` imports it on the first PDF. The pure parts are exported for
+ * tests and for apps that word their own notices.
+ */
+/** Pages per sheet, as a grid. */
+export const PDF_SHEET_COLUMNS = 2;
+export const PDF_SHEET_ROWS = 2;
+export const PDF_PAGES_PER_SHEET = PDF_SHEET_COLUMNS * PDF_SHEET_ROWS;
+/** Width of one page on a sheet; a sheet is two of these side by side. */
+export const PDF_PAGE_WIDTH_PX = 784;
+/** A PDF this large is refused before pdf.js opens it. */
+export const PDF_MAX_BYTES = 40 * 1024 * 1024;
+/**
+ * Below this many non-space characters per page, on average, the text layer
+ * is treated as absent (a slide deck's page numbers, a scanner's stamp) and
+ * the pages are looked at instead.
+ */
+export const PDF_MIN_TEXT_CHARS_PER_PAGE = 60;
+const SHEET_JPEG_QUALITY = 0.82;
+export function isPdfFile(file) {
+    return file.type === "application/pdf" || file.name.toLowerCase().endsWith(".pdf");
+}
+/** True when the extracted text is the document, not a few stray labels. */
+export function isTextRich(pageTexts) {
+    if (pageTexts.length === 0) {
+        return false;
+    }
+    const chars = pageTexts.reduce((n, t) => n + t.replace(/\s+/g, "").length, 0);
+    return chars / pageTexts.length >= PDF_MIN_TEXT_CHARS_PER_PAGE;
+}
+/** The pages as one text, each under a marker the Cat can cite. */
+export function joinPageTexts(pageTexts) {
+    return pageTexts
+        .map((t, i) => `--- page ${i + 1} ---\n${t.trim()}`)
+        .join("\n\n")
+        .trim();
+}
+/**
+ * Which pages go on which sheet, for at most `maxSheets` sheets. Pages past
+ * what fits are left out, and the caller says so.
+ */
+export function planSheets(pageCount, maxSheets) {
+    const shown = Math.min(pageCount, Math.max(0, maxSheets) * PDF_PAGES_PER_SHEET);
+    const sheets = [];
+    for (let first = 1; first <= shown; first += PDF_PAGES_PER_SHEET) {
+        const pages = [];
+        for (let p = first; p < first + PDF_PAGES_PER_SHEET && p <= shown; p++) {
+            pages.push(p);
+        }
+        sheets.push(pages);
+    }
+    return sheets;
+}
+/** "deck.pdf · pages 5–8", or "· page 9" for a sheet of one. */
+export function sheetName(fileName, firstPage, lastPage) {
+    return firstPage === lastPage
+        ? `${fileName} · page ${firstPage}`
+        : `${fileName} · pages ${firstPage}–${lastPage}`;
+}
+let pdfjsPromise = null;
+/**
+ * Where pdf.js's own runtime files live — the worker, the image decoders
+ * (JPEG 2000, JBIG2), CMaps, standard fonts, ICC profiles. They are fetched by
+ * URL at runtime, which a bundler cannot follow, so an app copies them into its
+ * static folder with `chatkit-copy-pdf-assets public/pdfjs` and passes
+ * `assetsUrl: "/pdfjs/"`. Served from the app's own origin, they also pass a
+ * strict Content-Security-Policy. Missing decoders are why a page whose
+ * pictures are JPEG 2000 — macOS's "reduce file size" export, the deck this
+ * was written for — draws blank.
+ */
+export const PDF_ASSET_DIRS = ["wasm", "cmaps", "standard_fonts", "iccs"];
+export const PDF_WORKER_FILE = "pdf.worker.min.mjs";
+function withSlash(url) {
+    return url.endsWith("/") ? url : `${url}/`;
+}
+/** pdf.js, loaded on the first PDF — never part of the chat's first paint. */
+function loadPdfJs(assetsUrl) {
+    if (!pdfjsPromise) {
+        pdfjsPromise = import("pdfjs-dist/legacy/build/pdf.mjs").then((pdfjs) => {
+            pdfjs.GlobalWorkerOptions.workerSrc = `${withSlash(assetsUrl)}${PDF_WORKER_FILE}`;
+            return pdfjs;
+        });
+        // A failed load (offline, blocked chunk) must not poison the next try.
+        pdfjsPromise.catch(() => {
+            pdfjsPromise = null;
+        });
+    }
+    return pdfjsPromise;
+}
+async function pageTextsOf(doc) {
+    const texts = [];
+    for (let n = 1; n <= doc.numPages; n++) {
+        const page = await doc.getPage(n);
+        const content = await page.getTextContent();
+        let text = "";
+        for (const item of content.items) {
+            if ("str" in item) {
+                text += item.str + (item.hasEOL ? "\n" : " ");
+            }
+        }
+        texts.push(text.replace(/[ \t]+\n/g, "\n").replace(/[ \t]{2,}/g, " "));
+        page.cleanup();
+    }
+    return texts;
+}
+async function renderSheet(doc, pages) {
+    // Rendering needs a canvas; outside a browser the pages are simply not drawn.
+    if (typeof document === "undefined")
+        return null;
+    const rendered = [];
+    for (const n of pages) {
+        const page = await doc.getPage(n);
+        const base = page.getViewport({ scale: 1 });
+        const viewport = page.getViewport({ scale: PDF_PAGE_WIDTH_PX / base.width });
+        const canvas = document.createElement("canvas");
+        canvas.width = Math.ceil(viewport.width);
+        canvas.height = Math.ceil(viewport.height);
+        const ctx = canvas.getContext("2d");
+        if (!ctx) {
+            return null;
+        }
+        // White, not transparent: a JPEG turns transparency black.
+        ctx.fillStyle = "#fff";
+        ctx.fillRect(0, 0, canvas.width, canvas.height);
+        await page.render({ canvas, canvasContext: ctx, viewport }).promise;
+        rendered.push(canvas);
+        page.cleanup();
+    }
+    if (rendered.length === 0) {
+        return null;
+    }
+    const cols = Math.min(PDF_SHEET_COLUMNS, rendered.length);
+    const rows = Math.ceil(rendered.length / PDF_SHEET_COLUMNS);
+    const cellW = PDF_PAGE_WIDTH_PX;
+    const cellH = Math.max(...rendered.map((c) => c.height));
+    const gap = 8;
+    const sheet = document.createElement("canvas");
+    sheet.width = cols * cellW + (cols - 1) * gap;
+    sheet.height = rows * cellH + (rows - 1) * gap;
+    const ctx = sheet.getContext("2d");
+    if (!ctx) {
+        return null;
+    }
+    // The gaps read as page edges; grey so a white page still has one.
+    ctx.fillStyle = "#9ca3af";
+    ctx.fillRect(0, 0, sheet.width, sheet.height);
+    rendered.forEach((c, i) => {
+        const x = (i % PDF_SHEET_COLUMNS) * (cellW + gap);
+        const y = Math.floor(i / PDF_SHEET_COLUMNS) * (cellH + gap);
+        ctx.drawImage(c, x, y);
+    });
+    return sheet.toDataURL("image/jpeg", SHEET_JPEG_QUALITY);
+}
+/**
+ * Read a picked PDF. Throws on a file pdf.js cannot open (encrypted, corrupt)
+ * — the app words that for the person. `PDF_MAX_BYTES` is checked by the app
+ * before calling, so it can say so in its own words.
+ */
+export async function readPdf(file, opts) {
+    const pdfjs = await loadPdfJs(opts.assetsUrl);
+    const data = file instanceof Uint8Array ? file : new Uint8Array(await file.arrayBuffer());
+    const base = withSlash(opts.assetsUrl);
+    const task = pdfjs.getDocument({
+        data,
+        wasmUrl: `${base}wasm/`,
+        cMapUrl: `${base}cmaps/`,
+        standardFontDataUrl: `${base}standard_fonts/`,
+        iccUrl: `${base}iccs/`,
+    });
+    const doc = await task.promise;
+    try {
+        const pageTexts = await pageTextsOf(doc);
+        if (isTextRich(pageTexts)) {
+            return { kind: "text", text: joinPageTexts(pageTexts), pageCount: doc.numPages };
+        }
+        const sheets = [];
+        for (const pages of planSheets(doc.numPages, opts.maxSheets)) {
+            const dataUrl = await renderSheet(doc, pages);
+            if (dataUrl) {
+                sheets.push({ firstPage: pages[0], lastPage: pages[pages.length - 1], dataUrl });
+            }
+        }
+        const pagesShown = sheets.length > 0 ? sheets[sheets.length - 1].lastPage : 0;
+        return { kind: "pages", sheets, pageCount: doc.numPages, pagesShown };
+    }
+    finally {
+        void task.destroy();
+    }
+}
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"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"}

package/dist/react/AttachMenu.d.ts

@@ -9,6 +9,19 @@ export type AttachMenuLabels = {
     sources: Record<AttachSource, string>;
 };
 export declare const DEFAULT_ATTACH_MENU_LABELS: AttachMenuLabels;
+/**
+ * One of the app's own rows in the attach sheet, under Camera · Photos ·
+ * Files: an icon, what it adds (`label`), an optional second line. Every row
+ * has this one anatomy, so a product's "Your things" reads as part of the
+ * same sheet, not a second menu. Picking a row closes the sheet first.
+ */
+export type AttachExtra = {
+    id: string;
+    label: string;
+    detail?: string;
+    icon?: ReactNode;
+    onPick: () => void;
+};
 /**
  * The paperclip, and what it opens on a phone: a sheet with Camera, Photos and
  * Files — one input each. See `ATTACH_SOURCE_INPUT` for why three inputs and
@@ -27,7 +40,7 @@ export declare const DEFAULT_ATTACH_MENU_LABELS: AttachMenuLabels;
  * they sit under Camera · Photos · Files in the same sheet, on every pointer,
  * since a mouse cannot reach them through a file dialog.
  */
-export declare function AttachMenu({ onFiles, disabled, labels, sources, trigger, extra, onOpenChange, }: {
+export declare function AttachMenu({ onFiles, disabled, labels, sources, trigger, extra, rows, onOpenChange, }: {
     onFiles: (files: FileList | null) => void;
     disabled?: boolean;
     labels?: AttachMenuLabels;
@@ -41,6 +54,10 @@ export declare function AttachMenu({ onFiles, disabled, labels, sources, trigger
      *  sheet opens on every pointer. A row that should close the sheet calls
      *  the `close` it is given. */
     extra?: (close: () => void) => ReactNode;
+    /** The app's rows as data — drawn with one anatomy (see `AttachExtra`).
+     *  With them the sheet opens on every pointer; with no `sources` it holds
+     *  only them. */
+    rows?: readonly AttachExtra[];
     onOpenChange?: (open: boolean) => void;
 }): import("react").JSX.Element;
 //# sourceMappingURL=AttachMenu.d.ts.map

package/dist/react/AttachMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachMenu.d.ts","sourceRoot":"","sources":["../../src/react/AttachMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC;AASF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAgB,EAChB,MAAmC,EACnC,OAAiB,EACjB,OAAO,EACP,KAAK,EACL,YAAY,GACb,EAAE;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;8EAC0E;IAC1E,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;yEACqE;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;mCAE+B;IAC/B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,+BAuEA"}
+{"version":3,"file":"AttachMenu.d.ts","sourceRoot":"","sources":["../../src/react/AttachMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AASF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAgB,EAChB,MAAmC,EACnC,OAAiB,EACjB,OAAO,EACP,KAAK,EACL,IAAI,EACJ,YAAY,GACb,EAAE;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;8EAC0E;IAC1E,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;yEACqE;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;mCAE+B;IAC/B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACzC;;qBAEiB;IACjB,IAAI,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,+BAkGA"}