@rsdk/depdoc.cli 6.0.0-next.42 → 6.0.0-next.44

package/src/model/placement.ts

@@ -27,6 +27,20 @@ function isTestFile(file: string): boolean {
   );
 }
 
+// Build-tool config files (vite.config.ts, eslint.config.js, ...) import
+// real packages, but those imports are tooling usage, not the workspace's
+// own runtime surface — treat them like test files for placement purposes
+// so they don't get forced into dependencies/peerDependencies. Matched by
+// exact path against the workspace's collected tooling files (not by name
+// pattern), so an app module that merely happens to be named e.g.
+// src/auth.config.ts is never misclassified.
+function isPrivateUsageFile(
+  file: string,
+  toolingFiles: ReadonlySet<string>,
+): boolean {
+  return isTestFile(file) || toolingFiles.has(file);
+}
+
 export function isExternal(
   depIdent: string,
   workspaceNames: Set<string>,
@@ -215,9 +229,13 @@ export function addUsageDependencies(
     const workspace = expected.workspace;
     if (workspace.isRoot) continue;
 
+    const toolingFiles = workspace.toolingFiles ?? new Set<string>();
+
     for (const [depIdent, usage] of workspace.sourceUsage) {
       const publicType = workspace.dtsImports.has(depIdent);
-      const runtime = [...usage.runtimeFiles].some((file) => !isTestFile(file));
+      const runtime = [...usage.runtimeFiles].some(
+        (file) => !isPrivateUsageFile(file, toolingFiles),
+      );
       const allTestOnly = [...usage.files].every(isTestFile);
 
       if (runtime || publicType) {

package/src/model/types.ts

@@ -23,8 +23,18 @@ export interface DependencyRule {
   required?: boolean;
 }
 
+// Extra root-level filename patterns (beyond the built-in *.config.* suffix
+// convention) whose imports should be treated as tooling usage rather than
+// the workspace's own runtime surface, e.g. Docusaurus' sidebars.ts.
+export interface ToolingFileRule {
+  match: string | string[];
+  workspace?: string | string[];
+}
+
 export interface DependencyModelConfig {
   version?: number;
+  ignoredImports?: string[];
+  toolingFiles?: ToolingFileRule[];
   rules?: DependencyRule[];
   doctor?: DoctorConfig;
 }
@@ -55,6 +65,7 @@ export interface DependencyViolation {
     | 'root-only'
     | 'root-only-usage'
     | 'unconstrained-version'
+    | 'stale-rule'
     | 'mirror'
     | 'stale'
     | 'dist-missing';
@@ -93,6 +104,11 @@ export interface WorkspaceFacts {
   hasSrc: boolean;
   hasDist: boolean;
   sourceFileCount?: number;
+
+  // Absolute paths of build-tool config files (vite.config.ts, ...) collected
+  // for this workspace; their imports are tooling usage, not the workspace's
+  // own runtime surface. Optional so callers that predate this field compile.
+  toolingFiles?: Set<string>;
 }
 
 export interface WorkspaceContext extends WorkspaceFacts {

package/src/runner.ts

@@ -33,7 +33,12 @@ export function runDependencyModel(
   const config = loadConfig(rootDir, options.depdocYamlPath);
   const rules = config.rules ?? [];
   const withDts = options.withDts === true;
-  const contexts = loadWorkspaces(rootDir, withDts);
+  const contexts = loadWorkspaces(
+    rootDir,
+    withDts,
+    config.ignoredImports ?? [],
+    config.toolingFiles ?? [],
+  );
   const packageExtensions = loadPackageExtensions(rootDir);
   const workspaceNames = new Set(
     contexts.filter((ws) => !ws.isRoot).map((ws) => ws.name),