@dimensional-innovations/tool-config 1.0.0

package/src/tools/stylelint/presets/frameworks/react.js

@@ -0,0 +1,18 @@
+/**
+ * React/Solid-specific Stylelint preset
+ *
+ * Note: Most React/Solid projects use CSS-in-JS (styled-components, emotion, etc.)
+ * which is better linted by ESLint plugins, not Stylelint.
+ *
+ * This preset is for React/Solid projects that use separate CSS files.
+ * If you're using CSS-in-JS exclusively, you don't need Stylelint.
+ *
+ * CSS Modules support is added conditionally in the factory function
+ * when Tailwind CSS is not detected.
+ */
+
+export default {
+  // No special rules needed for React/Solid CSS files
+  // They use standard CSS, so base preset is sufficient
+  rules: {}
+}

package/src/tools/stylelint/presets/frameworks/svelte.js

@@ -0,0 +1,28 @@
+/**
+ * Svelte-specific Stylelint preset
+ *
+ * Handles <style> blocks in Svelte components (.svelte files)
+ *
+ * Requires: postcss-html (peer dependency)
+ */
+
+export default {
+  extends: ['stylelint-config-standard'],
+
+  overrides: [
+    {
+      files: ['**/*.svelte'],
+      customSyntax: 'postcss-html'
+    }
+  ],
+
+  rules: {
+    // Allow Svelte :global() pseudo-class
+    'selector-pseudo-class-no-unknown': [
+      true,
+      {
+        ignorePseudoClasses: ['global']
+      }
+    ]
+  }
+}

package/src/tools/stylelint/presets/frameworks/vanilla.js

@@ -0,0 +1,14 @@
+/**
+ * Vanilla JavaScript / Angular / Node.js Stylelint preset
+ *
+ * For projects with standard CSS files (no framework-specific syntax)
+ * This includes:
+ * - Vanilla JavaScript projects
+ * - Angular projects (component styles use standard CSS)
+ * - Any project with separate .css files
+ */
+
+export default {
+  // No framework-specific rules needed
+  // Base preset provides everything required for standard CSS
+}

package/src/tools/stylelint/presets/frameworks/vue.js

@@ -0,0 +1,38 @@
+/**
+ * Vue-specific Stylelint preset
+ *
+ * Handles <style> blocks in Vue Single File Components (.vue files)
+ *
+ * Requires:
+ * - stylelint-config-standard-vue
+ * - postcss-html (peer dependencies)
+ */
+
+export default {
+  extends: ['stylelint-config-standard-vue'],
+
+  overrides: [
+    {
+      files: ['**/*.vue'],
+      customSyntax: 'postcss-html'
+    }
+  ],
+
+  rules: {
+    // Allow Vue-specific pseudo-classes
+    'selector-pseudo-class-no-unknown': [
+      true,
+      {
+        ignorePseudoClasses: ['deep', 'global', 'slotted']
+      }
+    ],
+
+    // Allow Vue-specific pseudo-elements
+    'selector-pseudo-element-no-unknown': [
+      true,
+      {
+        ignorePseudoElements: ['v-deep', 'v-global', 'v-slotted']
+      }
+    ]
+  }
+}

package/src/tools/stylelint/presets/scss.js

@@ -0,0 +1,83 @@
+/**
+ * SCSS/Sass Stylelint preset
+ *
+ * Standard SCSS linting rules for projects using Sass.
+ * Extends the standard SCSS configuration with additional quality rules.
+ *
+ * Key principles:
+ * - Support SCSS syntax (variables, mixins, nesting, etc.)
+ * - Enforce modern SCSS practices
+ * - Avoid common SCSS mistakes
+ * - Maintain consistency with CSS base rules
+ */
+
+export default {
+  extends: ['stylelint-config-standard-scss'],
+
+  rules: {
+    // Color rules
+    'color-hex-length': 'short',
+
+    // Variables
+    'scss/dollar-variable-colon-space-after': 'always',
+    'scss/dollar-variable-colon-space-before': 'never',
+    'scss/dollar-variable-pattern': [
+      '^[a-z][a-zA-Z0-9]*(-[a-z][a-zA-Z0-9]*)*$',
+      {
+        message: 'Expected variable to be kebab-case'
+      }
+    ],
+
+    // Operators
+    'scss/operator-no-newline-after': true,
+    'scss/operator-no-unspaced': true,
+
+    // Nesting
+    'max-nesting-depth': 4, // Allow one more level for SCSS
+
+    // At-rules (allow Tailwind if present)
+    'scss/at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: ['tailwind', 'apply', 'variants', 'responsive', 'screen', 'layer']
+      }
+    ],
+
+    // Mixins
+    'scss/at-mixin-pattern': [
+      '^[a-z][a-zA-Z0-9]*(-[a-z][a-zA-Z0-9]*)*$',
+      {
+        message: 'Expected mixin name to be kebab-case'
+      }
+    ],
+
+    // Functions
+    'scss/at-function-pattern': [
+      '^[a-z][a-zA-Z0-9]*(-[a-z][a-zA-Z0-9]*)*$',
+      {
+        message: 'Expected function name to be kebab-case'
+      }
+    ],
+
+    // Placeholder selectors
+    'scss/percent-placeholder-pattern': [
+      '^[a-z][a-zA-Z0-9]*(-[a-z][a-zA-Z0-9]*)*$',
+      {
+        message: 'Expected placeholder to be kebab-case'
+      }
+    ],
+
+    // Selector rules (inherit from base)
+    'selector-max-id': 0,
+    'selector-no-qualifying-type': true,
+    'selector-class-pattern': [
+      '^[a-z]([a-z0-9-]+)?(__([a-z0-9]+-?)+)?(--([a-z0-9]+-?)+){0,2}$',
+      {
+        message: 'Expected class selector to be kebab-case or BEM format'
+      }
+    ],
+
+    // Disable some rules that conflict with SCSS
+    'no-descending-specificity': null
+  }
+}

package/src/tools/stylelint/presets/tailwind.js

@@ -0,0 +1,49 @@
+/**
+ * Tailwind CSS Stylelint preset
+ *
+ * Configuration for projects using Tailwind CSS.
+ * Disables rules that conflict with Tailwind's utility-first approach.
+ *
+ * Key principles:
+ * - Allow Tailwind directives (@tailwind, @apply, @layer, etc.)
+ * - Disable rules that conflict with utility classes
+ * - Support arbitrary values and variants
+ * - Work alongside regular CSS/SCSS
+ */
+
+export default {
+  // Note: We don't extend stylelint-config-tailwindcss because it's too opinionated
+  // Instead, we selectively disable conflicting rules
+
+  rules: {
+    // Allow Tailwind at-rules
+    'at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: ['tailwind', 'apply', 'layer', 'variants', 'responsive', 'screen', 'config']
+      }
+    ],
+
+    // Allow Tailwind functions
+    'function-no-unknown': [
+      true,
+      {
+        ignoreFunctions: ['theme', 'screen']
+      }
+    ],
+
+    // Disable rules that conflict with Tailwind's utility classes
+    'selector-class-pattern': null, // Tailwind uses various patterns
+    'selector-max-id': null, // Allow IDs (though not recommended)
+    'no-descending-specificity': null, // Utility classes have complex specificity
+    'declaration-block-no-redundant-longhand-properties': null, // Utilities may look redundant
+
+    // Allow unknown properties (Tailwind CSS variables)
+    'property-no-unknown': [
+      true,
+      {
+        ignoreProperties: ['/^--/'] // Allow CSS custom properties
+      }
+    ]
+  }
+}

package/src/utils/package-reader.js

@@ -0,0 +1,42 @@
+import { existsSync, readFileSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * Read and parse package.json from a directory
+ * @param {string} cwd - Directory path
+ * @returns {Object|null} Parsed package.json or null if not found
+ */
+export function readPackageJson(cwd) {
+  const packagePath = join(cwd, 'package.json')
+
+  if (!existsSync(packagePath)) {
+    return null
+  }
+
+  try {
+    const content = readFileSync(packagePath, 'utf8')
+    return JSON.parse(content)
+  } catch (error) {
+    console.warn(`Warning: Failed to read package.json: ${error.message}`)
+    return null
+  }
+}
+
+/**
+ * Get production dependencies from package.json
+ * Only returns dependencies, not devDependencies, since devDependencies
+ * are for tooling/testing and should not influence framework detection.
+ * @param {Object} pkg - Parsed package.json
+ * @returns {Object} Production dependencies
+ */
+export function getAllDependencies(pkg) {
+  if (!pkg) {
+    return {}
+  }
+
+  // Only return production dependencies for framework detection
+  // devDependencies are for tooling/testing, not the actual framework
+  return {
+    ...pkg.dependencies
+  }
+}