Version Packages (preview) (#2848)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

.changeset/pre.json

@@ -25,6 +25,7 @@
   },
   "changesets": [
     "react-styles-remove-material-ui",
+    "react-styles-theme-extensions",
     "storybook-styles-docs"
   ]
 }

packages/styles/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Change Log
 
+## 2.0.0-preview.2
+
+### Minor Changes
+
+- 0a1bf8d: Enhanced theme system with support for extending `FusionTheme` with custom properties, improved nested theme composition, and comprehensive documentation.
+
+  ### Added
+  - **Theme Extension Support**: `FusionTheme` now supports extending with custom properties using generics:
+    ```typescript
+    type MyTheme = FusionTheme<{ colors: { primary: ColorStyleProperty } }>;
+    ```
+  - **Custom Base Theme Merging**: `createTheme` now accepts an optional `baseTheme` parameter for merging with custom base themes:
+    ```typescript
+    const extendedTheme = createTheme(
+      { colors: { ui: { background__danger: newColor } } },
+      outerTheme,
+    );
+    ```
+  - **Deep Merging Improvements**: Enhanced `deepMerge` function properly handles nested theme properties, `Record` types, and `StyleProperty` instances
+  - **Type Exports**: Explicitly exported `ThemeProviderProps`, `StylesProviderProps`, `FusionTheme`, `StyleDefinition`, and `createTheme` for better TypeScript support
+  - **Complete TSDoc Documentation**: All exported functions, types, and interfaces now have comprehensive TSDoc comments with examples, parameter descriptions, and usage patterns
+  - **Theme Extension Storybook Story**: New `ThemeExtension` story demonstrating how to extend themes with custom properties, including step-by-step examples for type definition, theme creation, and usage with `useTheme` and `makeStyles`
+
+  ### Changed
+  - `createTheme` signature now accepts optional `baseTheme` parameter (backward compatible)
+  - Improved type inference for extended themes in `ThemeProvider`, `useTheme`, and `makeStyles`
+  - Better handling of nested theme composition when using theme functions in nested `ThemeProvider` components
+  - **Storybook Stories Updated**: All stories now use theme CSS values (`theme.colors.*.css`, `theme.spacing.*.css`, `theme.typography.*.style.*`) instead of hardcoded custom CSS, ensuring proper integration with Fusion design system tokens
+
+  ### Technical Details
+  - Deep merging now correctly handles `StyleProperty` instances (replaces instead of merging)
+  - Theme composition works correctly with nested `ThemeProvider` components
+  - All types are properly exported and documented with complete TSDoc comments
+  - Typography properties accessed via `.style.fontSize`, `.style.fontWeight`, etc. for proper CSS value extraction
+  - Color and spacing properties accessed via `.css` property for CSS variable or value string
+
 ## 2.0.0-preview.1
 
 ### Major Changes

packages/styles/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-react-styles",
-  "version": "2.0.0-preview.1",
+  "version": "2.0.0-preview.2",
   "description": "style lib inspired by @material-ui/styles",
   "keywords": [
     "styling",