themelia-react-ui 0.0.0-stage → 1.0.0

package/dist/components/features/theme-tweaker/theme-tweaker.strings.d.ts

@@ -0,0 +1,75 @@
+import { type ThemeProviderSettingsStrings } from './theme-provider-settings';
+export interface ThemeTweakerStrings {
+    /** Surface title. */
+    title: string;
+    /** Supporting copy shown under the label. */
+    description: string;
+    searchLabel: string;
+    searchPlaceholder: string;
+    searchHint: string;
+    searchResults: string;
+    allGroups: string;
+    groupNavigationLabel: string;
+    previousGroup: string;
+    nextGroup: string;
+    groupNavigationTitle: string;
+    groupNavigationDescription: string;
+    sharedScope: string;
+    mixedScope: string;
+    variableCount: string;
+    groupSectionLabel: string;
+    lightMode: string;
+    darkMode: string;
+    reset: string;
+    copy: string;
+    copyProvider: string;
+    copyOverrides: string;
+    exportProvider: string;
+    exportOptions: string;
+    export: string;
+    exportPending: string;
+    exportDialogTitle: string;
+    exportDialogDescription: string;
+    downloadCss: string;
+    downloadProvider: string;
+    close: string;
+    copiedStatus: string;
+    exportedStatus: string;
+    invalidTheme: string;
+    emptySearch: string;
+    inheritValue: string;
+    resetVariable: string;
+    chooseColor: string;
+    adjustVariable: string;
+    changedCount: string;
+    cssOutputLabel: string;
+    cssOutputDescription: string;
+    overrideOutputLabel: string;
+    overrideOutputDescription: string;
+    providerOutputLabel: string;
+    providerOutputDescription: string;
+    autoPalette: string;
+    autoPaletteDescription: string;
+    typeRecipeTitle: string;
+    typeRecipeDescription: string;
+    baseTypeSize: string;
+    typeRatio: string;
+    elevationRecipeTitle: string;
+    elevationRecipeDescription: string;
+    elevationIntensity: string;
+    previewTitle: string;
+    previewDescription: string;
+    previewItemTitle: string;
+    previewItemDescription: string;
+    previewFieldLabel: string;
+    previewFieldPlaceholder: string;
+    previewAction: string;
+    previewSuccess: string;
+    previewWarning: string;
+    previewContract: string;
+    providerSettings: ThemeProviderSettingsStrings;
+    groups: Record<'colors' | 'states' | 'typography' | 'shape' | 'structure' | 'defaults', string>;
+    groupDescriptions: Record<'colors' | 'states' | 'typography' | 'shape' | 'structure' | 'defaults', string>;
+    sections: Record<'surfaces-content' | 'brand-actions' | 'charts' | 'sidebar' | 'semantic-feedback' | 'inverse-surfaces' | 'font-families' | 'type-scale' | 'radius' | 'elevation' | 'global-scales' | 'actions-controls' | 'rows-surfaces' | 'media' | 'application-shell' | 'content-widths' | 'adaptive-layout', string>;
+}
+export declare const defaultThemeTweakerStrings: ThemeTweakerStrings;

package/dist/components/features/theme-tweaker/theme-tweaker.types.d.ts

@@ -0,0 +1,161 @@
+import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
+import type { UIConfig } from '../../../lib/ui-provider';
+import type { StringsProp } from '../../../lib/strings';
+import type { ThemeTweakerStrings } from './theme-tweaker.strings';
+export type AdminUIThemeMode = 'light' | 'dark';
+export type AdminUIThemeVariableName = `--${string}`;
+export type AdminUIThemeOverrides = Partial<Record<AdminUIThemeVariableName, string>>;
+/** Serializable CSS-variable theme state shared by ThemeScope and ThemeTweaker. */
+export interface AdminUIThemeDefinition {
+    /** Active preview/application color mode. */
+    mode: AdminUIThemeMode;
+    /** Mode-independent typography, density, structure, radius, and font overrides. */
+    shared: AdminUIThemeOverrides;
+    /** Light-mode palette, state, chart, sidebar, and shadow overrides. */
+    light: AdminUIThemeOverrides;
+    /** Dark-mode palette, state, chart, sidebar, and shadow overrides. */
+    dark: AdminUIThemeOverrides;
+}
+export type ThemeTweakerGroup = 'colors' | 'states' | 'typography' | 'shape' | 'structure' | 'defaults';
+export type ThemeTweakerSection = 'surfaces-content' | 'brand-actions' | 'charts' | 'sidebar' | 'semantic-feedback' | 'inverse-surfaces' | 'font-families' | 'type-scale' | 'radius' | 'elevation' | 'global-scales' | 'actions-controls' | 'rows-surfaces' | 'media' | 'application-shell' | 'content-widths' | 'adaptive-layout';
+export type ThemeTweakerFieldScope = 'shared' | 'mode';
+export type ThemeTweakerFieldKind = 'color' | 'font' | 'length' | 'number' | 'shadow';
+/** Numeric editor recipe for a bounded CSS variable. */
+export interface ThemeTweakerRangeControl {
+    type: 'range';
+    min: number;
+    max: number;
+    step: number;
+    /** Unit appended to committed values. Omit for unitless tokens. */
+    unit?: string;
+    /** Fractional digits accepted by the accompanying numeric input. */
+    decimalPlaces?: number;
+}
+/** One editable public CSS variable. Consumers may extend or replace the defaults. */
+export interface ThemeTweakerField {
+    /** Display name. */
+    name: AdminUIThemeVariableName;
+    /** Display label. */
+    label: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    group: ThemeTweakerGroup;
+    section: ThemeTweakerSection;
+    scope: ThemeTweakerFieldScope;
+    kind: ThemeTweakerFieldKind;
+    placeholder?: string;
+    /** Optional task-oriented control. Fields without one retain exact raw CSS entry. */
+    control?: ThemeTweakerRangeControl;
+}
+export interface AdminUIThemeSelectors {
+    /** Selector receiving mode-independent variables. Defaults to `:root`. */
+    shared: string;
+    /** Selector receiving light-mode variables. Defaults to `:root, .light`. */
+    light: string;
+    /** Selector receiving dark-mode variables. Defaults to `.dark`. */
+    dark: string;
+}
+export interface SerializeAdminUIThemeOptions {
+    selectors?: AdminUIThemeSelectors;
+    /** Header comment in the generated file. Pass `false` to omit it. */
+    banner?: string | false;
+}
+export interface ThemeTweakerExportArtifact {
+    /** Browser-download name for the complete CSS artifact. */
+    fileName: string;
+    /** Complete, standalone CSS for every public runtime variable. */
+    cssText: string;
+    /** Smaller CSS containing only values explicitly changed by the user. */
+    overrideCssText: string;
+    /** Explicit controlled editor state at export time. */
+    theme: AdminUIThemeDefinition;
+    /** Resolved light, dark, and shared values used by `cssText`. */
+    resolvedTheme: AdminUIThemeDefinition;
+    /** Number of explicit shared, light, and dark variable overrides. */
+    overrideCount: number;
+    /** File name for the generated TypeScript UIProvider configuration. */
+    providerFileName: string;
+    /** Serializable mount-once UIProvider defaults represented by the recipe. */
+    providerConfig: UIConfig;
+    /** Typed TypeScript source exporting `adminUIConfig`. */
+    providerConfigText: string;
+}
+export interface CreateThemeTweakerExportArtifactOptions {
+    /** Resolved public-variable snapshot. Falls back to the explicit theme when omitted. */
+    resolvedTheme?: AdminUIThemeDefinition;
+    providerConfig?: UIConfig;
+    providerFileName?: string;
+}
+export type ThemeTweakerTarget = 'self' | 'document' | HTMLElement | (() => HTMLElement | null) | null;
+export interface ThemeScopeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Serializable CSS-variable definition applied to this one DOM boundary. */
+    theme: AdminUIThemeDefinition;
+    /** Override the stored active mode without changing the definition. */
+    mode?: AdminUIThemeMode;
+    /** The subtree and its package portals that should inherit the variables. */
+    children: ReactNode;
+}
+/** One root boundary for package display defaults and live CSS-variable theming. */
+export interface AdminUIThemeProviderProps extends ThemeScopeProps {
+    /** Mount-once package display defaults forwarded to UIProvider. */
+    config?: UIConfig;
+    /**
+     * Where the live CSS variables are applied. Application roots default to
+     * `document` so portaled menus, popovers, dialogs, and toasts inherit them.
+     * Use `self` only for an intentionally isolated embedded preview.
+     */
+    target?: Extract<ThemeTweakerTarget, 'self' | 'document'>;
+    /** Manage `.light` / `.dark` on the document root when `target="document"`. */
+    manageModeClass?: boolean;
+}
+export interface ThemeTweakerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'onCopy' | 'onReset'> {
+    /** Controlled theme definition. Pair with `onValueChange`. */
+    value?: AdminUIThemeDefinition;
+    /** Initial theme definition for uncontrolled usage. */
+    defaultValue?: Partial<AdminUIThemeDefinition>;
+    /** Called with the complete definition after a variable, recipe, reset, or mode change. */
+    onValueChange?: (theme: AdminUIThemeDefinition) => void;
+    /** Called after the active light/dark editor mode changes. */
+    onModeChange?: (mode: AdminUIThemeMode) => void;
+    /** Public-variable catalog. Defaults to the exhaustive package theme surface. */
+    fields?: readonly ThemeTweakerField[];
+    /**
+     * Live-application destination. `self` themes only the component and preview;
+     * `document` themes the application root while mounted.
+     */
+    target?: ThemeTweakerTarget;
+    /** Apply edited variables while the Tweaker is mounted. Defaults to true. */
+    apply?: boolean;
+    /** Manage `.light` / `.dark` on non-self targets. Disable when a theme manager owns the class. */
+    manageModeClass?: boolean;
+    /** Preview content. Omit for the built-in semantic preview; pass false to hide it. */
+    preview?: ReactNode | false;
+    /** Generated file name used by the default browser download. */
+    fileName?: string;
+    /** Controlled serializable UIProvider defaults edited and included in export artifacts. */
+    config?: UIConfig;
+    /** Initial uncontrolled serializable UIProvider defaults. */
+    defaultConfig?: UIConfig;
+    /** Called when an editable provider default changes. */
+    onConfigChange?: (config: UIConfig) => void;
+    /** Generated TypeScript config file name reported in export artifacts. */
+    providerFileName?: string;
+    /** Hide the built-in title/description when an owning drawer supplies them. */
+    showIntro?: boolean;
+    /** CSS selectors used by complete and override-only serialization. */
+    selectors?: AdminUIThemeSelectors;
+    /** Replaces the default browser download with consumer persistence or transport. */
+    onExport?: (artifact: ThemeTweakerExportArtifact) => void | Promise<void>;
+    /** Replaces the default Clipboard API copy action. */
+    onCopy?: (cssText: string) => void | Promise<void>;
+    /** Called after all explicit variable overrides are reset. */
+    onReset?: (previous: AdminUIThemeDefinition) => void;
+    /** Receives clipboard, export, download, or serialization failures. */
+    onError?: (error: unknown) => void;
+    /** Additional call-site actions appended to the compact editor toolbar. */
+    actionsSlot?: ReactNode;
+    /** Deep partial override for all editor, recipe, preview, and provider copy. */
+    strings?: StringsProp<ThemeTweakerStrings>;
+}
+/** React inline-style shape with typed CSS custom properties. */
+export type AdminUIThemeStyle = CSSProperties & Partial<Record<AdminUIThemeVariableName, string>>;

package/dist/components/features/theme-tweaker/theme-tweaker.utils.d.ts

@@ -0,0 +1,23 @@
+import { type UIConfig } from '../../../lib/ui-provider';
+import type { AdminUIThemeDefinition, AdminUIThemeMode, AdminUIThemeOverrides, AdminUIThemeSelectors, AdminUIThemeStyle, AdminUIThemeVariableName, CreateThemeTweakerExportArtifactOptions, SerializeAdminUIThemeOptions, ThemeTweakerExportArtifact } from './theme-tweaker.types';
+export declare const defaultAdminUIThemeSelectors: AdminUIThemeSelectors;
+export declare function createAdminUITheme(value?: Partial<AdminUIThemeDefinition>): AdminUIThemeDefinition;
+export declare function isAdminUIThemeVariableName(value: string): value is AdminUIThemeVariableName;
+export declare function serializeAdminUITheme(theme: AdminUIThemeDefinition, options?: SerializeAdminUIThemeOptions): string;
+/**
+ * Returns the complete serializable UIProvider contract. Function and
+ * date-fns-locale hooks remain consumer-owned and are intentionally omitted.
+ */
+export declare function createSerializableUIConfig(config?: UIConfig): UIConfig;
+export declare function serializeUIProviderConfig(config?: UIConfig): string;
+export declare function getActiveAdminUIThemeOverrides(theme: AdminUIThemeDefinition, mode?: AdminUIThemeMode): AdminUIThemeOverrides;
+export declare function adminUIThemeToStyle(theme: AdminUIThemeDefinition, mode?: AdminUIThemeMode): AdminUIThemeStyle;
+export declare function countAdminUIThemeOverrides(theme: AdminUIThemeDefinition): number;
+export declare function createScopedAdminUIThemeSelectors(scopeSelector: string): AdminUIThemeSelectors;
+export declare function createThemeTweakerExportArtifact(theme: AdminUIThemeDefinition, fileName?: string, options?: SerializeAdminUIThemeOptions, artifactOptions?: CreateThemeTweakerExportArtifactOptions): ThemeTweakerExportArtifact;
+export declare function downloadAdminUITheme(artifact: Pick<ThemeTweakerExportArtifact, 'cssText' | 'fileName'>): void;
+export declare function downloadAdminUITextFile({ fileName, text, mimeType, }: {
+    fileName: string;
+    text: string;
+    mimeType?: string;
+}): void;

package/dist/components/features/theme-tweaker/use-applied-theme.d.ts

@@ -0,0 +1,11 @@
+import { type RefObject } from 'react';
+import type { AdminUIThemeDefinition, ThemeTweakerTarget } from './theme-tweaker.types';
+interface UseAppliedThemeOptions {
+    apply: boolean;
+    manageModeClass: boolean;
+    selfRef: RefObject<HTMLDivElement | null>;
+    target: ThemeTweakerTarget;
+    theme: AdminUIThemeDefinition;
+}
+export declare function useAppliedTheme({ apply, manageModeClass, selfRef, target, theme, }: UseAppliedThemeOptions): void;
+export {};

package/dist/components/layout/app-shell/app-layout.d.ts

@@ -0,0 +1,12 @@
+import type { SidebarInsetLayoutProps, StackedLayoutProps, TopbarSidebarLayoutProps } from './app-shell.types';
+/** Presets select chrome; each underlying shell retains its own typed slots and behavior. */
+export type AppLayoutProps = (Omit<TopbarSidebarLayoutProps, 'headerTheme'> & {
+    variant?: 'light-header' | 'dark-header';
+}) | (Omit<SidebarInsetLayoutProps, 'surface'> & {
+    variant: 'sidebar' | 'inset';
+}) | (StackedLayoutProps & {
+    variant: 'stacked';
+});
+export type AppLayoutVariant = NonNullable<AppLayoutProps['variant']>;
+/** Five ready compositions using three shell owners, with one page viewport. */
+export declare function AppLayout(props: AppLayoutProps): import("react").JSX.Element;

package/dist/components/layout/app-shell/app-shell.types.d.ts

@@ -0,0 +1,151 @@
+import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
+export type TopbarSidebarHeaderTheme = 'light' | 'dark';
+export type TopbarSidebarSide = 'left' | 'right';
+export type TopbarSidebarContentElement = 'main' | 'div';
+export type TopbarSidebarMobileSidebarMode = 'drawer' | 'inline';
+export interface TopbarSidebarLayoutSlots {
+    /** Full header replacement inside the themed header region. */
+    header?: ReactNode;
+    /** Sidebar trigger rendered before the logo, usually visible on mobile. */
+    sidebarTrigger?: ReactNode;
+    /** Brand/logo block rendered at the far left of the header. */
+    logo?: ReactNode;
+    /** Content rendered after the logo and before the center slot. */
+    headerStart?: ReactNode;
+    /** Header center region, usually search or a scope switcher. */
+    headerCenter?: ReactNode;
+    /** Header actions rendered before the trailing account/notification region. */
+    headerActions?: ReactNode;
+    /** Header trailing region, usually notifications/user/actions. */
+    headerEnd?: ReactNode;
+    /** Sidebar column content. */
+    sidebar?: ReactNode;
+    /** Full content replacement; falls back to `children`. */
+    content?: ReactNode;
+}
+export type TopbarSidebarLayoutStyle = CSSProperties & {
+    '--shell-header-height'?: string;
+    '--shell-sidebar-width'?: string;
+};
+export interface TopbarSidebarLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Page content rendered in the content column. */
+    children?: ReactNode;
+    /** Header theme. Applies a `.light`/`.dark` token scope to the header so partials use ordinary tokens and invert against the header surface. */
+    headerTheme?: TopbarSidebarHeaderTheme;
+    /** Sidebar side in the body grid. */
+    sidebarSide?: TopbarSidebarSide;
+    /** Mobile sidebar behavior. `drawer` hides the body column below `md` so `SidebarTrigger` can open the sheet. */
+    mobileSidebarMode?: TopbarSidebarMobileSidebarMode;
+    /** Header height CSS value. Defaults to `var(--shell-header-height)`, whose root default is 4.5rem. */
+    headerHeight?: string;
+    /** Expanded sidebar column width CSS value. Defaults to `var(--shell-sidebar-width)`, whose root default is 16rem. */
+    sidebarWidth?: string;
+    /** Convenience mobile/sidebar trigger slot. Prefer `slots.sidebarTrigger` when composing many regions. */
+    sidebarTrigger?: ReactNode;
+    /** Convenience logo slot. Prefer `slots.logo` when composing many regions. */
+    logo?: ReactNode;
+    /** Convenience header actions slot. Prefer `slots.headerActions` when composing many regions. */
+    headerActions?: ReactNode;
+    /** Convenience sidebar slot. Prefer `slots.sidebar` when composing many regions. */
+    sidebar?: ReactNode;
+    /** Named content regions. */
+    slots?: TopbarSidebarLayoutSlots;
+    /** Semantic element for the content column. */
+    contentAs?: TopbarSidebarContentElement;
+    /** Merged onto the header region. */
+    headerClassName?: string;
+    headerInnerClassName?: string;
+    /** Merged onto the body region. */
+    bodyClassName?: string;
+    /** Merged onto the sidebar region. */
+    sidebarClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    style?: TopbarSidebarLayoutStyle;
+}
+export type SidebarInsetSide = 'left' | 'right';
+export type SidebarInsetContentElement = 'main' | 'div';
+/** `inset` floats the content on the sidebar surface; `flush` sits it edge to edge. */
+export type SidebarInsetSurface = 'inset' | 'flush';
+export interface SidebarInsetLayoutSlots {
+    /** Sidebar column content, spanning the full page height. */
+    sidebar?: ReactNode;
+    /** Full toolbar replacement inside the content column. */
+    toolbar?: ReactNode;
+    /** Sidebar trigger, rendered at the start of the toolbar. */
+    sidebarTrigger?: ReactNode;
+    /** Leading toolbar region, usually a breadcrumb or page title. */
+    toolbarStart?: ReactNode;
+    /** Trailing toolbar region, usually actions or an account menu. */
+    toolbarEnd?: ReactNode;
+    /** Full content replacement; falls back to `children`. */
+    content?: ReactNode;
+}
+export interface SidebarInsetLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Page content rendered in the content column. */
+    children?: ReactNode;
+    /** Sidebar side. */
+    sidebarSide?: SidebarInsetSide;
+    /** How the content surface meets the sidebar. */
+    surface?: SidebarInsetSurface;
+    /** Renders the toolbar row. Set `false` for a shell with no header chrome at all. */
+    toolbar?: boolean;
+    /** Expanded sidebar column width CSS value. */
+    sidebarWidth?: string;
+    /** Convenience sidebar slot. */
+    sidebar?: ReactNode;
+    /** Convenience trigger slot. */
+    sidebarTrigger?: ReactNode;
+    /** Named content regions. */
+    slots?: SidebarInsetLayoutSlots;
+    /** Semantic element for the content region. */
+    contentAs?: SidebarInsetContentElement;
+    /** Merged onto the sidebar region. */
+    sidebarClassName?: string;
+    /** Merged onto the toolbar region. */
+    toolbarClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    style?: TopbarSidebarLayoutStyle;
+}
+export type StackedContentElement = 'main' | 'div';
+export type StackedContentWidth = 'contained' | 'full';
+export interface StackedLayoutSlots {
+    /** Full header replacement. */
+    header?: ReactNode;
+    /** Brand/logo block at the start of the header. */
+    logo?: ReactNode;
+    /** Primary horizontal navigation, rendered after the logo. */
+    nav?: ReactNode;
+    /** Trailing header region, usually search, notifications or an account menu. */
+    headerEnd?: ReactNode;
+    /** Secondary row under the header, usually tabs or a breadcrumb. */
+    subheader?: ReactNode;
+    /** Full content replacement; falls back to `children`. */
+    content?: ReactNode;
+}
+export interface StackedLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Page content. */
+    children?: ReactNode;
+    /** Header theme, matching `TopbarSidebarLayout`'s token-scope approach. */
+    headerTheme?: TopbarSidebarHeaderTheme;
+    /** Constrains the content to the shell's reading width, or lets it span. */
+    contentWidth?: StackedContentWidth;
+    /** Header height CSS value. */
+    headerHeight?: string;
+    /** Convenience logo slot. */
+    logo?: ReactNode;
+    /** Convenience navigation slot. */
+    nav?: ReactNode;
+    /** Named content regions. */
+    slots?: StackedLayoutSlots;
+    /** Semantic element for the content region. */
+    contentAs?: StackedContentElement;
+    /** Merged onto the header region. */
+    headerClassName?: string;
+    /** Merged onto the sub-header region. */
+    subheaderClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    style?: TopbarSidebarLayoutStyle;
+}

package/dist/components/layout/app-shell/index.d.ts

@@ -0,0 +1,6 @@
+export { TopbarSidebarLayout } from './topbar-sidebar-layout';
+export type { TopbarSidebarContentElement, TopbarSidebarHeaderTheme, TopbarSidebarLayoutProps, TopbarSidebarLayoutSlots, TopbarSidebarLayoutStyle, TopbarSidebarSide, } from './app-shell.types';
+export { SidebarInsetLayout } from './sidebar-inset-layout';
+export { StackedLayout } from './stacked-layout';
+export type { SidebarInsetContentElement, SidebarInsetLayoutProps, SidebarInsetLayoutSlots, SidebarInsetSide, SidebarInsetSurface, StackedContentElement, StackedContentWidth, StackedLayoutProps, StackedLayoutSlots, } from './app-shell.types';
+export { AppLayout, type AppLayoutProps, type AppLayoutVariant } from './app-layout';

package/dist/components/layout/app-shell/sidebar-inset-layout.d.ts

@@ -0,0 +1,2 @@
+import type { SidebarInsetLayoutProps } from './app-shell.types';
+export declare function SidebarInsetLayout({ children, sidebarSide, surface, toolbar, sidebarWidth, sidebar, sidebarTrigger, slots, contentAs: Content, className, sidebarClassName, toolbarClassName, contentClassName, style, ...props }: SidebarInsetLayoutProps): import("react").JSX.Element;

package/dist/components/layout/app-shell/stacked-layout.d.ts

@@ -0,0 +1,2 @@
+import type { StackedLayoutProps } from './app-shell.types';
+export declare function StackedLayout({ children, headerTheme, contentWidth, headerHeight, logo, nav, slots, contentAs: Content, className, headerClassName, subheaderClassName, contentClassName, style, ...props }: StackedLayoutProps): import("react").JSX.Element;

package/dist/components/layout/app-shell/topbar-sidebar-layout.d.ts

@@ -0,0 +1,2 @@
+import type { TopbarSidebarLayoutProps } from './app-shell.types';
+export declare function TopbarSidebarLayout({ children, headerTheme, sidebarSide, mobileSidebarMode, headerHeight, sidebarWidth, sidebarTrigger, logo, headerActions, sidebar, slots, contentAs: Content, className, headerClassName, headerInnerClassName, bodyClassName, sidebarClassName, contentClassName, style, ...props }: TopbarSidebarLayoutProps): import("react").JSX.Element;

package/dist/components/layout/auth/auth-card.d.ts

@@ -0,0 +1,2 @@
+import type { AuthCardProps } from './auth.types';
+export declare function AuthCard({ surface, eyebrow, title, description, headerEnd, banner, media, footer, children, className, headerClassName, mediaClassName, contentClassName, footerClassName, ...props }: AuthCardProps): import("react").JSX.Element;

package/dist/components/layout/auth/auth-footer-links.d.ts

@@ -0,0 +1,2 @@
+import type { AuthFooterLinksProps } from './auth.types';
+export declare function AuthFooterLinks({ links, leadingIcon, separator, renderLink, className, strings: stringsProp, ...props }: AuthFooterLinksProps): import("react").JSX.Element | null;

package/dist/components/layout/auth/auth-form.d.ts

@@ -0,0 +1,11 @@
+import type { AuthFormProps, AuthFormRowProps } from './auth.types';
+/**
+ * Canonical auth form track. The explicit minmax(0, 1fr) column prevents
+ * nowrap controls from widening a narrow auth card through grid min-content.
+ */
+export declare function AuthForm({ className, ...props }: AuthFormProps): import("react").JSX.Element;
+/**
+ * Auxiliary auth row for controls such as "remember me" and recovery links.
+ * Items remain side by side when they fit and wrap without widening the card.
+ */
+export declare function AuthFormRow({ className, ...props }: AuthFormRowProps): import("react").JSX.Element;

package/dist/components/layout/auth/auth-hooks.d.ts

@@ -0,0 +1,4 @@
+import type { AuthBrand, AuthBrandConfig, UseAuthLinksOptions, UseAuthLinksReturn, UseAuthShellOptions, UseAuthShellReturn } from './auth.types';
+export declare function isAuthBrandConfig(brand: AuthBrand | undefined): brand is AuthBrandConfig;
+export declare function useAuthLinks({ links, renderLink, }?: UseAuthLinksOptions): UseAuthLinksReturn;
+export declare function useAuthShell({ variant, brand, footer, footerLinks, policyLinks, languageLinks, languageSwitcher, postCard, socialProviders, splitPanel, renderLink, }?: UseAuthShellOptions): UseAuthShellReturn;

package/dist/components/layout/auth/auth-method-switch.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import type { AuthMethodSwitchProps, UseAuthMethodSwitchOptions, UseAuthMethodSwitchReturn } from './auth.types';
+export declare function useAuthMethodSwitch({ options, value, defaultValue, onValueChange, }?: UseAuthMethodSwitchOptions): UseAuthMethodSwitchReturn;
+export declare function AuthMethodSwitch({ options, value, defaultValue, onValueChange, layout, divider, className, strings: stringsProp, ...props }: AuthMethodSwitchProps): React.JSX.Element | null;

package/dist/components/layout/auth/auth-shell.d.ts

@@ -0,0 +1,2 @@
+import type { AuthShellProps } from './auth.types';
+export declare function AuthShell({ children, variant: variantProp, size, align, brand, eyebrow, title, description, headerEnd, banner, cardMedia, cardMediaClassName, cardFooter, postCard, footer, footerLinks, policyLinks, languageLinks, languageSwitcher, socialProviders, socialProvidersLayout, socialDivider, splitPanel, splitSide, splitMobile, renderLink, className, mainClassName, stackClassName, cardClassName, cardContentClassName, splitGridClassName, splitPanelClassName, footerClassName, strings: stringsProp, ...props }: AuthShellProps): import("react").JSX.Element;

package/dist/components/layout/auth/auth-social-providers.d.ts

@@ -0,0 +1,3 @@
+import type { AuthSocialProviderButtonProps, AuthSocialProvidersProps } from './auth.types';
+export declare function AuthSocialProviderButton({ provider, renderLink, className, }: AuthSocialProviderButtonProps): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+export declare function AuthSocialProviders({ providers, layout, renderLink, className, strings: stringsProp, ...props }: AuthSocialProvidersProps): import("react").JSX.Element | null;

package/dist/components/layout/auth/auth-split-panel.d.ts

@@ -0,0 +1,2 @@
+import type { AuthSplitPanelProps } from './auth.types';
+export declare function AuthSplitPanel({ eyebrow, title, description, media, features, footer, children, surface, className, contentClassName, ...props }: AuthSplitPanelProps): import("react").JSX.Element;

package/dist/components/layout/auth/auth.strings.d.ts

@@ -0,0 +1,21 @@
+export interface AuthShellStrings {
+    socialDivider: string;
+    socialProvidersLabel: string;
+    footerLinksLabel: string;
+    policyLinksLabel: string;
+    languageLinksLabel: string;
+}
+export declare const defaultAuthShellStrings: AuthShellStrings;
+export interface AuthFooterLinksStrings {
+    label: string;
+}
+export declare const defaultAuthFooterLinksStrings: AuthFooterLinksStrings;
+export interface AuthSocialProvidersStrings {
+    label: string;
+}
+export declare const defaultAuthSocialProvidersStrings: AuthSocialProvidersStrings;
+export interface AuthMethodSwitchStrings {
+    label: string;
+    divider: string;
+}
+export declare const defaultAuthMethodSwitchStrings: AuthMethodSwitchStrings;