@supersuit/artifacts 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 `@supersuit/artifacts`. One entry per version, newest first. Each entry says what changed, how a
 host can tell whether it is affected (DETECTOR), what a host does about it (REMEDY), and the tests.
 
+## 0.7.1 (2026-09-27)
+
+**The narrator reads the subtitle.** `narrationText` built the spoken text from the title, the
+summary and the body, while the page renders a `subtitle:` between the title and the summary with
+no `data-nospeak`. So the audio skipped the page's first line under the title, and the highlighter
+expected words the narration never said.
+
+- `narrationText` takes an optional `subtitle` and reads it second; the narration-text route
+  passes it.
+- DETECTOR: a page with a `subtitle:` whose audio goes straight from the title to the summary.
+- REMEDY: bump, then republish the page so its narration is regenerated (the spoken text changed,
+  so the narration hash no longer matches and the publisher re-narrates).
+- Tests: `narration.test.ts` pins title, subtitle, summary, body order.
+
 ## 0.7.0 (2026-09-27)
 
 **A real version history: every page names its version, lists every version with its change note,

package/lib/artifacts/narration.d.ts

@@ -1,6 +1,7 @@
 export declare function narrationTextFromMarkdown(markdown: string): string;
 export declare function narrationText(input: {
     title: string;
+    subtitle?: string;
     summary: string;
     markdown: string;
 }): string;

package/lib/artifacts/narration.js

@@ -76,8 +76,12 @@ export function narrationTextFromMarkdown(markdown) {
     blocks(tree.children, out);
     return clean(out);
 }
+// The subtitle renders between the title and the summary with no data-nospeak, so the
+// highlighter expects it there; leaving it out made the narrator skip the page's first line.
 export function narrationText(input) {
-    return [input.title.trim(), input.summary.trim(), narrationTextFromMarkdown(input.markdown)].filter(Boolean).join('\n');
+    return [input.title.trim(), (input.subtitle ?? '').trim(), input.summary.trim(), narrationTextFromMarkdown(input.markdown)]
+        .filter(Boolean)
+        .join('\n');
 }
 /** Tokens the highlighter and the timings agree on: whitespace-split, lowercased, letters and digits only. */
 export function normalizeWord(w) {

package/lib/routes/artifacts.js

@@ -391,7 +391,7 @@ export function createArtifactRoutes(config) {
         const a = await store.get(id);
         if (!a)
             return NextResponse.json({ error: `no artifact with id ${id}` }, { status: 404 });
-        return NextResponse.json({ id, text: narrationText({ title: a.title, summary: a.summary, markdown: a.markdown }) });
+        return NextResponse.json({ id, text: narrationText({ title: a.title, subtitle: a.subtitle, summary: a.summary, markdown: a.markdown }) });
     }
     /** PUT /api/artifacts/<id>/assets/<name>: raw bytes in, public URL out. 16 MiB cap. */
     async function PUT_ASSET(request, { params }) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/artifacts",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Publish markdown as branded, read-aloud pages from a Next.js app: the artifacts store, the route factory, the read-along reader, brand packs, password and confidential pages, and share cards.",
   "license": "MIT",
   "type": "module",