@poodle64/librarian 2026.10.3 → 2026.10.5

package/dist/written.js

@@ -0,0 +1,83 @@
+/**
+ * The documents a persona writes while it answers.
+ *
+ * The app emits an `artefact` frame after each successful Write or Edit, and a
+ * reopened conversation lists the same versions on its turns. The page shows
+ * each version in the reading column and links it for download; the bytes
+ * come from the host's own route, never from this package.
+ */
+import { fill } from './copy';
+export const writtenKey = (written) => `${written.name}@${written.version}`;
+export const isHtml = (mediaType) => mediaType.toLowerCase().startsWith('text/html');
+/** The newest version of each document in `written`, in the order they first appear. */
+export function newestPerName(written) {
+    const newest = new Map();
+    for (const w of written) {
+        const had = newest.get(w.name);
+        if (!had || w.version >= had.version)
+            newest.set(w.name, w);
+    }
+    return [...newest.values()];
+}
+/** "Minute", or "Document" where the document has no kind. */
+export function kindLabel(written, words) {
+    const kind = (written.kind ?? '').trim() || words.documentKind;
+    return kind.charAt(0).toUpperCase() + kind.slice(1);
+}
+/** "Minute · 1 page · v1": kind, pages where known, version. */
+export function writtenMeta(written, words) {
+    const parts = [kindLabel(written, words)];
+    if (written.pages > 0)
+        parts.push(written.pages === 1 ? words.pageCount : fill(words.pagesCount, { n: written.pages }));
+    parts.push(fill(words.writtenVersion, { n: written.version }));
+    return parts.join(' · ');
+}
+const baseName = (name) => name.split('/').filter(Boolean).at(-1) ?? name;
+/** The download a card's chip offers: Word where the app renders it, else the source as written. */
+export function chipFor(written, words) {
+    const file = baseName(written.name);
+    if (written.formats.includes('docx')) {
+        const stem = file.replace(/\.[^.]+$/, '');
+        return { format: 'docx', file: `${stem}.docx`, label: words.formatWord };
+    }
+    return {
+        format: 'source',
+        file,
+        label: isHtml(written.media_type) ? words.formatHtml : words.formatMarkdown
+    };
+}
+/** A leading `---` front matter block is metadata, not the document. */
+export function stripFrontMatter(text) {
+    return text.replace(/^\uFEFF?---[ \t]*\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/, '').replace(/^\s*\n/, '');
+}
+/** Every version of `name` across the conversation, oldest first. */
+export function writtenVersions(turns, name) {
+    const found = new Map();
+    for (const turn of turns)
+        for (const written of turn.written ?? [])
+            if (written.name === name)
+                found.set(written.version, written);
+    return [...found.values()].sort((a, b) => a.version - b.version);
+}
+/** What a version downloads as: its source, then each format the app renders. */
+export function downloads(written, words) {
+    const label = (format) => format === 'docx' ? words.formatWord : format === 'pdf' ? words.formatPdf : format.toUpperCase();
+    return [
+        { format: 'source', label: isHtml(written.media_type) ? words.formatHtml : words.formatMarkdown },
+        ...written.formats.map((format) => ({ format, label: label(format) }))
+    ];
+}
+/** An empty sandbox stops scripts, not fetches: a written page's <img> or CSS url() would be a beacon without this. */
+export const FRAME_CSP = '<meta http-equiv="Content-Security-Policy" content="default-src \'none\'; style-src \'unsafe-inline\'; img-src data:; font-src data:">';
+/**
+ * A written HTML page as its sandboxed frame shows it: under `FRAME_CSP`, and
+ * without a refresh, which navigates the frame itself, a fetch no policy stops.
+ */
+export function framed(html) {
+    const page = new DOMParser().parseFromString(html, 'text/html');
+    for (const meta of page.querySelectorAll('meta[http-equiv]')) {
+        if (meta.getAttribute('http-equiv')?.trim().toLowerCase() === 'refresh')
+            meta.remove();
+    }
+    return FRAME_CSP + page.documentElement.outerHTML;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@poodle64/librarian",
-	"version": "2026.10.3",
+	"version": "2026.10.5",
 	"description": "An agent's conversation surface as a consumable Svelte 5 package: the stream client, transcript state and self-styling chat components (transcript, composer, markdown) every household app renders instead of rebuilding, speaking as whichever persona the app names.",
 	"type": "module",
 	"license": "MIT",
@@ -43,6 +43,14 @@
 			"types": "./dist/copy.d.ts",
 			"svelte": "./dist/copy.js"
 		},
+		"./written": {
+			"types": "./dist/written.d.ts",
+			"svelte": "./dist/written.js"
+		},
+		"./visuals": {
+			"types": "./dist/visuals.d.ts",
+			"svelte": "./dist/visuals.js"
+		},
 		"./attachments": {
 			"types": "./dist/attachments.d.ts",
 			"svelte": "./dist/attachments.js"
@@ -64,6 +72,11 @@
 		"isomorphic-dompurify": "^3.23.0",
 		"shiki": "^4.4.3"
 	},
+	"dependencies": {
+		"vega": "6.4.0",
+		"vega-embed": "7.3.0",
+		"vega-lite": "6.4.3"
+	},
 	"devDependencies": {
 		"@lucide/svelte": "^1.7.0",
 		"@poodle64/design-tokens": "workspace:*",