xertica-ui 2.5.2 → 2.6.0

package/components/pages/verify-email-page/VerifyEmailPage.tsx

@@ -1,206 +1,206 @@
-import React, { useState } from 'react';
-import { Button } from '../../ui/button';
-import { XerticaLogo } from '../../brand/xertica-logo';
-import { ImageWithFallback } from '../../figma/ImageWithFallback';
-import { LanguageSelector } from '../../brand/language-selector';
-import { ArrowLeft, Mail, CheckCircle2, Lock } from 'lucide-react';
-import { useNavigate, useLocation } from 'react-router-dom';
-import { useTranslation } from 'react-i18next';
-
-/**
- * Email Verification Page component.
- *
- * @description
- * An informative screen shown after a password reset request. It instructs
- * the user to check their email and provides a "Resend email" feature.
- * Includes the same consistent layout with a hero image side-panel.
- *
- * @ai-rules
- * 1. Data Source: It retrieves the email from the router's `location.state`.
- * 2. Visual Feedback: Displays a temporary success message upon successful resale of the verification email.
- * 3. Navigation: Includes a link to return to the `LoginPage`.
- */
-export function VerifyEmailPage() {
-  const navigate = useNavigate();
-  const location = useLocation();
-  const { t } = useTranslation();
-  const email = location.state?.email || 'your@email.com';
-  const [isResending, setIsResending] = useState(false);
-  const [resendSuccess, setResendSuccess] = useState(false);
-
-  const handleResend = async () => {
-    setIsResending(true);
-    setResendSuccess(false);
-
-    // Simulate email resending
-    await new Promise(resolve => setTimeout(resolve, 1500));
-
-    setIsResending(false);
-    setResendSuccess(true);
-
-    // Remove success message after 3 seconds
-    setTimeout(() => setResendSuccess(false), 3000);
-  };
-
-  const handleSocialLogin = (_provider: string) => {
-    // Wire your SSO/social provider integration here
-  };
-
-  return (
-    <div className="h-screen w-full flex overflow-y-auto">
-      {/* Left side - Full background image */}
-      <div className="hidden lg:flex lg:flex-1 relative overflow-hidden">
-        {/* Background image filling all space */}
-        <ImageWithFallback
-          src="https://images.unsplash.com/photo-1563986768609-322da13575f3?w=1200&h=800&fit=crop&auto=format"
-          alt={t('verifyEmail.heroImageAlt')}
-          className="absolute inset-0 w-full h-full object-cover"
-        />
-
-        {/* Gradient overlay */}
-        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
-      </div>
-
-      {/* Right side - Content */}
-      <div className="flex-1 flex items-center justify-center px-4 sm:px-6 lg:px-8 lg:flex-none lg:w-1/2 relative bg-muted">
-        {/* Language selector in the top right corner */}
-        <div className="absolute top-4 right-4 z-20">
-          <LanguageSelector variant="minimal" showIcon={false} />
-        </div>
-
-        {/* Mobile background gradient */}
-        <div className="absolute inset-0 lg:hidden bg-[image:var(--gradient-diagonal)] opacity-10 dark:opacity-5" />
-
-        <div className="w-full max-w-sm space-y-6 relative z-10">
-          {/* Form header */}
-          <div className="text-center">
-            <div className="flex items-center justify-center mb-4">
-              <XerticaLogo
-                className="h-12 w-auto text-primary dark:text-foreground"
-                variant="theme"
-              />
-            </div>
-
-            {/* Email icon */}
-            <div className="flex items-center justify-center mb-4">
-              <div className="p-4 bg-primary/10 rounded-[var(--radius)]">
-                <Mail className="w-12 h-12 text-primary" />
-              </div>
-            </div>
-
-            <h2 className="text-sm text-muted-foreground">{t('verifyEmail.heading')}</h2>
-            <p className="mt-2 text-muted-foreground">{t('verifyEmail.instructionsSent')}</p>
-            <p className="mt-1 text-primary">{email}</p>
-          </div>
-
-          {/* Instructions */}
-          <div className="bg-accent rounded-[var(--radius)] p-4 space-y-3">
-            <p className="text-muted-foreground">{t('verifyEmail.instructions')}</p>
-            <div className="flex items-start gap-2 text-muted-foreground">
-              <CheckCircle2 className="w-4 h-4 mt-0.5 flex-shrink-0 text-[var(--chart-2)]" />
-              <span className="text-sm">{t('verifyEmail.checkSpam')}</span>
-            </div>
-          </div>
-
-          {/* Success message on resend */}
-          {resendSuccess && (
-            <div className="bg-[var(--chart-2)]/10 border border-[var(--chart-2)]/20 rounded-[var(--radius)] p-3 flex items-center gap-2">
-              <CheckCircle2 className="w-5 h-5 text-[var(--chart-2)] flex-shrink-0" />
-              <span className="text-sm text-[var(--chart-2)]">
-                {t('verifyEmail.resentSuccess')}
-              </span>
-            </div>
-          )}
-
-          {/* Action buttons */}
-          <div className="space-y-3">
-            <p className="text-center text-muted-foreground">{t('verifyEmail.notReceived')}</p>
-            <Button
-              variant="outline"
-              className="w-full"
-              onClick={handleResend}
-              disabled={isResending}
-            >
-              {isResending ? t('verifyEmail.resending') : t('verifyEmail.resend')}
-            </Button>
-
-            <Button
-              type="button"
-              onClick={() => navigate('/login')}
-              variant="outline"
-              className="w-full text-muted-foreground hover:text-foreground"
-            >
-              <ArrowLeft className="w-4 h-4 mr-2" />
-              {t('verifyEmail.backToLogin')}
-            </Button>
-          </div>
-
-          {/* Divider */}
-          <div className="relative">
-            <div className="absolute inset-0 flex items-center">
-              <div className="w-full border-t border-border"></div>
-            </div>
-            <div className="relative flex justify-center text-sm">
-              <span className="bg-muted px-2 text-muted-foreground">
-                {t('login.orContinueWith')}
-              </span>
-            </div>
-          </div>
-
-          {/* Social/SSO login options */}
-          <div className="space-y-3">
-            {/* Google */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center"
-              onClick={() => handleSocialLogin('Google')}
-            >
-              <svg className="w-5 h-5 mr-2" viewBox="0 0 48 48" xmlns="http://www.w3.org/2000/svg">
-                <path
-                  fill="#EA4335"
-                  d="M24 9.5c3.54 0 6.71 1.22 9.21 3.6l6.85-6.85C35.9 2.38 30.47 0 24 0 14.62 0 6.51 5.38 2.56 13.22l7.98 6.19C12.43 13.72 17.74 9.5 24 9.5z"
-                ></path>
-                <path
-                  fill="#4285F4"
-                  d="M46.98 24.55c0-1.57-.15-3.09-.38-4.55H24v9.02h12.94c-.58 2.96-2.26 5.48-4.78 7.18l7.73 6c4.51-4.18 7.09-10.36 7.09-17.65z"
-                ></path>
-                <path
-                  fill="#FBBC05"
-                  d="M10.53 28.59c-.48-1.45-.76-2.99-.76-4.59s.27-3.14.76-4.59l-7.98-6.19C.92 16.46 0 20.12 0 24c0 3.88.92 7.54 2.56 10.78l7.97-6.19z"
-                ></path>
-                <path
-                  fill="#34A853"
-                  d="M24 48c6.48 0 11.93-2.13 15.89-5.81l-7.73-6c-2.15 1.45-4.92 2.3-8.16 2.3-6.26 0-11.57-4.22-13.47-9.91l-7.98 6.19C6.51 42.62 14.62 48 24 48z"
-                ></path>
-                <path fill="none" d="M0 0h48v48H0z"></path>
-              </svg>
-              <span>{t('login.signInWithGoogle')}</span>
-            </Button>
-
-            {/* MT Login */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center"
-              onClick={() => handleSocialLogin('MT Login')}
-            >
-              <Lock className="w-5 h-5 mr-2 text-[var(--chart-4)]" />
-              <span>{t('login.signInWithMTLogin')}</span>
-            </Button>
-
-            {/* gov.br */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center font-normal"
-              onClick={() => handleSocialLogin('gov.br')}
-            >
-              <span>{t('login.signInWithGovBr')}</span>
-            </Button>
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-}
+import React, { useState } from 'react';
+import { Button } from '../../ui/button';
+import { XerticaLogo } from '../../brand/xertica-logo';
+import { ImageWithFallback } from '../../figma/ImageWithFallback';
+import { LanguageSelector } from '../../brand/language-selector';
+import { ArrowLeft, Mail, CheckCircle2, Lock } from 'lucide-react';
+import { useNavigate, useLocation } from 'react-router-dom';
+import { useTranslation } from 'react-i18next';
+
+/**
+ * Email Verification Page component.
+ *
+ * @description
+ * An informative screen shown after a password reset request. It instructs
+ * the user to check their email and provides a "Resend email" feature.
+ * Includes the same consistent layout with a hero image side-panel.
+ *
+ * @ai-rules
+ * 1. Data Source: It retrieves the email from the router's `location.state`.
+ * 2. Visual Feedback: Displays a temporary success message upon successful resale of the verification email.
+ * 3. Navigation: Includes a link to return to the `LoginPage`.
+ */
+export function VerifyEmailPage() {
+  const navigate = useNavigate();
+  const location = useLocation();
+  const { t } = useTranslation();
+  const email = location.state?.email || 'your@email.com';
+  const [isResending, setIsResending] = useState(false);
+  const [resendSuccess, setResendSuccess] = useState(false);
+
+  const handleResend = async () => {
+    setIsResending(true);
+    setResendSuccess(false);
+
+    // Simulate email resending
+    await new Promise(resolve => setTimeout(resolve, 1500));
+
+    setIsResending(false);
+    setResendSuccess(true);
+
+    // Remove success message after 3 seconds
+    setTimeout(() => setResendSuccess(false), 3000);
+  };
+
+  const handleSocialLogin = (_provider: string) => {
+    // Wire your SSO/social provider integration here
+  };
+
+  return (
+    <div className="h-screen w-full flex overflow-y-auto">
+      {/* Left side - Full background image */}
+      <div className="hidden lg:flex lg:flex-1 relative overflow-hidden">
+        {/* Background image filling all space */}
+        <ImageWithFallback
+          src="https://images.unsplash.com/photo-1563986768609-322da13575f3?w=1200&h=800&fit=crop&auto=format"
+          alt={t('verifyEmail.heroImageAlt')}
+          className="absolute inset-0 w-full h-full object-cover"
+        />
+
+        {/* Gradient overlay */}
+        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
+      </div>
+
+      {/* Right side - Content */}
+      <div className="flex-1 flex items-center justify-center px-4 sm:px-6 lg:px-8 lg:flex-none lg:w-1/2 relative bg-muted">
+        {/* Language selector in the top right corner */}
+        <div className="absolute top-4 right-4 z-20">
+          <LanguageSelector variant="minimal" showIcon={false} />
+        </div>
+
+        {/* Mobile background gradient */}
+        <div className="absolute inset-0 lg:hidden bg-[image:var(--gradient-diagonal)] opacity-10 dark:opacity-5" />
+
+        <div className="w-full max-w-sm space-y-6 relative z-10">
+          {/* Form header */}
+          <div className="text-center">
+            <div className="flex items-center justify-center mb-4">
+              <XerticaLogo
+                className="h-12 w-auto text-primary dark:text-foreground"
+                variant="theme"
+              />
+            </div>
+
+            {/* Email icon */}
+            <div className="flex items-center justify-center mb-4">
+              <div className="p-4 bg-primary/10 rounded-[var(--radius)]">
+                <Mail className="w-12 h-12 text-primary" />
+              </div>
+            </div>
+
+            <h2 className="text-sm text-muted-foreground">{t('verifyEmail.heading')}</h2>
+            <p className="mt-2 text-muted-foreground">{t('verifyEmail.instructionsSent')}</p>
+            <p className="mt-1 text-primary">{email}</p>
+          </div>
+
+          {/* Instructions */}
+          <div className="bg-accent rounded-[var(--radius)] p-4 space-y-3">
+            <p className="text-muted-foreground">{t('verifyEmail.instructions')}</p>
+            <div className="flex items-start gap-2 text-muted-foreground">
+              <CheckCircle2 className="w-4 h-4 mt-0.5 flex-shrink-0 text-[var(--chart-2)]" />
+              <span className="text-sm">{t('verifyEmail.checkSpam')}</span>
+            </div>
+          </div>
+
+          {/* Success message on resend */}
+          {resendSuccess && (
+            <div className="bg-[var(--chart-2)]/10 border border-[var(--chart-2)]/20 rounded-[var(--radius)] p-3 flex items-center gap-2">
+              <CheckCircle2 className="w-5 h-5 text-[var(--chart-2)] flex-shrink-0" />
+              <span className="text-sm text-[var(--chart-2)]">
+                {t('verifyEmail.resentSuccess')}
+              </span>
+            </div>
+          )}
+
+          {/* Action buttons */}
+          <div className="space-y-3">
+            <p className="text-center text-muted-foreground">{t('verifyEmail.notReceived')}</p>
+            <Button
+              variant="outline"
+              className="w-full"
+              onClick={handleResend}
+              disabled={isResending}
+            >
+              {isResending ? t('verifyEmail.resending') : t('verifyEmail.resend')}
+            </Button>
+
+            <Button
+              type="button"
+              onClick={() => navigate('/login')}
+              variant="outline"
+              className="w-full text-muted-foreground hover:text-foreground"
+            >
+              <ArrowLeft className="w-4 h-4 mr-2" />
+              {t('verifyEmail.backToLogin')}
+            </Button>
+          </div>
+
+          {/* Divider */}
+          <div className="relative">
+            <div className="absolute inset-0 flex items-center">
+              <div className="w-full border-t border-border"></div>
+            </div>
+            <div className="relative flex justify-center text-sm">
+              <span className="bg-muted px-2 text-muted-foreground">
+                {t('login.orContinueWith')}
+              </span>
+            </div>
+          </div>
+
+          {/* Social/SSO login options */}
+          <div className="space-y-3">
+            {/* Google */}
+            <Button
+              type="button"
+              variant="outline"
+              className="w-full justify-center"
+              onClick={() => handleSocialLogin('Google')}
+            >
+              <svg className="w-5 h-5 mr-2" viewBox="0 0 48 48" xmlns="http://www.w3.org/2000/svg">
+                <path
+                  fill="#EA4335"
+                  d="M24 9.5c3.54 0 6.71 1.22 9.21 3.6l6.85-6.85C35.9 2.38 30.47 0 24 0 14.62 0 6.51 5.38 2.56 13.22l7.98 6.19C12.43 13.72 17.74 9.5 24 9.5z"
+                ></path>
+                <path
+                  fill="#4285F4"
+                  d="M46.98 24.55c0-1.57-.15-3.09-.38-4.55H24v9.02h12.94c-.58 2.96-2.26 5.48-4.78 7.18l7.73 6c4.51-4.18 7.09-10.36 7.09-17.65z"
+                ></path>
+                <path
+                  fill="#FBBC05"
+                  d="M10.53 28.59c-.48-1.45-.76-2.99-.76-4.59s.27-3.14.76-4.59l-7.98-6.19C.92 16.46 0 20.12 0 24c0 3.88.92 7.54 2.56 10.78l7.97-6.19z"
+                ></path>
+                <path
+                  fill="#34A853"
+                  d="M24 48c6.48 0 11.93-2.13 15.89-5.81l-7.73-6c-2.15 1.45-4.92 2.3-8.16 2.3-6.26 0-11.57-4.22-13.47-9.91l-7.98 6.19C6.51 42.62 14.62 48 24 48z"
+                ></path>
+                <path fill="none" d="M0 0h48v48H0z"></path>
+              </svg>
+              <span>{t('login.signInWithGoogle')}</span>
+            </Button>
+
+            {/* MT Login */}
+            <Button
+              type="button"
+              variant="outline"
+              className="w-full justify-center"
+              onClick={() => handleSocialLogin('MT Login')}
+            >
+              <Lock className="w-5 h-5 mr-2 text-[var(--chart-4)]" />
+              <span>{t('login.signInWithMTLogin')}</span>
+            </Button>
+
+            {/* gov.br */}
+            <Button
+              type="button"
+              variant="outline"
+              className="w-full justify-center font-normal"
+              onClick={() => handleSocialLogin('gov.br')}
+            >
+              <span>{t('login.signInWithGovBr')}</span>
+            </Button>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

package/components/pages/verify-email-page/verify-email-page.mdx

@@ -1,55 +1,55 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-
-<Meta title="Pages/VerifyEmailPage" />
-
-<Title>VerifyEmailPage</Title>
-<Subtitle>Full-page confirmation screen for email verification with a resend action.</Subtitle>
-
----
-
-## Overview
-
-`VerifyEmailPage` is shown after a user submits their email on `ForgotPasswordPage`. It reads the email address from `location.state?.email` (passed via React Router navigation state) and displays it in the confirmation message.
-
-The page includes a "Resend email" button that shows a 3-second success feedback before resetting.
-
-This component requires React Router v6+.
-
-```tsx
-import { VerifyEmailPage } from 'xertica-ui';
-
-// In your router config:
-{ path: '/verify-email', element: <VerifyEmailPage /> }
-```
-
----
-
-## Navigation Flow
-
-```
-/forgot-password  ──▶  /verify-email  (state: { email: string })
-                            │
-                    [resend button]  (no navigation — UI feedback only)
-```
-
----
-
-## Reading Location State
-
-The page automatically reads `location.state?.email` from React Router. If no email is present (e.g., the user navigates directly to `/verify-email`), the email display gracefully omits the address.
-
----
-
-## Props
-
-This component accepts no props — it is a self-contained page.
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Router requirement** — Must be inside a React Router `<BrowserRouter>`. `useLocation` is used to read navigation state.
-> - **State dependency** — Navigate to this page using `navigate('/verify-email', { state: { email } })` or the email display will be blank.
-> - **Resend logic** — The resend button currently provides visual-only feedback. Wire your actual resend API call by forking the component or wrapping it with a custom route element.
-> - **Expiry handling** — Add a link back to `/forgot-password` for cases where the verification link expires, so users can restart the flow.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+
+<Meta title="Pages/VerifyEmailPage" />
+
+<Title>VerifyEmailPage</Title>
+<Subtitle>Full-page confirmation screen for email verification with a resend action.</Subtitle>
+
+---
+
+## Overview
+
+`VerifyEmailPage` is shown after a user submits their email on `ForgotPasswordPage`. It reads the email address from `location.state?.email` (passed via React Router navigation state) and displays it in the confirmation message.
+
+The page includes a "Resend email" button that shows a 3-second success feedback before resetting.
+
+This component requires React Router v6+.
+
+```tsx
+import { VerifyEmailPage } from 'xertica-ui';
+
+// In your router config:
+{ path: '/verify-email', element: <VerifyEmailPage /> }
+```
+
+---
+
+## Navigation Flow
+
+```
+/forgot-password  ──▶  /verify-email  (state: { email: string })
+                            │
+                    [resend button]  (no navigation — UI feedback only)
+```
+
+---
+
+## Reading Location State
+
+The page automatically reads `location.state?.email` from React Router. If no email is present (e.g., the user navigates directly to `/verify-email`), the email display gracefully omits the address.
+
+---
+
+## Props
+
+This component accepts no props — it is a self-contained page.
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Router requirement** — Must be inside a React Router `<BrowserRouter>`. `useLocation` is used to read navigation state.
+> - **State dependency** — Navigate to this page using `navigate('/verify-email', { state: { email } })` or the email display will be blank.
+> - **Resend logic** — The resend button currently provides visual-only feedback. Wire your actual resend API call by forking the component or wrapping it with a custom route element.
+> - **Expiry handling** — Add a link back to `/forgot-password` for cases where the verification link expires, so users can restart the flow.

package/components/public-api-smoke.test.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
 import { render, screen } from '@testing-library/react';
 import { renderHook } from '@testing-library/react';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { describe, expect, it } from 'vitest';
 import * as Root from './index';
 import * as Assistant from './assistant';
@@ -29,13 +30,16 @@ describe('public API smoke tests', () => {
   });
 
   it('renders representative components from the public subpaths', () => {
+    const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false } } });
     render(
-      <Brand.XerticaProvider>
-        <UI.Button>Action</UI.Button>
-        <Layout.Header title="Header smoke" />
-        <Assistant.MarkdownMessage content="**Assistant** smoke" />
-        <Media.AudioPlayer title="Audio smoke" enableAutoFloat={false} />
-      </Brand.XerticaProvider>
+      <QueryClientProvider client={queryClient}>
+        <Brand.XerticaProvider>
+          <UI.Button>Action</UI.Button>
+          <Layout.Header title="Header smoke" />
+          <Assistant.MarkdownMessage content="**Assistant** smoke" />
+          <Media.AudioPlayer title="Audio smoke" enableAutoFloat={false} />
+        </Brand.XerticaProvider>
+      </QueryClientProvider>
     );
 
     expect(screen.getByRole('button', { name: 'Action' })).toBeInTheDocument();

package/components/shared/assistant-utils.ts

@@ -1,5 +1,6 @@
 import { BarChart3, ImageIcon, Table as TableIcon, FileText } from 'lucide-react';
 import React from 'react';
+import type { ChartConfig, DashboardChartDatum } from '../ui/chart';
 
 export interface AssistantSuggestion {
   id: string;
@@ -13,8 +14,8 @@ export interface AssistantMessage {
   content: string;
   timestamp: Date;
   isFavorite?: boolean;
-  chartData?: any[];
-  chartConfig?: any;
+  chartData?: DashboardChartDatum[];
+  chartConfig?: ChartConfig;
   attachmentType?: 'file' | 'audio' | 'image' | 'video' | 'document' | 'podcast' | 'search';
   attachmentName?: string;
   documentContent?: string;

package/components/shared/navigation.ts

@@ -11,9 +11,9 @@ export interface RouteConfig {
   /** Display label (used in sidebar and breadcrumbs) */
   label: string;
   /** Leading icon component */
-  icon: React.ComponentType<any>;
+  icon: React.ComponentType<{ className?: string }>;
   /** Optional page component (not used by the sidebar directly) */
-  component?: React.ComponentType<any>;
+  component?: React.ComponentType<{ className?: string }>;
 }
 
 // ─────────────────────────────────────────────────────────────────────────────

package/components/ui/accordion/accordion.mdx

@@ -1,29 +1,29 @@
-import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
-import * as AccordionStories from './accordion.stories';
-
-<Meta of={AccordionStories} />
-
-<Title />
-<Subtitle>A vertically stacked set of collapsible sections.</Subtitle>
-
-<Description />
-
-<Primary />
-
-## Controls
-<Controls />
-
----
-
-## Variations
-
-<Stories />
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Anatomy** — `AccordionItem` requires a unique `value`.
-> - **Icons** — The chevron icon is built-in; do not add your own.
-> - **Context** — Use `type="single" collapsible` for FAQs. Use `type="multiple"` for settings panels.
+import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
+import * as AccordionStories from './accordion.stories';
+
+<Meta of={AccordionStories} />
+
+<Title />
+<Subtitle>A vertically stacked set of collapsible sections.</Subtitle>
+
+<Description />
+
+<Primary />
+
+## Controls
+<Controls />
+
+---
+
+## Variations
+
+<Stories />
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Anatomy** — `AccordionItem` requires a unique `value`.
+> - **Icons** — The chevron icon is built-in; do not add your own.
+> - **Context** — Use `type="single" collapsible` for FAQs. Use `type="multiple"` for settings panels.