eva-css-fluid 2.0.8 → 2.1.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog — eva-css-fluid
+
+All notable changes to this package are documented here.
+
+## [Unreleased]
+
+### Deprecated
+- JSON config workflow (`eva.config.cjs`, CLI commands `init` / `setup` / `validate` / `generate`,
+  custom `build-with-config.cjs` script). Will be removed in **v3.0.0**.
+- Migrate to direct SCSS config:
+  ```scss
+  @use 'eva-css-fluid' with (
+    $sizes: (...),
+    $font-sizes: (...)
+  );
+  ```
+  The generated CSS is identical. See https://eva-css.xyz/framework/doc.html for the SCSS-only reference.
+- The deprecated CLI commands now print a warning to stderr. Set
+  `EVA_CSS_NO_DEPRECATION_WARNING=1` to silence it (e.g. in CI).
+
+## [2.0.8] and earlier
+
+See git history at https://github.com/nkdeus/eva-framework.

package/README.md

@@ -2,6 +2,22 @@
 
 > Revolutionary fluid design framework - Transform static Figma designs into truly responsive fluid systems
 
+> [!WARNING]
+> **The JSON config workflow is deprecated and will be removed in v3.0.**
+>
+> Going forward, the only supported configuration is the **direct SCSS workflow**:
+>
+> ```scss
+> @use 'eva-css-fluid' with (
+>   $sizes: (4, 8, 12, 16, 24, 32, 48, 64, 96, 128),
+>   $font-sizes: (12, 14, 16, 18, 20, 24, 32, 48)
+> );
+> ```
+>
+> The generated CSS is identical to what the JSON workflow produces. Migration is mechanical: copy the values from `eva.config.cjs` into the `with (...)` block.
+>
+> Concretely deprecated in v2.x and removed in v3.0: `eva.config.cjs`, the CLI commands `init`/`setup`/`validate`/`generate`, and the custom `build-with-config.cjs` script. See the SCSS-only reference at [eva-css.xyz/framework/doc.html](https://eva-css.xyz/framework/doc.html).
+
 **EVA CSS** replaces traditional breakpoint-based responsive design with **automatic fluid scaling**. Instead of defining arbitrary breakpoints for every screen size, EVA converts your static pixel values from Figma into intelligent `clamp()` functions that scale smoothly across all devices.
 
 ## 💡 The Revolutionary Concept
@@ -182,7 +198,10 @@ npx sass --load-path=node_modules styles/main.scss:styles/main.css
 
 ⚠️ **Note:** If you import EVA in multiple SCSS files, you'll need to duplicate the configuration.
 
-#### Option 2: JSON Configuration (Advanced - Requires Build Script)
+#### Option 2: JSON Configuration [DEPRECATED] (Advanced - Requires Build Script)
+
+> [!WARNING]
+> This workflow is deprecated and will be removed in v3.0. Use **Option 1 (SCSS Variables)** instead. The generated CSS is identical.
 
 **Centralized configuration file** - Better for complex projects with multiple SCSS files:
 
@@ -337,7 +356,9 @@ No CSS changes needed!
 
 ## 🎨 Configuration Options
 
-### JSON Configuration (eva.config.cjs or package.json)
+### JSON Configuration (eva.config.cjs or package.json) [DEPRECATED]
+
+> Deprecated in v2.x, removed in v3.0. Migrate to the SCSS `@use ... with (...)` syntax above.
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|

package/cli.cjs

@@ -19,10 +19,10 @@ Usage:
   eva-css <command> [options]
 
 Commands:
-  init           Initialize EVA CSS in existing project (creates eva.config.cjs)
-  setup          Complete project setup with workflow choice (SCSS vs JSON)
-  validate       Validate eva.config.js or package.json configuration
-  generate       Generate SCSS variables from config file
+  init           [DEPRECATED] Initialize EVA CSS in existing project (creates eva.config.cjs)
+  setup          [DEPRECATED] Complete project setup with workflow choice (SCSS vs JSON)
+  validate       [DEPRECATED] Validate eva.config.js or package.json configuration
+  generate       [DEPRECATED] Generate SCSS variables from config file
   help           Show this help message
 
 Examples:
@@ -31,29 +31,47 @@ Examples:
   eva-css validate          # Validate configuration
   eva-css generate output.scss
 
-Getting Started:
-  For new projects:         eva-css setup
-  For existing projects:    eva-css init
+Recommended workflow (SCSS-only):
+  @use 'eva-css-fluid' with (
+    $sizes: (4, 8, 12, 16, 24, 32, 48, 64, 96, 128),
+    $font-sizes: (12, 14, 16, 18, 20, 24, 32, 48)
+  );
 
 Documentation:
-  https://github.com/nkdeus/eva/blob/main/packages/eva-css/README.md
+  https://eva-css.xyz/framework/doc.html
+`);
+}
+
+function printDeprecationWarning(command) {
+  if (process.env.EVA_CSS_NO_DEPRECATION_WARNING) return;
+
+  console.warn(`
+⚠️  DEPRECATED: \`eva-css ${command}\` and the JSON config workflow will be removed in v3.0.
+   Migrate to direct SCSS config:
+     @use 'eva-css-fluid' with ($sizes: (...), $font-sizes: (...));
+   See: https://eva-css.xyz/framework/doc.html
+   (silence this warning with EVA_CSS_NO_DEPRECATION_WARNING=1)
 `);
 }
 
 switch (command) {
   case 'init':
+    printDeprecationWarning('init');
     initCommand();
     break;
 
   case 'setup':
+    printDeprecationWarning('setup');
     setupCommand();
     break;
 
   case 'validate':
+    printDeprecationWarning('validate');
     validateConfigCommand();
     break;
 
   case 'generate':
+    printDeprecationWarning('generate');
     const outputPath = args[1] || 'src/_config-generated.scss';
     generateScssCommand(outputPath);
     break;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "eva-css-fluid",
-    "version":  "2.0.8",
+    "version":  "2.1.0",
     "description":  "Fluid design framework with OKLCH colors - Transform static designs into responsive fluid systems",
     "type":  "module",
     "main":  "src/index.scss",
@@ -42,7 +42,8 @@
                   "scripts/",
                   "eva.config.template.js",
                   "README.md",
-                  "MIGRATION.md"
+                  "MIGRATION.md",
+                  "CHANGELOG.md"
               ],
     "keywords":  [
                      "css",
@@ -68,7 +69,7 @@
                     "generate:config":  "node cli.cjs generate"
                 },
     "dependencies":  {
-                         "eva-colors":  "^2.0.8"
+                         "eva-colors":  "^2.1.0"
                      },
     "devDependencies":  {
                             "sass":  "^1.94.1"