@bamboocss/types 1.18.0 → 1.20.0

package/dist/config.d.ts

@@ -286,6 +286,12 @@ 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
@@ -310,7 +316,13 @@ interface CssgenOptions {
    * which keeps the whole scale whether or not the app uses it — on the default preset
    * that is roughly a third of what survives pruning. There is no opt-out.
    *
-   * @default false
+   * Setting this to `false` keeps every token declaration, but still drops the `@property`
+   * registrations. Those are not tokens — nothing hands one to javascript and none appear
+   * in the `token()` surface — so the reachability problem above does not apply to them,
+   * and opting out of token pruning should not mean shipping a preset's whole filter and
+   * gradient set for nothing.
+   *
+   * @default true
    */
   pruneUnusedTokens?: boolean
   /**
@@ -326,7 +338,7 @@ interface CssgenOptions {
    * is deliberately over-inclusive: keeping an unused keyframe costs bytes, dropping a
    * used one breaks the animation.
    *
-   * @default false
+   * @default true
    */
   pruneUnusedKeyframes?: boolean
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamboocss/types",
-  "version": "1.18.0",
+  "version": "1.20.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.18.0"
+    "@bamboocss/extractor": "1.20.0"
   },
   "scripts": {
     "dev": "tsx scripts/watch.ts",