@kb-labs/devkit 1.0.0

package/eslint/node.js

@@ -0,0 +1,134 @@
+
+import tseslint from 'typescript-eslint'
+import importPlugin from 'eslint-plugin-import'
+import unusedImports from 'eslint-plugin-unused-imports'
+import sonarjs from 'eslint-plugin-sonarjs'
+
+export default [
+  // ---- ignore common build artifacts and generated files
+  {
+    ignores: [
+      '/dist/',
+      '/coverage/',
+      '/.yalc/',
+      '/node_modules/',
+      '**/dist/**',
+      '**/coverage/**',
+      '**/node_modules/**',
+      '**/*.d.ts',
+      '**/scripts/**',
+      '**/eslint.config.*',
+      '**/bootstrap.js'
+    ]
+  },
+
+  // ---- base TypeScript recommendations
+  ...tseslint.configs.recommended,
+
+  // ---- project-wide rules and import resolver
+  {
+    plugins: {
+      import: importPlugin,
+      'unused-imports': unusedImports,
+      sonarjs: sonarjs,
+    },
+    settings: {
+      // Let eslint-plugin-import resolve TS paths and packages without extensions
+      'import/resolver': {
+        typescript: {
+          alwaysTryTypes: true,
+          project: ['./tsconfig.json'],
+        },
+      },
+    },
+    languageOptions: {
+      // Basic TypeScript parsing without requiring project setup
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      // Allow bare imports without file extensions for TS/JS in ESM projects
+      'import/extensions': ['error', 'ignorePackages', {
+        ts: 'never', tsx: 'never', mts: 'never', cts: 'never',
+        js: 'never', mjs: 'never', cjs: 'never',
+      }],
+
+      // Allow dev dependencies in tests, configs and scripts
+      'import/no-extraneous-dependencies': ['error', {
+        devDependencies: [
+          '**/*.{test,spec}.{ts,tsx,js,jsx,mts,cts}',
+          '**/__tests__/**',
+          '**/vite.config.*',
+          '**/vitest.config.*',
+          '**/tsup*.config.*',
+          '**/eslint.config.*',
+          '**/scripts/**',
+        ],
+      }],
+
+      // TS ergonomics - disable base rule, use unused-imports instead
+      '@typescript-eslint/no-unused-vars': 'off',
+      'unused-imports/no-unused-imports': 'error',
+      'unused-imports/no-unused-vars': ['warn', {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+        caughtErrors: 'all',
+        caughtErrorsIgnorePattern: '^_',
+      }],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/consistent-type-imports': ['warn', { prefer: 'type-imports' }],
+
+      // Async/Promise safety (non-type-aware rules only)
+      // Note: @typescript-eslint/no-floating-promises requires project setup
+      'no-return-await': 'error',
+      'no-promise-executor-return': 'error',
+      // no-await-in-loop: off globally (too noisy for CLI/fs code).
+      // Enable per-repo where it matters (rest-api, workflow).
+      'no-await-in-loop': 'off',
+
+      // Security
+      'no-eval': 'error',
+      'no-implied-eval': 'error',
+      'no-new-func': 'error',
+
+      // General safety / clarity
+      'no-console': 'off',
+      'no-debugger': 'warn',
+      'eqeqeq': ['error', 'smart'],
+      'curly': ['error', 'all'],
+      'no-throw-literal': 'error',
+      'prefer-const': 'error',
+      'no-var': 'error',
+
+      // SonarJS rules (code quality & bug detection)
+      'sonarjs/no-duplicate-string': ['warn', { threshold: 5 }],
+      'sonarjs/cognitive-complexity': ['warn', 15],
+      'sonarjs/no-identical-functions': 'warn',
+      'sonarjs/no-collapsible-if': 'warn',
+      'sonarjs/no-redundant-boolean': 'warn',
+      'sonarjs/prefer-immediate-return': 'warn',
+    },
+  },
+
+  // ---- minimal .vue support (without forcing Vue plugin)
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: { extraFileExtensions: ['.vue'] },
+    },
+  },
+
+  // ---- test file overrides
+  {
+    files: [
+      '**/*.{test,spec}.{ts,tsx,js,jsx}',
+      '**/__tests__/**/*.{ts,tsx,js,jsx}',
+    ],
+    rules: {
+      // Disable duplicate string detection in tests - test literals should be inline for readability
+      'sonarjs/no-duplicate-string': 'off',
+    },
+  },
+]

package/eslint/react.js

@@ -0,0 +1,260 @@
+import tseslint from 'typescript-eslint'
+import importPlugin from 'eslint-plugin-import'
+import reactHooks from 'eslint-plugin-react-hooks'
+import jsxA11y from 'eslint-plugin-jsx-a11y'
+import unicorn from 'eslint-plugin-unicorn'
+
+export default [
+  // ---- ignore common build artifacts and generated files
+  {
+    ignores: [
+      '**/dist/**',
+      '**/coverage/**',
+      '**/.yalc/**',
+      '**/node_modules/**',
+      '**/*.d.ts',
+      '**/scripts/**',
+      '**/*.config.js',
+      '**/*.config.ts',
+      '**/vitest-setup.ts',
+      '**/vitest.setup.ts'
+    ]
+  },
+
+  // ---- base TypeScript recommendations
+  ...tseslint.configs.recommended,
+
+  // ---- project-wide rules and import resolver
+  {
+    plugins: {
+      import: importPlugin,
+      'react-hooks': reactHooks,
+      'jsx-a11y': jsxA11y,
+      unicorn: unicorn,
+    },
+    settings: {
+      // Let eslint-plugin-import resolve TS paths and packages without extensions
+      'import/resolver': {
+        typescript: {
+          alwaysTryTypes: true,
+          project: ['./tsconfig.json'],
+        },
+      },
+    },
+    languageOptions: {
+      // Enable type-aware capabilities when available without forcing per-repo setup
+      parserOptions: {
+        projectService: true,
+      },
+      // Define globals for browser and Node.js environments
+      globals: {
+        // Browser globals
+        window: 'readonly',
+        document: 'readonly',
+        fetch: 'readonly',
+        EventSource: 'readonly',
+        MessageEvent: 'readonly',
+        URLSearchParams: 'readonly',
+        console: 'readonly',
+        localStorage: 'readonly',
+        sessionStorage: 'readonly',
+        navigator: 'readonly',
+        setTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearTimeout: 'readonly',
+        clearInterval: 'readonly',
+        crypto: 'readonly',
+
+        // Node.js globals
+        process: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        module: 'readonly',
+        require: 'readonly',
+        exports: 'readonly',
+        global: 'readonly',
+
+        // TypeScript globals
+        NodeJS: 'readonly',
+
+        // React/JSX globals
+        JSX: 'readonly',
+        HTMLElement: 'readonly',
+        HTMLInputElement: 'readonly',
+        HTMLDivElement: 'readonly',
+        React: 'readonly',
+
+        // Browser APIs
+        requestAnimationFrame: 'readonly',
+        cancelAnimationFrame: 'readonly',
+        Response: 'readonly',
+        Headers: 'readonly',
+        RequestInit: 'readonly',
+      },
+    },
+    rules: {
+      // Never use .ts/.tsx extensions, always use .js/.json extensions
+      'import/extensions': ['error', 'never', {
+        'js': 'always',
+        'json': 'always'
+      }],
+
+      // Allow dev dependencies in tests, configs and scripts
+      'import/no-extraneous-dependencies': ['error', {
+        devDependencies: [
+          '**/*.{test,spec}.{ts,tsx,js,jsx,mts,cts}',
+          '**/__tests__/**',
+          '**/vite.config.*',
+          '**/vitest.config.*',
+          '**/tsup.config.*',
+          '**/eslint.config.*',
+          '**/scripts/**',
+        ],
+      }],
+
+      // TS ergonomics
+      '@typescript-eslint/no-unused-vars': ['warn', {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+        caughtErrorsIgnorePattern: '^_'
+      }],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-empty-object-type': 'off', // Allow empty interfaces (will be extended in future)
+      '@typescript-eslint/consistent-type-imports': ['warn', { prefer: 'type-imports' }],
+
+      // CRITICAL: Catch undefined variables (missing imports)
+      'no-undef': 'error',
+
+      // Naming conventions
+      '@typescript-eslint/naming-convention': [
+        'error',
+        // Interfaces: PascalCase with optional I prefix
+        {
+          selector: 'interface',
+          format: ['PascalCase'],
+          custom: {
+            regex: '^I?[A-Z]',
+            match: true,
+          },
+        },
+        // Type aliases: PascalCase
+        {
+          selector: 'typeAlias',
+          format: ['PascalCase'],
+        },
+        // Enums: PascalCase
+        {
+          selector: 'enum',
+          format: ['PascalCase'],
+        },
+        // Classes: PascalCase
+        {
+          selector: 'class',
+          format: ['PascalCase'],
+        },
+        // Variables: camelCase or UPPER_CASE (for constants)
+        {
+          selector: 'variable',
+          format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
+          leadingUnderscore: 'allow',
+        },
+        // Functions: camelCase or PascalCase (for React components)
+        {
+          selector: 'function',
+          format: ['camelCase', 'PascalCase'],
+        },
+        // Parameters: camelCase or PascalCase (for React component parameters)
+        {
+          selector: 'parameter',
+          format: ['camelCase', 'PascalCase'],
+          leadingUnderscore: 'allow',
+        },
+        // Properties: camelCase, UPPER_CASE, or PascalCase
+        // Allow __html (React dangerouslySetInnerHTML), 2xl (Tailwind), and kebab-case for HTTP headers
+        {
+          selector: 'property',
+          format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
+          leadingUnderscore: 'allow',
+          filter: {
+            // Allow:
+            // - __html, __[a-z]+ (React internals)
+            // - --cols-sm, --text-primary (CSS variables)
+            // - 2xl, 5m, 10m (Tailwind sizes, time units)
+            // - kebab-case: chart-line, date-picker, gpt-4, claude-3-sonnet, gpt-3.5-turbo
+            // - snake_case: error_rate, plugin_failure
+            // - PascalCase-kebab: Header-Content
+            // - percentages: 0%, 100%
+            // - numeric: 50, 100, 200, 404, 500 (HTTP status codes, color values)
+            regex: '^(__|--)[a-z0-9-]+$|^[0-9]+[a-z]+$|^[a-z]+(-[a-z0-9.]+)+$|^[a-z]+(_[a-z]+)+$|^([A-Z][a-z]+-)*[A-Z][a-z]+$|^[0-9]+%$|^[0-9]+$',
+            match: false,
+          },
+        },
+        // Methods: camelCase or PascalCase (for mocked React components in tests)
+        {
+          selector: 'method',
+          format: ['camelCase', 'PascalCase'],
+        },
+      ],
+
+      // General safety / clarity
+      'no-console': 'off',
+      'no-debugger': 'warn',
+      'eqeqeq': ['error', 'smart'],
+      'curly': ['error', 'all'],
+
+      // React Hooks rules
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': 'warn',
+
+      // JSX A11y basics
+      'jsx-a11y/alt-text': 'warn',
+      'jsx-a11y/anchor-is-valid': 'warn',
+
+      // File naming conventions
+      'unicorn/filename-case': [
+        'error',
+        {
+          cases: {
+            // React components: PascalCase (MyComponent.tsx)
+            // React hooks: camelCase (useHook.ts) - matched by camelCase
+            // Utility files: kebab-case (my-util.ts)
+            // Config files: kebab-case (tsup.config.ts)
+            // Test files: kebab-case (my-component.test.tsx)
+            kebabCase: true,
+            pascalCase: true,
+            camelCase: true,
+          },
+          ignore: [
+            // Allow common patterns
+            '^.*\\.config\\.(ts|js|mjs|cjs)$',
+            '^.*\\.test\\.(ts|tsx|js|jsx)$',
+            '^.*\\.spec\\.(ts|tsx|js|jsx)$',
+            '^README\\.md$',
+            '^CHANGELOG\\.md$',
+            '^LICENSE$',
+            // Allow UI prefix pattern (UIButton.tsx, UICard.tsx, etc.)
+            '^UI[A-Z].*\\.(ts|tsx|js|jsx)$',
+          ],
+        },
+      ],
+    },
+  },
+
+  // ---- minimal .vue support (without forcing Vue plugin)
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: { extraFileExtensions: ['.vue'] },
+    },
+  },
+
+  // ---- config files: allow .js extensions for ESM compatibility
+  {
+    files: ['**/*.config.{ts,js,mjs,cjs}', '**/tsup.config.ts', '**/vite.config.ts', '**/vitest.config.ts'],
+    rules: {
+      'import/extensions': 'off',
+    },
+  },
+]
+

package/package.json

@@ -0,0 +1,186 @@
+{
+  "name": "@kb-labs/devkit",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Shared developer toolkit for KB Labs projects: TS/ESLint/Prettier/Vitest/Tsup presets and reusable GitHub Actions.",
+  "files": [
+    "agents",
+    ".cursorrules",
+    "tsconfig",
+    "eslint",
+    "prettier",
+    "vitest",
+    "vite",
+    "tsup",
+    "templates",
+    ".github",
+    ".vscode",
+    "bin",
+    "sync",
+    "AGENTS.md",
+    ".github",
+    ".github/workflow-templates/**",
+    ".github/actions/**"
+  ],
+  "bin": {
+    "kb-devkit-sync": "./bin/devkit-sync.mjs",
+    "kb-devkit-paths": "./bin/devkit-paths.mjs",
+    "kb-devkit-tsup-external": "./bin/devkit-tsup-external.mjs",
+    "kb-devkit-validate-naming": "./bin/devkit-validate-naming.mjs",
+    "kb-devkit-check-imports": "./bin/devkit-check-imports.mjs",
+    "kb-devkit-check-exports": "./bin/devkit-check-exports.mjs",
+    "kb-devkit-check-duplicates": "./bin/devkit-check-duplicates.mjs",
+    "kb-devkit-check-structure": "./bin/devkit-check-structure.mjs",
+    "kb-devkit-check-commands": "./bin/devkit-check-commands.mjs",
+    "kb-devkit-check-types": "./bin/devkit-check-types.mjs",
+    "kb-devkit-check-configs": "./bin/devkit-check-configs.mjs",
+    "kb-devkit-check-scripts": "./bin/devkit-check-scripts.mjs",
+    "kb-devkit-migrate-configs": "./bin/devkit-migrate-configs.mjs",
+    "kb-devkit-types-audit": "./bin/devkit-types-audit.mjs",
+    "kb-devkit-build-order": "./bin/devkit-build-order.mjs",
+    "kb-devkit-types-order": "./bin/devkit-types-order.mjs",
+    "kb-devkit-visualize": "./bin/devkit-visualize.mjs",
+    "kb-devkit-ci": "./bin/devkit-ci.mjs",
+    "kb-devkit-fix-deps": "./bin/devkit-fix-deps.mjs",
+    "kb-devkit-stats": "./bin/devkit-stats.mjs",
+    "kb-devkit-check-paths": "./bin/devkit-check-paths.mjs",
+    "kb-devkit-architecture": "./bin/devkit-architecture.mjs",
+    "kb-devkit-freshness": "./bin/devkit-freshness.mjs",
+    "kb-devkit-check-deprecated": "./bin/devkit-check-deprecated.mjs",
+    "kb-devkit-check-build-readiness": "./bin/devkit-check-build-readiness.mjs",
+    "kb-devkit-health": "./bin/devkit-health.mjs",
+    "kb-devkit-qa": "./bin/kb-devkit-qa.mjs",
+    "kb-devkit-qa-history": "./bin/kb-devkit-qa-history.mjs",
+    "kb-devkit-core-gate": "./bin/devkit-core-gate.mjs"
+  },
+  "exports": {
+    "./tsconfig/": "./tsconfig/",
+    "./tsconfig/base.json": "./tsconfig/base.json",
+    "./tsconfig/cli.json": "./tsconfig/cli.json",
+    "./tsconfig/lib.json": "./tsconfig/lib.json",
+    "./tsconfig/node.json": "./tsconfig/node.json",
+    "./tsconfig/react-lib.json": "./tsconfig/react-lib.json",
+    "./tsconfig/react-app.json": "./tsconfig/react-app.json",
+    "./tsconfig/test.json": "./tsconfig/test.json",
+    "./eslint/": "./eslint/",
+    "./eslint/node.js": "./eslint/node.js",
+    "./eslint/react.js": "./eslint/react.js",
+    "./eslint/node": "./eslint/node.js",
+    "./eslint/react": "./eslint/react.js",
+    "./prettier/": "./prettier/",
+    "./prettier/index.json": "./prettier/index.json",
+    "./vitest/": "./vitest/",
+    "./vitest/node.js": "./vitest/node.js",
+    "./vitest/react.js": "./vitest/react.js",
+    "./vitest/node": "./vitest/node.js",
+    "./vitest/react": "./vitest/react.js",
+    "./vite/": "./vite/",
+    "./vite/react-app.js": "./vite/react-app.js",
+    "./vite/react-app": "./vite/react-app.js",
+    "./tsup/": "./tsup/",
+    "./tsup/bin.js": "./tsup/bin.js",
+    "./tsup/dual.js": "./tsup/dual.js",
+    "./tsup/node.js": "./tsup/node.js",
+    "./tsup/react-lib.js": "./tsup/react-lib.js",
+    "./tsup/sdk.js": "./tsup/sdk.js",
+    "./tsup/node": "./tsup/node.js",
+    "./tsup/react-lib": "./tsup/react-lib.js",
+    "./tsup/bin": "./tsup/bin.js",
+    "./tsup/sdk": "./tsup/sdk.js",
+    "./tsup/dual": "./tsup/dual.js",
+    "./agents/": "./agents/",
+    "./cursorrules": "./.cursorrules",
+    "./.vscode/settings.json": "./.vscode/settings.json",
+    "./AGENTS.md": "./AGENTS.md",
+    "./bin/devkit-sync.mjs": "./bin/devkit-sync.mjs",
+    "./bin/devkit-paths.mjs": "./bin/devkit-paths.mjs",
+    "./bin/devkit-tsup-external.mjs": "./bin/devkit-tsup-external.mjs",
+    "./tsup/external.mjs": "./tsup/external.mjs",
+    "./tsup/external": "./tsup/external.mjs",
+    "./tsup/external-sync.mjs": "./tsup/external-sync.mjs",
+    "./tsup/external-sync": "./tsup/external-sync.mjs",
+    "./sync": "./sync/index.mjs"
+  },
+  "peerDependencies": {
+    "@playwright/test": "*",
+    "eslint": "^9.35.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependenciesMeta": {
+    "eslint-plugin-import": {
+      "optional": true
+    },
+    "eslint-import-resolver-typescript": {
+      "optional": true
+    },
+    "eslint-plugin-react-hooks": {
+      "optional": true
+    },
+    "eslint-plugin-jsx-a11y": {
+      "optional": true
+    },
+    "@testing-library/react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@vitejs/plugin-react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "eslint-import-resolver-typescript": "^3.10.1",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "glob": "^11.0.0",
+    "yaml": "^2.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.3",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.35.0",
+    "eslint-plugin-filenames-simple": "^0.9.0",
+    "eslint-plugin-sonarjs": "^3.0.6",
+    "eslint-plugin-unicorn": "^62.0.0",
+    "jsdom": "^27.0.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "1.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.11.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "echo \"@kb-labs/devkit: nothing to build\"",
+    "lint": "eslint . --ignore-pattern 'dist/**'",
+    "lint:fix": "eslint . --fix --ignore-pattern 'dist/**'",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest --passWithNoTests",
+    "paths": "node ./bin/devkit-paths.mjs",
+    "fixtures": "node scripts/fixtures.js –help",
+    "fixtures:check": "node scripts/fixtures.js –action=check",
+    "fixtures:lint": "node scripts/fixtures.js –action=lint",
+    "fixtures:test": "node scripts/fixtures.js –action=test",
+    "fixtures:build": "node scripts/fixtures.js –action=build",
+    "fixtures:bootstrap": "node scripts/fixtures.js –action=bootstrap",
+    "fixtures:clean": "node scripts/fixtures.js –action=clean",
+    "fixtures:ci": "node scripts/fixtures.js –action=check –since=${GITHUB_BASE_REF:-origin/main} –concurrency=3 || node scripts/fixtures.js –action=check",
+    "postinstall": "kb-devkit-tsup-external --generate || true",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "type-check": "tsc --noEmit"
+  }
+}

package/prettier/index.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}