@almadar/ui 5.16.4 → 5.17.1

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/OptionConstraintGroup.d.ts

@@ -10,13 +10,13 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-export interface OptionConstraintOption {
+export type OptionConstraintOption = {
     id: string;
     label: string;
     priceDelta?: number;
     disabled?: boolean;
     outOfStock?: boolean;
-}
+};
 export type OptionConstraint = {
     type: 'single';
     required?: boolean;
@@ -30,7 +30,9 @@ export interface OptionConstraintGroupProps {
     title: string;
     description?: string;
     options: OptionConstraintOption[];
-    constraint: OptionConstraint;
+    /** Selection constraint. Optional — defaults to single-select (the generic
+     *  factory can't author a discriminated-union value; an author overrides it). */
+    constraint?: OptionConstraint;
     selected?: string[];
     onChange?: (selected: string[]) => void;
     changeEvent?: EventEmit<{

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/ViolationAlert.d.ts

@@ -10,7 +10,7 @@
  * - penalty: Penalty proceedings (error, severe)
  */
 import React from "react";
-export interface ViolationRecord {
+export type ViolationRecord = {
     /** Unique violation identifier */
     id: string;
     /** Law reference (e.g., "ZVPOT-1") */
@@ -29,7 +29,7 @@ export interface ViolationRecord {
     fieldId?: string;
     /** Tab/form where violation occurred */
     tabId?: string;
-}
+};
 export interface ViolationAlertProps {
     /** Violation data */
     violation: ViolationRecord;

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

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
-export interface CraftingIngredient {
+export type CraftingIngredient = {
     /** Icon component or emoji */
     icon?: React.ReactNode;
     /** Ingredient label */
@@ -9,16 +9,20 @@ export interface CraftingIngredient {
     required: number;
     /** Number currently available */
     available: number;
-}
+};
+export type 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/DialogueBox.d.ts

@@ -19,14 +19,14 @@ export type DialogueChoice = EventPayload & {
     next?: string;
     disabled?: boolean;
 };
-export interface DialogueNode {
+export type DialogueNode = {
     id?: string;
     speaker: string;
     text: string;
     portrait?: string;
     choices?: DialogueChoice[];
     autoAdvance?: number;
-}
+};
 /** Event Contract:
  *  Emits: UI:COMPLETE
  *  Emits: UI:CHOICE

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;

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

@@ -15,6 +15,7 @@
  * alignment is deliberately deferred).
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 export type ChartType = "bar" | "line" | "pie" | "area" | "donut" | "scatter" | "histogram";
 /**
  * Layer 2 visual treatment for the chart pattern — drives the chart
@@ -100,7 +101,7 @@ export interface ChartProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -12,6 +12,7 @@
  * - className for external styling
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 export type CodeViewerMode = "code" | "diff";
 export interface DiffLine {
     type: "add" | "remove" | "context";
@@ -24,6 +25,11 @@ export interface CodeViewerAction {
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
+export interface CodeViewerFile {
+    label: string;
+    code: string;
+    language?: string;
+}
 export interface CodeViewerProps {
     /** Viewer title */
     title?: string;
@@ -48,11 +54,7 @@ export interface CodeViewerProps {
     /** Max height before scrolling */
     maxHeight?: number | string;
     /** Multiple files (tabbed view) */
-    files?: readonly {
-        label: string;
-        code: string;
-        language?: string;
-    }[];
+    files?: readonly CodeViewerFile[];
     /** Actions */
     actions?: readonly CodeViewerAction[];
     /** Entity name for schema-driven auto-fetch */
@@ -60,7 +62,7 @@ export interface CodeViewerProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -10,6 +10,7 @@
  */
 import React from 'react';
 import type { EventKey, EventPayload } from '@almadar/core';
+import type { UiError } from '../atoms/types';
 import { type ButtonProps } from '../atoms/Button';
 import { type BadgeVariant } from '../atoms/Badge';
 import { type AlertVariant } from '../molecules/Alert';
@@ -20,7 +21,7 @@ import { type MapViewProps } from '../molecules/MapView';
 interface ClosedCircuitProps {
     className?: string;
     isLoading?: boolean;
-    error?: Error | null;
+    error?: UiError | null;
     entity?: string;
 }
 /**

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

@@ -8,6 +8,7 @@
  */
 import React from "react";
 import { type ModalSize } from "../molecules/Modal";
+import type { UiError } from '../atoms/types';
 export type ConfirmDialogVariant = "danger" | "warning" | "info" | "default";
 export interface ConfirmDialogProps {
     /** Whether the dialog is open (defaults to true when rendered by slot wrapper) */
@@ -37,7 +38,7 @@ export interface ConfirmDialogProps {
     /** Loading state for confirm button */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
     /** Additional CSS classes */