@almadar/ui 2.61.1 → 3.1.2

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

@@ -8,9 +8,10 @@
  * - Emits: UI:BOOK_NAVIGATE { chapterId }
  */
 import React from 'react';
-import type { EntityDisplayProps } from '../types';
 import type { BookPart } from './types';
-export interface BookTableOfContentsProps extends EntityDisplayProps<BookPart> {
+export interface BookTableOfContentsProps {
+    /** Additional CSS classes */
+    className?: string;
     parts: BookPart[];
     currentChapterId?: string;
     direction?: 'rtl' | 'ltr';

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

@@ -18,8 +18,8 @@
  */
 import React from 'react';
 import type { EntityDisplayProps } from '../types';
-import type { BookData, BookFieldMap } from './types';
-export interface BookViewerProps extends EntityDisplayProps<BookData | Record<string, unknown>> {
+import type { BookFieldMap } from './types';
+export interface BookViewerProps extends EntityDisplayProps {
     /** Initial page index (default: 0 = cover) */
     initialPage?: number;
     /** Field name translation map — a BookFieldMap object or locale key ("ar") */

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/game/three/index.cjs

@@ -1436,11 +1436,15 @@ function getGlobalEventBus() {
 var fallbackListeners = /* @__PURE__ */ new Map();
 var fallbackAnyListeners = /* @__PURE__ */ new Set();
 var fallbackEventBus = {
-  emit: (type, payload) => {
+  emit: (type, payload, source) => {
     const event = {
       type,
+      // Narrow at the bus boundary: public emit accepts an opaque object so
+      // generic UI emit sites don't require casts; the envelope stores the
+      // payload as EventPayload which listeners consume directly.
       payload,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      source
     };
     const handlers = fallbackListeners.get(type);
     log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
@@ -1503,8 +1507,8 @@ function useEventBus() {
 function useEmitEvent() {
   const eventBus = useEventBus();
   return React21.useCallback(
-    (type, payload) => {
-      eventBus.emit(type, payload);
+    (type, payload, source) => {
+      eventBus.emit(type, payload, source);
     },
     [eventBus]
   );

package/dist/components/organisms/game/three/index.js

@@ -1412,11 +1412,15 @@ function getGlobalEventBus() {
 var fallbackListeners = /* @__PURE__ */ new Map();
 var fallbackAnyListeners = /* @__PURE__ */ new Set();
 var fallbackEventBus = {
-  emit: (type, payload) => {
+  emit: (type, payload, source) => {
     const event = {
       type,
+      // Narrow at the bus boundary: public emit accepts an opaque object so
+      // generic UI emit sites don't require casts; the envelope stores the
+      // payload as EventPayload which listeners consume directly.
       payload,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      source
     };
     const handlers = fallbackListeners.get(type);
     log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
@@ -1479,8 +1483,8 @@ function useEventBus() {
 function useEmitEvent() {
   const eventBus = useEventBus();
   return useCallback(
-    (type, payload) => {
-      eventBus.emit(type, payload);
+    (type, payload, source) => {
+      eventBus.emit(type, payload, source);
     },
     [eventBus]
   );

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,21 +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.
      *
-     * Accepts three shapes today; the string branch is deprecated:
-     * - `readonly T[]`: pre-resolved array for list patterns (authoring
-     *   pattern: `entity: @payload.data` from the calling trait).
-     * - `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 when the
-     *   entity store itself is deleted; the prop shape will collapse to
-     *   `readonly T[] | T | undefined`.
+     * 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.
+     *
+     * 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.
      */
-    entity?: string | T | 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/docs/index.cjs

@@ -2570,11 +2570,15 @@ function getGlobalEventBus() {
 var fallbackListeners = /* @__PURE__ */ new Map();
 var fallbackAnyListeners = /* @__PURE__ */ new Set();
 var fallbackEventBus = {
-  emit: (type, payload) => {
+  emit: (type, payload, source) => {
     const event = {
       type,
+      // Narrow at the bus boundary: public emit accepts an opaque object so
+      // generic UI emit sites don't require casts; the envelope stores the
+      // payload as EventPayload which listeners consume directly.
       payload,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      source
     };
     const handlers = fallbackListeners.get(type);
     log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });

package/dist/docs/index.d.cts

@@ -295,7 +295,7 @@ interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
     /** onChange handler - accepts events from input, select, or textarea */
     onChange?: React.ChangeEventHandler<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>;
 }
-declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>>;
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>>;
 
 /**
  * DocSidebar Molecule Component

package/dist/docs/index.js

@@ -2546,11 +2546,15 @@ function getGlobalEventBus() {
 var fallbackListeners = /* @__PURE__ */ new Map();
 var fallbackAnyListeners = /* @__PURE__ */ new Set();
 var fallbackEventBus = {
-  emit: (type, payload) => {
+  emit: (type, payload, source) => {
     const event = {
       type,
+      // Narrow at the bus boundary: public emit accepts an opaque object so
+      // generic UI emit sites don't require casts; the envelope stores the
+      // payload as EventPayload which listeners consume directly.
       payload,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      source
     };
     const handlers = fallbackListeners.get(type);
     log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });

package/dist/hooks/event-bus-types.d.ts

@@ -1,42 +1,34 @@
 /**
  * Event Bus Types
  *
- * Type definitions for the page event bus system.
+ * Re-exports from @almadar/core so every package agrees on the same
+ * bus event envelope. @almadar/ui no longer owns its own KFlowEvent —
+ * that type was folded into core's BusEvent.
  *
  * @packageDocumentation
  */
-/**
- * A KFlow event that can be emitted on the event bus.
- */
-export interface KFlowEvent {
-    /** Event type identifier (e.g., 'TASK_COMPLETED', 'VALIDATION_SUCCESS') */
-    type: string;
-    /** Optional payload data */
-    payload?: Record<string, unknown>;
-    /** Timestamp when the event was emitted */
-    timestamp: number;
-    /** Source trait or component that emitted the event */
-    source?: string;
-}
-/**
- * Event listener callback function.
- */
-export type EventListener = (event: KFlowEvent) => void;
-/**
- * Function to unsubscribe from events.
- */
-export type Unsubscribe = () => void;
+import type { BusEvent, BusEventSource, BusEventListener, Unsubscribe } from "@almadar/core";
+export type { BusEvent, BusEventSource, Unsubscribe };
+export type EventListener = BusEventListener;
 /**
  * Event bus context type.
+ *
+ * `emit` accepts `Record<string, unknown>` on its public surface so
+ * generic UI components (DataGrid, SortableList, ...) can pass
+ * consumer-defined row data without a cast at every emit site. The
+ * envelope stored in `BusEvent.payload` is narrowed to `EventPayload`
+ * inside the bus implementation — listeners always receive the typed
+ * shape.
  */
 export interface EventBusContextType {
     /**
      * Emit an event to all listeners.
      *
      * @param type - Event type identifier
-     * @param payload - Optional payload data
+     * @param payload - Optional payload data (object-shaped)
+     * @param source - Optional origin info (orbital/trait/...)
      */
-    emit: (type: string, payload?: Record<string, unknown>) => void;
+    emit: (type: string, payload?: Record<string, unknown>, source?: BusEventSource) => void;
     /**
      * Subscribe to an event type.
      *
@@ -44,7 +36,7 @@ export interface EventBusContextType {
      * @param listener - Callback function
      * @returns Unsubscribe function
      */
-    on: (type: string, listener: EventListener) => Unsubscribe;
+    on: (type: string, listener: BusEventListener) => Unsubscribe;
     /**
      * Subscribe to an event type, but only fire once.
      *
@@ -52,7 +44,7 @@ export interface EventBusContextType {
      * @param listener - Callback function
      * @returns Unsubscribe function
      */
-    once: (type: string, listener: EventListener) => Unsubscribe;
+    once: (type: string, listener: BusEventListener) => Unsubscribe;
     /**
      * Check if there are any listeners for an event type.
      *
@@ -67,5 +59,5 @@ export interface EventBusContextType {
      * @param listener - Callback function invoked for every emitted event
      * @returns Unsubscribe function
      */
-    onAny?: (listener: EventListener) => Unsubscribe;
+    onAny?: (listener: BusEventListener) => Unsubscribe;
 }

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(() => {
@@ -932,11 +935,15 @@ function getGlobalEventBus() {
 var fallbackListeners = /* @__PURE__ */ new Map();
 var fallbackAnyListeners = /* @__PURE__ */ new Set();
 var fallbackEventBus = {
-  emit: (type, payload) => {
+  emit: (type, payload, source) => {
     const event = {
       type,
+      // Narrow at the bus boundary: public emit accepts an opaque object so
+      // generic UI emit sites don't require casts; the envelope stores the
+      // payload as EventPayload which listeners consume directly.
       payload,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      source
     };
     const handlers = fallbackListeners.get(type);
     log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
@@ -1013,8 +1020,8 @@ function useEventListener(event, handler) {
 function useEmitEvent() {
   const eventBus = useEventBus();
   return React.useCallback(
-    (type, payload) => {
-      eventBus.emit(type, payload);
+    (type, payload, source) => {
+      eventBus.emit(type, payload, source);
     },
     [eventBus]
   );
@@ -1585,8 +1592,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.d.ts

@@ -11,7 +11,7 @@ export { useAgentChat } from './useAgentChat';
 export { useValidation } from './useValidation';
 export { useDeepAgentGeneration } from './useDeepAgentGeneration';
 export { useEventBus, useEventListener, useEmitEvent } from './useEventBus';
-export type { KFlowEvent, EventListener, Unsubscribe, EventBusContextType } from './event-bus-types';
+export type { BusEvent, BusEventSource, EventListener, Unsubscribe, EventBusContextType, } from './event-bus-types';
 export { useUISlotManager, DEFAULT_SLOTS, type UISlot, type SlotAnimation, type SlotContent, type RenderUIConfig, type SlotChangeCallback, type UISlotManager, } from './useUISlots';
 export { useUIEvents, useSelectedEntity } from './useUIEvents';
 export { useEntityList, useEntityDetail, useEntity, useEntityListSuspense, useEntitySuspense, entityDataKeys, EntityDataProvider, useEntityDataAdapter, type EntityDataAdapter, type EntityDataRecord, type UseEntityListOptions, type UseEntityListResult, type UseEntityDetailResult, } from './useEntityData';

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(() => {
@@ -926,11 +929,15 @@ function getGlobalEventBus() {
 var fallbackListeners = /* @__PURE__ */ new Map();
 var fallbackAnyListeners = /* @__PURE__ */ new Set();
 var fallbackEventBus = {
-  emit: (type, payload) => {
+  emit: (type, payload, source) => {
     const event = {
       type,
+      // Narrow at the bus boundary: public emit accepts an opaque object so
+      // generic UI emit sites don't require casts; the envelope stores the
+      // payload as EventPayload which listeners consume directly.
       payload,
-      timestamp: Date.now()
+      timestamp: Date.now(),
+      source
     };
     const handlers = fallbackListeners.get(type);
     log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
@@ -1007,8 +1014,8 @@ function useEventListener(event, handler) {
 function useEmitEvent() {
   const eventBus = useEventBus();
   return useCallback(
-    (type, payload) => {
-      eventBus.emit(type, payload);
+    (type, payload, source) => {
+      eventBus.emit(type, payload, source);
     },
     [eventBus]
   );
@@ -1579,8 +1586,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/useEventBus.d.ts

@@ -1,5 +1,5 @@
-import type { KFlowEvent, EventListener, Unsubscribe, EventBusContextType } from './event-bus-types';
-export type { KFlowEvent, EventListener, Unsubscribe, EventBusContextType };
+import type { BusEvent, BusEventSource, EventListener, Unsubscribe, EventBusContextType } from './event-bus-types';
+export type { BusEvent, BusEventSource, EventListener, Unsubscribe, EventBusContextType };
 declare global {
     interface Window {
         __kflowEventBus?: EventBusContextType | null;
@@ -92,5 +92,5 @@ export declare const useEventSubscription: typeof useEventListener;
  * };
  * ```
  */
-export declare function useEmitEvent(): (type: string, payload?: Record<string, unknown>) => void;
+export declare function useEmitEvent(): (type: string, payload?: Record<string, unknown>, source?: BusEventSource) => void;
 export default useEventBus;

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";
   }
 };

package/dist/lib/verificationRegistry.d.ts

@@ -9,6 +9,7 @@
  *
  * @packageDocumentation
  */
+import type { BusEvent, EventPayload } from '@almadar/core';
 export type CheckStatus = "pass" | "fail" | "pending" | "warn";
 export interface VerificationCheck {
     id: string;
@@ -91,7 +92,7 @@ export type AssetLoadStatus = "loaded" | "failed" | "pending";
 /** Event bus log entry for verification */
 export interface EventLogEntry {
     type: string;
-    payload?: Record<string, unknown>;
+    payload?: EventPayload;
     timestamp: number;
 }
 /** Exposed on window for Playwright to query */
@@ -132,10 +133,7 @@ export declare function waitForTransition(event: string, timeoutMs?: number): Pr
  */
 export declare function bindEventBus(eventBus: {
     emit: (type: string, payload?: Record<string, unknown>) => void;
-    onAny?: (listener: (event: {
-        type: string;
-        payload?: Record<string, unknown>;
-    }) => void) => () => void;
+    onAny?: (listener: (event: BusEvent) => void) => () => void;
 }): void;
 /**
  * Bind a trait state getter so automation can query current states.