@libar-dev/architect 1.0.0-pre.3

package/dist/extractor/layer-inference.js

@@ -0,0 +1,93 @@
+/**
+ * @architect
+ * @architect-extractor
+ * @architect-pattern LayerInference
+ * @architect-status completed
+ * @architect-used-by GherkinExtractor
+ *
+ * ## LayerInference - Directory-Based Feature Classification
+ *
+ * Infers feature file layer (timeline, domain, integration, e2e, component)
+ * from directory path patterns. Enables filtering without explicit annotations.
+ *
+ * ### When to Use
+ *
+ * - When filtering scenarios by testing layer
+ * - When generating layer-specific documentation
+ * - When calculating test coverage by layer
+ */
+/**
+ * All valid feature layers as a readonly array
+ *
+ * @remarks
+ * Useful for validation and schema definitions
+ */
+export const FEATURE_LAYERS = [
+    'timeline',
+    'domain',
+    'integration',
+    'e2e',
+    'component',
+    'unknown',
+];
+/**
+ * Infer feature layer from file path
+ *
+ * Uses directory structure patterns to classify feature files:
+ * - `/timeline/` → timeline (process documentation)
+ * - `/deciders/` → domain (pure domain logic)
+ * - `/orders/`, `/inventory/` (not integration) → domain
+ * - `/integration-features/`, `/integration/` → integration
+ * - `/e2e/` → e2e (browser-based tests)
+ * - `/scanner/`, `/lint/` → component (tooling tests)
+ *
+ * @param filePath - Absolute or relative path to feature file
+ * @returns Inferred layer based on directory patterns
+ *
+ * @example
+ * ```typescript
+ * inferFeatureLayer('tests/features/timeline/phase-01.feature');
+ * // Returns: 'timeline'
+ *
+ * inferFeatureLayer('tests/features/deciders/order.decider.feature');
+ * // Returns: 'domain'
+ *
+ * inferFeatureLayer('tests/integration-features/orders/flow.feature');
+ * // Returns: 'integration'
+ * ```
+ */
+export function inferFeatureLayer(filePath) {
+    // Normalize path for cross-platform consistency
+    const normalizedPath = filePath.toLowerCase().replace(/\\/g, '/');
+    // Timeline features (process documentation)
+    if (normalizedPath.includes('/timeline/')) {
+        return 'timeline';
+    }
+    // Decider features (pure domain logic)
+    if (normalizedPath.includes('/deciders/')) {
+        return 'domain';
+    }
+    // Domain features (command handlers, but not integration tests)
+    // Check for integration FIRST to avoid false positives
+    const isIntegration = normalizedPath.includes('/integration-features/') || normalizedPath.includes('/integration/');
+    if (!isIntegration) {
+        if (normalizedPath.includes('/orders/') || normalizedPath.includes('/inventory/')) {
+            return 'domain';
+        }
+    }
+    // Integration features
+    if (isIntegration) {
+        return 'integration';
+    }
+    // E2E features (browser-based tests)
+    if (normalizedPath.includes('/e2e/')) {
+        return 'e2e';
+    }
+    // Component features (tooling tests)
+    if (normalizedPath.includes('/scanner/') || normalizedPath.includes('/lint/')) {
+        return 'component';
+    }
+    // Unknown - fallback for unclassified features
+    return 'unknown';
+}
+//# sourceMappingURL=layer-inference.js.map

package/dist/extractor/layer-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-inference.js","sourceRoot":"","sources":["../../src/extractor/layer-inference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgBH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,UAAU;IACV,QAAQ;IACR,aAAa;IACb,KAAK;IACL,WAAW;IACX,SAAS;CACD,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,gDAAgD;IAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAElE,4CAA4C;IAC5C,IAAI,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,uCAAuC;IACvC,IAAI,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gEAAgE;IAChE,uDAAuD;IACvD,MAAM,aAAa,GACjB,cAAc,CAAC,QAAQ,CAAC,wBAAwB,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEhG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAClF,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,qCAAqC;IACrC,IAAI,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qCAAqC;IACrC,IAAI,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9E,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/extractor/shape-extractor.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @architect
+ * @architect-pattern ShapeExtractor
+ * @architect-status completed
+ * @architect-phase 26
+ * @architect-implements ShapeExtraction
+ * @architect-uses typescript-estree
+ *
+ * ## Shape Extractor - TypeScript Type Extraction
+ *
+ * Extracts TypeScript type definitions (interfaces, type aliases, enums,
+ * function signatures) from source files for documentation generation.
+ *
+ * ### When to Use
+ *
+ * - When processing @architect-extract-shapes tags during extraction
+ * - When generating documentation that needs actual type definitions
+ * - When eliminating duplication between JSDoc examples and code
+ *
+ * ### Key Concepts
+ *
+ * - **AST-based extraction**: Uses typescript-estree for accurate parsing
+ * - **Preserves formatting**: Extracts exact source text, not regenerated
+ * - **Includes JSDoc**: Type-level JSDoc comments are preserved
+ * - **Order from tag**: Shapes appear in tag-specified order, not source order
+ */
+import { Result } from '../types/result.js';
+import type { ExtractedShape, ShapeExtractionOptionsInput, ShapeExtractionResult } from '../validation-schemas/extracted-shape.js';
+/**
+ * Extract named shapes from TypeScript source code.
+ *
+ * @param sourceCode - The TypeScript source code to parse
+ * @param shapeNames - Names of shapes to extract (in desired output order)
+ * @param options - Extraction options
+ * @returns Result containing extraction result with shapes, warnings, and not-found list
+ */
+export declare function extractShapes(sourceCode: string, shapeNames: string[], options?: ShapeExtractionOptionsInput): Result<ShapeExtractionResult>;
+/**
+ * Result of processing extract-shapes tag.
+ */
+export interface ProcessExtractShapesResult {
+    /** Successfully extracted shapes in tag order */
+    shapes: ExtractedShape[];
+    /** Warnings generated during extraction */
+    warnings: string[];
+}
+/**
+ * Process extract-shapes tag and return shapes for ExtractedPattern.
+ *
+ * Called by the document extractor when processing TypeScript files
+ * with @architect-extract-shapes tags.
+ *
+ * DD-4: Supports wildcard `*` for auto-discovery mode.
+ *
+ * @param sourceCode - File content
+ * @param extractShapesTag - Comma-separated shape names from tag, or `*` for auto-discovery
+ * @returns Result with extracted shapes and any warnings
+ */
+export declare function processExtractShapesTag(sourceCode: string, extractShapesTag: string, options?: {
+    readonly jsx?: boolean;
+}): ProcessExtractShapesResult;
+/**
+ * Discover declarations tagged with @architect-shape in source code.
+ *
+ * Scans all top-level declarations (exported and non-exported per DD-7)
+ * for @architect-shape tags in their preceding JSDoc. Tagged declarations
+ * are extracted as shapes with an optional group from the tag value (DD-5).
+ *
+ * Reuses existing infrastructure: findDeclarations(), extractPrecedingJsDoc(),
+ * and extractShape() — no parser changes needed (DD-2).
+ *
+ * @param sourceCode - TypeScript source code to scan
+ * @param options - Parse options (jsx should match file extension)
+ * @returns Result containing discovered shapes and warnings
+ */
+export declare function discoverTaggedShapes(sourceCode: string, options?: {
+    readonly jsx?: boolean;
+}): Result<ProcessExtractShapesResult>;
+//# sourceMappingURL=shape-extractor.d.ts.map

package/dist/extractor/shape-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-extractor.d.ts","sourceRoot":"","sources":["../../src/extractor/shape-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EACV,cAAc,EAKd,2BAA2B,EAC3B,qBAAqB,EAGtB,MAAM,0CAA0C,CAAC;AA8DlD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAAC,qBAAqB,CAAC,CAkE/B;AA6uBD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAyDD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,0BAA0B,CAqE5B;AA8CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,MAAM,CAAC,0BAA0B,CAAC,CAsDpC"}