@almadar/ui 2.61.0 → 3.0.1

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

@@ -1,10 +1,15 @@
 /**
  * BookViewer shared types
  *
- * Field names are canonical English. When entity data arrives from a
- * schema with non-English field names (e.g. Arabic .orb), a field map
- * translates them before passing to BookViewer. See `mapBookData()`.
+ * `BookData` / `BookPart` / `BookChapter` are rendering-layer content-model
+ * types: they carry a typed `OrbitalSchema` (via `@almadar/core`) for the
+ * embedded orbital-diagram feature, which is richer than `FieldValue` and
+ * therefore cannot satisfy `EntityRow`'s primitive-field constraint. The
+ * BookViewer organism's prop surface IS `EntityRow` — raw schema data bound
+ * from `@payload.data`; `mapBookData()` normalises those records (English or
+ * localised) into the typed `BookData` representation at render time.
  */
+import type { OrbitalSchema } from '@almadar/core';
 export interface BookData {
     title: string;
     subtitle?: string;
@@ -21,7 +26,7 @@ export interface BookChapter {
     id: string;
     title: string;
     content: string;
-    orbitalSchema?: unknown;
+    orbitalSchema?: OrbitalSchema;
 }
 /**
  * Maps raw entity field names to canonical BookData field names.

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

@@ -19,7 +19,6 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EntityDisplayProps } from '../types';
 import type { IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
 /** A hero on the world map */
@@ -102,7 +101,15 @@ export interface WorldMapEntity {
  *  Emits: UI:FEATURE_ENTER
  *  Emits: UI:TILE_CLICK
  */
-export interface WorldMapBoardProps extends EntityDisplayProps<WorldMapEntity> {
+export interface WorldMapBoardProps {
+    /** Additional CSS classes */
+    className?: string;
+    /** Loading state indicator */
+    isLoading?: boolean;
+    /** Error state */
+    error?: Error | null;
+    /** World map entity data */
+    entity?: WorldMapEntity | readonly WorldMapEntity[];
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */
@@ -147,7 +154,6 @@ export interface WorldMapBoardProps extends EntityDisplayProps<WorldMapEntity> {
     enableCamera?: boolean;
     effectSpriteUrls?: string[];
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
-    className?: string;
 }
 export declare function WorldMapBoard({ entity, isLoading, scale, unitScale, allowMoveAllHeroes, isInRange, heroSelectEvent, heroMoveEvent, battleEncounterEvent, featureEnterEvent, tileClickEvent, header, sidePanel, overlay, footer, onHeroSelect, onHeroMove, onBattleEncounter, onFeatureEnter, diamondTopY, enableCamera, effectSpriteUrls, resolveUnitFrame, className, }: WorldMapBoardProps): React.JSX.Element;
 export declare namespace WorldMapBoard {

package/dist/components/organisms/marketing-types.d.ts

@@ -1,21 +1,31 @@
 /**
  * Marketing Entity Types
  *
- * Shared entity interfaces for marketing/landing-page organisms.
- * These types define the data shapes consumed by HeroOrganism,
- * FeatureGridOrganism, PricingOrganism, StatsOrganism,
- * StepFlowOrganism, ShowcaseOrganism, TeamOrganism, and CaseStudyOrganism.
+ * Shared entity interfaces for marketing/landing-page organisms (HeroOrganism,
+ * FeatureGridOrganism, PricingOrganism, StatsOrganism, StepFlowOrganism,
+ * ShowcaseOrganism, TeamOrganism, CaseStudyOrganism).
+ *
+ * Every marketing entity extends `@almadar/core`'s `EntityRow` so the
+ * canonical runtime entity shape lives in core. Marketing data is pure
+ * JSON-serialisable content (strings, numbers, nested records) with no
+ * React nodes or callbacks, so the `EntityRow` index signature is satisfied
+ * structurally. Nested `MarketingAction` / `MarketingImage` carry explicit
+ * `[key: string]: FieldValue | undefined` signatures so they fit the
+ * `{ [key: string]: FieldValue }` branch of `FieldValue`.
  */
+import type { EntityRow, FieldValue } from '@almadar/core';
 export interface MarketingAction {
+    [key: string]: FieldValue | undefined;
     label: string;
     href: string;
     variant?: 'primary' | 'secondary' | 'ghost';
 }
 export interface MarketingImage {
+    [key: string]: FieldValue | undefined;
     src: string;
     alt: string;
 }
-export interface HeroEntity {
+export interface HeroEntity extends EntityRow {
     id: string;
     tag?: string;
     title: string;
@@ -28,7 +38,7 @@ export interface HeroEntity {
     imagePosition?: 'below' | 'right' | 'background';
     background?: 'dark' | 'gradient' | 'subtle';
 }
-export interface FeatureEntity {
+export interface FeatureEntity extends EntityRow {
     id: string;
     icon?: string;
     title: string;
@@ -36,7 +46,7 @@ export interface FeatureEntity {
     href?: string;
     linkLabel?: string;
 }
-export interface PricingPlanEntity {
+export interface PricingPlanEntity extends EntityRow {
     id: string;
     name: string;
     price: string;
@@ -47,19 +57,19 @@ export interface PricingPlanEntity {
     highlighted?: boolean;
     badge?: string;
 }
-export interface StatEntity {
+export interface StatEntity extends EntityRow {
     id: string;
     value: string;
     label: string;
 }
-export interface StepEntity {
+export interface StepEntity extends EntityRow {
     id: string;
     number?: number;
     title: string;
     description: string;
     icon?: string;
 }
-export interface ShowcaseEntity {
+export interface ShowcaseEntity extends EntityRow {
     id: string;
     title: string;
     description?: string;
@@ -68,7 +78,7 @@ export interface ShowcaseEntity {
     badge?: string;
     accentColor?: string;
 }
-export interface TeamMemberEntity {
+export interface TeamMemberEntity extends EntityRow {
     id: string;
     name: string;
     nameAr?: string;
@@ -76,7 +86,7 @@ export interface TeamMemberEntity {
     bio: string;
     avatar?: string;
 }
-export interface CaseStudyEntity {
+export interface CaseStudyEntity extends EntityRow {
     id: string;
     title: string;
     description: string;

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

@@ -7,6 +7,7 @@
  * Exception: Form manages local `formData` state for field input tracking.
  * This is the ONE allowed exception — documented here.
  */
+import type { EntityRow } from '@almadar/core';
 export declare const EntityDisplayEvents: {
     readonly SORT: "SORT";
     readonly PAGINATE: "PAGINATE";
@@ -35,27 +36,32 @@ export interface FilterPayload {
 export interface SelectPayload {
     ids: (string | number)[];
 }
-export interface EntityDisplayProps<T = unknown> {
+export interface EntityDisplayProps<T extends EntityRow = EntityRow> {
     /**
-     * Entity data or a legacy entity-name string.
+     * Pre-resolved entity data, typed against `@almadar/core`'s `EntityRow`
+     * (`{ id?: string } & Record<string, FieldValue>`) so the single source of
+     * truth for runtime entity shape lives in core. Consumers narrow via the
+     * generic parameter; the constraint guarantees every organism receives
+     * something with an optional `id` and a Record of `FieldValue` fields.
      *
-     * V2 Phase 2 accepts three shapes here (value-first is the canonical path):
-     * - `readonly T[]`: pre-resolved array for list patterns.
-     * - `T`: pre-resolved single record for detail patterns.
-     * - `string`: legacy entity-type name resolved by the renderer via
-     *   `useEntityRef`. Emits a dev-mode deprecation warning; removal
-     *   scheduled for Phase 6 of docs/Almadar_Entity_V2_Plan.md.
+     * Two shapes accepted:
+     * - `readonly T[]`: array for list patterns (authoring: `entity: @payload.data`
+     *   on the calling trait after a `fetch … { emit: { success } }` listener).
+     * - `T`: single record for detail patterns.
      *
-     * Prefer `items` for list shapes so organisms never depend on the
-     * renderer's string resolution at all.
-     */
-    entity?: string | T | readonly T[];
-    /**
-     * Pre-resolved list of records. V2 Phase 2 addition. When set, organisms
-     * should read data from here instead of `entity`. Resolving from the
-     * calling trait's `@payload.data` is the authoring pattern.
+     * The legacy `string` (entity-name) branch was removed in V2 Phase 6. The
+     * EntityStore resolver is gone; components now receive pre-resolved data via
+     * the event bus.
+     *
+     * NOTE: Several legacy organisms (HeroOrganism, TeamOrganism, CaseStudyOrganism,
+     * MediaGallery, PricingOrganism, ShowcaseOrganism, StatsOrganism, Sidebar,
+     * Timeline, StepFlowOrganism, FeatureGridOrganism, book/*, WorldMapBoard,
+     * StateMachineView, JazariStateMachine, MasterDetail, DataTable, Table) define
+     * local entity types (HeroEntity, TeamMemberEntity, …) that don't formally
+     * extend `EntityRow`. They surface `EntityDisplayProps<T>` constraint errors.
+     * Tracked as a Phase 7 follow-up in `docs/Almadar_Entity_V2_Plan.md` §10.
      */
-    items?: readonly T[];
+    entity?: T | readonly T[];
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */

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

@@ -15,8 +15,13 @@ export interface TemplateProps<E extends {
 } = {
     id: string;
 }> {
-    /** Entity data — single object, array from compiler, or string entity name */
-    entity?: string | E | readonly E[];
+    /**
+     * 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.
+     */
+    entity?: E | readonly E[];
     /** External styling override */
     className?: string;
 }

package/dist/hooks/index.cjs

@@ -8,6 +8,9 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var React__default = /*#__PURE__*/_interopDefault(React);
 
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 function useOrbitalHistory(options) {
   const { appId, authToken, userId, onHistoryChange, onRevertSuccess } = options;
   const getHeaders2 = React.useCallback(() => {
@@ -1585,8 +1588,8 @@ var API_BASE_URL = typeof process !== "undefined" && process.env?.VITE_API_URL ?
 var ApiError = class extends Error {
   constructor(status, statusText, message) {
     super(message || `API Error: ${status} ${statusText}`);
-    this.status = status;
-    this.statusText = statusText;
+    __publicField(this, "status", status);
+    __publicField(this, "statusText", statusText);
     this.name = "ApiError";
   }
 };

package/dist/hooks/index.js

@@ -2,6 +2,9 @@ import React, { createContext, useCallback, useState, useEffect, useMemo, useCon
 import { EventBusContext, SelectionContext } from '@almadar/ui/providers';
 import { useQueryClient, useMutation, useQuery } from '@tanstack/react-query';
 
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 function useOrbitalHistory(options) {
   const { appId, authToken, userId, onHistoryChange, onRevertSuccess } = options;
   const getHeaders2 = useCallback(() => {
@@ -1579,8 +1582,8 @@ var API_BASE_URL = typeof process !== "undefined" && process.env?.VITE_API_URL ?
 var ApiError = class extends Error {
   constructor(status, statusText, message) {
     super(message || `API Error: ${status} ${statusText}`);
-    this.status = status;
-    this.statusText = statusText;
+    __publicField(this, "status", status);
+    __publicField(this, "statusText", statusText);
     this.name = "ApiError";
   }
 };

package/dist/lib/index.cjs

@@ -3,6 +3,9 @@
 var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
 
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 function cn(...inputs) {
   return tailwindMerge.twMerge(clsx.clsx(inputs));
 }
@@ -12,8 +15,8 @@ var API_BASE_URL = typeof process !== "undefined" && process.env?.VITE_API_URL ?
 var ApiError = class extends Error {
   constructor(status, statusText, message) {
     super(message || `API Error: ${status} ${statusText}`);
-    this.status = status;
-    this.statusText = statusText;
+    __publicField(this, "status", status);
+    __publicField(this, "statusText", statusText);
     this.name = "ApiError";
   }
 };

package/dist/lib/index.js

@@ -1,6 +1,9 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
@@ -10,8 +13,8 @@ var API_BASE_URL = typeof process !== "undefined" && process.env?.VITE_API_URL ?
 var ApiError = class extends Error {
   constructor(status, statusText, message) {
     super(message || `API Error: ${status} ${statusText}`);
-    this.status = status;
-    this.statusText = statusText;
+    __publicField(this, "status", status);
+    __publicField(this, "statusText", statusText);
     this.name = "ApiError";
   }
 };