@nifrajs/cli 3.5.0 → 4.0.0

package/dist/internal/typescript-import.d.ts

@@ -1,33 +1,58 @@
 /**
  * The one place the CLI imports TypeScript from.
  *
- * The interpolated-SQL rule parses source with the TypeScript compiler, because the regex it replaced
- * could not tell `sql\`… ${id} …\`` (bound) from a plain template (injectable) without guessing at
- * string and comment boundaries. That is the right tool, but it is a ~25 MB dependency, and the CLI's
- * own typecheck step already treats `tsc` as something the PROJECT provides rather than something the
- * CLI ships. Making it a hard dependency would have contradicted that for every install.
- *
- * So it is an optional peer, resolved at the moment the rule runs. Every Nifra project has TypeScript
- * - the templates all ship a `typecheck` script - so this resolves in practice; the point is that an
- * install does not pay for it.
+ * The CLI supports the legacy compiler API shipped by TypeScript 5 and 6 and the
+ * split API shipped by TypeScript 7. The scanners only need a small AST surface,
+ * so TypeScript 7 is presented through a compatibility facade rather than leaking
+ * either compiler's concrete types through the rule registry.
  */
-/** The slice of the compiler the SQL scanner uses. Structural, so the peer stays optional. */
+import { type Diagnostic } from "../diagnostics.js";
+/** The legacy compiler API used by the syntax-only scanners and the compatibility facade. */
 export type TypeScriptApi = typeof import("typescript");
-/**
- * Import TypeScript from the CLI's own dependency tree, or `undefined` when it is not installed.
- *
- * Only a RESOLUTION failure is absence. A compiler that resolves and then fails while evaluating is a
- * broken install, not a missing one, and telling that user to install what they already have sends
- * them the wrong way - so that error is rethrown for the caller to report.
- */
+export declare const NIFRA_TS_UNSUPPORTED: "NIFRA_TS_UNSUPPORTED";
+/** A project compiler was found, but its API is outside the scanner adapter's supported range. */
+export declare class UnsupportedTypeScriptError extends Error {
+    readonly code: "NIFRA_TS_UNSUPPORTED";
+    readonly version: string;
+    constructor(version: string);
+}
+export declare function isUnsupportedTypeScriptError(error: unknown): error is UnsupportedTypeScriptError;
+export declare function unsupportedTypeScriptMessage(version: string): string;
+export declare function unsupportedTypeScriptDiagnostic(version: string): Diagnostic;
+/** Source files supplied to the TypeScript 7 virtual file system. */
+export interface TypeScriptSourceIndex {
+    readonly files: readonly string[];
+    read(file: string): string | undefined;
+    /** Optional temporary project config used by semantic adapters (for example OpenAPI probes). */
+    readonly projectConfig?: string;
+}
+/** A compiler plus the process/session that owns it. */
+export interface TypeScriptSession {
+    readonly compiler: TypeScriptApi;
+    /** TypeScript 7's asynchronous semantic API, present when a project program was opened. */
+    readonly semantic?: TypeScriptSemanticSession;
+    close(): Promise<void>;
+}
+export interface TypeScriptSemanticSession {
+    readonly checker: unknown;
+    readonly getCheckerForFile: (file: string) => Promise<unknown | undefined>;
+    readonly getSourceFile: (file: string) => Promise<unknown | undefined>;
+    readonly typeFlags: Readonly<Record<string, unknown>>;
+    readonly symbolFlags: Readonly<Record<string, unknown>>;
+    readonly signatureKind: Readonly<Record<string, unknown>>;
+}
+/** Import the CLI's own TypeScript only for legacy callers. Project loads use the adapter below. */
 export declare function importTypeScript(): Promise<TypeScriptApi | undefined>;
 /**
- * Import TypeScript resolved from the PROJECT root first, falling back to the CLI's own dependency
- * tree. A bare `import("typescript")` resolves relative to this file - the CLI's install - so a
- * globally-installed or bunx-run CLI could miss the project's compiler (or load a different major)
- * depending on where the CLI happened to live, while the project's own `typescript` sat unused in
- * its node_modules. Resolving from `root` makes the verdicts a function of the project, not of how
- * the CLI was installed - the same cwd-invariance the typecheck gate's tsc resolution has.
+ * Import TypeScript resolved from the PROJECT root first, with TypeScript 7's package exports
+ * selected explicitly. A project TypeScript 7 install never falls back to the CLI's compiler.
  */
-export declare function importProjectTypeScript(root: string): Promise<TypeScriptApi | undefined>;
+export declare function importProjectTypeScript(root: string, sourceIndex?: TypeScriptSourceIndex): Promise<TypeScriptApi | undefined>;
+export interface ProjectTypeScriptLoad {
+    readonly compiler: TypeScriptApi | undefined;
+    readonly session: TypeScriptSession | undefined;
+    readonly unsupported: UnsupportedTypeScriptError | undefined;
+}
+/** Load a project compiler for scanners while preserving a structured unsupported-toolchain result. */
+export declare function loadProjectTypeScript(root: string, load?: () => Promise<TypeScriptApi | undefined>, sourceIndex?: TypeScriptSourceIndex): Promise<ProjectTypeScriptLoad>;
 //# sourceMappingURL=typescript-import.d.ts.map

package/dist/internal/typescript-import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-import.d.ts","sourceRoot":"","sources":["../../src/internal/typescript-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GAAG,cAAc,YAAY,CAAC,CAAA;AAyBvD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAQ3E;AA6BD;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAgB9F"}
+{"version":3,"file":"typescript-import.d.ts","sourceRoot":"","sources":["../../src/internal/typescript-import.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,mBAAmB,CAAA;AAE/D,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,cAAc,YAAY,CAAC,CAAA;AAEvD,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAA;AAEnE,kGAAkG;AAClG,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,yBAAuB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBAEZ,OAAO,EAAE,MAAM;CAK5B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAahG;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAW3E;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACtC,gGAAgG;IAChG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAA;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IAC1E,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IACtE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrD,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC1D;AAgED,oGAAoG;AACpG,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAO3E;AAufD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,qBAAqB,GAClC,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGpC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC/C,QAAQ,CAAC,WAAW,EAAE,0BAA0B,GAAG,SAAS,CAAA;CAC7D;AAED,uGAAuG;AACvG,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,EAC/C,WAAW,CAAC,EAAE,qBAAqB,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAsBhC"}