@almadar/ui 5.16.2 → 5.17.0

package/dist/components/organisms/game/CastleBoard.d.ts

@@ -30,7 +30,7 @@ export interface CastleEntity {
     backgroundImage?: string;
 }
 /** Context exposed to render-prop slots */
-export interface CastleSlotContext {
+export type CastleSlotContext = {
     /** Currently hovered tile coordinates (null when not hovering) */
     hoveredTile: {
         x: number;
@@ -51,7 +51,7 @@ export interface CastleSlotContext {
     };
     /** Canvas scale */
     scale: number;
-}
+};
 export interface CastleBoardProps {
     /** Castle entity data */
     entity: CastleEntity;

package/dist/components/organisms/game/GameAudioProvider.d.ts

@@ -18,6 +18,7 @@
  */
 import React from 'react';
 import { type AudioManifest, type GameAudioControls } from './hooks/useGameAudio';
+import type { UiError } from '../../atoms/types';
 export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
 export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;
 /**
@@ -37,7 +38,7 @@ export interface GameAudioProviderProps {
     /** Closed-circuit props (unused, accepted for runtime compatibility) */
     className?: string;
     isLoading?: boolean;
-    error?: Error | null;
+    error?: UiError | null;
     entity?: string;
 }
 export declare function GameAudioProvider({ manifest, baseUrl, children, initialMuted, }: GameAudioProviderProps): React.JSX.Element;

package/dist/components/organisms/game/GameAudioToggle.d.ts

@@ -9,6 +9,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { UiError } from '../../atoms/types';
 export interface GameAudioToggleProps {
     /** Button size */
     size?: 'sm' | 'md' | 'lg';
@@ -17,7 +18,7 @@ export interface GameAudioToggleProps {
     /** Loading state (passed through) */
     isLoading?: boolean;
     /** Error state (passed through) */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

package/dist/components/organisms/game/TraitSlot.d.ts

@@ -20,8 +20,9 @@
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
 import { type TraitStateMachineDefinition } from './TraitStateViewer';
+import type { UiError } from '../../atoms/types';
 /** Data shape for a slot's equipped item */
-export interface SlotItemData {
+export type SlotItemData = {
     id: string;
     name: string;
     category: string;
@@ -32,7 +33,7 @@ export interface SlotItemData {
     iconUrl?: string;
     /** Optional state machine for tooltip display */
     stateMachine?: TraitStateMachineDefinition;
-}
+};
 /** Event Contract:
  *  Emits: UI:CLICK
  *  Emits: UI:REMOVE
@@ -64,7 +65,7 @@ export interface TraitSlotProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
     /** Called when an item is dropped on this slot */

package/dist/components/organisms/game/TraitStateViewer.d.ts

@@ -11,6 +11,7 @@
  */
 import React from 'react';
 import { type StateStyle } from '../../atoms/game/StateIndicator';
+import type { UiError } from '../../atoms/types';
 export interface TraitTransition {
     from: string;
     to: string;
@@ -42,7 +43,7 @@ export interface TraitStateViewerProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

package/dist/components/organisms/game/WorldMapBoard.d.ts

@@ -22,6 +22,7 @@ import React from 'react';
 import type { EventEmit } from '@almadar/core';
 import type { IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
+import type { UiError } from '../../atoms/types';
 /** A hero on the world map */
 export interface MapHero {
     id: string;
@@ -43,7 +44,7 @@ export interface MapHero {
     level?: number;
 }
 /** A hex on the map */
-export interface MapHex {
+export type MapHex = {
     x: number;
     y: number;
     terrain: string;
@@ -51,9 +52,9 @@ export interface MapHex {
     feature?: string;
     featureData?: Record<string, unknown>;
     passable?: boolean;
-}
+};
 /** Context exposed to render-prop slots */
-export interface WorldMapSlotContext {
+export type WorldMapSlotContext = {
     /** Currently hovered tile */
     hoveredTile: {
         x: number;
@@ -79,7 +80,7 @@ export interface WorldMapSlotContext {
     };
     /** Canvas scale */
     scale: number;
-}
+};
 /** Entity shape for the WorldMapBoard */
 export interface WorldMapEntity {
     id: string;
@@ -108,7 +109,7 @@ export interface WorldMapBoardProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** World map entity data */
     entity?: WorldMapEntity | readonly WorldMapEntity[];
     /** Canvas render scale */

package/dist/components/organisms/game/physics-sim/SimulationControls.d.ts

@@ -4,16 +4,17 @@
  * Play/pause/step/reset controls with speed and parameter sliders.
  */
 import React from 'react';
+export interface SimulationParameter {
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    label: string;
+}
 export interface SimulationControlsProps {
     running: boolean;
     speed: number;
-    parameters: Record<string, {
-        value: number;
-        min: number;
-        max: number;
-        step: number;
-        label: string;
-    }>;
+    parameters: Record<string, SimulationParameter>;
     onPlay: () => void;
     onPause: () => void;
     onStep: () => void;

package/dist/components/organisms/game/puzzles/event-handler/RuleEditor.d.ts

@@ -7,24 +7,22 @@
  * @packageDocumentation
  */
 import React from 'react';
-export interface RuleDefinition {
+export type RuleDefinition = {
     id: string;
     whenEvent: string;
     thenAction: string;
+};
+export interface RuleOption {
+    value: string;
+    label: string;
 }
 export interface RuleEditorProps {
     /** The current rule */
     rule: RuleDefinition;
     /** Available event triggers to listen for */
-    availableEvents: Array<{
-        value: string;
-        label: string;
-    }>;
+    availableEvents: RuleOption[];
     /** Available actions to perform */
-    availableActions: Array<{
-        value: string;
-        label: string;
-    }>;
+    availableActions: RuleOption[];
     /** Called when rule changes */
     onChange: (rule: RuleDefinition) => void;
     /** Called when rule is removed */

package/dist/components/organisms/game/puzzles/state-architect/StateNode.d.ts

@@ -7,6 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import { type Point } from '../../../../atoms';
 export interface StateNodeProps {
     /** State name */
     name: string;
@@ -17,10 +18,7 @@ export interface StateNodeProps {
     /** Whether this is the initial state */
     isInitial?: boolean;
     /** Position on the graph canvas */
-    position: {
-        x: number;
-        y: number;
-    };
+    position: Point;
     /** Click handler */
     onClick?: () => void;
     /** Additional CSS classes */

package/dist/components/organisms/game/puzzles/state-architect/TransitionArrow.d.ts

@@ -7,17 +7,12 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { Point } from '../../../../atoms/types';
 export interface TransitionArrowProps {
     /** Start position (center of from-node) */
-    from: {
-        x: number;
-        y: number;
-    };
+    from: Point;
     /** End position (center of to-node) */
-    to: {
-        x: number;
-        y: number;
-    };
+    to: Point;
     /** Event label shown on the arrow */
     eventLabel: string;
     /** Guard hint shown below event */

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

@@ -32,7 +32,7 @@ export interface IsometricTile {
     elevation?: number;
 }
 /** A unit positioned on the isometric grid */
-export interface IsometricUnit {
+export type IsometricUnit = {
     /** Unique unit identifier */
     id: string;
     /** Current grid position (2D format) */
@@ -76,9 +76,9 @@ export interface IsometricUnit {
     };
     /** Elevation offset for 3D rendering */
     elevation?: number;
-}
+};
 /** A map feature (resource, building, portal, etc.) */
-export interface IsometricFeature {
+export type IsometricFeature = {
     /** Optional unique identifier (required for 3D rendering) */
     id?: string;
     /** Grid x coordinate */
@@ -97,7 +97,7 @@ export interface IsometricFeature {
     color?: string;
     /** Elevation offset for 3D rendering */
     elevation?: number;
-}
+};
 /** Camera state for pan/zoom */
 export interface CameraState {
     /** Camera X offset in pixels */

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

@@ -1,4 +1,4 @@
-export { type EntityDisplayProps, EntityDisplayEvents, type SortPayload, type PaginatePayload, type SearchPayload, type FilterPayload, type SelectPayload, } from "./types";
+export { type EntityDisplayProps, type UiError, EntityDisplayEvents, type SortPayload, type PaginatePayload, type SearchPayload, type FilterPayload, type SelectPayload, } from "./types";
 export { DataTable, type DataTableProps, type Column, type RowAction, } from "./DataTable";
 export { StatCard, type StatCardProps } from "./StatCard";
 export { PageHeader, type PageHeaderProps, type PageBreadcrumb, } from "./PageHeader";

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

@@ -8,6 +8,8 @@
  * This is the ONE allowed exception — documented here.
  */
 import type { EntityRow, EntityInlet } from '@almadar/core';
+import type { UiError } from '../atoms/types';
+export type { UiError };
 export declare const EntityDisplayEvents: {
     readonly SORT: "SORT";
     readonly PAGINATE: "PAGINATE";
@@ -67,7 +69,7 @@ export interface EntityDisplayProps<T extends EntityRow = EntityRow> {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Current sort field */
     sortBy?: string;
     /** Current sort direction */

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

@@ -39,6 +39,11 @@ export interface TopBarAction {
     /** Visual variant. Default `"default"`. */
     variant?: "default" | "primary" | "danger";
 }
+export interface DashboardUser {
+    name: string;
+    email: string;
+    avatar?: string;
+}
 export interface DashboardLayoutProps {
     /** App name shown in sidebar */
     appName?: string;
@@ -48,11 +53,7 @@ export interface DashboardLayoutProps {
      *  as a navItems entry, not depend on baked-in chrome. */
     navItems?: NavItem[];
     /** Current user info (optional - auto-populated from auth context if not provided) */
-    user?: {
-        name: string;
-        email: string;
-        avatar?: string;
-    };
+    user?: DashboardUser;
     /** Header actions (extra slots beyond bell/search/theme). */
     headerActions?: React.ReactNode;
     /** Show the top-bar search box. Default `false` — opt in by setting

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

@@ -11,6 +11,12 @@ interface GameEntity {
     id: string;
     title?: string;
 }
+export interface GameControls {
+    onPlay?: () => void;
+    onPause?: () => void;
+    onReset?: () => void;
+    isPlaying?: boolean;
+}
 export interface GameTemplateProps extends TemplateProps<GameEntity> {
     /** Title of the game */
     title?: string;
@@ -23,12 +29,7 @@ export interface GameTemplateProps extends TemplateProps<GameEntity> {
     /** Whether the debug panel is visible */
     showDebugPanel?: boolean;
     /** Game controls */
-    controls?: {
-        onPlay?: () => void;
-        onPause?: () => void;
-        onReset?: () => void;
-        isPlaying?: boolean;
-    };
+    controls?: GameControls;
     /** Additional class name */
     className?: string;
 }

package/dist/marketing/index.d.cts

@@ -383,6 +383,20 @@ interface ContentSectionProps {
 }
 declare const ContentSection: React.ForwardRefExoticComponent<ContentSectionProps & React.RefAttributes<HTMLDivElement>>;
 
+/**
+ * A labelled link/CTA used by marketing molecules (HeroSection, CTABanner,
+ * PricingCard) for their primary/secondary call-to-action props.
+ */
+interface LinkAction {
+    label: string;
+    href: string;
+}
+/** An image with its required alt text. */
+interface ImageSource {
+    src: string;
+    alt: string;
+}
+
 /**
  * HeroSection Molecule Component
  *
@@ -397,19 +411,10 @@ interface HeroSectionProps {
     title: string;
     titleAccent?: string;
     subtitle: string;
-    primaryAction?: {
-        label: string;
-        href: string;
-    };
-    secondaryAction?: {
-        label: string;
-        href: string;
-    };
+    primaryAction?: LinkAction;
+    secondaryAction?: LinkAction;
     installCommand?: string;
-    image?: {
-        src: string;
-        alt: string;
-    };
+    image?: ImageSource;
     imagePosition?: 'below' | 'right' | 'background';
     background?: 'dark' | 'gradient' | 'subtle';
     align?: 'center' | 'left';
@@ -434,15 +439,9 @@ interface CTABannerProps {
     /** Supporting text below the title */
     subtitle?: string;
     /** Primary action button config */
-    primaryAction?: {
-        label: string;
-        href: string;
-    };
+    primaryAction?: LinkAction;
     /** Secondary action button config */
-    secondaryAction?: {
-        label: string;
-        href: string;
-    };
+    secondaryAction?: LinkAction;
     /** Background style */
     background?: CTABannerBackground;
     /** Content alignment */
@@ -510,10 +509,7 @@ interface PricingCardProps {
     price: string;
     description?: string;
     features: string[];
-    action: {
-        label: string;
-        href: string;
-    };
+    action: LinkAction;
     highlighted?: boolean;
     badge?: string;
     className?: string;
@@ -544,10 +540,7 @@ interface SplitSectionProps {
     title: string;
     description: string | React.ReactNode;
     bullets?: string[];
-    image?: {
-        src: string;
-        alt: string;
-    };
+    image?: ImageSource;
     imagePosition?: 'left' | 'right';
     background?: 'default' | 'alt';
     children?: React.ReactNode;
@@ -601,11 +594,12 @@ declare const StepFlow: React.FC<StepFlowProps>;
  * Uses StatDisplay internally when available for consistent styling.
  */
 
+interface StatItem {
+    value: string;
+    label: string;
+}
 interface StatsGridProps {
-    stats: {
-        value: string;
-        label: string;
-    }[];
+    stats: StatItem[];
     columns?: 2 | 3 | 4 | 6;
     className?: string;
 }
@@ -637,19 +631,22 @@ declare const TagCloud: React.FC<TagCloudProps>;
  * Composes VStack, HStack, Typography, Button, and Icon atoms.
  */
 
+interface GithubLink {
+    url: string;
+    stars?: number;
+}
+interface DiscordLink {
+    url: string;
+    members?: number;
+}
+interface TwitterLink {
+    url: string;
+    followers?: number;
+}
 interface CommunityLinksProps {
-    github?: {
-        url: string;
-        stars?: number;
-    };
-    discord?: {
-        url: string;
-        members?: number;
-    };
-    twitter?: {
-        url: string;
-        followers?: number;
-    };
+    github?: GithubLink;
+    discord?: DiscordLink;
+    twitter?: TwitterLink;
     heading?: string;
     subtitle?: string;
     className?: string;
@@ -686,10 +683,7 @@ declare const ServiceCatalog: React.FC<ServiceCatalogProps>;
 interface ShowcaseCardProps {
     title: string;
     description?: string;
-    image: {
-        src: string;
-        alt: string;
-    };
+    image: ImageSource;
     href?: string;
     badge?: string;
     accentColor?: string;
@@ -803,14 +797,15 @@ interface FooterLinkColumn {
     title: string;
     items: FooterLinkItem[];
 }
+interface FooterLogo {
+    src: string;
+    alt: string;
+    href?: string;
+}
 interface MarketingFooterProps {
     columns: FooterLinkColumn[];
     copyright?: string;
-    logo?: {
-        src: string;
-        alt: string;
-        href?: string;
-    };
+    logo?: FooterLogo;
     className?: string;
 }
 declare const MarketingFooter: React.FC<MarketingFooterProps>;

package/dist/providers/index.cjs

@@ -47862,6 +47862,16 @@ function SlotContentRenderer({
         );
       }
     }
+    if (propsSchema) {
+      for (const [propKey, propDef] of Object.entries(propsSchema)) {
+        const v = renderedProps[propKey];
+        if ((typeof v === "string" || typeof v === "number") && propDef.types?.some(
+          (t) => t === "date" || t === "datetime" || t === "timestamp"
+        )) {
+          renderedProps[propKey] = new Date(v);
+        }
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity

package/dist/providers/index.js

@@ -47813,6 +47813,16 @@ function SlotContentRenderer({
         );
       }
     }
+    if (propsSchema) {
+      for (const [propKey, propDef] of Object.entries(propsSchema)) {
+        const v = renderedProps[propKey];
+        if ((typeof v === "string" || typeof v === "number") && propDef.types?.some(
+          (t) => t === "date" || t === "datetime" || t === "timestamp"
+        )) {
+          renderedProps[propKey] = new Date(v);
+        }
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity

package/dist/runtime/index.cjs

@@ -47448,6 +47448,16 @@ function SlotContentRenderer({
         );
       }
     }
+    if (propsSchema) {
+      for (const [propKey, propDef] of Object.entries(propsSchema)) {
+        const v = renderedProps[propKey];
+        if ((typeof v === "string" || typeof v === "number") && propDef.types?.some(
+          (t) => t === "date" || t === "datetime" || t === "timestamp"
+        )) {
+          renderedProps[propKey] = new Date(v);
+        }
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity

package/dist/runtime/index.js

@@ -47399,6 +47399,16 @@ function SlotContentRenderer({
         );
       }
     }
+    if (propsSchema) {
+      for (const [propKey, propDef] of Object.entries(propsSchema)) {
+        const v = renderedProps[propKey];
+        if ((typeof v === "string" || typeof v === "number") && propDef.types?.some(
+          (t) => t === "date" || t === "datetime" || t === "timestamp"
+        )) {
+          renderedProps[propKey] = new Date(v);
+        }
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.16.2",
+  "version": "5.17.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [