@skastr0/pulsar-ts-pack 0.1.0

package/dist/signals/ts-ad-03-reexport-analysis.d.ts

@@ -0,0 +1,17 @@
+import { type SourceFile } from "ts-morph";
+export interface ReExportAnalysis {
+    readonly isBarrel: boolean;
+    readonly barrelRatio: number;
+    readonly maxChainDepth: number;
+    readonly directReExports: number;
+}
+interface ReExportAnalysisConfig {
+    readonly barrel_ratio_threshold: number;
+    readonly index_reexport_threshold: number;
+}
+export declare const buildReExportAnalysis: (sourceFiles: ReadonlyArray<SourceFile>, config: ReExportAnalysisConfig) => {
+    readonly reExportTargets: ReadonlyMap<string, ReadonlyArray<string>>;
+    readonly analysisByFile: Map<string, ReExportAnalysis>;
+};
+export {};
+//# sourceMappingURL=ts-ad-03-reexport-analysis.d.ts.map

package/dist/signals/ts-ad-03-reexport-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ad-03-reexport-analysis.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ad-03-reexport-analysis.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAA;CAC1C;AAED,eAAO,MAAM,qBAAqB,GAChC,aAAa,aAAa,CAAC,UAAU,CAAC,EACtC,QAAQ,sBAAsB,KAC7B;IACD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IACpE,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAiBvD,CAAA"}

package/dist/signals/ts-ad-03-reexport-analysis.js

@@ -0,0 +1,74 @@
+import { basename } from "node:path";
+import { sortedUniqueFilePaths } from "@skastr0/pulsar-core/signal";
+import { Node } from "ts-morph";
+import { createModuleResolver } from "../graph/module-graph.js";
+export const buildReExportAnalysis = (sourceFiles, config) => {
+    const fileSet = new Set(sourceFiles.map((sourceFile) => sourceFile.getFilePath()));
+    const resolver = createModuleResolver(sourceFiles, []);
+    const reExportTargets = new Map();
+    const analysisByFile = new Map();
+    for (const sourceFile of sourceFiles) {
+        const file = sourceFile.getFilePath();
+        const targets = collectReExportTargets(sourceFile, fileSet, resolver);
+        reExportTargets.set(file, targets);
+        analysisByFile.set(file, analyzeReExportFile(sourceFile, targets, config));
+    }
+    return { reExportTargets, analysisByFile };
+};
+const collectReExportTargets = (sourceFile, fileSet, resolver) => {
+    const file = sourceFile.getFilePath();
+    return sortedUniqueFilePaths(sourceFile.getExportDeclarations().reduce((acc, declaration) => {
+        const value = resolver.resolve(file, declaration);
+        if (value !== undefined && fileSet.has(value)) {
+            acc.push(value);
+        }
+        return acc;
+    }, []));
+};
+const analyzeReExportFile = (sourceFile, targets, config) => {
+    const file = sourceFile.getFilePath();
+    const directReExports = targets.length;
+    const totalExports = directReExports + countLocalExportSurfaces(sourceFile);
+    const barrelRatio = totalExports === 0 ? Number(directReExports > 0) : directReExports / totalExports;
+    const isBarrel = barrelRatio >= config.barrel_ratio_threshold ||
+        (basename(file) === "index.ts" && directReExports >= config.index_reexport_threshold);
+    return {
+        isBarrel,
+        barrelRatio,
+        maxChainDepth: 0,
+        directReExports,
+    };
+};
+const countLocalExportSurfaces = (sourceFile) => {
+    let count = 0;
+    for (const statement of sourceFile.getStatements()) {
+        if (Node.isExportDeclaration(statement)) {
+            if (statement.getModuleSpecifierValue() !== undefined)
+                continue;
+            count += Math.max(1, statement.getNamedExports().length);
+            continue;
+        }
+        if (Node.isExportAssignment(statement)) {
+            count += 1;
+            continue;
+        }
+        if (Node.isVariableStatement(statement)) {
+            if (!hasExportModifier(statement))
+                continue;
+            count += Math.max(1, statement.getDeclarations().length);
+            continue;
+        }
+        if (Node.isFunctionDeclaration(statement) ||
+            Node.isClassDeclaration(statement) ||
+            Node.isInterfaceDeclaration(statement) ||
+            Node.isTypeAliasDeclaration(statement) ||
+            Node.isEnumDeclaration(statement) ||
+            Node.isModuleDeclaration(statement)) {
+            if (hasExportModifier(statement))
+                count += 1;
+        }
+    }
+    return count;
+};
+const hasExportModifier = (node) => node.getModifiers().some((modifier) => modifier.getText() === "export");
+//# sourceMappingURL=ts-ad-03-reexport-analysis.js.map

package/dist/signals/ts-ad-03-reexport-analysis.js.map

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

package/dist/signals/ts-ad-03-reexport-depth.d.ts

@@ -0,0 +1,27 @@
+import { SignalContextTag } from "@skastr0/pulsar-core/signal";
+import type { DistributionalSummary, Signal } from "@skastr0/pulsar-core/signal";
+import { Schema } from "effect";
+import { TsProjectTag } from "../ts-project.js";
+import { type ReExportChain } from "./ts-ad-03-chains.js";
+import { type ReExportAnalysis } from "./ts-ad-03-reexport-analysis.js";
+declare const TsAd03Config: Schema.Struct<{
+    exclude_globs: Schema.Array$<typeof Schema.String>;
+    barrel_ratio_threshold: typeof Schema.Number;
+    index_reexport_threshold: typeof Schema.Number;
+    chain_threshold: typeof Schema.Number;
+    score_scale: typeof Schema.Number;
+    top_n_diagnostics: typeof Schema.Number;
+}>;
+type TsAd03Config = typeof TsAd03Config.Type;
+interface TsAd03Output {
+    readonly byFile: ReadonlyMap<string, ReExportAnalysis>;
+    readonly chainsOverThreshold: ReadonlyArray<ReExportChain>;
+    readonly stats: DistributionalSummary;
+    readonly threshold: number;
+    readonly scoreScale: number;
+    readonly diagnosticLimit: number;
+    readonly worktreePath?: string;
+}
+export declare const TsAd03: Signal<TsAd03Config, TsAd03Output, TsProjectTag | SignalContextTag>;
+export {};
+//# sourceMappingURL=ts-ad-03-reexport-depth.d.ts.map

package/dist/signals/ts-ad-03-reexport-depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ad-03-reexport-depth.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ad-03-reexport-depth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiC,MAAM,6BAA6B,CAAA;AAC7F,OAAO,KAAK,EAAc,qBAAqB,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAC5F,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAA;AAM7B,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAA;AAExC,QAAA,MAAM,YAAY;;;;;;;EAOhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,UAAU,YAAY;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACtD,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IAC1D,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,GAAG,gBAAgB,CAkEtF,CAAA"}

package/dist/signals/ts-ad-03-reexport-depth.js

@@ -0,0 +1,96 @@
+import { SignalContextTag, SignalComputeError, summarize } from "@skastr0/pulsar-core/signal";
+import { Effect, Schema } from "effect";
+import { TsProjectTag } from "../ts-project.js";
+import { isExcluded } from "./shared-globs.js";
+import { collectReExportChains, compareChains, effectiveChainDepth, uniqueChains, } from "./ts-ad-03-chains.js";
+import { formatDiagnosticPath, formatHopChain, selectDiagnosticChains, } from "./ts-ad-03-diagnostics.js";
+import { buildReExportAnalysis, } from "./ts-ad-03-reexport-analysis.js";
+const TsAd03Config = Schema.Struct({
+    exclude_globs: Schema.Array(Schema.String),
+    barrel_ratio_threshold: Schema.Number,
+    index_reexport_threshold: Schema.Number,
+    chain_threshold: Schema.Number,
+    score_scale: Schema.Number,
+    top_n_diagnostics: Schema.Number,
+});
+export const TsAd03 = {
+    id: "TS-AD-03-reexport-depth",
+    title: "Re-export depth",
+    aliases: ["TS-AD-03"],
+    tier: 1,
+    category: "architectural-drift",
+    kind: "structural",
+    configSchema: TsAd03Config,
+    defaultConfig: {
+        exclude_globs: [
+            "**/*.test.ts",
+            "**/*.spec.ts",
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/.turbo/**",
+        ],
+        barrel_ratio_threshold: 0.5,
+        index_reexport_threshold: 3,
+        chain_threshold: 3,
+        score_scale: 3,
+        top_n_diagnostics: 10,
+    },
+    inputs: [],
+    compute: (config) => Effect.gen(function* () {
+        const project = yield* TsProjectTag;
+        const context = yield* SignalContextTag;
+        const result = yield* Effect.try({
+            try: () => {
+                const sourceFiles = project
+                    .getSourceFiles()
+                    .filter((sourceFile) => !isExcluded(sourceFile.getFilePath(), config.exclude_globs));
+                return computeReExportDepthOutput(sourceFiles, config, context.worktreePath);
+            },
+            catch: (cause) => new SignalComputeError({
+                signalId: "TS-AD-03-reexport-depth",
+                message: String(cause),
+                cause,
+            }),
+        });
+        return result;
+    }),
+    score: (out) => {
+        if (out.chainsOverThreshold.length === 0)
+            return 1;
+        const maxEffectiveDepth = Math.max(...out.chainsOverThreshold.map(effectiveChainDepth));
+        const penalty = (maxEffectiveDepth - out.threshold) / Math.max(1, out.scoreScale);
+        return Math.max(0, 1 - Math.min(1, Math.max(0, penalty)));
+    },
+    diagnose: (out) => selectDiagnosticChains(out.chainsOverThreshold, out.diagnosticLimit).map((chain) => ({
+        severity: "warn",
+        message: `${chain.cycle ? "Re-export cycle" : "Deep re-export chain"} ` +
+            `(depth ${chain.depth}): ${formatHopChain(chain.hops, out.worktreePath)}`,
+        location: { file: chain.start },
+        data: {
+            start: chain.start,
+            end: chain.end,
+            depth: chain.depth,
+            effectiveDepth: effectiveChainDepth(chain),
+            hops: chain.hops.slice(),
+            displayHops: chain.hops.map((hop) => formatDiagnosticPath(hop, out.worktreePath)),
+            cycle: chain.cycle,
+        },
+    })),
+};
+const computeReExportDepthOutput = (sourceFiles, config, worktreePath) => {
+    const { reExportTargets, analysisByFile } = buildReExportAnalysis(sourceFiles, config);
+    const allChains = collectReExportChains(reExportTargets, analysisByFile);
+    const chainsOverThreshold = uniqueChains(allChains)
+        .filter((chain) => chain.depth > config.chain_threshold || chain.cycle)
+        .sort(compareChains);
+    return {
+        byFile: analysisByFile,
+        chainsOverThreshold,
+        stats: summarize(allChains.map((chain) => chain.depth)),
+        threshold: config.chain_threshold,
+        scoreScale: config.score_scale,
+        diagnosticLimit: config.top_n_diagnostics,
+        worktreePath,
+    };
+};
+//# sourceMappingURL=ts-ad-03-reexport-depth.js.map

package/dist/signals/ts-ad-03-reexport-depth.js.map

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

package/dist/signals/ts-de-01-coupling-output.d.ts

@@ -0,0 +1,38 @@
+import type { DistributionalSummary, SignalFactorLedger } from "@skastr0/pulsar-core/signal";
+import type { CalibrationDecision } from "@skastr0/pulsar-core/calibration";
+export interface CouplingCounterpart {
+    readonly module: string;
+    readonly outgoingTypes: number;
+    readonly incomingTypes: number;
+    readonly totalTypes: number;
+}
+export interface ModuleTypeCoupling {
+    readonly file: string;
+    readonly externalTypesReferenced: number;
+    readonly typesReferencedExternally: number;
+    readonly totalCoupling: number;
+    readonly counterparts: ReadonlyArray<CouplingCounterpart>;
+    readonly visible?: boolean;
+    readonly severity?: "info" | "warn" | "block";
+    readonly penaltyWeight?: number;
+    readonly factorPathPrefix?: string;
+    readonly policyDecisions?: ReadonlyArray<CalibrationDecision>;
+}
+export interface TsDe01Output {
+    readonly modules: ReadonlyArray<ModuleTypeCoupling>;
+    readonly byModule: ReadonlyMap<string, DistributionalSummary>;
+    readonly repoDistribution: DistributionalSummary;
+    readonly outlierThreshold: number;
+    readonly totalModules: number;
+    readonly diagnosticLimit: number;
+    readonly calibrationDecisions?: ReadonlyArray<CalibrationDecision>;
+    readonly factorLedger?: SignalFactorLedger;
+}
+export type CouplingTable = Map<string, Map<string, Set<string>>>;
+export declare const ensureNestedSet: (table: CouplingTable, outer: string, inner: string) => Set<string>;
+export declare const createCouplingTables: (fileSet: ReadonlySet<string>) => {
+    readonly outgoing: CouplingTable;
+    readonly incoming: CouplingTable;
+};
+export declare const buildOutputFromTables: (fileSet: ReadonlySet<string>, outgoing: ReadonlyMap<string, ReadonlyMap<string, Set<string>>>, incoming: ReadonlyMap<string, ReadonlyMap<string, Set<string>>>, diagnosticLimit: number) => TsDe01Output;
+//# sourceMappingURL=ts-de-01-coupling-output.d.ts.map

package/dist/signals/ts-de-01-coupling-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-de-01-coupling-output.d.ts","sourceRoot":"","sources":["../../src/signals/ts-de-01-coupling-output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAG3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAA;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAC3C;AAED,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AAEjE,eAAO,MAAM,eAAe,GAC1B,OAAO,aAAa,EACpB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,GAAG,CAAC,MAAM,CAMZ,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,SAAS,WAAW,CAAC,MAAM,CAAC,KAC3B;IACD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CAWjC,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,SAAS,WAAW,CAAC,MAAM,CAAC,EAC5B,UAAU,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAC/D,UAAU,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAC/D,iBAAiB,MAAM,KACtB,YAkDF,CAAA"}

package/dist/signals/ts-de-01-coupling-output.js

@@ -0,0 +1,80 @@
+import { summarize } from "@skastr0/pulsar-core/signal";
+import { compareDescendingMetricByFile } from "./shared-rank-order.js";
+export const ensureNestedSet = (table, outer, inner) => {
+    const row = table.get(outer) ?? new Map();
+    table.set(outer, row);
+    const set = row.get(inner) ?? new Set();
+    row.set(inner, set);
+    return set;
+};
+export const createCouplingTables = (fileSet) => {
+    const outgoing = new Map();
+    const incoming = new Map();
+    for (const file of fileSet) {
+        outgoing.set(file, new Map());
+        incoming.set(file, new Map());
+    }
+    return { outgoing, incoming };
+};
+export const buildOutputFromTables = (fileSet, outgoing, incoming, diagnosticLimit) => {
+    const byModule = new Map();
+    const modules = [];
+    for (const file of fileSet) {
+        const outgoingByCounterpart = outgoing.get(file) ?? new Map();
+        const incomingByCounterpart = incoming.get(file) ?? new Map();
+        const counterpartPaths = new Set([
+            ...outgoingByCounterpart.keys(),
+            ...incomingByCounterpart.keys(),
+        ]);
+        const counterparts = [...counterpartPaths]
+            .map((counterpart) => ({
+            module: counterpart,
+            outgoingTypes: outgoingByCounterpart.get(counterpart)?.size ?? 0,
+            incomingTypes: incomingByCounterpart.get(counterpart)?.size ?? 0,
+            totalTypes: (outgoingByCounterpart.get(counterpart)?.size ?? 0) +
+                (incomingByCounterpart.get(counterpart)?.size ?? 0),
+        }))
+            .filter((counterpart) => counterpart.totalTypes > 0)
+            .sort(compareCounterparts);
+        const summary = summarize(counterparts.map((counterpart) => counterpart.totalTypes));
+        const externalTypesReferenced = uniqueSetSize(outgoingByCounterpart.values());
+        const typesReferencedExternally = uniqueSetSize(incomingByCounterpart.values());
+        modules.push({
+            file,
+            externalTypesReferenced,
+            typesReferencedExternally,
+            totalCoupling: externalTypesReferenced + typesReferencedExternally,
+            counterparts,
+        });
+        byModule.set(file, summary);
+    }
+    modules.sort(compareModules);
+    const repoDistribution = summarize(modules.map((module) => module.externalTypesReferenced));
+    return {
+        modules,
+        byModule,
+        repoDistribution,
+        outlierThreshold: Math.max(repoDistribution.avg, repoDistribution.p95),
+        totalModules: modules.length,
+        diagnosticLimit,
+    };
+};
+const uniqueSetSize = (sets) => {
+    const merged = new Set();
+    for (const set of sets) {
+        for (const value of set) {
+            merged.add(value);
+        }
+    }
+    return merged.size;
+};
+const compareCounterparts = (left, right) => {
+    if (right.totalTypes !== left.totalTypes) {
+        return right.totalTypes - left.totalTypes;
+    }
+    return left.module.localeCompare(right.module);
+};
+const compareModules = (left, right) => {
+    return compareDescendingMetricByFile(left.totalCoupling, right.totalCoupling, left.file, right.file);
+};
+//# sourceMappingURL=ts-de-01-coupling-output.js.map

package/dist/signals/ts-de-01-coupling-output.js.map

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

package/dist/signals/ts-de-01-fast-coupling.d.ts

@@ -0,0 +1,4 @@
+import { type SourceFile } from "ts-morph";
+import { type TsDe01Output } from "./ts-de-01-coupling-output.js";
+export declare const computeFastImportTypeCoupling: (sourceFiles: ReadonlyArray<SourceFile>, diagnosticLimit: number) => TsDe01Output;
+//# sourceMappingURL=ts-de-01-fast-coupling.d.ts.map

package/dist/signals/ts-de-01-fast-coupling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-de-01-fast-coupling.d.ts","sourceRoot":"","sources":["../../src/signals/ts-de-01-fast-coupling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAA;AAEtC,eAAO,MAAM,6BAA6B,GACxC,aAAa,aAAa,CAAC,UAAU,CAAC,EACtC,iBAAiB,MAAM,KACtB,YAuBF,CAAA"}

package/dist/signals/ts-de-01-fast-coupling.js

@@ -0,0 +1,85 @@
+import { ts } from "ts-morph";
+import { createModuleResolver } from "../graph/module-graph.js";
+import { buildOutputFromTables, createCouplingTables, ensureNestedSet, } from "./ts-de-01-coupling-output.js";
+export const computeFastImportTypeCoupling = (sourceFiles, diagnosticLimit) => {
+    const fileSet = new Set(sourceFiles.map((sourceFile) => sourceFile.getFilePath()));
+    const resolver = createModuleResolver(sourceFiles, []);
+    const { outgoing, incoming } = createCouplingTables(fileSet);
+    for (const sourceFile of sourceFiles) {
+        const src = sourceFile.getFilePath();
+        const importedTypeTargets = importedTypeTargetsForFile(sourceFile, resolver);
+        if (importedTypeTargets.size === 0)
+            continue;
+        for (const reference of collectFastTypeReferenceNames(sourceFile)) {
+            const referenceName = rootTypeReferenceName(reference.name);
+            if (referenceName === undefined)
+                continue;
+            const targetFile = importedTypeTargets.get(referenceName);
+            if (targetFile === undefined || targetFile === src || !fileSet.has(targetFile))
+                continue;
+            const key = `${referenceName}:${reference.pos}`;
+            ensureNestedSet(outgoing, src, targetFile).add(key);
+            ensureNestedSet(incoming, targetFile, src).add(key);
+        }
+    }
+    return buildOutputFromTables(fileSet, outgoing, incoming, diagnosticLimit);
+};
+const importedTypeTargetsForFile = (sourceFile, resolver) => {
+    const targets = new Map();
+    const sourcePath = sourceFile.getFilePath();
+    for (const declaration of sourceFile.getImportDeclarations()) {
+        const targetPath = resolver.resolve(sourcePath, declaration);
+        if (targetPath === undefined)
+            continue;
+        const defaultImport = declaration.getDefaultImport();
+        if (defaultImport !== undefined) {
+            targets.set(defaultImport.getText(), targetPath);
+        }
+        const namespaceImport = declaration.getNamespaceImport();
+        if (namespaceImport !== undefined) {
+            targets.set(namespaceImport.getText(), targetPath);
+        }
+        for (const namedImport of declaration.getNamedImports()) {
+            targets.set(namedImport.getAliasNode()?.getText() ?? namedImport.getName(), targetPath);
+        }
+    }
+    return targets;
+};
+const collectFastTypeReferenceNames = (sourceFile) => {
+    const compilerSourceFile = sourceFile.compilerNode;
+    const references = [];
+    const visit = (node) => {
+        const name = fastTypeReferenceName(node, compilerSourceFile);
+        if (name !== undefined) {
+            references.push({ name, pos: node.pos });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(compilerSourceFile);
+    return references;
+};
+const fastTypeReferenceName = (node, sourceFile) => {
+    if (ts.isTypeReferenceNode(node)) {
+        return entityNameText(node.typeName, sourceFile);
+    }
+    if (ts.isExpressionWithTypeArguments(node)) {
+        return node.expression.getText(sourceFile);
+    }
+    if (ts.isTypeQueryNode(node)) {
+        return entityNameText(node.exprName, sourceFile);
+    }
+    return undefined;
+};
+const entityNameText = (name, sourceFile) => {
+    if (ts.isIdentifier(name))
+        return name.text;
+    return name.left.getText(sourceFile);
+};
+const rootTypeReferenceName = (name) => {
+    const trimmed = name.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    const match = /^[$A-Z_a-z][$\w]*/.exec(trimmed);
+    return match?.[0];
+};
+//# sourceMappingURL=ts-de-01-fast-coupling.js.map

package/dist/signals/ts-de-01-fast-coupling.js.map

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

package/dist/signals/ts-de-01-precise-coupling.d.ts

@@ -0,0 +1,4 @@
+import { type SourceFile } from "ts-morph";
+import { type TsDe01Output } from "./ts-de-01-coupling-output.js";
+export declare const computePreciseTypeCoupling: (sourceFiles: ReadonlyArray<SourceFile>, diagnosticLimit: number) => TsDe01Output;
+//# sourceMappingURL=ts-de-01-precise-coupling.d.ts.map

package/dist/signals/ts-de-01-precise-coupling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-de-01-precise-coupling.d.ts","sourceRoot":"","sources":["../../src/signals/ts-de-01-precise-coupling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAA;AAOtC,eAAO,MAAM,0BAA0B,GACrC,aAAa,aAAa,CAAC,UAAU,CAAC,EACtC,iBAAiB,MAAM,KACtB,YASF,CAAA"}

package/dist/signals/ts-de-01-precise-coupling.js

@@ -0,0 +1,23 @@
+import { buildOutputFromTables, createCouplingTables, ensureNestedSet, } from "./ts-de-01-coupling-output.js";
+import { collectTypeReferenceLikeNodes, declarationKey, resolveReferenceLikeDeclarations, } from "./shared-type-analysis.js";
+export const computePreciseTypeCoupling = (sourceFiles, diagnosticLimit) => {
+    const fileSet = new Set(sourceFiles.map((sourceFile) => sourceFile.getFilePath()));
+    const { outgoing, incoming } = createCouplingTables(fileSet);
+    for (const sourceFile of sourceFiles) {
+        recordPreciseTypeReferences(sourceFile, fileSet, outgoing, incoming);
+    }
+    return buildOutputFromTables(fileSet, outgoing, incoming, diagnosticLimit);
+};
+const recordPreciseTypeReferences = (sourceFile, fileSet, outgoing, incoming) => {
+    const src = sourceFile.getFilePath();
+    for (const reference of collectTypeReferenceLikeNodes(sourceFile)) {
+        for (const declaration of resolveReferenceLikeDeclarations(reference)) {
+            const targetFile = declaration.getSourceFile().getFilePath();
+            if (!fileSet.has(targetFile) || targetFile === src)
+                continue;
+            ensureNestedSet(outgoing, src, targetFile).add(declarationKey(declaration));
+            ensureNestedSet(incoming, targetFile, src).add(declarationKey(declaration));
+        }
+    }
+};
+//# sourceMappingURL=ts-de-01-precise-coupling.js.map

package/dist/signals/ts-de-01-precise-coupling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-de-01-precise-coupling.js","sourceRoot":"","sources":["../../src/signals/ts-de-01-precise-coupling.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAGhB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,6BAA6B,EAC7B,cAAc,EACd,gCAAgC,GACjC,MAAM,2BAA2B,CAAA;AAElC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,WAAsC,EACtC,eAAuB,EACT,EAAE;IAChB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAClF,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAE5D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,2BAA2B,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAA;AAC5E,CAAC,CAAA;AAED,MAAM,2BAA2B,GAAG,CAClC,UAAsB,EACtB,OAA4B,EAC5B,QAAuB,EACvB,QAAuB,EACjB,EAAE;IACR,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;IAEpC,KAAK,MAAM,SAAS,IAAI,6BAA6B,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,KAAK,MAAM,WAAW,IAAI,gCAAgC,CAAC,SAAS,CAAC,EAAE,CAAC;YACtE,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,CAAA;YAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,UAAU,KAAK,GAAG;gBAAE,SAAQ;YAE5D,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAA;YAC3E,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAA;QAC7E,CAAC;IACH,CAAC;AACH,CAAC,CAAA"}

package/dist/signals/ts-de-01-type-level-coupling.d.ts

@@ -0,0 +1,13 @@
+import type { Signal } from "@skastr0/pulsar-core/signal";
+import { Schema } from "effect";
+import { TsProjectTag } from "../ts-project.js";
+import type { TsDe01Output } from "./ts-de-01-coupling-output.js";
+declare const TsDe01Config: Schema.Struct<{
+    exclude_globs: Schema.Array$<typeof Schema.String>;
+    top_n_diagnostics: typeof Schema.Number;
+    precise_module_limit: typeof Schema.Number;
+}>;
+type TsDe01Config = typeof TsDe01Config.Type;
+export declare const TsDe01: Signal<TsDe01Config, TsDe01Output, TsProjectTag>;
+export {};
+//# sourceMappingURL=ts-de-01-type-level-coupling.d.ts.map

package/dist/signals/ts-de-01-type-level-coupling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-de-01-type-level-coupling.d.ts","sourceRoot":"","sources":["../../src/signals/ts-de-01-type-level-coupling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAA+C,MAAM,6BAA6B,CAAA;AAUlH,OAAO,EAAkB,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAI/C,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,+BAA+B,CAAA;AAEtC,QAAA,MAAM,YAAY;;;;EAIhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CA0FnE,CAAA"}