@almadar/ui 5.25.1 → 5.26.1

package/dist/components/game/atoms/ResourceCounter.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { ColorToken } from '../../core/atoms/types';
 export interface ResourceCounterProps {
     /** Icon component or emoji */
     icon?: React.ReactNode;
@@ -8,8 +9,8 @@ export interface ResourceCounterProps {
     value: number;
     /** Maximum value */
     max?: number;
-    /** Accent color class (e.g. 'text-yellow-400') */
-    color?: string;
+    /** Semantic palette token or an arbitrary Tailwind color class. */
+    color?: ColorToken | string;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg';
     /** Additional CSS classes */

package/dist/components/game/atoms/StateIndicator.d.ts

@@ -1,9 +1,8 @@
 /**
- * StateIndicator Component
- *
- * Displays a visual indicator for a game entity's current state.
- * Generic — not tied to any specific game. Projects can extend
- * the state styles via the `stateStyles` prop.
+ * StateIndicator — animated game-entity state pill (distinct from core Badge atom).
+ * Badge is a static text label. StateIndicator maps a state string (idle/active/
+ * moving/…) to icon + bg colour + optional pulse via a style registry that callers
+ * can extend. Use it in game HUDs where the entity state machine drives the display.
  */
 import React from 'react';
 export interface StateStyle {

package/dist/components/game/atoms/StatusEffect.d.ts

@@ -1,7 +1,6 @@
-import * as React from 'react';
 export interface StatusEffectProps {
-    /** Icon to display for the effect */
-    icon: React.ReactNode;
+    /** Lucide kebab-case icon name */
+    icon: string;
     /** Label describing the effect */
     label?: string;
     /** Remaining duration in seconds */

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

@@ -1,3 +1,9 @@
+/**
+ * ActionButtons — configurable button-group molecule for game controls (distinct from ActionButton atom).
+ * ActionButton is a single button with cooldown overlay and hotkey badge.
+ * ActionButtons manages a *set* of ControlButtons, tracks press/release state,
+ * and supports horizontal/vertical/diamond layouts for gamepad-style UI.
+ */
 import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
 export interface ActionButtonConfig {

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

@@ -1,4 +1,3 @@
-import * as React from "react";
 import { type StatBadgeProps } from "./StatBadge";
 export interface GameHudStat extends Omit<StatBadgeProps, "size"> {
     /** Data source entity name */
@@ -17,8 +16,8 @@ export interface GameHudElement {
     label?: string;
     /** Direct value (from compiled render-ui effects) */
     value?: number | string;
-    /** Icon name or node */
-    icon?: React.ReactNode;
+    /** Lucide kebab-case icon name */
+    icon?: string;
     /** Display format */
     format?: string;
     /** Max value (for bars/hearts) */

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

@@ -1,4 +1,10 @@
 import * as React from 'react';
+/**
+ * StatBadge — game stat display molecule (distinct from core Badge atom).
+ * Badge shows a text label/status token. StatBadge shows a numeric value
+ * with optional HealthBar (hearts/bar) or ScoreDisplay (animated number) and
+ * a named label — purpose-built for HUD stat rows, not general status tags.
+ */
 export interface StatBadgeProps {
     /** Stat label */
     label: string;

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

@@ -0,0 +1,16 @@
+import React from 'react';
+export interface StateJsonViewProps {
+    /** JSON data to display */
+    data: Record<string, unknown>;
+    /** Label */
+    label?: string;
+    /** Whether the code is expanded by default */
+    defaultExpanded?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function StateJsonView({ data, label, defaultExpanded, className, }: StateJsonViewProps): React.JSX.Element;
+export declare namespace StateJsonView {
+    var displayName: string;
+}
+export default StateJsonView;

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

@@ -4,7 +4,7 @@ export { TransitionArrow } from './TransitionArrow';
 export type { TransitionArrowProps } from './TransitionArrow';
 export { VariablePanel } from './VariablePanel';
 export type { VariablePanelProps } from './VariablePanel';
-export { CodeView } from './CodeView';
-export type { CodeViewProps } from './CodeView';
+export { StateJsonView } from './StateJsonView';
+export type { StateJsonViewProps } from './StateJsonView';
 export { StateArchitectBoard } from './StateArchitectBoard';
 export type { StateArchitectBoardProps, StateArchitectTransition, TestCase, } from './StateArchitectBoard';