@supersuit/artifacts 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 `@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.6.0 (2026-09-27)
+
+**"Updated" names the exact minute, in the reader's own time zone.**
+
+- The line under an artifact's summary read "Updated September 27, 2026", so a page republished
+  three times in one evening looked the same each time. It now reads "Updated September 27, 2026
+  at 8:07 AM CDT": the server renders UTC, and a small client component, `UpdatedTime`, swaps in
+  the viewer's zone once the page runs. The value is a `<time dateTime>` carrying the ISO stamp.
+- New `formatUpdated(iso, timeZone?)` in `src/artifacts/updated-at.ts`; a bad value renders
+  nothing rather than an invented time.
+- DETECTOR: an artifact page whose "Updated" line has no clock time.
+- REMEDY: take 0.6.0; nothing to configure.
+- Tests: `updated-at.test.ts` (exact minute and zone, UTC default, bad input), verified red with
+  the minute removed.
+
 ## 0.5.0 (2026-09-27)
 
 **Inline definitions: a page can define its jargon, and a reader sees it in line.**

package/lib/artifacts/updated-at.d.ts

@@ -0,0 +1 @@
+export declare function formatUpdated(iso: string, timeZone?: string): string;

package/lib/artifacts/updated-at.js

@@ -0,0 +1,11 @@
+// The "Updated" line under an artifact's summary, to the exact minute with its zone named.
+// The server renders UTC; the reader swaps in the viewer's own zone once it runs, so the minute
+// is always one a person can place (Gary, 2026-09-27).
+export function formatUpdated(iso, timeZone = 'UTC') {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return '';
+    const date = d.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric', timeZone });
+    const time = d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', timeZone, timeZoneName: 'short' });
+    return `${date} at ${time}`;
+}

package/lib/reader/updated-time.d.ts

@@ -0,0 +1,4 @@
+/** The exact minute a page was last updated, in the reader's own time zone once the page runs. */
+export declare function UpdatedTime({ iso }: {
+    iso: string;
+}): import("react").JSX.Element;

package/lib/reader/updated-time.js

@@ -0,0 +1,12 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { formatUpdated } from '../artifacts/updated-at.js';
+/** The exact minute a page was last updated, in the reader's own time zone once the page runs. */
+export function UpdatedTime({ iso }) {
+    const [text, setText] = useState(() => formatUpdated(iso));
+    useEffect(() => {
+        setText(formatUpdated(iso, Intl.DateTimeFormat().resolvedOptions().timeZone));
+    }, [iso]);
+    return (_jsx("time", { dateTime: iso, suppressHydrationWarning: true, children: text }));
+}

package/lib/routes/artifacts.js

@@ -16,6 +16,7 @@ import { showToc, tocOf, TocInline, TocRail } from '../artifacts/toc.js';
 import { renderShareCard } from '../brand/share-card.js';
 import { ArtifactReader } from '../reader/artifact-reader.js';
 import { ReaderWatch } from '../reader/reader-watch.js';
+import { UpdatedTime } from '../reader/updated-time.js';
 import { ACCESS_LEVELS, GRANT_COOKIE, GRANT_TTL_SECONDS, decide, firstName, mintGrant, safeReturnPath, signInUrl, verifyGrant, verifyPass, } from '../artifacts/reader.js';
 import { FLAG_KINDS, summarize } from '../artifacts/readers-store.js';
 import { AckDoor, ConfidentialBanner, NO_PRINT_CSS, NotAllowedDoor, SignInDoor, Watermark, ackText } from '../artifacts/confidential.js';
@@ -145,9 +146,8 @@ export function createArtifactRoutes(config) {
                 words = [];
             }
         }
-        const when = new Date(a.updatedAt).toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' });
         const toc = showToc(a.markdown, a.toc) ? tocOf(a.markdown) : [];
-        return (_jsxs(_Fragment, { children: [toc.length ? _jsx(TocRail, { items: toc }) : null, _jsxs("div", { id: "artifact-narration-root", children: [_jsxs("div", { className: `mx-auto max-w-2xl px-6 ${top ? 'pt-24 sm:pt-28' : 'pt-12'} pb-8 text-center`, children: [_jsx("p", { "data-nospeak": true, className: "mb-4 text-[11px] font-medium uppercase tracking-[0.3em]", style: { color: brand.accent }, children: brand.kicker }), _jsx("h1", { className: "text-4xl sm:text-5xl", style: { fontFamily: brand.type.display, color: brand.ink }, children: a.title }), a.subtitle ? (_jsx("p", { className: "mx-auto mt-4 max-w-xl text-xl sm:text-2xl", style: { fontFamily: brand.type.display, color: brand.ink }, children: a.subtitle })) : null, _jsx("p", { className: "mx-auto mt-6 max-w-xl text-lg italic opacity-80", children: a.summary }), _jsxs("p", { "data-nospeak": true, className: "mt-4 text-xs opacity-50", children: ["Updated ", when] })] }), a.cover ? (_jsx("div", { className: "mx-auto max-w-2xl px-6 pb-8", children: _jsx("img", { src: a.cover, alt: "", className: "w-full rounded-xl border border-[color:var(--a-line)]" }) })) : null, _jsxs("article", { className: "mx-auto max-w-2xl px-6 pb-24", children: [toc.length ? _jsx(TocInline, { items: toc }) : null, _jsx(ArtifactMarkdown, { markdown: a.markdown, definitions: a.definitions, notes: config.state && a.state ? { artifactId: a.id, accent: brand.accent } : undefined })] })] }), a.narration && words.length > 0 ? (_jsx(ArtifactReader, { src: a.narration, words: words, rootId: "artifact-narration-root", label: brand.narratorLabel(a.voice), accent: brand.accent, ground: brand.ground })) : null] }));
+        return (_jsxs(_Fragment, { children: [toc.length ? _jsx(TocRail, { items: toc }) : null, _jsxs("div", { id: "artifact-narration-root", children: [_jsxs("div", { className: `mx-auto max-w-2xl px-6 ${top ? 'pt-24 sm:pt-28' : 'pt-12'} pb-8 text-center`, children: [_jsx("p", { "data-nospeak": true, className: "mb-4 text-[11px] font-medium uppercase tracking-[0.3em]", style: { color: brand.accent }, children: brand.kicker }), _jsx("h1", { className: "text-4xl sm:text-5xl", style: { fontFamily: brand.type.display, color: brand.ink }, children: a.title }), a.subtitle ? (_jsx("p", { className: "mx-auto mt-4 max-w-xl text-xl sm:text-2xl", style: { fontFamily: brand.type.display, color: brand.ink }, children: a.subtitle })) : null, _jsx("p", { className: "mx-auto mt-6 max-w-xl text-lg italic opacity-80", children: a.summary }), _jsxs("p", { "data-nospeak": true, className: "mt-4 text-xs opacity-50", children: ["Updated ", _jsx(UpdatedTime, { iso: a.updatedAt })] })] }), a.cover ? (_jsx("div", { className: "mx-auto max-w-2xl px-6 pb-8", children: _jsx("img", { src: a.cover, alt: "", className: "w-full rounded-xl border border-[color:var(--a-line)]" }) })) : null, _jsxs("article", { className: "mx-auto max-w-2xl px-6 pb-24", children: [toc.length ? _jsx(TocInline, { items: toc }) : null, _jsx(ArtifactMarkdown, { markdown: a.markdown, definitions: a.definitions, notes: config.state && a.state ? { artifactId: a.id, accent: brand.accent } : undefined })] })] }), a.narration && words.length > 0 ? (_jsx(ArtifactReader, { src: a.narration, words: words, rootId: "artifact-narration-root", label: brand.narratorLabel(a.voice), accent: brand.accent, ground: brand.ground })) : null] }));
     }
     const cookieLine = (value, maxAge) => `${GRANT_COOKIE}=${value}; Path=/; Max-Age=${maxAge}; HttpOnly; Secure; SameSite=Lax`;
     /** GET /api/reader/enter?pass=<pass>&to=/<id>: where the sign-in authority sends a signed-in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/artifacts",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "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",