@jterrazz/typescript 5.3.0 → 6.0.0

package/README.md

@@ -1,53 +1,75 @@
 # @jterrazz/typescript
 
-Drop-in TypeScript build tooling with zero configuration.
+The complete TypeScript toolchain — build, run, check, and document with zero configuration. Powered by tsdown, Oxlint, Oxfmt, tsgo, and Knip.
 
 ## Installation
 
 ```bash
-npm install @jterrazz/typescript
+npm install @jterrazz/typescript --save-dev
 ```
 
-## Usage
+## Setup
 
 ### 1. Choose a TypeScript configuration
 
 ```json
 // tsconfig.json - Pick one:
-{ "extends": "@jterrazz/typescript/presets/tsconfig/node" }  // Node.js projects
-{ "extends": "@jterrazz/typescript/presets/tsconfig/next" }  // Next.js projects
-{ "extends": "@jterrazz/typescript/presets/tsconfig/expo" }  // Expo/React Native
+{ "extends": "@jterrazz/typescript/tsconfig/node" }  // Node.js projects
+{ "extends": "@jterrazz/typescript/tsconfig/next" }  // Next.js projects
+{ "extends": "@jterrazz/typescript/tsconfig/expo" }  // Expo/React Native
 ```
 
-### 2. Use the CLI
+### 2. Create the lint and format configs
+
+```ts
+// oxlint.config.ts
+import { oxlint } from '@jterrazz/typescript';
+import { defineConfig } from 'oxlint';
+
+export default defineConfig({
+    extends: [oxlint.node],
+});
+```
+
+```ts
+// oxfmt.config.ts
+import { oxfmt } from '@jterrazz/typescript';
+import { defineConfig } from 'oxfmt';
+
+export default defineConfig(oxfmt);
+```
+
+### 3. Use the CLI
 
 ```bash
 npx typescript build       # Build application (ESM + types)
 npx typescript bundle      # Bundle library (ESM + CJS + types)
 npx typescript start       # Run the built application
 npx typescript dev         # Build, run, and rebuild on changes
+npx typescript docs        # Generate API reference + llms.txt
+npx typescript check       # Check types, lint, formatting, and unused code
+npx typescript fix         # Auto-fix lint and formatting issues
 ```
 
-## What you get
+## Building
 
 - **Blazing fast** — Powered by [tsdown](https://tsdown.dev) / [Rolldown](https://rolldown.rs) (Rust)
 - **Zero configuration** — Works out of the box
 - **Multiple outputs** — ESM + CommonJS + TypeScript declarations
 - **Source maps** — Full debugging support
 
-### Build outputs
-
-| Command             | Output            | Description             |
-| ------------------- | ----------------- | ----------------------- |
-| `typescript build`  | `dist/index.js`   | ESM bundle              |
-|                     | `dist/index.d.ts` | TypeScript declarations |
-| `typescript bundle` | `dist/index.js`   | ESM bundle              |
-|                     | `dist/index.cjs`  | CommonJS bundle         |
-|                     | `dist/index.d.ts` | TypeScript declarations |
-| `typescript start`  | —                 | Runs `dist/index.js`    |
-| `typescript dev`    | `dist/index.js`   | Watch + rebuild + run   |
+| Command             | Output            | Description              |
+| ------------------- | ----------------- | ------------------------ |
+| `typescript build`  | `dist/index.js`   | ESM bundle               |
+|                     | `dist/index.d.ts` | TypeScript declarations  |
+| `typescript bundle` | `dist/index.js`   | ESM bundle               |
+|                     | `dist/index.cjs`  | CommonJS bundle          |
+|                     | `dist/index.d.ts` | TypeScript declarations  |
+| `typescript start`  | —                 | Runs `dist/index.js`     |
+| `typescript dev`    | `dist/index.js`   | Watch + rebuild + run    |
+| `typescript docs`   | `.docs/`          | API reference + llms.txt |
 
-## Project structure
+### Project structure
 
 ```
 your-project/
@@ -58,15 +80,89 @@ your-project/
 └── tsconfig.json          # Extends this package
 ```
 
-## How it works
+## Quality checks
+
+`typescript check` runs four tools in parallel:
+
+| Tool   | Purpose              |
+| ------ | -------------------- |
+| tsgo   | Type checking        |
+| oxlint | Linting              |
+| oxfmt  | Formatting           |
+| knip   | Unused code analysis |
+
+`typescript fix` runs tsgo, oxlint (with `--fix`), and oxfmt in parallel (knip excluded).
+
+### Lint presets
+
+| Preset        | Use Case                          |
+| ------------- | --------------------------------- |
+| `oxlint.node` | Node.js (requires .js extensions) |
+| `oxlint.expo` | Expo / React Native               |
+| `oxlint.next` | Next.js                           |
+
+### Architecture enforcement
+
+Enforce hexagonal architecture boundaries with the additive `oxlint.hexagonal` preset:
 
-The package uses a fully compiled toolchain — no JavaScript in the hot path:
+```ts
+import { oxlint } from '@jterrazz/typescript';
+import { defineConfig } from 'oxlint';
+
+export default defineConfig({
+    extends: [oxlint.node, oxlint.hexagonal],
+});
+```
+
+Rules enforced:
+
+- `domain/` cannot import from other layers
+- `application/` cannot import infrastructure
+- `presentation/ui/` cannot import navigation
+- `features/` cannot import other features
+
+### Unused code detection
+
+`typescript check` runs [Knip](https://knip.dev/) to detect unused files, exports, and dependencies. A base config is automatically merged with any project-local `knip.json`, handling common ecosystem patterns:
+
+- `@jterrazz/*` packages auto-ignored
+- Published libraries: `exports`/`types`/`files` rules auto-disabled
+- Convention paths (`fixtures/`, `expected/`, `docs/`) auto-ignored
+- Plugin dependencies (`*-plugin-*`, `@scope/*`) auto-ignored
+
+For fine-tuning, create a `knip.json` with only project-specific overrides.
+
+## API docs generation
+
+`typescript docs` reads TSDoc from `src/index.ts` and generates:
+
+- **Typedoc markdown** — Full API reference under `.docs/`
+- **`llms.txt`** — Structured index following the [llms.txt standard](https://llmstxt.org/)
+- **`llms-full.txt`** — Complete reference in one file for LLM context windows
+
+No `typedoc.json` needed. Pair with the shared CI workflow to auto-deploy:
+
+```yaml
+# .github/workflows/docs.yaml
+jobs:
+    docs:
+        uses: jterrazz/jterrazz-actions/.github/workflows/docs.yaml@main
+```
+
+## How it works
 
-| Step         | Tool                                  | Language |
-| ------------ | ------------------------------------- | -------- |
-| Transpile    | [Oxc](https://oxc.rs) (via tsdown)    | Rust     |
-| Bundle       | [Rolldown](https://rolldown.rs)       | Rust     |
-| Declarations | [tsdown](https://tsdown.dev) built-in | Rust     |
+The toolchain is fully compiled — no JavaScript in the hot path:
+
+| Step         | Tool                                               | Language |
+| ------------ | -------------------------------------------------- | -------- |
+| Transpile    | [Oxc](https://oxc.rs) (via tsdown)                 | Rust     |
+| Bundle       | [Rolldown](https://rolldown.rs)                    | Rust     |
+| Declarations | [tsdown](https://tsdown.dev) built-in              | Rust     |
+| Type check   | [tsgo](https://github.com/microsoft/typescript-go) | Go       |
+| Lint         | [Oxlint](https://oxc.rs/docs/guide/usage/linter)   | Rust     |
+| Format       | [Oxfmt](https://oxc.rs/docs/guide/usage/formatter) | Rust     |
+| Unused code  | [Knip](https://knip.dev)                           | Node     |
+| API docs     | [Typedoc](https://typedoc.org)                     | Node     |
 
 ## License
 

package/bin/commands/check.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+# Quality checks: runs tsgo, oxlint, oxfmt, and knip in parallel.
+# Called by: typescript check | typescript fix
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+CYAN_BG='\033[46m'
+BRIGHT_WHITE='\033[1;30m'
+NC='\033[0m'
+
+# Resolve symlinks to get the real script location
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+    DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+    SOURCE="$(readlink "$SOURCE")"
+    [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+PACKAGE_ROOT="$SCRIPT_DIR/../.."
+
+# Find bin directory
+if [ -x "$PACKAGE_ROOT/../../.bin/oxlint" ]; then
+    BIN_DIR="$PACKAGE_ROOT/../../.bin"
+elif [ -x "$PACKAGE_ROOT/node_modules/.bin/oxlint" ]; then
+    BIN_DIR="$PACKAGE_ROOT/node_modules/.bin"
+else
+    BIN_DIR="$(npm bin 2>/dev/null)"
+fi
+
+# Parse command and args
+COMMAND=""
+LINT_ARGS=()
+
+if [[ "${1:-}" == -* ]] || [ -z "${1:-}" ]; then
+    # No command, everything is args
+    true
+else
+    COMMAND="$1"
+    shift
+fi
+
+# Parse remaining args
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --ignore-pattern)
+            LINT_ARGS+=("$1" "$2")
+            shift 2
+            ;;
+        *)
+            shift
+            ;;
+    esac
+done
+
+# Create a temporary directory for log files
+tmp_dir=$(mktemp -d)
+cleanup() { rm -rf "$tmp_dir"; }
+trap cleanup EXIT
+
+run_checks() {
+    local FIX_MODE="$1"
+    local LABEL
+
+    if [ "$FIX_MODE" = true ]; then
+        LABEL="Running quality fixes"
+    else
+        LABEL="Running quality checks"
+    fi
+
+    printf "${CYAN_BG}${BRIGHT_WHITE} START ${NC} ${LABEL}\n"
+
+    # Run all tools in parallel
+    "$BIN_DIR/tsgo" --noEmit > "$tmp_dir/type.log" 2>&1 &
+    local type_pid=$!
+
+    if [ "$FIX_MODE" = true ]; then
+        "$BIN_DIR/oxlint" --fix "${LINT_ARGS[@]}" > "$tmp_dir/lint.log" 2>&1 &
+    else
+        "$BIN_DIR/oxlint" "${LINT_ARGS[@]}" > "$tmp_dir/lint.log" 2>&1 &
+    fi
+    local lint_pid=$!
+
+    if [ "$FIX_MODE" = true ]; then
+        "$BIN_DIR/oxfmt" > "$tmp_dir/format.log" 2>&1 &
+    else
+        "$BIN_DIR/oxfmt" --check > "$tmp_dir/format.log" 2>&1 &
+    fi
+    local format_pid=$!
+
+    # Knip: only run in check mode (fix mode is destructive)
+    # Merge base config (from this package) with optional project-local knip.json
+    local knip_pid=""
+    local knip_status=0
+    if [ "$FIX_MODE" = false ]; then
+        local knip_base="$PACKAGE_ROOT/presets/knip/base.json"
+        local knip_project=""
+        [ -f "knip.json" ] && knip_project="knip.json"
+        [ -f "knip.jsonc" ] && knip_project="knip.jsonc"
+
+        node "$PACKAGE_ROOT/bin/merge-knip-config.js" "$knip_base" $knip_project > "$tmp_dir/knip-merged.json"
+        "$BIN_DIR/knip" --no-progress --no-config-hints --config "$tmp_dir/knip-merged.json" > "$tmp_dir/knip.log" 2>&1 &
+        knip_pid=$!
+    fi
+
+    # Wait and collect statuses
+    wait $type_pid;   local type_status=$?
+    wait $lint_pid;   local lint_status=$?
+    wait $format_pid; local format_status=$?
+    [ -n "$knip_pid" ] && { wait $knip_pid; knip_status=$?; }
+
+    # Print results
+    printf "\n${CYAN_BG}${BRIGHT_WHITE} RUN ${NC} TypeScript Check\n\n"
+    [ -s "$tmp_dir/type.log" ] && cat "$tmp_dir/type.log"
+    [ $type_status -ne 0 ] && printf "${RED}✗ Failed with exit code %d${NC}\n" $type_status || printf "${GREEN}✓ Passed${NC}\n"
+
+    local lint_label="Oxlint Check"
+    [ "$FIX_MODE" = true ] && lint_label="Oxlint Fix"
+    printf "\n${CYAN_BG}${BRIGHT_WHITE} RUN ${NC} ${lint_label}\n\n"
+    [ -s "$tmp_dir/lint.log" ] && cat "$tmp_dir/lint.log"
+    [ $lint_status -ne 0 ] && printf "${RED}✗ Failed with exit code %d${NC}\n" $lint_status || printf "${GREEN}✓ Passed${NC}\n"
+
+    local format_label="Oxfmt Check"
+    [ "$FIX_MODE" = true ] && format_label="Oxfmt Format"
+    printf "\n${CYAN_BG}${BRIGHT_WHITE} RUN ${NC} ${format_label}\n\n"
+    [ -s "$tmp_dir/format.log" ] && cat "$tmp_dir/format.log"
+    [ $format_status -ne 0 ] && printf "${RED}✗ Failed with exit code %d${NC}\n" $format_status || printf "${GREEN}✓ Passed${NC}\n"
+
+    if [ "$FIX_MODE" = false ]; then
+        printf "\n${CYAN_BG}${BRIGHT_WHITE} RUN ${NC} Knip (unused code)\n\n"
+        [ -s "$tmp_dir/knip.log" ] && cat "$tmp_dir/knip.log"
+        [ $knip_status -ne 0 ] && printf "${RED}✗ Failed with exit code %d${NC}\n" $knip_status || printf "${GREEN}✓ Passed${NC}\n"
+    fi
+
+    # Summary
+    if [ "$FIX_MODE" = true ]; then
+        printf "\n${CYAN_BG}${BRIGHT_WHITE} END ${NC} Finalizing quality fixes\n\n"
+    else
+        printf "\n${CYAN_BG}${BRIGHT_WHITE} END ${NC} Finalizing quality checks\n\n"
+    fi
+
+    if [ $type_status -eq 0 ] && [ $lint_status -eq 0 ] && [ $format_status -eq 0 ] && [ $knip_status -eq 0 ]; then
+        printf "${GREEN}✓ All checks passed${NC}\n"
+        exit 0
+    else
+        printf "${RED}✗ Some checks failed${NC}\n"
+        exit 1
+    fi
+}
+
+case "$COMMAND" in
+    check)
+        run_checks false
+        ;;
+
+    fix)
+        run_checks true
+        ;;
+
+    *)
+        printf "Usage: check.sh <check|fix> [--ignore-pattern <pattern>]\n"
+        exit 1
+        ;;
+esac

package/bin/merge-knip-config.js

@@ -0,0 +1,240 @@
+#!/usr/bin/env node
+
+/**
+ * Merges the base knip config with an optional project-local knip.json,
+ * then applies dynamic detection rules based on the project's package.json and file structure.
+ *
+ * Usage: node merge-knip-config.js <base.json> [project-knip.json]
+ *
+ * Merge rules:
+ *   - Arrays (ignoreDependencies, ignoreBinaries, ignore): concatenated and deduplicated
+ *   - Objects (rules, vitest, etc.): project values override base
+ *   - Scalars (project, entry): project value wins
+ *   - $schema is always stripped from output
+ *
+ * Dynamic detection:
+ *   - Published library (main/exports/publishConfig) → disable exports/types/files rules
+ *   - Auto-ignore docs/**, fixtures/**, expected/** convention paths
+ *   - Vitest workspace workaround → explicit vitest config when vitest is a dependency
+ */
+
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+
+const basePath = process.argv[2];
+const projectPath = process.argv[3];
+
+const base = JSON.parse(readFileSync(basePath, 'utf8'));
+
+let project = {};
+if (projectPath) {
+    project = JSON.parse(readFileSync(projectPath, 'utf8'));
+}
+
+const ARRAY_KEYS = new Set(['ignore', 'ignoreBinaries', 'ignoreDependencies', 'entry', 'project']);
+
+const merged = {};
+const allKeys = new Set([...Object.keys(base), ...Object.keys(project)]);
+
+for (const key of allKeys) {
+    if (key === '$schema') {
+        continue;
+    }
+
+    const bVal = base[key];
+    const pVal = project[key];
+
+    if (pVal === undefined) {
+        merged[key] = bVal;
+    } else if (bVal === undefined) {
+        merged[key] = pVal;
+    } else if (ARRAY_KEYS.has(key) && Array.isArray(bVal) && Array.isArray(pVal)) {
+        merged[key] = [...new Set([...bVal, ...pVal])];
+    } else if (typeof bVal === 'object' && typeof pVal === 'object' && !Array.isArray(bVal)) {
+        merged[key] = { ...bVal, ...pVal };
+    } else {
+        merged[key] = pVal;
+    }
+}
+
+// --- Dynamic detection ---
+
+let pkg = {};
+if (existsSync('package.json')) {
+    pkg = JSON.parse(readFileSync('package.json', 'utf8'));
+}
+
+// 1. Published library → disable exports/types/files rules
+if (pkg.main || pkg.exports || pkg.publishConfig) {
+    merged.rules = { exports: 'off', files: 'off', types: 'off', ...merged.rules };
+}
+
+// 2. Auto-ignore convention paths that exist on disk
+const conventionIgnores = [];
+if (existsSync('docs')) {
+    conventionIgnores.push('docs/**');
+}
+
+// Scan for fixtures/** and expected/** directories anywhere in the tree (up to 3 levels)
+const scanDirs = ['tests', 'test', 'src'];
+for (const root of scanDirs) {
+    if (!existsSync(root)) {
+        continue;
+    }
+    findConventionDirs(root, 0);
+}
+
+function findConventionDirs(dir, depth) {
+    if (depth > 3) {
+        return;
+    }
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        if (entry.name === 'fixtures' || entry.name === 'expected') {
+            conventionIgnores.push(`${dir}/${entry.name}/**`);
+        } else if (entry.name !== 'node_modules') {
+            findConventionDirs(`${dir}/${entry.name}`, depth + 1);
+        }
+    }
+}
+
+if (conventionIgnores.length > 0) {
+    const existing = merged.ignore || [];
+    merged.ignore = [...new Set([...existing, ...conventionIgnores])];
+}
+
+// 3. Vitest workspace workaround — knip crashes on vitest.workspace.ts
+//    If vitest is a dependency, explicitly set the vitest config to avoid the workspace file
+const allDeps = { ...pkg.dependencies, ...pkg.devDependencies, ...pkg.peerDependencies };
+if (allDeps.vitest && !merged.vitest) {
+    if (existsSync('vitest.config.ts')) {
+        merged.vitest = { config: ['vitest.config.ts'] };
+    } else if (existsSync('vitest.config.js')) {
+        merged.vitest = { config: ['vitest.config.js'] };
+    } else if (existsSync('vitest.workspace.ts')) {
+        merged.vitest = { config: ['vitest.workspace.ts'] };
+    } else if (existsSync('vitest.workspace.js')) {
+        merged.vitest = { config: ['vitest.workspace.js'] };
+    }
+}
+
+// Also ignore vitest.workspace.ts if it exists (knip can't parse it)
+if (existsSync('vitest.workspace.ts') || existsSync('vitest.workspace.js')) {
+    const existing = merged.ignore || [];
+    const wsFile = existsSync('vitest.workspace.ts')
+        ? 'vitest.workspace.ts'
+        : 'vitest.workspace.js';
+    merged.ignore = [...new Set([...existing, wsFile])];
+}
+
+// 4. Playwright at non-standard paths + string-referenced global hooks.
+//    Knip auto-discovers `playwright.config.ts` at the repo root, but
+//    Projects that keep their browser tests under a dedicated subdir
+//    (e.g. `web/playwright.config.ts`, `e2e/playwright.config.ts`,
+//    `tests/playwright.config.ts`) need an explicit entry. The global
+//    Setup/teardown files next to that config are referenced as plain
+//    Strings from `playwright.config.ts`, so knip can't trace them —
+//    Add them as entries when they exist.
+if (allDeps['@playwright/test'] || allDeps.playwright) {
+    const playwrightSearchPaths = [
+        'web/playwright.config.ts',
+        'web/playwright.config.js',
+        'e2e/playwright.config.ts',
+        'e2e/playwright.config.js',
+        'tests/playwright.config.ts',
+        'tests/playwright.config.js',
+    ];
+    const playwrightEntries = [];
+    for (const configPath of playwrightSearchPaths) {
+        if (!existsSync(configPath)) {
+            continue;
+        }
+        playwrightEntries.push(configPath);
+        const configDir = configPath.slice(0, configPath.lastIndexOf('/'));
+        for (const hook of [
+            `${configDir}/setup/global-setup.ts`,
+            `${configDir}/setup/global-teardown.ts`,
+            `${configDir}/setup/global-setup.js`,
+            `${configDir}/setup/global-teardown.js`,
+        ]) {
+            if (existsSync(hook)) {
+                playwrightEntries.push(hook);
+            }
+        }
+    }
+    if (playwrightEntries.length > 0) {
+        const existing = merged.entry || [];
+        merged.entry = [...new Set([...existing, ...playwrightEntries])];
+    }
+}
+
+// 5. Auto-ignore plugin/addon dependencies for known parent packages
+const prodDeps = Object.keys(pkg.dependencies || {});
+const devDeps = Object.keys(pkg.devDependencies || {});
+const peerDeps = Object.keys(pkg.peerDependencies || {});
+const allDepNames = Object.keys(allDeps);
+const autoIgnoreDeps = [];
+
+// DevDependencies that are also peerDependencies (installed locally for testing)
+for (const dep of devDeps) {
+    if (peerDeps.includes(dep)) {
+        autoIgnoreDeps.push(dep);
+    }
+}
+
+for (const dep of [...prodDeps, ...devDeps]) {
+    // @scope/sub-package when the unscoped root is a peer or dependency
+    // E.g. @hono/node-server → hono
+    const scopeMatch = dep.match(/^@(?<scope>[^/]+)\//);
+    if (
+        scopeMatch &&
+        (peerDeps.includes(scopeMatch.groups.scope) ||
+            allDepNames.includes(scopeMatch.groups.scope))
+    ) {
+        autoIgnoreDeps.push(dep);
+        continue;
+    }
+
+    // <parent>-plugin-* or <parent>-preset-* when <parent> is installed
+    // E.g. vitepress-plugin-llms → vitepress
+    const pluginMatch = dep.match(/^(?<parent>.+?)-(?:plugin|preset|transformer|loader)-/);
+    if (pluginMatch && allDepNames.includes(pluginMatch.groups.parent)) {
+        autoIgnoreDeps.push(dep);
+        continue;
+    }
+
+    // eslint-plugin-* — always a runtime plugin loaded by config, never imported
+    if (dep.startsWith('eslint-plugin-')) {
+        autoIgnoreDeps.push(dep);
+    }
+}
+
+// 5. Auto-ignore production dependencies that provide binaries
+//    When a binary-only tool is in "dependencies", it's shipped for consumers (e.g. @jterrazz/typescript ships oxlint)
+for (const dep of prodDeps) {
+    if (autoIgnoreDeps.includes(dep)) {
+        continue;
+    }
+    try {
+        const depPkg = JSON.parse(readFileSync(`node_modules/${dep}/package.json`, 'utf8'));
+        if (depPkg.bin && Object.keys(depPkg.bin).length > 0) {
+            autoIgnoreDeps.push(dep);
+        }
+    } catch {
+        // Dep not installed locally — skip
+    }
+}
+
+if (autoIgnoreDeps.length > 0) {
+    const existing = merged.ignoreDependencies || [];
+    merged.ignoreDependencies = [...new Set([...existing, ...autoIgnoreDeps])];
+}
+
+process.stdout.write(JSON.stringify(merged));

package/bin/typescript.sh

@@ -90,26 +90,34 @@ case "$COMMAND" in
     docs)
         printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} Generating API docs...\n\n"
 
-        bash "$SCRIPT_DIR/generate-docs.sh" "$PROJECT_ROOT" "$PACKAGE_ROOT"
+        bash "$SCRIPT_DIR/commands/docs.sh" "$PROJECT_ROOT" "$PACKAGE_ROOT"
 
         printf "\n${GREEN}Docs generated at .docs/${NC}\n"
         ;;
 
+    check|fix)
+        exec bash "$SCRIPT_DIR/commands/check.sh" "$COMMAND" "$@"
+        ;;
+
     *)
-        printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} TypeScript/Node project toolkit\n\n"
+        printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} TypeScript toolchain\n\n"
         printf "Usage: typescript <command>\n\n"
         printf "Commands:\n"
         printf "  build     Build application (ESM + types)\n"
         printf "  bundle    Bundle library (ESM + CJS + types)\n"
         printf "  start     Run the built application\n"
         printf "  dev       Build, run, and rebuild on changes\n"
-        printf "  docs      Generate API reference + llms.txt from TSDoc\n\n"
+        printf "  docs      Generate API reference + llms.txt from TSDoc\n"
+        printf "  check     Check types, lint, formatting, and unused code\n"
+        printf "  fix       Auto-fix lint and formatting issues\n\n"
         printf "Examples:\n"
         printf "  typescript build\n"
         printf "  typescript bundle\n"
         printf "  typescript start\n"
         printf "  typescript dev\n"
         printf "  typescript docs\n"
+        printf "  typescript check\n"
+        printf "  typescript fix\n"
         exit 1
         ;;
 esac

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jterrazz/typescript",
-    "version": "5.3.0",
+    "version": "6.0.0",
     "author": "Jean-Baptiste Terrazzoni <contact@jterrazz.com>",
     "repository": {
         "type": "git",
@@ -11,25 +11,38 @@
     },
     "files": [
         "bin",
-        "presets"
+        "presets",
+        "src"
     ],
     "type": "module",
+    "main": "src/index.js",
+    "exports": {
+        ".": "./src/index.js",
+        "./tsconfig/*": "./presets/tsconfig/*.json",
+        "./tsdown/*": "./presets/tsdown/*.js",
+        "./presets/tsconfig/*": "./presets/tsconfig/*.json",
+        "./presets/tsdown/*": "./presets/tsdown/*.js"
+    },
     "publishConfig": {
         "registry": "https://registry.npmjs.org/"
     },
     "scripts": {
-        "lint": "codestyle check",
-        "lint:fix": "codestyle fix",
-        "test": "vitest --run",
-        "build": "# no build script"
+        "build": "# no build script",
+        "lint": "./bin/typescript.sh check --ignore-pattern '**/fixtures/**'",
+        "lint:fix": "./bin/typescript.sh fix --ignore-pattern '**/fixtures/**'",
+        "test": "vitest --run"
     },
     "dependencies": {
+        "@typescript/native-preview": "^7.0.0-dev.20260327.2",
+        "eslint-plugin-perfectionist": "^5.7.0",
+        "knip": "^6.2.0",
+        "oxfmt": "^0.42.0",
+        "oxlint": "^1.57.0",
         "tsdown": "^0.21.5",
         "typedoc": "^0.28.19",
         "typedoc-plugin-markdown": "^4.11.0"
     },
     "devDependencies": {
-        "@jterrazz/codestyle": "^3.0.9",
         "@jterrazz/test": "^5.3.2",
         "@types/node": "^25.5.0",
         "vitest": "^4.1.2"

package/presets/knip/base.json

@@ -0,0 +1,5 @@
+{
+    "$schema": "https://unpkg.com/knip@6/schema.json",
+    "ignoreDependencies": ["@jterrazz/codestyle", "@jterrazz/test", "@jterrazz/typescript"],
+    "ignoreBinaries": ["oxlint", "oxfmt"]
+}

package/presets/oxfmt/index.js

@@ -0,0 +1,12 @@
+import { defineConfig } from 'oxfmt';
+
+export default defineConfig({
+    printWidth: 100,
+    tabWidth: 4,
+    useTabs: false,
+    semi: true,
+    singleQuote: true,
+    trailingComma: 'all',
+    bracketSpacing: true,
+    endOfLine: 'lf',
+});

package/presets/oxlint/architectures/hexagonal-rules.js

@@ -0,0 +1,39 @@
+export default [
+    {
+        from: '/domain/',
+        disallow: [
+            '/application/',
+            '/infrastructure/',
+            '/presentation/',
+            '/di/',
+            '/config/',
+            '/generated/',
+        ],
+        message: 'Domain layer must be pure - cannot import from other layers',
+    },
+    {
+        from: '/application/use-cases/',
+        disallow: ['/infrastructure/', '/presentation/', '/di/'],
+        message: 'Use cases can only depend on domain and ports',
+    },
+    {
+        from: '/application/ports/',
+        disallow: ['/infrastructure/', '/presentation/', '/di/'],
+        message: 'Ports are interfaces - cannot depend on implementations',
+    },
+    {
+        from: '/infrastructure/inbound/',
+        disallow: ['/infrastructure/outbound/'],
+        message: 'Inbound adapters should not import outbound adapters - use DI',
+    },
+    {
+        from: '/presentation/ui/(atoms|molecules)/',
+        disallow: ['/navigation/'],
+        message: 'Atoms and molecules must be pure - no navigation imports',
+    },
+    {
+        from: '/presentation/features/',
+        disallow: ['/presentation/features/(?!common)'],
+        message: 'Features should be independent - use shared code in features/common',
+    },
+];

package/presets/oxlint/architectures/hexagonal.js

@@ -0,0 +1,13 @@
+import { resolve } from 'node:path';
+import { defineConfig } from 'oxlint';
+
+import defaultRules from './hexagonal-rules.js';
+
+const pluginPath = resolve(import.meta.dirname, '../plugins/codestyle.js');
+
+export default defineConfig({
+    jsPlugins: [pluginPath],
+    rules: {
+        'codestyle/arch-hexagonal': ['error', { rules: defaultRules }],
+    },
+});

package/presets/oxlint/base.js

@@ -0,0 +1,128 @@
+import { createRequire } from 'node:module';
+import { defineConfig } from 'oxlint';
+
+const require = createRequire(import.meta.url);
+const perfectionistPath = require.resolve('eslint-plugin-perfectionist');
+
+export default defineConfig({
+    plugins: ['typescript', 'import', 'oxc', 'unicorn'],
+    jsPlugins: [perfectionistPath],
+    categories: {
+        correctness: 'error',
+        suspicious: 'error',
+        perf: 'error',
+        pedantic: 'off',
+        style: 'error',
+        nursery: 'off',
+    },
+    rules: {
+        // ============================================
+        // ENABLED RULES
+        // ============================================
+
+        'no-unused-vars': 'error',
+
+        // -- TypeScript --
+        'typescript/consistent-type-imports': [
+            'error',
+            {
+                disallowTypeAnnotations: true,
+                fixStyle: 'inline-type-imports',
+                prefer: 'type-imports',
+            },
+        ],
+        'typescript/no-unused-expressions': [
+            'error',
+            {
+                allowShortCircuit: true,
+                allowTernary: true,
+                allowTaggedTemplates: true,
+            },
+        ],
+
+        // -- Perfectionist (sorting/ordering) --
+        'perfectionist/sort-heritage-clauses': ['error', { type: 'natural' }],
+        'perfectionist/sort-intersection-types': ['error', { type: 'natural' }],
+        'perfectionist/sort-jsx-props': ['error', { type: 'natural' }],
+        'perfectionist/sort-named-exports': ['error', { type: 'natural' }],
+        'perfectionist/sort-named-imports': ['error', { type: 'natural' }],
+        'perfectionist/sort-union-types': ['error', { type: 'natural' }],
+        'perfectionist/sort-imports': [
+            'error',
+            {
+                type: 'alphabetical',
+                order: 'asc',
+                ignoreCase: true,
+                newlinesBetween: 1,
+                groups: [
+                    ['builtin', 'external'],
+                    'internal',
+                    ['parent', 'sibling', 'index'],
+                    'style',
+                    'unknown',
+                ],
+            },
+        ],
+
+        // ============================================
+        // DISABLED - Conflicts with perfectionist
+        // ============================================
+
+        'sort-keys': 'off',
+        'sort-imports': 'off',
+
+        // ============================================
+        // DISABLED - Too strict / opinionated
+        // ============================================
+
+        'func-style': 'off',
+        'no-magic-numbers': 'off',
+        'no-ternary': 'off',
+        'init-declarations': 'off',
+        'id-length': 'off',
+        'max-statements': 'off',
+        'max-params': 'off',
+        'no-continue': 'off',
+        'arrow-body-style': 'off',
+        'prefer-destructuring': 'off',
+        'new-cap': 'off',
+        'no-await-in-loop': 'off',
+        'typescript/consistent-type-definitions': 'off',
+        'typescript/array-type': 'off',
+        'typescript/no-inferrable-types': 'off',
+        'unicorn/no-null': 'off',
+        'unicorn/no-array-sort': 'off',
+        'import/no-unassigned-import': 'off',
+        'import/no-named-default': 'off',
+        'import/no-nodejs-modules': 'off',
+
+        // ============================================
+        // ENABLED - Code style enforcement
+        // ============================================
+
+        'capitalized-comments': 'error',
+        curly: 'error',
+        'no-nested-ternary': 'error',
+        'unicorn/catch-error-name': 'error',
+        'unicorn/numeric-separators-style': 'error',
+
+        // ============================================
+        // DISABLED - Conflicts with other rules
+        // ============================================
+
+        'import/no-named-export': 'off',
+        'import/consistent-type-specifier-style': 'off',
+        'import/prefer-default-export': 'off',
+        'import/no-default-export': 'off',
+        'import/group-exports': 'off',
+        'import/no-anonymous-default-export': 'off',
+
+        // ============================================
+        // ENABLED - Clean imports
+        // ============================================
+
+        'import/first': 'error',
+        'import/no-namespace': 'error',
+    },
+    ignorePatterns: ['dist/**', 'node_modules/**'],
+});

package/presets/oxlint/expo.js

@@ -0,0 +1,33 @@
+import { resolve } from 'node:path';
+import { defineConfig } from 'oxlint';
+
+import base from './base.js';
+
+const pluginPath = resolve(import.meta.dirname, 'plugins/codestyle.js');
+
+export default defineConfig({
+    extends: [base],
+    plugins: ['typescript', 'import', 'react'],
+    jsPlugins: [pluginPath],
+    rules: {
+        'typescript/no-require-imports': [
+            'error',
+            {
+                allow: [
+                    String.raw`\.png$`,
+                    String.raw`\.jpg$`,
+                    String.raw`\.jpeg$`,
+                    String.raw`\.gif$`,
+                    String.raw`\.webp$`,
+                ],
+            },
+        ],
+        'codestyle/imports-without-ext': 'error',
+        'react/react-in-jsx-scope': 'off',
+        'react/jsx-props-no-spreading': 'off',
+        'react/jsx-boolean-value': 'off',
+        'react/jsx-handler-names': 'off',
+        'react/jsx-curly-brace-presence': 'off',
+        'unicorn/no-nested-ternary': 'off',
+    },
+});

package/presets/oxlint/next.js

@@ -0,0 +1,23 @@
+import { resolve } from 'node:path';
+import { defineConfig } from 'oxlint';
+
+import base from './base.js';
+
+const pluginPath = resolve(import.meta.dirname, 'plugins/codestyle.js');
+
+export default defineConfig({
+    extends: [base],
+    plugins: ['typescript', 'import', 'react', 'nextjs'],
+    jsPlugins: [pluginPath],
+    ignorePatterns: ['dist/**', 'node_modules/**', '.next/**', 'next-env.d.ts'],
+    rules: {
+        'codestyle/imports-without-ext': 'error',
+        'react/react-in-jsx-scope': 'off',
+        'react/jsx-props-no-spreading': 'off',
+        'react/jsx-boolean-value': 'off',
+        'react/jsx-handler-names': 'off',
+        'react/jsx-curly-brace-presence': 'off',
+        'react/jsx-max-depth': 'off',
+        'unicorn/no-nested-ternary': 'off',
+    },
+});

package/presets/oxlint/node.js

@@ -0,0 +1,14 @@
+import { resolve } from 'node:path';
+import { defineConfig } from 'oxlint';
+
+import base from './base.js';
+
+const pluginPath = resolve(import.meta.dirname, 'plugins/codestyle.js');
+
+export default defineConfig({
+    extends: [base],
+    jsPlugins: [pluginPath],
+    rules: {
+        'codestyle/imports-with-ext': 'error',
+    },
+});

package/presets/oxlint/plugins/codestyle.js

@@ -0,0 +1,194 @@
+// Codestyle plugin - custom rules for code quality
+// Contains: architecture boundaries, import extensions
+
+import defaultHexagonalRules from '../architectures/hexagonal-rules.js';
+
+// ============================================
+// Hexagonal - Architecture boundary rules
+// ============================================
+
+function createHexagonalRule() {
+    return {
+        meta: {
+            type: 'problem',
+            docs: {
+                description: 'Enforce hexagonal architecture layer boundaries',
+                category: 'Best Practices',
+            },
+            schema: [
+                {
+                    type: 'object',
+                    properties: {
+                        rules: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    from: { type: 'string' },
+                                    disallow: { type: 'array', items: { type: 'string' } },
+                                    message: { type: 'string' },
+                                },
+                                required: ['from', 'disallow'],
+                            },
+                        },
+                    },
+                },
+            ],
+        },
+        create(context) {
+            const options = context.options[0];
+            const rules = options && options.rules ? options.rules : defaultHexagonalRules;
+            const filename = context.getFilename();
+
+            function checkNode(node) {
+                if (!node.source || !node.source.value) {
+                    return;
+                }
+
+                const importPath = node.source.value;
+
+                for (const rule of rules) {
+                    const fromPattern = new RegExp(rule.from);
+                    if (!fromPattern.test(filename)) {
+                        continue;
+                    }
+
+                    for (const disallowPattern of rule.disallow) {
+                        if (new RegExp(disallowPattern).test(importPath)) {
+                            context.report({
+                                node: node.source,
+                                message: rule.message || 'Import violates architecture boundaries',
+                            });
+                            break;
+                        }
+                    }
+                }
+            }
+
+            return {
+                ImportDeclaration: checkNode,
+                ExportNamedDeclaration: checkNode,
+                ExportAllDeclaration: checkNode,
+            };
+        },
+    };
+}
+
+// ============================================
+// Imports-with-ext - Require .js extensions
+// ============================================
+
+const importsWithExtRule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Require .js extension in imports for Node.js ESM compatibility',
+            category: 'Best Practices',
+        },
+        fixable: 'code',
+        schema: [],
+    },
+    create(context) {
+        const hasExtension = /\.[a-zA-Z0-9]+$/;
+
+        function checkNode(node) {
+            if (!node.source || !node.source.value) {
+                return;
+            }
+
+            const importPath = node.source.value;
+
+            // Only check relative imports
+            if (!importPath.startsWith('.')) {
+                return;
+            }
+
+            // Skip if it already has an extension
+            if (hasExtension.test(importPath)) {
+                return;
+            }
+
+            // Skip type-only imports (they are erased at runtime)
+            if (node.importKind === 'type') {
+                return;
+            }
+
+            context.report({
+                node: node.source,
+                message: 'Missing .js extension in import (required for Node.js ESM)',
+                fix(fixer) {
+                    const newPath = `${importPath}.js`;
+                    return fixer.replaceText(node.source, `'${newPath}'`);
+                },
+            });
+        }
+
+        return {
+            ImportDeclaration: checkNode,
+            ExportNamedDeclaration: checkNode,
+            ExportAllDeclaration: checkNode,
+        };
+    },
+};
+
+// ============================================
+// Imports-without-ext - Remove extensions
+// ============================================
+
+const importsWithoutExtRule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Remove .js, .jsx, .ts, .tsx extensions from imports',
+            category: 'Best Practices',
+        },
+        fixable: 'code',
+        schema: [],
+    },
+    create(context) {
+        const extensionsToRemove = /\.(?:js|jsx|ts|tsx)$/;
+
+        function checkNode(node) {
+            if (!node.source || !node.source.value) {
+                return;
+            }
+
+            const importPath = node.source.value;
+
+            // Check both relative imports and path alias imports
+            if (!importPath.startsWith('.') && !importPath.startsWith('@/')) {
+                return;
+            }
+
+            if (extensionsToRemove.test(importPath)) {
+                const match = importPath.match(extensionsToRemove);
+                context.report({
+                    node: node.source,
+                    message: `Remove "${match[0]}" extension from import`,
+                    fix(fixer) {
+                        const newPath = importPath.replace(extensionsToRemove, '');
+                        return fixer.replaceText(node.source, `'${newPath}'`);
+                    },
+                });
+            }
+        }
+
+        return {
+            ImportDeclaration: checkNode,
+            ExportNamedDeclaration: checkNode,
+            ExportAllDeclaration: checkNode,
+        };
+    },
+};
+
+export default {
+    meta: {
+        name: 'codestyle',
+        version: '1.0.0',
+    },
+    rules: {
+        'arch-hexagonal': createHexagonalRule(),
+        'imports-with-ext': importsWithExtRule,
+        'imports-without-ext': importsWithoutExtRule,
+    },
+};

package/src/index.js

@@ -0,0 +1,16 @@
+import oxfmtConfig from '../presets/oxfmt/index.js';
+import hexagonalConfig from '../presets/oxlint/architectures/hexagonal.js';
+import expoConfig from '../presets/oxlint/expo.js';
+import nextConfig from '../presets/oxlint/next.js';
+import nodeConfig from '../presets/oxlint/node.js';
+
+export const oxfmt = oxfmtConfig;
+
+export const oxlint = {
+    expo: expoConfig,
+    hexagonal: hexagonalConfig,
+    next: nextConfig,
+    node: nodeConfig,
+};
+
+export default { oxfmt, oxlint };