@bytesbybrandon/living-docs 0.2.0 → 0.2.1

package/README.md

@@ -96,6 +96,7 @@ Detailed references:
 * [Guarantees](docs/guide/guarantees.md)
 * [Architecture](ARCHITECTURE.md)
 * [Decisions](docs/decisions/0001-one-model-three-themes.md)
+* [Website](https://bytesbybrandon.github.io/living-docs/), built from this repository with `npm run site`
 
 ---
 
@@ -122,7 +123,8 @@ living-docs/
     render/            block renderers, SVG generators, style resolution, themes
     server/            local preview server
   samples/             sample models and one Markdown source
-  scripts/             sample build script
+  scripts/             sample and website build scripts
+  site/                landing page template and stylesheet for the website
   tests/               Node test runner suites
   docs/
     decisions/         architecture decision records

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytesbybrandon/living-docs",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Turn a source document into a designed, self-contained living doc: academic paper, dark reading notes, or telemetry console. Ships an AXI CLI and an MCP server.",
   "type": "module",
   "license": "MIT",
@@ -47,8 +47,9 @@
     "access": "public"
   },
   "scripts": {
-    "test": "node --test tests/cli.test.js tests/ingest.test.js tests/mcp.test.js tests/motion.test.js tests/render.test.js tests/style.test.js tests/validate.test.js",
-    "samples": "node scripts/build-samples.js"
+    "test": "node --test tests/cli.test.js tests/ingest.test.js tests/mcp.test.js tests/motion.test.js tests/render.test.js tests/site.test.js tests/style.test.js tests/validate.test.js",
+    "samples": "node scripts/build-samples.js",
+    "site": "node scripts/build-site.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.2",

package/src/ingest/index.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { parseMarkdown, slug, wordCount, plainText } from '../model/markdown.js';
+import { parseMarkdown, slug, wordCount } from '../model/markdown.js';
 import { htmlToMarkdown, htmlTitle } from './html.js';
 import { textToMarkdown } from './text.js';
 
@@ -79,8 +79,8 @@ function normalizeBlocks(blocks) {
       if (block.type === 'table') {
         return {
           type: 'table',
-          columns: block.columns.map(c => plainText(c)),
-          rows: block.rows.map(row => row.map(cell => plainText(cell)))
+          columns: block.columns.map(c => c.trim()),
+          rows: block.rows.map(row => row.map(cell => cell.trim()))
         };
       }
       if (block.type === 'list') {
@@ -200,16 +200,24 @@ export function blockToModelBlock(block) {
 export function draftModel(ingested, { theme = 'paper-dark', includePreamble = true, maxBlocks = 400 } = {}) {
   const { meta, sections, preamble } = ingested;
   const blocks = [];
+  let abstractPending = Boolean(meta.abstract);
+  const takeBlock = block => {
+    if (abstractPending && block.type === 'paragraph' && block.text === meta.abstract) {
+      abstractPending = false;
+      return null;
+    }
+    return blockToModelBlock(block);
+  };
   if (includePreamble && preamble.length) {
     for (const block of preamble) {
-      const mapped = blockToModelBlock(block);
+      const mapped = takeBlock(block);
       if (mapped) blocks.push(mapped);
     }
   }
   for (const section of sections) {
     blocks.push({ type: 'heading', title: section.title, level: 2 });
     for (const block of section.blocks) {
-      const mapped = blockToModelBlock(block);
+      const mapped = takeBlock(block);
       if (mapped) blocks.push(mapped);
       if (blocks.length >= maxBlocks) break;
     }

package/src/model/markdown.js

@@ -56,7 +56,8 @@ const olRe = /^\s*\d+[.)]\s+(.*)$/;
 const hrRe = /^\s*([-*_])(?:\s*\1){2,}\s*$/;
 
 function splitRow(line) {
-  return line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|').map(cell => cell.trim());
+  const body = line.trim().replace(/^\|/, '').replace(/(?<!\\)\|$/, '');
+  return body.split(/(?<!\\)\|/).map(cell => cell.trim().replace(/\\\|/g, '|'));
 }
 
 /**

package/src/model/schema.js

@@ -300,7 +300,8 @@ export const STYLE = {
   seed: str('hex color that derives the accent family, e.g. #2f6f8f', { optional: true }),
   type: oneOf(['classic', 'editorial', 'technical', 'mono', 'hybrid', 'terminal'], 'curated type pairing', { optional: true }),
   density: oneOf(['compact', 'normal', 'roomy'], 'vertical rhythm', { optional: true }),
-  figure: oneOf(['outline', 'solid', 'minimal'], 'diagram and chart treatment', { optional: true })
+  figure: oneOf(['outline', 'solid', 'minimal'], 'diagram and chart treatment', { optional: true }),
+  layout: oneOf(['columns', 'single'], 'paper themes only: two columns (default) or one reading column for code and wide tables', { optional: true })
 };
 
 export const META = {

package/src/render/style.js

@@ -173,13 +173,15 @@ export function resolveStyle(theme, basePalette, style = {}, accentOverride) {
 
   const density = DENSITIES.has(style.density) ? style.density : 'normal';
   const figure = FIGURES.has(style.figure) ? style.figure : 'outline';
+  const layout = !isConsole && style.layout === 'single' ? 'single' : 'columns';
 
   return {
     palette,
     type,
     density,
     figure,
-    className: `density-${density} type-${type} fig-${figure}`
+    layout,
+    className: `density-${density} type-${type} fig-${figure} layout-${layout}`
   };
 }
 
@@ -287,5 +289,8 @@ export function styleCss(theme, palette, resolved) {
   const overrides = theme === 'hud' ? CONSOLE_OVERRIDES : PAPER_OVERRIDES;
   const density = DENSITY[theme]?.[resolved.density] || '';
   const type = TYPE[theme]?.[resolved.type] || '';
-  return `${palettes(palette)}${overrides}${density}${type}`;
+  const layout = resolved.layout === 'single'
+    ? '.columns{column-count:1;max-width:880px;margin-left:auto;margin-right:auto}.span-page{column-span:none}.footnotes{column-count:1}'
+    : '';
+  return `${palettes(palette)}${overrides}${density}${type}${layout}`;
 }

package/src/render/themes/hud.js

@@ -43,7 +43,7 @@ body{margin:0;background:#020409;color:var(--ink);font-family:var(--mono);font-s
 .scene-head{padding:14px 16px 0}
 .scene-head .brand-row{padding-bottom:6px}
 .scene-top{display:flex;justify-content:space-between;padding:12px 16px 6px;font-size:9px;letter-spacing:.12em;color:#5f8090;text-transform:uppercase}
-.scene-stage{position:relative;aspect-ratio:16/8.6;min-height:300px;margin-top:2px;background:radial-gradient(ellipse at 55% 45%,rgba(30,90,120,.35),rgba(4,8,14,0) 66%),#03060b}
+.scene-stage{position:relative;width:100%;min-width:0;aspect-ratio:16/8.6;min-height:300px;margin-top:2px;background:radial-gradient(ellipse at 55% 45%,rgba(30,90,120,.35),rgba(4,8,14,0) 66%),#03060b}
 .scene-canvas{position:absolute;inset:0;width:100%;height:100%}
 .scene-label{position:absolute;transform:translate(-50%,-50%);font-size:9.5px;letter-spacing:.04em;color:#7fa6b8;white-space:nowrap;text-shadow:0 0 6px #03060b;pointer-events:none}
 .scene-crosshair{position:absolute;transform:translate(-50%,-50%);width:190px;height:190px;border:1px solid rgba(94,200,229,.22);border-radius:50%;pointer-events:none}
@@ -217,7 +217,7 @@ tbody td{padding:5px 6px;color:#b7d4e1;border-bottom:1px solid #0a1822}
   .hud-head{flex-direction:column;gap:8px}
   .live{font-size:8px}
   .scene-stage{min-height:240px}
-  .scene-card{transform:translate(12px,18px);min-width:200px;max-width:230px}
+  .scene-card{left:12px!important;top:auto!important;bottom:10px;transform:none;min-width:0;max-width:none;width:calc(100% - 24px)}
   .scene-label{font-size:8px}
   .sc-tail{margin-left:0}
   .footnotes{column-count:1}