@almadar/ui 5.61.0 → 5.63.1

package/dist/components/core/atoms/Box.d.ts

@@ -52,6 +52,8 @@ export interface BoxProps extends React.HTMLAttributes<HTMLDivElement> {
     actionPayload?: EventPayload;
     /** Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave */
     hoverEvent?: EventKey;
+    /** When true (default), a touch/pen tap also fires `hoverEvent` (toggling hovered) so hover-only reveals work on touch. */
+    tapReveal?: boolean;
     /** Maximum width (CSS value, e.g., "550px", "80rem") */
     maxWidth?: string;
     /** Children elements */

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

@@ -13,13 +13,21 @@ import type { EventEmit, EventPayload, EntityRow, EntityWith } from "@almadar/co
  * 7 on laptop+ (≥1025).
  */
 export type CalendarDayWindow = 1 | 3 | 7;
+/** The per-event entity fields this grid reads. `startTime`/`endTime` are ISO
+ *  strings; `color` is a Tailwind class string applied to the event chip. */
+export interface CalendarEventRow {
+    title: string;
+    startTime: string;
+    endTime?: string;
+    color?: string;
+}
 export interface CalendarGridProps {
     /** Start of the week (defaults to current week's Monday) */
     weekStart?: Date;
     /** Time slot labels (defaults to 09:00-17:00) */
     timeSlots?: string[];
     /** Events to display on the grid */
-    events?: readonly EntityWith<'id' | 'title' | 'startTime'>[];
+    events?: readonly EntityWith<CalendarEventRow>[];
     /** Called when a time slot is clicked */
     onSlotClick?: (day: Date, time: string) => void;
     /** Called when a day header is clicked */

package/dist/components/core/molecules/GraphCanvas.d.ts

@@ -67,6 +67,10 @@ export interface GraphCanvasProps {
     repulsion?: number;
     /** Force-sim target edge length (larger ⇒ more spread out) */
     linkDistance?: number;
+    /** Minimum empty gap (px) enforced between node edges so nodes never overlap. */
+    nodeSpacing?: number;
+    /** Base opacity for links when nothing is hovered (kept faint so dense graphs stay readable; incident links brighten on hover). */
+    linkOpacity?: number;
     /** Layout algorithm */
     layout?: "force" | "circular" | "grid";
     /** Entity name for schema-driven auto-fetch */

package/dist/components/core/molecules/PositionedCanvas.d.ts

@@ -2,12 +2,25 @@ import React from "react";
 import type { EventEmit, EntityWith } from "@almadar/core";
 export type CanvasItemStatus = 'empty' | 'seated' | 'ordered' | 'awaiting-bill' | 'cleaning';
 export type CanvasItemShape = 'round' | 'rectangle' | 'square';
+/** The per-item entity fields this canvas reads. `x`/`y` are pixel coordinates
+ *  in the canvas plane; `status`/`shape` are string literal unions widened to
+ *  `string` at the row level. */
+export interface CanvasItemRow {
+    label: string;
+    x: number;
+    y: number;
+    capacity: number;
+    partySize?: number;
+    serverName?: string;
+    status?: CanvasItemStatus;
+    shape?: CanvasItemShape;
+}
 export interface PositionedCanvasProps {
     /**
      * Items to render. The molecule narrows non-array values to `[]` and reads
      * each row's `id` / `x` / `y` / `label` fields at render time.
      */
-    items: readonly EntityWith<'id' | 'label' | 'x' | 'y'>[];
+    items: readonly EntityWith<CanvasItemRow>[];
     width?: number;
     height?: number;
     selectedId?: string | null;

package/dist/components/core/molecules/ReplyTree.d.ts

@@ -7,8 +7,20 @@
 import React from "react";
 import type { EventEmit, EntityWith } from "@almadar/core";
 import { type VoteValue } from "./VoteStack";
+/** The per-node entity fields this tree reads. `replies` is the same row shape
+ *  nested recursively; `userVote` carries the `VoteValue` literal union. */
+export interface ReplyNodeRow {
+    authorName: string;
+    content: string;
+    authorAvatarUrl?: string;
+    postedAt?: string;
+    voteCount?: number;
+    userVote?: VoteValue;
+    collapsed?: boolean;
+    replies?: readonly EntityWith<ReplyNodeRow>[];
+}
 export interface ReplyTreeProps {
-    nodes: readonly EntityWith<'id' | 'authorName' | 'content'>[];
+    nodes: readonly EntityWith<ReplyNodeRow>[];
     maxDepth?: number;
     onVote?: (nodeId: string, vote: VoteValue) => void;
     onReply?: (parentNodeId: string) => void;

package/dist/components/core/templates/index.d.ts

@@ -11,6 +11,10 @@ export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext,
 export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/templates/PlatformerTemplate';
 export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/templates/TowerDefenseTemplate';
 export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/templates/RoguelikeTemplate';
+export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/templates/TopDownShooterTemplate';
+export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/templates/CityBuilderTemplate';
+export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/templates/VisualNovelTemplate';
+export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/templates/CardBattlerTemplate';
 export { LandingPageTemplate, type LandingPageTemplateProps, type LandingPageEntity, } from '../../marketing/templates/LandingPageTemplate';
 export { PricingPageTemplate, type PricingPageTemplateProps, type PricingPageEntity, } from '../../marketing/templates/PricingPageTemplate';
 export { FeatureDetailPageTemplate, type FeatureDetailPageTemplateProps, type FeatureDetailPageEntity, type FeatureDetailSection, } from '../../marketing/templates/FeatureDetailPageTemplate';

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

@@ -0,0 +1,35 @@
+import * as React from 'react';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+/** One playable card (icon + title + a few stat numbers). UI value DTO. */
+export interface CardHandCard {
+    id: string;
+    iconUrl?: AssetUrl;
+    title?: string;
+    cost?: number;
+    attack?: number;
+    defense?: number;
+    disabled?: boolean;
+}
+export interface CardHandProps {
+    /** Cards to lay out as a horizontal hand (or grid when wrapped). */
+    cards: CardHandCard[];
+    /** Currently selected card id. */
+    selectedId?: string;
+    /** Card-art size variant. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Direct callback when a (non-disabled) card is clicked. */
+    onCardClick?: (id: string) => void;
+    /** Event-bus event emitted with `{ cardId }` on click. */
+    cardClickEvent?: EventEmit<{
+        cardId: string;
+    }>;
+    /** Empty-state label when there are no cards. */
+    emptyLabel?: string;
+    className?: string;
+}
+/** Pure card-hand molecule: renders a row/grid of cards from props alone. */
+export declare function CardHand({ cards, selectedId, size, onCardClick, cardClickEvent, emptyLabel, className, }: CardHandProps): React.JSX.Element;
+export declare namespace CardHand {
+    var displayName: string;
+}
+export default CardHand;

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

@@ -12,7 +12,7 @@
  * concern analogous to Form's `formData`.
  */
 import React from 'react';
-import type { EventEmit, EventPayload } from '@almadar/core';
+import type { AssetUrl, EventEmit, EventPayload } from '@almadar/core';
 export type DialogueChoice = EventPayload & {
     text: string;
     action?: string;
@@ -53,8 +53,14 @@ export interface DialogueBoxProps {
     }>;
     /** Declarative event: emits UI:{advanceEvent} when dialogue is advanced */
     advanceEvent?: EventEmit<Record<string, never>>;
+    /** Optional full-frame scene image rendered behind the dialogue (visual-novel mode). */
+    backgroundImage?: AssetUrl;
+    /** Optional larger character portrait rendered standing over the scene (visual-novel mode). */
+    portraitUrl?: AssetUrl;
+    /** Multiplier for the large `portraitUrl` height relative to its default (default 1). */
+    portraitScale?: number;
     /** Optional className */
     className?: string;
 }
-export declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, completeEvent, choiceEvent, advanceEvent, className, }: DialogueBoxProps): React.JSX.Element;
+export declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, completeEvent, choiceEvent, advanceEvent, backgroundImage, portraitUrl, portraitScale, className, }: DialogueBoxProps): React.JSX.Element;
 export default DialogueBox;

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

@@ -9,6 +9,7 @@ export { DPad, type DPadProps, type DPadDirection } from './DPad';
 export { ActionButtons, type ActionButtonsProps, type ActionButtonConfig } from './ActionButtons';
 export { StatBadge, type StatBadgeProps } from './StatBadge';
 export { InventoryGrid, type InventoryGridProps, type InventoryGridItem } from './InventoryGrid';
+export { CardHand, type CardHandProps, type CardHandCard } from './CardHand';
 export { QuestTracker, type QuestTrackerProps, type Quest } from './QuestTracker';
 export { CraftingRecipe, type CraftingRecipeProps, type CraftingIngredient } from './CraftingRecipe';
 export { PowerupSlots, type PowerupSlotsProps, type ActivePowerup } from './PowerupSlots';