@rsdk/yarn.constraints 6.0.0-next.39 → 6.0.0-next.40

package/__tests__/fixtures/imports/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const bin = require('bin-entry-dep');
+
+bin();

package/__tests__/fixtures/imports/export-entry.mjs

@@ -0,0 +1 @@
+export { exported } from 'exports-entry-dep';

package/__tests__/fixtures/imports/root-entry.js

@@ -0,0 +1,3 @@
+import rootEntry from 'root-entry-dep';
+
+export default rootEntry;

package/__tests__/fixtures/imports/src/common.cjs

@@ -0,0 +1,3 @@
+const cjs = require('cjs-dep');
+
+module.exports = cjs;

package/__tests__/fixtures/imports/src/common.cts

@@ -0,0 +1,3 @@
+const cjs = require('cts-dep');
+
+export = cjs;

package/__tests__/fixtures/imports/src/component.tsx

@@ -0,0 +1,4 @@
+import { jsxRuntime } from 'tsx-runtime-dep';
+import { type ComponentProps } from 'tsx-type-dep';
+
+export const component = jsxRuntime<ComponentProps>;

package/__tests__/fixtures/imports/src/index.ts

@@ -0,0 +1,13 @@
+import { foo } from 'lodash';
+import type { Bar } from 'some-types';
+import { value, type MixedType } from 'mixed-dep';
+import { type OnlyType } from 'only-type-dep';
+import { baz } from '@scope/pkg/subpath';
+import { qux } from './local';
+import { built } from 'node:fs';
+export { reexported } from 'reexport-dep';
+export type { ReexportedType } from 'reexport-type-dep';
+const ignoredComment = "import ignored from 'string-dep'";
+// import ignored from 'comment-dep';
+const x = require('require-dep');
+const y = await import('dynamic-dep');

package/__tests__/fixtures/imports/src/module.mjs

@@ -0,0 +1,3 @@
+import mjs from 'mjs-dep';
+
+export default mjs;

package/__tests__/fixtures/imports/src/module.mts

@@ -0,0 +1,3 @@
+import { esm } from 'mts-dep';
+
+export const value = esm;

package/__tests__/fixtures/imports/src/plain.js

@@ -0,0 +1,3 @@
+const js = require('js-dep');
+
+module.exports = js;

package/__tests__/fixtures/imports/src/test-only-usage.ts

@@ -0,0 +1 @@
+import { runtime } from 'test-only-dep';

package/__tests__/imports.test.ts

@@ -0,0 +1,206 @@
+import path from 'node:path';
+
+import {
+  collectDtsImports,
+  collectSourceImports,
+  getPackageName,
+} from '../src/lib/imports';
+
+const FIXTURES = path.join(__dirname, 'fixtures/imports');
+
+// ---------------------------------------------------------------------------
+// getPackageName
+// ---------------------------------------------------------------------------
+
+describe('getPackageName', () => {
+  it('returns null for relative specifiers', () => {
+    expect(getPackageName('./local')).toBeNull();
+    expect(getPackageName('../parent')).toBeNull();
+    expect(getPackageName('/absolute')).toBeNull();
+  });
+
+  it('returns null for node: builtins', () => {
+    expect(getPackageName('node:fs')).toBeNull();
+    expect(getPackageName('node:path')).toBeNull();
+    expect(getPackageName('fs')).toBeNull();
+    expect(getPackageName('path')).toBeNull();
+  });
+
+  it('returns package name for bare specifiers', () => {
+    expect(getPackageName('lodash')).toBe('lodash');
+    expect(getPackageName('express')).toBe('express');
+  });
+
+  it('strips subpath from unscoped packages', () => {
+    expect(getPackageName('lodash/fp')).toBe('lodash');
+    expect(getPackageName('some-pkg/nested/deep')).toBe('some-pkg');
+  });
+
+  it('returns scoped package name', () => {
+    expect(getPackageName('@scope/pkg')).toBe('@scope/pkg');
+  });
+
+  it('strips subpath from scoped packages', () => {
+    expect(getPackageName('@scope/pkg/subpath')).toBe('@scope/pkg');
+    expect(getPackageName('@scope/pkg/deep/nested')).toBe('@scope/pkg');
+  });
+
+  it('returns null for malformed scoped specifier without package name', () => {
+    expect(getPackageName('@scope')).toBeNull();
+  });
+});
+
+// ---------------------------------------------------------------------------
+// collectSourceImports
+// ---------------------------------------------------------------------------
+
+describe('collectSourceImports', () => {
+  const srcDir = path.join(FIXTURES, 'src');
+  let entries: ReturnType<typeof collectSourceImports>;
+
+  beforeAll(() => {
+    entries = collectSourceImports(srcDir);
+  });
+
+  function names(): Set<string> {
+    return new Set(entries.map((e) => e.packageName));
+  }
+
+  it('collects runtime imports', () => {
+    const pkgs = names();
+    expect(pkgs.has('lodash')).toBe(true);
+    expect(pkgs.has('@scope/pkg')).toBe(true);
+    expect(pkgs.has('mixed-dep')).toBe(true);
+    expect(pkgs.has('require-dep')).toBe(true);
+    expect(pkgs.has('dynamic-dep')).toBe(true);
+    expect(pkgs.has('reexport-dep')).toBe(true);
+  });
+
+  it('marks import type entries as isTypeOnly', () => {
+    const typeOnlyEntry = entries.find((e) => e.packageName === 'some-types');
+    expect(typeOnlyEntry).toBeDefined();
+    expect(typeOnlyEntry!.isTypeOnly).toBe(true);
+  });
+
+  it('marks export type entries as isTypeOnly', () => {
+    const entry = entries.find((e) => e.packageName === 'reexport-type-dep');
+    expect(entry).toBeDefined();
+    expect(entry!.isTypeOnly).toBe(true);
+  });
+
+  it('marks import specifiers with only type bindings as isTypeOnly', () => {
+    const entry = entries.find((e) => e.packageName === 'only-type-dep');
+    expect(entry).toBeDefined();
+    expect(entry!.isTypeOnly).toBe(true);
+  });
+
+  it('treats mixed value and type specifiers as runtime imports', () => {
+    const entry = entries.find((e) => e.packageName === 'mixed-dep');
+    expect(entry).toBeDefined();
+    expect(entry!.isTypeOnly).toBe(false);
+  });
+
+  it('marks runtime imports as not isTypeOnly', () => {
+    const entry = entries.find((e) => e.packageName === 'lodash');
+    expect(entry).toBeDefined();
+    expect(entry!.isTypeOnly).toBe(false);
+  });
+
+  it('does not include relative imports', () => {
+    expect(names().has('./local')).toBe(false);
+  });
+
+  it('does not include node: builtins', () => {
+    expect(names().has('node:fs')).toBe(false);
+    expect(names().has('fs')).toBe(false);
+  });
+
+  it('ignores import-like text inside comments and strings', () => {
+    expect(names().has('comment-dep')).toBe(false);
+    expect(names().has('string-dep')).toBe(false);
+  });
+
+  it('includes the file path in each entry', () => {
+    const entry = entries.find((e) => e.packageName === 'lodash');
+    expect(entry!.file).toContain('index.ts');
+  });
+
+  it('collects imports from test files as well', () => {
+    expect(names().has('test-only-dep')).toBe(true);
+  });
+
+  it('collects supported source extensions', () => {
+    const pkgs = names();
+    expect(pkgs.has('tsx-runtime-dep')).toBe(true);
+    expect(pkgs.has('tsx-type-dep')).toBe(true);
+    expect(pkgs.has('mts-dep')).toBe(true);
+    expect(pkgs.has('cts-dep')).toBe(true);
+    expect(pkgs.has('js-dep')).toBe(true);
+    expect(pkgs.has('mjs-dep')).toBe(true);
+    expect(pkgs.has('cjs-dep')).toBe(true);
+  });
+
+  it('collects package main, bin, and exports entrypoints inside the workspace', () => {
+    const workspaceEntries = collectSourceImports(FIXTURES, {
+      name: '@test/imports',
+      main: 'root-entry.js',
+      bin: {
+        imports: 'bin.js',
+      },
+      exports: {
+        '.': './export-entry.mjs',
+        './dist': './dist/index.js',
+      },
+    });
+    const pkgs = new Set(workspaceEntries.map((e) => e.packageName));
+
+    expect(pkgs.has('root-entry-dep')).toBe(true);
+    expect(pkgs.has('bin-entry-dep')).toBe(true);
+    expect(pkgs.has('exports-entry-dep')).toBe(true);
+  });
+
+  it('does not collect .d.ts files (only .ts source files)', () => {
+    // dist/ is a sibling of src/, not inside it — so even if we somehow
+    // end up scanning it, .d.ts files are explicitly excluded.
+    const dtsEntry = entries.find((e) => e.file.endsWith('.d.ts'));
+    expect(dtsEntry).toBeUndefined();
+  });
+});
+
+// ---------------------------------------------------------------------------
+// collectDtsImports
+// ---------------------------------------------------------------------------
+
+describe('collectDtsImports', () => {
+  const distDir = path.join(FIXTURES, 'dist');
+  let result: Set<string>;
+
+  beforeAll(() => {
+    result = collectDtsImports(distDir);
+  });
+
+  it('collects packages from import type in dts', () => {
+    expect(result.has('some-types')).toBe(true);
+  });
+
+  it('collects packages from inline import() expressions in dts', () => {
+    expect(result.has('public-type-dep')).toBe(true);
+  });
+
+  it('collects packages from export declarations in dts', () => {
+    expect(result.has('dts-export-type-dep')).toBe(true);
+    expect(result.has('dts-export-runtime-dep')).toBe(true);
+  });
+
+  it('collects packages from triple-slash types in dts', () => {
+    expect(result.has('ambient-types')).toBe(true);
+  });
+
+  it('collects packages from ambient module declarations in dts', () => {
+    expect(result.has('ambient-module-dep')).toBe(true);
+  });
+
+  it('returns a set (no duplicates)', () => {
+    expect(result).toBeInstanceOf(Set);
+  });
+});

package/__tests__/manifest-writer.test.ts

@@ -0,0 +1,157 @@
+import {
+  mkdirSync,
+  mkdtempSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+} from 'node:fs';
+import { tmpdir } from 'node:os';
+import { resolve } from 'node:path';
+
+import { writeFixes } from '../src/writer/manifest-writer';
+import type {
+  ExpectedWorkspace,
+  WorkspaceFacts,
+} from '../src/dependency-model';
+
+function makeWorkspace(
+  location: string,
+  pkg: WorkspaceFacts['pkg'],
+): WorkspaceFacts {
+  return {
+    name: pkg.name,
+    location,
+    pkg,
+    role: pkg.role,
+    isRoot: false,
+    sourceUsage: new Map(),
+    dtsImports: new Set(),
+    hasSrc: false,
+    hasDist: false,
+  };
+}
+
+function makeExpected(
+  location: string,
+  pkg: WorkspaceFacts['pkg'],
+  sections: ExpectedWorkspace['sections'],
+): ExpectedWorkspace {
+  return {
+    workspace: makeWorkspace(location, pkg),
+    sections,
+    reasons: new Map(),
+  };
+}
+
+function makeSections(
+  sections: Partial<
+    Record<keyof ExpectedWorkspace['sections'], [string, string][]>
+  >,
+): ExpectedWorkspace['sections'] {
+  return {
+    dependencies: new Map(sections.dependencies ?? []),
+    peerDependencies: new Map(sections.peerDependencies ?? []),
+    devDependencies: new Map(sections.devDependencies ?? []),
+  };
+}
+
+function createPackageJson(
+  rootDir: string,
+  location: string,
+  pkg: WorkspaceFacts['pkg'],
+): void {
+  const dir = resolve(rootDir, location);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(
+    resolve(dir, 'package.json'),
+    JSON.stringify(pkg, null, 2) + '\n',
+  );
+}
+
+function readPackageJson(
+  rootDir: string,
+  location: string,
+): WorkspaceFacts['pkg'] {
+  return JSON.parse(
+    readFileSync(resolve(rootDir, location, 'package.json'), 'utf8'),
+  ) as WorkspaceFacts['pkg'];
+}
+
+describe('manifest writer', () => {
+  let rootDir: string;
+
+  beforeEach(() => {
+    rootDir = mkdtempSync(resolve(tmpdir(), 'rsdk-manifest-writer-'));
+  });
+
+  afterEach(() => {
+    rmSync(rootDir, { recursive: true, force: true });
+  });
+
+  it('removes peerDependenciesMeta when no expected peers remain', () => {
+    const location = 'packages/lib';
+    const pkg: WorkspaceFacts['pkg'] = {
+      name: '@test/lib',
+      role: 'library',
+      dependencies: { 'some-lib': '1.0.0' },
+      peerDependenciesMeta: { 'some-lib': { optional: true } },
+    };
+    createPackageJson(rootDir, location, pkg);
+
+    writeFixes(
+      rootDir,
+      new Map([
+        [
+          location,
+          makeExpected(
+            location,
+            pkg,
+            makeSections({
+              dependencies: [['some-lib', '1.0.0']],
+            }),
+          ),
+        ],
+      ]),
+    );
+
+    expect(
+      readPackageJson(rootDir, location).peerDependenciesMeta,
+    ).toBeUndefined();
+  });
+
+  it('keeps peerDependenciesMeta only for expected peers', () => {
+    const location = 'packages/lib';
+    const pkg: WorkspaceFacts['pkg'] = {
+      name: '@test/lib',
+      role: 'library',
+      peerDependencies: { react: '^18.0.0' },
+      peerDependenciesMeta: {
+        react: { optional: true },
+        'old-peer': { optional: true },
+      },
+      devDependencies: { react: '^18.0.0' },
+    };
+    createPackageJson(rootDir, location, pkg);
+
+    writeFixes(
+      rootDir,
+      new Map([
+        [
+          location,
+          makeExpected(
+            location,
+            pkg,
+            makeSections({
+              peerDependencies: [['react', '^18.0.0']],
+              devDependencies: [['react', '^18.0.0']],
+            }),
+          ),
+        ],
+      ]),
+    );
+
+    expect(readPackageJson(rootDir, location).peerDependenciesMeta).toEqual({
+      react: { optional: true },
+    });
+  });
+});

package/dist/ansi.d.ts

@@ -0,0 +1,9 @@
+export declare const ansi: {
+    bold: (value: string) => string;
+    dim: (value: string) => string;
+    red: (value: string) => string;
+    green: (value: string) => string;
+    yellow: (value: string) => string;
+    cyan: (value: string) => string;
+    magenta: (value: string) => string;
+};

package/dist/ansi.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ansi = void 0;
+/**
+ * Shared ANSI styling helpers for CLI output.
+ *
+ * Keep terminal escape codes centralized here so command/reporting modules can
+ * add restrained color without duplicating formatting details or hard-coding
+ * ANSI sequences throughout the codebase.
+ */
+const enabled = process.env.NO_COLOR === undefined && process.env.FORCE_COLOR !== '0';
+function wrap(open, close, value) {
+    return enabled ? `${open}${value}${close}` : value;
+}
+exports.ansi = {
+    bold: (value) => wrap('\u001B[1m', '\u001B[22m', value),
+    dim: (value) => wrap('\u001B[2m', '\u001B[22m', value),
+    red: (value) => wrap('\u001B[31m', '\u001B[39m', value),
+    green: (value) => wrap('\u001B[32m', '\u001B[39m', value),
+    yellow: (value) => wrap('\u001B[33m', '\u001B[39m', value),
+    cyan: (value) => wrap('\u001B[36m', '\u001B[39m', value),
+    magenta: (value) => wrap('\u001B[35m', '\u001B[39m', value),
+};
+//# sourceMappingURL=ansi.js.map

package/dist/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC;AAExE,SAAS,IAAI,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa;IACtD,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC;AAEY,QAAA,IAAI,GAAG;IAClB,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC;IACvE,GAAG,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC;IACtE,GAAG,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC;IACvE,KAAK,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC;IACzE,MAAM,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC;IAC1E,IAAI,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC;IACxE,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC;CAC5E,CAAC"}

package/dist/bin/depdoc.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/depdoc.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `depdoc` command-line entrypoint.
+ *
+ * The CLI only parses commands and orchestrates high-level steps. Dependency
+ * placement decisions live in the model engine, while filesystem collection and
+ * manifest writes go through the runner.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const ansi_1 = require("../ansi");
+const dependency_model_1 = require("../dependency-model");
+function printUsage() {
+    console.error(`${ansi_1.ansi.bold('Usage:')}
+  ${ansi_1.ansi.cyan('depdoc')} check [--with-dts]
+  ${ansi_1.ansi.cyan('depdoc')} fix [--with-dts]
+  ${ansi_1.ansi.cyan('depdoc')} explain <workspace> <dependency>
+  ${ansi_1.ansi.cyan('depdoc')} doctor`);
+}
+function spawnStep(label, cmd, cwd) {
+    console.error(`\n${ansi_1.ansi.cyan('──')} ${ansi_1.ansi.bold(label)}`);
+    console.error(`${ansi_1.ansi.dim('$')} ${ansi_1.ansi.cyan(cmd)}`);
+    (0, node_child_process_1.execSync)(cmd, { cwd, stdio: 'inherit' });
+}
+function checkPeerRequirements(cwd) {
+    const cmd = 'yarn explain peer-requirements';
+    console.error(`\n${ansi_1.ansi.cyan('──')} ${ansi_1.ansi.bold('yarn peer requirements')}`);
+    console.error(`${ansi_1.ansi.dim('$')} ${ansi_1.ansi.cyan(cmd)}`);
+    let output;
+    try {
+        output = (0, node_child_process_1.execSync)(cmd, {
+            cwd,
+            encoding: 'utf8',
+            maxBuffer: 32 * 1024 * 1024,
+        });
+    }
+    catch (error) {
+        const childError = error;
+        if (childError.stdout)
+            process.stderr.write(childError.stdout);
+        if (childError.stderr)
+            process.stderr.write(childError.stderr);
+        return false;
+    }
+    const failedRequirements = output
+        .split(/\r?\n/)
+        .filter((line) => line.includes('✘'));
+    if (failedRequirements.length === 0) {
+        console.error(ansi_1.ansi.green('✓ peer requirements are satisfied'));
+        return true;
+    }
+    console.error(failedRequirements.join('\n'));
+    console.error(ansi_1.ansi.red(`${failedRequirements.length} peer requirement(s) failed`));
+    console.error(ansi_1.ansi.dim('Run `yarn explain peer-requirements <hash>` for details.'));
+    return false;
+}
+function snapshotPackageJsons(result) {
+    return [...result.expected.keys()]
+        .sort()
+        .map((location) => (0, node_fs_1.readFileSync)(node_path_1.default.join(result.rootDir, location, 'package.json'), 'utf8'))
+        .join('\0');
+}
+function main() {
+    const rawArgs = process.argv.slice(2);
+    if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
+        printUsage();
+        process.exit(0);
+    }
+    const positional = rawArgs.filter((a) => !a.startsWith('--'));
+    const [command, firstArg, secondArg] = positional;
+    const withDts = rawArgs.includes('--with-dts');
+    if (!command) {
+        printUsage();
+        process.exit(1);
+    }
+    if (command === 'check') {
+        const result = (0, dependency_model_1.runDependencyModel)({ withDts });
+        console.error((0, dependency_model_1.formatDependencyModelResult)(result));
+        process.exit(result.violations.length === 0 ? 0 : 1);
+    }
+    if (command === 'fix') {
+        const before = (0, dependency_model_1.runDependencyModel)({ fix: true, withDts });
+        const after = (0, dependency_model_1.runDependencyModel)({ withDts });
+        const fixed = Math.max(0, before.violations.length - after.violations.length);
+        console.error((0, dependency_model_1.formatDependencyModelResult)(after));
+        if (fixed > 0) {
+            console.error(ansi_1.ansi.green(`fixed ${fixed} dependency model violation(s)`));
+        }
+        process.exit(after.violations.length === 0 ? 0 : 1);
+    }
+    if (command === 'explain') {
+        if (!firstArg || !secondArg) {
+            printUsage();
+            process.exit(1);
+        }
+        const result = (0, dependency_model_1.runDependencyModel)();
+        console.log((0, dependency_model_1.explainDependency)(result, firstArg, secondArg));
+        process.exit(0);
+    }
+    if (command === 'doctor') {
+        runDoctor();
+        return;
+    }
+    printUsage();
+    process.exit(1);
+}
+function runDoctor() {
+    console.error(`\n${ansi_1.ansi.cyan('──')} ${ansi_1.ansi.bold('depdoc fix')}`);
+    const fixResult = (0, dependency_model_1.runDependencyModel)({ fix: true });
+    const afterFix = (0, dependency_model_1.runDependencyModel)();
+    const fixed = Math.max(0, fixResult.violations.length - afterFix.violations.length);
+    console.error((0, dependency_model_1.formatDependencyModelResult)(afterFix));
+    if (fixed > 0)
+        console.error(ansi_1.ansi.green(`fixed ${fixed} violation(s)`));
+    const { rootDir, config } = afterFix;
+    spawnStep('yarn install', 'yarn install', rootDir);
+    if (config.doctor?.buildCmd) {
+        spawnStep('build', config.doctor.buildCmd, rootDir);
+    }
+    else {
+        console.error(`\n${ansi_1.ansi.cyan('──')} ${ansi_1.ansi.yellow('build skipped')} ${ansi_1.ansi.dim('(doctor.buildCmd not configured in .constraints.yml)')}`);
+    }
+    const beforeDtsFixSnapshot = snapshotPackageJsons(afterFix);
+    console.error(`\n${ansi_1.ansi.cyan('──')} ${ansi_1.ansi.bold('depdoc fix --with-dts')}`);
+    const dtsFix = (0, dependency_model_1.runDependencyModel)({ fix: true, withDts: true });
+    const afterDtsFix = (0, dependency_model_1.runDependencyModel)({ withDts: true });
+    const afterDtsFixSnapshot = snapshotPackageJsons(afterDtsFix);
+    const dtsFixed = Math.max(0, dtsFix.violations.length - afterDtsFix.violations.length);
+    console.error((0, dependency_model_1.formatDependencyModelResult)(afterDtsFix));
+    if (dtsFixed > 0) {
+        console.error(ansi_1.ansi.green(`fixed ${dtsFixed} additional violation(s) from .d.ts surface`));
+    }
+    if (beforeDtsFixSnapshot !== afterDtsFixSnapshot) {
+        spawnStep('yarn install (post-dts-fix)', 'yarn install', rootDir);
+    }
+    if (!checkPeerRequirements(rootDir))
+        process.exit(1);
+    if (config.doctor?.lintCmd) {
+        spawnStep('lint', config.doctor.lintCmd, rootDir);
+    }
+    if (config.doctor?.typecheckCmd) {
+        spawnStep('typecheck', config.doctor.typecheckCmd, rootDir);
+    }
+    const finalViolations = afterDtsFix.violations.length;
+    console.error(finalViolations === 0
+        ? `\n${ansi_1.ansi.green('✓')} ${ansi_1.ansi.bold('doctor: all checks passed')}`
+        : `\n${ansi_1.ansi.red('✖')} ${ansi_1.ansi.bold(`doctor: ${finalViolations} violation(s) remain`)}`);
+    process.exit(finalViolations === 0 ? 0 : 1);
+}
+main();
+//# sourceMappingURL=depdoc.js.map

package/dist/bin/depdoc.js.map

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

package/dist/collectors/config.d.ts

@@ -0,0 +1,2 @@
+import type { DependencyModelConfig } from '../model/types';
+export declare function loadConfig(rootDir: string, constraintsPath?: string): DependencyModelConfig;

package/dist/collectors/config.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+/**
+ * Constraints configuration collector.
+ *
+ * This module is the only place that resolves and parses `.constraints.yml`.
+ * It returns raw model configuration; rule semantics are handled later by the
+ * pure model layer.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = __importDefault(require("yaml"));
+function loadConfig(rootDir, constraintsPath) {
+    const filepath = constraintsPath ??
+        process.env.RSDK_YARN_CONSTRAINTS_CFG ??
+        node_path_1.default.join(rootDir, '.rsdk/.constraints.yml');
+    if (!(0, node_fs_1.existsSync)(filepath))
+        return { rules: [] };
+    return yaml_1.default.parse((0, node_fs_1.readFileSync)(filepath, 'utf8'));
+}
+//# sourceMappingURL=config.js.map