xertica-ui 2.4.0 → 2.5.0

package/components/pages/template-content/template-content.mdx

@@ -1,61 +1,61 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-
-<Meta title="Pages/TemplateContent" />
-
-<Title>TemplateContent</Title>
-<Subtitle>Kitchen-sink showcase and CLI starter template demonstrating the full Xertica UI component set.</Subtitle>
-
----
-
-## Overview
-
-`TemplateContent` is a comprehensive living demo that assembles the majority of Xertica UI primitives into a single scrollable page. It serves two purposes:
-
-1. **Development reference** - Shows the correct composition patterns for every major component.
-2. **CLI starter** - Acts as the baseline when scaffolding a new application page.
-
-It includes interactive showcases for cards, tabs, forms, tables, dialogs, alerts, progress, sliders, maps, headers, and sidebars.
-
-```tsx
-import { TemplateContent } from 'xertica-ui';
-
-{ path: '/template', element: <TemplateContent /> }
-```
-
----
-
-## Props
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `user` | `{ name?: string; email?: string; avatar?: string } \| null` | - | Currently authenticated user for the header. |
-| `onLogout` | `() => void` | - | Logout handler forwarded to the header. |
-| `onSettings` | `() => void` | - | Settings handler forwarded to the header. |
-
----
-
-## Layout Dependency
-
-`TemplateContent` uses optional layout state. When wrapped in `XerticaProvider`, it synchronizes sidebar width, expanded state, and layout controls. Without the provider, it renders with local fallback sidebar state.
-
-React Router is still required because the showcase uses `Link` and `useNavigate`.
-
----
-
-## Sidebar Showcase
-
-`TemplateContent` includes an embedded, interactive `Sidebar` preview with controls for:
-
-- Toggling footer sections.
-- Adjusting sidebar width via a `Slider`.
-- Switching between `variant="assistant"` and `variant="default"` modes.
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Reference first** - Before building a new page, check `TemplateContent` for the correct composition pattern.
-> - **Provider fallback** - `TemplateContent` renders without `XerticaProvider`, but the provider is recommended for synchronized layout state.
-> - **Router requirement** - React Router is still required for navigation hooks and links.
-> - **Map section** - The Maps showcase requires a valid `googleMapsApiKey` passed to `XerticaProvider`.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+
+<Meta title="Pages/TemplateContent" />
+
+<Title>TemplateContent</Title>
+<Subtitle>Kitchen-sink showcase and CLI starter template demonstrating the full Xertica UI component set.</Subtitle>
+
+---
+
+## Overview
+
+`TemplateContent` is a comprehensive living demo that assembles the majority of Xertica UI primitives into a single scrollable page. It serves two purposes:
+
+1. **Development reference** - Shows the correct composition patterns for every major component.
+2. **CLI starter** - Acts as the baseline when scaffolding a new application page.
+
+It includes interactive showcases for cards, tabs, forms, tables, dialogs, alerts, progress, sliders, maps, headers, and sidebars.
+
+```tsx
+import { TemplateContent } from 'xertica-ui';
+
+{ path: '/template', element: <TemplateContent /> }
+```
+
+---
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `user` | `{ name?: string; email?: string; avatar?: string } \| null` | - | Currently authenticated user for the header. |
+| `onLogout` | `() => void` | - | Logout handler forwarded to the header. |
+| `onSettings` | `() => void` | - | Settings handler forwarded to the header. |
+
+---
+
+## Layout Dependency
+
+`TemplateContent` uses optional layout state. When wrapped in `XerticaProvider`, it synchronizes sidebar width, expanded state, and layout controls. Without the provider, it renders with local fallback sidebar state.
+
+React Router is still required because the showcase uses `Link` and `useNavigate`.
+
+---
+
+## Sidebar Showcase
+
+`TemplateContent` includes an embedded, interactive `Sidebar` preview with controls for:
+
+- Toggling footer sections.
+- Adjusting sidebar width via a `Slider`.
+- Switching between `variant="assistant"` and `variant="default"` modes.
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Reference first** - Before building a new page, check `TemplateContent` for the correct composition pattern.
+> - **Provider fallback** - `TemplateContent` renders without `XerticaProvider`, but the provider is recommended for synchronized layout state.
+> - **Router requirement** - React Router is still required for navigation hooks and links.
+> - **Map section** - The Maps showcase requires a valid `googleMapsApiKey` passed to `XerticaProvider`.

package/components/pages/template-page/TemplatePage.stories.tsx

@@ -2,6 +2,7 @@ import type { Meta, StoryObj } from '@storybook/react';
 import { TemplatePage } from './TemplatePage';
 import { MemoryRouter } from 'react-router-dom';
 import { LayoutProvider } from '../../../contexts/LayoutContext';
+import { AuthProvider } from '../../../contexts/AuthContext';
 import React from 'react';
 
 const meta: Meta<typeof TemplatePage> = {
@@ -10,9 +11,11 @@ const meta: Meta<typeof TemplatePage> = {
   decorators: [
     Story => (
       <MemoryRouter initialEntries={['/template']}>
-        <LayoutProvider>
-          <Story />
-        </LayoutProvider>
+        <AuthProvider>
+          <LayoutProvider>
+            <Story />
+          </LayoutProvider>
+        </AuthProvider>
       </MemoryRouter>
     ),
   ],
@@ -24,16 +27,6 @@ const meta: Meta<typeof TemplatePage> = {
 export default meta;
 type Story = StoryObj<typeof TemplatePage>;
 
-export const Default: Story = {
-  args: {
-    user: { email: 'ariel@xertica.com' },
-    onLogout: () => {},
-  },
-};
+export const Default: Story = {};
 
-export const NoUser: Story = {
-  args: {
-    user: null,
-    onLogout: () => {},
-  },
-};
+export const NoUser: Story = {};

package/components/pages/template-page/template-page.mdx

@@ -1,53 +1,53 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-import * as TemplatePageStories from './TemplatePage.stories';
-
-<Meta of={TemplatePageStories} />
-
-<Title>TemplatePage</Title>
-<Subtitle>Full application shell with the component kitchen-sink reference.</Subtitle>
-
----
-
-## Overview
-
-`TemplatePage` is the reference implementation of the full application layout. It assembles:
-
-- **Sidebar** - Primary navigation.
-- **TemplateContent** - Kitchen-sink showcase of Xertica UI components.
-- **XerticaAssistant** - Floating AI assistant panel.
-
-When `XerticaProvider` is present, the page synchronizes sidebar width, sidebar expansion, and assistant visibility through `LayoutContext`. Without the provider, it renders with local fallback layout state.
-
-**Requires:** React Router v6. `XerticaProvider` is recommended for app-level synchronization.
-
----
-
-## Props
-
-| Prop | Type | Required | Description |
-|---|---|---|---|
-| `user` | `{ email: string } \| null` | Yes | Currently authenticated user. Passed to Sidebar for avatar and user menu display. |
-| `onLogout` | `() => void` | Yes | Called when the user triggers logout from the Sidebar. |
-
----
-
-## Composition
-
-```tsx
-import { TemplatePage } from 'xertica-ui';
-
-<Route
-  path="/template"
-  element={<TemplatePage user={currentUser} onLogout={handleLogout} />}
-/>
-```
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Reference implementation** - Use `TemplatePage` as the primary reference for assembling complex layouts.
-> - **Top-level only** - This is a full-screen layout component. Do not nest it inside other layouts.
-> - **Provider fallback** - The page renders without `XerticaProvider`, but the provider is recommended for synchronized app layout.
-> - **Extend via TemplateContent** - To change showcased components, edit `TemplateContent`.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+import * as TemplatePageStories from './TemplatePage.stories';
+
+<Meta of={TemplatePageStories} />
+
+<Title>TemplatePage</Title>
+<Subtitle>Full application shell with the component kitchen-sink reference.</Subtitle>
+
+---
+
+## Overview
+
+`TemplatePage` is the reference implementation of the full application layout. It assembles:
+
+- **Sidebar** - Primary navigation.
+- **TemplateContent** - Kitchen-sink showcase of Xertica UI components.
+- **XerticaAssistant** - Floating AI assistant panel.
+
+When `XerticaProvider` is present, the page synchronizes sidebar width, sidebar expansion, and assistant visibility through `LayoutContext`. Without the provider, it renders with local fallback layout state.
+
+**Requires:** React Router v6. `XerticaProvider` is recommended for app-level synchronization.
+
+---
+
+## Props
+
+| Prop | Type | Required | Description |
+|---|---|---|---|
+| `user` | `{ email: string } \| null` | Yes | Currently authenticated user. Passed to Sidebar for avatar and user menu display. |
+| `onLogout` | `() => void` | Yes | Called when the user triggers logout from the Sidebar. |
+
+---
+
+## Composition
+
+```tsx
+import { TemplatePage } from 'xertica-ui';
+
+<Route
+  path="/template"
+  element={<TemplatePage user={currentUser} onLogout={handleLogout} />}
+/>
+```
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Reference implementation** - Use `TemplatePage` as the primary reference for assembling complex layouts.
+> - **Top-level only** - This is a full-screen layout component. Do not nest it inside other layouts.
+> - **Provider fallback** - The page renders without `XerticaProvider`, but the provider is recommended for synchronized app layout.
+> - **Extend via TemplateContent** - To change showcased components, edit `TemplateContent`.