@styleframe/core 3.3.0 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @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
+
+- [#203](https://github.com/styleframe-dev/styleframe/pull/203) [`c314dbc`](https://github.com/styleframe-dev/styleframe/commit/c314dbc78872df38efe72d7931faf86afce5ffcc) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Track variable references in `root._usage.variables` for future transpiler optimizations
+  - Add `_usage: { variables: Set<string> }` to `Root` type and initialize in `createRoot()`
+  - Record variable names whenever `ref()` is called or `@`-prefixed syntax is resolved
+
 ## 3.3.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;
 
@@ -487,6 +487,10 @@ export declare type Root = {
     children: ContainerChild[];
     themes: Theme[];
     _registry: Map<string, Container | Root | Theme>;
+    _usage: {
+        variables: Set<string>;
+        utilities: Set<string>;
+    };
 };
 
 export declare type RuntimeModifierDeclarationsBlock = Record<string, PrimitiveTokenValue>;
@@ -556,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 {