@ankhorage/devtools 1.4.0 → 1.5.0

package/dist/policy/bunRuntimePolicy.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Canonical Bun runtime policy for Ankhorage repositories.
+ *
+ * Import this from `@ankhorage/devtools/policy` when another package needs to inspect
+ * the managed Bun version without defining an independent version authority.
+ */
 export declare const bunRuntimePolicy: {
     readonly packageManager: "bun@1.3.14";
     readonly typesRange: "^1.3.14";

package/dist/policy/bunRuntimePolicy.js

@@ -1,3 +1,9 @@
+/**
+ * Canonical Bun runtime policy for Ankhorage repositories.
+ *
+ * Import this from `@ankhorage/devtools/policy` when another package needs to inspect
+ * the managed Bun version without defining an independent version authority.
+ */
 export const bunRuntimePolicy = {
     packageManager: 'bun@1.3.14',
     typesRange: '^1.3.14',

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

@@ -1,9 +1,9 @@
-import tseslint from 'typescript-eslint';
+import type { Linter } from 'eslint';
 import type { DevtoolsConfigOptions } from './types.js';
 export declare const defaultIgnores: readonly ["**/ios/**", "**/android/**", "**/dist/**", "**/build/**", "**/.expo/**", "**/.next/**", "**/node_modules/**", "**/*.d.ts", "**/templates/**", "**/files/**"];
 export declare const defaultRestrictedImports: readonly [{
     readonly name: "react-native-reanimated-dnd";
     readonly message: "Forbidden in Ankhorage packages. Use '@ankhorage/react-native-reanimated-dnd-web' directly.";
 }];
-export declare function createConfig(options: DevtoolsConfigOptions): ReturnType<typeof tseslint.config>;
+export declare function createConfig(options: DevtoolsConfigOptions): Linter.Config[];
 export type { DevtoolsConfigOptions, DevtoolsEslintProfile, FlatConfigItem, ResolvedDevtoolsEslintProfile, RestrictedImport, } from './types.js';

package/dist/tools/eslint/index.js

@@ -4,13 +4,13 @@
  * The default `profile: 'auto'` reads the nearest `package.json` from `tsconfigRootDir` and uses
  * `@ankhorage/utility/project` to select overlapping project traits. React Native and Expo select
  * the `react-native` profile, React and Next.js select `react`, and other projects use `base`.
- * Consumers can explicitly select `base`, `react`, or `react-native` when automatic detection is
- * not appropriate.
  *
  * Every profile includes the shared TypeScript, import, unused-import, Prettier, security, and
  * quality rules. The common quality limits are 50 effective lines per function, 300 effective
- * lines per file, and modified cyclomatic complexity 15. React adds React and Hooks correctness
- * rules; React Native composes the React profile and adds focused React Native rules.
+ * lines per file, and modified cyclomatic complexity 15. Forward exports are forbidden outside
+ * explicit `index.*` barrels so implementation files export only symbols they own. React adds
+ * React and Hooks correctness rules; React Native composes the React profile and adds focused
+ * React Native rules.
  *
  * Repository-specific behavior stays additive: `additionalIgnores`, `restrictedImports`, and
  * `overrides` extend the central policy instead of replacing it. Narrow local overrides remain the
@@ -21,6 +21,7 @@
  */
 import { fixupPluginRules } from '@eslint/compat';
 import js from '@eslint/js';
+import { defineConfig } from 'eslint/config';
 import prettierConfig from 'eslint-config-prettier';
 import importPlugin from 'eslint-plugin-import';
 import prettierPlugin from 'eslint-plugin-prettier';
@@ -31,6 +32,7 @@ import securityPlugin from 'eslint-plugin-security';
 import simpleImportSort from 'eslint-plugin-simple-import-sort';
 import unusedImports from 'eslint-plugin-unused-imports';
 import tseslint from 'typescript-eslint';
+import { createModuleOwnershipConfig } from './moduleOwnership.js';
 import { resolveEslintProfile } from './profile.js';
 export const defaultIgnores = [
     '**/ios/**',
@@ -53,7 +55,7 @@ export const defaultRestrictedImports = [
 export function createConfig(options) {
     const normalized = normalizeOptions(options);
     const profile = resolveEslintProfile(options);
-    return tseslint.config({ ignores: [...defaultIgnores, ...normalized.additionalIgnores] }, { ...js.configs.recommended, files: normalized.files }, ...createTypeCheckedConfigs(normalized), createBaseConfig(normalized), ...createProfileConfigs(profile, normalized.files), ...normalized.overrides, ...(normalized.includePrettier ? [prettierConfig] : []));
+    return defineConfig({ ignores: [...defaultIgnores, ...normalized.additionalIgnores] }, { ...js.configs.recommended, files: normalized.files }, ...createTypeCheckedConfigs(normalized), createBaseConfig(normalized), createModuleOwnershipConfig(normalized.files), ...createProfileConfigs(profile, normalized.files), ...normalized.overrides, ...(normalized.includePrettier ? [prettierConfig] : []));
 }
 function normalizeOptions(options) {
     return {
@@ -161,7 +163,10 @@ function createProfileConfigs(profile, files) {
 function createReactConfig(files) {
     return {
         files,
-        plugins: { react: reactPlugin, 'react-hooks': reactHooksPlugin },
+        plugins: {
+            react: reactPlugin,
+            'react-hooks': fixupPluginRules({ rules: reactHooksPlugin.rules }),
+        },
         settings: { react: { version: 'detect' } },
         rules: {
             'react/no-danger': 'error',

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

@@ -0,0 +1,2 @@
+import type { FlatConfigItem } from './types.js';
+export declare function createModuleOwnershipConfig(files: string[]): FlatConfigItem;

package/dist/tools/eslint/moduleOwnership.js

@@ -0,0 +1,46 @@
+const INDEX_BARREL_FILES = [
+    '**/index.ts',
+    '**/index.tsx',
+    '**/index.js',
+    '**/index.jsx',
+    '**/index.mts',
+    '**/index.cts',
+    '**/index.mjs',
+    '**/index.cjs',
+];
+function isForwardExport(context, node) {
+    const tokens = context.sourceCode.getTokens(node);
+    if (tokens.at(0)?.value !== 'export') {
+        return false;
+    }
+    return tokens.some((token, index) => token.value === 'from' && tokens.at(index + 1)?.type === 'String');
+}
+const noForwardExportsRule = {
+    meta: {
+        type: 'problem',
+        schema: [],
+        messages: {
+            forwardExport: 'Forward exports are forbidden outside index barrels. Import directly from the owning module.',
+        },
+    },
+    create(context) {
+        return {
+            'Program > *'(node) {
+                if (isForwardExport(context, node)) {
+                    context.report({ node, messageId: 'forwardExport' });
+                }
+            },
+        };
+    },
+};
+const moduleOwnershipPlugin = {
+    rules: { 'no-forward-exports': noForwardExportsRule },
+};
+export function createModuleOwnershipConfig(files) {
+    return {
+        files,
+        ignores: [...INDEX_BARREL_FILES],
+        plugins: { ankhorage: moduleOwnershipPlugin },
+        rules: { 'ankhorage/no-forward-exports': 'error' },
+    };
+}

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

@@ -1,6 +1,5 @@
-import type tseslint from 'typescript-eslint';
-type FlatConfig = ReturnType<typeof tseslint.config>;
-export type FlatConfigItem = FlatConfig[number];
+import type { Linter } from 'eslint';
+export type FlatConfigItem = Linter.Config;
 export interface RestrictedImport {
     readonly name: string;
     readonly message: string;
@@ -19,4 +18,3 @@ export interface DevtoolsConfigOptions {
     readonly overrides?: FlatConfigItem[];
     readonly includePrettier?: boolean;
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Shared development tools and repository standards for Ankhorage",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",
@@ -66,6 +66,10 @@
       "types": "./dist/tools/knip/index.d.ts",
       "import": "./dist/tools/knip/index.js"
     },
+    "./policy": {
+      "types": "./dist/policy/bunRuntimePolicy.d.ts",
+      "import": "./dist/policy/bunRuntimePolicy.js"
+    },
     "./prettier": {
       "import": "./dist/tools/prettier/index.cjs",
       "require": "./dist/tools/prettier/index.cjs",