@bamboocss/types 1.17.3 → 1.19.0

package/dist/config.d.ts

@@ -286,12 +286,27 @@ interface CssgenOptions {
    * The token layer declares every token in the theme, and an app typically uses a small
    * fraction of them, so this is usually the largest single saving in render-blocking css.
    *
+   * The same walk also drops an `@property` registration for a custom property the finished
+   * stylesheet neither declares nor reads. A preset registers what its utilities compose —
+   * filters, gradients, transforms, transitions — and ships the whole set regardless of what
+   * the app draws, so an app using none of them carries all of it for nothing. Registrations
+   * declared through `globalVars` are yours and are never removed.
+   *
    * It is opt-in because reachability cannot be proven for every reference. `token()` and
    * `token.var()` calls are read out of the source, as is any literal `var(--x)` written
    * by hand. Three things stay invisible: a token named by a path the source does not
-   * spell out as a string literal — `token.var(key)` — one referenced only from a
-   * stylesheet outside `include`, and one used by a separate package consuming the output
-   * as design tokens. Use `staticCss` to keep those.
+   * spell out as a string literal, one referenced only from a stylesheet outside
+   * `include`, and one used by a separate package consuming the output as design tokens.
+   * Use `staticCss` to keep those.
+   *
+   * Only the *second* form of the first case is a risk. `token(key)` is safe for any path,
+   * because javascript receives a literal for a plain token rather than a reference. It is
+   * `token.var(key)` — the form that hands back `var(--x)` — that needs the declaration to
+   * still be there, so that is the one to hold with `staticCss`.
+   *
+   * A custom property declared by `globalCss` or `globalVars` is not one of these cases:
+   * the declaration ships whether or not anything in the stylesheet reads it, so whatever
+   * it references is kept alongside it.
    *
    * Tokens that javascript receives as a `var()` rather than a literal are always kept, so
    * that `token()` answers correctly for any path at runtime. That covers virtual tokens

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamboocss/types",
-  "version": "1.17.3",
+  "version": "1.19.0",
   "description": "The types for css bamboo",
   "homepage": "https://bamboocss.com",
   "license": "MIT",
@@ -32,7 +32,7 @@
     "ncp": "2.0.0",
     "pkg-types": "2.3.0",
     "ts-morph": "28.0.0",
-    "@bamboocss/extractor": "1.17.3"
+    "@bamboocss/extractor": "1.19.0"
   },
   "scripts": {
     "dev": "tsx scripts/watch.ts",