@almadar/ui 5.17.0 → 5.17.1

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/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,15 +9,15 @@ export interface CraftingIngredient {
     required: number;
     /** Number currently available */
     available: number;
-}
-export interface CraftingOutput {
+};
+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[];

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

@@ -9,6 +9,7 @@
  */
 import React from "react";
 import type { EventKey, EventPayload } from "@almadar/core";
+import type { UiError } from "../atoms/types";
 /**
  * Allowed element types for custom patterns.
  */
@@ -52,7 +53,7 @@ export interface CustomPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }

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

@@ -45,7 +45,7 @@ export interface DataTableProps<T extends EntityRow & {
         variant?: "default" | "primary" | "secondary" | "ghost" | "danger" | string;
         onClick?: (row: T) => void;
     }[];
-    emptyIcon?: LucideIcon;
+    emptyIcon?: LucideIcon | string;
     emptyTitle?: string;
     emptyDescription?: string;
     emptyAction?: DataTableEmptyAction;

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

@@ -12,7 +12,7 @@
  * - Nested sections with collapsible support
  */
 import React from "react";
-import type { EventKey } from "@almadar/core";
+import type { EventKey, FieldValue } from "@almadar/core";
 import { type SelectOption } from "../atoms/Select";
 import { type RelationOption } from "../molecules/RelationSelect";
 import type { OrbitalEntity } from "@almadar/core";
@@ -202,8 +202,8 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     /** Callback when any field value changes */
     onFieldChange?: (change: {
         fieldId: string;
-        value: unknown;
-        formValues: Record<string, unknown>;
+        value: FieldValue | undefined;
+        formValues: Record<string, FieldValue | undefined>;
     }) => void;
     /** Config path for form configuration (schema-driven) */
     configPath?: string;

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

@@ -10,6 +10,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { UiError } from '../atoms/types';
 import { type StackGap, type StackAlign, type StackJustify } from '../atoms/Stack';
 import { type BoxPadding, type BoxBg, type BoxRounded, type BoxShadow } from '../atoms/Box';
 import { type GridCols, type GridGap, type ResponsiveGridCols } from '../molecules/Grid';
@@ -27,7 +28,7 @@ export interface LayoutPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }
@@ -130,7 +131,7 @@ export interface SpacerPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }
@@ -157,7 +158,7 @@ export interface DividerPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }

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

@@ -18,14 +18,14 @@ import React from 'react';
 import type { DomLayoutData, DomStateNode, DomTransitionLabel, VisualizerConfig } from '../../lib/visualizer/index.js';
 import type { UiError } from '../atoms/types';
 /** Bundled transitions between same from→to states */
-export interface TransitionBundle {
+export type TransitionBundle = {
     id: string;
     from: string;
     to: string;
     labels: DomTransitionLabel[];
     isBidirectional: boolean;
     isReverse: boolean;
-}
+};
 export interface StateMachineViewProps {
     /** Additional CSS classes */
     className?: string;
@@ -33,7 +33,10 @@ export interface StateMachineViewProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    layoutData: DomLayoutData;
+    /** Pre-computed visualizer layout. Optional: when absent the view renders
+     *  nothing (an author wires real layout via config; the generic factory
+     *  can't synthesize a `DomLayoutData`). */
+    layoutData?: DomLayoutData;
     /** Custom state node renderer — when provided, replaces the default circle nodes */
     renderStateNode?: (state: DomStateNode, config: VisualizerConfig) => React.ReactNode;
 }

package/dist/components/organisms/book/types.d.ts

@@ -22,12 +22,12 @@ export interface BookPart {
     title: string;
     chapters: BookChapter[];
 }
-export interface BookChapter {
+export type BookChapter = {
     id: string;
     title: string;
     content: string;
     orbitalSchema?: OrbitalSchema;
-}
+};
 /**
  * Maps raw entity field names to canonical BookData field names.
  * Each key is a canonical field, each value is the entity field name.

package/dist/components/organisms/game/CastleBoard.d.ts

@@ -13,7 +13,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 /** Entity shape consumed by CastleBoard */
 export interface CastleEntity {
@@ -53,8 +53,9 @@ export type CastleSlotContext = {
     scale: number;
 };
 export interface CastleBoardProps {
-    /** Castle entity data */
-    entity: CastleEntity;
+    /** Castle entity data. Also accepts the canonical `EntityRow` the compiler
+     *  binds (and arrays); narrowed to `CastleEntity` internally. */
+    entity?: CastleEntity | EntityRow | readonly (CastleEntity | EntityRow)[];
     /** Canvas render scale */
     scale?: number;
     /** Top bar / header */

package/dist/components/organisms/game/TraitStateViewer.d.ts

@@ -12,19 +12,19 @@
 import React from 'react';
 import { type StateStyle } from '../../atoms/game/StateIndicator';
 import type { UiError } from '../../atoms/types';
-export interface TraitTransition {
+export type TraitTransition = {
     from: string;
     to: string;
     event: string;
     guardHint?: string;
-}
-export interface TraitStateMachineDefinition {
+};
+export type TraitStateMachineDefinition = {
     name: string;
     states: string[];
     currentState: string;
     transitions: TraitTransition[];
     description?: string;
-}
+};
 export interface TraitStateViewerProps {
     /** The trait / state machine to visualize */
     trait: TraitStateMachineDefinition;

package/dist/components/organisms/game/UncontrolledBattleBoard.d.ts

@@ -13,13 +13,18 @@
  *
  * @packageDocumentation
  */
+import * as React from 'react';
+import type { EntityRow } from '@almadar/core';
 import { type BattleBoardProps, type BattleUnit } from './BattleBoard';
+/** Uncontrolled entity read-shape: controlled game-state fields are dropped in
+ *  favor of `initialUnits`, which the internal `useBattleState` hook manages. */
+export type UncontrolledBattleEntity = Omit<BattleBoardProps['entity'], 'units' | 'phase' | 'turn' | 'gameResult' | 'selectedUnitId'> & {
+    initialUnits: BattleUnit[];
+};
 export interface UncontrolledBattleBoardProps extends Omit<BattleBoardProps, 'entity'> {
-    entity: Omit<BattleBoardProps['entity'], 'units' | 'phase' | 'turn' | 'gameResult' | 'selectedUnitId'> & {
-        initialUnits: BattleUnit[];
-    };
+    entity?: UncontrolledBattleEntity | EntityRow | readonly (UncontrolledBattleEntity | EntityRow)[];
 }
-export declare function UncontrolledBattleBoard({ entity, ...rest }: UncontrolledBattleBoardProps): import("react/jsx-runtime").JSX.Element;
+export declare function UncontrolledBattleBoard({ entity, ...rest }: UncontrolledBattleBoardProps): React.JSX.Element | null;
 export declare namespace UncontrolledBattleBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/WorldMapBoard.d.ts

@@ -19,7 +19,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow, FieldValue } from '@almadar/core';
 import type { IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
 import type { UiError } from '../../atoms/types';
@@ -50,7 +50,7 @@ export type MapHex = {
     terrain: string;
     terrainSprite?: string;
     feature?: string;
-    featureData?: Record<string, unknown>;
+    featureData?: Record<string, FieldValue | undefined>;
     passable?: boolean;
 };
 /** Context exposed to render-prop slots */
@@ -110,8 +110,9 @@ export interface WorldMapBoardProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** World map entity data */
-    entity?: WorldMapEntity | readonly WorldMapEntity[];
+    /** World map entity data. Also accepts the canonical `EntityRow` the
+     *  compiler binds; the component narrows to `WorldMapEntity` below. */
+    entity?: WorldMapEntity | EntityRow | readonly (WorldMapEntity | EntityRow)[];
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */

package/dist/components/organisms/game/puzzles/builder/BuilderBoard.d.ts

@@ -9,7 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface BuilderComponent {
     id: string;
@@ -44,13 +44,13 @@ export interface BuilderPuzzleEntity {
     };
 }
 export interface BuilderBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: BuilderPuzzleEntity;
+    entity?: BuilderPuzzleEntity | EntityRow | readonly (BuilderPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function BuilderBoard({ entity, completeEvent, className, }: BuilderBoardProps): React.JSX.Element;
+export declare function BuilderBoard({ entity, completeEvent, className, }: BuilderBoardProps): React.JSX.Element | null;
 export declare namespace BuilderBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/classifier/ClassifierBoard.d.ts

@@ -10,7 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface ClassifierItem {
     id: string;
@@ -45,13 +45,13 @@ export interface ClassifierPuzzleEntity {
     };
 }
 export interface ClassifierBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: ClassifierPuzzleEntity;
+    entity?: ClassifierPuzzleEntity | EntityRow | readonly (ClassifierPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function ClassifierBoard({ entity, completeEvent, className, }: ClassifierBoardProps): React.JSX.Element;
+export declare function ClassifierBoard({ entity, completeEvent, className, }: ClassifierBoardProps): React.JSX.Element | null;
 export declare namespace ClassifierBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/debugger/DebuggerBoard.d.ts

@@ -9,7 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface DebuggerLine {
     id: string;
@@ -37,13 +37,13 @@ export interface DebuggerPuzzleEntity {
     };
 }
 export interface DebuggerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: DebuggerPuzzleEntity;
+    entity?: DebuggerPuzzleEntity | EntityRow | readonly (DebuggerPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function DebuggerBoard({ entity, completeEvent, className, }: DebuggerBoardProps): React.JSX.Element;
+export declare function DebuggerBoard({ entity, completeEvent, className, }: DebuggerBoardProps): React.JSX.Element | null;
 export declare namespace DebuggerBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/event-handler/EventHandlerBoard.d.ts

@@ -11,7 +11,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 import { type PuzzleObjectDef } from './ObjectRulePanel';
 export interface EventHandlerPuzzleEntity {
@@ -40,8 +40,11 @@ export interface EventHandlerPuzzleEntity {
     };
 }
 export interface EventHandlerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Puzzle data */
-    entity: EventHandlerPuzzleEntity;
+    /** Puzzle data. The compiler binds the generic `EntityRow`, so the inlet
+     *  accepts it (and arrays) as union members; the component narrows to its
+     *  curated `EventHandlerPuzzleEntity` read-shape below (a valid
+     *  union-narrow) and renders nothing until a puzzle entity is present. */
+    entity?: EventHandlerPuzzleEntity | EntityRow | readonly (EventHandlerPuzzleEntity | EntityRow)[];
     /** Playback speed in ms per event */
     stepDurationMs?: number;
     /** Emits UI:{playEvent} */
@@ -51,7 +54,7 @@ export interface EventHandlerBoardProps extends Omit<EntityDisplayProps, 'entity
         success: boolean;
     }>;
 }
-export declare function EventHandlerBoard({ entity, stepDurationMs, playEvent, completeEvent, className, }: EventHandlerBoardProps): React.JSX.Element;
+export declare function EventHandlerBoard({ entity, stepDurationMs, playEvent, completeEvent, className, }: EventHandlerBoardProps): React.JSX.Element | null;
 export declare namespace EventHandlerBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/event-handler/ObjectRulePanel.d.ts

@@ -9,7 +9,7 @@
  */
 import React from 'react';
 import { type RuleDefinition } from './RuleEditor';
-export interface PuzzleObjectDef {
+export type PuzzleObjectDef = {
     id: string;
     name: string;
     icon: string;
@@ -27,7 +27,7 @@ export interface PuzzleObjectDef {
     rules: RuleDefinition[];
     /** Max rules allowed on this object */
     maxRules?: number;
-}
+};
 export interface ObjectRulePanelProps {
     /** The selected object */
     object: PuzzleObjectDef;

package/dist/components/organisms/game/puzzles/negotiator/NegotiatorBoard.d.ts

@@ -11,7 +11,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface NegotiatorAction {
     id: string;
@@ -46,13 +46,13 @@ export interface NegotiatorPuzzleEntity {
     };
 }
 export interface NegotiatorBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: NegotiatorPuzzleEntity;
+    entity?: NegotiatorPuzzleEntity | EntityRow | readonly (NegotiatorPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         score: number;
     }>;
 }
-export declare function NegotiatorBoard({ entity, completeEvent, className, }: NegotiatorBoardProps): React.JSX.Element;
+export declare function NegotiatorBoard({ entity, completeEvent, className, }: NegotiatorBoardProps): React.JSX.Element | null;
 export declare namespace NegotiatorBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/sequencer/SequencerBoard.d.ts

@@ -18,7 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { SlotItemData } from '../../TraitSlot';
 import type { EntityDisplayProps } from '../../../types';
 export interface SequencerPuzzleEntity {
@@ -52,8 +52,9 @@ export interface SequencerPuzzleEntity {
     };
 }
 export interface SequencerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Puzzle data */
-    entity: SequencerPuzzleEntity;
+    /** Puzzle data. Also accepts the canonical `EntityRow` the compiler binds
+     *  (and arrays); narrowed to `SequencerPuzzleEntity` internally. */
+    entity?: SequencerPuzzleEntity | EntityRow | readonly (SequencerPuzzleEntity | EntityRow)[];
     /** Category → color mapping */
     categoryColors?: Record<string, {
         bg: string;
@@ -71,7 +72,7 @@ export interface SequencerBoardProps extends Omit<EntityDisplayProps, 'entity'>
         sequence: string[];
     }>;
 }
-export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, className, }: SequencerBoardProps): React.JSX.Element;
+export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, className, }: SequencerBoardProps): React.JSX.Element | null;
 export declare namespace SequencerBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/simulator/SimulatorBoard.d.ts

@@ -10,7 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface SimulatorParameter {
     id: string;
@@ -46,13 +46,13 @@ export interface SimulatorPuzzleEntity {
     };
 }
 export interface SimulatorBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: SimulatorPuzzleEntity;
+    entity?: SimulatorPuzzleEntity | EntityRow | readonly (SimulatorPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function SimulatorBoard({ entity, completeEvent, className, }: SimulatorBoardProps): React.JSX.Element;
+export declare function SimulatorBoard({ entity, completeEvent, className, }: SimulatorBoardProps): React.JSX.Element | null;
 export declare namespace SimulatorBoard {
     var displayName: string;
 }

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

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 import { type VariableDef } from './VariablePanel';
 export interface StateArchitectTransition {
@@ -61,8 +61,9 @@ export interface StateArchitectPuzzleEntity {
     };
 }
 export interface StateArchitectBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Puzzle data */
-    entity: StateArchitectPuzzleEntity;
+    /** Puzzle data. Also accepts the canonical `EntityRow` the compiler binds
+     *  (and arrays); narrowed to `StateArchitectPuzzleEntity` internally. */
+    entity?: StateArchitectPuzzleEntity | EntityRow | readonly (StateArchitectPuzzleEntity | EntityRow)[];
     /** Playback speed */
     stepDurationMs?: number;
     /** Emits UI:{testEvent} */
@@ -73,7 +74,7 @@ export interface StateArchitectBoardProps extends Omit<EntityDisplayProps, 'enti
         passedTests: number;
     }>;
 }
-export declare function StateArchitectBoard({ entity, stepDurationMs, testEvent, completeEvent, className, }: StateArchitectBoardProps): React.JSX.Element;
+export declare function StateArchitectBoard({ entity, stepDurationMs, testEvent, completeEvent, className, }: StateArchitectBoardProps): React.JSX.Element | null;
 export declare namespace StateArchitectBoard {
     var displayName: string;
 }

package/dist/components/templates/GenericAppTemplate.d.ts

@@ -7,12 +7,7 @@
  */
 import React from "react";
 import type { TemplateProps } from "./types";
-interface GenericAppEntity {
-    id: string;
-    title?: string;
-    subtitle?: string;
-}
-export interface GenericAppTemplateProps extends TemplateProps<GenericAppEntity> {
+export interface GenericAppTemplateProps extends TemplateProps {
     /** Page title */
     title: string;
     /** Subtitle or description */
@@ -27,4 +22,3 @@ export interface GenericAppTemplateProps extends TemplateProps<GenericAppEntity>
     className?: string;
 }
 export declare const GenericAppTemplate: React.FC<GenericAppTemplateProps>;
-export {};

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

@@ -9,19 +9,27 @@
  *
  * @see docs/Almadar_Templates.md
  */
-/** Base props for all templates — enforces entity-only data flow. */
+import type { EntityRow } from "@almadar/core";
+/** Base props for all templates — enforces entity-only data flow.
+ *
+ * The constraint is `{ id?: string }` (optional id) so the canonical
+ * `EntityRow` from `@almadar/core` — whose `id` is optional — satisfies it. */
 export interface TemplateProps<E extends {
-    id: string;
-} = {
-    id: string;
-}> {
+    id?: string;
+} = EntityRow> {
     /**
      * Entity data — single object or array (pre-resolved by the compiler
      * from `@payload.data` on the calling trait). The legacy `string`
      * entity-name branch was removed in V2 Phase 6 along with the
      * EntityStore resolver.
+     *
+     * The inlet always also accepts the canonical `EntityRow` (and arrays of
+     * it), because the compiler binds the generic data-store row regardless of
+     * a template's curated read-shape `E`. A template that reads specific
+     * fields narrows `entity` to `E` internally (a valid union-narrow) — no
+     * `as unknown` cast and no per-template inlet widening required.
      */
-    entity?: E | readonly E[];
+    entity?: E | EntityRow | readonly (E | EntityRow)[];
     /** External styling override */
     className?: string;
 }