@styleframe/core 3.4.0 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @styleframe/core
 
+## 3.5.0
+
+### Minor Changes
+
+- [#221](https://github.com/styleframe-dev/styleframe/pull/221) [`6d406c2`](https://github.com/styleframe-dev/styleframe/commit/6d406c289b39c666a3fb7468aa3ec08f5a6d316b) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Add `treeshake` option to remove unused variables from CSS output.
+
+  `root._usage` now tracks both `variables` and `utilities` referenced during config execution and scanner registration. The transpiler's new `treeshake: true` option filters `root.variables` and theme variables down to only those present in `_usage.variables`. The plugin enables treeshaking by default when generating global CSS.
+
 ## 3.4.0
 
 ### Minor Changes

package/dist/styleframe.d.ts

@@ -57,7 +57,7 @@ export declare type ContainerInput = Pick<Container, "declarations" | "variables
 
 export declare function createAtRuleFunction(parent: Container, root: Root): (identifier: string, rule: string, declarationsOrCallback?: DeclarationsBlock | ContainerInput | DeclarationsCallback) => AtRule;
 
-export declare function createCssFunction(_parent: Container, _root: Root): (strings: TemplateStringsArray, ...interpolations: (TokenValue | Variable | AtRule)[]) => CSS_2;
+export declare function createCssFunction(_parent: Container, root: Root): (strings: TemplateStringsArray, ...interpolations: (TokenValue | Variable | AtRule)[]) => CSS_2;
 
 export declare function createDeclarationsCallbackContext(parent: Container, root: Root): DeclarationsCallbackContext;
 
@@ -489,6 +489,7 @@ export declare type Root = {
     _registry: Map<string, Container | Root | Theme>;
     _usage: {
         variables: Set<string>;
+        utilities: Set<string>;
     };
 };
 
@@ -559,6 +560,13 @@ export declare type TokenType = Variable["type"] | Reference["type"] | Selector[
 
 export declare type TokenValue = PrimitiveTokenValue | Reference | CSS_2 | Array<PrimitiveTokenValue | Reference | CSS_2>;
 
+/**
+ * Records a variable name in `root._usage.variables` for any Reference
+ * embedded in the given value (either the value itself or any Reference
+ * parts inside a CSS object).
+ */
+export declare function trackReferenceUsage(root: Root, value: TokenValue): void;
+
 export declare function transformUtilityKey(replacerOrOptions?: ((key: string) => string) | TransformUtilityKeyOptions): (value: TokenValue) => Record<string, TokenValue>;
 
 export declare interface TransformUtilityKeyOptions {