@nooh-ts/compiler 0.1.0 → 0.2.1

package/dist/index.d.mts

@@ -10,6 +10,7 @@ interface SourceSnapshot {
 }
 interface ModuleLoader {
   loadDefault: (modulePath: string) => Promise<unknown>;
+  loadModule?: (modulePath: string) => Promise<Record<string, unknown>>;
 }
 interface CompileOptions {
   readonly outputRoot?: string;
@@ -22,9 +23,11 @@ interface CompileInput {
   readonly sources: SourceSnapshot;
 }
 interface RuntimeConfig {
+  readonly dependencies?: string | undefined;
   readonly routes?: string | undefined;
 }
 interface LoadedConfig {
+  readonly dependenciesRoot: string;
   readonly root: string;
   readonly routesRoot: string;
   readonly source: string;
@@ -35,7 +38,6 @@ interface ConfigLoadResult {
   readonly diagnostics: readonly Diagnostic[];
 }
 interface DiscoveredEndpoint {
-  readonly endpointsRoot: string;
   readonly groupPath: string;
   readonly localPath: string;
   readonly source: string;
@@ -46,6 +48,7 @@ interface DiscoveredGroup {
 }
 interface DiscoveredProject {
   readonly config: LoadedConfig;
+  readonly dependencies: readonly SourceFile[];
   readonly endpoints: readonly DiscoveredEndpoint[];
   readonly groups: readonly DiscoveredGroup[];
 }
@@ -85,6 +88,40 @@ interface RouteModel {
   readonly routeSegments: readonly RouteSegment[];
   readonly source: string;
 }
+type DependencyScope = "value" | "singleton" | "request" | "transient";
+interface DependencyDeclaration {
+  readonly dependencies: readonly string[];
+  readonly id: string;
+  readonly name: string;
+  readonly scope: DependencyScope;
+  readonly source: string;
+}
+interface DependencyNode {
+  readonly declaration: DependencyDeclaration;
+}
+interface DependencyGraph {
+  readonly nodes: ReadonlyMap<string, DependencyNode>;
+  readonly order: readonly string[];
+  readonly references: ReadonlyMap<object, string>;
+}
+interface RouteDependencyModel {
+  readonly closure: readonly string[];
+  readonly roots: readonly string[];
+  readonly routeId: string;
+}
+interface CompilationIntrospection {
+  readonly dependencies: DependencyGraph;
+  readonly routeDependencies: readonly RouteDependencyModel[];
+}
+interface IntrospectionInput {
+  readonly compilation: Compilation;
+  readonly dependencySources: readonly SourceFile[];
+  readonly loader: ModuleLoader;
+}
+interface IntrospectionResult {
+  readonly diagnostics: readonly Diagnostic[];
+  readonly introspection: CompilationIntrospection | null;
+}
 interface RouteGroup {
   readonly children: readonly string[];
   readonly configSource?: string;
@@ -95,7 +132,9 @@ interface RouteGroup {
 }
 interface ProjectModel {
   readonly config: LoadedConfig;
+  readonly dependencies: DependencyGraph;
   readonly groups: readonly RouteGroup[];
+  readonly routeDependencies: readonly RouteDependencyModel[];
   readonly routes: readonly RouteModel[];
 }
 type DiagnosticSeverity = "error" | "warning" | "info";
@@ -105,7 +144,7 @@ interface Diagnostic {
   readonly message: string;
   readonly severity: DiagnosticSeverity;
 }
-type ModuleKind = "types" | "router" | "middleware" | "group" | "app";
+type ModuleKind = "types" | "router" | "middleware" | "group" | "di" | "error" | "app";
 interface ModulePlan {
   readonly groupId?: string;
   readonly id: string;
@@ -113,8 +152,10 @@ interface ModulePlan {
   readonly routeId?: string;
 }
 interface CompilationPlan {
+  readonly dependencies: DependencyGraph;
   readonly modules: readonly ModulePlan[];
   readonly outputRoot: string;
+  readonly routeDependencies: readonly RouteDependencyModel[];
 }
 interface GeneratedModule {
   readonly code: string;
@@ -131,13 +172,14 @@ interface Compilation {
   readonly plan: CompilationPlan | null;
 }
 interface NoohCompiler {
-  analyze: (parsed: ParsedProject, config: LoadedConfig) => {
+  analyze: (parsed: ParsedProject, config: LoadedConfig, dependencies?: DependencyGraph) => {
     model: ProjectModel;
     diagnostics: readonly Diagnostic[];
   };
   compile: (input: CompileInput) => Promise<Compilation>;
   discover: (sources: CompileInput["sources"], config: LoadedConfig) => DiscoveredProject;
   generate: (plan: CompilationPlan, model: ProjectModel) => GeneratedOutput;
+  generateRouteIntrospection: (plan: CompilationPlan, model: ProjectModel) => GeneratedOutput;
   loadConfig: (input: CompileInput) => Promise<ConfigLoadResult>;
   parse: (project: DiscoveredProject) => ParsedProject;
   plan: (model: ProjectModel, outputRoot?: string) => CompilationPlan;
@@ -161,15 +203,33 @@ export declare const compile: (input: CompileInput) => Promise<Compilation>;
 //#endregion
 //#region src/compiler.d.ts
 export declare const createCompiler: () => NoohCompiler;
+export declare const introspect: (input: IntrospectionInput) => Promise<IntrospectionResult>;
 //#endregion
 //#region src/diff.d.ts
 export declare const diff: (previous: GeneratedOutput, next: GeneratedOutput) => OutputDiff;
 //#endregion
+//#region src/finalize.d.ts
+export declare const finalizeCompilation: (compilation: Compilation, introspection: CompilationIntrospection) => Compilation;
+//#endregion
 //#region src/generate/index.d.ts
 export declare const generate: (plan: CompilationPlan, model: ProjectModel) => GeneratedOutput;
+export declare const generateRouteIntrospection: (plan: CompilationPlan, model: ProjectModel) => GeneratedOutput;
+//#endregion
+//#region src/introspect.d.ts
+export declare const NOOH_ROUTE_METADATA: unique symbol;
+interface RouteMetadata {
+  readonly dependencies: readonly unknown[];
+  readonly kind: "route";
+}
+export declare const readRouteMetadata: (value: unknown) => RouteMetadata | null;
+export declare const introspectRoute: (route: RouteModel, loader: IntrospectionInput["loader"]) => Promise<{
+  readonly diagnostics: readonly Diagnostic[];
+  readonly metadata?: RouteMetadata | undefined;
+}>;
+export declare const introspectCompilation: (input: IntrospectionInput) => Promise<IntrospectionResult>;
 //#endregion
 //#region src/pipeline/analyze.d.ts
-export declare const analyze: (parsed: ParsedProject, config: LoadedConfig) => {
+export declare const analyze: (parsed: ParsedProject, config: LoadedConfig, dependencies?: DependencyGraph) => {
   model: ProjectModel;
   diagnostics: readonly Diagnostic[];
 };
@@ -177,6 +237,17 @@ export declare const analyze: (parsed: ParsedProject, config: LoadedConfig) => {
 //#region src/pipeline/config.d.ts
 export declare const loadConfig: (input: CompileInput) => Promise<ConfigLoadResult>;
 //#endregion
+//#region src/pipeline/dependencies.d.ts
+export declare const createDependencyGraph: (declarations: readonly DependencyDeclaration[], references?: ReadonlyMap<object, string>) => {
+  readonly diagnostics: readonly Diagnostic[];
+  readonly graph: DependencyGraph;
+};
+export declare const loadDependencyGraph: (sources: readonly SourceFile[], loader: ModuleLoader) => Promise<{
+  readonly diagnostics: readonly Diagnostic[];
+  readonly graph: DependencyGraph;
+}>;
+export declare const dependencyClosure: (graph: DependencyGraph, roots: readonly string[]) => readonly string[];
+//#endregion
 //#region src/pipeline/discover.d.ts
 export declare const discover: (snapshot: SourceSnapshot, config: LoadedConfig) => DiscoveredProject;
 //#endregion
@@ -189,5 +260,5 @@ export declare const plan: (model: ProjectModel, outputRoot?: string) => Compila
 //#region src/recompile.d.ts
 export declare const recompile: (input: RecompileInput) => Promise<Compilation>;
 //#endregion
-export type { Compilation, CompilationPlan, CompileInput, CompileOptions, ConfigLoadResult, Diagnostic, DiscoveredEndpoint, DiscoveredProject, GeneratedModule, GeneratedOutput, LoadedConfig, ModuleKind, ModuleLoader, ModulePlan, NoohCompiler, OutputDiff, ParsedProject, ParsedRoute, ProjectModel, RecompileInput, RouteGroup, RouteMethod, RouteModel, RouteSegment, RuntimeConfig, SourceFile, SourceSnapshot };
+export type { Compilation, CompilationIntrospection, CompilationPlan, CompileInput, CompileOptions, ConfigLoadResult, DependencyDeclaration, DependencyGraph, DependencyNode, DependencyScope, Diagnostic, DiscoveredEndpoint, DiscoveredProject, GeneratedModule, GeneratedOutput, IntrospectionInput, IntrospectionResult, LoadedConfig, ModuleKind, ModuleLoader, ModulePlan, NoohCompiler, OutputDiff, ParsedProject, ParsedRoute, ProjectModel, RecompileInput, RouteDependencyModel, RouteGroup, RouteMetadata, RouteMethod, RouteModel, RouteSegment, RuntimeConfig, SourceFile, SourceSnapshot };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/compile.ts","../src/compiler.ts","../src/diff.ts","../src/generate/index.ts","../src/pipeline/analyze.ts","../src/pipeline/config.ts","../src/pipeline/discover.ts","../src/pipeline/parse.ts","../src/pipeline/plan.ts","../src/recompile.ts"],"mappings":";cAAa;KAWD,sBAAsB;UAEjB;WACN;WACA;;UAGM;WACN,gBAAgB;;UAGV;EACf,cAAc,uBAAuB;;UAGtB;WACN;;UAGM;WACN;WACA,QAAQ;WACR,UAAU;WACV;WACA,SAAS;;UAGH;WACN;;UAGM;WACN;WACA;WACA;WACA,OAAO;;UAGD;WACN,SAAS;WACT,sBAAsB;;UAGhB;WACN;WACA;WACA;WACA;;UAGM;WACN;WACA;;UAGM;WACN,QAAQ;WACR,oBAAoB;WACpB,iBAAiB;;KAGhB;WAEG;WACA;;WAGA;WACA;;WAGA;WACA;;UAGE;WACN;WACA,QAAQ;WACR;WACA,mBAAmB;WACnB;;UAGM;WACN;WACA;;UAGM;WACN,sBAAsB;WACtB,iBAAiB;WACjB,iBAAiB;;UAGX;WACN;WAEA;WACA;WAEA;WAEA,QAAQ;WAER;WACA,wBAAwB;WACxB;;UAGM;WACN;WACA;WACA;WACA;WACA;WACA;;UAGM;WACN,QAAQ;WACR,iBAAiB;WACjB,iBAAiB;;KAGhB;UAEK;WACN;WACA;WACA;WACA,UAAU;;KAGT;UAEK;WACN;WACA;WACA,MAAM;WACN;;UAGM;WACN,kBAAkB;WAClB;;UAGM;WACN;WACA;WACA,MAAM;;UAGA;WACN,kBAAkB;;UAGZ;WACN,sBAAsB;WACtB,OAAO;WACP,QAAQ;WACR,MAAM;;UAGA;EACf,UACE,QAAQ,eACR,QAAQ;IAER,OAAO;IACP,sBAAsB;;EAExB,UAAU,OAAO,iBAAiB,QAAQ;EAC1C,WACE,SAAS,yBACT,QAAQ,iBACL;EACL,WAAW,MAAM,iBAAiB,OAAO,iBAAiB;EAC1D,aAAa,OAAO,iBAAiB,QAAQ;EAC7C,QAAQ,SAAS,sBAAsB;EACvC,OAAO,OAAO,cAAc,wBAAwB;;UAGrC;WACN,gBAAgB;WAChB,kBAAkB;WAClB;WACA,oBAAoB;;UAGd;WACN;WACA,QAAQ;WACR,UAAU;WACV,UAAU;WACV,UAAU;;;;qBC3MR,UAAW,OAAO,iBAAe,QAAQ;;;qBCOzC,sBAAqB;;;qBCRrB,OACX,UAAU,iBACV,MAAM,oBACL;;;qBCQU,WACX,MAAM,iBACN,OAAO,iBACN;;;qBC4MU,UACX,QAAQ,eACR,QAAQ;EAER,OAAO;EACP,sBAAsB;;;;qBCvNX,aACX,OAAO,iBACN,QAAQ;;;qBC8GE,WACX,UAAU,gBACV,QAAQ,iBACP;;;qBCpHU,QAAS,SAAS,sBAAoB;;;qBCDtC,OACX,OAAO,cACP,wBACC;;;qBCRU,YAAa,OAAO,mBAAiB,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/compile.ts","../src/compiler.ts","../src/diff.ts","../src/finalize.ts","../src/generate/index.ts","../src/introspect.ts","../src/pipeline/analyze.ts","../src/pipeline/config.ts","../src/pipeline/dependencies.ts","../src/pipeline/discover.ts","../src/pipeline/parse.ts","../src/pipeline/plan.ts","../src/recompile.ts"],"mappings":"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"}