@spikedpunch/align-plugin-typescript 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 align contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @spikedpunch/align-plugin-typescript
+
+The TypeScript/JavaScript language plugin for
+[align](https://github.com/SpikedPunchVictim/align) — an architecture-conformance verification
+oracle for humans and LLM coding agents.
+
+Implements [`@spikedpunch/align-core`](https://www.npmjs.com/package/@spikedpunch/align-core)'s
+`LanguagePlugin`/`Scanner` and `ManifestScanner` interfaces:
+
+- a scan-and-discard dependency-graph builder over the TypeScript compiler API,
+- nearest-`tsconfig` resolution,
+- a pnpm-workspace-name resolver with **realpath** classification of inter-package edges (path
+  substring matching silently misclassifies workspace-symlinked edges as external), and
+- the `package.json`/`pnpm-lock.yaml` manifest scanner behind align's security gate.
+
+Depends on `typescript` and `yaml`. `@spikedpunch/align-core` never imports this package —
+dependency direction is `core ← plugin`, enforced by align's own dogfooded rules.
+
+Most users want the `align` CLI — see
+[`@spikedpunch/align-cli`](https://www.npmjs.com/package/@spikedpunch/align-cli). Import this
+package directly only to compose a custom align host.
+
+## License
+
+MIT

package/dist/doctor.d.ts

@@ -0,0 +1,25 @@
+export interface DeadAlias {
+    readonly tsconfig: string;
+    readonly alias: string;
+    readonly target: string;
+}
+/**
+ * tsconfig `paths` entries whose target doesn't resolve to anything on disk (spike finding:
+ * `@kluster/shared/*` -> a nonexistent directory — trusting tsconfig paths uncritically would
+ * have turned it into a phantom component per ADR 003). Walks every tsconfig.json in the repo
+ * (not just ones already visited by a check/scan), since a dead alias in an otherwise-unused
+ * tsconfig is exactly the kind of drift `align doctor` exists to surface.
+ */
+export declare function findDeadAliases(rootDir: string, excludes?: readonly string[]): DeadAlias[];
+export interface OrphanedPackage {
+    readonly dir: string;
+    readonly name: string;
+}
+/**
+ * Packages on disk (a directory with a `package.json`) that no `pnpm-workspace.yaml` glob covers
+ * (spike finding: kluster had 13 workspace-orphaned `@fold/*` packages). Returns `[]` when there's
+ * no `pnpm-workspace.yaml` at all — the "orphaned" concept only applies to declared pnpm
+ * workspaces, not every repo with a package.json.
+ */
+export declare function findOrphanedPackages(rootDir: string, excludes?: readonly string[]): OrphanedPackage[];
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAqEA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG,SAAS,EAAE,CAoC9F;AASD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG,eAAe,EAAE,CAwBzG"}

package/dist/doctor.js

@@ -0,0 +1,149 @@
+/**
+ * `align doctor` advisory scans (Stage 2) that need TS-specific filesystem knowledge — tsconfig
+ * `paths` parsing and workspace-package inventory — so they live in the TypeScript plugin
+ * alongside the scanner/resolver that already own that knowledge, rather than duplicating tsconfig
+ * parsing in the CLI. Both functions are read-only surveys: malformed input is skipped, never
+ * thrown, matching the scanner's "read-only survey posture" (ADR 003/004).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import ts from 'typescript';
+import { loadWorkspacePackages } from './workspace.js';
+const EXCLUDED_DIR_NAMES = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.build',
+    '.history',
+    '.git',
+    '.next',
+    '.turbo',
+    '.cache',
+    'coverage',
+    'out',
+]);
+function toSlash(p) {
+    return p.split(path.sep).join('/');
+}
+/** Same exclude vocabulary as the scanner's `excludes` option (literal prefixes and simple
+ * `*`/`**` globs) — a repo's own align.config.ts excludes (e.g. read-only vendored trees, fixture
+ * directories with intentionally-broken configs) must apply here too, or `align doctor` reports
+ * noise the repo owner already told align to ignore. */
+function isExcluded(relPath, excludes) {
+    if (relPath === '')
+        return false;
+    return excludes.some((pattern) => relPath === pattern || relPath.startsWith(`${pattern}/`) || globLikeMatch(pattern, relPath));
+}
+function globLikeMatch(pattern, filePath) {
+    if (!pattern.includes('*'))
+        return false;
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*/g, ' ')
+        .replace(/\*/g, '[^/]*')
+        .replace(/ /g, '.*');
+    return new RegExp(`^${escaped}$`).test(filePath);
+}
+function walkDirs(rootDir, excludes, visit) {
+    const inner = (absDir) => {
+        const relDir = toSlash(path.relative(rootDir, absDir));
+        if (isExcluded(relDir, excludes))
+            return;
+        visit(absDir);
+        let entries;
+        try {
+            entries = fs.readdirSync(absDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() && !EXCLUDED_DIR_NAMES.has(entry.name) && !entry.name.startsWith('.')) {
+                inner(path.join(absDir, entry.name));
+            }
+        }
+    };
+    inner(rootDir);
+}
+/**
+ * tsconfig `paths` entries whose target doesn't resolve to anything on disk (spike finding:
+ * `@kluster/shared/*` -> a nonexistent directory — trusting tsconfig paths uncritically would
+ * have turned it into a phantom component per ADR 003). Walks every tsconfig.json in the repo
+ * (not just ones already visited by a check/scan), since a dead alias in an otherwise-unused
+ * tsconfig is exactly the kind of drift `align doctor` exists to surface.
+ */
+export function findDeadAliases(rootDir, excludes = []) {
+    const dead = [];
+    walkDirs(rootDir, excludes, (absDir) => {
+        const tsconfigPath = path.join(absDir, 'tsconfig.json');
+        if (!fs.existsSync(tsconfigPath))
+            return;
+        const read = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
+        if (read.config === undefined)
+            return;
+        // Same trap as TsconfigResolver: strip include/files before parseJsonConfigFileContent.
+        const config = read.config;
+        delete config['include'];
+        delete config['exclude'];
+        config['files'] = [];
+        let parsed;
+        try {
+            parsed = ts.parseJsonConfigFileContent(config, ts.sys, absDir);
+        }
+        catch {
+            return;
+        }
+        const paths = parsed.options.paths;
+        if (paths === undefined)
+            return;
+        const baseUrl = parsed.options.baseUrl ?? absDir;
+        for (const [alias, targets] of Object.entries(paths)) {
+            for (const target of targets) {
+                if (!targetExists(baseUrl, target)) {
+                    dead.push({ tsconfig: toSlash(path.relative(rootDir, tsconfigPath)), alias, target });
+                }
+            }
+        }
+    });
+    return dead;
+}
+function targetExists(baseUrl, target) {
+    const withoutGlob = target.endsWith('*') ? target.slice(0, -1) : target;
+    const resolved = path.resolve(baseUrl, withoutGlob);
+    if (fs.existsSync(resolved))
+        return true;
+    return ['.ts', '.tsx', '.d.ts', '.js', '.mts', '.cts'].some((ext) => fs.existsSync(`${resolved}${ext}`));
+}
+/**
+ * Packages on disk (a directory with a `package.json`) that no `pnpm-workspace.yaml` glob covers
+ * (spike finding: kluster had 13 workspace-orphaned `@fold/*` packages). Returns `[]` when there's
+ * no `pnpm-workspace.yaml` at all — the "orphaned" concept only applies to declared pnpm
+ * workspaces, not every repo with a package.json.
+ */
+export function findOrphanedPackages(rootDir, excludes = []) {
+    const covered = new Set(loadWorkspacePackages(rootDir).map((p) => p.dir));
+    if (!fs.existsSync(path.join(rootDir, 'pnpm-workspace.yaml')))
+        return [];
+    const orphaned = [];
+    walkDirs(rootDir, excludes, (absDir) => {
+        if (absDir === rootDir)
+            return; // the monorepo root manifest is not itself a workspace member
+        const pkgJsonPath = path.join(absDir, 'package.json');
+        if (!fs.existsSync(pkgJsonPath))
+            return;
+        const relDir = `${toSlash(path.relative(rootDir, absDir))}/`;
+        if (covered.has(relDir))
+            return;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+            if (typeof pkg.name === 'string' && pkg.name.length > 0) {
+                orphaned.push({ dir: relDir, name: pkg.name });
+            }
+        }
+        catch {
+            // malformed package.json: skip this one, not the whole scan
+        }
+    });
+    return orphaned;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/exports.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Condensed symbol table extraction (Stage 4: FixProposal grounding): a pure, best-effort static
+ * syntactic pass over an already-parsed `ts.SourceFile` that lists a module's importable symbol
+ * names — the "default" sentinel for `export default`, and declared/re-exported names otherwise.
+ * Deliberately mirrors `scanFile`'s parse -> extract -> discard philosophy: no type-checking
+ * `ts.Program`, no cross-file resolution. `export * from './other'` barrels are the one case that
+ * would require resolving and scanning the target module to enumerate; that's out of scope here,
+ * so barrels are recognized (not crashed on) and simply contribute no symbols of their own.
+ */
+import ts from 'typescript';
+/** Extracts the set of names importable from this module. Only walks top-level statements —
+ * import/export declarations are only valid there in a module, so no need for a full recursive
+ * AST walk (unlike edge extraction, which must find nested dynamic `import()`/`require()` calls). */
+export declare function extractExportedSymbols(sourceFile: ts.SourceFile): string[];
+//# sourceMappingURL=exports.d.ts.map

package/dist/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAkB5B;;qGAEqG;AACrG,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,EAAE,CAwD1E"}

package/dist/exports.js

@@ -0,0 +1,88 @@
+/**
+ * Condensed symbol table extraction (Stage 4: FixProposal grounding): a pure, best-effort static
+ * syntactic pass over an already-parsed `ts.SourceFile` that lists a module's importable symbol
+ * names — the "default" sentinel for `export default`, and declared/re-exported names otherwise.
+ * Deliberately mirrors `scanFile`'s parse -> extract -> discard philosophy: no type-checking
+ * `ts.Program`, no cross-file resolution. `export * from './other'` barrels are the one case that
+ * would require resolving and scanning the target module to enumerate; that's out of scope here,
+ * so barrels are recognized (not crashed on) and simply contribute no symbols of their own.
+ */
+import ts from 'typescript';
+function hasModifier(node, kind) {
+    if (!ts.canHaveModifiers(node))
+        return false;
+    return ts.getModifiers(node)?.some((m) => m.kind === kind) ?? false;
+}
+/** Flattens a (possibly destructured) binding name into the identifiers it introduces, e.g.
+ * `export const { a, b: c } = obj;` yields `['a', 'c']`. */
+function collectBindingNames(name) {
+    if (ts.isIdentifier(name))
+        return [name.text];
+    const names = [];
+    for (const element of name.elements) {
+        if (ts.isBindingElement(element))
+            names.push(...collectBindingNames(element.name));
+    }
+    return names;
+}
+/** Extracts the set of names importable from this module. Only walks top-level statements —
+ * import/export declarations are only valid there in a module, so no need for a full recursive
+ * AST walk (unlike edge extraction, which must find nested dynamic `import()`/`require()` calls). */
+export function extractExportedSymbols(sourceFile) {
+    const symbols = new Set();
+    for (const statement of sourceFile.statements) {
+        if (ts.isExportAssignment(statement)) {
+            // `export default expr;` (isExportEquals: false) contributes the default sentinel.
+            // `export = expr;` (isExportEquals: true) is CommonJS-only export-assignment syntax with no
+            // ESM-style named/default symbol to ground fixes against — skipped.
+            if (!statement.isExportEquals)
+                symbols.add('default');
+            continue;
+        }
+        if (ts.isExportDeclaration(statement)) {
+            if (statement.exportClause === undefined) {
+                // `export * from './other'` — a barrel re-export. Enumerating its contents would require
+                // resolving and scanning the target module (cross-file), which this per-file pass
+                // deliberately doesn't do (see module doc comment). Not a crash, just no symbols added.
+                continue;
+            }
+            if (ts.isNamedExports(statement.exportClause)) {
+                // Covers both `export { foo, bar as baz }` and `export { foo } from './other'` — either
+                // way, `.name` is the externally-visible (importer-facing) identifier.
+                for (const specifier of statement.exportClause.elements)
+                    symbols.add(specifier.name.text);
+            }
+            else if (ts.isNamespaceExport(statement.exportClause)) {
+                // `export * as ns from './other'` — unlike a bare `export *`, the namespace binding name
+                // itself is statically known without resolving the target.
+                symbols.add(statement.exportClause.name.text);
+            }
+            continue;
+        }
+        if (!hasModifier(statement, ts.SyntaxKind.ExportKeyword))
+            continue;
+        if (hasModifier(statement, ts.SyntaxKind.DefaultKeyword)) {
+            // `export default function foo() {}` / `export default class Foo {}` — importable only as
+            // "default"; the local name `foo`/`Foo` isn't a separate importable symbol.
+            symbols.add('default');
+            continue;
+        }
+        if (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) {
+            if (statement.name !== undefined)
+                symbols.add(statement.name.text);
+        }
+        else if (ts.isInterfaceDeclaration(statement) ||
+            ts.isTypeAliasDeclaration(statement) ||
+            ts.isEnumDeclaration(statement)) {
+            symbols.add(statement.name.text);
+        }
+        else if (ts.isVariableStatement(statement)) {
+            for (const declaration of statement.declarationList.declarations) {
+                for (const name of collectBindingNames(declaration.name))
+                    symbols.add(name);
+            }
+        }
+    }
+    return [...symbols];
+}
+//# sourceMappingURL=exports.js.map

package/dist/exports.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './exports.js';
+export * from './plugin.js';
+export * from './scanner.js';
+export * from './tsconfig-resolver.js';
+export * from './workspace.js';
+export * from './doctor.js';
+export * from './manifest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './exports.js';
+export * from './plugin.js';
+export * from './scanner.js';
+export * from './tsconfig-resolver.js';
+export * from './workspace.js';
+export * from './doctor.js';
+export * from './manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,15 @@
+import { type ManifestInventory, type ManifestScanner, type ManifestScanOptions } from '@spikedpunch/align-core';
+/** Scans the manifest domain for one repo: the root `package.json` (always, even though it's
+ * never itself a `loadWorkspacePackages` entry — that function only enumerates
+ * `pnpm-workspace.yaml` glob members) plus every workspace member's `package.json`, each
+ * dependency's specifier resolved through `pnpm-lock.yaml`'s matching `importers:` entry when a
+ * lockfile is present (root importer key is `.`; member keys are their repo-relative dir with no
+ * trailing slash). */
+export declare function scanManifests(rootDir: string, excludes?: readonly string[]): ManifestInventory;
+/** `@spikedpunch/align-core`'s `ManifestScanner` injection seam, concretely implemented for the pnpm/Node
+ * ecosystem — wired in at the CLI composition root exactly like `TypeScriptPlugin`
+ * (`packages/cli/src/composition-root.ts`), never imported by `@spikedpunch/align-core` directly. */
+export declare class NodeManifestScanner implements ManifestScanner {
+    scan(options: ManifestScanOptions): ManifestInventory;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAYA,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AA6FjC;;;;;sBAKsB;AACtB,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG,iBAAiB,CAelG;AAED;;qGAEqG;AACrG,qBAAa,mBAAoB,YAAW,eAAe;IACzD,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB;CAGtD"}

package/dist/manifest.js

@@ -0,0 +1,116 @@
+/**
+ * Manifest scan domain (ADR 013): the concrete pnpm/Node-ecosystem reader for `security.manifest.*`
+ * rules — root + workspace `package.json` files (workspace inventory via `workspace.ts`'s
+ * `loadWorkspacePackages`, reused rather than duplicated) plus `pnpm-lock.yaml`'s `importers:`
+ * section for lockfile-resolved specifiers (needed so a `catalog:`-managed dependency's real
+ * specifier is visible to `security.manifest.source-hygiene` — spike/MANIFEST_PROBE_REPORT.md Rule
+ * 1's documented reason for reading the lockfile at all, not just package.json). No network, no
+ * `node_modules` required — same read-only, pre-install posture as `workspace.ts` (ADR 004).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { toRepoRelativePath, } from '@spikedpunch/align-core';
+import { loadWorkspacePackages } from './workspace.js';
+const DEP_FIELDS = ['dependencies', 'devDependencies', 'optionalDependencies'];
+function readJson(absPath) {
+    try {
+        return JSON.parse(fs.readFileSync(absPath, 'utf8'));
+    }
+    catch {
+        return undefined; // malformed/unreadable: skip this one file, not the whole scan
+    }
+}
+function readLockfile(rootDir) {
+    const lockPath = path.join(rootDir, 'pnpm-lock.yaml');
+    if (!fs.existsSync(lockPath))
+        return undefined;
+    try {
+        return parseYaml(fs.readFileSync(lockPath, 'utf8'));
+    }
+    catch {
+        return undefined; // malformed lockfile: read-only survey posture, don't crash the scan
+    }
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Best-effort raw-text line lookup for a dependency key — a deliberately boring heuristic (first
+ * `"<name>":` match in the file), not a JSON-position parser; documented v1 limitation, same
+ * posture as `workspace.ts`'s `resolveWorkspaceSpecifier` (CODING_BEST_PRACTICES.md §3). Good
+ * enough for `Violation.range`/`snippet` — a wrong line within the same file is a minor cosmetic
+ * miss, never a wrong fingerprint (fingerprints never use line numbers, ADR 006/013). */
+function findDependencyLine(raw, depName) {
+    const re = new RegExp(`^\\s*"${escapeRegExp(depName)}"\\s*:`);
+    const lines = raw.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        if (re.test(lines[i] ?? ''))
+            return i + 1;
+    }
+    return undefined;
+}
+function isExcluded(relDir, excludes) {
+    if (relDir === '')
+        return false;
+    return excludes.some((pattern) => relDir === pattern || relDir.startsWith(`${pattern}/`));
+}
+function buildManifestRecord(rootDir, relDir, lockImporter) {
+    const pkgJsonPath = path.join(rootDir, relDir, 'package.json');
+    if (!fs.existsSync(pkgJsonPath))
+        return undefined;
+    let raw;
+    try {
+        raw = fs.readFileSync(pkgJsonPath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    const pkg = readJson(pkgJsonPath);
+    if (pkg === undefined)
+        return undefined;
+    const dependencies = [];
+    for (const field of DEP_FIELDS) {
+        const declared = pkg[field];
+        if (declared === undefined)
+            continue;
+        const lockGroup = lockImporter?.[field];
+        for (const [name, rawSpecifier] of Object.entries(declared)) {
+            const specifier = lockGroup?.[name]?.specifier ?? rawSpecifier;
+            const line = findDependencyLine(raw, name);
+            dependencies.push({ name, specifier, field, ...(line === undefined ? {} : { line }) });
+        }
+    }
+    const filePath = relDir === '' ? 'package.json' : `${relDir}/package.json`;
+    return { file: toRepoRelativePath(filePath), raw, dependencies };
+}
+/** Scans the manifest domain for one repo: the root `package.json` (always, even though it's
+ * never itself a `loadWorkspacePackages` entry — that function only enumerates
+ * `pnpm-workspace.yaml` glob members) plus every workspace member's `package.json`, each
+ * dependency's specifier resolved through `pnpm-lock.yaml`'s matching `importers:` entry when a
+ * lockfile is present (root importer key is `.`; member keys are their repo-relative dir with no
+ * trailing slash). */
+export function scanManifests(rootDir, excludes = []) {
+    const lock = readLockfile(rootDir);
+    const manifests = [];
+    const rootRecord = buildManifestRecord(rootDir, '', lock?.importers?.['.']);
+    if (rootRecord !== undefined)
+        manifests.push(rootRecord);
+    for (const pkg of loadWorkspacePackages(rootDir)) {
+        const relDir = pkg.dir.endsWith('/') ? pkg.dir.slice(0, -1) : pkg.dir;
+        if (isExcluded(relDir, excludes))
+            continue;
+        const record = buildManifestRecord(rootDir, relDir, lock?.importers?.[relDir]);
+        if (record !== undefined)
+            manifests.push(record);
+    }
+    return { manifests, lockfilePresent: lock !== undefined };
+}
+/** `@spikedpunch/align-core`'s `ManifestScanner` injection seam, concretely implemented for the pnpm/Node
+ * ecosystem — wired in at the CLI composition root exactly like `TypeScriptPlugin`
+ * (`packages/cli/src/composition-root.ts`), never imported by `@spikedpunch/align-core` directly. */
+export class NodeManifestScanner {
+    scan(options) {
+        return scanManifests(options.rootDir, options.excludes);
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { LanguagePlugin } from '@spikedpunch/align-core';
+import { TypeScriptScanner } from './scanner.js';
+export declare class TypeScriptPlugin implements LanguagePlugin {
+    readonly id = "typescript";
+    readonly fileMatch: string[];
+    readonly scanner: TypeScriptScanner;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,SAAS,WAAkD;IACpE,QAAQ,CAAC,OAAO,oBAA2B;CAC5C"}

package/dist/plugin.js

@@ -0,0 +1,7 @@
+import { TypeScriptScanner } from './scanner.js';
+export class TypeScriptPlugin {
+    id = 'typescript';
+    fileMatch = ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'];
+    scanner = new TypeScriptScanner();
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,OAAO,gBAAgB;IAClB,EAAE,GAAG,YAAY,CAAC;IAClB,SAAS,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;CAC5C"}

package/dist/scanner.d.ts

@@ -0,0 +1,6 @@
+import { type ComponentName, type DependencyGraph, type ScanInput, type Scanner } from '@spikedpunch/align-core';
+export declare const UNMAPPED_COMPONENT: ComponentName;
+export declare class TypeScriptScanner implements Scanner {
+    scan(input: ScanInput): Promise<DependencyGraph>;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAUA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EAOpB,KAAK,SAAS,EACd,KAAK,OAAO,EAEb,MAAM,yBAAyB,CAAC;AAQjC,eAAO,MAAM,kBAAkB,eAAkC,CAAC;AAgElE,qBAAa,iBAAkB,YAAW,OAAO;IACzC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;CA4DvD"}

package/dist/scanner.js.map

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

package/dist/tsconfig-resolver.d.ts

@@ -0,0 +1,26 @@
+import { type WorkspacePackage } from './workspace.js';
+export type ResolvedTarget = {
+    readonly kind: 'internal';
+    readonly absolutePath: string;
+} | {
+    readonly kind: 'external';
+    readonly packageName: string;
+    readonly isBuiltin: boolean;
+} | {
+    readonly kind: 'unresolved';
+};
+export declare class TsconfigResolver {
+    private readonly repoRoot;
+    private readonly workspacePackages;
+    private readonly tsconfigByDir;
+    private readonly optionsByTsconfig;
+    private readonly resolutionCache;
+    constructor(repoRoot: string, workspacePackages: readonly WorkspacePackage[]);
+    resolveSpecifier(specifier: string, containingFile: string): ResolvedTarget;
+    private resolveUncached;
+    private realpathOf;
+    private optionsForDir;
+    private parseTsconfig;
+    private findNearestTsconfig;
+}
+//# sourceMappingURL=tsconfig-resolver.d.ts.map

package/dist/tsconfig-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-resolver.d.ts","sourceRoot":"","sources":["../src/tsconfig-resolver.ts"],"names":[],"mappings":"AASA,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAI5D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEpC,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IANpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyC;IAC3E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;gBAGlD,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,SAAS,gBAAgB,EAAE;IAGjE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc;IAe3E,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,mBAAmB;CA2B5B"}

package/dist/tsconfig-resolver.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,11 @@
+export interface WorkspacePackage {
+    readonly name: string;
+    readonly dir: string;
+}
+export declare function loadWorkspacePackages(rootDir: string): WorkspacePackage[];
+/** Given a bare import specifier and the workspace inventory, finds the owning package and its
+ * source-entry file (package-entry -> source mapping, ADR 004). Tries common TS monorepo entry
+ * conventions rather than a full package.json `exports` map resolver — a deliberately boring
+ * heuristic (CODING_BEST_PRACTICES.md §3), documented as a v1 limitation. */
+export declare function resolveWorkspaceSpecifier(specifier: string, packages: readonly WorkspacePackage[], rootDir: string): string | undefined;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAgCzE;AAgED;;;6EAG6E;AAC7E,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CA6BpB"}

package/dist/workspace.js

@@ -0,0 +1,143 @@
+/**
+ * pnpm-workspace.yaml package inventory (ADR 004): resolves workspace package names to their
+ * source directories without requiring `node_modules` to exist — the mechanism that makes
+ * `pnpm install` a non-prerequisite for seeing a repo's architecture. Doubles as the
+ * package-entry -> source mapping (cross-package imports would otherwise resolve to
+ * `dist/**\/*.d.ts`, which are not scanned nodes).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+export function loadWorkspacePackages(rootDir) {
+    const wsPath = path.join(rootDir, 'pnpm-workspace.yaml');
+    if (!fs.existsSync(wsPath))
+        return [];
+    let patterns;
+    try {
+        const doc = parseYaml(fs.readFileSync(wsPath, 'utf8'));
+        patterns = Array.isArray(doc?.packages) ? doc.packages.filter((p) => typeof p === 'string') : [];
+    }
+    catch {
+        return []; // malformed workspace file: read-only survey posture, don't crash the scan
+    }
+    const dirs = new Set();
+    for (const pattern of patterns) {
+        for (const dir of expandPattern(rootDir, pattern))
+            dirs.add(dir);
+    }
+    const packages = [];
+    for (const abs of dirs) {
+        const pkgJsonPath = path.join(abs, 'package.json');
+        if (!fs.existsSync(pkgJsonPath))
+            continue;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+            if (typeof pkg.name === 'string' && pkg.name.length > 0) {
+                const rel = path.relative(rootDir, abs).split(path.sep).join('/');
+                packages.push({ name: pkg.name, dir: rel.endsWith('/') ? rel : `${rel}/` });
+            }
+        }
+        catch {
+            // malformed package.json: skip this one package, not the whole scan
+        }
+    }
+    return packages;
+}
+/** Expands one pnpm-workspace.yaml glob pattern to absolute directories that contain a
+ * package.json. Supports the pattern vocabulary pnpm-workspace.yaml actually uses: literal
+ * segments, a single trailing/interior `*` (one directory level), and a trailing `**` (recursive
+ * — any package.json anywhere under the prefix). */
+function expandPattern(rootDir, pattern) {
+    const normalized = pattern.split('\\').join('/');
+    if (normalized.endsWith('/**') || normalized === '**') {
+        const prefix = normalized === '**' ? '' : normalized.slice(0, -'/**'.length);
+        const base = path.join(rootDir, prefix);
+        return collectPackageDirsRecursive(base);
+    }
+    const segments = normalized.split('/').filter((s) => s.length > 0);
+    let currentDirs = [rootDir];
+    for (const segment of segments) {
+        const next = [];
+        for (const dir of currentDirs) {
+            if (segment === '*') {
+                for (const entry of safeReaddir(dir)) {
+                    if (entry.isDirectory())
+                        next.push(path.join(dir, entry.name));
+                }
+            }
+            else {
+                const candidate = path.join(dir, segment);
+                if (isDirectory(candidate))
+                    next.push(candidate);
+            }
+        }
+        currentDirs = next;
+    }
+    return currentDirs;
+}
+function collectPackageDirsRecursive(base) {
+    const results = [];
+    const visit = (dir) => {
+        if (!isDirectory(dir))
+            return;
+        if (fs.existsSync(path.join(dir, 'package.json')))
+            results.push(dir);
+        for (const entry of safeReaddir(dir)) {
+            if (entry.isDirectory() && entry.name !== 'node_modules' && !entry.name.startsWith('.')) {
+                visit(path.join(dir, entry.name));
+            }
+        }
+    };
+    visit(base);
+    return results;
+}
+function safeReaddir(dir) {
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+function isDirectory(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Given a bare import specifier and the workspace inventory, finds the owning package and its
+ * source-entry file (package-entry -> source mapping, ADR 004). Tries common TS monorepo entry
+ * conventions rather than a full package.json `exports` map resolver — a deliberately boring
+ * heuristic (CODING_BEST_PRACTICES.md §3), documented as a v1 limitation. */
+export function resolveWorkspaceSpecifier(specifier, packages, rootDir) {
+    const match = packages.find((p) => specifier === p.name || specifier.startsWith(`${p.name}/`));
+    if (match === undefined)
+        return undefined;
+    const subpath = specifier === match.name ? '' : specifier.slice(match.name.length + 1);
+    const pkgAbsDir = path.join(rootDir, match.dir);
+    const candidates = subpath === ''
+        ? [
+            path.join(pkgAbsDir, 'src', 'index.ts'),
+            path.join(pkgAbsDir, 'src', 'index.tsx'),
+            path.join(pkgAbsDir, 'index.ts'),
+            path.join(pkgAbsDir, 'index.tsx'),
+            path.join(pkgAbsDir, 'src', 'index.js'),
+            path.join(pkgAbsDir, 'index.js'),
+        ]
+        : [
+            `${path.join(pkgAbsDir, subpath)}.ts`,
+            `${path.join(pkgAbsDir, subpath)}.tsx`,
+            path.join(pkgAbsDir, subpath, 'index.ts'),
+            `${path.join(pkgAbsDir, 'src', subpath)}.ts`,
+            path.join(pkgAbsDir, 'src', subpath, 'index.ts'),
+            `${path.join(pkgAbsDir, subpath)}.js`,
+        ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isFile())
+            return candidate;
+    }
+    return undefined;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAO1C,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAuC,CAAC;QAC7F,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,2EAA2E;IACxF,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAuB,CAAC;YACnF,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;oDAGoD;AACpD,SAAS,aAAa,CAAC,OAAe,EAAE,OAAe;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,WAAW,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,IAAI,KAAK,CAAC,WAAW,EAAE;wBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC1C,IAAI,WAAW,CAAC,SAAS,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,GAAW,EAAQ,EAAE;QAClC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAAE,OAAO;QAC9B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;6EAG6E;AAC7E,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,QAAqC,EACrC,OAAe;IAEf,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/F,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,OAAO,GAAG,SAAS,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,UAAU,GACd,OAAO,KAAK,EAAE;QACZ,CAAC,CAAC;YACE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;SACjC;QACH,CAAC,CAAC;YACE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK;YACrC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM;YACtC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC;YACzC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;YAC5C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC;YAChD,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK;SACtC,CAAC;IAER,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,SAAS,CAAC;IACpF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@spikedpunch/align-plugin-typescript",
+  "version": "0.1.0",
+  "description": "TypeScript/JavaScript dependency-graph plugin for align — ts-morph-based scanning and language adapters.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SpikedPunchVictim/align",
+    "directory": "packages/plugin-typescript"
+  },
+  "keywords": [
+    "align",
+    "architecture",
+    "conformance",
+    "typescript",
+    "javascript",
+    "ts-morph",
+    "dependency-graph",
+    "plugin"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "typescript": "^5.6.3",
+    "yaml": "^2.6.0",
+    "@spikedpunch/align-core": "0.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.4"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}