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

package/dist/model/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Shared dependency-model contracts.
+ *
+ * This module defines the data exchanged between collectors, the pure model
+ * engine, the manifest writer, and CLI reporting. It intentionally contains no
+ * filesystem or Yarn logic; callers should pass already collected facts.
+ */
+import type { PackageJson } from '../lib/package-json';
+export type SectionType = 'dependencies' | 'peerDependencies' | 'devDependencies';
+export type WorkspaceRole = 'library' | 'service' | 'cli';
+export interface DependencyRule {
+    match: string | string[];
+    workspace?: string | string[];
+    section?: SectionType;
+    version?: string;
+    rootOnly?: boolean;
+    required?: boolean;
+}
+export interface DependencyModelConfig {
+    version?: number;
+    rules?: DependencyRule[];
+    doctor?: DoctorConfig;
+}
+export interface DoctorConfig {
+    buildCmd?: string;
+    lintCmd?: string;
+    typecheckCmd?: string;
+}
+export interface DependencyModelOptions {
+    rootDir?: string;
+    constraintsPath?: string;
+    fix?: boolean;
+    withDts?: boolean;
+}
+export interface DependencyViolation {
+    code: 'root-private' | 'root-section' | 'role-missing' | 'role-invalid' | 'forbidden-section' | 'missing' | 'wrong-section' | 'wrong-range' | 'root-only' | 'root-only-usage' | 'unconstrained-version' | 'mirror' | 'stale' | 'dist-missing';
+    workspace: string;
+    workspaceLocation: string;
+    dependency?: string | undefined;
+    actualSection?: SectionType | undefined;
+    expectedSection?: SectionType | undefined;
+    actualRange?: string | undefined;
+    expectedRange?: string | undefined;
+    message: string;
+}
+export interface DependencyWarning {
+    code: 'bin-role-mismatch';
+    workspace?: string | undefined;
+    workspaceLocation?: string | undefined;
+    dependency?: string | undefined;
+    message: string;
+}
+export interface UsageSummary {
+    files: Set<string>;
+    runtimeFiles: Set<string>;
+    typeOnlyFiles: Set<string>;
+}
+export interface WorkspaceFacts {
+    name: string;
+    location: string;
+    pkg: PackageJson;
+    role: WorkspaceRole | undefined;
+    isRoot: boolean;
+    sourceUsage: Map<string, UsageSummary>;
+    dtsImports: Set<string>;
+    hasSrc: boolean;
+    hasDist: boolean;
+}
+export interface WorkspaceContext extends WorkspaceFacts {
+    dir: string;
+}
+export interface DependencyModelFacts {
+    workspaces: WorkspaceFacts[];
+    externalPeerMetadata: Map<string, Map<string, string> | null>;
+    externalTypeMetadata?: Map<string, {
+        hasBundledTypes: boolean;
+    }>;
+    typeProviderPackages?: Set<string>;
+    rules: DependencyRule[];
+    withDts?: boolean;
+}
+export interface DependencyModelOutput {
+    violations: DependencyViolation[];
+    warnings: DependencyWarning[];
+    expected: Map<string, ExpectedWorkspace>;
+}
+export interface DependencyModelResult {
+    rootDir: string;
+    violations: DependencyViolation[];
+    warnings: DependencyWarning[];
+    contexts: WorkspaceContext[];
+    expected: Map<string, ExpectedWorkspace>;
+    config: DependencyModelConfig;
+}
+export interface Reason {
+    kind: 'declared' | 'source-runtime' | 'source-public-type' | 'source-private-dev' | 'rule' | 'root-only' | 'dts-provider' | 'peer-propagation' | 'mirror' | 'version' | 'required-rule';
+    detail: string;
+}
+export interface ExpectedWorkspace {
+    workspace: WorkspaceFacts;
+    sections: Record<SectionType, Map<string, string>>;
+    reasons: Map<string, Reason[]>;
+}
+export interface EffectiveRule {
+    section?: SectionType;
+    version?: string;
+    rootOnly: boolean;
+    required?: boolean;
+}
+export interface PackageExtension {
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, {
+        optional?: boolean;
+    }>;
+}
+export declare const SECTIONS: SectionType[];

package/dist/model/types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SECTIONS = void 0;
+exports.SECTIONS = [
+    'dependencies',
+    'peerDependencies',
+    'devDependencies',
+];
+//# sourceMappingURL=types.js.map

package/dist/model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":";;;AA+Ja,QAAA,QAAQ,GAAkB;IACrC,cAAc;IACd,kBAAkB;IAClB,iBAAiB;CAClB,CAAC"}

package/dist/model/versions.d.ts

@@ -0,0 +1,3 @@
+import type { DependencyRule, DependencyViolation, ExpectedWorkspace, WorkspaceFacts } from './types';
+export declare function applyVersionRules(expectedByLocation: Map<string, ExpectedWorkspace>, root: WorkspaceFacts, workspaceNames: Set<string>, rules: DependencyRule[]): void;
+export declare function collectUnconstrainedVersionViolations(workspaces: WorkspaceFacts[], expectedByLocation: Map<string, ExpectedWorkspace>, rules: DependencyRule[]): DependencyViolation[];

package/dist/model/versions.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyVersionRules = applyVersionRules;
+exports.collectUnconstrainedVersionViolations = collectUnconstrainedVersionViolations;
+/**
+ * Version normalization and version-rule diagnostics.
+ *
+ * The placement engine decides where dependencies belong. This module applies
+ * version rules after placement and checks the invariant that repeated external
+ * dependencies have a global version rule.
+ */
+const expected_1 = require("./expected");
+const placement_1 = require("./placement");
+const rules_1 = require("./rules");
+const types_1 = require("./types");
+function applyVersionRules(expectedByLocation, root, workspaceNames, rules) {
+    for (const expected of expectedByLocation.values()) {
+        for (const section of types_1.SECTIONS) {
+            for (const [depIdent, range] of expected.sections[section]) {
+                const nextRange = (0, placement_1.resolveExpectedRangeAfterRulePass)(root, expected, workspaceNames, rules, depIdent, range);
+                if (nextRange !== range) {
+                    expected.sections[section].set(depIdent, nextRange);
+                    (0, expected_1.addReason)(expected, depIdent, {
+                        kind: 'version',
+                        detail: `${depIdent} range resolved to ${nextRange}`,
+                    });
+                }
+            }
+        }
+    }
+}
+function collectUnconstrainedVersionViolations(workspaces, expectedByLocation, rules) {
+    const workspaceNames = new Set(workspaces.filter((ws) => !ws.isRoot).map((ws) => ws.name));
+    const occurrences = new Map();
+    const ranges = new Map();
+    const addOccurrence = (workspace, section, depIdent, range) => {
+        if (!(0, placement_1.isExternal)(depIdent, workspaceNames) || range.startsWith('workspace:'))
+            return;
+        if (!occurrences.has(depIdent))
+            occurrences.set(depIdent, new Set());
+        if (!ranges.has(depIdent))
+            ranges.set(depIdent, new Set());
+        occurrences.get(depIdent).add(`${workspace.location}:${section}`);
+        ranges.get(depIdent).add(range);
+    };
+    for (const workspace of workspaces) {
+        for (const section of types_1.SECTIONS) {
+            for (const [depIdent, range] of Object.entries(workspace.pkg[section] ?? {})) {
+                addOccurrence(workspace, section, depIdent, range);
+            }
+        }
+    }
+    for (const expected of expectedByLocation.values()) {
+        for (const section of types_1.SECTIONS) {
+            for (const [depIdent, range] of expected.sections[section]) {
+                addOccurrence(expected.workspace, section, depIdent, range);
+            }
+        }
+    }
+    return [...occurrences.entries()]
+        .filter(([depIdent, byOccurrence]) => byOccurrence.size > 1 && !(0, rules_1.hasGlobalVersionRule)(rules, depIdent))
+        .map(([depIdent, byOccurrence]) => {
+        const rangeList = [...(ranges.get(depIdent) ?? [])].join(', ');
+        return {
+            code: 'unconstrained-version',
+            workspace: '<root>',
+            workspaceLocation: '.',
+            dependency: depIdent,
+            message: `${depIdent} appears ${byOccurrence.size} times without a global version rule (${rangeList})`,
+        };
+    });
+}
+//# sourceMappingURL=versions.js.map

package/dist/model/versions.js.map

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

package/dist/reporting.d.ts

@@ -0,0 +1,3 @@
+import type { DependencyModelResult } from './model/types';
+export declare function formatDependencyModelResult(result: DependencyModelResult): string;
+export declare function explainDependency(result: DependencyModelResult, workspaceSelector: string, depIdent: string): string;

package/dist/reporting.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDependencyModelResult = formatDependencyModelResult;
+exports.explainDependency = explainDependency;
+/**
+ * CLI-oriented dependency model reporting.
+ *
+ * The engine returns structured diagnostics and reason trails. This module
+ * turns them into stable human-readable text for `check`, `fix`, and `explain`.
+ */
+const expected_1 = require("./model/expected");
+const ansi_1 = require("./ansi");
+function formatDependencyModelResult(result) {
+    const lines = [];
+    for (const violation of result.violations) {
+        const dep = violation.dependency ? ` ${violation.dependency}` : '';
+        const location = violation.workspaceLocation === '.'
+            ? ''
+            : ` (${violation.workspaceLocation})`;
+        lines.push(`${ansi_1.ansi.red('✖')} ${ansi_1.ansi.bold(violation.workspace)}${ansi_1.ansi.dim(location)}${ansi_1.ansi.red(dep)}: ${violation.message}`);
+    }
+    for (const warning of result.warnings) {
+        const workspace = warning.workspace ? `${warning.workspace}: ` : '';
+        lines.push(`${ansi_1.ansi.yellow('⚠')} ${ansi_1.ansi.bold(workspace)}${warning.message}`);
+    }
+    if (result.violations.length === 0) {
+        lines.push(`${ansi_1.ansi.green('✓')} ${ansi_1.ansi.bold('dependency model is consistent')}`);
+    }
+    else {
+        lines.push(`${ansi_1.ansi.red('✖')} ${ansi_1.ansi.bold(`${result.violations.length} dependency model violation(s)`)}`);
+    }
+    if (result.warnings.length > 0) {
+        lines.push(`${ansi_1.ansi.yellow('⚠')} ${ansi_1.ansi.bold(`${result.warnings.length} warning(s)`)}`);
+    }
+    return lines.join('\n');
+}
+function explainDependency(result, workspaceSelector, depIdent) {
+    const workspace = result.contexts.find((ctx) => ctx.name === workspaceSelector ||
+        ctx.location === workspaceSelector ||
+        (workspaceSelector === '<root>' && ctx.isRoot));
+    if (!workspace) {
+        return `Workspace not found: ${workspaceSelector}`;
+    }
+    const expected = result.expected.get(workspace.location);
+    if (!expected) {
+        return `No dependency model data for workspace: ${workspaceSelector}`;
+    }
+    const actualSection = (0, expected_1.getDeclaredSection)(workspace.pkg, depIdent);
+    const actualRange = (0, expected_1.getDeclaredRange)(workspace.pkg, depIdent);
+    const expectedSection = (0, expected_1.getExpectedSection)(expected, depIdent);
+    const expectedRange = (0, expected_1.getExpectedRange)(expected, depIdent);
+    const reasons = expected.reasons.get(depIdent) ?? [];
+    const lines = [
+        `${ansi_1.ansi.bold(workspace.name)} ${ansi_1.ansi.dim(`(${workspace.location})`)}`,
+        ansi_1.ansi.cyan(depIdent),
+        `${ansi_1.ansi.bold('actual:')} ${actualSection ? `${ansi_1.ansi.yellow(actualSection)}@${actualRange}` : ansi_1.ansi.dim('not declared')}`,
+        `${ansi_1.ansi.bold('expected:')} ${expectedSection ? `${ansi_1.ansi.green(expectedSection)}@${expectedRange}` : ansi_1.ansi.dim('not required')}`,
+    ];
+    if (actualSection && !expectedSection) {
+        lines.push(`${ansi_1.ansi.bold('status:')} ${ansi_1.ansi.yellow('actual dependency is stale in the derived model')}`);
+    }
+    if (reasons.length > 0) {
+        lines.push(ansi_1.ansi.bold('reasons:'));
+        for (const reason of reasons) {
+            lines.push(`  - ${ansi_1.ansi.magenta(reason.kind)}: ${reason.detail}`);
+        }
+    }
+    const usage = workspace.sourceUsage.get(depIdent);
+    if (usage) {
+        lines.push(ansi_1.ansi.bold('source imports:'));
+        for (const file of [...usage.files].sort()) {
+            lines.push(`  - ${ansi_1.ansi.dim(file)}`);
+        }
+    }
+    if (workspace.dtsImports.has(depIdent)) {
+        lines.push(`${ansi_1.ansi.bold('public type surface:')} ${ansi_1.ansi.green('appears in dist/**/*.d.ts')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=reporting.js.map

package/dist/reporting.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,2 @@
+import type { DependencyModelOptions, DependencyModelResult } from './model/types';
+export declare function runDependencyModel(options?: DependencyModelOptions): DependencyModelResult;

package/dist/runner.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDependencyModel = runDependencyModel;
+/**
+ * Dependency model runner.
+ *
+ * The runner coordinates impure work: locating the repo root, collecting facts,
+ * iterating external metadata discovery, invoking the pure engine, and applying
+ * manifest fixes when requested.
+ */
+const config_1 = require("./collectors/config");
+const external_metadata_1 = require("./collectors/external-metadata");
+const package_extensions_1 = require("./collectors/package-extensions");
+const type_providers_1 = require("./collectors/type-providers");
+const workspaces_1 = require("./collectors/workspaces");
+const package_json_1 = require("./lib/package-json");
+const engine_1 = require("./model/engine");
+const manifest_writer_1 = require("./writer/manifest-writer");
+function runDependencyModel(options = {}) {
+    const rootDir = options.rootDir ?? (0, package_json_1.findMonorepoRoot)(process.cwd());
+    if (!rootDir) {
+        throw new Error('Unable to find monorepo root');
+    }
+    const config = (0, config_1.loadConfig)(rootDir, options.constraintsPath);
+    const rules = config.rules ?? [];
+    const withDts = options.withDts === true;
+    const contexts = (0, workspaces_1.loadWorkspaces)(rootDir, withDts);
+    const packageExtensions = (0, package_extensions_1.loadPackageExtensions)(rootDir);
+    const workspaceNames = new Set(contexts.filter((ws) => !ws.isRoot).map((ws) => ws.name));
+    const typeProviderPackages = (0, type_providers_1.collectTypeProviderPackages)(rootDir, contexts[0].pkg, rules);
+    const externalPeerMetadata = new Map();
+    const externalTypeMetadata = new Map();
+    const providerIdents = (0, external_metadata_1.collectExternalProviderIdents)(contexts, workspaceNames);
+    let output = null;
+    for (let pass = 0; pass < 10; pass++) {
+        (0, external_metadata_1.collectExternalMetadata)(rootDir, packageExtensions, providerIdents, externalPeerMetadata, externalTypeMetadata);
+        output = (0, engine_1.deriveDependencyModel)({
+            workspaces: contexts,
+            externalPeerMetadata,
+            externalTypeMetadata,
+            typeProviderPackages,
+            rules,
+            ...(withDts ? { withDts: true } : {}),
+        });
+        let changed = false;
+        for (const ident of (0, external_metadata_1.collectExternalProviderIdents)(contexts, workspaceNames, output.expected)) {
+            if (providerIdents.has(ident))
+                continue;
+            providerIdents.add(ident);
+            changed = true;
+        }
+        if (!changed)
+            break;
+    }
+    if (!output) {
+        throw new Error('Unable to derive dependency model');
+    }
+    if (options.fix && output.violations.length > 0) {
+        (0, manifest_writer_1.writeFixes)(rootDir, output.expected);
+    }
+    return {
+        rootDir,
+        violations: output.violations,
+        warnings: output.warnings,
+        contexts,
+        expected: output.expected,
+        config,
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":";;AAwBA,gDA6EC;AArGD;;;;;;GAMG;AACH,gDAAiD;AACjD,sEAGwC;AACxC,wEAAwE;AACxE,gEAA0E;AAC1E,wDAAyD;AACzD,qDAAsD;AACtD,2CAAuD;AAMvD,8DAAsD;AAEtD,SAAgB,kBAAkB,CAChC,UAAkC,EAAE;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAA,+BAAgB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAA,2BAAc,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,iBAAiB,GAAG,IAAA,0CAAqB,EAAC,OAAO,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CACzD,CAAC;IACF,MAAM,oBAAoB,GAAG,IAAA,4CAA2B,EACtD,OAAO,EACP,QAAQ,CAAC,CAAC,CAAE,CAAC,GAAG,EAChB,KAAK,CACN,CAAC;IACF,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC3E,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAwC,CAAC;IAC7E,MAAM,cAAc,GAAG,IAAA,iDAA6B,EAClD,QAAQ,EACR,cAAc,CACf,CAAC;IACF,IAAI,MAAM,GAAiC,IAAI,CAAC;IAEhD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,IAAA,2CAAuB,EACrB,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,CACrB,CAAC;QAEF,MAAM,GAAG,IAAA,8BAAqB,EAAC;YAC7B,UAAU,EAAE,QAAQ;YACpB,oBAAoB;YACpB,oBAAoB;YACpB,oBAAoB;YACpB,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,MAAM,KAAK,IAAI,IAAA,iDAA6B,EAC/C,QAAQ,EACR,cAAc,EACd,MAAM,CAAC,QAAQ,CAChB,EAAE,CAAC;YACF,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YACxC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,MAAM;IACtB,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAA,4BAAU,EAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,OAAO;QACP,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ;QACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/writer/manifest-writer.d.ts

@@ -0,0 +1,2 @@
+import type { ExpectedWorkspace } from '../model/types';
+export declare function writeFixes(rootDir: string, expectedByLocation: Map<string, ExpectedWorkspace>): void;

package/dist/writer/manifest-writer.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFixes = writeFixes;
+/**
+ * Manifest writer.
+ *
+ * The writer is the only module that mutates package.json files. It preserves
+ * unrelated fields, rewrites dependency sections from the expected graph, and
+ * skips writes when the normalized section content is unchanged.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const types_1 = require("../model/types");
+function sortedRecord(map) {
+    return Object.fromEntries([...map.entries()].sort(([a], [b]) => a.localeCompare(b)));
+}
+function recordsEqual(actual, expected) {
+    const actualEntries = Object.entries(actual ?? {}).sort(([a], [b]) => a.localeCompare(b));
+    const expectedEntries = [...expected.entries()].sort(([a], [b]) => a.localeCompare(b));
+    return JSON.stringify(actualEntries) === JSON.stringify(expectedEntries);
+}
+function peerDependenciesMetaEqual(actual, expected) {
+    const actualEntries = Object.entries(actual ?? {}).sort(([a], [b]) => a.localeCompare(b));
+    const expectedEntries = Object.entries(expected ?? {}).sort(([a], [b]) => a.localeCompare(b));
+    return JSON.stringify(actualEntries) === JSON.stringify(expectedEntries);
+}
+function prunePeerDependenciesMeta(pkg, expectedPeerDependencies) {
+    if (pkg.peerDependenciesMeta === undefined)
+        return false;
+    const nextMeta = Object.fromEntries(Object.entries(pkg.peerDependenciesMeta)
+        .filter(([depIdent]) => expectedPeerDependencies.has(depIdent))
+        .sort(([a], [b]) => a.localeCompare(b)));
+    if (Object.keys(nextMeta).length === 0) {
+        delete pkg.peerDependenciesMeta;
+        return true;
+    }
+    if (peerDependenciesMetaEqual(pkg.peerDependenciesMeta, nextMeta)) {
+        return false;
+    }
+    pkg.peerDependenciesMeta = nextMeta;
+    return true;
+}
+function writeFixes(rootDir, expectedByLocation) {
+    for (const expected of expectedByLocation.values()) {
+        const pkg = expected.workspace.pkg;
+        let changed = false;
+        for (const section of types_1.SECTIONS) {
+            if (expected.sections[section].size === 0) {
+                if (pkg[section] !== undefined) {
+                    delete pkg[section];
+                    changed = true;
+                }
+                continue;
+            }
+            if (!recordsEqual(pkg[section], expected.sections[section])) {
+                pkg[section] = sortedRecord(expected.sections[section]);
+                changed = true;
+            }
+        }
+        changed =
+            prunePeerDependenciesMeta(pkg, expected.sections.peerDependencies) ||
+                changed;
+        if (changed) {
+            const pkgPath = node_path_1.default.join(rootDir, expected.workspace.location, 'package.json');
+            (0, node_fs_1.writeFileSync)(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+        }
+    }
+}
+//# sourceMappingURL=manifest-writer.js.map

package/dist/writer/manifest-writer.js.map

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

package/eslint.config.cjs

@@ -0,0 +1,3 @@
+const rsdkEslint = require('@rsdk/eslint-plugin');
+
+module.exports = rsdkEslint.createConfig({ tsconfigRootDir: __dirname });

package/jest.config.js

@@ -0,0 +1 @@
+module.exports = require('@rsdk/jest/jest.config');

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@rsdk/yarn.constraints",
-  "version": "6.0.0-next.39",
+  "role": "cli",
+  "version": "6.0.0-next.40",
   "description": "Useful common classes, functions and types",
   "license": "Apache License 2.0",
   "publishConfig": {
@@ -10,9 +11,12 @@
     "url": "https://github.com/R-Vision/rsdk"
   },
   "main": "dist/index.js",
+  "bin": {
+    "depdoc": "dist/bin/depdoc.js"
+  },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.9",
+    "typescript": "5.7.3",
     "yaml": "^2.6.1"
   },
-  "gitHead": "5f69b147fc5e27544356c43087b313c4a7b34392"
+  "gitHead": "c220f82159e8e31cf90b2e4078e3570282d01021"
 }

package/src/ansi.ts

@@ -0,0 +1,23 @@
+/**
+ * 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: string, close: string, value: string): string {
+  return enabled ? `${open}${value}${close}` : value;
+}
+
+export const ansi = {
+  bold: (value: string): string => wrap('\u001B[1m', '\u001B[22m', value),
+  dim: (value: string): string => wrap('\u001B[2m', '\u001B[22m', value),
+  red: (value: string): string => wrap('\u001B[31m', '\u001B[39m', value),
+  green: (value: string): string => wrap('\u001B[32m', '\u001B[39m', value),
+  yellow: (value: string): string => wrap('\u001B[33m', '\u001B[39m', value),
+  cyan: (value: string): string => wrap('\u001B[36m', '\u001B[39m', value),
+  magenta: (value: string): string => wrap('\u001B[35m', '\u001B[39m', value),
+};