@zairakai/dev-tools 1.0.11

package/README.md

@@ -0,0 +1,162 @@
+# @zairakai/dev-tools
+
+[![Main][pipeline-main-badge]][pipeline-main-link]
+[![Develop][pipeline-develop-badge]][pipeline-develop-link]
+
+[![npm][npm-badge]][npm-link]
+[![GitLab Release][gitlab-release-badge]][gitlab-release]
+[![License][license-badge]][license]
+
+[![Node.js][node-badge]][node]
+[![ESLint][eslint-badge]][eslint]
+[![Prettier][prettier-badge]][prettier]
+[![Stylelint][stylelint-badge]][stylelint]
+
+One package for JavaScript/TypeScript quality tools. Zero-config by default, publish only what you want.
+
+---
+
+## Install
+
+```bash
+yarn add --dev @zairakai/dev-tools
+# or
+npm install --save-dev @zairakai/dev-tools
+```
+
+On install it will:
+
+- create `Makefile` if missing
+- create `.editorconfig`
+- create `config/dev-tools/eslint.config.js` baseline
+- suggest optional tools
+
+Laravel apps detected + `zairakai/laravel-dev-tools` installed:
+
+- the setup delegates to the Laravel full-stack setup to keep a single workflow
+
+---
+
+## Quick Start (Laravel + Vue)
+
+```bash
+composer require --dev zairakai/laravel-dev-tools
+npm install --save-dev @zairakai/dev-tools
+php artisan dev-tools:publish --fullstack
+php artisan dev-tools:publish --publish=gitlab-ci
+make quality
+```
+
+---
+
+## Use
+
+```bash
+make quality
+make test
+make ci
+```
+
+---
+
+## Tests
+
+```bash
+make test
+make bats
+```
+
+---
+
+## Publish configs (optional)
+
+```bash
+# all
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish
+
+# groups
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=quality
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=style
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=testing
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=typescript
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=gitlab-ci
+
+# single files
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=eslint
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=prettier
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=markdownlint
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=vitest
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=tsconfig
+```
+
+Published files go to `config/dev-tools/` and are never overwritten unless you use `--force`.
+
+---
+
+## GitLab CI
+
+```bash
+bash node_modules/@zairakai/dev-tools/scripts/setup-project.sh --publish=gitlab-ci
+```
+
+Laravel apps: use the full-stack CI from `zairakai/laravel-dev-tools` for one unified pipeline.
+
+---
+
+## Key make targets
+
+```bash
+make quality        # eslint + prettier + stylelint + markdownlint + shellcheck
+make quality-fix    # auto-fix
+make test           # vitest
+make typecheck      # tsc --noEmit
+make build          # tsup or tsc
+```
+
+---
+
+## Getting Help
+
+[![License][license-badge]][license]
+[![Security Policy][security-badge]][security]
+[![Issues][issues-badge]][issues]
+[![Discord][discord-badge]][discord]
+
+Built with love by the Zairakai team for JavaScript/TypeScript developers
+
+<!-- Reference Links -->
+[pipeline-main-badge]: https://gitlab.com/zairakai/npm/dev-tools/badges/main/pipeline.svg?ignore_skipped=true&key_text=Main
+[pipeline-main-link]: https://gitlab.com/zairakai/npm/dev-tools/-/commits/main
+
+[pipeline-develop-badge]: https://gitlab.com/zairakai/npm/dev-tools/badges/develop/pipeline.svg?ignore_skipped=true&key_text=Develop
+[pipeline-develop-link]: https://gitlab.com/zairakai/npm/dev-tools/-/commits/develop
+
+[npm-badge]: https://img.shields.io/npm/v/@zairakai/dev-tools
+[npm-link]: https://www.npmjs.com/package/@zairakai/dev-tools
+
+[gitlab-release-badge]: https://img.shields.io/gitlab/v/release/zairakai/npm/dev-tools?logo=gitlab
+[gitlab-release]: https://gitlab.com/zairakai/npm/dev-tools/-/releases
+
+[license-badge]: https://img.shields.io/badge/license-MIT-blue.svg
+[license]: ./LICENSE
+
+[security-badge]: https://img.shields.io/badge/security-scanned-green.svg
+[security]: ./SECURITY.md
+
+[issues-badge]: https://img.shields.io/gitlab/issues/open-raw/zairakai%2Fnpm%2Fdev-tools?logo=gitlab&label=Issues
+[issues]: https://gitlab.com/zairakai/npm/dev-tools/-/issues
+
+[discord-badge]: https://img.shields.io/discord/1260000352699289621?logo=discord&label=Discord&color=5865F2
+[discord]: https://discord.gg/MAmD5SG8Zu
+
+[node-badge]: https://img.shields.io/badge/node.js-%3E%3D22-green.svg?logo=node.js
+[node]: https://nodejs.org
+
+[eslint-badge]: https://img.shields.io/badge/code%20style-eslint-4B32C3.svg?logo=eslint
+[eslint]: https://eslint.org
+
+[prettier-badge]: https://img.shields.io/badge/formatter-prettier-F7B93E.svg?logo=prettier
+[prettier]: https://prettier.io
+
+[stylelint-badge]: https://img.shields.io/badge/css-stylelint-263238.svg?logo=stylelint
+[stylelint]: https://stylelint.io

package/config/.markdownlint.json

@@ -0,0 +1,7 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD024": {
+    "siblings_only": true
+  }
+}

package/config/.markdownlintignore

@@ -0,0 +1,5 @@
+.cache/
+.git/
+.opencode/
+node_modules/
+*.min.md

package/config/.prettierignore

@@ -0,0 +1,10 @@
+build/
+coverage/
+dist/
+node_modules/
+public/
+vendor/
+*.lock
+*.md
+*.min.css
+*.min.js

package/config/.stylelintignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+build/
+coverage/
+vendor/
+public/
+*.min.css

package/config/eslint.config.js

@@ -0,0 +1,191 @@
+/**
+ * Default ESLint configuration for @zairakai projects.
+ */
+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'
+
+export default [
+  // Base JavaScript rules
+  pluginJs.configs.recommended,
+
+  // Vue configurations
+  ...pluginVue.configs['flat/strongly-recommended'],
+
+  // Prettier integration (must be last)
+  eslintConfigPrettier,
+
+  // 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 specific configuration
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.vue'],
+    languageOptions: {
+      parser: parserTypeScript,
+      parserOptions: {
+        project: './tsconfig.json',
+        extraFileExtensions: ['.vue'],
+      },
+    },
+    plugins: {
+      '@typescript-eslint': pluginTypeScript,
+    },
+    rules: {
+      // Disable JS rules that conflict with TS
+      'no-unused-vars': 'off',
+      'no-undef': 'off',
+
+      // Enable TS rules
+      '@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',
+      '@typescript-eslint/prefer-optional-chain': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+    },
+  },
+
+  // Test files configuration
+  {
+    files: ['**/*.test.{js,ts}', '**/*.spec.{js,ts}', '**/tests/**/*'],
+    languageOptions: {
+      globals: {
+        ...globals.jest,
+        ...globals.vitest,
+        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',
+    },
+  },
+
+  // Configuration files
+  {
+    files: ['**/*.config.{js,ts}', '**/.*rc.{js,ts}'],
+    rules: {
+      'no-console': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+    },
+  },
+
+  // Ignore patterns
+  {
+    ignores: [
+      'build/**',
+      'coverage/**',
+      'dist/**',
+      'node_modules/**',
+      'public/**',
+      'storybook-static/**',
+      '.nuxt/**',
+      '.output/**',
+      '**/*.min.js',
+    ],
+  },
+]

package/config/prettier.config.js

@@ -0,0 +1,121 @@
+/**
+ * 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

package/config/stylelint.config.js

@@ -0,0 +1,56 @@
+/**
+ * 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',
+  ],
+}

package/config/tsconfig.base.json

@@ -0,0 +1,20 @@
+{
+  "$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,
+    "ignoreDeprecations": "5.0"
+  }
+}

package/config/vitest.config.js

@@ -0,0 +1,25 @@
+/**
+ * Default Vitest configuration for @zairakai packages.
+ * Provides sensible defaults for TypeScript projects.
+ *
+ * To customize, publish this file to your project:
+ *   bash node_modules/@zairakai/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'],
+    },
+  },
+})

package/index.js

@@ -0,0 +1,22 @@
+/**
+ * @zairakai/dev-tools
+ * Development tools umbrella — ESLint, Prettier, Stylelint, TypeScript, Vitest all-in-one.
+ */
+
+import eslint from './config/eslint.config.js'
+import prettier from './config/prettier.config.js'
+import stylelint from './config/stylelint.config.js'
+import tsconfig from './config/tsconfig.base.json' with { type: 'json' }
+import vitest from './config/vitest.config.js'
+
+// Named exports
+export { eslint, prettier, stylelint, tsconfig, vitest }
+
+// Named paths for consumers
+export const configs = {
+  eslint: '@zairakai/dev-tools/config/eslint.config.js',
+  prettier: '@zairakai/dev-tools/config/prettier.config.js',
+  stylelint: '@zairakai/dev-tools/config/stylelint.config.js',
+  vitest: '@zairakai/dev-tools/config/vitest.config.js',
+  tsconfig: '@zairakai/dev-tools/config/tsconfig.base.json',
+}