@ankhorage/devtools 1.0.5 → 1.0.6

package/README.md

@@ -16,7 +16,7 @@ Shared ESLint, Prettier, and Knip configuration for modern TypeScript projects.
 - Flat ESLint config (latest standard)
 - Preconfigured plugin ecosystem
 - Prettier integration
-- Shared Knip config factory
+- Shared Knip config factories
 - `ankhorage-eslint`, `ankhorage-prettier`, and `ankhorage-knip` binaries
 - Monorepo-friendly
 
@@ -98,7 +98,41 @@ export default createKnipConfig({
 });
 ```
 
-The shared config intentionally keeps defaults narrow so Knip can use its own zero-config package discovery. Prefer explicit `entry`, `project`, `ignoreBinaries`, `ignoreDependencies`, or `ignoreFiles` over broad ignores.
+For workspaces-based monorepos, use the monorepo preset:
+
+```ts
+import { createKnipMonorepoConfig } from '@ankhorage/devtools/knip';
+
+export default createKnipMonorepoConfig({
+  root: {
+    ignoreFiles: ['.prettierrc.js', 'eslint.config.js'],
+  },
+});
+```
+
+By default, the monorepo preset configures Knip workspaces for the root package, `packages/*`, and `apps/*`. Repos can override those defaults or add extra workspace globs:
+
+```ts
+import { createKnipMonorepoConfig } from '@ankhorage/devtools/knip';
+
+export default createKnipMonorepoConfig({
+  workspaceGlobs: ['packages/*', 'apps/*', 'examples/*'],
+  workspaceDefaults: {
+    ignoreFiles: ['fixtures/**'],
+  },
+  workspaces: {
+    '.': {
+      ignoreFiles: ['.prettierrc.js', 'eslint.config.js'],
+    },
+    'apps/editor': {
+      ignoreFiles: ['babel.config.js'],
+      ignoreDependencies: ['babel-preset-expo'],
+    },
+  },
+});
+```
+
+The shared config intentionally keeps defaults narrow so Knip can still report real unused files, exports, dependencies, and binaries. Prefer explicit `entry`, `project`, `ignoreBinaries`, `ignoreDependencies`, or `ignoreFiles` over broad ignores.
 
 ### CI
 

package/dist/knip.d.ts

@@ -10,4 +10,11 @@ export interface DevtoolsKnipWorkspaceConfigOptions {
 export interface DevtoolsKnipConfigOptions extends DevtoolsKnipWorkspaceConfigOptions {
     workspaces?: Record<string, DevtoolsKnipWorkspaceConfigOptions>;
 }
+export interface DevtoolsKnipMonorepoConfigOptions {
+    root?: DevtoolsKnipWorkspaceConfigOptions;
+    workspaceDefaults?: DevtoolsKnipWorkspaceConfigOptions;
+    workspaceGlobs?: string[];
+    workspaces?: Record<string, DevtoolsKnipWorkspaceConfigOptions>;
+}
 export declare function createKnipConfig(options?: DevtoolsKnipConfigOptions): KnipConfig;
+export declare function createKnipMonorepoConfig(options?: DevtoolsKnipMonorepoConfigOptions): KnipConfig;

package/dist/knip.js

@@ -1,3 +1,4 @@
+const DEFAULT_MONOREPO_WORKSPACE_GLOBS = ['packages/*', 'apps/*'];
 export function createKnipConfig(options = {}) {
     return {
         ...(options.entry === undefined ? {} : { entry: options.entry }),
@@ -11,3 +12,20 @@ export function createKnipConfig(options = {}) {
         ...(options.workspaces === undefined ? {} : { workspaces: options.workspaces }),
     };
 }
+export function createKnipMonorepoConfig(options = {}) {
+    const explicitWorkspaces = options.workspaces ?? {};
+    const workspaceGlobs = options.workspaceGlobs ?? [...DEFAULT_MONOREPO_WORKSPACE_GLOBS];
+    const workspaces = {
+        '.': options.root ?? {},
+    };
+    for (const workspaceGlob of workspaceGlobs) {
+        workspaces[workspaceGlob] = {
+            ...(options.workspaceDefaults ?? {}),
+            ...(explicitWorkspaces[workspaceGlob] ?? {}),
+        };
+    }
+    for (const [workspaceGlob, workspaceConfig] of Object.entries(explicitWorkspaces)) {
+        workspaces[workspaceGlob] = workspaceConfig;
+    }
+    return createKnipConfig({ workspaces });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Shared Lint and Format Configuration for Ankhorage",
   "homepage": "https://github.com/ankhorage/devtools#readme",
   "bugs": {