@almadar/ui 2.0.1 → 2.0.3

package/dist/components/organisms/layout/DashboardGrid.d.ts

@@ -1,34 +0,0 @@
-/**
- * DashboardGrid Component
- *
- * Multi-column grid for widgets and stats cards.
- * Supports cell spanning for flexible dashboard layouts.
- *
- * Uses wireframe theme styling (high contrast, sharp edges).
- */
-import React from "react";
-export interface DashboardGridCell {
-    /** Unique cell ID */
-    id: string;
-    /** Content to render in the cell */
-    content: React.ReactNode;
-    /** Number of columns this cell spans (1-4) */
-    colSpan?: 1 | 2 | 3 | 4;
-    /** Number of rows this cell spans (1-2) */
-    rowSpan?: 1 | 2;
-}
-export interface DashboardGridProps {
-    /** Number of columns */
-    columns?: 2 | 3 | 4;
-    /** Gap between cells */
-    gap?: "sm" | "md" | "lg";
-    /** Cell definitions */
-    cells: DashboardGridCell[];
-    /** Additional CSS classes */
-    className?: string;
-}
-/**
- * DashboardGrid - Multi-column widget grid
- */
-export declare const DashboardGrid: React.FC<DashboardGridProps>;
-export default DashboardGrid;

package/dist/components/organisms/layout/MasterDetail.d.ts

@@ -1,32 +0,0 @@
-/**
- * MasterDetail Component
- *
- * Classic master-detail pattern with a list on the left
- * and selected item detail on the right.
- *
- * Uses wireframe theme styling (high contrast, sharp edges).
- */
-import React from "react";
-export interface MasterDetailProps {
-    /** Master panel content (usually a list) */
-    master: React.ReactNode;
-    /** Detail panel content */
-    detail: React.ReactNode;
-    /** Content shown when nothing is selected */
-    emptyDetail?: React.ReactNode;
-    /** Whether an item is currently selected */
-    hasSelection?: boolean;
-    /** Width of master panel (e.g., '350px', '30%') */
-    masterWidth?: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Class for master pane */
-    masterClassName?: string;
-    /** Class for detail pane */
-    detailClassName?: string;
-}
-/**
- * MasterDetail - List + detail split layout
- */
-export declare const MasterDetail: React.FC<MasterDetailProps>;
-export default MasterDetail;

package/dist/components/organisms/layout/SplitPane.d.ts

@@ -1,34 +0,0 @@
-/**
- * SplitPane Component
- *
- * Two-pane resizable split layout for master-detail views,
- * dual-pane editors, and code + preview layouts.
- *
- * Uses wireframe theme styling (high contrast, sharp edges).
- */
-import React from "react";
-export interface SplitPaneProps {
-    /** Direction of the split */
-    direction?: "horizontal" | "vertical";
-    /** Initial ratio (0-100, percentage of first pane) */
-    ratio?: number;
-    /** Minimum size of either pane in pixels */
-    minSize?: number;
-    /** Allow user resizing */
-    resizable?: boolean;
-    /** Content for the left/top pane */
-    left: React.ReactNode;
-    /** Content for the right/bottom pane */
-    right: React.ReactNode;
-    /** Additional CSS classes */
-    className?: string;
-    /** Class for left/top pane */
-    leftClassName?: string;
-    /** Class for right/bottom pane */
-    rightClassName?: string;
-}
-/**
- * SplitPane - Two-pane resizable layout
- */
-export declare const SplitPane: React.FC<SplitPaneProps>;
-export default SplitPane;

package/dist/components/organisms/layout/TabbedContainer.d.ts

@@ -1,42 +0,0 @@
-/**
- * TabbedContainer Component
- *
- * Tabbed content areas with shared header/context.
- * Wraps the Tabs molecule with layout-specific styling.
- *
- * Uses wireframe theme styling (high contrast, sharp edges).
- */
-import React from "react";
-export interface TabDefinition {
-    /** Tab identifier */
-    id: string;
-    /** Tab label */
-    label: string;
-    /** Tab content (optional if using sectionId) */
-    content?: React.ReactNode;
-    /** Section ID to render (alternative to content) */
-    sectionId?: string;
-    /** Optional badge/count */
-    badge?: string | number;
-    /** Disable this tab */
-    disabled?: boolean;
-}
-export interface TabbedContainerProps {
-    /** Tab definitions */
-    tabs: TabDefinition[];
-    /** Default active tab ID */
-    defaultTab?: string;
-    /** Controlled active tab */
-    activeTab?: string;
-    /** Callback when tab changes */
-    onTabChange?: (tabId: string) => void;
-    /** Tab position */
-    position?: "top" | "left";
-    /** Additional CSS classes */
-    className?: string;
-}
-/**
- * TabbedContainer - Tabbed content areas
- */
-export declare const TabbedContainer: React.FC<TabbedContainerProps>;
-export default TabbedContainer;

package/dist/components/organisms/layout/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Layout organisms index
- *
- * Export layout pattern components for adaptive UI.
- */
-export { SplitPane, type SplitPaneProps } from './SplitPane';
-export { MasterDetail, type MasterDetailProps } from './MasterDetail';
-export { DashboardGrid, type DashboardGridProps, type DashboardGridCell } from './DashboardGrid';
-export { TabbedContainer, type TabbedContainerProps, type TabDefinition } from './TabbedContainer';

package/dist/components/organisms/types.d.ts

@@ -1,65 +0,0 @@
-/**
- * Shared types for entity-display organisms.
- *
- * All entity-display organisms (DataTable, List, Table, CardGrid, DetailPanel)
- * extend EntityDisplayProps to guarantee a uniform prop contract.
- *
- * Exception: Form manages local `formData` state for field input tracking.
- * This is the ONE allowed exception — documented here.
- */
-export declare const EntityDisplayEvents: {
-    readonly SORT: "SORT";
-    readonly PAGINATE: "PAGINATE";
-    readonly SEARCH: "SEARCH";
-    readonly FILTER: "FILTER";
-    readonly CLEAR_FILTERS: "CLEAR_FILTERS";
-    readonly SELECT: "SELECT";
-    readonly DESELECT: "DESELECT";
-};
-export interface SortPayload {
-    field: string;
-    direction: 'asc' | 'desc';
-}
-export interface PaginatePayload {
-    page: number;
-    pageSize?: number;
-}
-export interface SearchPayload {
-    query: string;
-}
-export interface FilterPayload {
-    field: string;
-    operator: string;
-    value: unknown;
-}
-export interface SelectPayload {
-    ids: (string | number)[];
-}
-export interface EntityDisplayProps<T = unknown> {
-    /** Entity name for schema-driven integration */
-    entity?: string;
-    /** Data array provided by the trait via render-ui */
-    data?: readonly T[] | T[];
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Current sort field */
-    sortBy?: string;
-    /** Current sort direction */
-    sortDirection?: 'asc' | 'desc';
-    /** Current search query value */
-    searchValue?: string;
-    /** Current page number (1-indexed) */
-    page?: number;
-    /** Number of items per page */
-    pageSize?: number;
-    /** Total number of items (for pagination display) */
-    totalCount?: number;
-    /** Active filters */
-    activeFilters?: Record<string, unknown>;
-    /** Currently selected item IDs */
-    selectedIds?: readonly (string | number)[];
-}

package/dist/components/templates/AuthLayout.d.ts

@@ -1,14 +0,0 @@
-import React from "react";
-export interface AuthLayoutProps {
-    /** App name */
-    appName?: string;
-    /** Logo component or URL */
-    logo?: React.ReactNode;
-    /** Background image URL */
-    backgroundImage?: string;
-    /** Show branding panel on the side */
-    showBranding?: boolean;
-    /** Branding panel content */
-    brandingContent?: React.ReactNode;
-}
-export declare const AuthLayout: React.FC<AuthLayoutProps>;

package/dist/components/templates/BattleTemplate.d.ts

@@ -1,25 +0,0 @@
-/**
- * BattleTemplate
- *
- * Thin declarative wrapper around BattleBoard organism.
- * All game logic (turn phases, movement animation, combat, etc.) lives in BattleBoard.
- *
- * Compliant with Almadar_Templates.md: no hooks, no callbacks, entity-only data flow.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { TemplateProps } from './types';
-import type { BattleEntity } from '../organisms/game/BattleBoard';
-export type { BattleEntity, BattlePhase, BattleUnit, BattleTile, BattleSlotContext, } from '../organisms/game/BattleBoard';
-export interface BattleTemplateProps extends TemplateProps<BattleEntity> {
-    /** Canvas render scale */
-    scale?: number;
-    /** Unit draw-size multiplier */
-    unitScale?: number;
-}
-export declare function BattleTemplate({ entity, scale, unitScale, className, }: BattleTemplateProps): React.JSX.Element;
-export declare namespace BattleTemplate {
-    var displayName: string;
-}
-export default BattleTemplate;

package/dist/components/templates/CastleTemplate.d.ts

@@ -1,23 +0,0 @@
-/**
- * CastleTemplate
- *
- * Thin declarative wrapper around CastleBoard organism.
- * All game logic (hover state, feature selection, etc.) lives in CastleBoard.
- *
- * Compliant with Almadar_Templates.md: no hooks, no callbacks, entity-only data flow.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { TemplateProps } from './types';
-import type { CastleEntity } from '../organisms/game/CastleBoard';
-export type { CastleEntity, CastleSlotContext, } from '../organisms/game/CastleBoard';
-export interface CastleTemplateProps extends TemplateProps<CastleEntity> {
-    /** Canvas render scale */
-    scale?: number;
-}
-export declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React.JSX.Element;
-export declare namespace CastleTemplate {
-    var displayName: string;
-}
-export default CastleTemplate;

package/dist/components/templates/CounterTemplate.d.ts

@@ -1,44 +0,0 @@
-/**
- * CounterTemplate
- *
- * A presentational template for counter/incrementer features.
- * Supports increment, decrement, and reset operations.
- */
-import React from "react";
-import type { TemplateProps } from "./types";
-export type CounterSize = "sm" | "md" | "lg";
-export type CounterVariant = "minimal" | "standard" | "full";
-export interface CounterEntity {
-    /** Entity ID */
-    id: string;
-    /** Current count value */
-    count: number;
-    /** Whether decrement button is disabled */
-    decrementDisabled?: boolean;
-    /** Whether increment button is disabled */
-    incrementDisabled?: boolean;
-    /** Step label for decrement button (e.g. "-5") */
-    decrementLabel?: string;
-    /** Step label for increment button (e.g. "+5") */
-    incrementLabel?: string;
-    /** Formatted range text (e.g. "Range: 0 to 100") */
-    rangeText?: string;
-}
-export interface CounterTemplateProps extends TemplateProps<CounterEntity> {
-    /** Called when increment is clicked */
-    onIncrement?: () => void;
-    /** Called when decrement is clicked */
-    onDecrement?: () => void;
-    /** Called when reset is clicked */
-    onReset?: () => void;
-    /** Title displayed above the counter */
-    title?: string;
-    /** Show reset button */
-    showReset?: boolean;
-    /** Counter display size */
-    size?: CounterSize;
-    /** Template variant */
-    variant?: CounterVariant;
-}
-export declare const CounterTemplate: React.FC<CounterTemplateProps>;
-export default CounterTemplate;

package/dist/components/templates/DashboardLayout.d.ts

@@ -1,32 +0,0 @@
-import React from "react";
-import { LucideIcon } from "lucide-react";
-export interface NavItem {
-    label: string;
-    href: string;
-    icon: LucideIcon;
-    badge?: string | number;
-    children?: NavItem[];
-}
-export interface DashboardLayoutProps {
-    /** App name shown in sidebar */
-    appName?: string;
-    /** Logo component or URL */
-    logo?: React.ReactNode;
-    /** Navigation items */
-    navItems?: NavItem[];
-    /** Current user info (optional - auto-populated from auth context if not provided) */
-    user?: {
-        name: string;
-        email: string;
-        avatar?: string;
-    };
-    /** Header actions (notifications, etc.) */
-    headerActions?: React.ReactNode;
-    /** Show search in header */
-    showSearch?: boolean;
-    /** Custom sidebar footer */
-    sidebarFooter?: React.ReactNode;
-    /** Callback when user clicks sign out (optional - uses auth context signOut if not provided) */
-    onSignOut?: () => void;
-}
-export declare const DashboardLayout: React.FC<DashboardLayoutProps>;

package/dist/components/templates/GameShell.d.ts

@@ -1,33 +0,0 @@
-/**
- * GameShell
- *
- * A full-screen layout wrapper for game applications.
- * Replaces DashboardLayout for game clients — no sidebar nav, just full-viewport
- * rendering with an optional HUD overlay bar.
- *
- * Used as a React Router layout route element:
- *   <Route element={<GameShell appName="TraitWars" />}>
- *     <Route index element={<WorldMapPage />} />
- *     ...
- *   </Route>
- *
- * @generated pattern — can be customised per-game via props
- */
-import React from "react";
-export interface GameShellProps {
-    /** Application / game title shown in the HUD bar */
-    appName?: string;
-    /** Optional HUD content rendered above the main area */
-    hud?: React.ReactNode;
-    /** Extra class name on the root container */
-    className?: string;
-    /** Whether to show the minimal top bar (default: true) */
-    showTopBar?: boolean;
-}
-/**
- * Full-viewport game shell layout.
- *
- * Renders child routes via `<Outlet />` inside a full-height flex container.
- * An optional top bar shows the game title and can host HUD widgets.
- */
-export declare const GameShell: React.FC<GameShellProps>;

package/dist/components/templates/GameTemplate.d.ts

@@ -1,36 +0,0 @@
-/**
- * GameTemplate
- *
- * A presentational template for game applications.
- * Includes a main game canvas/area, HUD overlay, and an optional debug sidebar.
- * **Atomic Design**: Composed using Box, Typography, and Layout molecules/atoms.
- */
-import React from "react";
-import type { TemplateProps } from "./types";
-interface GameEntity {
-    id: string;
-    title?: string;
-}
-export interface GameTemplateProps extends TemplateProps<GameEntity> {
-    /** Title of the game */
-    title?: string;
-    /** The main game canvas or content */
-    children: React.ReactNode;
-    /** HUD overlay content (scores, health, etc.) */
-    hud?: React.ReactNode;
-    /** Debug panel content */
-    debugPanel?: React.ReactNode;
-    /** Whether the debug panel is visible */
-    showDebugPanel?: boolean;
-    /** Game controls */
-    controls?: {
-        onPlay?: () => void;
-        onPause?: () => void;
-        onReset?: () => void;
-        isPlaying?: boolean;
-    };
-    /** Additional class name */
-    className?: string;
-}
-export declare const GameTemplate: React.FC<GameTemplateProps>;
-export {};

package/dist/components/templates/GenericAppTemplate.d.ts

@@ -1,30 +0,0 @@
-/**
- * GenericAppTemplate
- *
- * A simple, generic template for any application.
- * Includes a header with title and actions, and a main content area.
- * **Atomic Design**: Composed using Box, Typography, and Button atoms.
- */
-import React from "react";
-import type { TemplateProps } from "./types";
-interface GenericAppEntity {
-    id: string;
-    title?: string;
-    subtitle?: string;
-}
-export interface GenericAppTemplateProps extends TemplateProps<GenericAppEntity> {
-    /** Page title */
-    title: string;
-    /** Subtitle or description */
-    subtitle?: string;
-    /** Main content */
-    children: React.ReactNode;
-    /** Header actions (buttons, links) */
-    headerActions?: React.ReactNode;
-    /** Footer content */
-    footer?: React.ReactNode;
-    /** Additional class name */
-    className?: string;
-}
-export declare const GenericAppTemplate: React.FC<GenericAppTemplateProps>;
-export {};

package/dist/components/templates/WorldMapTemplate.d.ts

@@ -1,29 +0,0 @@
-/**
- * WorldMapTemplate
- *
- * Thin declarative wrapper around WorldMapBoard organism.
- * All game logic (hero movement, encounters, hex conversion, etc.) lives in WorldMapBoard.
- *
- * Compliant with Almadar_Templates.md: no hooks, no callbacks, entity-only data flow.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { TemplateProps } from './types';
-import type { WorldMapEntity } from '../organisms/game/WorldMapBoard';
-export type { WorldMapEntity, MapHero, MapHex, WorldMapSlotContext, } from '../organisms/game/WorldMapBoard';
-export interface WorldMapTemplateProps extends TemplateProps<WorldMapEntity> {
-    /** Canvas render scale */
-    scale?: number;
-    /** Unit draw-size multiplier */
-    unitScale?: number;
-    /** Override for the diamond-top Y offset within tile sprites (default: 374). */
-    diamondTopY?: number;
-    /** Allow selecting / moving ALL heroes (including enemy). For testing. */
-    allowMoveAllHeroes?: boolean;
-}
-export declare function WorldMapTemplate({ entity, scale, unitScale, diamondTopY, allowMoveAllHeroes, className, }: WorldMapTemplateProps): React.JSX.Element;
-export declare namespace WorldMapTemplate {
-    var displayName: string;
-}
-export default WorldMapTemplate;

package/dist/components/templates/index.d.ts

@@ -1,10 +0,0 @@
-export type { TemplateProps } from './types';
-export { DashboardLayout, type DashboardLayoutProps, type NavItem } from './DashboardLayout';
-export { AuthLayout, type AuthLayoutProps } from './AuthLayout';
-export { CounterTemplate, type CounterTemplateProps, type CounterSize, type CounterVariant } from './CounterTemplate';
-export { GameTemplate, type GameTemplateProps } from './GameTemplate';
-export { GenericAppTemplate, type GenericAppTemplateProps } from './GenericAppTemplate';
-export { GameShell, type GameShellProps } from './GameShell';
-export { BattleTemplate, type BattleTemplateProps, type BattleEntity, type BattlePhase, type BattleUnit, type BattleTile, type BattleSlotContext, } from './BattleTemplate';
-export { CastleTemplate, type CastleTemplateProps, type CastleEntity, type CastleSlotContext, } from './CastleTemplate';
-export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapEntity, type MapHero, type MapHex, type WorldMapSlotContext, } from './WorldMapTemplate';

package/dist/components/templates/types.d.ts

@@ -1,17 +0,0 @@
-/**
- * Base template types for Almadar UI.
- *
- * All templates MUST extend `TemplateProps<E>` to enforce entity-only data flow
- * and JSON round-trip compatibility with the flattener pipeline.
- *
- * @see docs/Almadar_Templates.md
- */
-/** Base props for all templates — enforces entity-only data flow. */
-export interface TemplateProps<E extends {
-    id: string;
-}> {
-    /** Entity data — the sole source of runtime state */
-    entity: E;
-    /** External styling override */
-    className?: string;
-}

package/dist/context/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/context/ThemeContext.d.ts

@@ -1,104 +0,0 @@
-/**
- * Unified ThemeContext - Single provider for theme and color mode
- *
- * Combines design theme selection (ocean, wireframe, etc.) with
- * color mode (light/dark) into a single, simple system.
- *
- * Uses a single data attribute: data-theme="ocean-light" or data-theme="ocean-dark"
- *
- * @packageDocumentation
- */
-import React from "react";
-/** Color mode preference */
-export type ColorMode = "light" | "dark" | "system";
-/** Resolved color mode (what's actually applied) */
-export type ResolvedMode = "light" | "dark";
-/** Theme definition */
-export interface ThemeDefinition {
-    /** Theme identifier (e.g., "ocean", "wireframe") */
-    name: string;
-    /** Display name for UI (e.g., "Ocean Blue") */
-    displayName?: string;
-    /** Whether this theme has light mode styles */
-    hasLightMode?: boolean;
-    /** Whether this theme has dark mode styles */
-    hasDarkMode?: boolean;
-}
-/** Built-in themes available in the design system */
-export declare const BUILT_IN_THEMES: ThemeDefinition[];
-/** Theme context value */
-interface ThemeContextValue {
-    /** Current theme name */
-    theme: string;
-    /** Current color mode setting (may be 'system') */
-    mode: ColorMode;
-    /** Resolved color mode (always 'light' or 'dark') */
-    resolvedMode: ResolvedMode;
-    /** Set the theme */
-    setTheme: (theme: string) => void;
-    /** Set the color mode */
-    setMode: (mode: ColorMode) => void;
-    /** Toggle between light and dark modes */
-    toggleMode: () => void;
-    /** Available themes */
-    availableThemes: ThemeDefinition[];
-    /** The full theme string applied to data-theme (e.g., "ocean-light") */
-    appliedTheme: string;
-}
-declare const ThemeContext: React.Context<ThemeContextValue | undefined>;
-export interface ThemeProviderProps {
-    children: React.ReactNode;
-    /** Available themes (will be merged with built-in themes) */
-    themes?: readonly ThemeDefinition[] | ThemeDefinition[];
-    /** Default theme name */
-    defaultTheme?: string;
-    /** Default color mode */
-    defaultMode?: ColorMode;
-    /** Optional target element ref — when provided, theme attributes are applied to this element instead of document.documentElement */
-    targetRef?: React.RefObject<HTMLElement>;
-}
-/**
- * Unified ThemeProvider component
- *
- * @example
- * ```tsx
- * // Basic usage with built-in themes
- * <ThemeProvider defaultTheme="wireframe" defaultMode="light">
- *   <App />
- * </ThemeProvider>
- *
- * // With custom themes from orbital schema
- * import { THEMES } from './generated/theme-manifest';
- * <ThemeProvider themes={THEMES} defaultTheme="ocean" defaultMode="system">
- *   <App />
- * </ThemeProvider>
- * ```
- */
-export declare const ThemeProvider: React.FC<ThemeProviderProps>;
-/**
- * Hook for accessing theme context
- *
- * @returns Theme context value
- *
- * @example
- * ```tsx
- * const { theme, resolvedMode, toggleMode, setTheme } = useTheme();
- *
- * // Toggle dark mode
- * <button onClick={toggleMode}>
- *   {resolvedMode === 'dark' ? 'Light' : 'Dark'}
- * </button>
- *
- * // Change theme
- * <select value={theme} onChange={(e) => setTheme(e.target.value)}>
- *   {availableThemes.map(t => (
- *     <option key={t.name} value={t.name}>{t.displayName || t.name}</option>
- *   ))}
- * </select>
- * ```
- */
-export declare function useTheme(): ThemeContextValue;
-export type Theme = ColorMode;
-export type ResolvedTheme = ResolvedMode;
-export type DesignTheme = ThemeDefinition;
-export default ThemeContext;