@feugene/granularity 0.28.2 → 0.28.3

package/README.md

@@ -32,16 +32,16 @@ strategies.
 
 - root export: `@feugene/granularity`;
 - component subpath exports: `@feugene/granularity/components/<ComponentName>`;
-- ready-made CSS entrypoints:
-  - `@feugene/granularity/foundation.css` — `tokens` + built-in `light`/`dark` themes + `base`;
-  - `@feugene/granularity/styles.css` — `foundation` plus styles for all components;
-  - `@feugene/granularity/components/<ComponentName>/styles.css` — `foundation` plus styles for a specific component and its dependencies;
-- low-level foundation exports: `@feugene/granularity/styles/tokens.css`, `@feugene/granularity/styles/base.css`, `@feugene/granularity/styles/themes/light.css`, `@feugene/granularity/styles/themes/dark.css`;
+- ready-made CSS entrypoint: `@feugene/granularity/styles.css` — tokens, base layer, preflight and the
+  built-in `light`/`dark` themes in one file, for consumers who do not run the `UnoCSS` preset. A
+  component's own CSS is not there and does not need to be: the component's chunk imports it itself;
+- low-level foundation exports: `@feugene/granularity/styles/tokens.css`, `@feugene/granularity/styles/base.css`, `@feugene/granularity/styles/preflight.css`, `@feugene/granularity/styles/themes/light.css`, `@feugene/granularity/styles/themes/dark.css`;
 - package-level API: `@feugene/granularity/directives`, `@feugene/granularity/fileValidation`;
 - design tokens as data: `@feugene/granularity/tokens` (typed registry) and the raw `@feugene/granularity/tokens/*.json` source the CSS is generated from;
-- two `UnoCSS` integration scenarios:
-    - `@feugene/granularity/uno` — browser-safe preset;
-    - `@feugene/granularity/uno-node` — node-oriented preset with CSS/preflight helpers.
+- two `UnoCSS` integration scenarios, both through the granular provider:
+    - `@feugene/granularity/granular-provider` — browser-safe registry of components;
+    - `@feugene/granularity/granular-provider/node` — the node-side counterpart, which reads CSS and
+      preflight from the file system.
 
 ## Limitations
 
@@ -74,11 +74,15 @@ yarn add -D unocss
 import '@feugene/granularity/styles.css'
 ```
 
-That's enough to quickly get a working base: `styles.css` already includes `foundation.css` (`tokens`, `base`,
-built-in `light`/`dark` themes) and the styles for all components.
+That's enough to get a working base: the file carries the tokens, the base layer, the preflight and the
+built-in `light`/`dark` themes. What it does not carry is the utility classes the components are built
+from — those are generated by the `UnoCSS` preset for the components you actually select. Without the preset
+a component renders with its own CSS but without layout utilities.
 
-If you need a more precise CSS setup, use `@feugene/granularity/foundation.css` together with
-`@feugene/granularity/components/<ComponentName>/styles.css`, or assemble styles via the `UnoCSS` preset.
+For a finer setup take the layers apart — `@feugene/granularity/styles/tokens.css`,
+`styles/base.css`, `styles/preflight.css`, `styles/themes/<name>.css` — or assemble everything with the
+preset. There is no per-component stylesheet to import: a component that has CSS of its own imports it
+from its own chunk, so a granular import already brings everything it needs.
 
 ## Documentation
 

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@feugene/granularity",
-  "version": "0.28.2",
+  "version": "0.28.3",
   "framework": "vue",
   "js-types-syntax": "typescript",
   "description-markup": "markdown",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@feugene/granularity",
   "description": "Granularity design system package with Vue 3 components, consumed via the `@feugene/unocss-preset-granular` preset.",
-  "version": "0.28.2",
+  "version": "0.28.3",
   "license": "SEE LICENSE IN LICENSE",
   "author": {
     "name": "Evgeniy Fureev",
@@ -53,6 +53,7 @@
       "default": "./dist/index.js"
     },
     "./styles/*": "./dist/styles/*",
+    "./styles.css": "./dist/styles/index.css",
     "./composables/useAnnouncer": {
       "types": "./dist/types/composables/useAnnouncer.d.ts",
       "import": "./dist/composables/useAnnouncer.js"
@@ -529,6 +530,9 @@
       "types": "./dist/types/directives/dropzone.d.ts",
       "import": "./dist/directives/dropzone.js"
     },
+    "./directives/globalDirectives": {
+      "types": "./dist/types/directives/globalDirectives.d.ts"
+    },
     "./directives/hotkey": {
       "types": "./dist/types/directives/hotkey.d.ts",
       "import": "./dist/directives/hotkey.js"
@@ -625,7 +629,7 @@
     "vue-tsc": "^3.3.7"
   },
   "scripts": {
-    "build": "vite build && gr-check-dist-dev-guard && node scripts/check-dist-no-tests.mjs && node scripts/generate-web-types.mjs && vue-tsc -p tsconfig.build.json",
+    "build": "vite build && gr-check-dist-dev-guard && node scripts/check-dist-no-tests.mjs && node scripts/generate-web-types.mjs && vue-tsc -p tsconfig.build.json && node scripts/check-dist-exports.mjs",
     "check:messages": "fint-i18n-check-messages src/i18n/locales",
     "dev": "vite build --watch",
     "doctor": "granular doctor ./granular.options.mjs --strict",