@nebutra/ui 0.2.1 → 0.2.3

package/dist/patterns/index.d.ts

@@ -1,7 +1,25 @@
-import * as React from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { HTMLAttributes, ReactNode, ComponentType } from 'react';
 import { Icon } from '@nebutra/icons';
 
+interface ArtifactShiftCardProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+    contentClassName?: string;
+}
+interface ArtifactShiftCardPreviewProps extends HTMLAttributes<HTMLElement> {
+    filename: string;
+    language: string;
+    code: string;
+    label: string;
+    maxLines?: number;
+    signals?: readonly string[];
+}
+type ArtifactShiftCardFooterProps = HTMLAttributes<HTMLElement>;
+declare function ArtifactShiftCard({ className, contentClassName, children, ...props }: ArtifactShiftCardProps): react_jsx_runtime.JSX.Element;
+declare function ArtifactShiftCardPreview({ filename, language, code, label, maxLines, signals, className, ...props }: ArtifactShiftCardPreviewProps): react_jsx_runtime.JSX.Element;
+declare function ArtifactShiftCardFooter({ className, ...props }: ArtifactShiftCardFooterProps): react_jsx_runtime.JSX.Element;
+
 type CardVariant = "default" | "elevated" | "bordered" | "ghost" | "gradient";
 type CardPadding = "none" | "sm" | "md" | "lg";
 interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
@@ -48,6 +66,40 @@ interface CommandBoxProps extends React.HTMLAttributes<HTMLDivElement> {
 }
 declare const CommandBox: React.ForwardRefExoticComponent<CommandBoxProps & React.RefAttributes<HTMLDivElement>>;
 
+type DashboardMetricTone = "neutral" | "blue" | "green" | "amber";
+interface DashboardCommandSurfaceProps {
+    status?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    actions?: ReactNode;
+    children?: ReactNode;
+    className?: string;
+}
+declare function DashboardCommandSurface({ status, title, description, actions, children, className, }: DashboardCommandSurfaceProps): react_jsx_runtime.JSX.Element;
+interface DashboardPanelProps {
+    title: ReactNode;
+    description?: ReactNode;
+    meta?: ReactNode;
+    action?: ReactNode;
+    children: ReactNode;
+    className?: string;
+    headerClassName?: string;
+}
+declare function DashboardPanel({ title, description, meta, action, children, className, headerClassName, }: DashboardPanelProps): react_jsx_runtime.JSX.Element;
+interface DashboardMetricTileProps {
+    label: ReactNode;
+    value: ReactNode;
+    detail?: ReactNode;
+    source?: ReactNode;
+    icon?: ComponentType<{
+        className?: string;
+        "aria-hidden"?: boolean;
+    }>;
+    tone?: DashboardMetricTone;
+    className?: string;
+}
+declare function DashboardMetricTile({ label, value, detail, source, icon: Icon, tone, className, }: DashboardMetricTileProps): react_jsx_runtime.JSX.Element;
+
 type GalleryCardIconTone = "neutral" | "blue" | "cyan" | "purple" | "amber" | "green" | "pink";
 type GalleryCardBadgeTone = "beta" | "new" | "owner" | "featured" | "coming-soon";
 interface GalleryCardMetadata {
@@ -101,6 +153,58 @@ declare namespace GalleryCard {
     var displayName: string;
 }
 
+type IconComponent = ComponentType<{
+    className?: string;
+    "aria-hidden"?: boolean;
+}>;
+type IconInput = IconComponent | ReactNode;
+interface KineticFeatureCardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    icon?: IconInput;
+    eyebrow?: ReactNode;
+    title: ReactNode;
+    description: ReactNode;
+    children?: ReactNode;
+}
+interface KineticCodePreviewProps extends HTMLAttributes<HTMLDivElement> {
+    filename?: string;
+    language?: string;
+    lines: readonly string[];
+}
+interface KineticConsoleFrameProps extends HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    status?: ReactNode;
+    children: ReactNode;
+}
+type KineticStepRailProps = HTMLAttributes<HTMLDivElement>;
+interface KineticMorphSurfaceProps extends HTMLAttributes<HTMLDivElement> {
+    activeKey?: string | number;
+    children: ReactNode;
+}
+interface KineticSignalMarqueeProps extends HTMLAttributes<HTMLDivElement> {
+    eyebrow?: ReactNode;
+    children: ReactNode;
+}
+interface KineticCommandBoxProps extends HTMLAttributes<HTMLDivElement> {
+    command: string;
+    copyLabel: string;
+    copiedLabel: string;
+}
+interface KineticStepProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    icon?: IconComponent;
+    index: number;
+    title: ReactNode;
+    description: ReactNode;
+    phaseLabel?: string;
+}
+declare function KineticFeatureCard({ icon, eyebrow, title, description, children, className, ...props }: KineticFeatureCardProps): react_jsx_runtime.JSX.Element;
+declare function KineticCodePreview({ filename, language, lines, className, ...props }: KineticCodePreviewProps): react_jsx_runtime.JSX.Element;
+declare function KineticConsoleFrame({ title, status, children, className, ...props }: KineticConsoleFrameProps): react_jsx_runtime.JSX.Element;
+declare function KineticMorphSurface({ activeKey, className, children, ...props }: KineticMorphSurfaceProps): react_jsx_runtime.JSX.Element;
+declare function KineticSignalMarquee({ eyebrow, className, children, ...props }: KineticSignalMarqueeProps): react_jsx_runtime.JSX.Element;
+declare function KineticCommandBox({ command, copyLabel, copiedLabel, className, ...props }: KineticCommandBoxProps): react_jsx_runtime.JSX.Element;
+declare function KineticStepRail({ className, children, ...props }: KineticStepRailProps): react_jsx_runtime.JSX.Element;
+declare function KineticStep({ icon: Icon, index, title, description, phaseLabel, className, ...props }: KineticStepProps): react_jsx_runtime.JSX.Element;
+
 interface MarkdownEditorProps {
     value: string;
     onChange: (next: string) => void;
@@ -224,20 +328,42 @@ interface SidebarNavItem {
     /** Nested children — 1 level deep max */
     children?: SidebarNavItem[];
     disabled?: boolean;
+    /** Controlled expansion for parent items (with children). When provided
+     * together with onExpandedChange, the inner Collapsible runs as a
+     * controlled component. Falls back to uncontrolled otherwise. */
+    expanded?: boolean;
+    onExpandedChange?: (next: boolean) => void;
+}
+/** A single icon-button action rendered inline-right of the section label,
+ * revealed only on section hover/focus-within. Max 3 per section. */
+interface SidebarNavSectionAction {
+    id: string;
+    icon: SidebarNavIcon;
+    /** Accessible name (also used as title attribute). */
+    label: string;
+    /** Click handler — required unless `render` is provided. */
+    onClick?: () => void;
+    /** Optional wrapper to replace the default `<button>` rendering. Receives
+     * the default icon-button element so consumers can compose, e.g., a
+     * DropdownMenu trigger around it. When provided, `onClick` is ignored. */
+    render?: (defaultButton: React.ReactElement) => React.ReactNode;
 }
 interface SidebarNavSection {
     id: string;
     /** Group label, e.g. "MiniMax 实验室". Hidden when collapsed. */
     label?: string;
     items: SidebarNavItem[];
+    /** Hover/focus-revealed actions next to the section label. Skipped in
+     * collapsed mode and when empty. Limit to ≤ 3 to keep visual rhythm. */
+    actions?: SidebarNavSectionAction[];
 }
 interface SidebarNavRenderLinkProps {
     href: string;
     children: React.ReactNode;
-    className?: string;
+    className?: string | undefined;
     "aria-current"?: "page" | undefined;
-    "aria-label"?: string;
-    onClick?: () => void;
+    "aria-label"?: string | undefined;
+    onClick?: (() => void) | undefined;
 }
 interface SidebarNavProps {
     sections: SidebarNavSection[];
@@ -360,4 +486,4 @@ interface WorkspaceSwitcherProps {
 }
 declare function WorkspaceSwitcher({ workspaces, activeWorkspaceId, onSwitch, variant, footerSlot, headerSlot, className, showRoleBadge, disabled, }: WorkspaceSwitcherProps): React.ReactElement;
 
-export { type AnswerType, type Author, Card, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardIcon, type CardIconProps, type CardProps, CardRoot, CardTitle, type CardTitleProps, CommandBox, type CommandBoxProps, GalleryCard, type GalleryCardAction, type GalleryCardBadge, type GalleryCardBadgeTone, type GalleryCardIconTone, type GalleryCardMetadata, type GalleryCardProps, type GalleryCardRenderLinkProps, MarkdownEditor, type MarkdownEditorProps, MarkdownRenderer, type MarkdownRendererProps, QAPage, type QAPageProps, type QuestionType, SidebarNav, type SidebarNavBadge, type SidebarNavBadgeTone, type SidebarNavIcon, type SidebarNavItem, type SidebarNavProps, type SidebarNavRenderLinkProps, type SidebarNavSection, Terminal, TerminalBody, type TerminalBodyProps, TerminalHeader, type TerminalHeaderProps, TerminalLine, type TerminalLineProps, type TerminalProps, TerminalRoot, UserInfo, type UserInfoProps, UserMenu, type UserMenuGroup, type UserMenuItem, type UserMenuProps, type UserMenuUser, VoteButtons, type VoteButtonsProps, type VoteType, type Workspace, type WorkspaceRole, WorkspaceSwitcher, type WorkspaceSwitcherProps };
+export { type AnswerType, ArtifactShiftCard, ArtifactShiftCardFooter, type ArtifactShiftCardFooterProps, ArtifactShiftCardPreview, type ArtifactShiftCardPreviewProps, type ArtifactShiftCardProps, type Author, Card, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardIcon, type CardIconProps, type CardProps, CardRoot, CardTitle, type CardTitleProps, CommandBox, type CommandBoxProps, DashboardCommandSurface, type DashboardCommandSurfaceProps, DashboardMetricTile, type DashboardMetricTileProps, DashboardPanel, type DashboardPanelProps, GalleryCard, type GalleryCardAction, type GalleryCardBadge, type GalleryCardBadgeTone, type GalleryCardIconTone, type GalleryCardMetadata, type GalleryCardProps, type GalleryCardRenderLinkProps, KineticCodePreview, type KineticCodePreviewProps, KineticCommandBox, type KineticCommandBoxProps, KineticConsoleFrame, type KineticConsoleFrameProps, KineticFeatureCard, type KineticFeatureCardProps, KineticMorphSurface, type KineticMorphSurfaceProps, KineticSignalMarquee, type KineticSignalMarqueeProps, KineticStep, type KineticStepProps, KineticStepRail, type KineticStepRailProps, MarkdownEditor, type MarkdownEditorProps, MarkdownRenderer, type MarkdownRendererProps, QAPage, type QAPageProps, type QuestionType, SidebarNav, type SidebarNavBadge, type SidebarNavBadgeTone, type SidebarNavIcon, type SidebarNavItem, type SidebarNavProps, type SidebarNavRenderLinkProps, type SidebarNavSection, type SidebarNavSectionAction, Terminal, TerminalBody, type TerminalBodyProps, TerminalHeader, type TerminalHeaderProps, TerminalLine, type TerminalLineProps, type TerminalProps, TerminalRoot, UserInfo, type UserInfoProps, UserMenu, type UserMenuGroup, type UserMenuItem, type UserMenuProps, type UserMenuUser, VoteButtons, type VoteButtonsProps, type VoteType, type Workspace, type WorkspaceRole, WorkspaceSwitcher, type WorkspaceSwitcherProps };