adorn-api 1.0.13 → 1.0.15

package/dist/compiler/analyze/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Analyze module exports
+ */
+export { scanControllers, type ScannedController, type ScannedOperation, type ScannedParameter } from './scanControllers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compiler/analyze/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/analyze/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC"}

package/dist/compiler/analyze/scanControllers.d.ts

@@ -1,36 +1,88 @@
+/**
+ * Scans TypeScript source files for controller classes decorated with @Controller and extracts their operations.
+ * This module provides the foundation for API compilation by identifying all HTTP endpoints defined in the codebase.
+ */
 import ts from "typescript";
+/**
+ * Represents a scanned controller class with its metadata and operations.
+ * Contains information about the controller class, base path, and all HTTP operations it defines.
+ */
 export interface ScannedController {
+    /** The name of the controller class */
     className: string;
+    /** The base path prefix for all operations in this controller */
     basePath: string;
+    /** The TypeScript source file containing this controller */
     sourceFile: ts.SourceFile;
+    /** The class declaration node from the TypeScript AST */
     classDeclaration: ts.ClassDeclaration;
+    /** Array of scanned operations (endpoints) in this controller */
     operations: ScannedOperation[];
+    /** Optional list of content types this controller consumes */
     consumes?: string[];
+    /** Optional list of content types this controller produces */
     produces?: string[];
 }
+/**
+ * Represents a scanned HTTP operation (endpoint) within a controller.
+ * Contains all metadata needed to generate API documentation and client code.
+ */
 export interface ScannedOperation {
+    /** The name of the method implementing this operation */
     methodName: string;
+    /** The HTTP method (GET, POST, PUT, PATCH, DELETE) */
     httpMethod: string;
+    /** The URL path for this operation, relative to controller base path */
     path: string;
+    /** Unique identifier for this operation, used in OpenAPI specs and client generation */
     operationId: string;
+    /** The method declaration node from the TypeScript AST */
     methodDeclaration: ts.MethodDeclaration;
+    /** The TypeScript return type of this operation */
     returnType: ts.Type;
+    /** Optional TypeScript type node for the return type */
     returnTypeNode?: ts.TypeNode;
+    /** Array of scanned parameters for this operation */
     parameters: ScannedParameter[];
+    /** Indices of parameters that are path parameters */
     pathParamIndices: number[];
+    /** Index of the parameter that is the request body, or null if none */
     bodyParamIndex: number | null;
+    /** Indices of parameters that are query parameters */
     queryParamIndices: number[];
+    /** Index of the parameter that is a query object (all query params as properties), or null if none */
     queryObjectParamIndex: number | null;
+    /** Index of the parameter that is a headers object, or null if none */
     headerObjectParamIndex: number | null;
+    /** Index of the parameter that is a cookies object, or null if none */
     cookieObjectParamIndex: number | null;
+    /** The content type of the request body, if applicable */
     bodyContentType?: string;
 }
+/**
+ * Represents a scanned parameter of an operation.
+ * Contains metadata about the parameter's name, type, and position.
+ */
 export interface ScannedParameter {
+    /** The name of the parameter */
     name: string;
+    /** The zero-based index of the parameter in the function signature */
     index: number;
+    /** The TypeScript type of this parameter */
     type: ts.Type;
+    /** Whether this parameter is optional */
     isOptional: boolean;
+    /** Optional parameter declaration node from the TypeScript AST */
     paramNode?: ts.ParameterDeclaration;
 }
+/**
+ * Scans an array of TypeScript source files for controller classes and extracts their operations.
+ * Only classes decorated with @Controller are considered, and only methods with HTTP method decorators
+ * (e.g., @Get, @Post) are treated as operations.
+ *
+ * @param sourceFiles - Array of TypeScript source files to scan
+ * @param checker - TypeScript type checker for analyzing types
+ * @returns Array of scanned controllers with their operations
+ */
 export declare function scanControllers(sourceFiles: ts.SourceFile[], checker: ts.TypeChecker): ScannedController[];
 //# sourceMappingURL=scanControllers.d.ts.map

package/dist/compiler/analyze/scanControllers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanControllers.d.ts","sourceRoot":"","sources":["../../../src/compiler/analyze/scanControllers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC;IACtC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAAC;IACxC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC;IAC7B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC;CACrC;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,EAAE,CAAC,UAAU,EAAE,EAC5B,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,iBAAiB,EAAE,CAerB"}
+{"version":3,"file":"scanControllers.d.ts","sourceRoot":"","sources":["../../../src/compiler/analyze/scanControllers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,yDAAyD;IACzD,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC;IACtC,iEAAiE;IACjE,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAAC;IACxC,mDAAmD;IACnD,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC;IAC7B,qDAAqD;IACrD,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,uEAAuE;IACvE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,sGAAsG;IACtG,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,uEAAuE;IACvE,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,uEAAuE;IACvE,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACd,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,EAAE,CAAC,UAAU,EAAE,EAC5B,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,iBAAiB,EAAE,CAerB"}

package/dist/compiler/cache/isStale.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Result of a cache staleness check.
+ * - stale: false means cache is valid and artifacts can be used as-is
+ * - stale: true means cache is invalid and artifacts need to be regenerated
+ */
 export type StaleResult = {
     stale: false;
     reason: "up-to-date";
@@ -6,11 +11,32 @@ export type StaleResult = {
     reason: string;
     detail?: string;
 };
+/**
+ * Collects all TypeScript config files in the inheritance chain.
+ * Follows the "extends" property recursively to build a complete list of config files.
+ *
+ * @param tsconfigPathAbs - Absolute path to the root tsconfig.json
+ * @returns Array of absolute paths to all config files in the chain, in order from root to leaf
+ */
 export declare function collectTsconfigChain(tsconfigPathAbs: string): string[];
+/**
+ * Searches for a package lockfile (pnpm-lock.yaml, package-lock.json, or yarn.lock)
+ * starting from the given directory and moving up the directory tree.
+ *
+ * @param startDir - The directory to start searching from
+ * @returns Object with path and modification time of the found lockfile, or null if not found
+ */
 export declare function findLockfile(startDir: string): {
     path: string;
     mtimeMs: number;
 } | null;
+/**
+ * Determines whether the compiled artifacts are stale and need to be regenerated.
+ * Checks the manifest, cache file, TypeScript config files, lockfile, and input files.
+ *
+ * @param params - Object containing outDir, project path, adorn version, and TypeScript version
+ * @returns Promise resolving to a StaleResult indicating whether regeneration is needed
+ */
 export declare function isStale(params: {
     outDir: string;
     project: string;

package/dist/compiler/cache/isStale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isStale.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/isStale.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GACnB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAsBrD,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCtE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAevF;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,CA+CvB"}
+{"version":3,"file":"isStale.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/isStale.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAsBrD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCtE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAevF;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,CA+CvB"}

package/dist/compiler/cache/loadArtifacts.d.ts

@@ -1,3 +1,6 @@
+/**
+ * OpenAPI specification interface as loaded from openapi.json
+ */
 interface OpenApi {
     openapi: string;
     components?: {
@@ -7,6 +10,10 @@ interface OpenApi {
     info?: Record<string, unknown>;
     security?: Array<Record<string, string[]>>;
 }
+/**
+ * Manifest interface describing the compiled API structure.
+ * Contains metadata about the generation process and all controllers/operations.
+ */
 interface Manifest {
     manifestVersion: number;
     generatedAt: string;
@@ -81,6 +88,9 @@ interface Manifest {
         }>;
     }>;
 }
+/**
+ * Validator module interface for precompiled validation logic.
+ */
 interface ValidatorModule {
     validators: Record<string, {
         body?: (data: unknown) => boolean;
@@ -95,16 +105,42 @@ interface ValidatorModule {
         errors: unknown[] | null;
     };
 }
+/**
+ * Options for loading artifacts from the output directory.
+ */
 export interface LoadArtifactsOptions {
     outDir: string;
 }
+/**
+ * Result of loading artifacts from the output directory.
+ */
 export interface LoadedArtifacts {
     openapi: OpenApi;
     manifest: Manifest;
     validators: ValidatorModule | null;
 }
+/**
+ * Loads OpenAPI spec, manifest, and validators from the output directory.
+ * Results are cached in memory to avoid repeated file I/O.
+ *
+ * @param options - Object containing the output directory path
+ * @returns Promise resolving to loaded artifacts including OpenAPI spec, manifest, and validators
+ */
 export declare function loadArtifacts(options: LoadArtifactsOptions): Promise<LoadedArtifacts>;
+/**
+ * Clears the in-memory artifact cache.
+ * If an output directory is specified, only that entry is removed.
+ * Otherwise, the entire cache is cleared.
+ *
+ * @param outDir - Optional specific output directory to clear from cache
+ */
 export declare function clearArtifactCache(outDir?: string): void;
+/**
+ * Returns statistics about the current artifact cache state.
+ * Useful for debugging and monitoring cache behavior.
+ *
+ * @returns Object containing cache size and array of cached keys
+ */
 export declare function getArtifactCacheStats(): {
     size: number;
     keys: string[];

package/dist/compiler/cache/loadArtifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadArtifacts.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/loadArtifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loadArtifacts.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/loadArtifacts.ts"],"names":[],"mappings":"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"}

package/dist/compiler/cache/schema.d.ts

@@ -1,18 +1,32 @@
+/**
+ * Cache schema definition for version 1 of the adorn-api cache format.
+ * Stores information about the compilation environment and input files for cache invalidation.
+ */
 export interface AdornCacheV1 {
+    /** Cache format version, always 1 */
     cacheVersion: 1;
+    /** Information about the generator that created this cache */
     generator: {
+        /** Generator name, always "adorn-api" */
         name: "adorn-api";
+        /** Version of the adorn-api package */
         version: string;
+        /** Version of TypeScript used during compilation */
         typescript: string;
     };
+    /** Information about the TypeScript project configuration */
     project: {
+        /** Absolute path to the TypeScript config file */
         tsconfigPath: string;
+        /** Map of config file paths to their modification times */
         configFiles: Record<string, number>;
+        /** Optional package lockfile information for dependency change detection */
         lockfile?: {
             path: string;
             mtimeMs: number;
         } | null;
     };
+    /** Map of input file paths to their modification times */
     inputs: Record<string, number>;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/compiler/cache/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,CAAC,CAAC;IAChB,SAAS,EAAE;QACT,IAAI,EAAE,WAAW,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KACrD,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,YAAY,EAAE,CAAC,CAAC;IAChB,8DAA8D;IAC9D,SAAS,EAAE;QACT,yCAAyC;QACzC,IAAI,EAAE,WAAW,CAAC;QAClB,uCAAuC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,oDAAoD;QACpD,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,6DAA6D;IAC7D,OAAO,EAAE;QACP,kDAAkD;QAClD,YAAY,EAAE,MAAM,CAAC;QACrB,2DAA2D;QAC3D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,4EAA4E;QAC5E,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KACrD,CAAC;IACF,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}

package/dist/compiler/cache/writeCache.d.ts

@@ -1,4 +1,10 @@
 import ts from "typescript";
+/**
+ * Writes cache information to the output directory.
+ * Captures the current state of the compilation environment for future staleness checks.
+ *
+ * @param params - Object containing output directory, tsconfig path, TypeScript program, and adorn version
+ */
 export declare function writeCache(params: {
     outDir: string;
     tsconfigAbs: string;

package/dist/compiler/cache/writeCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeCache.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/writeCache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,YAAY,CAAC;AAkB5B,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAqCP"}
+{"version":3,"file":"writeCache.d.ts","sourceRoot":"","sources":["../../../src/compiler/cache/writeCache.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,YAAY,CAAC;AAkB5B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAqCP"}

package/dist/compiler/gems.d.ts

@@ -0,0 +1,75 @@
+import { SchemaGraph } from "./graph/schemaGraph.js";
+import type { Graph } from "./graph/types.js";
+/**
+ * GEMS Compiler configuration
+ */
+export interface GEMSConfig {
+    tsconfigPath: string;
+    deduplicate: boolean;
+    inline: boolean;
+    flatten: boolean;
+    verbose: boolean;
+    generateOpenAPI: boolean;
+    generateManifest: boolean;
+    outputPath?: string;
+}
+/**
+ * GEMS Compiler result
+ */
+export interface GEMSResult {
+    graph: Graph;
+    schemaGraph: SchemaGraph;
+    openapi?: any;
+    manifest?: any;
+    stages: string[];
+    duration: number;
+    statistics: {
+        totalNodes: number;
+        totalEdges: number;
+        cyclesDetected: number;
+        stronglyConnectedComponents: number;
+        duplicatesRemoved: number;
+        nodesInlined: number;
+        nodesFlattened: number;
+    };
+}
+/**
+ * Create default GEMS compiler configuration
+ */
+export declare function createGEMSConfig(tsconfigPath: string, partial?: Partial<GEMSConfig>): GEMSConfig;
+/**
+ * Compile TypeScript sources using GEMS compiler
+ */
+export declare function compileWithGEMS(config: GEMSConfig): Promise<GEMSResult>;
+/**
+ * Quick compile with default configuration
+ */
+export declare function quickCompile(tsconfigPath: string): Promise<GEMSResult>;
+/**
+ * Analyze a TypeScript project without full compilation
+ */
+export declare function analyzeProject(tsconfigPath: string): Promise<{
+    graph: Graph;
+    schemaGraph: SchemaGraph;
+    analysis: {
+        typeCount: number;
+        controllerCount: number;
+        operationCount: number;
+        avgComplexity: number;
+        potentialOptimizations: {
+            duplicateTypes: number;
+            inlineCandidates: number;
+            flattenCandidates: number;
+        };
+    };
+}>;
+/**
+ * Export GEMS compiler
+ */
+export declare const GEMS: {
+    compile: typeof compileWithGEMS;
+    quickCompile: typeof quickCompile;
+    analyze: typeof analyzeProject;
+    createConfig: typeof createGEMSConfig;
+};
+//# sourceMappingURL=gems.d.ts.map

package/dist/compiler/gems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gems.d.ts","sourceRoot":"","sources":["../../src/compiler/gems.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,2BAA2B,EAAE,MAAM,CAAC;QACpC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAChC,UAAU,CAYZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA6I7E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAO5E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IACT,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,sBAAsB,EAAE;YACtB,cAAc,EAAE,MAAM,CAAC;YACvB,gBAAgB,EAAE,MAAM,CAAC;YACzB,iBAAiB,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH,CAAC;CACH,CAAC,CA8CD;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;CAKhB,CAAC"}

package/dist/compiler/generator/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generator module exports
+ */
+export { generateOpenAPI, generateOpenAPIFromGraph, type OpenAPI31, type JsonSchema, type OpenAPIGeneratorOptions, DEFAULT_GENERATOR_OPTIONS } from './openapi.js';
+export { generateManifest, generateManifestFromGraph } from './manifest.js';
+export type { OperationObject, ParameterObject, RequestBodyObject, ResponseObject, MediaTypeObject } from './openapi.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compiler/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/generator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnK,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EAChB,MAAM,cAAc,CAAC"}

package/dist/compiler/generator/manifest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Manifest generator using GEMS graph-based IR.
+ * Generates runtime binding metadata from graph structure.
+ */
+import type { Graph } from "../graph/types.js";
+import type { ManifestV1 } from "../manifest/format.js";
+/**
+ * Manifest generation options
+ */
+export interface ManifestGeneratorOptions {
+    validationMode: "none" | "ajv-runtime" | "precompiled";
+    version: string;
+    typescriptVersion: string;
+}
+/**
+ * Generate manifest from GEMS graph
+ */
+export declare function generateManifestFromGraph(graph: Graph, options: ManifestGeneratorOptions): ManifestV1;
+/**
+ * Generate manifest from GEMS compilation result
+ */
+export declare function generateManifest(graph: Graph, validationMode?: "none" | "ajv-runtime" | "precompiled", version?: string, typescriptVersion?: string): ManifestV1;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/compiler/generator/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/compiler/generator/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,KAAK,EAKN,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,UAAU,EAQX,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,wBAAwB,GAChC,UAAU,CA0BZ;AAsRD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,cAAc,GAAE,MAAM,GAAG,aAAa,GAAG,aAA6B,EACtE,OAAO,GAAE,MAAgB,EACzB,iBAAiB,GAAE,MAAgB,GAClC,UAAU,CAMZ"}

package/dist/compiler/generator/openapi.d.ts

@@ -0,0 +1,118 @@
+/**
+ * OpenAPI 3.1 generator using GEMS graph-based IR.
+ * Generates optimized schemas from the graph structure.
+ */
+import type { Graph } from "../graph/types.js";
+import type { SchemaGraph } from "../graph/schemaGraph.js";
+/**
+ * OpenAPI 3.1 specification
+ */
+export interface OpenAPI31 {
+    openapi: "3.1.0";
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    components: {
+        schemas: Record<string, JsonSchema>;
+    };
+    paths: Record<string, Record<string, OperationObject>>;
+}
+/**
+ * OpenAPI operation object
+ */
+export interface OperationObject {
+    operationId: string;
+    summary?: string;
+    description?: string;
+    parameters?: ParameterObject[];
+    requestBody?: RequestBodyObject;
+    responses: Record<string, ResponseObject>;
+    tags?: string[];
+}
+/**
+ * OpenAPI parameter object
+ */
+export interface ParameterObject {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    required: boolean;
+    schema: JsonSchema;
+    description?: string;
+}
+/**
+ * OpenAPI request body object
+ */
+export interface RequestBodyObject {
+    description?: string;
+    required: boolean;
+    content: Record<string, MediaTypeObject>;
+}
+/**
+ * OpenAPI response object
+ */
+export interface ResponseObject {
+    description: string;
+    content?: Record<string, MediaTypeObject>;
+}
+/**
+ * OpenAPI media type object
+ */
+export interface MediaTypeObject {
+    schema: JsonSchema;
+    examples?: Record<string, unknown>;
+}
+/**
+ * JSON Schema (subset for OpenAPI 3.1)
+ */
+export interface JsonSchema {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    $ref?: string;
+    description?: string;
+    enum?: (string | number | boolean)[];
+    nullable?: boolean;
+    default?: unknown;
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    additionalProperties?: boolean | JsonSchema;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+}
+/**
+ * OpenAPI generator options
+ */
+export interface OpenAPIGeneratorOptions {
+    title?: string;
+    version?: string;
+    description?: string;
+    servers?: string[];
+    inlineAll?: boolean;
+    excludeUnusedSchemas?: boolean;
+}
+/**
+ * Default generator options
+ */
+export declare const DEFAULT_GENERATOR_OPTIONS: OpenAPIGeneratorOptions;
+/**
+ * Generate OpenAPI 3.1 specification from GEMS graph
+ */
+export declare function generateOpenAPIFromGraph(graph: Graph, schemaGraph: SchemaGraph, options?: Partial<OpenAPIGeneratorOptions>): OpenAPI31;
+/**
+ * Generate OpenAPI spec from GEMS compilation result
+ */
+export declare function generateOpenAPI(graph: Graph, schemaGraph: SchemaGraph, options?: Partial<OpenAPIGeneratorOptions>): OpenAPI31;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/compiler/generator/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/compiler/generator/openapi.ts"],"names":[],"mappings":"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"}

package/dist/compiler/graph/builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Graph builder that converts CST/AST to graph-based IR.
+ * Creates typed nodes and establishes relationships between them.
+ */
+import ts from "typescript";
+import type { Graph } from "./types.js";
+/**
+ * Builder context for constructing the graph
+ */
+export interface GraphBuilderContext {
+    graph: Graph;
+    checker: ts.TypeChecker;
+    sourceFiles: ts.SourceFile[];
+    nodeMap: Map<ts.Node, string>;
+}
+/**
+ * Create a new graph builder context
+ */
+export declare function createGraphBuilderContext(checker: ts.TypeChecker, sourceFiles: ts.SourceFile[], tsVersion?: string): GraphBuilderContext;
+/**
+ * Build the graph from source files
+ */
+export declare function buildGraph(context: GraphBuilderContext): Graph;
+//# sourceMappingURL=builder.d.ts.map

package/dist/compiler/graph/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/compiler/graph/builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EACV,KAAK,EAON,MAAM,YAAY,CAAC;AASpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,WAAW,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,WAAW,EAAE,EAAE,CAAC,UAAU,EAAE,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,CAOrB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,KAAK,CAoB9D"}

package/dist/compiler/graph/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Graph-based IR for compiler
+ */
+export * from './types.js';
+export * from './builder.js';
+export * from './schemaGraph.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compiler/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/graph/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/compiler/graph/schemaGraph.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Schema graph operations for advanced schema management.
+ * Provides graph algorithms for schema optimization and analysis.
+ */
+import type { Graph, NodeId } from "./types.js";
+/**
+ * Schema-specific graph with advanced operations
+ */
+export declare class SchemaGraph {
+    private graph;
+    private adjacency;
+    private reverseAdjacency;
+    constructor(graph: Graph);
+    /**
+     * Build adjacency lists for faster traversal
+     */
+    private buildAdjacencyLists;
+    /**
+     * Find all nodes that use a given type
+     */
+    findTypeUsages(typeId: NodeId): NodeId[];
+    /**
+     * Detect cycles in the dependency graph
+     */
+    detectCycles(): CycleReport;
+    /**
+     * Depth-first search for cycle detection
+     */
+    private detectCyclesDFS;
+    /**
+     * Find strongly connected components using Tarjan's algorithm
+     */
+    findStronglyConnectedComponents(): NodeId[][];
+    /**
+     * Topological sort of the graph
+     */
+    topologicalSort(): NodeId[];
+    /**
+     * Find nodes reachable from a given start node
+     */
+    findReachable(startNodeId: NodeId): Set<NodeId>;
+    /**
+     * Find shortest path between two nodes (BFS)
+     */
+    findShortestPath(fromId: NodeId, toId: NodeId): NodeId[] | null;
+    /**
+     * Reconstruct path from previous map
+     */
+    private reconstructPath;
+    /**
+     * Get nodes grouped by their depth from roots
+     */
+    getDepthGroups(): Map<number, NodeId[]>;
+    /**
+     * Get the underlying graph
+     */
+    getGraph(): Graph;
+}
+/**
+ * Cycle detection report
+ */
+export interface CycleReport {
+    hasCycles: boolean;
+    cycles: NodeId[][];
+    cycleCount: number;
+}
+//# sourceMappingURL=schemaGraph.d.ts.map