@nahisaho/musubix-core 1.0.0

package/dist/codegen/unit-test-generator.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Unit Test Generator
+ *
+ * Generates unit tests from code and specifications
+ *
+ * @packageDocumentation
+ * @module codegen/unit-test-generator
+ *
+ * @see REQ-TST-001 - Unit Test Generation
+ * @see Article VII - Quality Assurance Standards
+ */
+/**
+ * Test framework type
+ */
+export type TestFramework = 'jest' | 'mocha' | 'vitest' | 'ava' | 'tap' | 'pytest' | 'unittest' | 'junit' | 'nunit' | 'xunit' | 'go-test';
+/**
+ * Test assertion style
+ */
+export type AssertionStyle = 'expect' | 'assert' | 'should' | 'chai';
+/**
+ * Test target type
+ */
+export type TestTargetType = 'function' | 'method' | 'class' | 'module' | 'component';
+/**
+ * Test case info
+ */
+export interface TestCaseInfo {
+    /** Test case name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Test type */
+    type: 'unit' | 'edge' | 'boundary' | 'error' | 'null';
+    /** Input values */
+    inputs: TestInput[];
+    /** Expected output */
+    expectedOutput: TestOutput;
+    /** Setup code */
+    setup?: string;
+    /** Teardown code */
+    teardown?: string;
+    /** Mocks required */
+    mocks?: TestMock[];
+    /** Tags */
+    tags?: string[];
+}
+/**
+ * Test input
+ */
+export interface TestInput {
+    /** Parameter name */
+    name: string;
+    /** Value */
+    value: unknown;
+    /** Type */
+    type: string;
+    /** Description */
+    description?: string;
+}
+/**
+ * Test output
+ */
+export interface TestOutput {
+    /** Expected value */
+    value?: unknown;
+    /** Expected type */
+    type?: string;
+    /** Expected error */
+    error?: {
+        type: string;
+        message?: string;
+    };
+    /** Custom assertion */
+    assertion?: string;
+}
+/**
+ * Test mock
+ */
+export interface TestMock {
+    /** Module or object to mock */
+    target: string;
+    /** Method to mock */
+    method?: string;
+    /** Return value */
+    returnValue?: unknown;
+    /** Implementation */
+    implementation?: string;
+    /** Is spy */
+    isSpy?: boolean;
+}
+/**
+ * Test suite info
+ */
+export interface TestSuiteInfo {
+    /** Suite name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Target file */
+    targetFile: string;
+    /** Test framework */
+    framework: TestFramework;
+    /** Test cases */
+    testCases: TestCaseInfo[];
+    /** Imports */
+    imports: string[];
+    /** Setup */
+    beforeAll?: string;
+    /** Teardown */
+    afterAll?: string;
+    /** Before each */
+    beforeEach?: string;
+    /** After each */
+    afterEach?: string;
+}
+/**
+ * Function to test
+ */
+export interface FunctionToTest {
+    /** Function name */
+    name: string;
+    /** Parameters */
+    parameters: Array<{
+        name: string;
+        type: string;
+        optional?: boolean;
+        defaultValue?: string;
+    }>;
+    /** Return type */
+    returnType: string;
+    /** Is async */
+    isAsync: boolean;
+    /** Is static */
+    isStatic?: boolean;
+    /** Class name (if method) */
+    className?: string;
+    /** JSDoc description */
+    description?: string;
+    /** Source code */
+    sourceCode?: string;
+}
+/**
+ * Generated test result
+ */
+export interface GeneratedTestResult {
+    /** Test file content */
+    content: string;
+    /** Test file path */
+    filePath: string;
+    /** Number of test cases */
+    testCount: number;
+    /** Coverage estimate */
+    coverageEstimate: {
+        statements: number;
+        branches: number;
+        functions: number;
+        lines: number;
+    };
+    /** Warnings */
+    warnings: string[];
+}
+/**
+ * Test generator configuration
+ */
+export interface UnitTestGeneratorConfig {
+    /** Test framework */
+    framework: TestFramework;
+    /** Assertion style */
+    assertionStyle: AssertionStyle;
+    /** Generate edge cases */
+    generateEdgeCases: boolean;
+    /** Generate error cases */
+    generateErrorCases: boolean;
+    /** Generate null/undefined cases */
+    generateNullCases: boolean;
+    /** Maximum test cases per function */
+    maxTestCasesPerFunction: number;
+    /** Include setup/teardown */
+    includeSetupTeardown: boolean;
+    /** Generate mocks */
+    generateMocks: boolean;
+    /** Test file suffix */
+    testFileSuffix: string;
+    /** Test directory */
+    testDirectory: string;
+    /** Verbose descriptions */
+    verboseDescriptions: boolean;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_TEST_GENERATOR_CONFIG: UnitTestGeneratorConfig;
+/**
+ * Unit Test Generator
+ */
+export declare class UnitTestGenerator {
+    private config;
+    private template;
+    constructor(config?: Partial<UnitTestGeneratorConfig>);
+    /**
+     * Generate tests for a function
+     */
+    generateForFunction(func: FunctionToTest, targetFile: string): GeneratedTestResult;
+    /**
+     * Generate tests for multiple functions
+     */
+    generateForModule(functions: FunctionToTest[], targetFile: string): GeneratedTestResult;
+    /**
+     * Generate test cases for a function
+     */
+    private generateTestCases;
+    /**
+     * Generate happy path test
+     */
+    private generateHappyPathTest;
+    /**
+     * Generate edge case tests
+     */
+    private generateEdgeCaseTests;
+    /**
+     * Generate error tests
+     */
+    private generateErrorTests;
+    /**
+     * Generate null/undefined tests
+     */
+    private generateNullTests;
+    /**
+     * Generate test file content
+     */
+    private generateTestFile;
+    /**
+     * Generate module test file
+     */
+    private generateModuleTestFile;
+    /**
+     * Generate describe block body
+     */
+    private generateDescribeBody;
+    /**
+     * Generate test body
+     */
+    private generateTestBody;
+    /**
+     * Generate test name from function
+     */
+    private generateTestName;
+    /**
+     * Generate sample value for type
+     */
+    private generateSampleValue;
+    /**
+     * Generate expected value for return type
+     */
+    private generateExpectedValue;
+    /**
+     * Generate invalid value for type
+     */
+    private generateInvalidValue;
+    /**
+     * Get edge values for type
+     */
+    private getEdgeValues;
+    /**
+     * Get test file path
+     */
+    private getTestFilePath;
+    /**
+     * Get import path
+     */
+    private getImportPath;
+    /**
+     * Estimate coverage
+     */
+    private estimateCoverage;
+    /**
+     * Estimate module coverage
+     */
+    private estimateModuleCoverage;
+    /**
+     * Generate warnings
+     */
+    private generateWarnings;
+}
+/**
+ * Create unit test generator instance
+ */
+export declare function createUnitTestGenerator(config?: Partial<UnitTestGeneratorConfig>): UnitTestGenerator;
+//# sourceMappingURL=unit-test-generator.d.ts.map

package/dist/codegen/unit-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-test-generator.d.ts","sourceRoot":"","sources":["../../src/codegen/unit-test-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1I;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD,mBAAmB;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,sBAAsB;IACtB,cAAc,EAAE,UAAU,CAAC;IAC3B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,iBAAiB;IACjB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,cAAc;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,gBAAgB,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,eAAe;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,sBAAsB;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,0BAA0B;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oCAAoC;IACpC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sCAAsC;IACtC,uBAAuB,EAAE,MAAM,CAAC;IAChC,6BAA6B;IAC7B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,uBAY3C,CAAC;AAuJF;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAA4C;gBAEhD,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAKrD;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB;IAgBlF;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,cAAc,EAAE,EAC3B,UAAU,EAAE,MAAM,GACjB,mBAAmB;IAsBtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqDxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiBzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,iBAAiB,CAEnB"}