@ankhorage/devtools 1.15.1 → 1.15.2

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v1.15.1](././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) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v1.15.2](././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) ![docs: paradox](././paradox/badges/docs.svg)
 
 Shared tooling, repository automation, runtime policies, and agent standards for Ankhorage TypeScript projects
 

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

@@ -1,3 +1,4 @@
+/*** Defines the Prettier files and ignore policy managed for consuming repositories. */
 export declare const prettierManagedFiles: readonly [{
     readonly relativePath: "prettier.local.config.js";
     readonly render: typeof renderInitialLocalConfig;
@@ -5,7 +6,14 @@ export declare const prettierManagedFiles: readonly [{
 }, {
     readonly relativePath: ".prettierrc.js";
     readonly render: typeof renderPrettierConfig;
+}, {
+    readonly relativePath: ".prettierignore";
+    readonly render: typeof renderPrettierIgnore;
 }];
+/*** Renders the shared Prettier wrapper for the target package module type. */
 declare function renderPrettierConfig(targetDirectory: string): Promise<string>;
+/*** Preserves an existing repository Prettier config as its initial local extension. */
 declare function renderInitialLocalConfig(targetDirectory: string): Promise<string>;
+/*** Preserves repository-owned ignore entries while appending required generated-artifact ignores. */
+declare function renderPrettierIgnore(targetDirectory: string): Promise<string>;
 export {};

package/dist/tools/prettier/managed.js

@@ -26,6 +26,8 @@ const LEGACY_ESM_CONFIG = `export { default } from '@ankhorage/devtools/prettier
 `;
 const LEGACY_COMMONJS_CONFIG = `module.exports = require('@ankhorage/devtools/prettier');
 `;
+const REQUIRED_PRETTIER_IGNORE_ENTRIES = ['node_modules', 'dist', 'README.md', 'paradox/'];
+/*** Defines the Prettier files and ignore policy managed for consuming repositories. */
 export const prettierManagedFiles = [
     {
         relativePath: 'prettier.local.config.js',
@@ -36,10 +38,16 @@ export const prettierManagedFiles = [
         relativePath: '.prettierrc.js',
         render: renderPrettierConfig,
     },
+    {
+        relativePath: '.prettierignore',
+        render: renderPrettierIgnore,
+    },
 ];
+/*** Renders the shared Prettier wrapper for the target package module type. */
 async function renderPrettierConfig(targetDirectory) {
     return (await readPackageType(targetDirectory)) === 'module' ? ESM_CONFIG : COMMONJS_CONFIG;
 }
+/*** Preserves an existing repository Prettier config as its initial local extension. */
 async function renderInitialLocalConfig(targetDirectory) {
     const isModule = (await readPackageType(targetDirectory)) === 'module';
     try {
@@ -53,6 +61,25 @@ async function renderInitialLocalConfig(targetDirectory) {
     }
     return isModule ? EMPTY_ESM_LOCAL_CONFIG : EMPTY_COMMONJS_LOCAL_CONFIG;
 }
+/*** Preserves repository-owned ignore entries while appending required generated-artifact ignores. */
+async function renderPrettierIgnore(targetDirectory) {
+    const existing = await readFile(resolve(targetDirectory, '.prettierignore'), 'utf8').catch((error) => {
+        if (isNodeError(error) && error.code === 'ENOENT')
+            return '';
+        throw error;
+    });
+    const existingEntries = new Set(existing
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .filter((line) => line !== '' && !line.startsWith('#')));
+    const missingEntries = REQUIRED_PRETTIER_IGNORE_ENTRIES.filter((entry) => !existingEntries.has(entry));
+    if (missingEntries.length === 0) {
+        return existing.endsWith('\n') ? existing : `${existing}\n`;
+    }
+    const prefix = existing === '' ? '' : existing.endsWith('\n') ? existing : `${existing}\n`;
+    return `${prefix}${missingEntries.join('\n')}\n`;
+}
+/*** Reads whether the target package uses ESM or CommonJS package semantics. */
 async function readPackageType(targetDirectory) {
     try {
         const contents = await readFile(resolve(targetDirectory, 'package.json'), 'utf8');
@@ -66,12 +93,15 @@ async function readPackageType(targetDirectory) {
         throw error;
     }
 }
+/*** Narrows an unknown JSON value to a non-array record. */
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/*** Identifies Prettier wrappers that contain no repository-owned configuration. */
 function isSharedOnlyConfig(value) {
     return [ESM_CONFIG, COMMONJS_CONFIG, LEGACY_ESM_CONFIG, LEGACY_COMMONJS_CONFIG].includes(value);
 }
+/*** Narrows an unknown error to a Node error carrying an error code. */
 function isNodeError(error) {
     return error instanceof Error && 'code' in error;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.15.1",
+  "version": "1.15.2",
   "description": "Shared tooling, repository automation, runtime policies, and agent standards for Ankhorage TypeScript projects",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",
@@ -49,14 +49,15 @@
     "renovateSyncProtocol": 1
   },
   "keywords": [
-    "typescript",
+    "ankhorage",
+    "developer-tools",
     "eslint",
-    "prettier",
-    "knip",
     "github-actions",
-    "vscode",
+    "knip",
+    "prettier",
     "repository-sync",
-    "developer-tools"
+    "typescript",
+    "vscode"
   ],
   "bin": {
     "ankhorage-changeset": "./dist/cli/bin/changeset.js",