@deskwork/studio 0.15.0 → 0.16.0

package/dist/pages/scrapbook/text-helpers.js

@@ -0,0 +1,92 @@
+/**
+ * Scrapbook text-content helpers — pure Buffer/string utilities for
+ * rendering closed-state previews and per-kind meta strings.
+ */
+export function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * 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 function stripFrontmatter(text) {
+    if (!text.startsWith('---\n'))
+        return text;
+    const closeIdx = text.indexOf('\n---\n', 4);
+    if (closeIdx < 0)
+        return text;
+    return text.slice(closeIdx + 5).replace(/^\n+/, '');
+}
+/**
+ * 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 function previewExcerpt(buf, kind) {
+    let text = buf.subarray(0, Math.min(buf.byteLength, 2400)).toString('utf-8');
+    if (text.indexOf('\0') >= 0)
+        return null;
+    if (kind === 'md')
+        text = stripFrontmatter(text);
+    if (kind === 'json') {
+        try {
+            const fullText = buf.toString('utf-8');
+            text = JSON.stringify(JSON.parse(fullText), null, 2);
+        }
+        catch {
+            // Invalid JSON — fall through to the raw-text excerpt below.
+        }
+    }
+    const excerpt = text.split('\n').slice(0, 8).join('\n').slice(0, 600);
+    if (excerpt.trim() === '')
+        return null;
+    return excerpt;
+}
+/**
+ * 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 function countLines(buf) {
+    let count = 0;
+    for (const b of buf)
+        if (b === 0x0a)
+            count++;
+    if (buf.length > 0 && buf[buf.length - 1] !== 0x0a)
+        count++;
+    return count;
+}
+/**
+ * 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 function countJsonKeys(buf) {
+    try {
+        const obj = JSON.parse(buf.toString('utf-8'));
+        if (obj !== null && typeof obj === 'object' && !Array.isArray(obj)) {
+            return Object.keys(obj).length;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=text-helpers.js.map

package/dist/pages/scrapbook/text-helpers.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * Scrapbook page render context — shared between dispatch + render
+ * helpers in the scrapbook page split.
+ *
+ * #205 — the entryId is the load-bearing addition. When present, it
+ * threads into the file-fetch URL via `entryId=` so the read-only
+ * binary endpoint resolves through `scrapbookDirForEntry` (matching
+ * the entry-aware mutation API). When absent, slug-template addressing
+ * (`path=`) is the back-compat fallback.
+ */
+import type { StudioContext } from '../../routes/api.ts';
+/**
+ * Per-render context for the scrapbook page. Carries a pre-resolved
+ * absolute scrapbook directory (used for filesystem reads in
+ * `computeKindMeta` / `renderPreview`) plus the addressing identifiers
+ * used in URL emission (`site`, `path`, optional `entryId`).
+ */
+export interface RenderCtx {
+    studio: StudioContext;
+    site: string;
+    path: string;
+    entryId?: string;
+    /** Absolute path of the scrapbook directory on disk. */
+    scrapbookDir: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pages/scrapbook/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/pages/scrapbook/types.js

@@ -0,0 +1,12 @@
+/**
+ * Scrapbook page render context — shared between dispatch + render
+ * helpers in the scrapbook page split.
+ *
+ * #205 — the entryId is the load-bearing addition. When present, it
+ * threads into the file-fetch URL via `entryId=` so the read-only
+ * binary endpoint resolves through `scrapbookDirForEntry` (matching
+ * the entry-aware mutation API). When absent, slug-template addressing
+ * (`path=`) is the back-compat fallback.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/pages/scrapbook/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/pages/scrapbook.d.ts

@@ -1,14 +1,14 @@
 /**
  * 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 lives in the `scrapbook/` directory (one module
+ * per concern, each under the 500-line cap). This file re-exports the
+ * public render function + error type so the existing `server.ts`
+ * import keeps working.
  *
- * 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
+ * Mirrors the post-#191 envelope/dispatch split for mutations
+ * (`routes/scrapbook-mutation-{envelope,dispatch}.ts`): the slim entry
+ * is the public surface; the directory holds the concerns.
  */
-import type { StudioContext } from '../routes/api.ts';
-export declare function renderScrapbookPage(ctx: StudioContext, site: string, path: string): string;
+export { renderScrapbookPage, ScrapbookPageError, } from './scrapbook/index.ts';
 //# sourceMappingURL=scrapbook.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scrapbook.d.ts","sourceRoot":"","sources":["../../src/pages/scrapbook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAskBtD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAuDR"}
+{"version":3,"file":"scrapbook.d.ts","sourceRoot":"","sources":["../../src/pages/scrapbook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}