@ankhorage/devtools 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fabio Gartenmann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# @ankhorage/devtools
+
+Shared Lint and Format Configuration for Ankhorage.
+
+This package provides a unified, modern ESLint and Prettier configuration policy used across Ankhorage projects. It is built on top of **ESLint Flat Config** and **typescript-eslint**, ensuring a seamless, type-safe development experience.
+
+## Installation
+
+```bash
+bun add -d @ankhorage/devtools
+# or
+npm install --save-dev @ankhorage/devtools
+```
+
+## Features
+
+- **One Package, Two Exports**: Access everything via `@ankhorage/devtools/eslint` and `@ankhorage/devtools/prettier`.
+- **Modern Standards**: Built for ESLint 9+ and Prettier 3+.
+- **Type-Safe**: Uses `typescript-eslint`'s recommended type-checked and stylistic rules.
+- **Unified Policy**: Converges all repositories to a single, high-quality linting standard.
+
+## Usage
+
+### ESLint
+
+Create an `eslint.config.mjs` file in your project root:
+
+```javascript
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createConfig } from '@ankhorage/devtools/eslint';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default createConfig({
+  tsconfigRootDir: __dirname,
+  project: ['./tsconfig.json'],
+  files: ['src/**/*.ts'],
+});
+```
+
+#### Configuration Options
+
+The `createConfig` function accepts the following required options:
+
+- `tsconfigRootDir`: The root directory for tsconfig resolution (typically `import.meta.dirname` or equivalent).
+- `project`: An array of paths to your `tsconfig` files (e.g., `['./tsconfig.json']`).
+- `files`: An array of glob patterns for the files you want to lint (e.g., `['src/**/*.{ts,tsx}']`).
+
+Optional options:
+
+- `allowDefaultProject`: Glob patterns for files to allow in the default project.
+- `additionalIgnores`: Extra glob patterns to ignore.
+- `restrictedImports`: An array of `{ name, message }` objects to append to the default restricted imports.
+- `overrides`: An array of raw ESLint flat config objects to append to the configuration.
+- `includePrettier`: Whether to include the Prettier configuration (defaults to `true`).
+
+### Prettier
+
+Create a `prettier.config.cjs` file in your project root:
+
+```javascript
+/** @type {import('prettier').Config} */
+module.exports = require('@ankhorage/devtools/prettier');
+```
+
+**Note**: You should keep a local `.prettierignore` file in your repository to define ignored patterns.
+
+## Examples
+
+Check the [examples](./examples) directory for copy-pasteable configurations:
+
+- `examples/monorepo/eslint.config.mjs`: For monorepo project structures.
+- `examples/package/eslint.config.mjs`: For standalone package structures.
+
+## License
+
+MIT

package/dist/eslint.d.ts

@@ -0,0 +1,11 @@
+import tseslint from 'typescript-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 monorepo. Use '@ankh/dnd' (boundary) instead.";
+}, {
+    readonly name: "@ankhorage/react-native-reanimated-dnd-web";
+    readonly message: "Forbidden in monorepo. Use '@ankh/dnd' (boundary) instead.";
+}];
+export declare function createConfig(options: DevtoolsConfigOptions): ReturnType<typeof tseslint.config>;

package/dist/eslint.js

@@ -0,0 +1,106 @@
+import js from '@eslint/js';
+import prettierConfig from 'eslint-config-prettier';
+import importPlugin from 'eslint-plugin-import';
+import prettierPlugin from 'eslint-plugin-prettier';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import unusedImports from 'eslint-plugin-unused-imports';
+import tseslint from 'typescript-eslint';
+export const defaultIgnores = [
+    '**/ios/**',
+    '**/android/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.expo/**',
+    '**/.next/**',
+    '**/node_modules/**',
+    '**/*.d.ts',
+    '**/templates/**',
+    '**/files/**',
+];
+export const defaultRestrictedImports = [
+    {
+        name: 'react-native-reanimated-dnd',
+        message: "Forbidden in monorepo. Use '@ankh/dnd' (boundary) instead.",
+    },
+    {
+        name: '@ankhorage/react-native-reanimated-dnd-web',
+        message: "Forbidden in monorepo. Use '@ankh/dnd' (boundary) instead.",
+    },
+];
+export function createConfig(options) {
+    const normalizedOptions = {
+        allowDefaultProject: [],
+        additionalIgnores: [],
+        restrictedImports: [],
+        overrides: [],
+        includePrettier: true,
+        ...options,
+    };
+    const combinedRestrictedImports = [
+        ...defaultRestrictedImports,
+        ...normalizedOptions.restrictedImports,
+    ];
+    const plugins = {
+        import: importPlugin,
+        prettier: prettierPlugin,
+        'simple-import-sort': simpleImportSort,
+        'unused-imports': unusedImports,
+    };
+    return tseslint.config({
+        ignores: [...defaultIgnores, ...normalizedOptions.additionalIgnores],
+    }, js.configs.recommended, ...tseslint.configs.recommendedTypeChecked.map((config) => ({
+        ...config,
+        files: normalizedOptions.files,
+    })), ...tseslint.configs.stylisticTypeChecked.map((config) => ({
+        ...config,
+        files: normalizedOptions.files,
+    })), {
+        files: normalizedOptions.files,
+        languageOptions: {
+            parser: tseslint.parser,
+            parserOptions: {
+                project: normalizedOptions.project,
+                tsconfigRootDir: normalizedOptions.tsconfigRootDir,
+                allowDefaultProject: normalizedOptions.allowDefaultProject,
+            },
+        },
+        plugins,
+        rules: {
+            '@typescript-eslint/no-non-null-assertion': 'error',
+            '@typescript-eslint/prefer-readonly': 'error',
+            '@typescript-eslint/prefer-optional-chain': 'error',
+            '@typescript-eslint/prefer-as-const': 'error',
+            '@typescript-eslint/no-unnecessary-type-arguments': 'error',
+            '@typescript-eslint/no-unnecessary-condition': 'error',
+            '@typescript-eslint/no-unnecessary-type-constraint': 'error',
+            '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+            '@typescript-eslint/consistent-type-definitions': ['error', 'interface'],
+            '@typescript-eslint/prefer-nullish-coalescing': 'error',
+            'no-restricted-imports': [
+                'error',
+                {
+                    paths: combinedRestrictedImports,
+                },
+            ],
+            'prefer-destructuring': 'off',
+            '@typescript-eslint/prefer-destructuring': 'error',
+            'simple-import-sort/imports': 'error',
+            'simple-import-sort/exports': 'error',
+            'unused-imports/no-unused-imports': 'error',
+            'unused-imports/no-unused-vars': [
+                'error',
+                {
+                    vars: 'all',
+                    varsIgnorePattern: '^_',
+                    args: 'after-used',
+                    argsIgnorePattern: '^_',
+                },
+            ],
+            'import/order': 'off',
+            '@typescript-eslint/no-unused-vars': 'off',
+            '@typescript-eslint/no-explicit-any': 'error',
+            'prettier/prettier': 'error',
+            'no-console': 'off',
+        },
+    }, ...normalizedOptions.overrides, ...(normalizedOptions.includePrettier ? [prettierConfig] : []));
+}

package/dist/prettier.cjs

@@ -0,0 +1,9 @@
+/** @type {import('prettier').Config} */
+module.exports = {
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'all',
+  printWidth: 100,
+  tabWidth: 2,
+  arrowParens: 'always',
+};

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+import type tseslint from 'typescript-eslint';
+export type FlatConfig = ReturnType<typeof tseslint.config>;
+export type FlatConfigItem = FlatConfig[number];
+export interface RestrictedImport {
+    name: string;
+    message: string;
+}
+export interface DevtoolsConfigOptions {
+    tsconfigRootDir: string;
+    project: string[];
+    files: string[];
+    allowDefaultProject?: string[];
+    additionalIgnores?: string[];
+    restrictedImports?: RestrictedImport[];
+    overrides?: FlatConfigItem[];
+    includePrettier?: boolean;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/examples/monorepo/eslint.config.mjs

@@ -0,0 +1,12 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createConfig } from '@ankhorage/devtools/eslint';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default createConfig({
+  tsconfigRootDir: __dirname,
+  project: ['./tsconfig.base.json'],
+  files: ['packages/**/src/**/*.{ts,tsx}', 'apps/**/src/**/*.{ts,tsx}', 'scripts/**/*.{ts,tsx}'],
+  allowDefaultProject: ['scripts/**/*.ts'],
+});

package/examples/package/.prettierignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+build
+.next
+.expo

package/examples/package/eslint.config.mjs

@@ -0,0 +1,11 @@
+import { createConfig } from '@ankhorage/devtools/eslint';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default createConfig({
+  tsconfigRootDir: __dirname,
+  project: ['./tsconfig.eslint.json'],
+  files: ['src/**/*.{ts,tsx}'],
+});

package/examples/package/prettier.config.cjs

@@ -0,0 +1,2 @@
+/** @type {import('prettier').Config} */
+module.exports = require('@ankhorage/devtools/prettier');

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@ankhorage/devtools",
+  "version": "1.0.0",
+  "description": "Shared Lint and Format Configuration for Ankhorage",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./eslint": {
+      "types": "./dist/eslint.d.ts",
+      "import": "./dist/eslint.js"
+    },
+    "./prettier": {
+      "require": "./dist/prettier.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/prettier.cjs dist/prettier.cjs",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.2.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "prettier": "^3.8.1",
+    "typescript-eslint": "^8.24.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.30.0",
+    "@types/node": "^25.2.3",
+    "bun-types": "^1.3.11",
+    "typescript": "^5.9.3"
+  }
+}