@ankhorage/devtools 2.0.18 → 2.0.20

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.18](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.20](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects
 
@@ -77,6 +77,7 @@ export default defineParadoxConfig({
 - [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
 - [Module relationships](././paradox/diagrams/module-relationships.mmd)
 - [Export graph](././paradox/diagrams/export-graph.mmd)
+- [createKnipConfig sequence](././paradox/diagrams/sequences/create-knip-config.mmd)
 - [createKnipMonorepoConfig sequence](././paradox/diagrams/sequences/create-knip-monorepo-config.mmd)
 
 ## Public API

package/dist/constants/eslint.d.ts

@@ -0,0 +1 @@
+export declare const EXAMPLES_ESLINT_OWNERSHIP_MARKER = "// This file is managed by @ankhorage/devtools.\n";

package/dist/constants/eslint.js

@@ -0,0 +1 @@
+export const EXAMPLES_ESLINT_OWNERSHIP_MARKER = '// This file is managed by @ankhorage/devtools.\n';

package/dist/tools/eslint/managed.js

@@ -1,5 +1,6 @@
 import { readdir, readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
+import { EXAMPLES_ESLINT_OWNERSHIP_MARKER } from '../../constants/eslint.js';
 const ESLINT_CONFIG = `import { createConfig } from '@ankhorage/devtools/eslint';
 import localConfig from './eslint.local.config.mjs';
 
@@ -16,7 +17,6 @@ export default [
 `;
 const EMPTY_LOCAL_CONFIG = `export default [];
 `;
-const EXAMPLES_OWNERSHIP_MARKER = '// This file is managed by @ankhorage/devtools.\n';
 const IGNORED_EXAMPLE_DIRECTORY_NAMES = new Set([
     '.expo',
     '.next',
@@ -28,7 +28,7 @@ const IGNORED_EXAMPLE_DIRECTORY_NAMES = new Set([
     'node_modules',
     'templates',
 ]);
-const ESLINT_EXAMPLES_CONFIG = `${EXAMPLES_OWNERSHIP_MARKER}import { existsSync } from 'node:fs';
+const ESLINT_EXAMPLES_CONFIG = `${EXAMPLES_ESLINT_OWNERSHIP_MARKER}import { existsSync } from 'node:fs';
 
 import { createConfig } from '@ankhorage/devtools/eslint';
 import localConfig from './eslint.local.config.mjs';
@@ -114,7 +114,7 @@ async function assertExamplesConfigOwnershipAsync(targetDirectory) {
             return;
         throw error;
     }
-    if (!contents.startsWith(EXAMPLES_OWNERSHIP_MARKER)) {
+    if (!contents.startsWith(EXAMPLES_ESLINT_OWNERSHIP_MARKER)) {
         throw new Error('Cannot replace consumer-owned eslint.examples.config.mjs. ' +
             'Move its repository-specific overrides into eslint.local.config.mjs, keeping their ' +
             'examples file scope and preserving existing local entries. Then remove the old examples ' +

package/dist/tools/knip/index.d.ts

@@ -1,15 +1,3 @@
-/***
- * Build shared Knip configuration while preserving repository-specific discovery.
- *
- * `createKnipConfig` keeps Knip zero-config discovery. Repositories can add narrow entries, project globs, ignored files,
- * binaries, dependencies, and workspace overrides without duplicating the shared Knip version.
- *
- * `createKnipMonorepoConfig` adds a root workspace plus conventional `packages/*` and `apps/*`
- * workspace globs. Callers can override those globs, provide workspace defaults, and replace or
- * extend individual workspace configuration deterministically.
- *
- * @readme
- */
 import type { KnipConfig } from 'knip';
 export interface DevtoolsKnipWorkspaceConfigOptions {
     readonly entry?: string[];

package/dist/tools/knip/index.js

@@ -1,6 +1,25 @@
+/***
+ * Build shared Knip configuration while preserving repository-specific discovery.
+ *
+ * `createKnipConfig` keeps Knip zero-config discovery. Repositories can add narrow entries, project globs, ignored files,
+ * binaries, dependencies, and workspace overrides without duplicating the shared Knip version.
+ *
+ * `createKnipMonorepoConfig` adds a root workspace plus conventional `packages/*` and `apps/*`
+ * workspace globs. Callers can override those globs, provide workspace defaults, and replace or
+ * extend individual workspace configuration deterministically.
+ *
+ * @readme
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { EXAMPLES_ESLINT_OWNERSHIP_MARKER } from '../../constants/eslint.js';
 const DEFAULT_MONOREPO_WORKSPACE_GLOBS = ['packages/*', 'apps/*'];
+const MANAGED_EXAMPLES_ESLINT_CONFIG = 'eslint.examples.config.mjs';
 /*** Build shared Knip configuration while preserving repository-specific discovery. */
 export function createKnipConfig(options = {}) {
+    const ignoredFiles = [
+        ...(options.ignoreFiles ?? []),
+        ...(hasManagedExamplesEslintConfig() ? [MANAGED_EXAMPLES_ESLINT_CONFIG] : []),
+    ];
     return {
         ...(options.entry === undefined ? {} : { entry: options.entry }),
         ...(options.project === undefined ? {} : { project: options.project }),
@@ -9,7 +28,7 @@ export function createKnipConfig(options = {}) {
         ...(options.ignoreDependencies === undefined
             ? {}
             : { ignoreDependencies: options.ignoreDependencies }),
-        ...(options.ignoreFiles === undefined ? {} : { ignoreFiles: options.ignoreFiles }),
+        ...(ignoredFiles.length === 0 ? {} : { ignoreFiles: [...new Set(ignoredFiles)] }),
         ...(options.workspaces === undefined ? {} : { workspaces: options.workspaces }),
     };
 }
@@ -31,3 +50,8 @@ export function createKnipMonorepoConfig(options = {}) {
     }
     return createKnipConfig({ workspaces });
 }
+/*** Report whether the examples ESLint config is owned by Devtools. */
+function hasManagedExamplesEslintConfig() {
+    return (existsSync(MANAGED_EXAMPLES_ESLINT_CONFIG) &&
+        readFileSync(MANAGED_EXAMPLES_ESLINT_CONFIG, 'utf8').startsWith(EXAMPLES_ESLINT_OWNERSHIP_MARKER));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "2.0.18",
+  "version": "2.0.20",
   "description": "Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",