@styleframe/core 3.5.0 → 3.6.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @styleframe/core
 
+## 3.6.1
+
+### Patch Changes
+
+- [#238](https://github.com/styleframe-dev/styleframe/pull/238) [`4ace91d`](https://github.com/styleframe-dev/styleframe/commit/4ace91d5e15020c29d585848ee66f6250946b2d1) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Bundle type declarations on build. The shared Vite config now enables `vite-plugin-dts`'s `bundleTypes`, so each package ships a single rolled-up `.d.ts` per entry (via `@microsoft/api-extractor`) instead of a tree of per-file declarations. `@microsoft/api-extractor` is now a peer dependency of `@styleframe/config-vite`.
+
+## 3.6.0
+
+### Minor Changes
+
+- [#234](https://github.com/styleframe-dev/styleframe/pull/234) [`c7ff8c8`](https://github.com/styleframe-dev/styleframe/commit/c7ff8c89776b2e117b0f45f3e1f8ca6695f24a29) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Add recipe-level tree-shaking. Unused recipes and their utility classes are excluded from the CSS and TypeScript consumer module during production builds.
+  - **Core**: `Root._usage` gains `recipes` and `recipeUtilities` fields. Recipe utility class names are tracked per-recipe in `recipeUtilities` and promoted to `utilities` via `registerRecipeUtilities()`.
+  - **Scanner**: New `scanImports()` and `scanFileImports()` methods use importree v2's `parseImports()` to detect which recipes are imported from `virtual:styleframe`.
+  - **Transpiler**: TS and DTS consumers filter recipes by `_usage.recipes` — only emitting used recipes when the set is populated.
+  - **Plugin**: Recipe scanning integrated into the build flow after content scanning. Defaults to tree-shaking ON for builds, OFF for dev. Safety: namespace/dynamic imports include all recipes with a warning. `recipes.include` option provides an escape hatch for force-including recipes.
+
+- [#226](https://github.com/styleframe-dev/styleframe/pull/226) [`dc99d46`](https://github.com/styleframe-dev/styleframe/commit/dc99d4699046f5e5f3dcac965648fd50b0339412) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Add build-time utility class name shortening for production builds.
+
+  Generates shortening maps at transpile time with collision-safe abbreviation and built-in defaults for common CSS properties. Hashes long arbitrary values for stable compact names. Supports underscore-as-space in arbitrary values (`_padding:[10px_20px]`). Exposes `minify` plugin option with user-overridable defaults.
+
+### Patch Changes
+
+- [#233](https://github.com/styleframe-dev/styleframe/pull/233) [`0ef38e6`](https://github.com/styleframe-dev/styleframe/commit/0ef38e69ca941cefab31463c23980f52cae1541f) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Migrate from Vite 7 to Vite 8 with native Rolldown integration. Replace esbuild transforms with Oxc in the plugin, rename `rollupOptions` to `rolldownOptions`, upgrade `vite-plugin-dts` v4 to v5 (`rollupTypes` → `bundleTypes`), and bump vitest from v3 to v4.
+
 ## 3.5.0
 
 ### Minor Changes

package/dist/{styleframe.d.ts → index.d.cts}

@@ -467,6 +467,14 @@ export declare type Reference<Name extends string = string> = {
 
 export declare type RefFunction = (variable: string, fallback?: string) => Reference;
 
+/**
+ * Promotes recipe utility class names from `_usage.recipeUtilities` into `_usage.utilities`.
+ *
+ * When called without `recipeNames`, promotes all recipes (backward-compatible default).
+ * When called with a set of recipe names, only promotes matching entries.
+ */
+export declare function registerRecipeUtilities(root: Root, recipeNames?: Set<string>): void;
+
 export declare function rfdc<T = any>(opts?: RfdcOptions): CloneFunction<T>;
 
 declare interface RfdcOptions {
@@ -490,6 +498,8 @@ export declare type Root = {
     _usage: {
         variables: Set<string>;
         utilities: Set<string>;
+        recipes: Set<string>;
+        recipeUtilities: Map<string, Set<string>>;
     };
 };
 
@@ -510,6 +520,15 @@ export declare type Selector = {
     _exportName?: string;
 };
 
+export declare type ShorteningMap = {
+    /** Property name shortening: e.g. "margin-top" -> "mt" */
+    p: Record<string, string>;
+    /** Value shortening: e.g. "primary" -> "p" */
+    v: Record<string, string>;
+    /** Modifier shortening: e.g. "hover" -> "h" */
+    m: Record<string, string>;
+};
+
 export declare interface Styleframe {
     id: string;
     root: Root;