@voltro/ui-shadcn 0.66.1 → 0.68.0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import { ButtonHTMLAttributes } from 'react';
 import { ClassProp } from 'class-variance-authority/types';
 import { ClassValue } from 'clsx';
+import { ComponentProps } from 'react';
 import { ComponentPropsWithoutRef } from 'react';
+import { ComponentPropsWithRef } from 'react';
 import { ComponentType } from 'react';
 import { CSSProperties } from 'react';
-import { DialogHTMLAttributes } from 'react';
 import { FC } from 'react';
 import { FormHTMLAttributes } from 'react';
 import { ForwardRefExoticComponent } from 'react';
@@ -40,10 +41,12 @@ declare interface AnimatedNumberProps {
  *  is immediate (the pre-paint `themeBootScript` handles the first load). */
 export declare const applyTheme: (theme: ThemePreference) => void;
 
-export declare const AppShell: ({ brand, nav, right, children, className, LinkComponent, }: AppShellProps) => ReactNode;
+export declare const AppShell: ({ brand, header, nav, right, children, className, LinkComponent, }: AppShellProps) => ReactNode;
 
 declare interface AppShellProps {
     readonly brand: ReactNode;
+    /** Custom top navigation using the app's own shared header composition. */
+    readonly header?: ReactNode;
     readonly nav?: ReadonlyArray<NavLink>;
     readonly right?: ReactNode;
     readonly children: ReactNode;
@@ -189,7 +192,7 @@ declare interface CodeComparePanelProps {
     readonly code?: string;
     /** Shiki language. Triggers syntax highlighting on `code`. */
     readonly lang?: ShikiLang;
-    /** Visual treatment — `'muted'` is dimmed (the "before"),
+    /** Visual treatment — `'muted'` uses a neutral border (the "before"),
      *  `'highlight'` keeps the full styling + adds a primary border. */
     readonly tone?: 'muted' | 'highlight';
     /** The corner tag. Pass a translated string on a localised page. */
@@ -238,7 +241,7 @@ export declare const DatabaseIcon: (p: DocIconProps) => ReactNode;
  *  writes `document.cookie` in the browser, returns the header string. */
 export declare const deleteCookie: (name: string, path?: string) => string;
 
-export declare const Dialog: ({ className, children, ...props }: DialogHTMLAttributes<HTMLDialogElement>) => ReactNode;
+export declare const Dialog: ({ className, children, ...props }: ComponentPropsWithRef<"dialog">) => ReactNode;
 
 export declare const DialogDescription: ({ className, ...props }: HTMLAttributes<HTMLParagraphElement>) => ReactNode;
 
@@ -317,7 +320,7 @@ declare interface DocShellProps {
     readonly LinkComponent?: ComponentType<ShellLinkProps>;
 }
 
-export declare const DocsLayout: ({ brand, nav, children, currentPath, topNav, topRight, search, page, LinkComponent, className, labels, footer, sidebarHeader, }: DocsLayoutProps) => ReactNode;
+export declare const DocsLayout: ({ brand, nav, children, currentPath, topNav, topRight, search, page, LinkComponent, className, labels, footer, sidebarHeader, header, intro, sidebar, }: DocsLayoutProps) => ReactNode;
 
 /** User-facing strings for the layout's own chrome. Defaults are English
  *  so the layout works unconfigured; pass catalog values to localize. */
@@ -350,6 +353,14 @@ declare interface DocsLayoutProps {
     readonly brand: ReactNode;
     readonly nav: ReadonlyArray<DocsNavGroup>;
     readonly children: ReactNode;
+    /** Compose the top bar while retaining the layout's mobile navigation control. */
+    readonly header?: (controls: {
+        readonly menuButton: ReactNode;
+    }) => ReactNode;
+    /** Full-width introduction above the reading columns. */
+    readonly intro?: ReactNode;
+    /** Show the desktop section rail. Mobile navigation remains available. */
+    readonly sidebar?: boolean;
     /** Current pathname — used to highlight the active nav entry +
      *  decide which group opens by default. */
     readonly currentPath?: string;
@@ -712,7 +723,7 @@ export declare interface PreferenceCookies {
     readonly locale?: string;
 }
 
-export declare const ProfileMenu: ({ identity, links, languages, currentLanguage, onLanguageChange, logoutUrl, onLogout, signInUrl, labels, }: ProfileMenuProps) => ReactNode;
+export declare const ProfileMenu: ({ identity, links, languages, currentLanguage, onLanguageChange, logoutUrl, onLogout, signInUrl, labels, trigger, }: ProfileMenuProps) => ReactNode;
 
 export declare interface ProfileMenuLabels {
     /** Section label for the theme switch. Default `'Theme'`. */
@@ -747,6 +758,8 @@ export declare interface ProfileMenuLink {
 }
 
 export declare interface ProfileMenuProps {
+    /** Custom accessible trigger; Radix supplies menu state and focus handling. */
+    readonly trigger?: ReactNode;
     readonly identity?: {
         readonly name: string;
         readonly sublabel?: string;
@@ -912,6 +925,61 @@ export declare const SHIKI_LANGS: readonly ["text", "ts", "tsx", "typescript", "
 
 export declare type ShikiLang = typeof SHIKI_LANGS[number];
 
+/** Decorative Voltro contour field. Import `@voltro/ui-shadcn/signal.css`.
+ * Static at SSR, with reduced-motion and visibility-aware animation on hydration. */
+export declare function SignalField({ animated, paused, className }: SignalFieldProps): ReactNode;
+
+export declare interface SignalFieldProps {
+    /** Enable the ambient wave. Supply a visible pause control when enabling it. */
+    readonly animated?: boolean;
+    readonly paused?: boolean;
+    readonly className?: string;
+}
+
+/** Compact brand navigation with a keyboard-accessible disclosure and moving marker. */
+export declare function SignalHeader({ brand, links, navigationLabel, menuLabel, menuTitle, menuLinks, utilities, navigationAction, className, sticky }: SignalHeaderProps): ReactNode;
+
+/** Secondary header action; the filled Signal CTA remains the page's primary action. */
+export declare function SignalHeaderAction({ children, className, ...props }: ComponentProps<'a'>): ReactNode;
+
+export declare interface SignalHeaderProps {
+    readonly brand: ReactNode;
+    readonly links: readonly SignalNavigationLink[];
+    readonly navigationLabel: string;
+    readonly menuLabel: string;
+    readonly menuTitle: ReactNode;
+    readonly menuLinks: readonly SignalNavigationLink[];
+    readonly utilities?: ReactNode;
+    /** Context navigation, such as the Docs section drawer, stays beside the rail. */
+    readonly navigationAction?: ReactNode;
+    readonly className?: string;
+    /** Keep navigation available while reading; the surface appears after scrolling. */
+    readonly sticky?: boolean;
+}
+
+export declare interface SignalNavigationLink {
+    readonly label: string;
+    readonly href: string;
+    readonly description?: string;
+    readonly current?: boolean;
+}
+
+/** One appearance/language entry point for public and operating Signal surfaces. */
+export declare function SignalPreferences({ locale, ...props }: SignalPreferencesProps): ReactNode;
+
+export declare interface SignalPreferencesProps extends Omit<ProfileMenuProps, 'trigger' | 'labels' | 'languages' | 'currentLanguage'> {
+    readonly locale: 'en' | 'de';
+}
+
+/** Search is a command trigger, sized to the navigation rail with a compact mobile state. */
+export declare function SignalSearch({ label, onOpen, className }: SignalSearchProps): ReactNode;
+
+export declare interface SignalSearchProps {
+    readonly label: string;
+    readonly onOpen: () => void;
+    readonly className?: string;
+}
+
 export declare const SiteFooter: ({ brand, tagline, social, columns, bottomLeft, bottomRight, copyrightHolder, socialLabel, LinkComponent, className, }: SiteFooterProps) => ReactNode;
 
 export declare interface SiteFooterColumn {
@@ -1054,6 +1122,9 @@ export declare const TerminalIcon: (p: DocIconProps) => ReactNode;
 
 export declare const Textarea: ({ className, ...props }: TextareaHTMLAttributes<HTMLTextAreaElement>) => ReactNode;
 
+/** Fired after applyTheme so preference controls in the same document stay in sync. */
+export declare const THEME_CHANGE_EVENT = "voltro:theme-change";
+
 export declare const THEME_COOKIE = "voltro:theme";
 
 /**
@@ -1170,7 +1241,7 @@ export declare type VoltroMarkVariant = 'gradient' | 'mono' | 'white';
  * type set in the surrounding font and `currentColor`, so it inherits
  * the app's typography and is correct in light + dark automatically.
  */
-export declare const VoltroWordmark: ({ size, markVariant, label, className, style, }: VoltroWordmarkProps) => ReactNode;
+export declare const VoltroWordmark: ({ size, markVariant, label, product, productTone, className, style, }: VoltroWordmarkProps) => ReactNode;
 
 export declare interface VoltroWordmarkProps {
     /** Mark height in px; the wordmark text scales with it. Default 28. */
@@ -1178,6 +1249,10 @@ export declare interface VoltroWordmarkProps {
     readonly markVariant?: VoltroMarkVariant;
     /** Wordmark label. Default "Voltro". */
     readonly label?: string;
+    /** Product badge beside the shared wordmark, e.g. Framework or Cloud. */
+    readonly product?: ReactNode;
+    /** Warning tone for an operator surface; proportions stay shared. */
+    readonly productTone?: 'brand' | 'warning';
     readonly className?: string;
     readonly style?: CSSProperties;
 }