@bamboocss/types 1.12.3 → 1.13.2

package/LICENSE.md

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2023 Segun Adebayo
+Copyright (c) 2026 Gajus Kuizinas
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

package/dist/config.d.ts

@@ -349,6 +349,46 @@ interface CssgenOptions {
    * @default false
    */
   minify?: boolean
+  /**
+   * Whether to drop token css variables that nothing in the generated css can reach.
+   *
+   * 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.
+   *
+   * 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.
+   *
+   * 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
+   * and any token carrying a condition, and it has one cost worth knowing about: a
+   * negative token resolves to `calc(var(--spacing-4) * -1)`, so every token with a
+   * negative counterpart pins its own declaration. Spacing scales generate one per entry,
+   * 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
+   */
+  pruneUnusedTokens?: boolean
+  /**
+   * Drop `@keyframes` rules nothing can reach.
+   *
+   * A preset declares every animation it offers and an app uses a handful, so the rest
+   * are dead weight in the stylesheet that blocks first paint. Only keyframes the theme
+   * declares are ever removed — one emitted by `globalCss` is left alone.
+   *
+   * A name is kept when any declaration in the generated css names it, and when it
+   * appears anywhere under `include`, which covers an animation assembled at runtime or
+   * applied through an inline `style` rather than through bamboo. That textual fallback
+   * is deliberately over-inclusive: keeping an unused keyframe costs bytes, dropping a
+   * used one breaks the animation.
+   *
+   * @default false
+   */
+  pruneUnusedKeyframes?: boolean
   /**
    * The root selector for the css variables.
    * @default ':where(:host, :root)'

package/dist/prop-type.d.ts

@@ -5,6 +5,14 @@ import type { CssProperties } from './system-types'
  * Shadowed export (in CLI): DO NOT REMOVE
  * -----------------------------------------------------------------------------*/
 
+/**
+ * Empty on purpose, and unreferenced on purpose. A generated project never sees this file:
+ * the CLI emits its own `styled-system/types/prop-type.d.ts` declaring `UtilityValues` and a
+ * `PropertyValue` resolved against it. This copy is what ships in the `@bamboocss/types`
+ * bundle, so nothing in this repo can consume it and knip cannot tell it apart from dead code.
+ *
+ * @public
+ */
 export interface PropertyTypes {}
 
 export type PropertyValue<K extends string> = K extends keyof PropertyTypes

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@bamboocss/types",
-  "version": "1.12.3",
+  "version": "1.13.2",
   "description": "The types for css bamboo",
-  "homepage": "https://bamboo-css.com",
+  "homepage": "https://bamboocss.com",
   "license": "MIT",
-  "author": "Segun Adebayo <joseshegs@gmail.com>",
+  "author": "Gajus Kuizinas <gajus@gajus.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bamboocss/bamboo.git",
@@ -32,7 +32,7 @@
     "ncp": "2.0.0",
     "pkg-types": "2.3.0",
     "ts-morph": "28.0.0",
-    "@bamboocss/extractor": "1.12.3"
+    "@bamboocss/extractor": "1.13.2"
   },
   "scripts": {
     "dev": "tsx scripts/watch.ts",