@zairakai/js-dev-tools 3.4.4 → 3.5.0

package/README.md

@@ -27,6 +27,7 @@ One unified toolkit to set up JavaScript/TypeScript quality tooling. Context-awa
 | **Concentrated Configs** | Centralized, opinionated configurations for all your tools. Avoid configuration drift across projects. |
 | **Unified Workflow** | One set of `make` commands to rule them all. Whether it's a small library or a large application, the quality gate remains the same. |
 | **Auto-Syncing CI** | Automatically updates GitLab CI ref tags in your `.gitlab-ci.yml` when you update the package. Keep your pipelines current without manual effort. |
+| **Shared base** | The ESLint, Prettier, Stylelint, Vitest, TypeScript and markdownlint rules live in [`@stanislas-poisson/js-dev-tools`](https://github.com/Stanislas-Poisson/js-dev-tools), which this package requires. The paths of this package (`@zairakai/js-dev-tools/eslint`, `/prettier`, ...) stay the same. |
 | **Zero Friction** | Automated setup script handles the heavy lifting on install. |
 
 ---

package/config/.markdownlint.json

@@ -1,7 +1,3 @@
 {
-  "default": true,
-  "MD013": false,
-  "MD024": {
-    "siblings_only": true
-  }
+  "extends": "@stanislas-poisson/js-dev-tools/config/.markdownlint.json"
 }

package/config/eslint.config.js

@@ -1,247 +1,2 @@
-/**
- * Default ESLint configuration for @zairakai projects.
- */
-import { includeIgnoreFile } from '@eslint/compat'
-import pluginJs from '@eslint/js'
-import pluginTypeScript from '@typescript-eslint/eslint-plugin'
-import parserTypeScript from '@typescript-eslint/parser'
-import eslintConfigPrettier from 'eslint-config-prettier'
-import pluginVue from 'eslint-plugin-vue'
-import globals from 'globals'
-import { existsSync } from 'node:fs'
-import path from 'node:path'
-
-const gitignorePath = path.resolve(process.cwd(), '.gitignore')
-const gitignoreConfig = existsSync(gitignorePath) ? [includeIgnoreFile(gitignorePath)] : []
-
-export default [
-  ...gitignoreConfig,
-
-  // Base JavaScript rules
-  pluginJs.configs.recommended,
-
-  // Vue flat config (sets up vue-eslint-parser as the Vue file parser)
-  ...pluginVue.configs['flat/strongly-recommended'],
-
-  // Base configuration for all files
-  {
-    languageOptions: {
-      globals: {
-        ...globals.browser,
-        ...globals.node,
-        ...globals.es2022,
-      },
-      parserOptions: {
-        ecmaVersion: 'latest',
-        sourceType: 'module',
-      },
-    },
-    rules: {
-      // Yoda style enforcement (Zairakai convention)
-      yoda: [
-        'error',
-        'always',
-        {
-          exceptRange: true,
-          onlyEquality: false,
-        },
-      ],
-
-      // Code quality
-      'no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-          caughtErrorsIgnorePattern: '^_',
-        },
-      ],
-      'no-unused-expressions': [
-        'error',
-        {
-          allowShortCircuit: true,
-          allowTernary: true,
-          allowTaggedTemplates: true,
-        },
-      ],
-      'no-console': [
-        'warn',
-        {
-          allow: ['warn', 'error', 'info', 'debug'],
-        },
-      ],
-      'no-debugger': 'error',
-
-      // Best practices
-      eqeqeq: [
-        'error',
-        'always',
-        {
-          null: 'ignore',
-        },
-      ],
-      curly: ['error', 'all'],
-      'prefer-const': 'error',
-      'no-var': 'error',
-      'object-shorthand': 'error',
-      'prefer-template': 'error',
-      'prefer-arrow-callback': 'error',
-
-      // Import rules
-      'sort-imports': [
-        'error',
-        {
-          ignoreDeclarationSort: true,
-          ignoreMemberSort: false,
-          memberSyntaxSortOrder: ['none', 'all', 'multiple', 'single'],
-        },
-      ],
-
-      // Vue specific rules (relaxed for flexibility)
-      'vue/multi-word-component-names': 'off',
-      'vue/require-default-prop': 'off',
-      'vue/valid-template-root': 'off',
-      'vue/no-v-html': 'warn',
-      'vue/require-v-for-key': 'error',
-      'vue/no-unused-components': 'warn',
-      'vue/component-name-in-template-casing': ['error', 'PascalCase'],
-      'vue/attribute-hyphenation': ['error', 'always'],
-      'vue/v-on-event-hyphenation': ['error', 'always'],
-    },
-  },
-
-  // TypeScript configuration for .ts / .tsx files
-  {
-    files: ['**/*.ts', '**/*.tsx'],
-    languageOptions: {
-      parser: parserTypeScript,
-      parserOptions: {
-        project: './tsconfig.json',
-      },
-    },
-    plugins: {
-      '@typescript-eslint': pluginTypeScript,
-    },
-    rules: {
-      'no-unused-vars': 'off',
-      'no-undef': 'off',
-      '@typescript-eslint/no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-          caughtErrorsIgnorePattern: '^_',
-        },
-      ],
-      '@typescript-eslint/no-explicit-any': 'warn',
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/prefer-nullish-coalescing': [
-        'error',
-        {
-          // Boolean OR (e.g. combining two route-guard flags) is not the same
-          // operation as null-coalescing: `??` only falls through on
-          // null/undefined, so `false ?? true` stays `false` where
-          // `false || true` correctly yields `true`. Forcing `??` here would
-          // silently break any logic relying on an explicit `false`.
-          ignorePrimitives: { boolean: true },
-        },
-      ],
-      '@typescript-eslint/prefer-optional-chain': 'error',
-      '@typescript-eslint/no-non-null-assertion': 'warn',
-    },
-  },
-
-  // TypeScript configuration for .vue files
-  // vue-eslint-parser (set by pluginVue above) must remain the primary parser.
-  // TypeScript parser is passed as parserOptions.parser for <script> blocks only.
-  {
-    files: ['**/*.vue'],
-    languageOptions: {
-      parserOptions: {
-        parser: parserTypeScript,
-        project: './tsconfig.json',
-        extraFileExtensions: ['.vue'],
-      },
-    },
-    plugins: {
-      '@typescript-eslint': pluginTypeScript,
-    },
-    rules: {
-      'no-unused-vars': 'off',
-      'no-undef': 'off',
-      '@typescript-eslint/no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-          caughtErrorsIgnorePattern: '^_',
-        },
-      ],
-      '@typescript-eslint/no-explicit-any': 'warn',
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/prefer-nullish-coalescing': [
-        'error',
-        {
-          // See the .ts block above for why boolean operands are exempted.
-          ignorePrimitives: { boolean: true },
-        },
-      ],
-      '@typescript-eslint/prefer-optional-chain': 'error',
-      '@typescript-eslint/no-non-null-assertion': 'warn',
-    },
-  },
-
-  // Test files
-  {
-    files: ['**/*.test.{js,ts}', '**/*.spec.{js,ts}', '**/tests/**/*'],
-    languageOptions: {
-      globals: {
-        ...globals.jest,
-        describe: 'readonly',
-        it: 'readonly',
-        test: 'readonly',
-        expect: 'readonly',
-        beforeEach: 'readonly',
-        afterEach: 'readonly',
-        beforeAll: 'readonly',
-        afterAll: 'readonly',
-        vi: 'readonly',
-      },
-    },
-    rules: {
-      '@typescript-eslint/no-explicit-any': 'off',
-      'no-console': 'off',
-    },
-  },
-
-  // Config files
-  {
-    files: ['**/*.config.{js,ts}', '**/.*rc.{js,ts}'],
-    rules: {
-      'no-console': 'off',
-      '@typescript-eslint/no-var-requires': 'off',
-    },
-  },
-
-  // Ignore patterns
-  {
-    ignores: [
-      'build/**',
-      'coverage/**',
-      'dist/**',
-      // The documentation site (VitePress) has its own tools and is not part of the package.
-      'docs/**',
-      'node_modules/**',
-      'public/**',
-      'storybook-static/**',
-      '.nuxt/**',
-      '.output/**',
-      '**/*.min.js',
-    ],
-  },
-
-  // Prettier — must be last to disable all formatting rules
-  eslintConfigPrettier,
-]
+// The rules live in @stanislas-poisson/js-dev-tools; this path stays for the projects that use it.
+export { default } from '@stanislas-poisson/js-dev-tools/eslint'

package/config/knip.config.js

@@ -1,9 +1,8 @@
 /**
  * Knip configuration for @zairakai/js-dev-tools
  *
- * This package ships bundled configs for consumer projects.
- * Many dependencies are referenced as strings (prettier plugins, stylelint configs)
- * rather than ES imports — knip cannot trace those automatically.
+ * This package re-exports the configs of @stanislas-poisson/js-dev-tools, whose dependencies are referenced as strings
+ * by the tools; knip cannot trace those automatically, so the base package is the one that lists them.
  */
 
 export default {
@@ -16,19 +15,6 @@ export default {
   exclude: ['optionalPeerDependencies'],
 
   ignoreDependencies: [
-    // Prettier plugins — referenced as strings in config/prettier.config.js
-    '@prettier/plugin-php',
-    'prettier-plugin-blade',
-    'prettier-plugin-organize-imports',
-
-    // Stylelint configs/plugins — referenced as strings in config/stylelint.config.js
-    'stylelint-config-html',
-    'stylelint-config-recommended-vue',
-    'stylelint-config-standard',
-    'stylelint-config-standard-scss',
-    'stylelint-order',
-    'stylelint-scss',
-
     // Coverage provider — referenced as string in config/vitest.config.js (provider: 'v8')
     '@vitest/coverage-v8',
 

package/config/prettier.config.js

@@ -1,121 +1,2 @@
-/**
- * Default Prettier configuration for @zairakai projects.
- */
-
-const config = {
-  // Core formatting
-  printWidth: 120,
-  tabWidth: 2,
-  useTabs: false,
-  semi: false,
-  singleQuote: true,
-  quoteProps: 'as-needed',
-  trailingComma: 'es5',
-  bracketSpacing: true,
-  bracketSameLine: false,
-  arrowParens: 'always',
-  endOfLine: 'lf',
-
-  // HTML & Vue specific
-  htmlWhitespaceSensitivity: 'css',
-  vueIndentScriptAndStyle: true,
-  singleAttributePerLine: false,
-
-  // JSX specific
-  jsxSingleQuote: true,
-
-  // Prose formatting
-  proseWrap: 'preserve',
-  embeddedLanguageFormatting: 'auto',
-
-  // Plugin configuration
-  plugins: ['prettier-plugin-blade', '@prettier/plugin-php', 'prettier-plugin-organize-imports'],
-
-  // File-specific overrides
-  overrides: [
-    // TypeScript/JavaScript files
-    {
-      files: ['*.ts', '*.tsx', '*.js', '*.jsx', '*.vue'],
-      options: {
-        semi: false,
-        singleQuote: true,
-        trailingComma: 'es5',
-      },
-    },
-
-    // Vue files
-    {
-      files: '*.vue',
-      options: {
-        vueIndentScriptAndStyle: true,
-        singleAttributePerLine: true,
-      },
-    },
-
-    // SCSS/CSS files
-    {
-      files: ['*.scss', '*.css'],
-      options: {
-        tabWidth: 2,
-        singleQuote: false,
-        trailingComma: 'es5',
-        semi: false,
-      },
-    },
-
-    // PHP/Blade files
-    {
-      files: ['*.blade.php'],
-      options: {
-        tabWidth: 4,
-        useTabs: false,
-        phpVersion: '8.3',
-        trailingCommaPHP: true,
-        semi: false,
-      },
-    },
-
-    // JSON files
-    {
-      files: ['*.json', '*.jsonc'],
-      options: {
-        tabWidth: 2,
-        trailingComma: 'none',
-        semi: false,
-      },
-    },
-
-    // YAML files
-    {
-      files: ['*.yml', '*.yaml'],
-      options: {
-        tabWidth: 2,
-        singleQuote: false,
-        bracketSpacing: false,
-        semi: false,
-      },
-    },
-
-    // Package.json files
-    {
-      files: 'package.json',
-      options: {
-        tabWidth: 2,
-        trailingComma: 'none',
-        semi: false,
-      },
-    },
-
-    // Configuration files
-    {
-      files: ['*.config.js', '*.config.ts', '.*rc.js', '.*rc.ts'],
-      options: {
-        tabWidth: 2,
-        singleQuote: true,
-        semi: false,
-      },
-    },
-  ],
-}
-
-export default config
+// The rules live in @stanislas-poisson/js-dev-tools; this path stays for the projects that use it.
+export { default } from '@stanislas-poisson/js-dev-tools/prettier'

package/config/stylelint.config.js

@@ -1,56 +1,2 @@
-/**
- * Full Stylelint config for @zairakai projects
- */
-
-export default {
-  extends: [
-    'stylelint-config-standard-scss', // Base SCSS rules
-    'stylelint-config-recommended-vue', // Vue SFC support
-    'stylelint-config-html', // HTML support
-  ],
-  plugins: ['stylelint-scss'],
-
-  overrides: [
-    // Vue files
-    {
-      files: ['*.vue', '**/*.vue'],
-      rules: {
-        'scss/at-rule-no-unknown': true,
-      },
-    },
-    // SCSS files
-    {
-      files: ['*.scss', '**/*.scss'],
-      rules: {
-        'scss/at-mixin-argumentless-call-parentheses': 'never',
-        'scss/dollar-variable-pattern': '^[_a-z0-9\\-]+$',
-        'scss/selector-no-redundant-nesting-selector': true,
-      },
-    },
-  ],
-
-  rules: {
-    // SCSS basics
-    'declaration-block-no-redundant-longhand-properties': true,
-    'length-zero-no-unit': true,
-
-    // SCSS operator & function rules
-    'scss/at-rule-no-unknown': true,
-    'scss/at-mixin-argumentless-call-parentheses': 'never',
-
-    // Naming conventions
-    'scss/dollar-variable-pattern': '^[_a-z0-9\\-]+$',
-    'scss/selector-no-redundant-nesting-selector': true,
-  },
-
-  ignoreFiles: [
-    'node_modules/**/*',
-    'dist/**/*',
-    'build/**/*',
-    'coverage/**/*',
-    'public/**/*',
-    '.nuxt/**/*',
-    '.output/**/*',
-    '**/*.min.css',
-  ],
-}
+// The rules live in @stanislas-poisson/js-dev-tools; this path stays for the projects that use it.
+export { default } from '@stanislas-poisson/js-dev-tools/stylelint'

package/config/tsconfig.base.json

@@ -1,19 +1,3 @@
 {
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "strict": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "exactOptionalPropertyTypes": true
-  }
+  "extends": "@stanislas-poisson/js-dev-tools/config/tsconfig.base.json"
 }

package/config/vitest.config.js

@@ -1,25 +1,2 @@
-/**
- * Default Vitest configuration for @zairakai packages.
- * Provides sensible defaults for TypeScript projects.
- *
- * To customize, publish this file to your project:
- *   bash node_modules/@zairakai/js-dev-tools/scripts/setup-project.sh --publish=vitest
- *
- * The published config (config/dev-tools/vitest.config.js) can extend this
- * base config and add project-specific settings (Vue plugin, jsdom, etc.).
- */
-
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'lcov', 'html', 'cobertura'],
-      reportsDirectory: 'build/coverage',
-      exclude: ['node_modules/**', 'dist/**', 'build/**', '**/*.config.*', '**/*.d.ts'],
-    },
-  },
-})
+// The defaults live in @stanislas-poisson/js-dev-tools; this path stays for the projects that use it.
+export { default } from '@stanislas-poisson/js-dev-tools/vitest'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zairakai/js-dev-tools",
-  "version": "3.4.4",
+  "version": "3.5.0",
   "description": "The unified and centralized development toolkit for JavaScript/TypeScript projects - ESLint, Prettier, Stylelint, Knip, Vitest, Git Hooks, and GitLab CI pipeline templates",
   "keywords": [
     "dev-tools",
@@ -88,27 +88,11 @@
     "validate": "make quality"
   },
   "dependencies": {
-    "@eslint/compat": "^2.1.1",
-    "@eslint/js": "^10.0.1",
-    "@prettier/plugin-php": "^0.25.0",
-    "@typescript-eslint/eslint-plugin": "^8.71.1",
-    "@typescript-eslint/parser": "^8.71.1",
+    "@stanislas-poisson/js-dev-tools": "^1.0.0",
     "eslint": "^10.12.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-vue": "^10.11.1",
-    "globals": "^17.13.0",
     "markdownlint-cli2": "^0.23.3",
     "prettier": "^3.9.9",
-    "prettier-plugin-blade": "^3.3.3",
-    "prettier-plugin-organize-imports": "^4.3.0",
-    "stylelint": "^17.16.0",
-    "stylelint-config-html": "^2.0.0",
-    "stylelint-config-recommended-vue": "^2.0.0",
-    "stylelint-config-standard": "^40.0.0",
-    "stylelint-config-standard-scss": "^17.0.0",
-    "stylelint-order": "^8.1.1",
-    "stylelint-scss": "^7.3.0",
-    "vue-eslint-parser": "^10.4.1"
+    "stylelint": "^17.16.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^5.0.3",