@platform-blocks/ui 0.1.1

package/lib/components/Accessibility/AccessibilityDemo.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+/**
+ * Comprehensive accessibility demo showcasing all features
+ */
+export declare const AccessibilityDemo: React.FC;

package/lib/components/Accessibility/AccessibilityHelpers.d.ts

@@ -0,0 +1,49 @@
+import React from 'react';
+interface SkipLinkProps {
+    href: string;
+    children: React.ReactNode;
+    onPress?: () => void;
+}
+/**
+ * Skip link for keyboard navigation - allows users to skip to main content
+ */
+export declare const SkipLink: React.FC<SkipLinkProps>;
+interface LandmarkProps {
+    role: 'main' | 'navigation' | 'banner' | 'contentinfo' | 'complementary';
+    label?: string;
+    children: React.ReactNode;
+    style?: any;
+}
+/**
+ * Semantic landmark component for page structure
+ */
+export declare const Landmark: React.FC<LandmarkProps>;
+interface LiveRegionProps {
+    priority?: 'polite' | 'assertive';
+    children: React.ReactNode;
+    atomic?: boolean;
+}
+/**
+ * Live region for dynamic content announcements
+ */
+export declare const LiveRegion: React.FC<LiveRegionProps>;
+interface ProgressIndicatorProps {
+    value: number;
+    max?: number;
+    label?: string;
+    description?: string;
+    showPercentage?: boolean;
+}
+/**
+ * Accessible progress indicator
+ */
+export declare const ProgressIndicator: React.FC<ProgressIndicatorProps>;
+interface ErrorBoundaryFallbackProps {
+    error: Error;
+    resetError: () => void;
+}
+/**
+ * Accessible error boundary fallback
+ */
+export declare const ErrorBoundaryFallback: React.FC<ErrorBoundaryFallbackProps>;
+export {};

package/lib/components/Accessibility/AccessibilityTesting.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+interface AccessibilityDebuggerProps {
+    visible?: boolean;
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+}
+/**
+ * Development tool for debugging accessibility features
+ */
+export declare const AccessibilityDebugger: React.FC<AccessibilityDebuggerProps>;
+interface AccessibilityTestSuiteProps {
+    onTestComplete?: (results: AccessibilityTestResults) => void;
+}
+interface AccessibilityTestResults {
+    colorContrast: boolean;
+    focusableElements: number;
+    screenReaderLabels: boolean;
+    keyboardNavigation: boolean;
+    reducedMotion: boolean;
+}
+/**
+ * Automated accessibility testing component
+ */
+export declare const AccessibilityTestSuite: React.FC<AccessibilityTestSuiteProps>;
+export {};

package/lib/components/Accessibility/AccessibleComponents.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+interface AccessibleAnnouncerProps {
+    children: React.ReactNode;
+    announcements: string[];
+}
+/**
+ * Component that provides live region for announcements
+ */
+export declare const AccessibleAnnouncer: React.FC<AccessibleAnnouncerProps>;
+interface AccessibleModalProps {
+    visible: boolean;
+    title?: string;
+    children: React.ReactNode;
+    onDismiss?: () => void;
+}
+/**
+ * Accessible modal with focus management
+ */
+export declare const AccessibleModal: React.FC<AccessibleModalProps>;
+export {};

package/lib/components/Accessibility/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AccessibleComponents';
+export * from './AccessibilityHelpers';

package/lib/components/Accordion/Accordion.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { AccordionProps, AccordionRef } from './types';
+export declare const Accordion: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<AccordionRef>>;
+export declare const Root: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<AccordionRef>>;
+export declare const Item: React.FC<import("./AccordionItem").AccordionItemComponentProps>;
+export declare const AccordionNamespace: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<AccordionRef>> & {
+    Root: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<AccordionRef>>;
+    Item: React.FC<import("./AccordionItem").AccordionItemComponentProps>;
+};

package/lib/components/Accordion/AccordionItem.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { AccordionItem, AccordionProps } from './types';
+import type { AccordionAnimationProp } from './types';
+export interface AccordionItemComponentProps {
+    item: AccordionItem;
+    isExpanded: boolean;
+    isDisabled: boolean;
+    isLast: boolean;
+    variant: AccordionProps['variant'];
+    onPress: () => void;
+    showChevron: boolean;
+    styles: any;
+    chevronColor: string;
+    disabledChevronColor: string;
+    headerStyle?: any;
+    contentStyle?: any;
+    headerTextStyle?: any;
+    idPrefix: string;
+    animated: AccordionAnimationProp;
+    chevronPosition?: 'start' | 'end';
+}
+export declare const AccordionItemComponent: React.FC<AccordionItemComponentProps>;
+export default AccordionItemComponent;

package/lib/components/Accordion/defaults.d.ts

@@ -0,0 +1,13 @@
+export declare const ACCORDION_DEFAULTS: {
+    readonly type: "single";
+    readonly defaultExpanded: string[];
+    readonly variant: "default";
+    readonly size: "md";
+    readonly color: "primary";
+    readonly showChevron: true;
+    readonly autoPersist: true;
+    readonly animated: true;
+    readonly chevronPosition: "end";
+    readonly density: "comfortable";
+};
+export type AccordionDefaultProps = typeof ACCORDION_DEFAULTS;

package/lib/components/Accordion/hooks/useAccordionItemAnimation.d.ts

@@ -0,0 +1,17 @@
+import { View } from 'react-native';
+export interface UseAccordionItemAnimationOptions {
+    expanded: boolean;
+    animated: boolean | {
+        duration?: number;
+        easing?: (t: number) => number;
+    };
+}
+export interface UseAccordionItemAnimationResult {
+    contentRef: React.RefObject<View | null>;
+    onContentLayout: (e: any) => void;
+    animatedHeightStyle: any;
+    animatedChevronStyle: any;
+    isLayoutComplete: boolean;
+    contentHeight: number;
+}
+export declare function useAccordionItemAnimation(opts: UseAccordionItemAnimationOptions): UseAccordionItemAnimationResult;

package/lib/components/Accordion/hooks/useMeasuredHeight.d.ts

@@ -0,0 +1,8 @@
+import { LayoutChangeEvent, View } from 'react-native';
+export interface MeasuredHeightResult {
+    ref: React.RefObject<View>;
+    height: number;
+    onLayout: (e: LayoutChangeEvent) => void;
+    hasMeasured: boolean;
+}
+export declare function useMeasuredHeight(initialExpanded: boolean): MeasuredHeightResult;

package/lib/components/Accordion/index.d.ts

@@ -0,0 +1,5 @@
+import { Accordion, AccordionNamespace } from './Accordion';
+export { Accordion, AccordionNamespace };
+export declare const AccordionRoot: import("react").ForwardRefExoticComponent<import("./types").AccordionProps & import("react").RefAttributes<import("./types").AccordionRef>>;
+export type { AccordionProps, AccordionItem as AccordionItemType, AccordionRef } from './types';
+export type { AccordionType, AccordionVariant, AccordionColor, AccordionComputedStyles, AccordionStyleResolver, AccordionToggleDetail, OnAccordionToggle, AccordionAnimationProp } from './types';

package/lib/components/Accordion/styles.d.ts

@@ -0,0 +1,17 @@
+import type { TextStyle } from 'react-native';
+import type { PlatformBlocksTheme } from '../../core/theme/types';
+import { SizeValue } from '../../core/theme/sizes';
+import type { AccordionProps, AccordionComputedStyles } from './types';
+type VariantTokenFn = (theme: PlatformBlocksTheme, radiusStyles: any) => {
+    container: any;
+    item: any;
+    header: any;
+    content: any;
+};
+export declare const accordionVariants: Record<string, VariantTokenFn>;
+export declare const getAccordionStyles: (theme: PlatformBlocksTheme, variant: AccordionProps["variant"], size: SizeValue | undefined, color: AccordionProps["color"], // reserved for future variant coloring
+radiusStyles: any | undefined, density?: AccordionProps["density"]) => AccordionComputedStyles & {
+    activeHeaderText: TextStyle;
+    disabledHeaderText: TextStyle;
+};
+export default getAccordionStyles;

package/lib/components/Accordion/tokens.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformBlocksTheme } from '../../core/theme/types';
+export interface AccordionSectionStyle {
+    [key: string]: any;
+}
+export interface AccordionVariantTokens {
+    container: AccordionSectionStyle;
+    item: AccordionSectionStyle;
+    header: AccordionSectionStyle;
+    content: AccordionSectionStyle;
+}
+export type AccordionVariantTokenFn = (theme: PlatformBlocksTheme, radiusStyles?: AccordionSectionStyle) => AccordionVariantTokens;
+export declare const ACCORDION_VARIANTS: Record<string, AccordionVariantTokenFn>;

package/lib/components/Accordion/types.d.ts

@@ -0,0 +1,180 @@
+import type { ReactNode } from 'react';
+import type { ViewStyle, TextStyle } from 'react-native';
+import type { SizeValue } from '../../core/theme/sizes';
+import type { BorderRadiusProps } from '../../core/theme/radius';
+import type { PlatformBlocksTheme } from '../../core/theme/types';
+import type { SpacingProps } from '../../core/utils';
+/**
+ * Single logical panel within an `Accordion`.
+ * Provide a stable, unique `key` for correct persistence and state reconciliation.
+ */
+export interface AccordionItem {
+    /**
+     * Unique identifier for the item. Must be stable across renders.
+     */
+    key: string;
+    /**
+     * Header label rendered in the item trigger row.
+     */
+    title: string;
+    /**
+     * Collapsible body content shown when the item is expanded.
+     */
+    content: ReactNode;
+    /**
+     * Disables user interaction and visually indicates the item is inactive.
+     */
+    disabled?: boolean;
+    /**
+     * Optional decorative or status icon rendered alongside the title.
+     */
+    icon?: ReactNode;
+}
+export type AccordionType = 'single' | 'multiple';
+export type AccordionVariant = 'default' | 'separated' | 'bordered';
+export type AccordionColor = 'primary' | 'secondary' | 'gray';
+/**
+ * Props for the `Accordion` component.
+ * Supports controlled & uncontrolled usage patterns, single or multi expansion modes,
+ * density & variant styling, and optional persistence between remounts.
+ */
+export interface AccordionProps extends SpacingProps, BorderRadiusProps {
+    /**
+     * Ordered list of items to render. The `key` for each item must be unique.
+     */
+    items: AccordionItem[];
+    /**
+     * Expansion behavior.
+     * 'single' ensures only one item can be expanded at a time; 'multiple' allows independent expansion.
+     * @default 'single'
+     */
+    type?: AccordionType;
+    /**
+     * Initial expanded item keys (uncontrolled). Ignored when `expanded` is provided.
+     * For `type="single"` only the first key is used at initialization.
+     * @default []
+     */
+    defaultExpanded?: string[];
+    /**
+     * Controlled set of expanded item keys. Provide alongside `onExpandedChange`.
+     */
+    expanded?: string[];
+    /**
+     * Called when the expanded keys change (both controlled & uncontrolled flows).
+     */
+    onExpandedChange?: (expanded: string[]) => void;
+    /**
+     * Per-item toggle event with rich metadata. Fires after state resolution.
+     */
+    onItemToggle?: OnAccordionToggle;
+    /**
+     * Visual variant style preset.
+     * @default 'default'
+     */
+    variant?: AccordionVariant;
+    /**
+     * Size scale controlling paddings, font sizes, and icon dimensions.
+     * @default 'md'
+     */
+    size?: SizeValue;
+    /**
+     * Color theme accent applied to active headers & focus states.
+     * @default 'primary'
+     */
+    color?: AccordionColor;
+    /**
+     * Whether to render the chevron affordance.
+     * @default true
+     */
+    showChevron?: boolean;
+    /**
+     * Chevron placement relative to the header text.
+     * @default 'end'
+     */
+    chevronPosition?: 'start' | 'end';
+    /**
+     * Space efficiency / vertical density preset.
+     * @default 'comfortable'
+     */
+    density?: 'comfortable' | 'compact' | 'spacious';
+    /**
+     * Root container style override.
+     */
+    style?: ViewStyle;
+    /**
+     * Header row style override applied to each item.
+     */
+    headerStyle?: ViewStyle;
+    /**
+     * Collapsible content container style override.
+     */
+    contentStyle?: ViewStyle;
+    /**
+     * Text style applied to the header label.
+     */
+    headerTextStyle?: TextStyle;
+    /**
+     * Explicit persistence key. If omitted, an automatic hash key will be generated when uncontrolled.
+     */
+    persistKey?: string;
+    /**
+     * Enables persistence of expanded state (uncontrolled only) across remounts in-process.
+     * @default true
+     */
+    autoPersist?: boolean;
+    /**
+     * Enables animation or accepts a config object for custom durations & easing.
+     * @default true
+     */
+    animated?: AccordionAnimationProp;
+}
+/**
+ * Internal computed style contract resolved from theme + props.
+ * Not part of the public API surface intentionally (subject to change).
+ */
+export interface AccordionComputedStyles {
+    container: ViewStyle;
+    item: ViewStyle;
+    header: ViewStyle;
+    content: ViewStyle;
+    headerText: TextStyle;
+    activeHeaderText: TextStyle;
+    disabledHeaderText: TextStyle;
+    chevron: ViewStyle;
+}
+export type AccordionStyleResolver = (theme: PlatformBlocksTheme, variant: AccordionVariant | undefined, size: SizeValue | undefined, color: AccordionColor | undefined, radiusStyles?: any) => AccordionComputedStyles;
+/**
+ * Detail object supplied to `onItemToggle` describing the transition and new state.
+ */
+export interface AccordionToggleDetail {
+    itemKey: string;
+    expanded: boolean;
+    expandedKeys: string[];
+    type: AccordionType;
+    variant: AccordionVariant | undefined;
+}
+/**
+ * Callback signature fired after an item toggles.
+ */
+export type OnAccordionToggle = (detail: AccordionToggleDetail) => void;
+/**
+ * Controls animation behavior. `true` uses defaults; `false` disables transitions.
+ * Provide an object to customize timing.
+ */
+export type AccordionAnimationProp = boolean | {
+    duration?: number;
+    easing?: (t: number) => number;
+};
+/**
+ * Imperative methods exposed via `ref` when using `forwardRef`.
+ */
+export interface AccordionRef {
+    /** Expand all non-disabled items (multi mode) or ensure one item open (single). */
+    expandAll: () => void;
+    /** Collapse every expanded item. */
+    collapseAll: () => void;
+    /** Toggle a specific item by key. */
+    toggle: (key: string) => void;
+    /** Current expanded keys snapshot. */
+    getExpanded: () => string[];
+}

package/lib/components/Alert/Alert.d.ts

@@ -0,0 +1,2 @@
+import type { AlertFactoryPayload } from './types';
+export declare const Alert: import("../../core/factory").PlatformBlocksComponent<AlertFactoryPayload>;

package/lib/components/Alert/index.d.ts

@@ -0,0 +1,2 @@
+export { Alert } from './Alert';
+export type { AlertProps, AlertVariant, AlertColor, AlertSeverity } from './types';

package/lib/components/Alert/types.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import { View, ViewStyle } from 'react-native';
+import { SpacingProps } from '../../core/utils';
+import { BorderRadiusProps } from '../../core/theme/radius';
+export type AlertVariant = 'light' | 'filled' | 'outline' | 'subtle';
+export type AlertColor = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'gray';
+export type AlertSeverity = 'info' | 'success' | 'warning' | 'error';
+export interface AlertProps extends SpacingProps, BorderRadiusProps {
+    variant?: AlertVariant;
+    color?: AlertColor | string;
+    sev?: AlertSeverity;
+    title?: string;
+    children?: React.ReactNode;
+    icon?: React.ReactNode | string | null | false;
+    fullWidth?: boolean;
+    withCloseButton?: boolean;
+    closeButtonLabel?: string;
+    onClose?: () => void;
+    style?: ViewStyle;
+    testID?: string;
+}
+export interface AlertFactoryPayload {
+    props: AlertProps;
+    ref: View;
+}

package/lib/components/AppShell/AppShell.d.ts

@@ -0,0 +1,48 @@
+import React from 'react';
+import { View } from 'react-native';
+import type { AppShellProps, AppShellContextValue, AppShellHeaderProps, AppShellNavbarProps, AppShellAsideProps, AppShellFooterProps, AppShellBottomNavProps, AppShellMainProps, AppShellSectionProps } from './types';
+import { MobileMenu } from './MobileMenu';
+import { BottomAppBar } from './BottomAppBar';
+import { StatusBarManager } from './StatusBarManager';
+type AppShellApi = {
+    openNavbar: () => void;
+    closeNavbar: () => void;
+    toggleNavbar: () => void;
+};
+type AppShellLayout = {
+    headerHeight: number | string;
+    navbarWidth: number | string;
+    asideWidth: number | string;
+    footerHeight: number | string;
+    bottomNavHeight: number | string;
+};
+export declare const useNavbarHover: () => boolean;
+export declare const useAppShell: () => AppShellContextValue;
+export declare const useAppShellApi: () => AppShellApi;
+export declare const useAppShellLayout: () => AppShellLayout;
+export declare const AppShellHeader: React.FC<AppShellHeaderProps>;
+export declare const AppShellNavbar: React.FC<AppShellNavbarProps>;
+export declare const AppShellAside: React.FC<AppShellAsideProps>;
+export declare const AppShellFooter: React.FC<AppShellFooterProps>;
+export declare const AppShellBottomNav: React.FC<AppShellBottomNavProps>;
+export declare const AppShellMain: React.FC<AppShellMainProps>;
+export declare const AppShellSection: React.FC<AppShellSectionProps>;
+interface AppShellFactoryPayload {
+    props: AppShellProps;
+    ref: View;
+}
+declare const AppShellComponent: import("../../core/factory").PlatformBlocksComponent<AppShellFactoryPayload>;
+type AppShellType = typeof AppShellComponent & {
+    Header: typeof AppShellHeader;
+    Navbar: typeof AppShellNavbar;
+    Aside: typeof AppShellAside;
+    Footer: typeof AppShellFooter;
+    BottomNav: typeof AppShellBottomNav;
+    BottomAppBar: typeof BottomAppBar;
+    Main: typeof AppShellMain;
+    Section: typeof AppShellSection;
+    MobileMenu: typeof MobileMenu;
+    StatusBarManager: typeof StatusBarManager;
+};
+export declare const AppShell: AppShellType;
+export {};

package/lib/components/AppShell/BottomAppBar.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { AppShellBottomNavProps } from './types';
+export declare const BottomAppBar: React.FC<AppShellBottomNavProps>;

package/lib/components/AppShell/MobileMenu.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { MobileMenuConfig } from './types';
+interface MobileMenuProps {
+    visible: boolean;
+    onClose: () => void;
+    children: React.ReactNode;
+    config?: MobileMenuConfig;
+}
+export declare const MobileMenu: React.FC<MobileMenuProps>;
+export {};

package/lib/components/AppShell/StatusBarManager.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { StatusBarConfig } from './types';
+interface StatusBarManagerProps extends StatusBarConfig {
+    children?: React.ReactNode;
+}
+export declare const StatusBarManager: React.FC<StatusBarManagerProps>;
+export {};

package/lib/components/AppShell/app-layout/AppLayoutProvider.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { AppLayoutBlueprint, AppLayoutRuntimeOverrides } from './types';
+export interface AppLayoutProviderProps {
+    blueprint: AppLayoutBlueprint;
+    value?: AppLayoutRuntimeOverrides;
+    children: React.ReactNode;
+}
+export declare const AppLayoutProvider: React.FC<AppLayoutProviderProps>;

package/lib/components/AppShell/app-layout/AppLayoutRenderer.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export interface AppLayoutRendererProps {
+    children: React.ReactNode;
+}
+export declare const AppLayoutRenderer: React.FC<AppLayoutRendererProps>;

package/lib/components/AppShell/app-layout/context.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { AppLayoutProviderValue } from './types';
+export declare const AppLayoutContext: React.Context<AppLayoutProviderValue | undefined>;
+export declare const useAppLayoutContext: () => AppLayoutProviderValue;

package/lib/components/AppShell/app-layout/defineAppLayout.d.ts

@@ -0,0 +1,2 @@
+import type { AppLayoutBlueprint } from './types';
+export declare const defineAppLayout: <T extends AppLayoutBlueprint>(blueprint: T) => T;

package/lib/components/AppShell/app-layout/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './defineAppLayout';
+export * from './AppLayoutProvider';
+export * from './AppLayoutRenderer';
+export { useAppLayoutContext } from './context';

package/lib/components/AppShell/app-layout/types.d.ts

@@ -0,0 +1,120 @@
+import type React from 'react';
+import type { PlatformOSType } from 'react-native';
+import type { ResponsiveSize, Breakpoint, StatusBarConfig } from '../types';
+export type LayoutVisibilityFn = (ctx: AppLayoutRuntimeContext) => boolean;
+export interface LayoutComponentEntry<Props = any> {
+    component: React.ComponentType<Props>;
+    props?: Props | ((ctx: AppLayoutRuntimeContext) => Props);
+    show?: LayoutVisibilityFn;
+    key?: string;
+    target?: 'shell' | 'root' | 'root-before' | 'root-after';
+}
+export interface LayoutRenderEntry {
+    render: (ctx: AppLayoutRuntimeContext) => React.ReactNode;
+    show?: LayoutVisibilityFn;
+    key?: string;
+    target?: 'shell' | 'root' | 'root-before' | 'root-after';
+}
+export type LayoutEntry<Props = any> = LayoutComponentEntry<Props> | LayoutRenderEntry;
+export type LayoutComponentOrRenderEntry<Props = any> = LayoutEntry<Props>;
+export interface LayoutBreakpointsConfig {
+    headerHeight?: ResponsiveSize;
+    navbarWidth?: ResponsiveSize;
+    asideWidth?: ResponsiveSize;
+    footerHeight?: ResponsiveSize;
+    bottomNavHeight?: ResponsiveSize;
+    padding?: ResponsiveSize;
+}
+export interface LayoutNavbarConfig extends LayoutComponentEntry {
+    width?: ResponsiveSize;
+    collapsedWidth?: number;
+    expandOnHover?: boolean;
+    startCollapsedDesktop?: boolean;
+}
+export interface LayoutAsideConfig extends LayoutComponentEntry {
+    width?: ResponsiveSize;
+}
+export interface LayoutFooterConfig extends LayoutComponentEntry {
+    height?: ResponsiveSize;
+}
+export interface LayoutBottomNavConfig extends LayoutComponentEntry {
+    height?: ResponsiveSize;
+}
+export interface LayoutMainConfig {
+    id?: string;
+    role?: string;
+    maxWidth?: number | string;
+    centerContent?: boolean;
+    tableOfContents?: LayoutEntry;
+    hideTableOfContentsOnMobile?: boolean;
+    tableOfContentsWidth?: number | string;
+    tableOfContentsWithBorder?: boolean;
+    props?: Record<string, any> | ((ctx: AppLayoutRuntimeContext) => Record<string, any>);
+}
+export interface LayoutOptions {
+    withSafeArea?: boolean;
+    withBorder?: boolean;
+    backgroundColor?: string;
+    padding?: ResponsiveSize;
+    style?: any;
+    statusBar?: StatusBarConfig;
+    transitionDuration?: number;
+    transitionTimingFunction?: string;
+    disabled?: boolean;
+    testID?: string;
+}
+export type LayoutSection = 'header' | 'navbar' | 'aside' | 'footer' | 'bottomNav';
+export type AppLayoutEffect = (ctx: AppLayoutRuntimeContext) => void | (() => void);
+export interface AppLayoutBlueprint {
+    id: string;
+    breakpoints?: LayoutBreakpointsConfig;
+    header?: LayoutComponentOrRenderEntry;
+    navbar?: LayoutNavbarConfig;
+    aside?: LayoutAsideConfig;
+    footer?: LayoutFooterConfig;
+    bottomNav?: LayoutBottomNavConfig;
+    overlays?: LayoutEntry[];
+    effects?: AppLayoutEffect[];
+    main?: LayoutMainConfig;
+    layout?: LayoutOptions;
+    visibility?: Partial<Record<LayoutSection, LayoutVisibilityFn>>;
+    meta?: Record<string, unknown>;
+}
+export interface AppLayoutNavigation {
+    push?: (path: string) => void;
+    replace?: (path: string) => void;
+    goBack?: () => void;
+    open?: (path: string) => void;
+}
+export interface AppLayoutRuntimeOverrides {
+    query?: Record<string, string | string[] | undefined>;
+    pathname?: string;
+    navigation?: AppLayoutNavigation;
+    platform?: PlatformOSType;
+    meta?: Record<string, unknown>;
+}
+export interface AppLayoutRuntimeContext {
+    blueprint: AppLayoutBlueprint;
+    query: Record<string, string | string[] | undefined>;
+    pathname?: string;
+    navigation?: AppLayoutNavigation;
+    platform: PlatformOSType;
+    breakpoint: Breakpoint;
+    isMobile: boolean;
+    isLandscape: boolean;
+    orientation: 'portrait' | 'landscape';
+    theme: any;
+    colorScheme: string | undefined;
+    reducedMotion: boolean;
+    meta?: Record<string, unknown>;
+}
+export interface AppLayoutProviderValue {
+    blueprint: AppLayoutBlueprint;
+    runtime: {
+        query: Record<string, string | string[] | undefined>;
+        pathname?: string;
+        navigation?: AppLayoutNavigation;
+        platform: PlatformOSType;
+        meta?: Record<string, unknown>;
+    };
+}