@almadar/ui 5.111.0 → 5.113.0

package/dist/marketing/index.d.ts

@@ -1,72 +0,0 @@
-/**
- * @almadar/ui/marketing
- *
- * SSR-safe subset of @almadar/ui for marketing/documentation sites.
- * Contains only the atoms and molecules used in Docusaurus pages.
- * No game engines, no Three.js, no browser-only APIs at module scope.
- */
-export { Box } from '../components/core/atoms/Box';
-export { VStack, HStack } from '../components/core/atoms/Stack';
-export { Typography } from '../components/core/atoms/Typography';
-export { Button } from '../components/core/atoms/Button';
-export { Badge } from '../components/core/atoms/Badge';
-export { Icon } from '../components/core/atoms/Icon';
-export { Card } from '../components/core/atoms/Card';
-export { Divider } from '../components/core/atoms/Divider';
-export { Center } from '../components/core/atoms/Center';
-export { Spacer } from '../components/core/atoms/Spacer';
-export { ContentSection } from '../components/marketing/atoms/ContentSection';
-export type { ContentSectionProps } from '../components/marketing/atoms/ContentSection';
-export { HeroSection } from '../components/marketing/molecules/HeroSection';
-export type { HeroSectionProps } from '../components/marketing/molecules/HeroSection';
-export { CTABanner } from '../components/marketing/molecules/CTABanner';
-export type { CTABannerProps } from '../components/marketing/molecules/CTABanner';
-export { FeatureCard } from '../components/marketing/molecules/FeatureCard';
-export type { FeatureCardProps } from '../components/marketing/molecules/FeatureCard';
-export { FeatureGrid } from '../components/core/molecules/FeatureGrid';
-export type { FeatureGridProps } from '../components/core/molecules/FeatureGrid';
-export { PricingCard } from '../components/marketing/molecules/PricingCard';
-export type { PricingCardProps } from '../components/marketing/molecules/PricingCard';
-export { PricingGrid } from '../components/marketing/molecules/PricingGrid';
-export type { PricingGridProps } from '../components/marketing/molecules/PricingGrid';
-export { SplitSection } from '../components/marketing/molecules/SplitSection';
-export type { SplitSectionProps } from '../components/marketing/molecules/SplitSection';
-export { InstallBox } from '../components/marketing/molecules/InstallBox';
-export type { InstallBoxProps } from '../components/marketing/molecules/InstallBox';
-export { StepFlow } from '../components/marketing/molecules/StepFlow';
-export type { StepFlowProps, StepItemProps } from '../components/marketing/molecules/StepFlow';
-export { StatsGrid } from '../components/marketing/molecules/StatsGrid';
-export type { StatsGridProps } from '../components/marketing/molecules/StatsGrid';
-export { TagCloud } from '../components/marketing/molecules/TagCloud';
-export type { TagCloudProps } from '../components/marketing/molecules/TagCloud';
-export { CommunityLinks } from '../components/marketing/molecules/CommunityLinks';
-export type { CommunityLinksProps } from '../components/marketing/molecules/CommunityLinks';
-export { ServiceCatalog } from '../components/marketing/molecules/ServiceCatalog';
-export type { ServiceCatalogProps } from '../components/marketing/molecules/ServiceCatalog';
-export { ShowcaseCard } from '../components/marketing/molecules/ShowcaseCard';
-export type { ShowcaseCardProps } from '../components/marketing/molecules/ShowcaseCard';
-export { TeamCard } from '../components/marketing/molecules/TeamCard';
-export type { TeamCardProps } from '../components/marketing/molecules/TeamCard';
-export { CaseStudyCard } from '../components/marketing/molecules/CaseStudyCard';
-export type { CaseStudyCardProps } from '../components/marketing/molecules/CaseStudyCard';
-export { ArticleSection } from '../components/marketing/molecules/ArticleSection';
-export type { ArticleSectionProps } from '../components/marketing/molecules/ArticleSection';
-export { SimpleGrid } from '../components/core/molecules/SimpleGrid';
-export { MarketingFooter } from '../components/marketing/molecules/MarketingFooter';
-export type { MarketingFooterProps, FooterLinkColumn, FooterLinkItem } from '../components/marketing/molecules/MarketingFooter';
-export { GradientDivider } from '../components/core/molecules/GradientDivider';
-export type { GradientDividerProps } from '../components/core/molecules/GradientDivider';
-export { PullQuote } from '../components/marketing/molecules/PullQuote';
-export type { PullQuoteProps } from '../components/marketing/molecules/PullQuote';
-export { AnimatedCounter } from '../components/core/molecules/AnimatedCounter';
-export type { AnimatedCounterProps } from '../components/core/molecules/AnimatedCounter';
-export { AnimatedReveal } from '../components/marketing/atoms/AnimatedReveal';
-export type { AnimatedRevealProps, RevealTrigger, RevealAnimation } from '../components/marketing/atoms/AnimatedReveal';
-export { AnimatedGraphic } from '../components/marketing/atoms/AnimatedGraphic';
-export type { AnimatedGraphicProps, GraphicAnimation } from '../components/marketing/atoms/AnimatedGraphic';
-export { PatternTile, getTileDimensions } from '../components/marketing/atoms/PatternTile';
-export type { PatternTileProps, PatternVariant } from '../components/marketing/atoms/PatternTile';
-export { GeometricPattern } from '../components/marketing/molecules/GeometricPattern';
-export type { GeometricPatternProps } from '../components/marketing/molecules/GeometricPattern';
-export { EdgeDecoration } from '../components/core/molecules/EdgeDecoration';
-export type { EdgeDecorationProps, EdgeVariant, EdgeSide } from '../components/core/molecules/EdgeDecoration';

package/dist/providers/CurrentPagePathContext.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-declare const CurrentPagePathContext: React.Context<string | undefined>;
-export interface CurrentPagePathProviderProps {
-    value: string | undefined;
-    children: React.ReactNode;
-}
-export declare const CurrentPagePathProvider: React.FC<CurrentPagePathProviderProps>;
-export declare const useCurrentPagePath: () => string | undefined;
-export { CurrentPagePathContext };

package/dist/providers/DesignThemeContext.d.ts

@@ -1,21 +0,0 @@
-/** @deprecated Use ThemeDefinition from ThemeContext */
-export type DesignTheme = string;
-/**
- * @deprecated Use ThemeProvider from ThemeContext instead
- */
-export declare const DesignThemeProvider: import("react").FC<import("./ThemeContext").ThemeProviderProps>;
-/**
- * @deprecated Use useTheme from ThemeContext instead
- *
- * This wrapper provides backward compatibility with the old API.
- */
-export declare function useDesignTheme(): {
-    designTheme: string;
-    setDesignTheme: (theme: string) => void;
-    availableThemes: string[];
-};
-declare const _default: {
-    DesignThemeProvider: import("react").FC<import("./ThemeContext").ThemeProviderProps>;
-    useDesignTheme: typeof useDesignTheme;
-};
-export default _default;

package/dist/providers/EntitySchemaContext.d.ts

@@ -1,81 +0,0 @@
-/**
- * EntitySchemaContext
- *
- * Minimal context providing entity schema definitions (field metadata).
- * This is NOT a data store — actual entity rows flow through the state
- * machine's `@payload.data` binding on the emitting trait's fetch-success
- * transition and land on the rendering component's `entity` prop.
- *
- * Replaces EntityStore's schema functionality without the mock data generation.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { ResolvedEntity } from '@almadar/core';
-export interface EntitySchemaContextValue {
-    /** Entity definitions (schema metadata only) */
-    entities: Map<string, ResolvedEntity>;
-    /**
-     * Per-trait linkedEntity name. `ResolvedTrait` itself doesn't carry
-     * linkedEntity (it lives on `ResolvedTraitBinding` at the page-binding
-     * level), so OrbPreview pre-projects every page's trait bindings into
-     * a flat `traitName → entityName` map for the slot renderer.
-     *
-     * Used by SlotContentRenderer to resolve `entityDef` via
-     * `traitLinkedEntities.get(sourceTrait) → entities.get(...)` when the
-     * rendered pattern's `entity:` prop is a resolved value (V2 path)
-     * rather than a string entity-name. Without this lookup, form-section
-     * can't enrich its fields with entity field metadata (values enum,
-     * etc.) and an enum field renders as a plain text input. Closes VR3.
-     */
-    traitLinkedEntities: ReadonlyMap<string, string>;
-    /**
-     * Per-trait owning-orbital name. Same shape as `traitLinkedEntities`,
-     * built from `schema.orbitals[].traits[]`. UISlotRenderer uses this
-     * to wrap each slot's rendered subtree in `TraitScopeProvider` so
-     * descendant pure components (Button, etc.) emit qualified
-     * `UI:Orbital.Trait.EVENT` keys via the scoped useEventBus.
-     */
-    orbitalsByTrait: ReadonlyMap<string, string>;
-}
-export interface EntitySchemaProviderProps {
-    /** Entity definitions from resolved schema */
-    entities: ResolvedEntity[];
-    /**
-     * Per-trait linkedEntity name, projected from every page's
-     * ResolvedTraitBinding. Optional for back-compat; when omitted,
-     * SlotContentRenderer's enrichment path can only follow the
-     * legacy V1 string-entity-name lookup.
-     */
-    traitLinkedEntities?: ReadonlyMap<string, string>;
-    /**
-     * Per-trait owning-orbital name. Required for the runtime path's
-     * trait-scoped event qualification (Button etc. emit qualified keys
-     * via TraitScopeProvider). Optional for back-compat with consumers
-     * that don't yet thread the orbital map through.
-     */
-    orbitalsByTrait?: ReadonlyMap<string, string>;
-    /** Children */
-    children: React.ReactNode;
-}
-/**
- * Provides entity schema definitions to the component tree.
- *
- * This is a lightweight provider that only holds schema metadata (field definitions).
- * Actual entity rows arrive via `@payload.data` on the rendering trait's
- * success transition — they do NOT live in this context.
- */
-export declare function EntitySchemaProvider({ entities, traitLinkedEntities, orbitalsByTrait, children, }: EntitySchemaProviderProps): React.ReactElement;
-/**
- * Access entity schema definitions.
- * Use this for field metadata (form building, filter enrichment).
- * Actual entity rows flow via `@payload.data` on the state machine's
- * success transition — never read them from a context.
- */
-export declare function useEntitySchema(): EntitySchemaContextValue;
-/**
- * Safe version of useEntitySchema that returns null when no provider is present.
- * Used by UISlotRenderer which may render outside an EntitySchemaProvider (compiled mode).
- */
-export declare function useEntitySchemaOptional(): EntitySchemaContextValue | null;
-export default EntitySchemaProvider;

package/dist/providers/EventBusProvider.d.ts

@@ -1,47 +0,0 @@
-/**
- * EventBusProvider - React context provider for the event bus
- *
- * Provides a page-scoped event bus for trait communication.
- * Each page has its own event bus instance.
- *
- * NOTE: Selection state has been moved to SelectionProvider.
- * Use SelectionProvider for tracking selected entities.
- *
- * @packageDocumentation
- */
-import React, { type ReactNode } from 'react';
-import type { EventBusContextType } from '../types/event-bus-types';
-import type { EntityRow } from '@almadar/core';
-/**
- * Extended context type for backward compatibility.
- *
- * @deprecated getSelectedEntity and clearSelectedEntity are deprecated.
- * Use SelectionProvider and useSelection hook instead.
- */
-export interface EventBusContextTypeExtended extends EventBusContextType {
-    /** @deprecated Use useSelection from SelectionProvider instead. */
-    getSelectedEntity: () => EntityRow | null;
-    /** @deprecated Use useSelection from SelectionProvider instead. */
-    clearSelectedEntity: () => void;
-}
-export declare const EventBusContext: React.Context<EventBusContextTypeExtended | null>;
-interface EventBusProviderProps {
-    children: ReactNode;
-    /**
-     * @deprecated No-op. Logging is now gated by `@almadar/logger` —
-     * use `setLogLevel('DEBUG')` or `setNamespaceLevel('almadar:eventbus', 'DEBUG')`
-     * from `@almadar/logger` to control verbosity. Kept for API compatibility.
-     */
-    debug?: boolean;
-    /**
-     * When true, this provider does NOT register itself as the global event bus
-     * (`window.__kflowEventBus`). Use for SANDBOXED subtrees — e.g. a studio
-     * preview (`BrowserPlayground`) embedded inside a host app — whose internal
-     * events must stay context-local and must NOT clobber the host's global bus.
-     * Children still get this bus via React context; only the global bridge is
-     * skipped. Default false (root/standalone providers own the global bridge).
-     */
-    isolated?: boolean;
-}
-export declare function EventBusProvider({ children, isolated }: EventBusProviderProps): React.JSX.Element;
-export type { EventBusContextType };

package/dist/providers/GameAudioProvider.d.ts

@@ -1,53 +0,0 @@
-/**
- * GameAudioProvider
- *
- * Context provider that wires the audio system to the Almadar event bus.
- * Wrap your game organism with this provider, then emit:
- *
- *   emit('UI:PLAY_SOUND', { key: 'footstep' })
- *
- * from anywhere inside the tree and the corresponding sound will play.
- *
- * The provider also exposes `muted`/`setMuted` and `masterVolume`/
- * `setMasterVolume` via the `GameAudioContext` for toggle buttons.
- *
- * Closed-circuit props (`className`, `isLoading`, `error`) are
- * accepted but intentionally unused — the provider renders only its children.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import { type AudioManifest, type GameAudioControls } from '../hooks/useGameAudio';
-import type { UiError } from '../components/core/atoms/types';
-export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
-export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;
-/**
- * Access the game audio context.
- * Must be called from within a `<GameAudioProvider>` tree.
- */
-export declare function useGameAudioContext(): GameAudioContextValue;
-/**
- * Access the game audio context, or `null` when there is no `<GameAudioProvider>`
- * ancestor. Lets a component stay self-contained (render standalone with a local
- * fallback) — the provider is an implementation detail, never a hard precondition.
- */
-export declare function useGameAudioContextOptional(): GameAudioContextValue | null;
-export interface GameAudioProviderProps {
-    /** Sound manifest — keys mapped to SoundEntry definitions */
-    manifest: AudioManifest;
-    /** Base URL prepended to all sound paths (default '') */
-    baseUrl?: string;
-    /** Children to render */
-    children: React.ReactNode;
-    /** Initial muted state */
-    initialMuted?: boolean;
-    /** Closed-circuit props (unused, accepted for runtime compatibility) */
-    className?: string;
-    isLoading?: boolean;
-    error?: UiError | null;
-}
-export declare function GameAudioProvider({ manifest, baseUrl, children, initialMuted, }: GameAudioProviderProps): React.JSX.Element;
-export declare namespace GameAudioProvider {
-    var displayName: string;
-}
-export default GameAudioProvider;

package/dist/providers/OfflineModeProvider.d.ts

@@ -1,79 +0,0 @@
-/**
- * OfflineModeProvider
- *
- * Context provider that wraps useOfflineExecutor with force-offline toggle support.
- * Enables testing offline behavior without actually disconnecting.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import { type UseOfflineExecutorOptions, type UseOfflineExecutorResult } from '../lib/offline-executor';
-export interface OfflineModeContextValue extends UseOfflineExecutorResult {
-    /** Force offline mode for testing */
-    forceOffline: boolean;
-    /** Toggle force offline mode */
-    setForceOffline: (value: boolean) => void;
-    /** Whether effectively offline (real or forced) */
-    effectivelyOffline: boolean;
-}
-export interface OfflineModeProviderProps extends UseOfflineExecutorOptions {
-    children: React.ReactNode;
-}
-/**
- * OfflineModeProvider - Wraps offline executor with force-offline support.
- *
- * @example
- * ```tsx
- * function App() {
- *   return (
- *     <OfflineModeProvider
- *       serverUrl="/api/orbitals"
- *       authToken={token}
- *       autoSync={true}
- *       renderToSlot={slotManager.render}
- *       navigate={router.push}
- *       notify={toast.show}
- *       eventBus={{ emit: bus.emit }}
- *     >
- *       <PreviewPage />
- *     </OfflineModeProvider>
- *   );
- * }
- * ```
- */
-export declare function OfflineModeProvider({ children, ...executorOptions }: OfflineModeProviderProps): React.ReactElement;
-/**
- * Access offline mode context.
- *
- * @example
- * ```tsx
- * function OfflineToggle() {
- *   const {
- *     effectivelyOffline,
- *     forceOffline,
- *     setForceOffline,
- *     pendingCount,
- *     sync,
- *   } = useOfflineMode();
- *
- *   return (
- *     <div>
- *       <Toggle
- *         checked={forceOffline}
- *         onChange={setForceOffline}
- *       >
- *         Test Offline
- *       </Toggle>
- *       {pendingCount > 0 && <Badge>{pendingCount} pending</Badge>}
- *       <Button onClick={sync}>Sync Now</Button>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useOfflineMode(): OfflineModeContextValue;
-/**
- * Check if offline mode provider is available (optional usage).
- */
-export declare function useOptionalOfflineMode(): OfflineModeContextValue | null;
-export default OfflineModeProvider;

package/dist/providers/OrbitalProvider.d.ts

@@ -1,110 +0,0 @@
-/**
- * OrbitalProvider
- *
- * Unified provider that combines all required contexts for Orbital applications.
- * Provides a single import for both Builder preview and compiled shell.
- *
- * Combines:
- * - ThemeProvider - Theme and color mode management
- * - EventBusProvider - Page-scoped event pub/sub
- * - SelectionProvider - Selected entity tracking
- *
- * Entity data flows through props (via enrichFromResponse in ServerBridge),
- * not through context. FetchedDataProvider has been removed.
- *
- * @packageDocumentation
- */
-import React, { type ReactNode } from 'react';
-import type { EntityRow } from '@almadar/core';
-import { type UIThemeDefinition } from './ThemeContext';
-export interface OrbitalProviderProps {
-    children: ReactNode;
-    /** Custom themes (merged with built-in themes) */
-    themes?: UIThemeDefinition[];
-    /** Default theme name */
-    defaultTheme?: string;
-    /** Default color mode */
-    defaultMode?: 'light' | 'dark' | 'system';
-    /** Optional target element ref for scoped theme application */
-    targetRef?: React.RefObject<HTMLElement>;
-    /** Skip ThemeProvider (use when already inside a themed container like shadow DOM) */
-    skipTheme?: boolean;
-    /** Enable debug logging for all providers */
-    debug?: boolean;
-    /** Initial fetched data */
-    /** @deprecated No longer used. Entity data flows through server response props. */
-    initialData?: Record<string, EntityRow[]>;
-    /**
-     * Enable Suspense mode. When true, UISlotRenderer wraps each slot in
-     * `<ErrorBoundary><Suspense>` with Skeleton fallbacks.
-     * Opt-in — existing isLoading prop pattern still works when false/absent.
-     */
-    suspense?: boolean;
-    /**
-     * Enable verification wiring for visual testing.
-     * When true, lifecycle events are recorded and exposed via
-     * `window.__orbitalVerification` for Playwright/automation.
-     * Default: true in development, false in production.
-     */
-    verification?: boolean;
-    /**
-     * Sandbox mode: the event bus stays context-local and does NOT register as
-     * the global bus. Set for studio previews embedded in a host app (so the
-     * preview's events don't clobber the host's global bus). Default false.
-     */
-    isolated?: boolean;
-}
-/**
- * OrbitalProvider - Unified context provider for Orbital applications
- *
- * Wraps your application with all required providers in the correct order.
- *
- * @example
- * ```tsx
- * // Basic usage
- * function App() {
- *   return (
- *     <OrbitalProvider>
- *       <Router>
- *         <Routes />
- *       </Router>
- *     </OrbitalProvider>
- *   );
- * }
- *
- * // With configuration
- * function App() {
- *   return (
- *     <OrbitalProvider
- *       defaultTheme="minimalist"
- *       defaultMode="dark"
- *       debug={process.env.NODE_ENV === 'development'}
- *     >
- *       <Router>
- *         <Routes />
- *       </Router>
- *     </OrbitalProvider>
- *   );
- * }
- *
- * // With custom themes from schema
- * import { THEMES } from './generated/theme-manifest';
- *
- * function App() {
- *   return (
- *     <OrbitalProvider themes={THEMES} defaultTheme="ocean">
- *       <Router>
- *         <Routes />
- *       </Router>
- *     </OrbitalProvider>
- *   );
- * }
- * ```
- */
-export declare function OrbitalProvider({ children, themes, defaultTheme, defaultMode, targetRef, skipTheme, debug, initialData, suspense, verification, isolated, }: OrbitalProviderProps): React.ReactElement;
-export declare namespace OrbitalProvider {
-    var displayName: string;
-}
-export { ThemeProvider } from './ThemeContext';
-export { EventBusProvider } from './EventBusProvider';
-export { SelectionProvider } from './SelectionProvider';

package/dist/providers/OrbitalThemeProvider.d.ts

@@ -1,37 +0,0 @@
-/**
- * OrbitalThemeProvider — runtime application of `OrbitalDefinition.theme`.
- *
- * Wraps an orbital's rendered subtree in a wrapping `<div>` that sets the
- * CSS variables derived from `theme.tokens` (and `variants.dark` when the
- * resolved color mode is dark). Inline custom-property declarations on the
- * wrapper override any `[data-theme]` selector rule for the same variable
- * within the subtree, while letting unset variables cascade from the parent.
- *
- * Mapping is delegated to `themeTokensToCssVars`, which mirrors the Rust
- * compiler's `generate_tokens_css`. Compile-time and runtime produce the
- * same CSS variable map for the same `ThemeDefinition` input, so a Studio
- * Design System edit and an `orbital compile` of the same schema render
- * identically.
- *
- * No-op when:
- * - `theme` is `undefined` (orbital declares no theme — parent cascades)
- * - `theme` is a string ref that didn't get inlined upstream
- *
- * @example
- * ```tsx
- * <OrbitalThemeProvider theme={orbital.theme}>
- *   <UISlotRenderer />
- * </OrbitalThemeProvider>
- * ```
- */
-import { type ReactElement, type ReactNode } from 'react';
-import type { ThemeRef } from '@almadar/core';
-export interface OrbitalThemeProviderProps {
-    /** The `OrbitalDefinition.theme` value (inline definition or string ref). */
-    theme?: ThemeRef;
-    children: ReactNode;
-}
-export declare function OrbitalThemeProvider({ theme, children }: OrbitalThemeProviderProps): ReactElement;
-export declare namespace OrbitalThemeProvider {
-    var displayName: string;
-}

package/dist/providers/SelectionProvider.d.ts

@@ -1,82 +0,0 @@
-/**
- * SelectionProvider - Manages selected entity state
- *
- * Separates selection state from the EventBusProvider to maintain
- * clean architecture (event bus stays pure pub/sub).
- *
- * This provider:
- * - Listens to UI:VIEW and UI:SELECT events to track selected entity
- * - Listens to UI:CLOSE, UI:DESELECT, UI:CANCEL to clear selection
- * - Provides the selected entity to any component that needs it
- *
- * @packageDocumentation
- */
-import React, { type ReactNode } from 'react';
-import type { EntityRow } from '@almadar/core';
-export interface SelectionContextType<T = EntityRow> {
-    /** The currently selected entity */
-    selected: T | null;
-    /** Manually set the selected entity */
-    setSelected: (entity: T | null) => void;
-    /** Clear the selection */
-    clearSelection: () => void;
-    /** Check if an entity is selected */
-    isSelected: (entity: T) => boolean;
-}
-declare const SelectionContext: React.Context<SelectionContextType<EntityRow> | null>;
-interface SelectionProviderProps {
-    children: ReactNode;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Custom comparison function for isSelected */
-    compareEntities?: (a: EntityRow, b: EntityRow) => boolean;
-}
-/**
- * Provider component for selection state.
- *
- * Must be used within an EventBusProvider.
- *
- * @example
- * ```tsx
- * function OrderListPage() {
- *   return (
- *     <EventBusProvider>
- *       <SelectionProvider debug={process.env.NODE_ENV === 'development'}>
- *         <OrderTable />
- *         <OrderDetailDrawer />
- *       </SelectionProvider>
- *     </EventBusProvider>
- *   );
- * }
- * ```
- */
-export declare function SelectionProvider({ children, debug, compareEntities, }: SelectionProviderProps): React.JSX.Element;
-/**
- * Hook to access selection state.
- *
- * @throws Error if used outside SelectionProvider
- *
- * @example
- * ```tsx
- * function OrderDetailDrawer() {
- *   const { selected, clearSelection } = useSelection<Order>();
- *
- *   if (!selected) return null;
- *
- *   return (
- *     <Drawer onClose={clearSelection}>
- *       <OrderDetail order={selected} />
- *     </Drawer>
- *   );
- * }
- * ```
- */
-export declare function useSelection<T = EntityRow>(): SelectionContextType<T>;
-/**
- * Hook to access selection state with fallback for components
- * that may be used outside SelectionProvider.
- *
- * Returns null if no SelectionProvider is found.
- */
-export declare function useSelectionOptional<T = EntityRow>(): SelectionContextType<T> | null;
-export { SelectionContext };