@loykin/designkit 0.0.4 → 0.0.5

package/dist/index.d.cts

@@ -328,7 +328,22 @@ interface WorkbenchBodyTemplateProps {
     /** Mobile Sheet label for the right pane trigger */
     rightPaneLabel?: string;
 }
-declare function WorkbenchBodyTemplate({ theme, className, contentClassName, title, description, status, topBar, headerRight, actions, leftPane, mainPane, rightPane, bottomPane, children, resizable, leftPaneCollapsed, rightPaneCollapsed, bottomPaneCollapsed, leftPaneWidth, rightPaneWidth, bottomPaneHeight, minLeftPaneWidth, maxLeftPaneWidth, minRightPaneWidth, maxRightPaneWidth, minBottomPaneHeight, maxBottomPaneHeight, onResize, leftPaneClassName, mainPaneClassName, rightPaneClassName, bottomPaneClassName, leftPaneLabel, rightPaneLabel, }: WorkbenchBodyTemplateProps): React__default.JSX.Element;
+declare function WorkbenchBodyTemplateRoot({ theme, className, contentClassName, title, description, status, topBar, headerRight, actions, leftPane, mainPane, rightPane, bottomPane, children, resizable, leftPaneCollapsed, rightPaneCollapsed, bottomPaneCollapsed, leftPaneWidth, rightPaneWidth, bottomPaneHeight, minLeftPaneWidth, maxLeftPaneWidth, minRightPaneWidth, maxRightPaneWidth, minBottomPaneHeight, maxBottomPaneHeight, onResize, leftPaneClassName, mainPaneClassName, rightPaneClassName, bottomPaneClassName, leftPaneLabel, rightPaneLabel, }: WorkbenchBodyTemplateProps): React__default.JSX.Element;
+interface WorkbenchSectionProps {
+    title?: ReactNode;
+    description?: ReactNode;
+    actions?: ReactNode;
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * Groups related controls inside a `WorkbenchBodyTemplate` pane (typically
+ * `rightPane`), separating an options/inspector area into labeled sections.
+ */
+declare function WorkbenchSection({ title, description, actions, className, children }: WorkbenchSectionProps): React__default.JSX.Element;
+declare const WorkbenchBodyTemplate: typeof WorkbenchBodyTemplateRoot & {
+    Section: typeof WorkbenchSection;
+};
 
 /**
  * Defines one tab inside `DataBodyTemplate`.
@@ -585,29 +600,6 @@ interface ListDetailBodyTemplateProps {
 }
 declare function ListDetailBodyTemplate({ theme, className, topBar, list, detail, emptyDetail, listWidth, listClassName, detailClassName, onBack, backLabel, }: ListDetailBodyTemplateProps): React$1.JSX.Element;
 
-interface PanelTemplateProps {
-    title?: React__default.ReactNode;
-    eyebrow?: React__default.ReactNode;
-    status?: React__default.ReactNode;
-    actions?: React__default.ReactNode;
-    footer?: React__default.ReactNode;
-    children?: React__default.ReactNode;
-    className?: string;
-    bodyClassName?: string;
-}
-interface PanelTemplateSectionProps {
-    title?: React__default.ReactNode;
-    description?: React__default.ReactNode;
-    actions?: React__default.ReactNode;
-    className?: string;
-    children?: React__default.ReactNode;
-}
-declare function PanelTemplateSection({ title, description, actions, className, children, }: PanelTemplateSectionProps): React__default.JSX.Element;
-declare function PanelTemplateRoot({ title, eyebrow, status, actions, footer, children, className, bodyClassName, }: PanelTemplateProps): React__default.JSX.Element;
-declare const PanelTemplate: typeof PanelTemplateRoot & {
-    Section: typeof PanelTemplateSection;
-};
-
 type FormWizardVariant = 'card' | 'plain';
 interface FormWizardStep {
     key: string;
@@ -794,6 +786,141 @@ interface TemplateNavigationGroup {
     items: TemplateNavigationItem[];
 }
 
+interface PanelTemplateProps {
+    title?: React__default.ReactNode;
+    eyebrow?: React__default.ReactNode;
+    status?: React__default.ReactNode;
+    actions?: React__default.ReactNode;
+    footer?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    className?: string;
+    bodyClassName?: string;
+}
+interface PanelTemplateSectionProps {
+    title?: React__default.ReactNode;
+    description?: React__default.ReactNode;
+    actions?: React__default.ReactNode;
+    className?: string;
+    children?: React__default.ReactNode;
+}
+interface PanelTemplateRowProps {
+    label: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    className?: string;
+}
+declare function PanelTemplateSection({ title, description, actions, className, children, }: PanelTemplateSectionProps): React__default.JSX.Element;
+declare function PanelTemplateRow({ label, children, className }: PanelTemplateRowProps): React__default.JSX.Element;
+declare function PanelTemplateRoot({ title, eyebrow, status, actions, footer, children, className, bodyClassName, }: PanelTemplateProps): React__default.JSX.Element;
+declare const PanelTemplate: typeof PanelTemplateRoot & {
+    Section: typeof PanelTemplateSection;
+    Row: typeof PanelTemplateRow;
+};
+
+type InteractiveCardProps = React$1.ComponentProps<typeof Card>;
+/**
+ * A `Card` that is itself a click target inside a grid: fills its cell,
+ * lifts and shadows on hover. Reaches for this instead of re-deriving the
+ * same hover/elevation treatment per grid (blog cards, product cards, …).
+ */
+declare function InteractiveCard({ className, ...props }: InteractiveCardProps): React$1.JSX.Element;
+
+type ArticleTone = 'violet' | 'emerald' | 'amber' | 'rose' | 'sky' | 'slate';
+interface ArticleCoverProps {
+    /** Semantic accent — maps to a bundled gradient so domain data never stores Tailwind class strings. */
+    tone: ArticleTone;
+    className?: string;
+    children?: React$1.ReactNode;
+}
+/** Gradient cover block for an article thumbnail or hero. Size it via `className` (e.g. `h-32` or `h-56`). */
+declare function ArticleCover({ tone, className, children }: ArticleCoverProps): React$1.JSX.Element;
+interface ArticleBylineProps {
+    author: string;
+    initials: string;
+    /** Secondary line under the author name, e.g. read time. Omit to show just the name. */
+    meta?: React$1.ReactNode;
+    size?: 'sm' | 'default';
+    className?: string;
+}
+/** Author avatar + name (+ optional meta line), shared between article cards and the article page. */
+declare function ArticleByline({ author, initials, meta, size, className, }: ArticleBylineProps): React$1.JSX.Element;
+interface ArticleTocItem {
+    href: string;
+    label: React$1.ReactNode;
+    /** Visually emphasize this entry, e.g. the section currently in view. */
+    emphasis?: boolean;
+}
+interface ArticleTocProps {
+    title?: React$1.ReactNode;
+    items: ArticleTocItem[];
+    className?: string;
+}
+/** Table-of-contents list for an article's aside. */
+declare function ArticleToc({ title, items, className }: ArticleTocProps): React$1.JSX.Element;
+interface ArticleBodyProps {
+    className?: string;
+    children?: React$1.ReactNode;
+}
+/** Reading-width container with article body typography for prose content. */
+declare function ArticleBody({ className, children }: ArticleBodyProps): React$1.JSX.Element;
+interface ArticleBodySkeletonProps {
+    className?: string;
+}
+/** Loading placeholder matching `ArticleBody`'s reading width. */
+declare function ArticleBodySkeleton({ className }: ArticleBodySkeletonProps): React$1.JSX.Element;
+interface ArticleCardPreviewProps {
+    tone: ArticleTone;
+    category: React$1.ReactNode;
+    title: React$1.ReactNode;
+    excerpt: React$1.ReactNode;
+    author: string;
+    initials: string;
+    readTime: React$1.ReactNode;
+    /** Decorative content layered over the cover, e.g. an icon. */
+    coverContent?: React$1.ReactNode;
+    coverClassName?: string;
+    className?: string;
+}
+/**
+ * The clickable article-card shape used by every card grid of articles:
+ * cover, category, title, excerpt, byline, read time. Compose `coverContent`
+ * for per-listing decoration; everything else is the shared shell.
+ */
+declare function ArticleCardPreview({ tone, category, title, excerpt, author, initials, readTime, coverContent, coverClassName, className, }: ArticleCardPreviewProps): React$1.JSX.Element;
+
+interface FormFieldProps {
+    label: React$1.ReactNode;
+    htmlFor: string;
+    /** Validation failure for this field. Takes precedence over `helperText`. */
+    error?: React$1.ReactNode;
+    /** Non-error supporting text shown when there is no `error`. */
+    helperText?: React$1.ReactNode;
+    className?: string;
+    children: React$1.ReactNode;
+}
+/**
+ * The label + control + helper/error wrapper every stacked form field uses
+ * (see the form-workflow guide contract). Compose the control itself
+ * (`Input`, `Select`, …) as `children`; this owns only the surrounding shape.
+ */
+declare function FormField({ label, htmlFor, error, helperText, className, children }: FormFieldProps): React$1.JSX.Element;
+interface FormActionsProps {
+    /** Optional status or form-level message, left-aligned before the buttons. */
+    status?: React$1.ReactNode;
+    cancelLabel?: React$1.ReactNode;
+    onCancel?: () => void;
+    cancelDisabled?: boolean;
+    submitLabel: React$1.ReactNode;
+    submitDisabled?: boolean;
+    className?: string;
+}
+/**
+ * The bottom action row every stacked form ends with: an optional status
+ * message, then Cancel before the right-aligned primary submit action, per
+ * the form-workflow guide contract. Always renders the divider above the
+ * actions — do not add a second one around this component.
+ */
+declare function FormActions({ status, cancelLabel, onCancel, cancelDisabled, submitLabel, submitDisabled, className, }: FormActionsProps): React$1.JSX.Element;
+
 declare function useIsMobile(): boolean;
 
 type ShellId = 'sidebar' | 'header';
@@ -854,4 +981,4 @@ declare function cn(...inputs: ClassValue[]): string;
 
 declare const useThemeStore: zustand.UseBoundStore<zustand.StoreApi<ThemeState>>;
 
-export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BrowseBodyTemplate, type BrowseBodyTemplateProps, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ColorsBodyTemplate, type ColorsBodyTemplateProps, type CurrentTemplateId, DashboardBodyTemplate, type DashboardBodyTemplateProps, DashboardPanel, type DashboardPanelProps, type DataBodyBodyProps, type DataBodyFieldProps, type DataBodyGroupProps, type DataBodyResourceProps, type DataBodyRowProps, type DataBodySectionProps, type DataBodySummaryProps, type DataBodyTabProps, DataBodyTemplate, type DataBodyTemplateProps, DataPage, type DataPageActionsProps, type DataPageContentProps, type DataPageFooterProps, type DataPageGroupBodyProps, type DataPageGroupHeaderProps, type DataPageGroupProps, type DataPageGroupToolbarProps, type DataPageHeaderProps, type DataPageProps, type DataPageTabProps, type DataPageTabsProps, type DataPageTitleBlockProps, type DensityId, type DetailBodyHeaderProps, type DetailBodySectionProps, type DetailBodyTabProps, DetailBodyTemplate, type DetailBodyTemplateProps, type DetailBodyVariant, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateAction, type EmptyStateProps, FormWizardBodyTemplate, type FormWizardBodyTemplateProps, type FormWizardStep, type FormWizardVariant, type GlobalTheme, type GroupLayout, type GroupVariant, Input, Label, ListDetailBodyTemplate, type ListDetailBodyTemplateProps, type LoginBg, LoginBodyTemplate, type LoginBodyTemplateProps, type LoginCard, type LoginCardWidth, type LoginLayout, type LoginSide, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuPositioner, NavigationMenuTrigger, PageBreadcrumb, type PageBreadcrumbItem, PageTopBar, type PageTopBarProps, type PageTopBarVariant, PanelTemplate, type PanelTemplateProps, type PanelTemplateSectionProps, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, type ShellId, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type StyleInjectorOptions, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, type TemplateId, type TemplateNavigationGroup, type TemplateNavigationItem, type TemplateOverride, type ThemeState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TypographyBodyTemplate, type TypographyBodyTemplateProps, WorkbenchBodyTemplate, type WorkbenchBodyTemplateProps, type WorkbenchResizeState, badgeVariants, buildTemplateTheme, buildTopBar, buttonVariants, cn, navigationMenuTriggerStyle, tabsListVariants, useIsMobile, useSidebar, useSidebarOptional, useStyleInjector, useThemeStore };
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, ArticleBody, type ArticleBodyProps, ArticleBodySkeleton, type ArticleBodySkeletonProps, ArticleByline, type ArticleBylineProps, ArticleCardPreview, type ArticleCardPreviewProps, ArticleCover, type ArticleCoverProps, ArticleToc, type ArticleTocItem, type ArticleTocProps, type ArticleTone, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BrowseBodyTemplate, type BrowseBodyTemplateProps, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ColorsBodyTemplate, type ColorsBodyTemplateProps, type CurrentTemplateId, DashboardBodyTemplate, type DashboardBodyTemplateProps, DashboardPanel, type DashboardPanelProps, type DataBodyBodyProps, type DataBodyFieldProps, type DataBodyGroupProps, type DataBodyResourceProps, type DataBodyRowProps, type DataBodySectionProps, type DataBodySummaryProps, type DataBodyTabProps, DataBodyTemplate, type DataBodyTemplateProps, DataPage, type DataPageActionsProps, type DataPageContentProps, type DataPageFooterProps, type DataPageGroupBodyProps, type DataPageGroupHeaderProps, type DataPageGroupProps, type DataPageGroupToolbarProps, type DataPageHeaderProps, type DataPageProps, type DataPageTabProps, type DataPageTabsProps, type DataPageTitleBlockProps, type DensityId, type DetailBodyHeaderProps, type DetailBodySectionProps, type DetailBodyTabProps, DetailBodyTemplate, type DetailBodyTemplateProps, type DetailBodyVariant, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateAction, type EmptyStateProps, FormActions, type FormActionsProps, FormField, type FormFieldProps, FormWizardBodyTemplate, type FormWizardBodyTemplateProps, type FormWizardStep, type FormWizardVariant, type GlobalTheme, type GroupLayout, type GroupVariant, Input, InteractiveCard, type InteractiveCardProps, Label, ListDetailBodyTemplate, type ListDetailBodyTemplateProps, type LoginBg, LoginBodyTemplate, type LoginBodyTemplateProps, type LoginCard, type LoginCardWidth, type LoginLayout, type LoginSide, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuPositioner, NavigationMenuTrigger, PageBreadcrumb, type PageBreadcrumbItem, PageTopBar, type PageTopBarProps, type PageTopBarVariant, PanelTemplate, type PanelTemplateProps, type PanelTemplateRowProps, type PanelTemplateSectionProps, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, type ShellId, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type StyleInjectorOptions, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, type TemplateId, type TemplateNavigationGroup, type TemplateNavigationItem, type TemplateOverride, type ThemeState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TypographyBodyTemplate, type TypographyBodyTemplateProps, WorkbenchBodyTemplate, type WorkbenchBodyTemplateProps, type WorkbenchResizeState, type WorkbenchSectionProps, badgeVariants, buildTemplateTheme, buildTopBar, buttonVariants, cn, navigationMenuTriggerStyle, tabsListVariants, useIsMobile, useSidebar, useSidebarOptional, useStyleInjector, useThemeStore };

package/dist/index.d.ts

@@ -328,7 +328,22 @@ interface WorkbenchBodyTemplateProps {
     /** Mobile Sheet label for the right pane trigger */
     rightPaneLabel?: string;
 }
-declare function WorkbenchBodyTemplate({ theme, className, contentClassName, title, description, status, topBar, headerRight, actions, leftPane, mainPane, rightPane, bottomPane, children, resizable, leftPaneCollapsed, rightPaneCollapsed, bottomPaneCollapsed, leftPaneWidth, rightPaneWidth, bottomPaneHeight, minLeftPaneWidth, maxLeftPaneWidth, minRightPaneWidth, maxRightPaneWidth, minBottomPaneHeight, maxBottomPaneHeight, onResize, leftPaneClassName, mainPaneClassName, rightPaneClassName, bottomPaneClassName, leftPaneLabel, rightPaneLabel, }: WorkbenchBodyTemplateProps): React__default.JSX.Element;
+declare function WorkbenchBodyTemplateRoot({ theme, className, contentClassName, title, description, status, topBar, headerRight, actions, leftPane, mainPane, rightPane, bottomPane, children, resizable, leftPaneCollapsed, rightPaneCollapsed, bottomPaneCollapsed, leftPaneWidth, rightPaneWidth, bottomPaneHeight, minLeftPaneWidth, maxLeftPaneWidth, minRightPaneWidth, maxRightPaneWidth, minBottomPaneHeight, maxBottomPaneHeight, onResize, leftPaneClassName, mainPaneClassName, rightPaneClassName, bottomPaneClassName, leftPaneLabel, rightPaneLabel, }: WorkbenchBodyTemplateProps): React__default.JSX.Element;
+interface WorkbenchSectionProps {
+    title?: ReactNode;
+    description?: ReactNode;
+    actions?: ReactNode;
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * Groups related controls inside a `WorkbenchBodyTemplate` pane (typically
+ * `rightPane`), separating an options/inspector area into labeled sections.
+ */
+declare function WorkbenchSection({ title, description, actions, className, children }: WorkbenchSectionProps): React__default.JSX.Element;
+declare const WorkbenchBodyTemplate: typeof WorkbenchBodyTemplateRoot & {
+    Section: typeof WorkbenchSection;
+};
 
 /**
  * Defines one tab inside `DataBodyTemplate`.
@@ -585,29 +600,6 @@ interface ListDetailBodyTemplateProps {
 }
 declare function ListDetailBodyTemplate({ theme, className, topBar, list, detail, emptyDetail, listWidth, listClassName, detailClassName, onBack, backLabel, }: ListDetailBodyTemplateProps): React$1.JSX.Element;
 
-interface PanelTemplateProps {
-    title?: React__default.ReactNode;
-    eyebrow?: React__default.ReactNode;
-    status?: React__default.ReactNode;
-    actions?: React__default.ReactNode;
-    footer?: React__default.ReactNode;
-    children?: React__default.ReactNode;
-    className?: string;
-    bodyClassName?: string;
-}
-interface PanelTemplateSectionProps {
-    title?: React__default.ReactNode;
-    description?: React__default.ReactNode;
-    actions?: React__default.ReactNode;
-    className?: string;
-    children?: React__default.ReactNode;
-}
-declare function PanelTemplateSection({ title, description, actions, className, children, }: PanelTemplateSectionProps): React__default.JSX.Element;
-declare function PanelTemplateRoot({ title, eyebrow, status, actions, footer, children, className, bodyClassName, }: PanelTemplateProps): React__default.JSX.Element;
-declare const PanelTemplate: typeof PanelTemplateRoot & {
-    Section: typeof PanelTemplateSection;
-};
-
 type FormWizardVariant = 'card' | 'plain';
 interface FormWizardStep {
     key: string;
@@ -794,6 +786,141 @@ interface TemplateNavigationGroup {
     items: TemplateNavigationItem[];
 }
 
+interface PanelTemplateProps {
+    title?: React__default.ReactNode;
+    eyebrow?: React__default.ReactNode;
+    status?: React__default.ReactNode;
+    actions?: React__default.ReactNode;
+    footer?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    className?: string;
+    bodyClassName?: string;
+}
+interface PanelTemplateSectionProps {
+    title?: React__default.ReactNode;
+    description?: React__default.ReactNode;
+    actions?: React__default.ReactNode;
+    className?: string;
+    children?: React__default.ReactNode;
+}
+interface PanelTemplateRowProps {
+    label: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    className?: string;
+}
+declare function PanelTemplateSection({ title, description, actions, className, children, }: PanelTemplateSectionProps): React__default.JSX.Element;
+declare function PanelTemplateRow({ label, children, className }: PanelTemplateRowProps): React__default.JSX.Element;
+declare function PanelTemplateRoot({ title, eyebrow, status, actions, footer, children, className, bodyClassName, }: PanelTemplateProps): React__default.JSX.Element;
+declare const PanelTemplate: typeof PanelTemplateRoot & {
+    Section: typeof PanelTemplateSection;
+    Row: typeof PanelTemplateRow;
+};
+
+type InteractiveCardProps = React$1.ComponentProps<typeof Card>;
+/**
+ * A `Card` that is itself a click target inside a grid: fills its cell,
+ * lifts and shadows on hover. Reaches for this instead of re-deriving the
+ * same hover/elevation treatment per grid (blog cards, product cards, …).
+ */
+declare function InteractiveCard({ className, ...props }: InteractiveCardProps): React$1.JSX.Element;
+
+type ArticleTone = 'violet' | 'emerald' | 'amber' | 'rose' | 'sky' | 'slate';
+interface ArticleCoverProps {
+    /** Semantic accent — maps to a bundled gradient so domain data never stores Tailwind class strings. */
+    tone: ArticleTone;
+    className?: string;
+    children?: React$1.ReactNode;
+}
+/** Gradient cover block for an article thumbnail or hero. Size it via `className` (e.g. `h-32` or `h-56`). */
+declare function ArticleCover({ tone, className, children }: ArticleCoverProps): React$1.JSX.Element;
+interface ArticleBylineProps {
+    author: string;
+    initials: string;
+    /** Secondary line under the author name, e.g. read time. Omit to show just the name. */
+    meta?: React$1.ReactNode;
+    size?: 'sm' | 'default';
+    className?: string;
+}
+/** Author avatar + name (+ optional meta line), shared between article cards and the article page. */
+declare function ArticleByline({ author, initials, meta, size, className, }: ArticleBylineProps): React$1.JSX.Element;
+interface ArticleTocItem {
+    href: string;
+    label: React$1.ReactNode;
+    /** Visually emphasize this entry, e.g. the section currently in view. */
+    emphasis?: boolean;
+}
+interface ArticleTocProps {
+    title?: React$1.ReactNode;
+    items: ArticleTocItem[];
+    className?: string;
+}
+/** Table-of-contents list for an article's aside. */
+declare function ArticleToc({ title, items, className }: ArticleTocProps): React$1.JSX.Element;
+interface ArticleBodyProps {
+    className?: string;
+    children?: React$1.ReactNode;
+}
+/** Reading-width container with article body typography for prose content. */
+declare function ArticleBody({ className, children }: ArticleBodyProps): React$1.JSX.Element;
+interface ArticleBodySkeletonProps {
+    className?: string;
+}
+/** Loading placeholder matching `ArticleBody`'s reading width. */
+declare function ArticleBodySkeleton({ className }: ArticleBodySkeletonProps): React$1.JSX.Element;
+interface ArticleCardPreviewProps {
+    tone: ArticleTone;
+    category: React$1.ReactNode;
+    title: React$1.ReactNode;
+    excerpt: React$1.ReactNode;
+    author: string;
+    initials: string;
+    readTime: React$1.ReactNode;
+    /** Decorative content layered over the cover, e.g. an icon. */
+    coverContent?: React$1.ReactNode;
+    coverClassName?: string;
+    className?: string;
+}
+/**
+ * The clickable article-card shape used by every card grid of articles:
+ * cover, category, title, excerpt, byline, read time. Compose `coverContent`
+ * for per-listing decoration; everything else is the shared shell.
+ */
+declare function ArticleCardPreview({ tone, category, title, excerpt, author, initials, readTime, coverContent, coverClassName, className, }: ArticleCardPreviewProps): React$1.JSX.Element;
+
+interface FormFieldProps {
+    label: React$1.ReactNode;
+    htmlFor: string;
+    /** Validation failure for this field. Takes precedence over `helperText`. */
+    error?: React$1.ReactNode;
+    /** Non-error supporting text shown when there is no `error`. */
+    helperText?: React$1.ReactNode;
+    className?: string;
+    children: React$1.ReactNode;
+}
+/**
+ * The label + control + helper/error wrapper every stacked form field uses
+ * (see the form-workflow guide contract). Compose the control itself
+ * (`Input`, `Select`, …) as `children`; this owns only the surrounding shape.
+ */
+declare function FormField({ label, htmlFor, error, helperText, className, children }: FormFieldProps): React$1.JSX.Element;
+interface FormActionsProps {
+    /** Optional status or form-level message, left-aligned before the buttons. */
+    status?: React$1.ReactNode;
+    cancelLabel?: React$1.ReactNode;
+    onCancel?: () => void;
+    cancelDisabled?: boolean;
+    submitLabel: React$1.ReactNode;
+    submitDisabled?: boolean;
+    className?: string;
+}
+/**
+ * The bottom action row every stacked form ends with: an optional status
+ * message, then Cancel before the right-aligned primary submit action, per
+ * the form-workflow guide contract. Always renders the divider above the
+ * actions — do not add a second one around this component.
+ */
+declare function FormActions({ status, cancelLabel, onCancel, cancelDisabled, submitLabel, submitDisabled, className, }: FormActionsProps): React$1.JSX.Element;
+
 declare function useIsMobile(): boolean;
 
 type ShellId = 'sidebar' | 'header';
@@ -854,4 +981,4 @@ declare function cn(...inputs: ClassValue[]): string;
 
 declare const useThemeStore: zustand.UseBoundStore<zustand.StoreApi<ThemeState>>;
 
-export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BrowseBodyTemplate, type BrowseBodyTemplateProps, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ColorsBodyTemplate, type ColorsBodyTemplateProps, type CurrentTemplateId, DashboardBodyTemplate, type DashboardBodyTemplateProps, DashboardPanel, type DashboardPanelProps, type DataBodyBodyProps, type DataBodyFieldProps, type DataBodyGroupProps, type DataBodyResourceProps, type DataBodyRowProps, type DataBodySectionProps, type DataBodySummaryProps, type DataBodyTabProps, DataBodyTemplate, type DataBodyTemplateProps, DataPage, type DataPageActionsProps, type DataPageContentProps, type DataPageFooterProps, type DataPageGroupBodyProps, type DataPageGroupHeaderProps, type DataPageGroupProps, type DataPageGroupToolbarProps, type DataPageHeaderProps, type DataPageProps, type DataPageTabProps, type DataPageTabsProps, type DataPageTitleBlockProps, type DensityId, type DetailBodyHeaderProps, type DetailBodySectionProps, type DetailBodyTabProps, DetailBodyTemplate, type DetailBodyTemplateProps, type DetailBodyVariant, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateAction, type EmptyStateProps, FormWizardBodyTemplate, type FormWizardBodyTemplateProps, type FormWizardStep, type FormWizardVariant, type GlobalTheme, type GroupLayout, type GroupVariant, Input, Label, ListDetailBodyTemplate, type ListDetailBodyTemplateProps, type LoginBg, LoginBodyTemplate, type LoginBodyTemplateProps, type LoginCard, type LoginCardWidth, type LoginLayout, type LoginSide, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuPositioner, NavigationMenuTrigger, PageBreadcrumb, type PageBreadcrumbItem, PageTopBar, type PageTopBarProps, type PageTopBarVariant, PanelTemplate, type PanelTemplateProps, type PanelTemplateSectionProps, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, type ShellId, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type StyleInjectorOptions, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, type TemplateId, type TemplateNavigationGroup, type TemplateNavigationItem, type TemplateOverride, type ThemeState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TypographyBodyTemplate, type TypographyBodyTemplateProps, WorkbenchBodyTemplate, type WorkbenchBodyTemplateProps, type WorkbenchResizeState, badgeVariants, buildTemplateTheme, buildTopBar, buttonVariants, cn, navigationMenuTriggerStyle, tabsListVariants, useIsMobile, useSidebar, useSidebarOptional, useStyleInjector, useThemeStore };
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, ArticleBody, type ArticleBodyProps, ArticleBodySkeleton, type ArticleBodySkeletonProps, ArticleByline, type ArticleBylineProps, ArticleCardPreview, type ArticleCardPreviewProps, ArticleCover, type ArticleCoverProps, ArticleToc, type ArticleTocItem, type ArticleTocProps, type ArticleTone, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BrowseBodyTemplate, type BrowseBodyTemplateProps, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ColorsBodyTemplate, type ColorsBodyTemplateProps, type CurrentTemplateId, DashboardBodyTemplate, type DashboardBodyTemplateProps, DashboardPanel, type DashboardPanelProps, type DataBodyBodyProps, type DataBodyFieldProps, type DataBodyGroupProps, type DataBodyResourceProps, type DataBodyRowProps, type DataBodySectionProps, type DataBodySummaryProps, type DataBodyTabProps, DataBodyTemplate, type DataBodyTemplateProps, DataPage, type DataPageActionsProps, type DataPageContentProps, type DataPageFooterProps, type DataPageGroupBodyProps, type DataPageGroupHeaderProps, type DataPageGroupProps, type DataPageGroupToolbarProps, type DataPageHeaderProps, type DataPageProps, type DataPageTabProps, type DataPageTabsProps, type DataPageTitleBlockProps, type DensityId, type DetailBodyHeaderProps, type DetailBodySectionProps, type DetailBodyTabProps, DetailBodyTemplate, type DetailBodyTemplateProps, type DetailBodyVariant, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateAction, type EmptyStateProps, FormActions, type FormActionsProps, FormField, type FormFieldProps, FormWizardBodyTemplate, type FormWizardBodyTemplateProps, type FormWizardStep, type FormWizardVariant, type GlobalTheme, type GroupLayout, type GroupVariant, Input, InteractiveCard, type InteractiveCardProps, Label, ListDetailBodyTemplate, type ListDetailBodyTemplateProps, type LoginBg, LoginBodyTemplate, type LoginBodyTemplateProps, type LoginCard, type LoginCardWidth, type LoginLayout, type LoginSide, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuPositioner, NavigationMenuTrigger, PageBreadcrumb, type PageBreadcrumbItem, PageTopBar, type PageTopBarProps, type PageTopBarVariant, PanelTemplate, type PanelTemplateProps, type PanelTemplateRowProps, type PanelTemplateSectionProps, Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, type ShellId, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, type StyleInjectorOptions, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, type TemplateId, type TemplateNavigationGroup, type TemplateNavigationItem, type TemplateOverride, type ThemeState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TypographyBodyTemplate, type TypographyBodyTemplateProps, WorkbenchBodyTemplate, type WorkbenchBodyTemplateProps, type WorkbenchResizeState, type WorkbenchSectionProps, badgeVariants, buildTemplateTheme, buildTopBar, buttonVariants, cn, navigationMenuTriggerStyle, tabsListVariants, useIsMobile, useSidebar, useSidebarOptional, useStyleInjector, useThemeStore };