@anarchitects/governance-adapter-typescript 0.0.1 → 0.0.3

package/README.md

@@ -51,8 +51,12 @@ import {
   discoverTypeScriptProjects,
   deriveProjectTags,
   mapTypeScriptImportsToGovernanceDependencies,
+  normalizeTypeScriptPathAliases,
   parsePackageManagerWorkspace,
+  parseTsconfig,
   parseTsConfigResolution,
+  resolveTsconfigExtends,
+  resolveWorkspacePackages,
   type TsConfigResolutionModel,
   type TypeScriptImportGraph,
   type TypeScriptProjectDiscoveryResult,
@@ -67,7 +71,13 @@ The root export currently includes:
 - `createGovernanceWorkspaceAdapter(...)`
 - `detectTypeScriptWorkspace(...)`
 - `parsePackageManagerWorkspace(...)`
+- `resolveWorkspacePackages(...)`
 - `parseTsConfigResolution(...)`
+- `parseTsconfig(...)`
+- `resolveTsConfigExtendsChain(...)`
+- `resolveTsconfigExtends(...)`
+- `normalizePathAliasesFromConfigs(...)`
+- `normalizeTypeScriptPathAliases(...)`
 - `discoverTypeScriptProjects(...)`
 - `buildTypeScriptImportGraph(...)`
 - `mapTypeScriptImportsToGovernanceDependencies(...)`
@@ -76,6 +86,28 @@ The root export currently includes:
 
 The current API is a set of composable adapter primitives. It does not expose a single all-in-one host runner.
 
+Parity already covered inside this package includes:
+
+- workspace detection and probe-style support heuristics
+- package-manager workspace parsing
+- TypeScript project discovery and tag derivation
+- `tsconfig` / path-alias resolution
+- static import graph extraction
+- normalization into Governance Core adapter result inputs
+
+The package-root API now exposes the exact reusable parity helpers that host
+packages can consume directly:
+
+- `detectTypeScriptWorkspace(...)`
+- `parseTsconfig(...)`
+- `resolveTsconfigExtends(...)`
+- `normalizeTypeScriptPathAliases(...)`
+- `parsePackageManagerWorkspace(...)`
+- `resolveWorkspacePackages(...)`
+- `discoverTypeScriptProjects(...)`
+- `buildTypeScriptImportGraph(...)`
+- `mapTypeScriptImportsToGovernanceDependencies(...)`
+
 ## Usage
 
 The typical workflow is:
@@ -94,7 +126,7 @@ import {
   discoverTypeScriptProjects,
   mapTypeScriptImportsToGovernanceDependencies,
   parsePackageManagerWorkspace,
-  parseTsConfigResolution,
+  parseTsconfig,
 } from '@anarchitects/governance-adapter-typescript';
 
 const detection = detectTypeScriptWorkspace(process.cwd());
@@ -108,7 +140,7 @@ const projectDiscovery = discoverTypeScriptProjects({
   workspaceRoot: workspacePackages.workspaceRoot,
   packageRoots: workspacePackages.packageRoots,
 });
-const tsconfig = parseTsConfigResolution(detection.workspaceRoot);
+const tsconfig = parseTsconfig(detection.workspaceRoot);
 const importGraph = buildTypeScriptImportGraph({
   workspaceRoot: detection.workspaceRoot,
   projects: projectDiscovery.projects,

package/dist/detect-typescript-workspace.d.ts

@@ -1,3 +1,3 @@
-import { TypeScriptWorkspaceDetectionResult } from './types.js';
+import type { TypeScriptWorkspaceDetectionResult } from './types.js';
 export declare function detectTypeScriptWorkspace(workspacePath: string): TypeScriptWorkspaceDetectionResult;
 //# sourceMappingURL=detect-typescript-workspace.d.ts.map

package/dist/diagnostics.d.ts

@@ -1,4 +1,4 @@
-import { TypeScriptWorkspaceDetectionDiagnostic, TypeScriptWorkspaceIndicators } from './types.js';
+import type { TypeScriptWorkspaceDetectionDiagnostic, TypeScriptWorkspaceIndicators } from './types.js';
 export declare function invalidPackageJsonDiagnostic(filePath: string): TypeScriptWorkspaceDetectionDiagnostic;
 export declare function partialWorkspaceDetectionDiagnostic(indicators: TypeScriptWorkspaceIndicators): TypeScriptWorkspaceDetectionDiagnostic;
 export declare function noWorkspaceIndicatorsDiagnostic(): TypeScriptWorkspaceDetectionDiagnostic;

package/dist/import-graph.d.ts

@@ -1,5 +1,5 @@
-import { GovernanceProjectInput } from '@anarchitects/governance-core';
-import { TsConfigResolutionModel, TypeScriptImportGraph } from './types.js';
+import type { GovernanceProjectInput } from '@anarchitects/governance-core';
+import type { TsConfigResolutionModel, TypeScriptImportGraph } from './types.js';
 export declare function buildTypeScriptImportGraph(options: {
     workspaceRoot: string;
     projects: readonly GovernanceProjectInput[];

package/dist/index.d.ts

@@ -2,9 +2,12 @@ export { detectTypeScriptWorkspace } from './detect-typescript-workspace.js';
 export { buildTypeScriptImportGraph } from './import-graph.js';
 export { DEFAULT_TYPESCRIPT_PROJECT_DISCOVERY_CONFIG, createGovernanceWorkspaceAdapter, createTypeScriptWorkspaceAdapter, governanceWorkspaceAdapter, type CreateGovernanceWorkspaceAdapterOptions, type CreateTypeScriptWorkspaceAdapterOptions, } from './workspace-adapter.js';
 export { mapTypeScriptImportsToGovernanceDependencies } from './map-imports-to-projects.js';
+export { normalizePathAliasesFromConfigs, normalizePathAliasesFromConfigs as normalizeTypeScriptPathAliases, } from './normalize-path-aliases.js';
 export { parsePackageManagerWorkspace } from './parse-package-manager-workspace.js';
-export { parseTsConfigResolution } from './parse-tsconfig.js';
+export { parseTsConfigResolution, parseTsConfigResolution as parseTsconfig, } from './parse-tsconfig.js';
 export { discoverTypeScriptProjects } from './project-discovery.js';
+export { resolveTsConfigExtendsChain, resolveTsConfigExtendsChain as resolveTsconfigExtends, } from './resolve-tsconfig-extends.js';
+export { resolveWorkspacePackages } from './resolve-workspace-packages.js';
 export { deriveProjectTags, type DerivedProjectTags } from './tag-mapping.js';
 export type { TsConfigResolutionModel, TypeScriptImportEdge, TypeScriptImportGraph, TypeScriptImportKind, TypeScriptProjectDependencyMappingResult, TypeScriptProjectDiscoveryConfig, TypeScriptProjectDiscoveryResult, TypeScriptProjectDiscoveryRule, TypeScriptSourceFileNode, TypeScriptWorkspaceDetectionDiagnostic, TypeScriptWorkspaceDetectionResult, TypeScriptWorkspaceDetectionStatus, TypeScriptWorkspaceIndicators, TypeScriptWorkspacePackageManager, WorkspacePackageResolution, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,EAChC,gCAAgC,EAChC,0BAA0B,EAC1B,KAAK,uCAAuC,EAC5C,KAAK,uCAAuC,GAC7C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4CAA4C,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,wCAAwC,EACxC,gCAAgC,EAChC,gCAAgC,EAChC,8BAA8B,EAC9B,wBAAwB,EACxB,sCAAsC,EACtC,kCAAkC,EAClC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,2CAA2C,EAC3C,gCAAgC,EAChC,gCAAgC,EAChC,0BAA0B,EAC1B,KAAK,uCAAuC,EAC5C,KAAK,uCAAuC,GAC7C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4CAA4C,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,IAAI,8BAA8B,GAClE,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,uBAAuB,IAAI,aAAa,GACzC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,IAAI,sBAAsB,GACtD,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,wCAAwC,EACxC,gCAAgC,EAChC,gCAAgC,EAChC,8BAA8B,EAC9B,wBAAwB,EACxB,sCAAsC,EACtC,kCAAkC,EAClC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -194,7 +194,7 @@ function je(t, e, r) {
     path: t
   };
 }
-function w(t, e, r) {
+function T(t, e, r) {
   return {
     code: "governance.typescript_adapter.ambiguous_project_match",
     message: `File "${e}" matched multiple discovered projects.`,
@@ -273,7 +273,7 @@ function We(t, e) {
   return o.push(
     ...i.map(
       (a) => he(
-        T(e),
+        w(e),
         `Failed to parse source file "${e}": ${g.flattenDiagnosticMessageText(
           a.messageText,
           `
@@ -303,7 +303,7 @@ function We(t, e) {
     if (g.isImportEqualsDeclaration(a) && g.isExternalModuleReference(a.moduleReference)) {
       o.push(
         ye(
-          T(e),
+          w(e),
           `Import-equals syntax is not supported for deterministic analysis in "${e}".`
         )
       );
@@ -329,13 +329,13 @@ function xe(t, e) {
     diagnostics: []
   } : {
     imports: [],
-    diagnostics: [ve(T(e))]
+    diagnostics: [ve(w(e))]
   };
 }
 function Ae(t) {
   return t.endsWith(".tsx") ? g.ScriptKind.TSX : t.endsWith(".jsx") ? g.ScriptKind.JSX : t.endsWith(".js") ? g.ScriptKind.JS : g.ScriptKind.TS;
 }
-function T(t) {
+function w(t) {
   return `/${Ce(t)}`;
 }
 function Ce(t) {
@@ -348,7 +348,7 @@ const Fe = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx"]), De = /* @__P
   "node_modules",
   "out"
 ]);
-function we(t, e) {
+function Te(t, e) {
   const r = [], n = /* @__PURE__ */ new Set(), o = [...e].sort(
     (i, s) => (i.root ?? "").localeCompare(s.root ?? "") || (i.name ?? i.id).localeCompare(s.name ?? s.id)
   );
@@ -391,7 +391,7 @@ function Z({
       });
       continue;
     }
-    if (!s.isFile() || !Te(s.name))
+    if (!s.isFile() || !we(s.name))
       continue;
     const a = p.join(e, s.name), c = Ie(
       t,
@@ -403,7 +403,7 @@ function Z({
     }));
   }
 }
-function Te(t) {
+function we(t) {
   return t.endsWith(".d.ts") ? !1 : Fe.has(p.extname(t).toLowerCase());
 }
 function Ie(t, e) {
@@ -411,7 +411,7 @@ function Ie(t, e) {
 }
 const K = [".ts", ".tsx", ".js", ".jsx"];
 function Re(t) {
-  const e = p.resolve(t.workspaceRoot), r = we(e, t.projects), n = [], o = [];
+  const e = p.resolve(t.workspaceRoot), r = Te(e, t.projects), n = [], o = [];
   for (const i of r) {
     const s = p.resolve(e, i.filePath), a = k(s, "utf8"), c = We(a, i.filePath);
     n.push(...c.diagnostics);
@@ -590,7 +590,7 @@ function Be(t) {
         a.filePath
       )
     ) : c.status === "ambiguous" && r.push(
-      w(
+      T(
         X(a.filePath),
         a.filePath,
         c.projects.map((u) => u.id)
@@ -647,7 +647,7 @@ function Ve({
       return;
     }
     o.push(
-      w(
+      T(
         _(e.sourceFile, e.specifier),
         e.resolvedFile,
         c.projects.map((u) => u.id)
@@ -673,7 +673,7 @@ function Ve({
     return;
   if (s.length > 1) {
     o.push(
-      w(
+      T(
         _(e.sourceFile, e.specifier),
         e.specifier,
         s.map((c) => c.id)
@@ -1578,7 +1578,7 @@ function Ct(t) {
         importGraph: s
       });
       return {
-        workspaceId: wt(r),
+        workspaceId: Tt(r),
         workspaceName: ae(r),
         workspaceRoot: ".",
         projects: o.projects,
@@ -1606,7 +1606,7 @@ function Dt(t) {
   const e = [];
   return t.indicators.pnpmWorkspace && e.push("pnpm-workspace.yaml is present"), t.indicators.packageManagerWorkspaces && e.push("package.json declares package-manager workspaces"), t.indicators.tsconfig && e.push("tsconfig.json is present"), t.indicators.tsconfigBase && e.push("tsconfig.base.json is present"), e.length === 0 && e.push("no TypeScript workspace indicators were found"), e;
 }
-function wt(t) {
+function Tt(t) {
   return ae(t);
 }
 function ae(t) {
@@ -1632,6 +1632,12 @@ export {
   $t as discoverTypeScriptProjects,
   Nt as governanceWorkspaceAdapter,
   Be as mapTypeScriptImportsToGovernanceDependencies,
+  dt as normalizePathAliasesFromConfigs,
+  dt as normalizeTypeScriptPathAliases,
   ot as parsePackageManagerWorkspace,
-  yt as parseTsConfigResolution
+  yt as parseTsConfigResolution,
+  yt as parseTsconfig,
+  mt as resolveTsConfigExtendsChain,
+  mt as resolveTsconfigExtends,
+  tt as resolveWorkspacePackages
 };

package/dist/map-imports-to-projects.d.ts

@@ -1,5 +1,5 @@
-import { GovernanceProjectInput } from '@anarchitects/governance-core';
-import { TypeScriptImportGraph, TypeScriptProjectDependencyMappingResult } from './types.js';
+import type { GovernanceProjectInput } from '@anarchitects/governance-core';
+import type { TypeScriptImportGraph, TypeScriptProjectDependencyMappingResult } from './types.js';
 export declare function mapTypeScriptImportsToGovernanceDependencies(options: {
     workspaceRoot: string;
     projects: readonly GovernanceProjectInput[];

package/dist/normalize-path-aliases.d.ts

@@ -1,4 +1,4 @@
-import { TsConfigResolutionModel, TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
+import type { TsConfigResolutionModel, TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
 interface ResolvedTsConfigFile {
     filePath: string;
     jsonPath: string;

package/dist/normalize-workspace-patterns.d.ts

@@ -1,4 +1,4 @@
-import { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
+import type { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
 export interface NormalizedWorkspacePatterns {
     patterns: string[];
     diagnostics: TypeScriptWorkspaceDetectionDiagnostic[];

package/dist/parse-imports.d.ts

@@ -1,4 +1,4 @@
-import { TypeScriptImportKind, TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
+import type { TypeScriptImportKind, TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
 export interface ParsedImportReference {
     specifier: string;
     kind: TypeScriptImportKind;

package/dist/parse-package-manager-workspace.d.ts

@@ -1,3 +1,3 @@
-import { WorkspacePackageResolution } from './types.js';
+import type { WorkspacePackageResolution } from './types.js';
 export declare function parsePackageManagerWorkspace(workspacePath: string): WorkspacePackageResolution;
 //# sourceMappingURL=parse-package-manager-workspace.d.ts.map

package/dist/parse-tsconfig.d.ts

@@ -1,3 +1,3 @@
-import { TsConfigResolutionModel } from './types.js';
+import type { TsConfigResolutionModel } from './types.js';
 export declare function parseTsConfigResolution(workspacePath: string, configFilePath?: string): TsConfigResolutionModel;
 //# sourceMappingURL=parse-tsconfig.d.ts.map

package/dist/project-discovery.d.ts

@@ -1,3 +1,3 @@
-import { TypeScriptProjectDiscoveryConfig, TypeScriptProjectDiscoveryResult, WorkspacePackageResolution } from './types.js';
+import type { TypeScriptProjectDiscoveryConfig, TypeScriptProjectDiscoveryResult, WorkspacePackageResolution } from './types.js';
 export declare function discoverTypeScriptProjects(workspace: WorkspacePackageResolution, config: TypeScriptProjectDiscoveryConfig): TypeScriptProjectDiscoveryResult;
 //# sourceMappingURL=project-discovery.d.ts.map

package/dist/project-naming.d.ts

@@ -1,4 +1,4 @@
-import { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
+import type { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
 interface RenderTemplateResult {
     value?: string;
     diagnostics: TypeScriptWorkspaceDetectionDiagnostic[];

package/dist/resolve-tsconfig-extends.d.ts

@@ -1,4 +1,4 @@
-import { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
+import type { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
 interface ParsedTsConfig {
     filePath: string;
     jsonPath: string;

package/dist/source-file-discovery.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceProjectInput } from '@anarchitects/governance-core';
-import { TypeScriptSourceFileNode } from './types.js';
+import type { GovernanceProjectInput } from '@anarchitects/governance-core';
+import type { TypeScriptSourceFileNode } from './types.js';
 export declare function discoverTypeScriptSourceFiles(workspaceRoot: string, projects: readonly GovernanceProjectInput[]): TypeScriptSourceFileNode[];
 //# sourceMappingURL=source-file-discovery.d.ts.map

package/dist/tag-mapping.d.ts

@@ -1,4 +1,4 @@
-import { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
+import type { TypeScriptWorkspaceDetectionDiagnostic } from './types.js';
 export interface DerivedProjectTags {
     tags: string[];
     domain?: string;

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceDiagnostic, GovernanceDependencyInput, GovernanceProjectInput } from '@anarchitects/governance-core';
+import type { GovernanceDiagnostic, GovernanceDependencyInput, GovernanceProjectInput } from '@anarchitects/governance-core';
 export type TypeScriptWorkspaceDetectionStatus = 'supported' | 'partial' | 'unsupported';
 export interface TypeScriptWorkspaceIndicators {
     packageJson: boolean;

package/dist/workspace-adapter.d.ts

@@ -1,5 +1,5 @@
-import { GovernanceWorkspaceAdapter } from '@anarchitects/governance-core';
-import { TypeScriptProjectDiscoveryConfig } from './types.js';
+import type { GovernanceWorkspaceAdapter } from '@anarchitects/governance-core';
+import type { TypeScriptProjectDiscoveryConfig } from './types.js';
 export interface CreateTypeScriptWorkspaceAdapterOptions {
     discoveryConfig: TypeScriptProjectDiscoveryConfig;
     tsconfigPath?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anarchitects/governance-adapter-typescript",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Platform-independent Governance TypeScript workspace adapter that normalizes discovery into Governance Core contracts.",
   "license": "MIT",
   "type": "module",
@@ -52,7 +52,7 @@
     }
   },
   "dependencies": {
-    "@anarchitects/governance-core": "^0.0.1",
+    "@anarchitects/governance-core": "^0.0.3",
     "minimatch": "^10.1.1",
     "typescript": "~5.9.2",
     "yaml": "^2.8.1"