@libar-dev/architect 1.0.0-pre.3

package/dist/renderable/load-preamble.js

@@ -0,0 +1,298 @@
+/**
+ * @architect
+ * @architect-implements ProceduralGuideCodec
+ * @architect-arch-context renderer
+ * @architect-arch-layer domain
+ *
+ * ## loadPreambleFromMarkdown — Shared Markdown-to-SectionBlock Parser
+ *
+ * Reads a markdown file via `readFileSync` and parses it into a
+ * `readonly SectionBlock[]` array using a line-by-line state machine.
+ *
+ * **Design Decision DD-8:** Preamble content is naturally authored as
+ * markdown. Converting to inline TypeScript `SectionBlock[]` literals
+ * is verbose. This shared parser eliminates 540+ lines of inline
+ * TypeScript per codec config while preserving the same shape.
+ *
+ * ### When to Use
+ *
+ * - In `architect.config.ts` to load preamble markdown files
+ * - At config import time (before any codec `decode()` call)
+ * - When any codec needs static SectionBlock[] from a `.md` file
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+// =============================================================================
+// Detection Helpers
+// =============================================================================
+const HEADING_REGEX = /^(#{1,6})\s+(.+)$/;
+const SEPARATOR_REGEX = /^(---+|\*\*\*+|___+)$/;
+const CODE_FENCE_OPEN_REGEX = /^```(.*)$/;
+const CODE_FENCE_CLOSE_REGEX = /^```\s*$/;
+const UNORDERED_LIST_REGEX = /^[-*]\s+(.*)$/;
+const ORDERED_LIST_REGEX = /^\d+\.\s+(.*)$/;
+const TABLE_SEPARATOR_REGEX = /^\|[\s:]*-+[\s:|-]*\|$/;
+/**
+ * Checks whether a line starts a table (line starts with `|` and the
+ * following line is a separator row like `|---|---|`).
+ */
+function isTableStart(line, nextLine) {
+    return line.startsWith('|') && nextLine !== undefined && TABLE_SEPARATOR_REGEX.test(nextLine);
+}
+/**
+ * Parses a table row into its cell values, trimming whitespace.
+ * Strips leading and trailing `|` characters.
+ */
+function parseTableRow(line) {
+    // Remove leading and trailing `|`, split by `|`, trim each cell
+    const stripped = line.replace(/^\|/, '').replace(/\|$/, '');
+    return stripped.split('|').map((cell) => cell.trim());
+}
+/**
+ * Checks whether a line is a list item (unordered or ordered).
+ */
+function isListItem(line) {
+    return UNORDERED_LIST_REGEX.test(line) || ORDERED_LIST_REGEX.test(line);
+}
+/**
+ * Extracts the text content from a list item line.
+ * For `- [ ] text`, returns `[ ] text` (preserves GFM checkbox).
+ */
+function extractListItemText(line) {
+    const unorderedMatch = UNORDERED_LIST_REGEX.exec(line);
+    if (unorderedMatch?.[1] !== undefined) {
+        return unorderedMatch[1];
+    }
+    const orderedMatch = ORDERED_LIST_REGEX.exec(line);
+    if (orderedMatch?.[1] !== undefined) {
+        return orderedMatch[1];
+    }
+    return line;
+}
+/**
+ * Checks whether a list item line is ordered (starts with `\d+. `).
+ */
+function isOrderedListItem(line) {
+    return ORDERED_LIST_REGEX.test(line);
+}
+// =============================================================================
+// Flush Helpers
+// =============================================================================
+function flushParagraph(paragraphLines) {
+    return { type: 'paragraph', text: paragraphLines.join(' ') };
+}
+function flushCodeFence(acc) {
+    const content = acc.lines.join('\n');
+    if (acc.language === 'mermaid') {
+        return { type: 'mermaid', content };
+    }
+    if (acc.language.length > 0) {
+        return { type: 'code', language: acc.language, content };
+    }
+    return { type: 'code', content };
+}
+function flushTable(acc) {
+    return { type: 'table', columns: acc.columns, rows: acc.rows };
+}
+function flushList(acc) {
+    return { type: 'list', ordered: acc.ordered, items: acc.items };
+}
+// =============================================================================
+// Core Parser
+// =============================================================================
+/**
+ * Parses a markdown string into a `readonly SectionBlock[]` array.
+ *
+ * Uses a 5-state line-by-line state machine:
+ * - `idle` — start state, entered after emitting a block
+ * - `in-code-fence` — inside ``` delimiters
+ * - `in-table` — accumulating table rows
+ * - `in-paragraph` — accumulating paragraph text
+ * - `in-list` — accumulating list items
+ *
+ * @param content - Raw markdown string to parse
+ * @returns Parsed SectionBlock array
+ */
+export function parseMarkdownToBlocks(content) {
+    const lines = content.split('\n');
+    const blocks = [];
+    let state = 'idle';
+    let paragraphLines = [];
+    let codeFence = { language: '', lines: [] };
+    let tableAcc = { columns: [], rows: [] };
+    let listAcc = { ordered: false, items: [] };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const nextLine = i + 1 < lines.length ? lines[i + 1] : undefined;
+        // -----------------------------------------------------------------
+        // State: in-code-fence — collect lines until closing ```
+        // -----------------------------------------------------------------
+        if (state === 'in-code-fence') {
+            if (CODE_FENCE_CLOSE_REGEX.test(line)) {
+                blocks.push(flushCodeFence(codeFence));
+                codeFence = { language: '', lines: [] };
+                state = 'idle';
+            }
+            else {
+                codeFence.lines.push(line);
+            }
+            continue;
+        }
+        // -----------------------------------------------------------------
+        // State: in-table — collect rows until line doesn't start with |
+        // -----------------------------------------------------------------
+        if (state === 'in-table') {
+            if (line.startsWith('|')) {
+                // Skip separator rows
+                if (!TABLE_SEPARATOR_REGEX.test(line)) {
+                    tableAcc.rows.push(parseTableRow(line));
+                }
+                continue;
+            }
+            // Line doesn't start with | — flush table
+            blocks.push(flushTable(tableAcc));
+            tableAcc = { columns: [], rows: [] };
+            state = 'idle';
+            // Fall through to process current line in idle
+        }
+        // -----------------------------------------------------------------
+        // State: in-list — collect items until line doesn't match list pattern
+        // -----------------------------------------------------------------
+        if (state === 'in-list') {
+            if (isListItem(line)) {
+                // Check for list type change (ordered vs unordered)
+                const currentOrdered = isOrderedListItem(line);
+                if (currentOrdered !== listAcc.ordered) {
+                    // Flush the current list and start a new one
+                    blocks.push(flushList(listAcc));
+                    listAcc = { ordered: currentOrdered, items: [extractListItemText(line)] };
+                }
+                else {
+                    listAcc.items.push(extractListItemText(line));
+                }
+                continue;
+            }
+            // Not a list item — flush list
+            blocks.push(flushList(listAcc));
+            listAcc = { ordered: false, items: [] };
+            state = 'idle';
+            // Fall through to process current line in idle
+        }
+        // -----------------------------------------------------------------
+        // State: in-paragraph — collect lines until blank line
+        // -----------------------------------------------------------------
+        if (state === 'in-paragraph') {
+            if (line.trim() === '') {
+                blocks.push(flushParagraph(paragraphLines));
+                paragraphLines = [];
+                state = 'idle';
+                continue;
+            }
+            // Check if this line starts a new construct (heading, code fence, etc.)
+            if (HEADING_REGEX.test(line) ||
+                SEPARATOR_REGEX.test(line) ||
+                CODE_FENCE_OPEN_REGEX.test(line) ||
+                isTableStart(line, nextLine) ||
+                isListItem(line)) {
+                // Flush paragraph first
+                blocks.push(flushParagraph(paragraphLines));
+                paragraphLines = [];
+                state = 'idle';
+                // Fall through to idle processing
+            }
+            else {
+                paragraphLines.push(line);
+                continue;
+            }
+        }
+        // -----------------------------------------------------------------
+        // State: idle — detect what the current line is
+        // -----------------------------------------------------------------
+        // Blank line — skip
+        if (line.trim() === '') {
+            continue;
+        }
+        // Code fence opening
+        const codeFenceMatch = CODE_FENCE_OPEN_REGEX.exec(line);
+        if (codeFenceMatch !== null && !CODE_FENCE_CLOSE_REGEX.test(line)) {
+            state = 'in-code-fence';
+            codeFence = { language: (codeFenceMatch[1] ?? '').trim(), lines: [] };
+            continue;
+        }
+        // Heading
+        const headingMatch = HEADING_REGEX.exec(line);
+        if (headingMatch?.[1] !== undefined && headingMatch[2] !== undefined) {
+            blocks.push({
+                type: 'heading',
+                level: headingMatch[1].length,
+                text: headingMatch[2],
+            });
+            continue;
+        }
+        // Separator
+        if (SEPARATOR_REGEX.test(line)) {
+            blocks.push({ type: 'separator' });
+            continue;
+        }
+        // Table start
+        if (isTableStart(line, nextLine)) {
+            state = 'in-table';
+            tableAcc = { columns: parseTableRow(line), rows: [] };
+            // Skip the separator row (next line)
+            i++;
+            continue;
+        }
+        // List item
+        if (isListItem(line)) {
+            state = 'in-list';
+            listAcc = { ordered: isOrderedListItem(line), items: [extractListItemText(line)] };
+            continue;
+        }
+        // Paragraph (default)
+        state = 'in-paragraph';
+        paragraphLines = [line];
+    }
+    // -----------------------------------------------------------------
+    // Flush any remaining state
+    // -----------------------------------------------------------------
+    if (state === 'in-code-fence') {
+        // Unterminated code fence — still emit what we have
+        blocks.push(flushCodeFence(codeFence));
+    }
+    else if (state === 'in-table') {
+        blocks.push(flushTable(tableAcc));
+    }
+    else if (state === 'in-list') {
+        blocks.push(flushList(listAcc));
+    }
+    else if (state === 'in-paragraph' && paragraphLines.length > 0) {
+        blocks.push(flushParagraph(paragraphLines));
+    }
+    return blocks;
+}
+// =============================================================================
+// File Loader
+// =============================================================================
+/**
+ * Reads a markdown file and parses it into a `readonly SectionBlock[]` array.
+ *
+ * Uses `readFileSync` (synchronous) — intended to run at config import time,
+ * not during codec decode. Resolves `filePath` relative to project root
+ * (`process.cwd()`).
+ *
+ * @param filePath - Path to markdown file, relative to project root
+ * @returns Parsed SectionBlock array suitable for ReferenceDocConfig.preamble
+ *
+ * @example
+ * ```typescript
+ * const preamble = loadPreambleFromMarkdown('docs-sources/session-workflow-guide.md');
+ * // Returns: readonly SectionBlock[] with HeadingBlock, ParagraphBlock,
+ * //          CodeBlock, MermaidBlock, TableBlock, ListBlock, SeparatorBlock
+ * ```
+ */
+export function loadPreambleFromMarkdown(filePath) {
+    const absolutePath = resolve(process.cwd(), filePath);
+    const content = readFileSync(absolutePath, 'utf-8');
+    return parseMarkdownToBlocks(content);
+}
+//# sourceMappingURL=load-preamble.js.map

package/dist/renderable/load-preamble.js.map

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

package/dist/renderable/render.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern UniversalRenderer
+ * @architect-status completed
+ * @architect-arch-role service
+ * @architect-arch-context renderer
+ * @architect-arch-layer application
+ *
+ * ## Universal Renderer
+ *
+ * Converts RenderableDocument to output strings. Three renderers:
+ * - `renderToMarkdown` — Full markdown for human documentation
+ * - `renderToClaudeMdModule` — Standard markdown with H3-rooted headings for modular-claude-md
+ *
+ * All are "dumb printers" — they know nothing about patterns, phases,
+ * or domain concepts. All logic lives in the codecs; these just render blocks.
+ *
+ * ### When to Use
+ *
+ * - `renderToMarkdown` for human-readable docs (`docs/` output)
+ * - `renderToClaudeMdModule` for AI context (`_claude-md/` output)
+ * - `renderDocumentWithFiles` for multi-file output with detail files
+ */
+import type { RenderableDocument } from './schema.js';
+/**
+ * Render a RenderableDocument to markdown string.
+ *
+ * @param doc - The document to render
+ * @returns Markdown string
+ */
+export declare function renderToMarkdown(doc: RenderableDocument): string;
+/**
+ * Render a RenderableDocument to a modular-claude-md compatible module.
+ *
+ * Uses standard markdown headings offset by +2 (H1→H3, H2→H4) so the
+ * output plugs directly into modular-claude-md's H3-rooted module system.
+ * Omits frontmatter, mermaid blocks, and link-out blocks. Flattens
+ * collapsible blocks into headings.
+ *
+ * @param doc - The document to render
+ * @returns Markdown string compatible with modular-claude-md
+ */
+export declare function renderToClaudeMdModule(doc: RenderableDocument): string;
+/**
+ * Output file descriptor
+ */
+export interface OutputFile {
+    path: string;
+    content: string;
+}
+/**
+ * Render a document and all its additional files.
+ *
+ * @param doc - The document to render
+ * @param basePath - Base path for the main document
+ * @param renderer - Render function to use (defaults to renderToMarkdown)
+ * @returns Array of output files
+ */
+export declare function renderDocumentWithFiles(doc: RenderableDocument, basePath: string, renderer?: (d: RenderableDocument) => string): OutputFile[];
+//# sourceMappingURL=render.d.ts.map

package/dist/renderable/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/renderable/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAMnB,MAAM,aAAa,CAAC;AAyBrB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAwBhE;AA2DD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAgBtE;AA+ND;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,MAAyB,GAC7D,UAAU,EAAE,CAoBd"}