@deskwork/studio 0.15.0 → 0.16.0

package/dist/pages/scrapbook/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Scrapbook viewer — `/dev/scrapbook/:site/<path>`.
+ *
+ * Issue #161 redesign: aside-left folder card with numbered item list,
+ * vertical card grid with per-kind colored ribbons + always-visible foot
+ * toolbar + per-kind preview rendering, drop zone, secret section,
+ * single-expanded card invariant, aside cross-linking.
+ *
+ * The implementation is split across this directory (one module per
+ * concern, each under the 500-line cap). This file is the orchestrator:
+ * dispatch listing, build the render context, compose the chrome.
+ *
+ * Mockup: docs/superpowers/frontend-design/2026-05-02-review-redesign/scrapbook-redesign.html
+ * Spec:   docs/superpowers/specs/2026-05-02-scrapbook-redesign-impl-spec.md
+ */
+import type { StudioContext } from '../../routes/api.ts';
+export { ScrapbookPageError } from './dispatch.ts';
+export declare function renderScrapbookPage(ctx: StudioContext, site: string, path: string, opts?: {
+    entryId?: string;
+}): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/pages/scrapbook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pages/scrapbook/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkBzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,CA+EjB"}

package/dist/pages/scrapbook/index.js

@@ -0,0 +1,96 @@
+/**
+ * Scrapbook viewer — `/dev/scrapbook/:site/<path>`.
+ *
+ * Issue #161 redesign: aside-left folder card with numbered item list,
+ * vertical card grid with per-kind colored ribbons + always-visible foot
+ * toolbar + per-kind preview rendering, drop zone, secret section,
+ * single-expanded card invariant, aside cross-linking.
+ *
+ * The implementation is split across this directory (one module per
+ * concern, each under the 500-line cap). This file is the orchestrator:
+ * dispatch listing, build the render context, compose the chrome.
+ *
+ * Mockup: docs/superpowers/frontend-design/2026-05-02-review-redesign/scrapbook-redesign.html
+ * Spec:   docs/superpowers/specs/2026-05-02-scrapbook-redesign-impl-spec.md
+ */
+import { html, unsafe } from "../html.js";
+import { layout } from "../layout.js";
+import { renderEditorialFolio } from "../chrome.js";
+import { ScrapbookPageError, resolveListing } from "./dispatch.js";
+import { countByKind, renderAside, renderBreadcrumb, renderCard, renderComposer, renderDropZone, renderFilterChips, renderSearch, renderSecretSection, } from "./render.js";
+export { ScrapbookPageError } from "./dispatch.js";
+export async function renderScrapbookPage(ctx, site, path, opts = {}) {
+    // Validate site against the project's configured site list. Without
+    // this check, an unknown site key reaches the path resolver and
+    // produces either an opaque error or a path traversal vector.
+    if (!(site in ctx.config.sites)) {
+        throw new ScrapbookPageError(`unknown site: ${site}`, 404);
+    }
+    const requestedEntryId = opts.entryId !== undefined && opts.entryId.length > 0 ? opts.entryId : null;
+    const { scrapbookDir, result, resolvedEntryId } = await resolveListing(ctx, site, path, requestedEntryId);
+    const items = result.items;
+    const secretItems = result.secretItems;
+    const totalSize = items.reduce((s, i) => s + i.size, 0);
+    const lastModified = items.reduce((acc, i) => {
+        if (!i.mtime)
+            return acc;
+        if (!acc || i.mtime > acc)
+            return i.mtime;
+        return acc;
+    }, null);
+    const counts = countByKind(items);
+    const folderLabel = path.split('/').filter(Boolean).pop() ?? path;
+    // Effective entryId for URL emission: prefer the request-supplied id
+    // (so the client's mutation requests round-trip through the same
+    // addressing mode) and fall back to the slug-mode lookup result.
+    const effectiveEntryId = requestedEntryId ?? resolvedEntryId;
+    const rctx = effectiveEntryId !== null
+        ? { studio: ctx, site, path, entryId: effectiveEntryId, scrapbookDir }
+        : { studio: ctx, site, path, scrapbookDir };
+    const cards = items.map((item, i) => renderCard(rctx, item, i));
+    const cardsHtml = cards.map((c) => c.__raw).join('');
+    const reviewLink = effectiveEntryId !== null
+        ? `/dev/editorial-review/entry/${effectiveEntryId}`
+        : null;
+    // The data-entry-id attribute is consumed by scrapbook-client.ts —
+    // when present, the client sends `entryId` on mutation requests so
+    // writes resolve via `scrapbookDirForEntry` (#191). Falls back to
+    // `data-path` slug-template addressing when absent.
+    // entryId comes from a UUID lookup — already validated against the
+    // calendar's CalendarEntry.id, so no escaping concern beyond the
+    // belt-and-braces unsafe wrapping for the conditional attribute.
+    const entryIdAttr = effectiveEntryId !== null
+        ? unsafe(` data-entry-id="${effectiveEntryId}"`)
+        : unsafe('');
+    const body = html `
+    ${renderEditorialFolio('content', `scrapbook · ${site}/${path}`)}
+    <main class="scrap-page" data-site="${site}" data-path="${path}"${entryIdAttr}>
+      ${renderAside(site, path, items, totalSize, lastModified, secretItems.length, reviewLink)}
+      <section class="scrap-main">
+        <header class="scrap-main-header">
+          ${renderBreadcrumb(site, path)}
+          ${renderSearch()}
+        </header>
+        ${renderFilterChips(counts)}
+        ${renderComposer()}
+        <ol class="scrap-cards" id="cards" data-scrap-cards>
+          ${unsafe(cardsHtml)}
+        </ol>
+        ${renderDropZone()}
+        ${renderSecretSection(rctx, secretItems)}
+      </section>
+    </main>`;
+    return layout({
+        title: `scrapbook · ${folderLabel} — dev`,
+        cssHrefs: [
+            '/static/css/editorial-review.css',
+            '/static/css/editorial-nav.css',
+            '/static/css/scrapbook.css',
+            '/static/css/blog-figure.css',
+        ],
+        bodyAttrs: 'data-review-ui="scrapbook"',
+        bodyHtml: body,
+        scriptModules: ['scrapbook-client'],
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/pages/scrapbook/index.js.map

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

package/dist/pages/scrapbook/render.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Scrapbook page render helpers — RawHtml emitters for cards, previews,
+ * the aside, the new-note composer, the drop zone, the secret section,
+ * and the breadcrumb / search / filter chrome.
+ *
+ * Reads filesystem only via `computeKindMeta` and `renderPreview`; both
+ * resolve through the pre-resolved `RenderCtx.scrapbookDir` (set by the
+ * dispatch step) so render stays free of path-resolution logic.
+ */
+import { type ScrapbookItem } from '@deskwork/core/scrapbook';
+import { type RawHtml } from '../html.ts';
+import type { RenderCtx } from './types.ts';
+export interface KindCounts {
+    all: number;
+    md: number;
+    img: number;
+    json: number;
+    js: number;
+    txt: number;
+    other: number;
+}
+export declare function countByKind(items: readonly ScrapbookItem[]): KindCounts;
+/**
+ * Compute the per-kind extra meta string shown after the kind chip + size:
+ *   md / txt → "{N} lines"
+ *   json     → "{N} keys" (root must be a plain object; otherwise empty)
+ *   img      → "{W} × {H}" (PNG only; other formats → empty)
+ *   other    → empty
+ *
+ * ENOENT (race-window with delete) returns empty so the card still
+ * renders; other errors propagate to the page renderer.
+ */
+export declare function computeKindMeta(rctx: RenderCtx, item: ScrapbookItem, opts?: {
+    secret?: boolean;
+}): string;
+/**
+ * Server-side preview for the closed-state card. Img → bg-frame URL;
+ * md → italic Newsreader excerpt with frontmatter stripped; json → mono
+ * pre with parse-then-stringify pretty-print; txt → mono pre raw excerpt.
+ * Other / empty / binary-as-text → no preview block.
+ */
+export declare function renderPreview(rctx: RenderCtx, item: ScrapbookItem, opts?: {
+    secret?: boolean;
+}): RawHtml;
+export declare function renderFilterChips(counts: KindCounts): RawHtml;
+export declare function renderSearch(): RawHtml;
+export declare function renderBreadcrumb(site: string, path: string): RawHtml;
+export declare function renderAside(site: string, path: string, items: readonly ScrapbookItem[], totalSize: number, lastModified: string | null, secretCount: number, reviewLink: string | null): RawHtml;
+export declare function renderCard(rctx: RenderCtx, item: ScrapbookItem, index: number, opts?: {
+    secret?: boolean;
+}): RawHtml;
+/**
+ * Inline new-note composer (Phase 34b — #166).
+ *
+ * Mirrors the pre-F1 inline composer (`44094ee^:scrapbook.ts:274-294`),
+ * adapted to the F1 `.scrap-*` design vocabulary. Hidden by default;
+ * the aside's `+ new note` button reveals it via the client wire-up.
+ *
+ * Per `.claude/rules/affordance-placement.md`: component-attached to
+ * the page (not a generic toolbar), placed where the resulting note
+ * will appear in sorted position. Direct manipulation: in-page form,
+ * filename + body + secret toggle visible inline, Cmd/Ctrl+S saves,
+ * Esc cancels. Replaces the F1 `window.prompt()` regression (#166).
+ */
+export declare function renderComposer(): RawHtml;
+export declare function renderDropZone(): RawHtml;
+export declare function renderSecretSection(rctx: RenderCtx, secretItems: readonly ScrapbookItem[]): RawHtml;
+//# sourceMappingURL=render.d.ts.map

package/dist/pages/scrapbook/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/pages/scrapbook/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAQxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,UAAU,CAYvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,MAAM,CAwBR;AAsBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,OAAO,CAsCT;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAc7D;AAED,wBAAgB,YAAY,IAAI,OAAO,CAMtC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CA2CT;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,OAAO,CAqDT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAmBxC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,SAAS,aAAa,EAAE,GACpC,OAAO,CAcT"}

package/dist/pages/scrapbook/render.js

@@ -0,0 +1,315 @@
+/**
+ * Scrapbook page render helpers — RawHtml emitters for cards, previews,
+ * the aside, the new-note composer, the drop zone, the secret section,
+ * and the breadcrumb / search / filter chrome.
+ *
+ * Reads filesystem only via `computeKindMeta` and `renderPreview`; both
+ * resolve through the pre-resolved `RenderCtx.scrapbookDir` (set by the
+ * dispatch step) so render stays free of path-resolution logic.
+ */
+import { readFileSync } from 'node:fs';
+import { formatRelativeTime, formatSize, scrapbookFilePathAtDir, } from '@deskwork/core/scrapbook';
+import { html, unsafe } from "../html.js";
+import { countJsonKeys, countLines, escapeHtml, previewExcerpt, } from "./text-helpers.js";
+import { readImageDimensions } from "./image-readers.js";
+const KIND_LABEL = {
+    md: 'MD',
+    img: 'IMG',
+    json: 'JSON',
+    js: 'JS',
+    txt: 'TXT',
+    other: '·',
+};
+export function countByKind(items) {
+    const counts = {
+        all: items.length,
+        md: 0,
+        img: 0,
+        json: 0,
+        js: 0,
+        txt: 0,
+        other: 0,
+    };
+    for (const i of items)
+        counts[i.kind]++;
+    return counts;
+}
+/**
+ * Compute the per-kind extra meta string shown after the kind chip + size:
+ *   md / txt → "{N} lines"
+ *   json     → "{N} keys" (root must be a plain object; otherwise empty)
+ *   img      → "{W} × {H}" (PNG only; other formats → empty)
+ *   other    → empty
+ *
+ * ENOENT (race-window with delete) returns empty so the card still
+ * renders; other errors propagate to the page renderer.
+ */
+export function computeKindMeta(rctx, item, opts = {}) {
+    if (item.kind !== 'md' && item.kind !== 'txt' && item.kind !== 'json' && item.kind !== 'img') {
+        return '';
+    }
+    let buf;
+    try {
+        const fullPath = scrapbookFilePathAtDir(rctx.scrapbookDir, item.name, opts.secret ? { secret: true } : {});
+        buf = readFileSync(fullPath);
+    }
+    catch (e) {
+        if (e instanceof Error && 'code' in e && e.code === 'ENOENT')
+            return '';
+        throw e;
+    }
+    if (item.kind === 'md' || item.kind === 'txt')
+        return `${countLines(buf)} lines`;
+    if (item.kind === 'json') {
+        const keys = countJsonKeys(buf);
+        return keys !== null ? `${keys} keys` : '';
+    }
+    // img
+    const dims = readImageDimensions(buf);
+    return dims ? `${dims.width} × ${dims.height}` : '';
+}
+/**
+ * Build the file-fetch URL for the read-only binary endpoint. Prefers
+ * entry-aware addressing when `rctx.entryId` is set (#205); falls back
+ * to slug-template addressing (`path=`) otherwise.
+ */
+function buildFileFetchUrl(rctx, filename, secret) {
+    const params = new URLSearchParams({ site: rctx.site, name: filename });
+    if (rctx.entryId !== undefined && rctx.entryId.length > 0) {
+        params.set('entryId', rctx.entryId);
+    }
+    else {
+        params.set('path', rctx.path);
+    }
+    if (secret)
+        params.set('secret', '1');
+    return `/api/dev/scrapbook-file?${params.toString()}`;
+}
+/**
+ * Server-side preview for the closed-state card. Img → bg-frame URL;
+ * md → italic Newsreader excerpt with frontmatter stripped; json → mono
+ * pre with parse-then-stringify pretty-print; txt → mono pre raw excerpt.
+ * Other / empty / binary-as-text → no preview block.
+ */
+export function renderPreview(rctx, item, opts = {}) {
+    const { secret = false } = opts;
+    if (item.kind === 'img') {
+        const url = buildFileFetchUrl(rctx, item.name, secret);
+        return unsafe(html `
+      <div class="scrap-preview scrap-preview--img" aria-hidden="true">
+        <div class="scrap-preview--img-frame" style="background-image: url(&quot;${url}&quot;);"></div>
+      </div>`);
+    }
+    if (item.kind !== 'md' && item.kind !== 'txt' && item.kind !== 'json') {
+        return unsafe('');
+    }
+    try {
+        const fullPath = scrapbookFilePathAtDir(rctx.scrapbookDir, item.name, secret ? { secret: true } : {});
+        const buf = readFileSync(fullPath);
+        const excerpt = previewExcerpt(buf, item.kind);
+        if (excerpt === null)
+            return unsafe('');
+        const safe = escapeHtml(excerpt);
+        if (item.kind === 'json' || item.kind === 'txt') {
+            return unsafe(html `
+        <pre class="scrap-preview scrap-preview--mono" aria-hidden="true">${unsafe(safe)}</pre>`);
+        }
+        return unsafe(html `
+      <div class="scrap-preview scrap-preview-md" aria-hidden="true"><p>${unsafe(safe)}</p></div>`);
+    }
+    catch (e) {
+        // ENOENT = file disappeared between listScrapbook and this read (race
+        // window with delete); rendering an empty preview is the right call.
+        // Anything else (EACCES, EISDIR, encoding bugs) propagates so the
+        // operator sees a real error instead of a silently-broken page.
+        if (e instanceof Error && 'code' in e && e.code === 'ENOENT') {
+            return unsafe('');
+        }
+        throw e;
+    }
+}
+export function renderFilterChips(counts) {
+    const chip = (kind, label, isAll = false) => unsafe(html `
+    <button class="scrap-filter" type="button" data-filter="${kind}"
+      aria-pressed="${isAll ? 'true' : 'false'}">${label} · ${counts[kind]}</button>`);
+    return unsafe(html `
+    <div class="scrap-filters" role="toolbar" aria-label="filter by kind">
+      ${chip('all', 'all', true)}
+      ${chip('md', 'md')}
+      ${chip('img', 'img')}
+      ${chip('json', 'json')}
+      ${chip('txt', 'txt')}
+      ${chip('other', 'other')}
+    </div>`);
+}
+export function renderSearch() {
+    return unsafe(html `
+    <div class="scrap-search">
+      <input type="search" placeholder="filter by name or content" aria-label="filter scrapbook" data-scrap-search />
+      <span class="scrap-search-kbd">/</span>
+    </div>`);
+}
+export function renderBreadcrumb(site, path) {
+    const segments = path.split('/').filter(Boolean);
+    const last = segments[segments.length - 1] ?? path;
+    return unsafe(html `
+    <nav class="scrap-breadcrumb" aria-label="hierarchy">
+      <a href="/dev/content/${site}">${site}</a><span class="sep">›</span>
+      <b>${last}</b>
+    </nav>`);
+}
+export function renderAside(site, path, items, totalSize, lastModified, secretCount, reviewLink) {
+    const lastModifiedLabel = lastModified ? formatRelativeTime(lastModified) : '—';
+    const publicCount = items.length;
+    const sizeLabel = formatSize(totalSize);
+    const folderLabel = path.split('/').filter(Boolean).pop() ?? path;
+    const fullPath = `${site}/${path}/scrapbook/`;
+    // #168 Phase 34 ship-pass — when this scrapbook belongs to a tracked
+    // calendar entry, expose a "← back to review" link so the operator
+    // who arrived from the entry-review surface (or via the dashboard's
+    // scrapbook chip) has an obvious path back. Pre-fix the only nav
+    // affordance was the breadcrumb's site link, which lands on the
+    // content tree, not the entry-review.
+    const backLink = reviewLink !== null
+        ? unsafe(html `<p class="scrap-aside-back"><a href="${reviewLink}">← back to review</a></p><hr />`)
+        : unsafe('');
+    return unsafe(html `
+    <aside class="scrap-aside">
+      ${backLink}
+      <p class="scrap-aside-kicker"><em>§</em> The folder</p>
+      <h1 class="scrap-aside-title">${folderLabel}</h1>
+      <p class="scrap-aside-meta">${site}</p>
+      <hr />
+      <p class="scrap-aside-totals">
+        <strong>${publicCount}</strong> public ·
+        <strong>${secretCount}</strong> secret ·
+        <em>${sizeLabel}</em>
+      </p>
+      <p class="scrap-aside-meta">last modified ${lastModifiedLabel}</p>
+      <hr />
+      <ol class="scrap-aside-list" data-scrap-aside-list>
+        ${items.map((item, i) => {
+        const seq = String(i + 1).padStart(2, '0');
+        return unsafe(html `<li><span class="num">${seq}</span><a href="#item-${i + 1}" data-scrap-aside-link>${item.name}</a></li>`);
+    })}
+      </ol>
+      <hr />
+      <div class="scrap-aside-actions">
+        <button class="scrap-aside-btn scrap-aside-btn--primary" type="button" data-action="new-note">+ new note</button>
+        <button class="scrap-aside-btn" type="button" data-action="upload">+ upload file</button>
+      </div>
+      <hr />
+      <p class="scrap-aside-path">${fullPath}</p>
+    </aside>`);
+}
+export function renderCard(rctx, item, index, opts = {}) {
+    const { secret = false } = opts;
+    const seq = String(index + 1).padStart(2, '0');
+    const kindLabel = KIND_LABEL[item.kind];
+    const kindClass = item.kind === 'other' ? '' : `scrap-kind--${item.kind}`;
+    const time = item.mtime
+        ? html `<time class="scrap-time" datetime="${item.mtime}">${formatRelativeTime(item.mtime)}</time>`
+        : '';
+    const preview = renderPreview(rctx, item, { secret });
+    const kindMeta = computeKindMeta(rctx, item, { secret });
+    const kindMetaHtml = kindMeta
+        ? unsafe(html `<span>·</span><span>${kindMeta}</span>`)
+        : unsafe('');
+    const editBtn = item.kind === 'img'
+        ? unsafe('')
+        : unsafe(html `<button class="scrap-tool" type="button" data-action="edit">edit</button>`);
+    // Secret cards get id="secret-item-N" to disambiguate from public ids in
+    // restoreFromHash + aside cross-link lookups (F4 contract); the
+    // mark-secret action toggle reads "mark public" since clicking it moves
+    // the card OUT of the secret section.
+    const id = secret ? `secret-item-${index + 1}` : `item-${index + 1}`;
+    const markSecretLabel = secret ? 'mark public' : 'mark secret';
+    const dataSecretAttr = secret ? ' data-secret="true"' : '';
+    // #164 Phase 34b — small ⚿ glyph next to .scrap-name on secret
+    // cards. Provides visual continuity for the secret marker once a
+    // card is expanded (where it grows outside the grouped section's
+    // visual scope).
+    const secretGlyph = secret
+        ? unsafe(html `<span class="scrap-name-secret-mark" aria-label="secret" title="secret — never published">⚿</span>`)
+        : unsafe('');
+    return unsafe(html `
+    <li class="scrap-card" data-kind="${item.kind}" data-state="closed" id="${id}"${unsafe(dataSecretAttr)}>
+      <div class="scrap-card-head">
+        <span class="scrap-seq">N° ${seq}</span>
+        ${secretGlyph}
+        <span class="scrap-name" data-action="open">${item.name}</span>
+        ${unsafe(time)}
+      </div>
+      <div class="scrap-card-meta">
+        <span class="scrap-kind ${kindClass}">${kindLabel}</span>
+        <span class="scrap-size">${formatSize(item.size)}</span>
+        ${kindMetaHtml}
+      </div>
+      ${preview}
+      <div class="scrap-card-foot">
+        <button class="scrap-tool scrap-tool--primary" type="button" data-action="open">open</button>
+        ${editBtn}
+        <button class="scrap-tool" type="button" data-action="rename">rename</button>
+        <button class="scrap-tool" type="button" data-action="mark-secret">${markSecretLabel}</button>
+        <span class="spacer"></span>
+        <button class="scrap-tool scrap-tool--delete" type="button" data-action="delete">delete</button>
+      </div>
+    </li>`);
+}
+/**
+ * Inline new-note composer (Phase 34b — #166).
+ *
+ * Mirrors the pre-F1 inline composer (`44094ee^:scrapbook.ts:274-294`),
+ * adapted to the F1 `.scrap-*` design vocabulary. Hidden by default;
+ * the aside's `+ new note` button reveals it via the client wire-up.
+ *
+ * Per `.claude/rules/affordance-placement.md`: component-attached to
+ * the page (not a generic toolbar), placed where the resulting note
+ * will appear in sorted position. Direct manipulation: in-page form,
+ * filename + body + secret toggle visible inline, Cmd/Ctrl+S saves,
+ * Esc cancels. Replaces the F1 `window.prompt()` regression (#166).
+ */
+export function renderComposer() {
+    return unsafe(html `
+    <form class="scrap-composer" data-scrap-composer hidden>
+      <header class="scrap-composer-head">
+        <span class="scrap-composer-glyph" aria-hidden="true">✎</span>
+        <span class="scrap-composer-kicker">NEW NOTE</span>
+        <input type="text" class="scrap-composer-filename" data-composer-filename
+          placeholder="note-name.md" aria-label="new note filename" />
+        <label class="scrap-composer-secret" title="save under scrapbook/secret/ — never published">
+          <input type="checkbox" data-composer-secret />
+          <span>secret</span>
+        </label>
+        <button class="scrap-tool" type="button" data-action="composer-cancel">cancel</button>
+        <button class="scrap-tool scrap-tool--primary" type="submit" data-action="composer-save">save →</button>
+      </header>
+      <textarea class="scrap-composer-body" data-composer-body
+        placeholder="Write the note in markdown. Cmd/Ctrl+S saves, Esc cancels."
+        aria-label="new note body" rows="8"></textarea>
+    </form>`);
+}
+export function renderDropZone() {
+    return unsafe(html `
+    <div class="scrap-drop" role="button" tabindex="0" data-action="upload"
+         aria-label="Drop a file here, or press Enter to pick one">
+      ── drop a file here, or pick one ──
+    </div>`);
+}
+export function renderSecretSection(rctx, secretItems) {
+    if (secretItems.length === 0)
+        return unsafe('');
+    const cards = secretItems.map((item, i) => renderCard(rctx, item, i, { secret: true }));
+    return unsafe(html `
+    <section class="scrap-secret" aria-label="secret items">
+      <header class="scrap-secret-head">
+        <span class="scrap-secret-mark" aria-hidden="true">⚿</span>
+        <h2 class="scrap-secret-title">Secret</h2>
+        <span class="scrap-secret-badge">private — never published</span>
+      </header>
+      <ol class="scrap-cards">
+        ${cards}
+      </ol>
+    </section>`);
+}
+//# sourceMappingURL=render.js.map

package/dist/pages/scrapbook/render.js.map

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

package/dist/pages/scrapbook/text-helpers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Scrapbook text-content helpers — pure Buffer/string utilities for
+ * rendering closed-state previews and per-kind meta strings.
+ */
+export declare function escapeHtml(s: string): string;
+/**
+ * Strip a YAML frontmatter block from the top of an md file. Only strips
+ * the leading `---\n...\n---\n` block; body-level `---` separators (Setext
+ * H2 underline, thematic break) are preserved because the function only
+ * looks at the first 4 chars for the opener.
+ */
+export declare function stripFrontmatter(text: string): string;
+/**
+ * Build the closed-state preview excerpt for md/json/txt. Returns null
+ * when there's nothing useful to render — empty file, frontmatter-only
+ * file, or binary masquerading as text — so the caller can omit the
+ * preview block entirely (matches "other" kind treatment, avoids the
+ * 6rem min-height void).
+ *
+ * For json: pretty-print via JSON.parse + JSON.stringify(_, null, 2) so
+ * minified single-line files still render multi-line. Falls back to raw
+ * content on parse error (bad JSON is still readable as text).
+ *
+ * Binary detection: NUL byte presence after UTF-8 decode. Real text
+ * almost never has NUL; binary files have it within the first KB.
+ */
+export declare function previewExcerpt(buf: Buffer, kind: 'md' | 'json' | 'txt'): string | null;
+/**
+ * Count lines in a text file: number of `\n` bytes plus 1 if the last
+ * byte isn't `\n` (so a 3-line file whether or not it has a trailing
+ * newline reports 3).
+ */
+export declare function countLines(buf: Buffer): number;
+/**
+ * Count top-level keys in a JSON object. Returns null if the file is not
+ * valid JSON or its root is not a plain object (arrays, primitives →
+ * null; caller renders no extra meta).
+ */
+export declare function countJsonKeys(buf: Buffer): number | null;
+//# sourceMappingURL=text-helpers.d.ts.map

package/dist/pages/scrapbook/text-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-helpers.d.ts","sourceRoot":"","sources":["../../../src/pages/scrapbook/text-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAetF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUxD"}