@almadar/ui 5.16.4 → 5.17.1

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

@@ -27,9 +27,11 @@ export interface AvatarProps {
      */
     initials?: string;
     /**
-     * Icon to display when no image or initials
+     * Icon to display when no image or initials. Accepts a Lucide component
+     * directly, or a canonical kebab-case icon name string (resolved via
+     * `resolveIcon`) so trait/factory authors can pass an icon by name.
      */
-    icon?: LucideIcon;
+    icon?: LucideIcon | string;
     /**
      * Size of the avatar
      * @default 'md'

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

@@ -9,12 +9,12 @@ import { type SExpr } from '@almadar/evaluator';
 /**
  * Context for conditional evaluation
  */
-export interface ConditionalContext {
+export type ConditionalContext = {
     formValues: Record<string, unknown>;
     globalVariables: Record<string, unknown>;
     localVariables?: Record<string, unknown>;
     entity?: Record<string, unknown>;
-}
+};
 export interface ConditionalWrapperProps {
     /** The S-expression condition to evaluate */
     condition?: SExpr;

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

@@ -22,8 +22,12 @@ export type IconAnimation = 'spin' | 'pulse' | 'none';
  */
 export declare function resolveIcon(name: string): LucideIcon;
 export interface IconProps {
-    /** Lucide icon component (preferred for type-safe usage) */
-    icon?: LucideIcon;
+    /**
+     * Lucide icon component (preferred for type-safe usage), OR a canonical
+     * kebab-case icon name string — a string is treated exactly like `name` so
+     * trait/factory authors can pass an icon by name through the `icon` prop.
+     */
+    icon?: LucideIcon | string;
     /** Icon name as string (resolved from iconMap) */
     name?: string;
     /** Size of the icon */

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

@@ -21,8 +21,9 @@ export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElem
     error?: string;
     leftIcon?: React.ReactNode;
     rightIcon?: React.ReactNode;
-    /** Lucide icon component for left side (convenience prop) */
-    icon?: LucideIcon;
+    /** Lucide icon component for left side (convenience prop), or a canonical
+     *  kebab-case icon name string (resolved via `resolveIcon`). */
+    icon?: LucideIcon | string;
     /** Show clear button when input has value */
     clearable?: boolean;
     /** Callback when clear button is clicked */

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

@@ -8,7 +8,7 @@ import React from "react";
 /**
  * Law reference definition
  */
-export interface LawReference {
+export type LawReference = {
     /** Law identifier (e.g., "VVO", "TPED") */
     law: string;
     /** Full name of the law */
@@ -19,7 +19,7 @@ export interface LawReference {
     clause?: string;
     /** Optional link to full law text */
     link?: string;
-}
+};
 export interface LawReferenceTooltipProps {
     /** The law reference to display */
     reference: LawReference;

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 type 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 type LinkAction = {
+    label: string;
+    href: string;
+};
+/** An image with its required alt text. */
+export type ImageSource = {
+    src: string;
+    alt: string;
+};
+/** A 2D point in canvas/layout coordinates. */
+export type Point = {
+    x: number;
+    y: number;
+};
+/** A 2D rectangle in canvas coordinates (`w`/`h` = width/height). */
+export type Rect = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};