styles-config 2.0.0-alpha.7 → 2.0.0-alpha.9

package/README.md

@@ -1,10 +1,19 @@
 # styles-config
 
-A general-purpose configuration system for styling frameworks including Jess, Less, Sass, Tailwind, and more.
+**A shared configuration schema and loader for styling tools (Jess, Less, Sass,
+Tailwind, …).**
+
+`styles-config` is part of the [Jess](https://github.com/jesscss/jess) project.
+It is published **unscoped** — the package name is `styles-config`, not
+`@jesscss/config`.
 
 ## Overview
 
-`styles-config` provides a unified configuration format and loading system that works across multiple CSS preprocessors and styling frameworks. It allows you to define configuration once and use it with different tools, or maintain separate configurations for different frameworks.
+`styles-config` provides a unified configuration format and loading system that
+works across multiple CSS preprocessors and styling frameworks. It lets you define
+configuration once and use it with different tools, or maintain separate
+configurations for different frameworks. Jess itself reads its compile options
+through this loader.
 
 ## Features
 
@@ -16,14 +25,12 @@ A general-purpose configuration system for styling frameworks including Jess, Le
 
 ## Installation
 
-```bash
+```sh
 npm install styles-config
-# or
-pnpm add styles-config
-# or
-yarn add styles-config
 ```
 
+Published to npm under both the `latest` and `alpha` dist-tags.
+
 ## Configuration File Format
 
 Create a configuration file in your project root. Supported file names:
@@ -39,8 +46,9 @@ interface StylesConfig {
     searchPaths?: string[];
     enableJavaScript?: boolean;
     mathMode?: 'always' | 'parens-division' | 'parens' | 'strict';
-    unitMode?: 'loose' | 'strict';
-    equalityMode?: 'coerce' | 'strict';
+    unitMode?: 'loose' | 'preserve' | 'strict';
+    functionMode?: 'preserve' | 'error';
+    equalityMode?: 'less' | 'sass' | 'exact';
   };
   input?: InputOptions | InputOptions[];
   output?: OutputOptions | OutputOptions[];
@@ -78,7 +86,7 @@ export default {
   compile: {
     mathMode: 'parens-division',
     unitMode: 'loose',
-    equalityMode: 'coerce',
+    equalityMode: 'less',
     searchPaths: ['./src/styles', './node_modules']
   },
   input: [
@@ -320,6 +328,16 @@ This package is designed to be extensible. To add support for a new framework:
 2. Add the extension mapping in `src/options.ts` if needed
 3. Update the documentation
 
+## Status
+
+Alpha. Part of the Jess monorepo, which is early software under active
+development. Please [report issues](https://github.com/jesscss/jess/issues).
+
+## Links
+
+- Repository: <https://github.com/jesscss/jess>
+- Documentation: <https://jesscss.github.io/> (currently pre-alpha content)
+
 ## License
 
-MIT
+[MIT](https://github.com/jesscss/jess/blob/dev/LICENSE)

package/lib/types.d.ts

@@ -7,14 +7,16 @@ export type MathMode = 'always' | 'parens-division' | 'parens' | 'strict';
  */
 export type UnitMode = 'loose' | 'preserve' | 'strict';
 /**
- * Function-call resolution modes — mirrors {@link UnitMode}. Governs an optional
- * (global) function call that matched a registered function but couldn't be
- * evaluated: `preserve` renders it as-is (+ warning), `error` throws.
+ * Function-call resolution modes — compiler input to the shared evaluator.
+ * Governs an optional (global) function call that matched a registered function
+ * but couldn't be evaluated: `preserve` renders it as-is (+ warning), `error`
+ * throws.
  */
 export type FunctionMode = 'preserve' | 'error';
 /**
- * Equality dialects for guard comparisons — named by dialect (Less 4.x and Sass
- * diverge in opposite directions), not by strictness:
+ * Equality compatibility modes for the shared guard evaluator. The names retain
+ * their source-compatibility meaning (Less 4.x and Sass diverge in opposite
+ * directions), not separate runtime semantics:
  * - `less`: Less 4.x equality (numeric coercion; quoted vs unquoted distinct)
  * - `sass`: Dart Sass equality (unit-strict; quote-insensitive strings)
  * - `exact`: no coercion — operands must be the same node type

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.0-alpha.9",
   "description": "General-purpose configuration for styling frameworks (Jess, Less, Sass, Tailwind, etc.)",
   "main": "lib/index.cjs",
   "types": "lib/index.d.ts",
@@ -21,7 +21,7 @@
   "dependencies": {
     "cosmiconfig": "^9.0.0",
     "picomatch": "^4.0.2",
-    "@jesscss/core": "2.0.0-alpha.7"
+    "@jesscss/core": "2.0.0-alpha.9"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",