@almadar/ui 5.16.2 → 5.17.0

package/dist/avl/index.cjs

@@ -56560,6 +56560,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/avl/index.js

@@ -56511,6 +56511,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/components/atoms/game/MiniMap.d.ts

@@ -1,17 +1,20 @@
+import type { Rect } from '../types';
+export interface MiniMapTile {
+    x: number;
+    y: number;
+    color: string;
+}
+export interface MiniMapUnit {
+    x: number;
+    y: number;
+    color: string;
+    isPlayer?: boolean;
+}
 export interface MiniMapProps {
     /** Tile data: each tile renders as a 1px dot at (x,y) with the given color */
-    tiles?: {
-        x: number;
-        y: number;
-        color: string;
-    }[];
+    tiles?: MiniMapTile[];
     /** Unit positions: each unit renders as a 2px dot */
-    units?: {
-        x: number;
-        y: number;
-        color: string;
-        isPlayer?: boolean;
-    }[];
+    units?: MiniMapUnit[];
     /** Canvas display width in pixels */
     width?: number;
     /** Canvas display height in pixels */
@@ -21,12 +24,7 @@ export interface MiniMapProps {
     /** Logical map height (for coordinate scaling) */
     mapHeight?: number;
     /** Viewport rectangle outline */
-    viewportRect?: {
-        x: number;
-        y: number;
-        w: number;
-        h: number;
-    };
+    viewportRect?: Rect;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -47,3 +47,4 @@ export { AnimatedReveal, type AnimatedRevealProps, type RevealTrigger, type Reve
 export { AnimatedGraphic, type AnimatedGraphicProps, type GraphicAnimation } from "./AnimatedGraphic";
 export { TraitFrame, type TraitFrameProps } from "./TraitFrame";
 export * from "./game";
+export { type UiError, type LinkAction, type ImageSource, type Point, type Rect, } from "./types";

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

@@ -0,0 +1,40 @@
+/**
+ * Cross-cutting atom-level prop shapes shared across the design system.
+ */
+/**
+ * Concrete error-state shape read by display components (`error.message`,
+ * occasionally `error.stack`). Structurally assignable from the global `Error`,
+ * so existing call sites passing an `Error` keep working — this just gives the
+ * pattern extractor a readable field schema instead of the opaque `Error` global.
+ */
+export interface UiError {
+    message: string;
+    name?: string;
+    code?: string;
+    stack?: string;
+}
+/**
+ * A labelled link/CTA used by marketing molecules (HeroSection, CTABanner,
+ * PricingCard) for their primary/secondary call-to-action props.
+ */
+export interface LinkAction {
+    label: string;
+    href: string;
+}
+/** An image with its required alt text. */
+export interface ImageSource {
+    src: string;
+    alt: string;
+}
+/** A 2D point in canvas/layout coordinates. */
+export interface Point {
+    x: number;
+    y: number;
+}
+/** A 2D rectangle in canvas coordinates (`w`/`h` = width/height). */
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}

package/dist/components/index.cjs

@@ -47795,6 +47795,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/components/index.js

@@ -47746,6 +47746,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/components/molecules/CTABanner.d.ts

@@ -5,6 +5,7 @@
  * Uses the site's theme naturally - no forced color inversions.
  */
 import React from 'react';
+import type { LinkAction } from '../atoms/types';
 export type CTABannerBackground = 'default' | 'alt' | 'dark' | 'gradient' | 'primary';
 export interface CTABannerProps {
     /** Banner headline */
@@ -12,15 +13,9 @@ export 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 */

package/dist/components/molecules/CalendarGrid.d.ts

@@ -7,13 +7,13 @@
  */
 import React from "react";
 import type { EventEmit, EventPayload, EntityCollection } from "@almadar/core";
-export interface CalendarEvent {
+export type CalendarEvent = {
     id: string;
     title: string;
     startTime: string | Date;
     endTime?: string | Date;
     color?: string;
-}
+};
 /**
  * Number of day columns rendered at once. Matches the responsiveness-
  * audit tiers exactly: 1 day on mobile (≤640), 3 on tablet (641–1024),

package/dist/components/molecules/CommunityLinks.d.ts

@@ -5,19 +5,22 @@
  * Composes VStack, HStack, Typography, Button, and Icon atoms.
  */
 import React from 'react';
+export interface GithubLink {
+    url: string;
+    stars?: number;
+}
+export interface DiscordLink {
+    url: string;
+    members?: number;
+}
+export interface TwitterLink {
+    url: string;
+    followers?: number;
+}
 export 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;

package/dist/components/molecules/DataGrid.d.ts

@@ -13,6 +13,7 @@
 import React from 'react';
 import type { EntityRow, EventKey, EntityCollection } from '@almadar/core';
 import { type DataDndProps } from './useDataDnd';
+import type { UiError } from '../atoms/types';
 export interface DataGridField {
     /** Entity field name (dot-notation supported) */
     name: string;
@@ -87,7 +88,7 @@ export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndP
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity field name containing an image URL for card thumbnails */
     imageField?: string;
     /** Enable multi-select with checkboxes */

package/dist/components/molecules/DataList.d.ts

@@ -13,6 +13,7 @@
 import React from 'react';
 import type { EntityRow, EntityCollection, EventKey } from "@almadar/core";
 import { type DataDndProps } from './useDataDnd';
+import type { UiError } from '../atoms/types';
 export interface DataListField {
     /** Entity field name (dot-notation supported) */
     name: string;
@@ -36,6 +37,14 @@ export interface DataListItemAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
+export interface DataListSwipeAction {
+    /** Button label */
+    label: string;
+    /** Lucide icon name */
+    icon?: string;
+    /** Button variant */
+    variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
+}
 export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndProps {
     /**
      * Schema entity data — single record or collection, typed against
@@ -76,7 +85,7 @@ export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndP
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Enable drag-to-reorder with grip handles */
     reorderable?: boolean;
     /** Event emitted on reorder: UI:{reorderEvent} with { fromIndex, toIndex } */
@@ -84,19 +93,11 @@ export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndP
     /** Event emitted on left swipe: UI:{swipeLeftEvent} with { row } */
     swipeLeftEvent?: EventKey;
     /** Actions revealed on left swipe */
-    swipeLeftActions?: readonly {
-        label: string;
-        icon?: string;
-        variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
-    }[];
+    swipeLeftActions?: readonly DataListSwipeAction[];
     /** Event emitted on right swipe: UI:{swipeRightEvent} with { row } */
     swipeRightEvent?: EventKey;
     /** Actions revealed on right swipe */
-    swipeRightActions?: readonly {
-        label: string;
-        icon?: string;
-        variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
-    }[];
+    swipeRightActions?: readonly DataListSwipeAction[];
     /** Event emitted on long press: UI:{longPressEvent} with { row } */
     longPressEvent?: EventKey;
     /** Enable infinite scroll loading */

package/dist/components/molecules/GraphView.d.ts

@@ -8,13 +8,13 @@
  * to lay out nodes, then renders via SVG circles and lines.
  */
 import React from 'react';
-export interface GraphViewNode {
+export type GraphViewNode = {
     id: string;
     label?: string;
     color?: string;
     size?: number;
     group?: string;
-}
+};
 export interface GraphViewEdge {
     source: string;
     target: string;

package/dist/components/molecules/HeroSection.d.ts

@@ -6,25 +6,17 @@
  * Optionally includes an InstallBox molecule for CLI commands.
  */
 import React from 'react';
+import type { LinkAction, ImageSource } from '../atoms/types';
 export interface HeroSectionProps {
     tag?: string;
     tagVariant?: 'primary' | 'secondary' | 'accent';
     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';

package/dist/components/molecules/MapView.d.ts

@@ -1,5 +1,5 @@
 import type { EventEmit } from '@almadar/core';
-export interface MapMarkerData {
+export type MapMarkerData = {
     /** Unique marker identifier */
     id: string | number;
     /** Latitude */
@@ -10,7 +10,7 @@ export interface MapMarkerData {
     label?: string;
     /** Optional category for styling */
     category?: string;
-}
+};
 export interface MapRouteWaypoint {
     lat: number;
     lng: number;

package/dist/components/molecules/MarketingFooter.d.ts

@@ -14,14 +14,15 @@ export interface FooterLinkColumn {
     title: string;
     items: FooterLinkItem[];
 }
+export interface FooterLogo {
+    src: string;
+    alt: string;
+    href?: string;
+}
 export interface MarketingFooterProps {
     columns: FooterLinkColumn[];
     copyright?: string;
-    logo?: {
-        src: string;
-        alt: string;
-        href?: string;
-    };
+    logo?: FooterLogo;
     className?: string;
 }
 export declare const MarketingFooter: React.FC<MarketingFooterProps>;

package/dist/components/molecules/Meter.d.ts

@@ -6,6 +6,7 @@
  * Pure molecule: no entity prop, no data fetching.
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 export type MeterVariant = "linear" | "radial" | "segmented";
 export interface MeterThreshold {
     value: number;
@@ -44,7 +45,7 @@ export interface MeterProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

package/dist/components/molecules/PricingCard.d.ts

@@ -5,15 +5,13 @@
  * Composes atoms: Card, VStack, HStack, Badge, Typography, Icon, Divider, Spacer, Button.
  */
 import React from 'react';
+import type { LinkAction } from '../atoms/types';
 export interface PricingCardProps {
     name: string;
     price: string;
     description?: string;
     features: string[];
-    action: {
-        label: string;
-        href: string;
-    };
+    action: LinkAction;
     highlighted?: boolean;
     badge?: string;
     className?: string;

package/dist/components/molecules/QrScanner.d.ts

@@ -5,11 +5,11 @@ import type { EventEmit, EventPayload } from "@almadar/core";
  * `EventPayloadValue` map) so the result is directly assignable to a
  * render-ui dispatched event payload without re-shaping.
  */
-export interface QrScanResult extends EventPayload {
+export type QrScanResult = EventPayload & {
     text: string;
     format: string;
     timestamp: number;
-}
+};
 export interface QrScannerProps {
     onScan?: (result: QrScanResult) => void;
     scanEvent?: EventEmit<QrScanResult>;

package/dist/components/molecules/RepeatableFormSection.d.ts

@@ -11,14 +11,14 @@
  * - Emits: UI:SECTION_REMOVED { sectionType, index, itemId }
  */
 import React from "react";
-export interface RepeatableItem {
+export type RepeatableItem = {
     id: string;
     /** State in which this item was added (for audit trails) */
     addedInState?: string;
     /** Timestamp when item was added */
     addedAt?: string;
     [key: string]: unknown;
-}
+};
 export interface RepeatableFormSectionProps {
     /** Section type identifier */
     sectionType: string;

package/dist/components/molecules/ShowcaseCard.d.ts

@@ -5,13 +5,11 @@
  * Composes Card, Box, VStack, Badge, and Typography atoms.
  */
 import React from 'react';
+import type { ImageSource } from '../atoms/types';
 export interface ShowcaseCardProps {
     title: string;
     description?: string;
-    image: {
-        src: string;
-        alt: string;
-    };
+    image: ImageSource;
     href?: string;
     badge?: string;
     accentColor?: string;

package/dist/components/molecules/SplitSection.d.ts

@@ -5,14 +5,12 @@
  * Composes Box, HStack, VStack, Typography, and Icon atoms.
  */
 import React from 'react';
+import type { ImageSource } from '../atoms/types';
 export 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;

package/dist/components/molecules/StatDisplay.d.ts

@@ -6,6 +6,7 @@
  * No entity prop, no data fetching, no hooks beyond icon resolution.
  */
 import React from 'react';
+import type { UiError } from '../atoms/types';
 export type StatDisplayLook = 'elevated' | 'flat' | 'progress-backed' | 'gauge' | 'sparkline';
 export interface StatDisplayProps {
     /** Display label (e.g., "Total", "Remaining") */
@@ -51,6 +52,6 @@ export interface StatDisplayProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
 }
 export declare const StatDisplay: React.FC<StatDisplayProps>;

package/dist/components/molecules/StatsGrid.d.ts

@@ -6,11 +6,12 @@
  * Uses StatDisplay internally when available for consistent styling.
  */
 import React from 'react';
+export interface StatItem {
+    value: string;
+    label: string;
+}
 export interface StatsGridProps {
-    stats: {
-        value: string;
-        label: string;
-    }[];
+    stats: StatItem[];
     columns?: 2 | 3 | 4 | 6;
     className?: string;
 }

package/dist/components/molecules/TableView.d.ts

@@ -14,6 +14,7 @@
 import React from 'react';
 import type { EntityRow, EventKey, EntityCollection } from '@almadar/core';
 import { type DataDndProps } from './useDataDnd';
+import type { UiError } from '../atoms/types';
 export interface TableViewColumn {
     /** Stable column key (React key + default value lookup). */
     key: string;
@@ -80,7 +81,7 @@ export interface TableViewProps<T extends EntityRow = EntityRow> extends DataDnd
     /** Loading state. */
     isLoading?: boolean;
     /** Error state. */
-    error?: Error | null;
+    error?: UiError | null;
     /** Group rows under section headers by a field value. */
     groupBy?: string;
     /** Max rows before a "Show More" button. Defaults to 0 (show all). */

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

@@ -10,15 +10,19 @@ export interface CraftingIngredient {
     /** Number currently available */
     available: number;
 }
+export interface CraftingOutput {
+    /** Icon component or emoji */
+    icon?: React.ReactNode;
+    /** 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: {
-        icon?: React.ReactNode;
-        label: string;
-        rarity?: string;
-    };
+    output: CraftingOutput;
     /** Whether the player has enough ingredients to craft */
     canCraft?: boolean;
     /** Callback when the craft button is clicked */

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

@@ -1,4 +1,9 @@
 import * as React from 'react';
+export interface HealthEffect {
+    icon: React.ReactNode;
+    label?: string;
+    variant?: 'buff' | 'debuff' | 'neutral';
+}
 export interface HealthPanelProps {
     /** Current health value */
     current: number;
@@ -9,11 +14,7 @@ export interface HealthPanelProps {
     /** Label shown above the bar */
     label?: string;
     /** Active status effects displayed as small badges */
-    effects?: {
-        icon: React.ReactNode;
-        label?: string;
-        variant?: 'buff' | 'debuff' | 'neutral';
-    }[];
+    effects?: HealthEffect[];
     /** Whether to display numeric HP values */
     showNumbers?: boolean;
     /** Size variant */

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

@@ -27,19 +27,24 @@ import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../organisms/game/types/isometric';
 import type { ResolvedFrame } from '../../organisms/game/types/spriteAnimation';
+import type { UiError } from '../../atoms/types';
 /** Event Contract:
  *  Emits: UI:TILE_CLICK
  *  Emits: UI:UNIT_CLICK
  *  Emits: UI:TILE_HOVER
  *  Emits: UI:TILE_LEAVE
  */
+export interface TileCoord {
+    x: number;
+    y: number;
+}
 export interface IsometricCanvasProps {
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Array of tiles to render */
     tiles?: IsometricTile[];
     /** Array of units on the board */
@@ -49,20 +54,11 @@ export interface IsometricCanvasProps {
     /** Currently selected unit ID */
     selectedUnitId?: string | null;
     /** Valid move positions (shown as pulsing green highlights) */
-    validMoves?: Array<{
-        x: number;
-        y: number;
-    }>;
+    validMoves?: TileCoord[];
     /** Attack target positions (shown as pulsing red highlights) */
-    attackTargets?: Array<{
-        x: number;
-        y: number;
-    }>;
+    attackTargets?: TileCoord[];
     /** Hovered tile position */
-    hoveredTile?: {
-        x: number;
-        y: number;
-    } | null;
+    hoveredTile?: TileCoord | null;
     onTileClick?: (x: number, y: number) => void;
     onUnitClick?: (unitId: string) => void;
     onTileHover?: (x: number, y: number) => void;