@jterrazz/codestyle 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jean-Baptiste Terrazzoni <contact@jterrazz.com>
+
+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,125 @@
+_Hey there - I'm Jean-Baptiste, just another developer doing weird things with code. All my projects live on [jterrazz.com](https://jterrazz.com) - complete with backstories and lessons learned. Feel free to poke around - you might just find something useful!_
+
+# @jterrazz/codestyle
+
+Unified lint/format configs to standardize TypeScript codebases with Oxlint + Oxfmt.
+
+## Installation
+
+Install the package using npm:
+
+```bash
+npm install @jterrazz/codestyle --save-dev
+```
+
+## Usage
+
+### Oxlint Configuration
+
+Choose the configuration that matches your environment:
+
+**For Node.js projects:**
+
+```json
+// oxlint.json
+{
+    "extends": ["@jterrazz/codestyle/oxlint/node"]
+}
+```
+
+**For Expo/React Native projects:**
+
+```json
+// oxlint.json
+{
+    "extends": ["@jterrazz/codestyle/oxlint/expo"]
+}
+```
+
+**For Next.js projects:**
+
+```json
+// oxlint.json
+{
+    "extends": ["@jterrazz/codestyle/oxlint/nextjs"]
+}
+```
+
+### Oxfmt Configuration
+
+```json
+// oxfmt.json
+{
+    "extends": ["@jterrazz/codestyle/oxfmt"]
+}
+```
+
+## Features
+
+### Environment-Specific Configurations
+
+**Node.js Configuration:**
+
+- Requires explicit file extensions (`.js`) for imports
+- Optimized for Node.js patterns
+
+**Expo/React Native Configuration:**
+
+- No file extensions in imports (auto-fixed)
+- React plugin enabled
+
+**Next.js Configuration:**
+
+- No file extensions in imports (Turbopack compatibility, auto-fixed)
+- React and Next.js plugins enabled
+
+### Shared Features
+
+- **TypeScript**: Strict type checking with consistent type imports
+- **Import Sorting**: Automated import organization with architectural grouping (via perfectionist)
+- **Code Quality**: Perfectionist plugin for consistent code style
+- **Performance**: Oxlint is 50-100x faster than ESLint, Oxfmt is 10x faster than Prettier, tsgo is 10x faster than tsc
+
+## CLI Tools
+
+This package includes a CLI tool for running quality checks:
+
+```bash
+# Run all quality checks (tsgo, Oxlint, Oxfmt) in parallel
+npx codestyle
+
+# Automatically fix all fixable issues (Oxlint --fix, Oxfmt format)
+npx codestyle --fix
+
+# Run individual checks
+npx codestyle --type      # TypeScript type checking only
+npx codestyle --lint      # Linting only
+npx codestyle --format    # Format checking only
+
+# Combine flags
+npx codestyle --lint --fix    # Fix lint issues only
+npx codestyle --format --fix  # Format files only
+```
+
+## Scripts
+
+Add these scripts to your `package.json` for common development tasks:
+
+```json
+{
+    "scripts": {
+        "codestyle": "codestyle",
+        "codestyle:fix": "codestyle --fix"
+    }
+}
+```
+
+## Configuration
+
+The configurations are fully modular and include:
+
+- **Base configuration**: Common rules for TypeScript, import sorting, code quality
+- **Environment-specific**: Tailored rules for Node.js, Expo/React Native, and Next.js
+- **Custom plugins**: JS plugins for import extension enforcement
+
+Happy coding!

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@jterrazz/codestyle",
+  "version": "1.0.0",
+  "author": "Jean-Baptiste Terrazzoni <contact@jterrazz.com>",
+  "bin": {
+    "codestyle": "./src/codestyle.sh"
+  },
+  "files": [
+    "src"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./oxlint/node": "./src/oxlint/node.json",
+    "./oxlint/expo": "./src/oxlint/expo.json",
+    "./oxlint/nextjs": "./src/oxlint/nextjs.json",
+    "./oxfmt": "./src/oxfmt/index.json"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "lint": "oxlint --ignore-pattern '**/fixtures/**'",
+    "lint:fix": "oxlint --fix --ignore-pattern '**/fixtures/**'",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "build": "# no build script"
+  },
+  "dependencies": {
+    "@typescript/native-preview": "^7.0.0-dev",
+    "eslint-plugin-perfectionist": "^4.15.1",
+    "oxfmt": "^0.19.0",
+    "oxlint": "^1.35.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "@types/node": "*"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
+  }
+}

package/src/codestyle.sh

@@ -0,0 +1,160 @@
+#!/bin/bash
+
+# Colors for output (using Vitest-like colors)
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+CYAN_BG='\033[46m'  # Cyan background
+BRIGHT_WHITE='\033[1;30m'  # Bold black text
+NC='\033[0m' # No Color
+
+# Parse arguments
+FIX_MODE=false
+RUN_TYPE=false
+RUN_LINT=false
+RUN_FORMAT=false
+RUN_ALL=true
+EXTRA_ARGS=()
+
+for arg in "$@"; do
+    case $arg in
+        --fix)
+            FIX_MODE=true
+            ;;
+        --type)
+            RUN_TYPE=true
+            RUN_ALL=false
+            ;;
+        --lint)
+            RUN_LINT=true
+            RUN_ALL=false
+            ;;
+        --format)
+            RUN_FORMAT=true
+            RUN_ALL=false
+            ;;
+        *)
+            EXTRA_ARGS+=("$arg")
+            ;;
+    esac
+done
+
+# If running all, enable all checks
+if [ "$RUN_ALL" = true ]; then
+    RUN_TYPE=true
+    RUN_LINT=true
+    RUN_FORMAT=true
+fi
+
+# Create a temporary directory for log files
+tmp_dir=$(mktemp -d)
+cleanup() {
+    rm -rf "$tmp_dir"
+}
+trap cleanup EXIT
+
+if [ "$FIX_MODE" = true ]; then
+    printf "${CYAN_BG}${BRIGHT_WHITE} START ${NC} Running quality fixes\n"
+else
+    printf "${CYAN_BG}${BRIGHT_WHITE} START ${NC} Running quality checks\n"
+fi
+
+# Run selected commands in parallel and save their outputs
+type_pid=""
+code_pid=""
+style_pid=""
+
+if [ "$RUN_TYPE" = true ]; then
+    tsgo --noEmit "${EXTRA_ARGS[@]}" > "$tmp_dir/type.log" 2>&1 &
+    type_pid=$!
+fi
+
+if [ "$RUN_LINT" = true ]; then
+    if [ "$FIX_MODE" = true ]; then
+        oxlint --fix "${EXTRA_ARGS[@]:-.}" > "$tmp_dir/code.log" 2>&1 &
+    else
+        oxlint "${EXTRA_ARGS[@]:-.}" > "$tmp_dir/code.log" 2>&1 &
+    fi
+    code_pid=$!
+fi
+
+if [ "$RUN_FORMAT" = true ]; then
+    if [ "$FIX_MODE" = true ]; then
+        oxfmt "${EXTRA_ARGS[@]:-.}" > "$tmp_dir/style.log" 2>&1 &
+    else
+        oxfmt --check "${EXTRA_ARGS[@]:-.}" > "$tmp_dir/style.log" 2>&1 &
+    fi
+    style_pid=$!
+fi
+
+# Function to print output with a header
+print_output() {
+    local file=$1
+    local header=$2
+    local status=$3
+
+    printf "\n${CYAN_BG}${BRIGHT_WHITE} RUN ${NC} %s\n\n" "$header"
+    if [ -s "$file" ]; then
+        cat "$file"
+    fi
+    if [ $status -ne 0 ]; then
+        printf "${RED}✗ Failed with exit code %d${NC}\n" $status
+    else
+        printf "${GREEN}✓ Passed${NC}\n"
+    fi
+}
+
+# Wait for processes and collect statuses
+type_status=0
+code_status=0
+style_status=0
+
+if [ -n "$type_pid" ]; then
+    wait $type_pid
+    type_status=$?
+fi
+
+if [ -n "$code_pid" ]; then
+    wait $code_pid
+    code_status=$?
+fi
+
+if [ -n "$style_pid" ]; then
+    wait $style_pid
+    style_status=$?
+fi
+
+# Print outputs with headers
+if [ "$RUN_TYPE" = true ]; then
+    print_output "$tmp_dir/type.log" "TypeScript Check" $type_status
+fi
+
+if [ "$RUN_LINT" = true ]; then
+    if [ "$FIX_MODE" = true ]; then
+        print_output "$tmp_dir/code.log" "Oxlint Fix" $code_status
+    else
+        print_output "$tmp_dir/code.log" "Oxlint Check" $code_status
+    fi
+fi
+
+if [ "$RUN_FORMAT" = true ]; then
+    if [ "$FIX_MODE" = true ]; then
+        print_output "$tmp_dir/style.log" "Oxfmt Format" $style_status
+    else
+        print_output "$tmp_dir/style.log" "Oxfmt Check" $style_status
+    fi
+fi
+
+# Print final 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 ] && [ $code_status -eq 0 ] && [ $style_status -eq 0 ]; then
+    printf "${GREEN}✓ All checks passed${NC}\n"
+    exit 0
+else
+    printf "${RED}✗ Some checks failed${NC}\n"
+    exit 1
+fi

package/src/index.js

@@ -0,0 +1,14 @@
+import oxfmtConfig from "./oxfmt/index.json" with { type: "json" };
+import expoConfig from "./oxlint/expo.json" with { type: "json" };
+import nextjsConfig from "./oxlint/nextjs.json" with { type: "json" };
+import nodeConfig from "./oxlint/node.json" with { type: "json" };
+
+export const oxfmt = oxfmtConfig;
+
+export const oxlint = {
+  expo: expoConfig,
+  nextjs: nextjsConfig,
+  node: nodeConfig,
+};
+
+export default { oxfmt, oxlint };

package/src/oxfmt/index.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://oxc.rs/schemas/oxfmt/0.19.0/schema.json",
+  "printWidth": 100,
+  "tabWidth": 4,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "endOfLine": "lf"
+}

package/src/oxlint/base.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+  "plugins": ["typescript", "import", "oxc"],
+  "jsPlugins": ["eslint-plugin-perfectionist"],
+  "categories": {
+    "correctness": "error",
+    "suspicious": "warn",
+    "perf": "warn",
+    "pedantic": "off",
+    "style": "warn",
+    "nursery": "off"
+  },
+  "rules": {
+    "no-unused-vars": "error",
+    "sort-keys": "off",
+    "sort-imports": "off",
+    "func-style": "off",
+    "no-magic-numbers": "off",
+    "import/no-named-export": "off",
+    "import/no-anonymous-default-export": "off",
+    "import/group-exports": "off",
+    "no-ternary": "off",
+    "init-declarations": "off",
+    "capitalized-comments": "off",
+    "id-length": "off",
+    "typescript/consistent-type-definitions": "off",
+    "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/sort-array-includes": ["error", { "type": "natural" }],
+    "perfectionist/sort-classes": ["error", { "type": "natural" }],
+    "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-switch-case": ["error", { "type": "natural" }],
+    "perfectionist/sort-union-types": ["error", { "type": "natural" }],
+    "perfectionist/sort-variable-declarations": [
+      "error",
+      { "type": "natural" }
+    ],
+    "perfectionist/sort-imports": [
+      "error",
+      {
+        "type": "alphabetical",
+        "order": "asc",
+        "ignoreCase": true,
+        "newlinesBetween": "always",
+        "groups": [
+          ["builtin", "external"],
+          "internal",
+          ["parent", "sibling", "index"],
+          "style",
+          "unknown"
+        ]
+      }
+    ]
+  },
+  "ignorePatterns": ["dist/**", "node_modules/**"]
+}

package/src/oxlint/expo.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+  "extends": ["./base.json"],
+  "plugins": ["typescript", "import", "react"],
+  "jsPlugins": ["./plugins/remove-ts-extensions.js"],
+  "rules": {
+    "typescript/no-require-imports": [
+      "error",
+      {
+        "allow": ["\\.png$", "\\.jpg$", "\\.jpeg$", "\\.gif$", "\\.webp$"]
+      }
+    ],
+    "remove-ts-extensions/remove-ts-extensions": "error"
+  }
+}

package/src/oxlint/nextjs.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+  "extends": ["./base.json"],
+  "plugins": ["typescript", "import", "react", "nextjs"],
+  "jsPlugins": ["./plugins/remove-ts-extensions.js"],
+  "ignorePatterns": ["dist/**", "node_modules/**", ".next/**", "next-env.d.ts"],
+  "rules": {
+    "remove-ts-extensions/remove-ts-extensions": "error"
+  }
+}

package/src/oxlint/node.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+  "extends": ["./base.json"],
+  "jsPlugins": ["./plugins/require-js-extensions.js"],
+  "rules": {
+    "require-js-extensions/require-js-extensions": "error"
+  }
+}

package/src/oxlint/plugins/remove-ts-extensions.js

@@ -0,0 +1,58 @@
+// Custom rule to remove TS/JS extensions from imports
+// Compatible with both ESLint and Oxlint JS plugin API
+
+const removeTsExtensionsRule = {
+  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 (starting with . or ..) AND path alias imports (starting with @/)
+      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: "remove-ts-extensions",
+    version: "1.0.0",
+  },
+  rules: {
+    "remove-ts-extensions": removeTsExtensionsRule,
+  },
+};

package/src/oxlint/plugins/require-js-extensions.js

@@ -0,0 +1,65 @@
+// Custom rule to require .js extensions in imports (for Node.js ESM)
+// Compatible with both ESLint and Oxlint JS plugin API
+
+const requireJsExtensionsRule = {
+  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,
+    };
+  },
+};
+
+export default {
+  meta: {
+    name: "require-js-extensions",
+    version: "1.0.0",
+  },
+  rules: {
+    "require-js-extensions": requireJsExtensionsRule,
+  },
+};