feat(storybook): overhaul 6-tier taxonomy, author 3 living enterprise…

.storybook/preview.ts

@@ -32,24 +32,40 @@ const preview: Preview = {
       storySort: {
         order: [
           'Overview & Docs',
+          'Foundations & Docs',
           ['Introduction', 'How to Use Storybook', 'Design Tokens', 'Performance Dashboard'],
-          'Introduction',
-          'Docs',
-          ['Design Tokens', 'Performance Dashboard'],
+          'Living Enterprise Workflows',
+          [
+            'Vendor Onboarding & KYC Flow',
+            'Procurement & Invoicing Settlement Flow',
+            'Multi-Tenant Administration Flow',
+            'Interactive Workbench',
+          ],
           'Playground',
-          ['Interactive Workbench', 'Vendor Onboarding Flow', 'Procurement Ledger'],
+          ['Interactive Workbench'],
+          'Core UI Primitives',
+          [
+            'Primitives',
+            'Forms & Inputs',
+            'Data Display',
+            'Feedback & States',
+            'Overlays & Dialogs',
+            'Navigation & Shell',
+          ],
           'Core',
           'Forms',
           'Data Display',
           'Feedback',
           'Overlays',
           'Navigation',
           'Layout',
+          'India Statutory & Regional',
           'India Primitives',
           'India',
+          'Enterprise Authentication',
           'Authentication',
           'Auth',
-          'UI',
+          'Domain & Talent Lab',
           '*',
         ],
       },

packages/auth/src/components/auth-card.stories.tsx

@@ -4,7 +4,7 @@ import { AuthProvider } from '../context/auth-context';
 import { MockAuthAdapter } from '../core/mock-adapter';
 
 const meta: Meta<typeof AuthCard> = {
-  title: 'Authentication/AuthCard',
+  title: 'Enterprise Authentication/AuthCard',
   component: AuthCard,
   tags: ['autodocs'],
   parameters: {

packages/auth/src/components/forgot-password-form.stories.tsx

@@ -4,7 +4,7 @@ import { AuthProvider } from '../context/auth-context';
 import { MockAuthAdapter } from '../core/mock-adapter';
 
 const meta: Meta<typeof ForgotPasswordForm> = {
-  title: 'Authentication/ForgotPasswordForm',
+  title: 'Enterprise Authentication/ForgotPasswordForm',
   component: ForgotPasswordForm,
   tags: ['autodocs'],
   parameters: {

packages/auth/src/components/login-form.stories.tsx

@@ -4,7 +4,7 @@ import { AuthProvider } from '../context/auth-context';
 import { MockAuthAdapter, DEFAULT_MOCK_PASSWORD } from '../core/mock-adapter';
 
 const meta: Meta<typeof LoginForm> = {
-  title: 'Authentication/LoginForm',
+  title: 'Enterprise Authentication/LoginForm',
   component: LoginForm,
   tags: ['autodocs'],
   parameters: {

packages/auth/src/components/oauth-button-group.stories.tsx

@@ -4,7 +4,7 @@ import { AuthProvider } from '../context/auth-context';
 import { MockAuthAdapter } from '../core/mock-adapter';
 
 const meta: Meta<typeof OAuthButtonGroup> = {
-  title: 'Authentication/OAuthButtonGroup',
+  title: 'Enterprise Authentication/OAuthButtonGroup',
   component: OAuthButtonGroup,
   tags: ['autodocs'],
   parameters: {

packages/auth/src/components/oauth-button.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from '@storybook/react';
 import { OAuthButton } from './oauth-button';
 
 const meta: Meta<typeof OAuthButton> = {
-  title: 'Authentication/OAuthButton',
+  title: 'Enterprise Authentication/OAuthButton',
   component: OAuthButton,
   tags: ['autodocs'],
   parameters: {

packages/auth/src/components/otp-form.stories.tsx

@@ -4,7 +4,7 @@ import { AuthProvider } from '../context/auth-context';
 import { MockAuthAdapter } from '../core/mock-adapter';
 
 const meta: Meta<typeof OtpForm> = {
-  title: 'Authentication/OtpForm',
+  title: 'Enterprise Authentication/OtpForm',
   component: OtpForm,
   tags: ['autodocs'],
   parameters: {

packages/auth/src/components/signup-form.stories.tsx

@@ -4,7 +4,7 @@ import { AuthProvider } from '../context/auth-context';
 import { MockAuthAdapter } from '../core/mock-adapter';
 
 const meta: Meta<typeof SignUpForm> = {
-  title: 'Authentication/SignUpForm',
+  title: 'Enterprise Authentication/SignUpForm',
   component: SignUpForm,
   tags: ['autodocs'],
   parameters: {

public/sitemap.xml

@@ -7,57 +7,77 @@
     <priority>1.0</priority>
   </url>
 
-  <!-- Overview & Documentation -->
+  <!-- Foundations & Documentation -->
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/overview-docs-introduction--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/foundations-docs-introduction--docs</loc>
     <changefreq>weekly</changefreq>
     <priority>0.9</priority>
   </url>
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/overview-docs-how-to-use-storybook--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/foundations-docs-how-to-use-storybook--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.9</priority>
   </url>
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/overview-docs-design-tokens--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/foundations-docs-design-tokens--docs</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/foundations-docs-performance-dashboard--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
 
-  <!-- Interactive Workbench / Playground -->
+  <!-- Living Enterprise Workflows -->
+  <url>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/living-enterprise-workflows-vendor-onboarding-kyc-flow--docs</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/living-enterprise-workflows-procurement-invoicing-settlement-flow--docs</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.9</priority>
+  </url>
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/playground-interactive-workbench--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/living-enterprise-workflows-multi-tenant-administration-flow--docs</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/living-enterprise-workflows-interactive-workbench--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.9</priority>
   </url>
 
   <!-- Core UI Primitives -->
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/forms-button--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/core-ui-primitives-forms-inputs-button--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/data-display-datatable--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/core-ui-primitives-data-display-datatable--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
 
-  <!-- Authentication Components -->
+  <!-- India Statutory & Regional -->
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/authentication-authcard--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/india-statutory-regional-amountsummarycardindia--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
-
-  <!-- India Statutory Compliance Primitives -->
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/india-primitives-amountsummarycardindia--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/india-statutory-regional-upiqrcard--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
+
+  <!-- Enterprise Authentication -->
   <url>
-    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/india-primitives-upiqrcard--docs</loc>
+    <loc>https://abeta-dev.github.io/react-libs/?path=/docs/enterprise-authentication-authcard--docs</loc>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

src/components/ui/core/calendar.stories.tsx

@@ -102,7 +102,7 @@ function MultipleCalendarStory(args: CalendarStoryArgs) {
  * - Range styling: start/end = filled circles; middle = soft accent fill, no radius
  */
 const meta = {
-  title: "Core/Calendar",
+  title: "Core UI Primitives/Forms & Inputs/Calendar",
   component: Calendar,
   parameters: {
     layout: "centered",

src/components/ui/core/date-range-picker.stories.tsx

@@ -50,7 +50,7 @@ function ControlledDateRangeStory(args: DateRangePickerStoryArgs) {
  * The trigger supports button variants and range changes are committed only when users click Apply.
  */
 const meta = {
-  title: "Core/DateRangePicker",
+  title: "Core UI Primitives/Forms & Inputs/DateRangePicker",
   component: DatePickerWithRange,
   parameters: {
     layout: "centered",

src/components/ui/core/item.stories.tsx

@@ -15,7 +15,7 @@ import { Button } from "../forms/button";
 import { FileText, ChevronRight, CheckCircle2, AlertTriangle, ArrowUpRight } from "lucide-react";
 
 const meta: Meta<typeof Item> = {
-  title: "Core/Item",
+  title: "Core UI Primitives/Primitives/Item",
   component: Item,
   tags: ["autodocs"],
   parameters: {

src/components/ui/core/kbd.stories.tsx

@@ -15,7 +15,7 @@ import { Kbd, KbdGroup, KbdShortcut } from "./kbd";
  *   - Override detection with `os="mac"` or `os="windows"`
  */
 const meta = {
-  title: "Core/Kbd",
+  title: "Core UI Primitives/Primitives/Kbd",
   component: Kbd,
   parameters: {
     layout: "centered",

src/components/ui/core/language-toggle.stories.tsx

@@ -13,7 +13,7 @@ import { LanguageToggle, type SupportedLanguage } from "./language-toggle";
  * - Dropdown items show native script + English subtitle
  */
 const meta = {
-  title: "Core/LanguageToggle",
+  title: "India Statutory & Regional/LanguageToggle",
   component: LanguageToggle,
   parameters: {
     layout: "centered",

src/components/ui/core/popover.stories.tsx

@@ -15,7 +15,7 @@ import {
 type PopoverContentStoryArgs = React.ComponentProps<typeof PopoverContent>;
 
 const meta = {
-  title: "Core/Popover",
+  title: "Core UI Primitives/Overlays & Dialogs/Popover",
   component: PopoverContent,
   parameters: {
     layout: "centered",

src/components/ui/core/typography.stories.tsx

@@ -4,7 +4,7 @@ import { expect } from "storybook/test"
 import { Typography } from "./typography"
 
 const meta = {
-  title: "Core/Typography",
+  title: "Core UI Primitives/Primitives/Typography",
   component: Typography,
   parameters: {
     layout: "padded",

src/components/ui/data-display/ActiveFilterBadge.stories.tsx

@@ -8,7 +8,7 @@ import { ActiveFilterBadge } from "./ActiveFilterBadge";
  * Shows the current filter label and provides a clear button.
  */
 const meta = {
-  title: "Data Display/ActiveFilterBadge",
+  title: "Core UI Primitives/Data Display/ActiveFilterBadge",
   component: ActiveFilterBadge,
   parameters: {
     layout: "padded",

src/components/ui/data-display/accordion.stories.tsx

@@ -16,7 +16,7 @@ import {
  * - Content text uses `text-muted-foreground` + `leading-relaxed` for better readability
  */
 const meta = {
-  title: "Data Display/Accordion",
+  title: "Core UI Primitives/Data Display/Accordion",
   component: Accordion,
   parameters: {
     layout: "centered",

src/components/ui/data-display/amount-summary-card.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from "@storybook/react";
 import { AmountSummaryCard } from "./amount-summary-card";
 
 const meta: Meta<typeof AmountSummaryCard> = {
-  title: "Data Display/AmountSummaryCard",
+  title: "Core UI Primitives/Data Display/AmountSummaryCard",
   component: AmountSummaryCard,
   tags: ["autodocs"],
   parameters: {

src/components/ui/data-display/avatar.stories.tsx

@@ -11,7 +11,7 @@ import { Avatar, AvatarImage, AvatarFallback, AvatarGroup } from "./avatar";
  * - Added `AvatarGroup` component with `ring-2 ring-background` gap and overflow `+N` badge
  */
 const meta = {
-  title: "Data Display/Avatar",
+  title: "Core UI Primitives/Data Display/Avatar",
   component: Avatar,
   parameters: {
     layout: "centered",

src/components/ui/data-display/badge.stories.tsx

@@ -7,7 +7,7 @@ import { Badge } from './badge';
  * Supports `default`, `secondary`, `destructive`, and `outline` variants.
  */
 const meta = {
-  title: 'Data Display/Badge',
+  title: 'Core UI Primitives/Data Display/Badge',
   component: Badge,
   parameters: {
     layout: 'centered',

src/components/ui/data-display/bilingual-tooltip.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from "@storybook/react";
 import { BilingualTooltip } from "./bilingual-tooltip";
 
 const meta: Meta<typeof BilingualTooltip> = {
-  title: "Data Display/BilingualTooltip",
+  title: "India Statutory & Regional/BilingualTooltip",
   component: BilingualTooltip,
   tags: ["autodocs"],
   parameters: {

src/components/ui/data-display/carousel.stories.tsx

@@ -20,7 +20,7 @@ import {
  * - `selectedIndex` and `scrollSnaps` now tracked from Embla API
  */
 const meta = {
-  title: "Data Display/Carousel",
+  title: "Core UI Primitives/Data Display/Carousel",
   component: Carousel,
   parameters: {
     layout: "centered",

src/components/ui/data-display/chart.stories.tsx

@@ -25,7 +25,7 @@ import {
  * - Added Area, Line, Pie chart variants
  */
 const meta = {
-  title: 'Data Display/Chart',
+  title: 'Core UI Primitives/Data Display/Chart',
   component: ChartContainer,
   parameters: {
     layout: 'padded',

src/components/ui/data-display/collapsible.stories.tsx

@@ -22,7 +22,7 @@ import { ChevronDown } from 'lucide-react';
  * - Bare `Collapsible` primitives remain unchanged for custom layouts
  */
 const meta = {
-  title: 'Data Display/Collapsible',
+  title: 'Core UI Primitives/Data Display/Collapsible',
   component: Collapsible,
   parameters: {
     layout: 'centered',

src/components/ui/data-display/data-table.stories.tsx

@@ -15,7 +15,7 @@ import { StatusBadge } from './status-badge';
  * - `aria-label` on Prev/Next + `aria-current="page"` on active page button
  */
 const meta = {
-  title: 'Data Display/DataTable',
+  title: 'Core UI Primitives/Data Display/DataTable',
   component: DataTable,
   parameters: {
     layout: 'padded',

src/components/ui/data-display/image-viewer.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from '@storybook/react';
 import { ImageViewer } from './image-viewer';
 
 const meta = {
-  title: 'Data Display/ImageViewer',
+  title: 'Core UI Primitives/Data Display/ImageViewer',
   component: ImageViewer,
   parameters: {
     layout: 'centered',

src/components/ui/data-display/info-list.stories.tsx

@@ -4,7 +4,7 @@ import { StatusBadge } from "./status-badge";
 import { Card, CardHeader, CardTitle, CardContent } from "../layout/card";
 
 const meta: Meta<typeof InfoList> = {
-  title: "Data Display/InfoList",
+  title: "Core UI Primitives/Data Display/InfoList",
   component: InfoList,
   tags: ["autodocs"],
   parameters: {

src/components/ui/data-display/kpi-card.stories.tsx

@@ -3,7 +3,7 @@ import { DollarSign, Users, ShoppingCart, Activity } from "lucide-react";
 import { KPICard } from "./kpi-card";
 
 const meta: Meta<typeof KPICard> = {
-  title: "Data Display/KPICard",
+  title: "Core UI Primitives/Data Display/KPICard",
   component: KPICard,
   tags: ["autodocs"],
   parameters: {

src/components/ui/data-display/line-items-card.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from "@storybook/react";
 import { LineItemsCard, type LineItem } from "./line-items-card";
 
 const meta: Meta<typeof LineItemsCard> = {
-  title: "Data Display/LineItemsCard",
+  title: "Core UI Primitives/Data Display/LineItemsCard",
   component: LineItemsCard,
   tags: ["autodocs"],
   parameters: {

src/components/ui/data-display/match-score-gauge.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from "@storybook/react";
 import { MatchScoreGauge } from "./match-score-gauge";
 
 const meta: Meta<typeof MatchScoreGauge> = {
-  title: "Data Display/MatchScoreGauge",
+  title: "Domain & Talent Lab/MatchScoreGauge",
   component: MatchScoreGauge,
   tags: ["autodocs"],
   parameters: {