@eddacraft/anvil-adapters 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,9 @@
+/**
+ * Base Adapter Framework
+ *
+ * Core types, interfaces, and registry for format adapters.
+ */
+export * from './types.js';
+export * from './registry.js';
+export * from './utils.js';
+export * from './file-discovery.js';

package/dist/base/registry.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Adapter Registry
+ *
+ * Central registry for format adapters with auto-detection and lookup capabilities.
+ */
+import type { FormatAdapter, DetectionResult, PathDetectionHint } from './types.js';
+/**
+ * Registry for managing format adapters
+ *
+ * Provides:
+ * - Adapter registration and lookup
+ * - Auto-detection of formats from content
+ * - Extension-based adapter selection
+ */
+export declare class AdapterRegistry {
+    private static instance;
+    private adapters;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): AdapterRegistry;
+    /**
+     * Reset singleton instance (useful for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Register an adapter
+     *
+     * @param adapter - Adapter to register
+     * @throws Error if adapter with same name already registered
+     */
+    register(adapter: FormatAdapter): void;
+    /**
+     * Unregister an adapter by name
+     *
+     * @param name - Name of adapter to unregister
+     * @returns True if adapter was removed, false if not found
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get adapter by name
+     *
+     * @param name - Adapter name
+     * @returns Adapter instance or undefined
+     */
+    getAdapter(name: string): FormatAdapter | undefined;
+    /**
+     * Get adapter for a specific format identifier or extension
+     *
+     * @param format - Format identifier (e.g., "speckit") or extension (e.g., ".md")
+     * @returns First matching adapter or undefined
+     */
+    getAdapterForFormat(format: string): FormatAdapter | undefined;
+    /**
+     * Detect adapter from content
+     *
+     * Runs detection on all registered adapters and returns the best match.
+     *
+     * @param content - Content to analyze
+     * @param minConfidence - Minimum confidence score (0-100) to accept
+     * @returns Best matching adapter and detection result, or undefined
+     */
+    detectAdapter(content: string, minConfidence?: number): {
+        adapter: FormatAdapter;
+        detection: DetectionResult;
+    } | undefined;
+    /**
+     * Detect adapter from content with path hints
+     *
+     * Like detectAdapter but passes file path information to adapters
+     * that implement detectWithPath for improved accuracy.
+     *
+     * @param content - Content to analyze
+     * @param hint - File path and directory information
+     * @param minConfidence - Minimum confidence score (0-100) to accept
+     * @returns Best matching adapter and detection result, or undefined
+     */
+    detectAdapterWithPath(content: string, hint: PathDetectionHint, minConfidence?: number): {
+        adapter: FormatAdapter;
+        detection: DetectionResult;
+    } | undefined;
+    /**
+     * Get all detection results for content
+     *
+     * Useful for debugging or showing user multiple format possibilities.
+     *
+     * @param content - Content to analyze
+     * @returns Array of detection results for all adapters, sorted by confidence
+     */
+    detectAll(content: string): Array<{
+        adapter: FormatAdapter;
+        detection: DetectionResult;
+    }>;
+    /**
+     * List all registered adapters
+     *
+     * @returns Array of all adapters
+     */
+    listAdapters(): ReadonlyArray<FormatAdapter>;
+    /**
+     * List all adapter names
+     *
+     * @returns Array of adapter names
+     */
+    listAdapterNames(): ReadonlyArray<string>;
+    /**
+     * List all supported formats across all adapters
+     *
+     * @returns Array of unique format identifiers
+     */
+    listSupportedFormats(): ReadonlyArray<string>;
+    /**
+     * List all supported extensions across all adapters
+     *
+     * @returns Array of unique file extensions
+     */
+    listSupportedExtensions(): ReadonlyArray<string>;
+    /**
+     * Get adapters that can import a specific format
+     *
+     * @param format - Format identifier or extension
+     * @returns Array of adapters that support this format for import
+     */
+    getImportAdapters(format: string): ReadonlyArray<FormatAdapter>;
+    /**
+     * Get adapters that can export to a specific format
+     *
+     * @param format - Format identifier or extension
+     * @returns Array of adapters that support this format for export
+     */
+    getExportAdapters(format: string): ReadonlyArray<FormatAdapter>;
+    /**
+     * Check if any adapter supports a format
+     *
+     * @param format - Format identifier or extension
+     * @returns True if at least one adapter supports this format
+     */
+    isFormatSupported(format: string): boolean;
+    /**
+     * Clear all registered adapters
+     *
+     * Mainly useful for testing.
+     */
+    clear(): void;
+    /**
+     * Get number of registered adapters
+     */
+    get size(): number;
+}
+/**
+ * Default singleton instance
+ */
+export declare const registry: AdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/base/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/base/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpF;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAyC;IAEzD,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,eAAe;IAOrC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAOtC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAInD;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAS9D;;;;;;;;OAQG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAW,GACzB;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,GAAG,SAAS;IAerE;;;;;;;;;;OAUG;IACH,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,EACvB,aAAa,GAAE,MAAW,GACzB;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,GAAG,SAAS;IAkBrE;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,CAAC;IASzF;;;;OAIG;IACH,YAAY,IAAI,aAAa,CAAC,aAAa,CAAC;IAI5C;;;;OAIG;IACH,gBAAgB,IAAI,aAAa,CAAC,MAAM,CAAC;IAIzC;;;;OAIG;IACH,oBAAoB,IAAI,aAAa,CAAC,MAAM,CAAC;IAU7C;;;;OAIG;IACH,uBAAuB,IAAI,aAAa,CAAC,MAAM,CAAC;IAUhD;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,aAAa,CAAC;IAI/D;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,aAAa,CAAC;IAI/D;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,iBAAgC,CAAC"}

package/dist/base/registry.js

@@ -0,0 +1,227 @@
+/**
+ * Adapter Registry
+ *
+ * Central registry for format adapters with auto-detection and lookup capabilities.
+ */
+/**
+ * Registry for managing format adapters
+ *
+ * Provides:
+ * - Adapter registration and lookup
+ * - Auto-detection of formats from content
+ * - Extension-based adapter selection
+ */
+export class AdapterRegistry {
+    static instance = null;
+    adapters = new Map();
+    constructor() { }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!AdapterRegistry.instance) {
+            AdapterRegistry.instance = new AdapterRegistry();
+        }
+        return AdapterRegistry.instance;
+    }
+    /**
+     * Reset singleton instance (useful for testing)
+     */
+    static resetInstance() {
+        AdapterRegistry.instance = null;
+    }
+    /**
+     * Register an adapter
+     *
+     * @param adapter - Adapter to register
+     * @throws Error if adapter with same name already registered
+     */
+    register(adapter) {
+        if (this.adapters.has(adapter.metadata.name)) {
+            throw new Error(`Adapter '${adapter.metadata.name}' is already registered`);
+        }
+        this.adapters.set(adapter.metadata.name, adapter);
+    }
+    /**
+     * Unregister an adapter by name
+     *
+     * @param name - Name of adapter to unregister
+     * @returns True if adapter was removed, false if not found
+     */
+    unregister(name) {
+        return this.adapters.delete(name);
+    }
+    /**
+     * Get adapter by name
+     *
+     * @param name - Adapter name
+     * @returns Adapter instance or undefined
+     */
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    /**
+     * Get adapter for a specific format identifier or extension
+     *
+     * @param format - Format identifier (e.g., "speckit") or extension (e.g., ".md")
+     * @returns First matching adapter or undefined
+     */
+    getAdapterForFormat(format) {
+        for (const adapter of this.adapters.values()) {
+            if (adapter.canImport(format)) {
+                return adapter;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Detect adapter from content
+     *
+     * Runs detection on all registered adapters and returns the best match.
+     *
+     * @param content - Content to analyze
+     * @param minConfidence - Minimum confidence score (0-100) to accept
+     * @returns Best matching adapter and detection result, or undefined
+     */
+    detectAdapter(content, minConfidence = 50) {
+        let bestMatch;
+        let bestConfidence = minConfidence - 1;
+        for (const adapter of this.adapters.values()) {
+            const detection = adapter.detect(content);
+            if (detection.detected && detection.confidence > bestConfidence) {
+                bestConfidence = detection.confidence;
+                bestMatch = { adapter, detection };
+            }
+        }
+        return bestMatch;
+    }
+    /**
+     * Detect adapter from content with path hints
+     *
+     * Like detectAdapter but passes file path information to adapters
+     * that implement detectWithPath for improved accuracy.
+     *
+     * @param content - Content to analyze
+     * @param hint - File path and directory information
+     * @param minConfidence - Minimum confidence score (0-100) to accept
+     * @returns Best matching adapter and detection result, or undefined
+     */
+    detectAdapterWithPath(content, hint, minConfidence = 50) {
+        let bestMatch;
+        let bestConfidence = minConfidence - 1;
+        for (const adapter of this.adapters.values()) {
+            const detection = adapter.detectWithPath
+                ? adapter.detectWithPath(content, hint)
+                : adapter.detect(content);
+            if (detection.detected && detection.confidence > bestConfidence) {
+                bestConfidence = detection.confidence;
+                bestMatch = { adapter, detection };
+            }
+        }
+        return bestMatch;
+    }
+    /**
+     * Get all detection results for content
+     *
+     * Useful for debugging or showing user multiple format possibilities.
+     *
+     * @param content - Content to analyze
+     * @returns Array of detection results for all adapters, sorted by confidence
+     */
+    detectAll(content) {
+        const results = Array.from(this.adapters.values()).map((adapter) => ({
+            adapter,
+            detection: adapter.detect(content),
+        }));
+        return results.sort((a, b) => b.detection.confidence - a.detection.confidence);
+    }
+    /**
+     * List all registered adapters
+     *
+     * @returns Array of all adapters
+     */
+    listAdapters() {
+        return Array.from(this.adapters.values());
+    }
+    /**
+     * List all adapter names
+     *
+     * @returns Array of adapter names
+     */
+    listAdapterNames() {
+        return Array.from(this.adapters.keys());
+    }
+    /**
+     * List all supported formats across all adapters
+     *
+     * @returns Array of unique format identifiers
+     */
+    listSupportedFormats() {
+        const formats = new Set();
+        for (const adapter of this.adapters.values()) {
+            for (const format of adapter.metadata.formats) {
+                formats.add(format);
+            }
+        }
+        return Array.from(formats).sort();
+    }
+    /**
+     * List all supported extensions across all adapters
+     *
+     * @returns Array of unique file extensions
+     */
+    listSupportedExtensions() {
+        const extensions = new Set();
+        for (const adapter of this.adapters.values()) {
+            for (const ext of adapter.metadata.extensions) {
+                extensions.add(ext);
+            }
+        }
+        return Array.from(extensions).sort();
+    }
+    /**
+     * Get adapters that can import a specific format
+     *
+     * @param format - Format identifier or extension
+     * @returns Array of adapters that support this format for import
+     */
+    getImportAdapters(format) {
+        return Array.from(this.adapters.values()).filter((adapter) => adapter.canImport(format));
+    }
+    /**
+     * Get adapters that can export to a specific format
+     *
+     * @param format - Format identifier or extension
+     * @returns Array of adapters that support this format for export
+     */
+    getExportAdapters(format) {
+        return Array.from(this.adapters.values()).filter((adapter) => adapter.canExport(format));
+    }
+    /**
+     * Check if any adapter supports a format
+     *
+     * @param format - Format identifier or extension
+     * @returns True if at least one adapter supports this format
+     */
+    isFormatSupported(format) {
+        return this.getAdapterForFormat(format) !== undefined;
+    }
+    /**
+     * Clear all registered adapters
+     *
+     * Mainly useful for testing.
+     */
+    clear() {
+        this.adapters.clear();
+    }
+    /**
+     * Get number of registered adapters
+     */
+    get size() {
+        return this.adapters.size;
+    }
+}
+/**
+ * Default singleton instance
+ */
+export const registry = AdapterRegistry.getInstance();

package/dist/base/testing.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Adapter Testing Utilities
+ *
+ * Helpers for testing format adapters with common patterns and assertions.
+ */
+import type { FormatAdapter, ParseResult, SerializeResult, DetectionResult, ParseContext, AdapterOptions } from './types.js';
+import type { APSPlan } from '@eddacraft/anvil-core';
+/**
+ * Test fixture for adapter testing
+ */
+export interface AdapterTestFixture {
+    /** Name of the test case */
+    name: string;
+    /** Raw content in external format */
+    content: string;
+    /** Expected detection result (optional) */
+    expectedDetection?: Partial<DetectionResult>;
+    /** Expected parse success (optional) */
+    expectParseSuccess?: boolean;
+    /** Context for parsing */
+    parseContext?: ParseContext;
+    /** Options for operations */
+    options?: AdapterOptions;
+    /** Expected values in parsed plan (optional) */
+    expectedPlan?: Partial<APSPlan>;
+    /** Expected error codes (if parse should fail) */
+    expectedErrors?: string[];
+    /** Expected warning codes */
+    expectedWarnings?: string[];
+}
+/**
+ * Test helper for adapter detection
+ */
+export declare class AdapterTester {
+    private adapter;
+    constructor(adapter: FormatAdapter);
+    /**
+     * Test detection with a fixture
+     */
+    testDetection(fixture: AdapterTestFixture): DetectionResult;
+    /**
+     * Test parsing with a fixture
+     */
+    testParse(fixture: AdapterTestFixture): Promise<ParseResult>;
+    /**
+     * Test serialization
+     */
+    testSerialize(plan: APSPlan, options?: AdapterOptions): Promise<SerializeResult>;
+    /**
+     * Test round-trip: parse then serialize then parse again
+     */
+    testRoundTrip(fixture: AdapterTestFixture): Promise<{
+        firstParse: ParseResult;
+        serialized: SerializeResult;
+        secondParse: ParseResult;
+        planMatches: boolean;
+    }>;
+    /**
+     * Assert that parsed plan matches expected values
+     */
+    private assertPlanMatches;
+    /**
+     * Compare two plans for equality (ignoring hash and timestamps)
+     */
+    private plansEqual;
+}
+/**
+ * Create a test adapter tester
+ */
+export declare function createTester(adapter: FormatAdapter): AdapterTester;
+/**
+ * Create a basic parse context for testing
+ */
+export declare function createTestContext(overrides?: Partial<ParseContext>): ParseContext;
+/**
+ * Create basic adapter options for testing
+ */
+export declare function createTestOptions(overrides?: Partial<AdapterOptions>): AdapterOptions;
+/**
+ * Assert detection result
+ */
+export declare function assertDetection(result: DetectionResult, expected: {
+    detected: boolean;
+    minConfidence?: number;
+}): void;
+/**
+ * Assert parse success
+ */
+export declare function assertParseSuccess(result: ParseResult): asserts result is ParseResult & {
+    data: APSPlan;
+};
+/**
+ * Assert parse failure
+ */
+export declare function assertParseFailure(result: ParseResult, expectedErrorCode?: string): void;
+/**
+ * Assert serialize success
+ */
+export declare function assertSerializeSuccess(result: SerializeResult): asserts result is SerializeResult & {
+    content: string;
+};
+//# sourceMappingURL=testing.d.ts.map

package/dist/base/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/base/testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,wCAAwC;IACxC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE1C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,eAAe;IAwB3D;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAgDlE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAItF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QACxD,UAAU,EAAE,WAAW,CAAC;QACxB,UAAU,EAAE,eAAe,CAAC;QAC5B,WAAW,EAAE,WAAW,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;IAyCF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,UAAU;CAmBnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAElE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CASjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAOrF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,IAAI,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAUnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAaxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,IAAI,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAUzD"}