@ankhorage/devtools 2.0.4 → 2.0.6

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.4](././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.6](././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
 

package/dist/tools/eslint/managed.d.ts

@@ -8,9 +8,9 @@ export declare const eslintManagedFiles: readonly [{
 }, {
     readonly relativePath: "eslint.examples.config.mjs";
     readonly contents: "// This file is managed by @ankhorage/devtools.\nimport { existsSync } from 'node:fs';\n\nimport { createConfig } from '@ankhorage/devtools/eslint';\nimport localConfig from './eslint.local.config.mjs';\n\nconst exampleFiles = ['examples/**/*.{ts,tsx}'];\nconst localEntries = Array.isArray(localConfig) ? localConfig : [localConfig];\nconst rootProjects = ['./tsconfig.eslint.json', './tsconfig.json'].filter((project) =>\n  existsSync(new URL(project, import.meta.url)),\n);\n\nexport default [\n  ...createConfig({\n    files: exampleFiles,\n    project: [...rootProjects, './examples/**/tsconfig.json'],\n    tsconfigRootDir: import.meta.dirname,\n  }),\n  ...localEntries,\n];\n";
-    readonly isApplicable: typeof hasExamplesDirectory;
+    readonly isApplicable: typeof hasTypeScriptExamples;
 }];
 declare function renderInitialLocalConfig(targetDirectory: string): Promise<string>;
-/*** Report whether the target repository owns public examples at its root. */
-declare function hasExamplesDirectory(targetDirectory: string): Promise<boolean>;
+/*** Report whether the target repository owns TypeScript source examples at its root. */
+declare function hasTypeScriptExamples(targetDirectory: string): Promise<boolean>;
 export {};

package/dist/tools/eslint/managed.js

@@ -1,4 +1,4 @@
-import { readFile, stat } from 'node:fs/promises';
+import { readdir, readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 const ESLINT_CONFIG = `import { createConfig } from '@ankhorage/devtools/eslint';
 import localConfig from './eslint.local.config.mjs';
@@ -17,6 +17,17 @@ 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',
+    'android',
+    'build',
+    'dist',
+    'files',
+    'ios',
+    'node_modules',
+    'templates',
+]);
 const ESLINT_EXAMPLES_CONFIG = `${EXAMPLES_OWNERSHIP_MARKER}import { existsSync } from 'node:fs';
 
 import { createConfig } from '@ankhorage/devtools/eslint';
@@ -50,7 +61,7 @@ export const eslintManagedFiles = [
     {
         relativePath: 'eslint.examples.config.mjs',
         contents: ESLINT_EXAMPLES_CONFIG,
-        isApplicable: hasExamplesDirectory,
+        isApplicable: hasTypeScriptExamples,
     },
 ];
 async function renderInitialLocalConfig(targetDirectory) {
@@ -68,11 +79,18 @@ async function renderInitialLocalConfig(targetDirectory) {
 function isNodeError(error) {
     return error instanceof Error && 'code' in error;
 }
-/*** Report whether the target repository owns public examples at its root. */
-async function hasExamplesDirectory(targetDirectory) {
+/*** Report whether the target repository owns TypeScript source examples at its root. */
+async function hasTypeScriptExamples(targetDirectory) {
     await assertExamplesConfigOwnershipAsync(targetDirectory);
+    return await containsTypeScriptExampleAsync(resolve(targetDirectory, 'examples'));
+}
+/*** Report whether a directory tree contains a TypeScript or TSX source example. */
+async function containsTypeScriptExampleAsync(directory) {
     try {
-        return (await stat(resolve(targetDirectory, 'examples'))).isDirectory();
+        const entries = await readdir(directory, { withFileTypes: true });
+        return (await Promise.all(entries.map(async (entry) => entry.isDirectory() && !IGNORED_EXAMPLE_DIRECTORY_NAMES.has(entry.name)
+            ? await containsTypeScriptExampleAsync(resolve(directory, entry.name))
+            : entry.isFile() && isTypeScriptExampleSource(entry.name)))).some(Boolean);
     }
     catch (error) {
         if (isNodeError(error) && error.code === 'ENOENT') {
@@ -81,6 +99,10 @@ async function hasExamplesDirectory(targetDirectory) {
         throw error;
     }
 }
+/*** Report whether a file is lintable TypeScript example source rather than a declaration. */
+function isTypeScriptExampleSource(fileName) {
+    return /\.tsx?$/u.test(fileName) && !fileName.endsWith('.d.ts');
+}
 /*** Require explicit adoption of consumer overrides before managing an existing examples config. */
 async function assertExamplesConfigOwnershipAsync(targetDirectory) {
     let contents;

package/dist/tools/workflows/files/ci.yml

@@ -83,19 +83,6 @@ jobs:
             echo "No test script found; skipping."
           fi
 
-      - name: Run standalone contract
-        run: |
-          if node -e "const p=require('./package.json'); const required=p.private!==true&&p.publishConfig?.access==='public'; process.exit(required||p.scripts?.['test:standalone']?0:1)"; then
-            if node -e "const p=require('./package.json'); process.exit(p.scripts?.['test:standalone']?0:1)"; then
-              bun run test:standalone
-            else
-              echo "::error title=Standalone contract test required::Public packages must define test:standalone."
-              exit 1
-            fi
-          else
-            echo "No standalone owner test required; skipping."
-          fi
-
       - name: Run typecheck
         run: |
           if node -e "const p=require('./package.json'); process.exit(p.scripts?.typecheck ? 0 : 1)"; then

package/dist/tools/workflows/files/release.yml

@@ -76,17 +76,8 @@ jobs:
             echo "No build script found; skipping."
           fi
 
-      - name: Validate standalone release contract
-        run: |
-          BUN_INSTALL_CACHE_DIR="${RUNNER_TEMP}/doctor-cache" bunx @ankhorage/doctor@__ANKH_DOCTOR_VERSION__ validate .
-          if node -e "const p=require('./package.json'); const required=p.private!==true&&p.publishConfig?.access==='public'; process.exit(required||p.scripts?.['test:standalone']?0:1)"; then
-            if node -e "const p=require('./package.json'); process.exit(p.scripts?.['test:standalone']?0:1)"; then
-              bun run test:standalone
-            else
-              echo "::error title=Standalone contract test required::Public packages must define test:standalone."
-              exit 1
-            fi
-          fi
+      - name: Validate release contract
+        run: BUN_INSTALL_CACHE_DIR="${RUNNER_TEMP}/doctor-cache" bunx @ankhorage/doctor@__ANKH_DOCTOR_VERSION__ validate .
 
       - name: Version packages directly on main
         id: release
@@ -168,9 +159,6 @@ jobs:
           if node -e "const p=require('./package.json'); process.exit(p.scripts?.build?0:1)"; then
             bun run build
           fi
-          if node -e "const p=require('./package.json'); process.exit(p.scripts?.['test:standalone']?0:1)"; then
-            bun run test:standalone
-          fi
           pack_dir="$(mktemp -d "${RUNNER_TEMP}/standalone-pack.XXXXXX")"
           install_dir="$(mktemp -d "${RUNNER_TEMP}/standalone-install.XXXXXX")"
           npm pack --ignore-scripts --pack-destination "$pack_dir" >/dev/null

package/package.json

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