@oardi/css-utils 0.131.1 → 0.132.0

package/css-utils-manifest.json

@@ -1,6 +1,6 @@
 {
 	"package": "@oardi/css-utils",
-	"version": "0.131.1",
+	"version": "0.132.0",
 	"breakpoints": { "sm": "576px", "md": "768px", "lg": "992px", "xl": "1200px", "xxl": "1400px" },
 	"lifecycle": {
 		"deprecated": [

package/css-utils-reference.md

@@ -3,7 +3,7 @@
 > Generated automatically. Do not edit manually.
 
 - Package: `@oardi/css-utils`
-- Version: `0.131.1`
+- Version: `0.132.0`
 - Source: public SCSS entry point and utility configuration
 
 ## Usage guidance

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oardi/css-utils",
-	"version": "0.131.1",
+	"version": "0.132.0",
 	"author": "Ardian Shala",
 	"homepage": "https://css-utils.oardi.com",
 	"description": "Powerful set of semantic css classes with support for breakpoints, directions and spacings",
@@ -24,6 +24,10 @@
 			"sass": "./scss/theme.scss",
 			"default": "./scss/theme.scss"
 		},
+		"./tokens": {
+			"sass": "./scss/variables.scss",
+			"default": "./scss/variables.scss"
+		},
 		"./components/*": {
 			"sass": "./scss/components/*.scss",
 			"default": "./scss/components/*.scss"

package/readme.md

@@ -86,7 +86,27 @@ For custom responsive SCSS, import the breakpoint mixins without loading the lib
 
 The Dart Sass CLI uses `@use 'pkg:@oardi/css-utils/breakpoints' as bp;` with `--pkg-importer=node`.
 
-Import theme values without generating CSS via `@use '@oardi/css-utils/theme' as theme;`. To load one component's styles, use a path such as `@use '@oardi/css-utils/components/button';`. The Dart Sass CLI uses the same paths with a `pkg:` prefix.
+Import theme values without generating CSS via `@use '@oardi/css-utils/theme' as theme;`.
+
+## Load individual components
+
+Load the shared design tokens once alongside the components you need:
+
+```scss
+@use '@oardi/css-utils/tokens';
+@use '@oardi/css-utils/components/button';
+```
+
+`tokens` emits the default CSS variables, dark-theme overrides (`data-theme="dark"` on `<html>`) and reduced-motion settings. It establishes the shared cascade order without loading reset, typography, utility or component rules. Component imports require these tokens unless your application already loads the full library or supplies all required variables itself.
+
+The full `@use '@oardi/css-utils';` import already includes the tokens. Sass emits them only once if both entry points are used in the same compilation. Override CSS variables after the imports as shown below.
+
+The Dart Sass CLI uses the same paths with a `pkg:` prefix and `--pkg-importer=node`:
+
+```scss
+@use 'pkg:@oardi/css-utils/tokens';
+@use 'pkg:@oardi/css-utils/components/button';
+```
 
 ## Browser support