@almadar/ui 5.74.0 → 5.76.0

package/dist/{hooks → types}/event-bus-types.d.ts

@@ -8,7 +8,8 @@
  * @packageDocumentation
  */
 import type { BusEvent, BusEventSource, BusEventListener, EventPayload, Unsubscribe } from "@almadar/core";
-export type { BusEvent, BusEventSource, EventPayload, Unsubscribe };
+export type { BusEvent, BusEventSource, BusEventListener, EventPayload, Unsubscribe };
+/** @deprecated Use BusEventListener from @almadar/core directly. */
 export type EventListener = BusEventListener;
 /**
  * Event bus context type.

package/dist/{renderer/types.d.ts → types/renderer-types.d.ts}

@@ -7,6 +7,7 @@
  *
  * @packageDocumentation
  */
+import type { EntityRow, FieldValue, UISlot, PatternConfig } from '@almadar/core';
 /**
  * A client effect is a tuple where the first element is the effect type
  * and the remaining elements are the arguments.
@@ -17,7 +18,8 @@
  * ['notify', 'Task created!', { type: 'success' }]
  * ['emit', 'TASK_CREATED', { id: '123' }]
  */
-export type ClientEffect = ['render-ui', string, PatternConfig | null] | ['navigate', string, Record<string, unknown>?] | ['notify', string, NotifyOptions?] | ['emit', string, unknown?];
+export type { UISlot, PatternConfig };
+export type ClientEffect = ['render-ui', string, PatternConfig | null] | ['navigate', string, Record<string, FieldValue>?] | ['notify', string, NotifyOptions?] | ['emit', string, FieldValue?];
 /**
  * Options for notify effect
  */
@@ -25,22 +27,10 @@ export interface NotifyOptions {
     type?: 'success' | 'error' | 'info' | 'warning';
     duration?: number;
 }
-/**
- * Configuration for a pattern to render in a slot.
- * This is what render-ui effects carry as their payload.
- */
-export interface PatternConfig {
-    /** Pattern type from registry (e.g., 'entity-table', 'form-section') */
-    type: string;
-    /** Entity name for data binding */
-    entity?: string;
-    /** Additional props for the pattern component */
-    [key: string]: unknown;
-}
 /**
  * Resolved pattern with component information from component-mapping.json
  */
-export interface ResolvedPattern {
+export interface MappedPattern {
     /** Component name (e.g., 'DataTable') */
     component: string;
     /** Import path for the component */
@@ -48,7 +38,7 @@ export interface ResolvedPattern {
     /** Pattern category (e.g., 'display', 'form') */
     category: string;
     /** Validated and normalized props */
-    validatedProps: Record<string, unknown>;
+    validatedProps: Record<string, FieldValue>;
 }
 /**
  * Response from server after processing an event.
@@ -60,14 +50,14 @@ export interface EventResponse {
     /** New state after transition (if transition occurred) */
     newState?: string;
     /** Data fetched by server effects (e.g., { Task: [...] }) */
-    data?: Record<string, unknown[]>;
+    data?: Record<string, EntityRow[]>;
     /** Client effects to execute (render-ui, navigate, notify, emit) */
     clientEffects?: ClientEffect[];
     /** Results of individual effect executions (for debugging) */
     effectResults?: Array<{
         effect: string;
         success: boolean;
-        data?: unknown;
+        data?: FieldValue;
         error?: string;
     }>;
     /** Error message if success is false */
@@ -87,7 +77,7 @@ export interface ClientEffectExecutorConfig {
      * Navigate to a route.
      * Called for 'navigate' effects.
      */
-    navigate: (path: string, params?: Record<string, unknown>) => void;
+    navigate: (path: string, params?: Record<string, FieldValue>) => void;
     /**
      * Show a notification.
      * Called for 'notify' effects.
@@ -98,22 +88,18 @@ export interface ClientEffectExecutorConfig {
      * Called for 'emit' effects.
      */
     eventBus: {
-        emit: (event: string, payload?: unknown) => void;
+        emit: (event: string, payload?: FieldValue) => void;
     };
     /**
      * Optional: Data from server response for render-ui.
      * Components can use this to access fetched entity data.
      */
-    data?: Record<string, unknown[]>;
+    data?: Record<string, EntityRow[]>;
     /**
      * Optional: Callback when all effects have been executed.
      */
     onComplete?: () => void;
 }
-/**
- * Valid UI slot names
- */
-export type UISlot = 'main' | 'sidebar' | 'modal' | 'drawer' | 'overlay' | 'center' | 'toast' | 'hud-top' | 'hud-bottom' | 'floating';
 /**
  * Slot type classification
  */
@@ -137,14 +123,14 @@ export interface SlotDefinition {
  */
 export interface DataContext {
     /** Server-provided data (highest priority) */
-    fetchedData?: Record<string, unknown[]>;
+    fetchedData?: Record<string, EntityRow[]>;
     /** In-memory mock data (for Builder preview) */
     entityStore?: {
-        getRecords: (entityName: string) => unknown[];
+        getRecords: (entityName: string) => EntityRow[];
     };
     /** Query singleton for filtering */
     querySingleton?: {
-        getFilters: (queryRef: string) => Record<string, unknown>;
+        getFilters: (queryRef: string) => Record<string, FieldValue>;
     };
 }
 /**
@@ -152,7 +138,7 @@ export interface DataContext {
  */
 export interface DataResolution {
     /** Resolved data array */
-    data: unknown[];
+    data: EntityRow[];
     /** Whether data is still loading */
     loading: boolean;
     /** Error if resolution failed */

package/dist/types/runtime-types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OrbitalRuntime Types
+ *
+ * Re-exports IR types from @almadar/core.
+ * This ensures runtime uses the same types as the compiler.
+ *
+ * @packageDocumentation
+ */
+export type { TransitionFrom, ResolvedField, ResolvedEntity, ResolvedEntityBinding, ResolvedTraitState, ResolvedTraitEvent, ResolvedTraitTransition, ResolvedTraitGuard, ResolvedTraitTick, ResolvedTraitDataEntity, ResolvedTraitUIBinding, ResolvedTrait, ResolvedTraitBinding, ResolvedPattern, ResolvedSectionEvent, ResolvedSection, ResolvedNavigation, ResolvedPage, ResolvedIR, } from '@almadar/core';
+import type { ResolvedTraitListener as CoreResolvedTraitListener, ListenSource } from '@almadar/core';
+export type { ListenSource };
+/**
+ * Extended `ResolvedTraitListener` carrying the runtime `source` scope
+ * descriptor. Core's `ResolvedTraitListener` includes `source?: ListenSource`
+ * starting with the version that shipped `ListenSource`; this intersection
+ * keeps the field visible even if older core builds omit it.
+ */
+export type ResolvedTraitListener = CoreResolvedTraitListener & {
+    source?: ListenSource;
+};
+export { createEmptyResolvedTrait, createEmptyResolvedPage, createResolvedField, inferTsType, isResolvedIR, } from '@almadar/core';

package/dist/{runtime/ui → types}/slot-types.d.ts

@@ -10,7 +10,8 @@
  *
  * @packageDocumentation
  */
-import type { PatternConfig, EventSource, ResolvedTrait } from '@almadar/core';
+import type { PatternConfig, EventSource, ResolvedTrait, FieldValue, SExpr } from '@almadar/core';
+import type { SlotPropValue } from '../hooks/useUISlots';
 /**
  * Slot-render observability channel. Used by `useTraitStateMachine`,
  * `OrbPreview.applyServerEffects`, and the `<SlotContentRenderer>` to
@@ -24,14 +25,14 @@ export declare const slotLog: import("@almadar/logger").Logger;
  * references across renders (e.g. spotting the form-reset bug where
  * the same logical row arrives with a fresh ref id every transition).
  */
-export declare function refId(obj: unknown): number | null;
+export declare function refId(obj: SlotPropValue | null | undefined): number | null;
 /**
  * One pattern within a slot's accumulated render-ui set, plus any
  * caller-supplied props that should be merged on top.
  */
 export interface SlotPatternEntry {
     pattern: PatternConfig;
-    props: Record<string, unknown>;
+    props: Record<string, FieldValue | undefined>;
 }
 /**
  * The originating trait + state for a slot write. Embedded in the
@@ -43,6 +44,6 @@ export interface SlotSource extends EventSource {
     trait: string;
     state: string;
     transition: string;
-    effects: unknown[];
+    effects: SExpr[];
     traitDefinition: ResolvedTrait;
 }

package/locales/index.ts

@@ -42,7 +42,7 @@ export function mergeMessages(
 }
 
 /** Remove $meta and $extends keys from a messages object */
-function stripMeta(obj: Record<string, unknown>): Record<string, string> {
+function stripMeta(obj: Record<string, string | object>): Record<string, string> {
   const result: Record<string, string> = {};
   for (const [key, value] of Object.entries(obj)) {
     if (key.startsWith('$')) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.74.0",
+  "version": "5.76.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -46,33 +46,28 @@
       "import": "./dist/runtime/index.js",
       "require": "./dist/runtime/index.cjs"
     },
-    "./stores": {
-      "types": "./dist/stores/index.d.ts",
-      "import": "./dist/stores/index.js",
-      "require": "./dist/stores/index.cjs"
-    },
     "./lib": {
       "types": "./dist/lib/index.d.ts",
       "import": "./dist/lib/index.js",
       "require": "./dist/lib/index.cjs"
     },
     "./components/organisms/game/three": {
-      "types": "./dist/components/game/molecules/three/index.d.ts",
-      "import": "./dist/components/game/molecules/three/index.js",
-      "require": "./dist/components/game/molecules/three/index.cjs"
+      "types": "./dist/components/game/3d/index.d.ts",
+      "import": "./dist/components/game/3d/index.js",
+      "require": "./dist/components/game/3d/index.cjs"
     },
     "./components/molecules/game/three": {
-      "types": "./dist/components/game/molecules/three/index.d.ts",
-      "import": "./dist/components/game/molecules/three/index.js",
-      "require": "./dist/components/game/molecules/three/index.cjs"
+      "types": "./dist/components/game/3d/index.d.ts",
+      "import": "./dist/components/game/3d/index.js",
+      "require": "./dist/components/game/3d/index.cjs"
     },
     "./components/organisms/game/TraitStateViewer": {
-      "import": "./components/game/organisms/TraitStateViewer.tsx",
-      "types": "./components/game/organisms/TraitStateViewer.tsx"
+      "import": "./components/game/2d/TraitStateViewer.tsx",
+      "types": "./components/game/2d/TraitStateViewer.tsx"
     },
     "./components/organisms/game/TraitSlot": {
-      "import": "./components/game/organisms/TraitSlot.tsx",
-      "types": "./components/game/organisms/TraitSlot.tsx"
+      "import": "./components/game/2d/TraitSlot.tsx",
+      "types": "./components/game/2d/TraitSlot.tsx"
     },
     "./templates": {
       "import": "./templates/index.ts",
@@ -83,11 +78,6 @@
       "import": "./dist/marketing/index.js",
       "require": "./dist/marketing/index.cjs"
     },
-    "./docs": {
-      "types": "./dist/docs/index.d.ts",
-      "import": "./dist/docs/index.js",
-      "require": "./dist/docs/index.cjs"
-    },
     "./avl": {
       "types": "./dist/avl/index.d.ts",
       "import": "./dist/avl/index.js",
@@ -129,16 +119,15 @@
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",
     "build:watch": "tsup --watch",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build -o storybook-static",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --no-warn-ignored --max-warnings 0 ."
   },
   "dependencies": {
     "@almadar/core": "^10.8.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/logger": "^1.3.0",
     "@almadar/patterns": ">=2.35.0",
-    "@almadar/runtime": "^6.7.0",
+    "@almadar/runtime": "^6.15.2",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@dnd-kit/core": "^6.3.1",
@@ -192,11 +181,6 @@
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.0",
     "@react-three/postprocessing": "3.0.4",
-    "@storybook/addon-docs": "^10.2.6",
-    "@storybook/addon-links": "^10.2.6",
-    "@storybook/addon-themes": "^10.2.6",
-    "@storybook/react": "^10.2.6",
-    "@storybook/react-vite": "^10.2.6",
     "@tailwindcss/container-queries": "^0.1.1",
     "@tanstack/react-query": "^5.0.0",
     "@testing-library/jest-dom": "^6.4.0",
@@ -223,7 +207,6 @@
     "react-compiler-runtime": "19.0.0-beta-af1b7da-20250417",
     "react-dom": "^19.0.0",
     "react-router-dom": "^7.13.0",
-    "storybook": "^10.2.6",
     "tailwindcss": "^3.4.0",
     "three": "^0.160.1",
     "tsup": "^8.0.0",

package/dist/components/core/atoms/ThemeSelector.d.ts

@@ -1,21 +0,0 @@
-/**
- * ThemeSelector - Design theme selector component
- *
- * A dropdown/toggle component for switching between design themes.
- *
- * @packageDocumentation
- */
-import React from "react";
-interface ThemeSelectorProps {
-    /** Optional className */
-    className?: string;
-    /** Show as dropdown or buttons */
-    variant?: "dropdown" | "buttons";
-    /** Show labels */
-    showLabels?: boolean;
-}
-/**
- * ThemeSelector component for switching design themes
- */
-export declare const ThemeSelector: React.FC<ThemeSelectorProps>;
-export default ThemeSelector;

package/dist/components/game/atoms/HealthBar.d.ts

@@ -1,18 +0,0 @@
-export interface HealthBarProps {
-    /** Current health value */
-    current: number;
-    /** Maximum health value */
-    max: number;
-    /** Display format */
-    format?: 'hearts' | 'bar' | 'numeric';
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Additional CSS classes */
-    className?: string;
-    /** Animation on change */
-    animated?: boolean;
-}
-export declare function HealthBar({ current, max, format, size, className, animated, }: HealthBarProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace HealthBar {
-    var displayName: string;
-}

package/dist/components/game/atoms/XPBar.d.ts

@@ -1,20 +0,0 @@
-export interface XPBarProps {
-    /** Current XP value */
-    current: number;
-    /** XP needed for next level */
-    max: number;
-    /** Current level */
-    level?: number;
-    /** Whether to show the XP label */
-    showLabel?: boolean;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Animate the fill bar with a CSS transition */
-    animated?: boolean;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function XPBar({ current, max, level, showLabel, size, animated, className, }: XPBarProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace XPBar {
-    var displayName: string;
-}

package/dist/components/game/atoms/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * Game Atom Components
- *
- * Basic building blocks for game UI.
- *
- * @packageDocumentation
- */
-export { HealthBar, type HealthBarProps } from './HealthBar';
-export { ScoreDisplay, type ScoreDisplayProps } from './ScoreDisplay';
-export { ControlButton, type ControlButtonProps } from './ControlButton';
-export { Sprite, drawSprite, type SpriteProps } from './Sprite';
-export { StateIndicator, type StateIndicatorProps, type StateStyle } from './StateIndicator';
-export { TimerDisplay, type TimerDisplayProps } from './TimerDisplay';
-export { ResourceCounter, type ResourceCounterProps } from './ResourceCounter';
-export { ItemSlot, type ItemSlotProps } from './ItemSlot';
-export { TurnIndicator, type TurnIndicatorProps } from './TurnIndicator';
-export { ComboCounter, type ComboCounterProps } from './ComboCounter';
-export { XPBar, type XPBarProps } from './XPBar';
-export { WaypointMarker, type WaypointMarkerProps } from './WaypointMarker';
-export { StatusEffect, type StatusEffectProps } from './StatusEffect';
-export { DamageNumber, type DamageNumberProps } from './DamageNumber';
-export { DialogueBubble, type DialogueBubbleProps } from './DialogueBubble';
-export { ChoiceButton, type ChoiceButtonProps } from './ChoiceButton';
-export { ActionButton, type ActionButtonProps } from './ActionButton';
-export { MiniMap, type MiniMapProps } from './MiniMap';

package/dist/components/game/molecules/ActionButtons.d.ts

@@ -1,38 +0,0 @@
-import type { EventEmit } from '@almadar/core';
-import type { IconInput } from '../../core/atoms';
-export interface ActionButtonConfig {
-    /** Unique identifier */
-    id: string;
-    /** Display label */
-    label?: string;
-    /** Icon component or emoji */
-    icon?: IconInput;
-    /** Button variant */
-    variant?: 'primary' | 'secondary' | 'ghost' | string;
-}
-/** Event Contract:
- *  Emits: UI:ACTION
- */
-export interface ActionButtonsProps {
-    /** Button configurations */
-    buttons: ActionButtonConfig[];
-    /** Called when a button is pressed/released */
-    onAction?: (id: string, pressed: boolean) => void;
-    /** Declarative event name emitted on action via useEventBus */
-    actionEvent?: EventEmit<{
-        id: string;
-        pressed: boolean;
-    }>;
-    /** Layout variant */
-    layout?: 'horizontal' | 'vertical' | 'diamond';
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Additional CSS classes */
-    className?: string;
-    /** Disabled state */
-    disabled?: boolean;
-}
-export declare function ActionButtons({ buttons, onAction, actionEvent, layout, size, className, disabled, }: ActionButtonsProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace ActionButtons {
-    var displayName: string;
-}

package/dist/components/game/molecules/CardHand.d.ts

@@ -1,35 +0,0 @@
-import * as React from 'react';
-import type { Asset, EventEmit } from '@almadar/core';
-/** One playable card (icon + title + a few stat numbers). UI value DTO. */
-export interface CardHandCard {
-    id: string;
-    iconUrl?: Asset;
-    title?: string;
-    cost?: number;
-    attack?: number;
-    defense?: number;
-    disabled?: boolean;
-}
-export interface CardHandProps {
-    /** Cards to lay out as a horizontal hand (or grid when wrapped). */
-    cards: CardHandCard[];
-    /** Currently selected card id. */
-    selectedId?: string;
-    /** Card-art size variant. */
-    size?: 'sm' | 'md' | 'lg';
-    /** Direct callback when a (non-disabled) card is clicked. */
-    onCardClick?: (id: string) => void;
-    /** Event-bus event emitted with `{ cardId }` on click. */
-    cardClickEvent?: EventEmit<{
-        cardId: string;
-    }>;
-    /** Empty-state label when there are no cards. */
-    emptyLabel?: string;
-    className?: string;
-}
-/** Pure card-hand molecule: renders a row/grid of cards from props alone. */
-export declare function CardHand({ cards, selectedId, size, onCardClick, cardClickEvent, emptyLabel, className, }: CardHandProps): React.JSX.Element;
-export declare namespace CardHand {
-    var displayName: string;
-}
-export default CardHand;

package/dist/components/game/molecules/CombatLog.d.ts

@@ -1,30 +0,0 @@
-/**
- * CombatLog Component
- *
- * Scrollable log of combat events with icons and colors.
- * Generalized from Trait Wars — removed asset manifest coupling.
- */
-import React from 'react';
-export type CombatLogEventType = 'attack' | 'defend' | 'heal' | 'move' | 'special' | 'death' | 'spawn';
-export interface CombatEvent {
-    id: string;
-    type: CombatLogEventType;
-    message: string;
-    timestamp: number;
-    actorName?: string;
-    targetName?: string;
-    value?: number;
-    turn?: number;
-}
-export interface CombatLogProps {
-    events: CombatEvent[];
-    maxVisible?: number;
-    autoScroll?: boolean;
-    showTimestamps?: boolean;
-    title?: string;
-    className?: string;
-}
-export declare function CombatLog({ events, maxVisible, autoScroll, showTimestamps, className, title, }: CombatLogProps): React.JSX.Element;
-export declare namespace CombatLog {
-    var displayName: string;
-}

package/dist/components/game/molecules/CraftingRecipe.d.ts

@@ -1,40 +0,0 @@
-import type { EventEmit } from '@almadar/core';
-import { type IconInput } from '../../core/atoms/Icon';
-export type CraftingIngredient = {
-    /** Icon component or emoji */
-    icon?: IconInput;
-    /** Ingredient label */
-    label: string;
-    /** Number required for the recipe */
-    required: number;
-    /** Number currently available */
-    available: number;
-};
-export type CraftingOutput = {
-    /** Icon component or emoji */
-    icon?: IconInput;
-    /** Output item label */
-    label: string;
-    /** Rarity tier */
-    rarity?: string;
-};
-export interface CraftingRecipeProps {
-    /** Input ingredients for the recipe */
-    inputs: CraftingIngredient[];
-    /** Output item produced by the recipe */
-    output: CraftingOutput;
-    /** Whether the player has enough ingredients to craft */
-    canCraft?: boolean;
-    /** Callback when the craft button is clicked */
-    onCraft?: () => void;
-    /** Event bus event name for crafting */
-    craftEvent?: EventEmit<{
-        output: string;
-    }>;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function CraftingRecipe({ inputs, output, canCraft, onCraft, craftEvent, className, }: CraftingRecipeProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace CraftingRecipe {
-    var displayName: string;
-}

package/dist/components/game/molecules/DPad.d.ts

@@ -1,26 +0,0 @@
-import type { EventEmit } from '@almadar/core';
-export type DPadDirection = 'up' | 'down' | 'left' | 'right';
-/** Event Contract:
- *  Emits: UI:DIRECTION
- */
-export interface DPadProps {
-    /** Called when a direction is pressed/released */
-    onDirection?: (direction: DPadDirection, pressed: boolean) => void;
-    /** Declarative event name emitted on direction press/release via useEventBus */
-    directionEvent?: EventEmit<{
-        direction: DPadDirection;
-        pressed: boolean;
-    }>;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Whether to include diagonal buttons */
-    includeDiagonals?: boolean;
-    /** Additional CSS classes */
-    className?: string;
-    /** Disabled state */
-    disabled?: boolean;
-}
-export declare function DPad({ onDirection, directionEvent, size, includeDiagonals, className, disabled, }: DPadProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace DPad {
-    var displayName: string;
-}

package/dist/components/game/molecules/DialogueBox.d.ts

@@ -1,66 +0,0 @@
-/**
- * DialogueBox Component
- *
- * NPC dialogue display with typewriter effect and choices.
- *
- * **State categories (closed-circuit compliant):**
- * - Content (dialogue node, speaker, text, choices) → received via props
- * - UI-transient animation (displayedText, isTyping, charIndex, selectedChoice) → local only
- * - Events → emitted via `useEventBus()` (complete, choice, advance)
- *
- * Local state is typewriter animation only — an inherently rendering-only
- * concern analogous to Form's `formData`.
- */
-import React from 'react';
-import type { Asset, EventEmit, EventPayload } from '@almadar/core';
-export type DialogueChoice = EventPayload & {
-    text: string;
-    action?: string;
-    next?: string;
-    disabled?: boolean;
-};
-export type DialogueNode = {
-    id?: string;
-    speaker: string;
-    text: string;
-    portrait?: string;
-    choices?: DialogueChoice[];
-    autoAdvance?: number;
-};
-/** Event Contract:
- *  Emits: UI:COMPLETE
- *  Emits: UI:CHOICE
- *  Emits: UI:ADVANCE
- */
-export interface DialogueBoxProps {
-    /** Current dialogue node to display */
-    dialogue: DialogueNode;
-    /** Typewriter speed in ms per character (0 = instant) */
-    typewriterSpeed?: number;
-    /** Position of dialogue box */
-    position?: 'top' | 'bottom';
-    /** Called when text animation completes */
-    onComplete?: () => void;
-    /** Called when a choice is selected */
-    onChoice?: (choice: DialogueChoice) => void;
-    /** Called when dialogue is advanced (no choices) */
-    onAdvance?: () => void;
-    /** Declarative event: emits UI:{completeEvent} when text animation completes */
-    completeEvent?: EventEmit<Record<string, never>>;
-    /** Declarative event: emits UI:{choiceEvent} with { choice: DialogueChoice } when a choice is selected */
-    choiceEvent?: EventEmit<{
-        choice: DialogueChoice;
-    }>;
-    /** Declarative event: emits UI:{advanceEvent} when dialogue is advanced */
-    advanceEvent?: EventEmit<Record<string, never>>;
-    /** Optional full-frame scene image rendered behind the dialogue (visual-novel mode). */
-    backgroundImage?: Asset;
-    /** Optional larger character portrait rendered standing over the scene (visual-novel mode). */
-    portraitUrl?: Asset;
-    /** Multiplier for the large `portraitUrl` height relative to its default (default 1). */
-    portraitScale?: number;
-    /** Optional className */
-    className?: string;
-}
-export declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, completeEvent, choiceEvent, advanceEvent, backgroundImage, portraitUrl, portraitScale, className, }: DialogueBoxProps): React.JSX.Element;
-export default DialogueBox;