@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.4

package/dist/generators/source-mapper.d.ts

@@ -1,143 +0,0 @@
-/**
- * @architect
- * @architect-core
- * @architect-pattern SourceMapper
- * @architect-status completed
- * @architect-arch-role infrastructure
- * @architect-arch-context generator
- * @architect-arch-layer infrastructure
- * @architect-depends-on DecisionDocCodec,ShapeExtractor,GherkinASTParser
- *
- * ## Source Mapper - Multi-Source Content Aggregation
- *
- * Aggregates content from multiple source files based on source mapping tables
- * parsed from decision documents. Dispatches extraction to appropriate handlers
- * based on extraction method (shape extraction, rule blocks, JSDoc, etc.).
- *
- * ### When to Use
- *
- * - When generating documentation from a decision document's source mapping
- * - When aggregating content from TypeScript, Gherkin, and decision sources
- * - When building docs with progressive disclosure (compact vs detailed)
- *
- * ### Key Concepts
- *
- * - **Source Mapping Table**: Defines sections, source files, and extraction methods
- * - **Self-Reference**: `THIS DECISION` markers extract from current document
- * - **Graceful Degradation**: Missing files produce warnings, not failures
- * - **Order Preservation**: Aggregated content maintains mapping table order
- */
-import type { Result } from '../types/result.js';
-import { type SourceMappingEntry, type DecisionDocContent, type ExtractedDocString } from '../renderable/codecs/decision-doc.js';
-import type { ExtractedShape } from '../validation-schemas/extracted-shape.js';
-import type { WarningCollector } from './warning-collector.js';
-import type { FileCache } from '../cache/file-cache.js';
-/**
- * Options for source mapping execution
- */
-export interface SourceMapperOptions {
-    /** Base directory for resolving relative paths */
-    baseDir: string;
-    /** Current decision document path (for self-references) */
-    decisionDocPath: string;
-    /** Parsed decision document content (for self-reference extraction) */
-    decisionContent: DecisionDocContent;
-    /** Detail level affects what content is included */
-    detailLevel?: 'summary' | 'standard' | 'detailed';
-    /** Optional warning collector for structured warning handling */
-    warningCollector?: WarningCollector;
-    /** Optional file cache for avoiding repeated disk reads */
-    fileCache?: FileCache;
-}
-/**
- * Warning produced during extraction
- */
-export interface ExtractionWarning {
-    /** Warning severity */
-    severity: 'warning' | 'info';
-    /** Warning message */
-    message: string;
-    /** Source mapping entry that produced the warning */
-    sourceMapping: SourceMappingEntry;
-}
-/**
- * Single extracted section from a source
- */
-export interface ExtractedSection {
-    /** Target section name from mapping */
-    section: string;
-    /** Source file path or self-reference marker */
-    sourceFile: string;
-    /** Extraction method used */
-    extractionMethod: string;
-    /** Extracted content (markdown) */
-    content: string;
-    /** Extracted shapes (if applicable) */
-    shapes?: ExtractedShape[];
-    /** Extracted DocStrings (if applicable) */
-    docStrings?: ExtractedDocString[];
-}
-/**
- * Result of source mapping execution
- */
-export interface AggregatedContent {
-    /** Extracted sections in mapping order */
-    sections: ExtractedSection[];
-    /** Warnings produced during extraction */
-    warnings: ExtractionWarning[];
-    /** Overall success (true if at least one section extracted) */
-    success: boolean;
-}
-/**
- * Extract content from THIS DECISION (the current decision document)
- */
-export declare function extractFromDecision(options: SourceMapperOptions, sourceMapping: SourceMappingEntry): Result<ExtractedSection>;
-/**
- * Extract shapes from a TypeScript file using @extract-shapes
- */
-export declare function extractFromTypeScript(filePath: string, options: SourceMapperOptions, sourceMapping: SourceMappingEntry): Promise<Result<ExtractedSection>>;
-/**
- * Extract Rule blocks or Scenario Outline Examples from a behavior spec
- */
-export declare function extractFromBehaviorSpec(filePath: string, options: SourceMapperOptions, sourceMapping: SourceMappingEntry): Promise<Result<ExtractedSection>>;
-/**
- * Execute source mapping to aggregate content from multiple sources
- *
- * Takes source mapping entries from a decision document and extracts content
- * from each referenced source file. Handles self-references (THIS DECISION),
- * TypeScript files (@extract-shapes, JSDoc), and behavior specs (Rule blocks,
- * Scenario Outline Examples).
- *
- * @param sourceMappings - Source mapping entries from decision document
- * @param options - Mapper options including base directory and decision content
- * @returns Aggregated content with sections in mapping order
- *
- * @example
- * ```typescript
- * const result = await executeSourceMapping(decisionContent.sourceMappings, {
- *   baseDir: process.cwd(),
- *   decisionDocPath: 'specs/my-decision.feature',
- *   decisionContent: decisionContent,
- *   detailLevel: 'detailed',
- * });
- *
- * if (result.success) {
- *   for (const section of result.sections) {
- *     console.log(`## ${section.section}\n${section.content}`);
- *   }
- * }
- * ```
- */
-export declare function executeSourceMapping(sourceMappings: readonly SourceMappingEntry[], options: SourceMapperOptions): Promise<AggregatedContent>;
-/**
- * Validate source mappings before execution
- *
- * Checks all referenced files exist and extraction methods are valid.
- * Does not perform actual extraction.
- *
- * @param sourceMappings - Source mapping entries to validate
- * @param options - Mapper options (only baseDir is required)
- * @returns Array of validation warnings
- */
-export declare function validateSourceMappings(sourceMappings: readonly SourceMappingEntry[], options: Pick<SourceMapperOptions, 'baseDir'>): Promise<ExtractionWarning[]>;
-//# sourceMappingURL=source-mapper.d.ts.map

package/dist/generators/source-mapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"source-mapper.d.ts","sourceRoot":"","sources":["../../src/generators/source-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAOxB,MAAM,sCAAsC,CAAC;AAI9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAG/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMxD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAEhB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IAExB,uEAAuE;IACvE,eAAe,EAAE,kBAAkB,CAAC;IAEpC,oDAAoD;IACpD,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAElD,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAE7B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAE1B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAE7B,0CAA0C;IAC1C,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAE9B,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;CAClB;AA0FD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,kBAAkB,GAChC,MAAM,CAAC,gBAAgB,CAAC,CAuE1B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAoJnC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAsCnC;AAmHD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,SAAS,kBAAkB,EAAE,EAC7C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAwE5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,SAAS,kBAAkB,EAAE,EAC7C,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAC5C,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyC9B"}