@libar-dev/architect 1.0.0-pre.3

package/dist/renderable/generate.js

@@ -0,0 +1,437 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern DocumentGenerator
+ * @architect-status completed
+ * @architect-arch-role service
+ * @architect-arch-context renderer
+ * @architect-arch-layer application
+ *
+ * ## Document Generation
+ *
+ * Simplified document generation using codecs.
+ * Replaces the complex BuiltInGenerator + SectionRegistry pattern.
+ *
+ * ### When to Use
+ *
+ * - When generating specific document types from MasterDataset
+ * - When needing high-level generation API without direct codec usage
+ * - When building custom documentation workflows
+ *
+ * Flow: MasterDataset → Codec → RenderableDocument → Renderer → Markdown
+ */
+import { renderDocumentWithFiles, renderToClaudeMdModule } from './render.js';
+import { Result } from '../types/result.js';
+// Default codec instances
+import { PatternsDocumentCodec, RoadmapDocumentCodec, CompletedMilestonesCodec, CurrentWorkCodec, RequirementsDocumentCodec, SessionContextCodec, RemainingWorkCodec, PrChangesCodec, AdrDocumentCodec, PlanningChecklistCodec, SessionPlanCodec, SessionFindingsCodec, ChangelogCodec, TraceabilityCodec, OverviewCodec, BusinessRulesCodec, ArchitectureDocumentCodec, TaxonomyDocumentCodec, ValidationRulesCodec, ClaudeModuleCodec, IndexCodec, } from './codecs/index.js';
+// Factory functions for creating codecs with options
+import { createPatternsCodec, createRoadmapCodec, createMilestonesCodec, createCurrentWorkCodec, createRequirementsCodec, createSessionContextCodec, createRemainingWorkCodec, createPrChangesCodec, createAdrCodec, createPlanningChecklistCodec, createSessionPlanCodec, createSessionFindingsCodec, createChangelogCodec, createTraceabilityCodec, createOverviewCodec, createBusinessRulesCodec, createArchitectureCodec, createTaxonomyCodec, createValidationRulesCodec, createClaudeModuleCodec, createIndexCodec, } from './codecs/index.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Document Types
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Available document types and their output paths
+ */
+export const DOCUMENT_TYPES = {
+    patterns: {
+        outputPath: 'PATTERNS.md',
+        description: 'Pattern registry with category details',
+    },
+    roadmap: {
+        outputPath: 'ROADMAP.md',
+        description: 'Development roadmap by phase',
+    },
+    milestones: {
+        outputPath: 'COMPLETED-MILESTONES.md',
+        description: 'Historical completed milestones',
+    },
+    current: {
+        outputPath: 'CURRENT-WORK.md',
+        description: 'Active development work in progress',
+    },
+    requirements: {
+        outputPath: 'PRODUCT-REQUIREMENTS.md',
+        description: 'Product requirements by area/role',
+    },
+    session: {
+        outputPath: 'SESSION-CONTEXT.md',
+        description: 'Current session context and focus',
+    },
+    remaining: {
+        outputPath: 'REMAINING-WORK.md',
+        description: 'Aggregate view of incomplete work',
+    },
+    'pr-changes': {
+        outputPath: 'working/PR-CHANGES.md',
+        description: 'PR-scoped changes for review',
+    },
+    adrs: {
+        outputPath: 'DECISIONS.md',
+        description: 'Architecture Decision Records',
+    },
+    'planning-checklist': {
+        outputPath: 'PLANNING-CHECKLIST.md',
+        description: 'Pre-planning questions and Definition of Done',
+    },
+    'session-plan': {
+        outputPath: 'SESSION-PLAN.md',
+        description: 'Implementation plans for phases',
+    },
+    'session-findings': {
+        outputPath: 'SESSION-FINDINGS.md',
+        description: 'Retrospective discoveries for roadmap refinement',
+    },
+    changelog: {
+        outputPath: 'CHANGELOG-GENERATED.md',
+        description: 'Keep a Changelog format changelog',
+    },
+    traceability: {
+        outputPath: 'TRACEABILITY.md',
+        description: 'Timeline to behavior file coverage',
+    },
+    overview: {
+        outputPath: 'OVERVIEW.md',
+        description: 'Project architecture overview',
+    },
+    'business-rules': {
+        outputPath: 'BUSINESS-RULES.md',
+        description: 'Business rules and invariants by domain',
+    },
+    architecture: {
+        outputPath: 'ARCHITECTURE.md',
+        description: 'Architecture diagrams (component and layered views)',
+    },
+    taxonomy: {
+        outputPath: 'TAXONOMY.md',
+        description: 'Tag taxonomy configuration reference',
+    },
+    'validation-rules': {
+        outputPath: 'VALIDATION-RULES.md',
+        description: 'Process Guard validation rules reference',
+    },
+    'claude-modules': {
+        outputPath: 'CLAUDE-MODULES.md',
+        description: 'CLAUDE.md modules generated from annotated behavior specs',
+    },
+    index: {
+        outputPath: 'INDEX.md',
+        description: 'Navigation hub with editorial preamble and MasterDataset statistics',
+    },
+};
+/**
+ * Per-document-type renderer overrides.
+ * Document types not listed here use the default `renderToMarkdown`.
+ */
+const DOCUMENT_TYPE_RENDERERS = {
+    'claude-modules': renderToClaudeMdModule,
+};
+// Private storage for the CodecRegistry
+const _codecStore = new Map();
+const _factoryStore = new Map();
+/**
+ * Registry for document codecs providing a single source of truth.
+ *
+ * The CodecRegistry centralizes codec and factory registration, eliminating
+ * the need to manually synchronize CODEC_MAP and CODEC_FACTORY_MAP.
+ *
+ * @example
+ * ```typescript
+ * // Register a codec and its factory
+ * CodecRegistry.register('patterns', PatternsDocumentCodec);
+ * CodecRegistry.registerFactory('patterns', createPatternsCodec);
+ *
+ * // Retrieve codec or factory
+ * const codec = CodecRegistry.get('patterns');
+ * const factory = CodecRegistry.getFactory('patterns');
+ * ```
+ */
+export const CodecRegistry = {
+    /**
+     * Register a default codec for a document type.
+     *
+     * @param type - The document type to register
+     * @param codec - The codec instance to use
+     */
+    register(type, codec) {
+        _codecStore.set(type, codec);
+    },
+    /**
+     * Register a factory function for a document type.
+     *
+     * Factory functions are used when codec options are provided,
+     * allowing customization of codec behavior at runtime.
+     *
+     * @param type - The document type to register
+     * @param factory - The factory function to create codecs with options
+     */
+    registerFactory(type, factory) {
+        _factoryStore.set(type, factory);
+    },
+    /**
+     * Get the default codec for a document type.
+     *
+     * @param type - The document type to retrieve
+     * @returns The codec instance, or undefined if not registered
+     */
+    get(type) {
+        return _codecStore.get(type);
+    },
+    /**
+     * Get the factory function for a document type.
+     *
+     * @param type - The document type to retrieve
+     * @returns The factory function, or undefined if not registered
+     */
+    getFactory(type) {
+        return _factoryStore.get(type);
+    },
+    /**
+     * Check if a codec is registered for a document type.
+     *
+     * @param type - The document type to check
+     * @returns True if a codec is registered
+     */
+    has(type) {
+        return _codecStore.has(type);
+    },
+    /**
+     * Check if a factory is registered for a document type.
+     *
+     * @param type - The document type to check
+     * @returns True if a factory is registered
+     */
+    hasFactory(type) {
+        return _factoryStore.has(type);
+    },
+    /**
+     * Get all registered document types.
+     *
+     * @returns Array of registered document types
+     */
+    getRegisteredTypes() {
+        return Array.from(_codecStore.keys());
+    },
+    /**
+     * Clear all registrations (useful for testing).
+     */
+    clear() {
+        _codecStore.clear();
+        _factoryStore.clear();
+    },
+};
+// ═══════════════════════════════════════════════════════════════════════════
+// Registry Initialization
+// ═══════════════════════════════════════════════════════════════════════════
+// Register all default codecs
+CodecRegistry.register('patterns', PatternsDocumentCodec);
+CodecRegistry.register('roadmap', RoadmapDocumentCodec);
+CodecRegistry.register('milestones', CompletedMilestonesCodec);
+CodecRegistry.register('current', CurrentWorkCodec);
+CodecRegistry.register('requirements', RequirementsDocumentCodec);
+CodecRegistry.register('session', SessionContextCodec);
+CodecRegistry.register('remaining', RemainingWorkCodec);
+CodecRegistry.register('pr-changes', PrChangesCodec);
+CodecRegistry.register('adrs', AdrDocumentCodec);
+CodecRegistry.register('planning-checklist', PlanningChecklistCodec);
+CodecRegistry.register('session-plan', SessionPlanCodec);
+CodecRegistry.register('session-findings', SessionFindingsCodec);
+CodecRegistry.register('changelog', ChangelogCodec);
+CodecRegistry.register('traceability', TraceabilityCodec);
+CodecRegistry.register('overview', OverviewCodec);
+CodecRegistry.register('business-rules', BusinessRulesCodec);
+CodecRegistry.register('architecture', ArchitectureDocumentCodec);
+CodecRegistry.register('taxonomy', TaxonomyDocumentCodec);
+CodecRegistry.register('validation-rules', ValidationRulesCodec);
+CodecRegistry.register('claude-modules', ClaudeModuleCodec);
+CodecRegistry.register('index', IndexCodec);
+// Register all factory functions (used when codec options are provided)
+CodecRegistry.registerFactory('patterns', createPatternsCodec);
+CodecRegistry.registerFactory('roadmap', createRoadmapCodec);
+CodecRegistry.registerFactory('milestones', createMilestonesCodec);
+CodecRegistry.registerFactory('current', createCurrentWorkCodec);
+CodecRegistry.registerFactory('requirements', createRequirementsCodec);
+CodecRegistry.registerFactory('session', createSessionContextCodec);
+CodecRegistry.registerFactory('remaining', createRemainingWorkCodec);
+CodecRegistry.registerFactory('pr-changes', createPrChangesCodec);
+CodecRegistry.registerFactory('adrs', createAdrCodec);
+CodecRegistry.registerFactory('planning-checklist', createPlanningChecklistCodec);
+CodecRegistry.registerFactory('session-plan', createSessionPlanCodec);
+CodecRegistry.registerFactory('session-findings', createSessionFindingsCodec);
+CodecRegistry.registerFactory('changelog', createChangelogCodec);
+CodecRegistry.registerFactory('traceability', createTraceabilityCodec);
+CodecRegistry.registerFactory('overview', createOverviewCodec);
+CodecRegistry.registerFactory('business-rules', createBusinessRulesCodec);
+CodecRegistry.registerFactory('architecture', createArchitectureCodec);
+CodecRegistry.registerFactory('taxonomy', createTaxonomyCodec);
+CodecRegistry.registerFactory('validation-rules', createValidationRulesCodec);
+CodecRegistry.registerFactory('claude-modules', createClaudeModuleCodec);
+CodecRegistry.registerFactory('index', createIndexCodec);
+// ═══════════════════════════════════════════════════════════════════════════
+// Codec Resolution
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Resolve the codec for a document type, using a factory if options are provided.
+ */
+function resolveCodec(type, options) {
+    const typeOptions = options?.[type];
+    if (typeOptions !== undefined) {
+        const factory = CodecRegistry.getFactory(type);
+        if (factory !== undefined) {
+            return factory(typeOptions);
+        }
+    }
+    return CodecRegistry.get(type);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Generation Functions
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Generate a single document type with Result-based error handling.
+ *
+ * This function wraps codec.decode() and renderDocumentWithFiles() in try/catch,
+ * returning a Result type instead of throwing exceptions. Use this when you need
+ * explicit error handling without try/catch at the call site.
+ *
+ * @param type - Document type to generate
+ * @param dataset - MasterDataset with pattern data
+ * @param options - Optional codec-specific options
+ * @returns Result containing OutputFile[] on success, or GenerationError on failure
+ *
+ * @example
+ * ```typescript
+ * const result = generateDocumentSafe("patterns", masterDataset);
+ * if (Result.isOk(result)) {
+ *   for (const file of result.value) {
+ *     fs.writeFileSync(file.path, file.content);
+ *   }
+ * } else {
+ *   console.error(`Failed to generate ${result.error.documentType}: ${result.error.message}`);
+ * }
+ * ```
+ */
+export function generateDocumentSafe(type, dataset, options) {
+    const outputPath = DOCUMENT_TYPES[type].outputPath;
+    const codec = resolveCodec(type, options);
+    if (codec === undefined) {
+        return Result.err({
+            documentType: type,
+            message: `No codec registered for document type: ${type}`,
+            phase: 'decode',
+        });
+    }
+    // Decode: MasterDataset → RenderableDocument (with error handling)
+    let doc;
+    try {
+        doc = codec.decode(dataset);
+    }
+    catch (err) {
+        return Result.err({
+            documentType: type,
+            message: err instanceof Error ? err.message : String(err),
+            cause: err instanceof Error ? err : undefined,
+            phase: 'decode',
+        });
+    }
+    // Render: RenderableDocument → OutputFile[] (with error handling)
+    try {
+        const renderer = DOCUMENT_TYPE_RENDERERS[type];
+        const files = renderDocumentWithFiles(doc, outputPath, renderer);
+        return Result.ok(files);
+    }
+    catch (err) {
+        return Result.err({
+            documentType: type,
+            message: err instanceof Error ? err.message : String(err),
+            cause: err instanceof Error ? err : undefined,
+            phase: 'render',
+        });
+    }
+}
+/**
+ * Generate a single document type
+ *
+ * @param type - Document type to generate
+ * @param dataset - MasterDataset with pattern data
+ * @param options - Optional codec-specific options (e.g., changedFiles for PR changes)
+ * @returns Array of output files (main + additional for progressive disclosure)
+ *
+ * When options are provided for the requested document type, the factory function
+ * is used to create a codec with custom configuration. Otherwise, the default
+ * codec instance is used.
+ *
+ * **Error Handling:** This function may throw if codec.decode() or rendering fails.
+ * For explicit error handling without exceptions, use `generateDocumentSafe()` which
+ * returns a Result type instead.
+ *
+ * @example
+ * ```typescript
+ * // Without options (uses default codec)
+ * const files = generateDocument("patterns", masterDataset);
+ *
+ * // With options (uses factory function)
+ * const files = generateDocument("pr-changes", masterDataset, {
+ *   "pr-changes": { changedFiles: ["src/foo.ts"], releaseFilter: "v0.2.0" }
+ * });
+ * ```
+ */
+export function generateDocument(type, dataset, options) {
+    const outputPath = DOCUMENT_TYPES[type].outputPath;
+    const codec = resolveCodec(type, options);
+    if (codec === undefined) {
+        throw new Error(`No codec registered for document type: ${type}`);
+    }
+    // Decode: MasterDataset → RenderableDocument
+    const doc = codec.decode(dataset);
+    // Render: RenderableDocument → OutputFile[]
+    const renderer = DOCUMENT_TYPE_RENDERERS[type];
+    return renderDocumentWithFiles(doc, outputPath, renderer);
+}
+/**
+ * Generate multiple document types
+ *
+ * @param types - Document types to generate
+ * @param dataset - MasterDataset with pattern data
+ * @param options - Optional codec-specific options
+ * @returns Array of all output files
+ */
+export function generateDocuments(types, dataset, options) {
+    const allFiles = [];
+    for (const type of types) {
+        const files = generateDocument(type, dataset, options);
+        allFiles.push(...files);
+    }
+    return allFiles;
+}
+/**
+ * Generate all document types
+ *
+ * @param dataset - MasterDataset with pattern data
+ * @param options - Optional codec-specific options
+ * @returns Array of all output files
+ */
+export function generateAllDocuments(dataset, options) {
+    const types = Object.keys(DOCUMENT_TYPES);
+    return generateDocuments(types, dataset, options);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Utility Functions
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Get available document types
+ */
+export function getAvailableDocumentTypes() {
+    return Object.keys(DOCUMENT_TYPES);
+}
+/**
+ * Check if a string is a valid document type
+ */
+export function isValidDocumentType(type) {
+    return type in DOCUMENT_TYPES;
+}
+/**
+ * Get document type info
+ */
+export function getDocumentTypeInfo(type) {
+    return DOCUMENT_TYPES[type];
+}
+//# sourceMappingURL=generate.js.map

package/dist/renderable/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/renderable/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAmB,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,0BAA0B;AAC1B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,qDAAqD;AACrD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AA8B3B,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE;QACR,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE,wCAAwC;KACtD;IACD,OAAO,EAAE;QACP,UAAU,EAAE,YAAY;QACxB,WAAW,EAAE,8BAA8B;KAC5C;IACD,UAAU,EAAE;QACV,UAAU,EAAE,yBAAyB;QACrC,WAAW,EAAE,iCAAiC;KAC/C;IACD,OAAO,EAAE;QACP,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,qCAAqC;KACnD;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,yBAAyB;QACrC,WAAW,EAAE,mCAAmC;KACjD;IACD,OAAO,EAAE;QACP,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,mCAAmC;KACjD;IACD,SAAS,EAAE;QACT,UAAU,EAAE,mBAAmB;QAC/B,WAAW,EAAE,mCAAmC;KACjD;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,8BAA8B;KAC5C;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,cAAc;QAC1B,WAAW,EAAE,+BAA+B;KAC7C;IACD,oBAAoB,EAAE;QACpB,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,+CAA+C;KAC7D;IACD,cAAc,EAAE;QACd,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,iCAAiC;KAC/C;IACD,kBAAkB,EAAE;QAClB,UAAU,EAAE,qBAAqB;QACjC,WAAW,EAAE,kDAAkD;KAChE;IACD,SAAS,EAAE;QACT,UAAU,EAAE,wBAAwB;QACpC,WAAW,EAAE,mCAAmC;KACjD;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,oCAAoC;KAClD;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE,+BAA+B;KAC7C;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,mBAAmB;QAC/B,WAAW,EAAE,yCAAyC;KACvD;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,qDAAqD;KACnE;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE,sCAAsC;KACpD;IACD,kBAAkB,EAAE;QAClB,UAAU,EAAE,qBAAqB;QACjC,WAAW,EAAE,0CAA0C;KACxD;IACD,gBAAgB,EAAE;QAChB,UAAU,EAAE,mBAAmB;QAC/B,WAAW,EAAE,2DAA2D;KACzE;IACD,KAAK,EAAE;QACL,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,qEAAqE;KACnF;CACO,CAAC;AAIX;;;GAGG;AACH,MAAM,uBAAuB,GAC3B;IACE,gBAAgB,EAAE,sBAAsB;CACzC,CAAC;AAwDJ,wCAAwC;AACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;AAC3D,MAAM,aAAa,GAAG,IAAI,GAAG,EAA8B,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,IAAkB,EAAE,KAAoB;QAC/C,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAkB,EAAE,OAAqB;QACvD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAkB;QACpB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAkB;QAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAkB;QACpB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAkB;QAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,WAAW,CAAC,KAAK,EAAE,CAAC;QACpB,aAAa,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACO,CAAC;AAEX,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,8BAA8B;AAC9B,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAC1D,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACxD,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;AAC/D,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AACpD,aAAa,CAAC,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC;AAClE,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AACvD,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;AACxD,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AACrD,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AACjD,aAAa,CAAC,QAAQ,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AACrE,aAAa,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;AACzD,aAAa,CAAC,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AACjE,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACpD,aAAa,CAAC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;AAC1D,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAClD,aAAa,CAAC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAC7D,aAAa,CAAC,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC;AAClE,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAC1D,aAAa,CAAC,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AACjE,aAAa,CAAC,QAAQ,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAC5D,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAE5C,wEAAwE;AACxE,aAAa,CAAC,eAAe,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC/D,aAAa,CAAC,eAAe,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAC7D,aAAa,CAAC,eAAe,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;AACnE,aAAa,CAAC,eAAe,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AACjE,aAAa,CAAC,eAAe,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;AACvE,aAAa,CAAC,eAAe,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AACpE,aAAa,CAAC,eAAe,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC;AACrE,aAAa,CAAC,eAAe,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;AAClE,aAAa,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACtD,aAAa,CAAC,eAAe,CAAC,oBAAoB,EAAE,4BAA4B,CAAC,CAAC;AAClF,aAAa,CAAC,eAAe,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;AACtE,aAAa,CAAC,eAAe,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAC;AAC9E,aAAa,CAAC,eAAe,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;AACjE,aAAa,CAAC,eAAe,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;AACvE,aAAa,CAAC,eAAe,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC/D,aAAa,CAAC,eAAe,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;AAC1E,aAAa,CAAC,eAAe,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;AACvE,aAAa,CAAC,eAAe,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC/D,aAAa,CAAC,eAAe,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAC;AAC9E,aAAa,CAAC,eAAe,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;AACzE,aAAa,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAuBzD,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,SAAS,YAAY,CAAC,IAAkB,EAAE,OAAsB;IAC9D,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAkB,EAClB,OAAsB,EACtB,OAAsB;IAEtB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;IAEnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,GAAG,CAAC;YAChB,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,0CAA0C,IAAI,EAAE;YACzD,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,IAAI,GAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAuB,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,GAAG,CAAC;YAChB,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YAC7C,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,GAAG,CAAC;YAChB,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YAC7C,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,OAAsB,EACtB,OAAsB;IAEtB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;IAEnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,6CAA6C;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAuB,CAAC;IAExD,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,uBAAuB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,OAAsB,EACtB,OAAsB;IAEtB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAsB,EAAE,OAAsB;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAmB,CAAC;IAC5D,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAmB,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,IAAI,cAAc,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IAIpD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/renderable/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern RenderableDocumentModel(RDM)
+ * @architect-status completed
+ *
+ * ## Renderable Document Model (RDM)
+ *
+ * Unified document generation using codecs and a universal renderer.
+ *
+ * ### When to Use
+ *
+ * - When importing RDM types, schemas, or block builders
+ * - When using codecs for document transformation
+ * - When rendering RenderableDocuments to markdown
+ *
+ * Architecture:
+ * ```
+ * MasterDataset → Document Codecs → RenderableDocument → Universal Renderer → Markdown
+ * ```
+ *
+ * Key Exports:
+ * - Schema: `RenderableDocument`, `SectionBlock`, block builders
+ * - Codecs: `PatternsDocumentCodec`, `TimelineCodec`, etc.
+ * - Renderer: `renderToMarkdown`, `renderDocumentWithFiles`
+ * - Generation: `generateDocument`, `generateAllDocuments`
+ */
+export { RenderableDocumentSchema, HeadingBlockSchema, ParagraphBlockSchema, SeparatorBlockSchema, TableBlockSchema, ListBlockSchema, CodeBlockSchema, MermaidBlockSchema, CollapsibleBlockSchema, LinkOutBlockSchema, SectionBlockSchema, type RenderableDocument, type HeadingBlock, type ParagraphBlock, type SeparatorBlock, type TableBlock, type ListBlock, type CodeBlock, type MermaidBlock, type CollapsibleBlock, type LinkOutBlock, type SectionBlock, type ListItem, heading, paragraph, separator, table, list, code, mermaid, collapsible, linkOut, document, } from './schema.js';
+export { renderToMarkdown, renderToClaudeMdModule, renderDocumentWithFiles, type OutputFile, } from './render.js';
+export { PatternsDocumentCodec, RoadmapDocumentCodec, CompletedMilestonesCodec, RequirementsDocumentCodec, SessionContextCodec, RemainingWorkCodec, } from './codecs/index.js';
+export { generateDocument, generateDocuments, generateAllDocuments, getAvailableDocumentTypes, isValidDocumentType, getDocumentTypeInfo, DOCUMENT_TYPES, type DocumentType, } from './generate.js';
+export { normalizeStatus } from '../taxonomy/index.js';
+export { getStatusEmoji, getDisplayName, formatCategoryName, extractSummary, computeStatusCounts, completionPercentage, renderProgressBar, sortByPhaseAndName, sortByStatusAndName, formatBusinessValue, } from './utils.js';
+export { groupBy } from '../utils/index.js';
+export { loadPreambleFromMarkdown, parseMarkdownToBlocks } from './load-preamble.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderable/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,EAEL,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAElB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EAEb,OAAO,EACP,SAAS,EACT,SAAS,EACT,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,WAAW,EACX,OAAO,EACP,QAAQ,GACT,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM5C,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/renderable/index.js

@@ -0,0 +1,58 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern RenderableDocumentModel(RDM)
+ * @architect-status completed
+ *
+ * ## Renderable Document Model (RDM)
+ *
+ * Unified document generation using codecs and a universal renderer.
+ *
+ * ### When to Use
+ *
+ * - When importing RDM types, schemas, or block builders
+ * - When using codecs for document transformation
+ * - When rendering RenderableDocuments to markdown
+ *
+ * Architecture:
+ * ```
+ * MasterDataset → Document Codecs → RenderableDocument → Universal Renderer → Markdown
+ * ```
+ *
+ * Key Exports:
+ * - Schema: `RenderableDocument`, `SectionBlock`, block builders
+ * - Codecs: `PatternsDocumentCodec`, `TimelineCodec`, etc.
+ * - Renderer: `renderToMarkdown`, `renderDocumentWithFiles`
+ * - Generation: `generateDocument`, `generateAllDocuments`
+ */
+// ═══════════════════════════════════════════════════════════════════════════
+// Schema Exports
+// ═══════════════════════════════════════════════════════════════════════════
+export { 
+// Schemas
+RenderableDocumentSchema, HeadingBlockSchema, ParagraphBlockSchema, SeparatorBlockSchema, TableBlockSchema, ListBlockSchema, CodeBlockSchema, MermaidBlockSchema, CollapsibleBlockSchema, LinkOutBlockSchema, SectionBlockSchema, 
+// Builders
+heading, paragraph, separator, table, list, code, mermaid, collapsible, linkOut, document, } from './schema.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Renderer Exports
+// ═══════════════════════════════════════════════════════════════════════════
+export { renderToMarkdown, renderToClaudeMdModule, renderDocumentWithFiles, } from './render.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Codec Exports
+// ═══════════════════════════════════════════════════════════════════════════
+export { PatternsDocumentCodec, RoadmapDocumentCodec, CompletedMilestonesCodec, RequirementsDocumentCodec, SessionContextCodec, RemainingWorkCodec, } from './codecs/index.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Generation Exports
+// ═══════════════════════════════════════════════════════════════════════════
+export { generateDocument, generateDocuments, generateAllDocuments, getAvailableDocumentTypes, isValidDocumentType, getDocumentTypeInfo, DOCUMENT_TYPES, } from './generate.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Utility Exports
+// ═══════════════════════════════════════════════════════════════════════════
+export { normalizeStatus } from '../taxonomy/index.js';
+export { getStatusEmoji, getDisplayName, formatCategoryName, extractSummary, computeStatusCounts, completionPercentage, renderProgressBar, sortByPhaseAndName, sortByStatusAndName, formatBusinessValue, } from './utils.js';
+export { groupBy } from '../utils/index.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Preamble Loader
+// ═══════════════════════════════════════════════════════════════════════════
+export { loadPreambleFromMarkdown, parseMarkdownToBlocks } from './load-preamble.js';
+//# sourceMappingURL=index.js.map

package/dist/renderable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/renderable/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,OAAO;AACL,UAAU;AACV,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB;AAclB,WAAW;AACX,OAAO,EACP,SAAS,EACT,SAAS,EACT,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,WAAW,EACX,OAAO,EACP,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/renderable/load-preamble.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @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 type { SectionBlock } from './schema.js';
+/**
+ * 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 declare function parseMarkdownToBlocks(content: string): readonly SectionBlock[];
+/**
+ * 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 declare function loadPreambleFromMarkdown(filePath: string): readonly SectionBlock[];
+//# sourceMappingURL=load-preamble.d.ts.map

package/dist/renderable/load-preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-preamble.d.ts","sourceRoot":"","sources":["../../src/renderable/load-preamble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkHhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAwK9E;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAIlF"}