@cube-dev/ui-kit 0.166.0 → 0.167.0

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useEffect, useRef, useState } from "react";
 import { useSSRSafeId } from "@react-aria/ssr";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useIsDarwin.ts

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { useMemo } from "react";
 

package/dist/utils/react/useLayoutEffect.d.ts

@@ -2,7 +2,7 @@
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.d.ts
-declare const useLayoutEffect$1: typeof React$1.useEffect;
+declare const useLayoutEffect$1: typeof React$1.useLayoutEffect;
 //#endregion
 export { useLayoutEffect$1 as useLayoutEffect };
 //# sourceMappingURL=useLayoutEffect.d.ts.map

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.tsx

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useCallback, useSyncExternalStore } from "react";
 

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { useCallback, useContext, useEffect, useRef } from "react";
 

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useViewportSize.ts

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 import { isValidElement } from "react";
 import { isFragment } from "react-is";
 

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is

package/dist/utils/styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 //#region src/utils/styles.ts
 /**
 * Split properties into style and non-style properties.

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {

package/dist/utils/warnings.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {
 	disabled: "isDisabled",

package/dist/version.js

@@ -1,7 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.166.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.167.0 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.166.0";
-const TASTY_VERSION = "3.1.0";
+const VERSION = "0.167.0";
+const TASTY_VERSION = "3.3.1";
 if (typeof window !== "undefined") {
 	const version = VERSION;
 	const tastyVersion = TASTY_VERSION;

package/docs/Colors.md

@@ -1,35 +1,24 @@
 # Colors
 
-Cube UI Kit color tokens are generated by Glaze from a shared OKHST palette.
-Every adaptive token includes light, dark, and high-contrast variants. Change
-the active scheme in the Storybook toolbar to review each example.
+Cube UI Kit color tokens are generated by Glaze from a shared OKHST palette. Every adaptive token includes light, dark, and high-contrast variants. Change the active scheme in the Storybook toolbar to review each example.
 
-The colors shown here come from the default seeds. Those seeds — brand hue,
-saturation, per-status hues — are tunable at runtime; see
-[Theming](./Theming.md) for a live playground.
+The colors shown here come from the default seeds. Those seeds — brand hue, saturation, per-status hues — are tunable at runtime; see [Theming](./Theming.md) for a live playground.
 
 ## Choosing a color pair
 
 Start with the surface, then choose a foreground designed for that surface:
 
-- On neutral surfaces, use the matching text family:
-  `#surface` + `#surface-text`, `#surface-2` + `#surface-2-text`, and so on.
-- On semantic tinted surfaces, use `#<theme>-surface-text` for a neutralized,
-  high-contrast foreground.
-- Use `#<theme>-accent-text` or `-soft` when the foreground should retain the
-  semantic hue, such as notification titles and links.
+- On neutral surfaces, use the matching text family: `#surface` + `#surface-text`, `#surface-2` + `#surface-2-text`, and so on.
+- On semantic tinted surfaces, use `#<theme>-surface-text` for a neutralized, high-contrast foreground.
+- Use `#<theme>-accent-text` or `-soft` when the foreground should retain the semantic hue, such as notification titles and links.
 - On solid accent fills, use `#<theme>-accent-surface-text`.
-- Do not select colors only because they look similar. Their names describe
-  the contrast relationship and intended role.
+- Do not select colors only because they look similar. Their names describe the contrast relationship and intended role.
 
-The text examples show each color with `t3m`, `t3`, and `t4`. Typography does
-not change the color pairing; it makes the foreground easier to evaluate at
-common UI sizes and weights.
+The text examples show each color with `t3m`, `t3`, and `t4`. Typography does not change the color pairing; it makes the foreground easier to evaluate at common UI sizes and weights.
 
 ## Neutral surfaces
 
-Neutral surfaces form the page, panel, and nested-container elevation ladder.
-Use the text tokens named for the selected surface whenever one exists.
+Neutral surfaces form the page, panel, and nested-container elevation ladder. Use the text tokens named for the selected surface whenever one exists.
 
 ## Semantic surfaces
 
@@ -37,45 +26,32 @@ Semantic surfaces support two deliberate foreground treatments.
 
 ### Surface text
 
-The surface-text family keeps the semantic hue subtle and prioritizes strong
-readability.
+The surface-text family keeps the semantic hue subtle and prioritizes strong readability.
 
 ### Accent text
 
-The accent-text family preserves more semantic color. This is the pairing used
-by notification and Item card styles.
+The accent-text family preserves more semantic color. This is the pairing used by notification and Item card styles.
 
 ## Solid accents and interaction states
 
-Solid accent fills are fixed brand colors with a dedicated light foreground.
-The numbered surface ramp represents default, hover, and pressed states and is
-shared by semantic themes.
+Solid accent fills are fixed brand colors with a dedicated light foreground. The numbered surface ramp represents default, hover, and pressed states and is shared by semantic themes.
 
 ## Disabled states
 
-Disabled pairs intentionally have lower contrast than active content. Use the
-neutral pair for low-emphasis controls and the accent-disabled pair for muted
-solid semantic controls. Do not use disabled text for active information or
-content that must meet normal text contrast requirements.
+Disabled pairs intentionally have lower contrast than active content. Use the neutral pair for low-emphasis controls and the accent-disabled pair for muted solid semantic controls. Do not use disabled text for active information or content that must meet normal text contrast requirements.
 
 ## Utility colors
 
-`#placeholder`, `#focus`, semantic accent icons, and `#overlay` have narrow
-roles. Keep them in those roles rather than treating them as general palette
-swatches.
+`#placeholder`, `#focus`, semantic accent icons, and `#overlay` have narrow roles. Keep them in those roles rather than treating them as general palette swatches.
 
 ## Code syntax
 
-Syntax tokens are calibrated as a group against `#surface`. Use the semantic
-token for each syntax role instead of assigning arbitrary palette colors.
+Syntax tokens are calibrated as a group against `#surface`. Use the semantic token for each syntax role instead of assigning arbitrary palette colors.
 
 ## Borders and shadows
 
-Borders use the `1bw` design-system width. Shadow geometry comes from
-`src/tokens/shadows.ts`; the `#shadow-sm`, `#shadow-md`, and `#shadow-lg`
-colors adapt with the active scheme.
+Borders use the `1bw` design-system width. Shadow geometry comes from `src/tokens/shadows.ts`; the `#shadow-sm`, `#shadow-md`, and `#shadow-lg` colors adapt with the active scheme.
 
 ## Scope
 
-This reference focuses on tokens intended for product UI. Internal loading-face
-colors and compatibility aliases are intentionally omitted.
+This reference focuses on tokens intended for product UI. Internal loading-face colors and compatibility aliases are intentionally omitted.

package/docs/ComplexLayout.md

@@ -64,6 +64,7 @@ Use `Layout.Panel` for side navigation. Panels are absolutely positioned and aut
 ```
 
 **Key props:**
+
 - `side` - Panel position: `"left"`, `"right"`, `"top"`, `"bottom"`
 - `size` - Panel width (for left/right) or height (for top/bottom)
 - `isOpen` / `onOpenChange` - Control panel visibility
@@ -86,6 +87,7 @@ Add `isResizable` to allow users to resize the panel.
 ```
 
 **Resize behavior:**
+
 - Drag the edge handle to resize
 - Double-click the handle to reset to default size
 - Use `minSize` and `maxSize` to constrain resize range
@@ -108,6 +110,7 @@ Use `sizeStorageKey` to persist the panel size in localStorage. The size will be
 ```
 
 **Notes:**
+
 - The `sizeStorageKey` must be unique across your application
 - Size is persisted after drag operations complete
 - Double-clicking to reset also updates the stored value
@@ -166,6 +169,7 @@ Use `Space` components to create three sections.
 ```
 
 **Header props:**
+
 - `title` - Page title
 - `subtitle` - Text below the title
 - `breadcrumbs` - Array of `[label, href]` tuples
@@ -222,6 +226,7 @@ Panels with `mode="sticky"` float over content without pushing it aside.
 ### Overlay Panel
 
 Panels with `mode="overlay"` show a backdrop and dismiss on:
+
 - Clicking the backdrop
 - Pressing Escape anywhere in the Layout
 - Moving focus to the main content area
@@ -264,6 +269,7 @@ Panels with `mode="dialog"` render as a modal dialog instead of inline.
 ```
 
 **Use cases:**
+
 - Mobile-responsive layouts where sidebars become modal dialogs
 - Settings panels that need full focus
 - Any panel that should overlay rather than push content
@@ -354,6 +360,7 @@ Use `Layout.Container` for content that should be horizontally centered with a c
 ```
 
 **Use cases:**
+
 - Article or documentation pages
 - Forms and settings pages
 - Any content that benefits from constrained width
@@ -371,6 +378,7 @@ Use `Layout.Center` for content that should be centered both horizontally and ve
 ```
 
 **Use cases:**
+
 - Empty states ("No items found")
 - Loading screens
 - Welcome/onboarding screens

package/docs/CreateComponent.md

@@ -38,6 +38,7 @@ function MyComponent(props: MyComponentProps) {
 ```
 
 **Filter options:**
+
 - `eventProps: true` - Include standard DOM event handlers (onClick, onFocus, etc.)
 - `labelable: true` - Include ARIA labeling properties
 - `propNames: Set<string>` - Include specific additional properties
@@ -96,7 +97,7 @@ import {
   filterBaseProps,
 } from '@tenphi/tasty';
 
-interface MyComponentProps 
+interface MyComponentProps
   extends AllBaseProps,
     ContainerStyleProps,
     TextStyleProps {
@@ -104,7 +105,7 @@ interface MyComponentProps
 
 function MyComponent(props: MyComponentProps) {
   const styles = extractStyles(props, [...CONTAINER_STYLES, ...TEXT_STYLES]);
-  
+
   return (
     <Element
       {...filterBaseProps(props, { eventProps: true })}
@@ -155,6 +156,7 @@ function MyComponent({ isLoading, mods, ...props }: MyComponentProps) {
 ```
 
 **Usage:**
+
 ```tsx
 <MyComponent mods={{ custom: true, highlighted: isHighlighted }} />
 // Renders: <div data-custom data-highlighted class="...">
@@ -169,7 +171,7 @@ const MyElement = tasty({
   styles: {
     display: 'flex',
     gap: '1x',
-    
+
     // Sub-element styles
     Icon: {
       preset: 'h3',
@@ -192,6 +194,7 @@ function MyComponent(props) {
 ```
 
 **Usage with style overrides:**
+
 ```tsx
 <MyComponent
   styles={{
@@ -204,6 +207,7 @@ function MyComponent(props) {
 ```
 
 **When to use sub-elements:**
+
 - Elements that should share the parent's state (hover, focus, disabled, etc.)
 - Tightly coupled UI parts (icon + label, title + subtitle)
 - When you want a single `styles` prop to control everything
@@ -224,7 +228,7 @@ interface MyComponentProps extends AllBaseProps {
 
 function MyComponent({ iconStyles, labelStyles, ...props }: MyComponentProps) {
   const styles = extractStyles(props, CONTAINER_STYLES);
-  
+
   return (
     <Element styles={styles}>
       <IconElement styles={iconStyles} />
@@ -235,6 +239,7 @@ function MyComponent({ iconStyles, labelStyles, ...props }: MyComponentProps) {
 ```
 
 **When to use additional style properties:**
+
 - Inner elements need independent state management (separate hover, focus behaviors)
 - Complex components with multiple logical sections
 - Components that need fine-grained styling control
@@ -251,7 +256,7 @@ import { useRef } from 'react';
 function MyButton(props) {
   const ref = useRef();
   const { buttonProps } = useButton(props, ref);
-  
+
   return (
     <Element
       {...buttonProps}
@@ -267,6 +272,7 @@ function MyButton(props) {
 ### Example 1: Block Component (Basic)
 
 This demonstrates a basic component with:
+
 - Base properties support
 - All container style properties
 - Clean, minimal implementation
@@ -308,6 +314,7 @@ export const Block = forwardRef(function Block(props: CubeBlockProps, ref) {
 ### Example 2: Action Component (Advanced)
 
 This demonstrates advanced features:
+
 - React Aria integration (`useButton`)
 - Complex modifier handling
 - Multiple style property sets
@@ -384,7 +391,7 @@ export const Action = forwardRef(function Action(
     },
     domRef,
   );
-  
+
   const { hoverProps, isHovered } = useHover({ isDisabled });
 
   const styles = extractStyles(props, STYLE_PROPS);
@@ -414,7 +421,7 @@ export const Action = forwardRef(function Action(
 For input components that need to integrate with forms, see the [Field documentation](./components/form/Field.md) for comprehensive guidance on:
 
 - Form state management
-- Validation integration  
+- Validation integration
 - Label and help text handling
 - Error state management
 - Accessibility requirements for form controls
@@ -455,7 +462,7 @@ When creating a new component, consider:
 
 - [ ] Base properties support (`AllBaseProps`, `filterBaseProps`)
 - [ ] Appropriate style property sets
-- [ ] Modifier (`mods`) support for state-based styling  
+- [ ] Modifier (`mods`) support for state-based styling
 - [ ] Additional style properties for inner elements
 - [ ] Sub-element definitions for targeted styling
 - [ ] React Aria integration for accessibility

package/docs/Introduction.md

@@ -1,36 +1,23 @@
 # Cube UI Kit
 
-Cube UI Kit is the open-source React design system behind Cube Cloud. The
-`@cube-dev/ui-kit` package combines production-ready components, accessible
-interaction patterns, a token-aware styling engine, and a runtime-configurable
-color system.
+Cube UI Kit is the open-source React design system behind Cube Cloud. The `@cube-dev/ui-kit` package combines production-ready components, accessible interaction patterns, a token-aware styling engine, and a runtime-configurable color system.
 
 ## Built for product interfaces
 
-- **Production-ready components** — From layout and typography primitives to
-  forms, tables, navigation, dialogs, notifications, and complex pickers.
-- **Accessible interactions** — React Aria provides the foundation for keyboard
-  navigation, focus management, and screen-reader behavior.
-- **Composable styling** — Components share design tokens, style properties,
-  state-driven values, and responsive syntax.
-- **Integrated forms** — Fields connect directly to validation and form state
-  without an extra wrapper component.
-- **TypeScript-first APIs** — Component props, tokens, themes, and styling values
-  are typed and discoverable.
+- **Production-ready components** — From layout and typography primitives to forms, tables, navigation, dialogs, notifications, and complex pickers.
+- **Accessible interactions** — React Aria provides the foundation for keyboard navigation, focus management, and screen-reader behavior.
+- **Composable styling** — Components share design tokens, style properties, state-driven values, and responsive syntax.
+- **Integrated forms** — Fields connect directly to validation and form state without an extra wrapper component.
+- **TypeScript-first APIs** — Component props, tokens, themes, and styling values are typed and discoverable.
 
 ## The foundations
 
 Cube UI Kit is built on two independent open-source projects:
 
-- [Tasty](https://tasty.style) is the declarative styling engine. It turns
-  token-aware style objects, responsive values, and component states into
-  conflict-free CSS.
-- [Glaze](https://github.com/tenphi/glaze) generates the semantic color palette.
-  A small set of brand and status seeds resolves into light, dark, and
-  high-contrast token sets.
+- [Tasty](https://tasty.style) is the declarative styling engine. It turns token-aware style objects, responsive values, and component states into conflict-free CSS.
+- [Glaze](https://github.com/tenphi/glaze) generates the semantic color palette. A small set of brand and status seeds resolves into light, dark, and high-contrast token sets.
 
-Use the [Theme Builder](/story/getting-started-theming--theme-builder) to tune a
-palette and preview the result across schemes and contrast levels.
+Use the [Theme Builder](/story/getting-started-theming--theme-builder) to tune a palette and preview the result across schemes and contrast levels.
 
 ## Get started
 
@@ -57,14 +44,11 @@ export function App() {
 }
 ```
 
-`Root` installs the design tokens and providers used by overlays, navigation,
-internationalization, and other shared behaviors. See the
-[Root reference](./components/Root.md) for application-level options.
+`Root` installs the design tokens and providers used by overlays, navigation, internationalization, and other shared behaviors. See the [Root reference](./components/Root.md) for application-level options.
 
 ## Style with the system
 
-Most components accept style properties directly. Values can reference semantic
-units and color tokens, so custom layouts stay aligned with the design system:
+Most components accept style properties directly. Values can reference semantic units and color tokens, so custom layouts stay aligned with the design system:
 
 ```tsx
 <Space
@@ -78,14 +62,11 @@ units and color tokens, so custom layouts stay aligned with the design system:
 </Space>
 ```
 
-For component states, reusable styled components, sub-elements, presets, and the
-complete token reference, continue to [Usage](./Usage.md)
-or the [Tasty project](https://tasty.style).
+For component states, reusable styled components, sub-elements, presets, and the complete token reference, continue to [Usage](./Usage.md) or the [Tasty project](https://tasty.style).
 
 ## Configure the palette
 
-Pass palette seeds to `Root` to apply a product theme. Glaze resolves the complete
-semantic palette from this compact configuration:
+Pass palette seeds to `Root` to apply a product theme. Glaze resolves the complete semantic palette from this compact configuration:
 
 ```tsx
 <Root
@@ -98,13 +79,11 @@ semantic palette from this compact configuration:
 </Root>
 ```
 
-The [Theming guide](./Theming.md) covers palette zones,
-runtime updates, regional previews, dark mode, and high-contrast behavior.
+The [Theming guide](./Theming.md) covers palette zones, runtime updates, regional previews, dark mode, and high-contrast behavior.
 
 ## Where to go next
 
 - Browse the sidebar for live component examples and API documentation.
 - Learn the shared styling model in [Usage](./Usage.md).
 - Build validated workflows with the [Form documentation](./components/form/Form.md).
-- Review [Base Properties](./BaseProperties.md) shared by
-  components across the kit.
+- Review [Base Properties](./BaseProperties.md) shared by components across the kit.

package/docs/RenderCache.md

@@ -82,8 +82,8 @@ const [activeId, setActiveId] = useState(1);
   getKey={(item) => item.id}
 >
   {(item) => (
-    <ExpensiveListItem 
-      item={item} 
+    <ExpensiveListItem
+      item={item}
       isActive={item.id === activeId}
     />
   )}
@@ -100,6 +100,7 @@ const [activeId, setActiveId] = useState(1);
 ## Best Practices
 
 1. **Use stable keys**: Ensure getKey returns consistent keys for the same items across renders
+
    ```jsx
    // Good: Using stable IDs
    <RenderCache
@@ -109,7 +110,7 @@ const [activeId, setActiveId] = useState(1);
    >
      {(item) => <Item {...item} />}
    </RenderCache>
-   
+
    // Bad: Using indices (unstable when list changes)
    <RenderCache
      items={items}
@@ -121,6 +122,7 @@ const [activeId, setActiveId] = useState(1);
    ```
 
 2. **Minimize renderKeys**: Only include keys that truly need re-rendering to maximize cache benefits
+
    ```jsx
    // Good: Only re-render the active item
    <RenderCache
@@ -130,7 +132,7 @@ const [activeId, setActiveId] = useState(1);
    >
      {(item) => <Item {...item} />}
    </RenderCache>
-   
+
    // Bad: Re-rendering all items defeats the purpose
    <RenderCache
      items={items}
@@ -146,12 +148,13 @@ const [activeId, setActiveId] = useState(1);
 4. **Profile first**: Use React DevTools Profiler to confirm you have a performance issue before adding this optimization
 
 5. **Avoid inline functions**: Use stable render functions to prevent unnecessary cache invalidation
+
    ```jsx
    // Good: Stable render function
    const renderItem = useCallback((item) => (
      <ExpensiveItem item={item} />
    ), []);
-   
+
    <RenderCache
      items={items}
      renderKeys={[selectedId]}
@@ -174,4 +177,3 @@ const [activeId, setActiveId] = useState(1);
 - **useMemo** - For memoizing computed values
 - **useCallback** - For memoizing callback functions
 - **DisplayTransition** - For animating component mount/unmount
-