@almadar/ui 5.75.0 → 5.76.1

package/dist/marketing/index.cjs

@@ -3121,7 +3121,7 @@ var libPromises = /* @__PURE__ */ new Map();
 function loadLib(key, importer) {
   let p = libPromises.get(key);
   if (!p) {
-    p = importer().then((m) => m);
+    p = importer();
     libPromises.set(key, p);
   }
   return p;
@@ -3170,9 +3170,9 @@ function resolveLucide(name) {
   const pascal = kebabToPascal(name);
   const lucideMap = LucideIcons2__namespace;
   const direct = lucideMap[pascal];
-  if (direct && typeof direct === "object") return direct;
+  if (direct && typeof direct === "function") return direct;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "object") return asIs;
+  if (asIs && typeof asIs === "function") return asIs;
   return LucideIcons2__namespace.HelpCircle;
 }
 var phosphorAliases = {
@@ -3339,7 +3339,7 @@ function resolvePhosphor(name, weight, family) {
     () => import('@phosphor-icons/react'),
     (lib) => {
       const PhosphorComp = lib[target];
-      if (!PhosphorComp || typeof PhosphorComp !== "object") return null;
+      if (!PhosphorComp) return null;
       const Component = PhosphorComp;
       const Adapter = (props) => /* @__PURE__ */ jsxRuntime.jsx(
         Component,
@@ -3520,7 +3520,7 @@ function resolveTabler(name, family) {
     () => import('@tabler/icons-react'),
     (lib) => {
       const TablerComp = lib[target];
-      if (!TablerComp || typeof TablerComp !== "object") return null;
+      if (!TablerComp) return null;
       const Component = TablerComp;
       const Adapter = (props) => /* @__PURE__ */ jsxRuntime.jsx(
         Component,
@@ -3705,7 +3705,7 @@ function resolveFa(name, family) {
     () => import('react-icons/fa'),
     (lib) => {
       const FaComp = lib[target];
-      if (!FaComp || typeof FaComp !== "function") return null;
+      if (!FaComp) return null;
       const Component = FaComp;
       const Adapter = (props) => /* @__PURE__ */ jsxRuntime.jsx(
         Component,

package/dist/marketing/index.js

@@ -3097,7 +3097,7 @@ var libPromises = /* @__PURE__ */ new Map();
 function loadLib(key, importer) {
   let p = libPromises.get(key);
   if (!p) {
-    p = importer().then((m) => m);
+    p = importer();
     libPromises.set(key, p);
   }
   return p;
@@ -3146,9 +3146,9 @@ function resolveLucide(name) {
   const pascal = kebabToPascal(name);
   const lucideMap = LucideIcons2;
   const direct = lucideMap[pascal];
-  if (direct && typeof direct === "object") return direct;
+  if (direct && typeof direct === "function") return direct;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "object") return asIs;
+  if (asIs && typeof asIs === "function") return asIs;
   return LucideIcons2.HelpCircle;
 }
 var phosphorAliases = {
@@ -3315,7 +3315,7 @@ function resolvePhosphor(name, weight, family) {
     () => import('@phosphor-icons/react'),
     (lib) => {
       const PhosphorComp = lib[target];
-      if (!PhosphorComp || typeof PhosphorComp !== "object") return null;
+      if (!PhosphorComp) return null;
       const Component = PhosphorComp;
       const Adapter = (props) => /* @__PURE__ */ jsx(
         Component,
@@ -3496,7 +3496,7 @@ function resolveTabler(name, family) {
     () => import('@tabler/icons-react'),
     (lib) => {
       const TablerComp = lib[target];
-      if (!TablerComp || typeof TablerComp !== "object") return null;
+      if (!TablerComp) return null;
       const Component = TablerComp;
       const Adapter = (props) => /* @__PURE__ */ jsx(
         Component,
@@ -3681,7 +3681,7 @@ function resolveFa(name, family) {
     () => import('react-icons/fa'),
     (lib) => {
       const FaComp = lib[target];
-      if (!FaComp || typeof FaComp !== "function") return null;
+      if (!FaComp) return null;
       const Component = FaComp;
       const Adapter = (props) => /* @__PURE__ */ jsx(
         Component,

package/dist/{runtime → providers}/EntitySchemaContext.d.ts

@@ -73,10 +73,6 @@ export declare function EntitySchemaProvider({ entities, traitLinkedEntities, or
  * success transition — never read them from a context.
  */
 export declare function useEntitySchema(): EntitySchemaContextValue;
-/**
- * Get a specific entity's schema definition.
- */
-export declare function useEntityDefinition(entityName: string): ResolvedEntity | undefined;
 /**
  * Safe version of useEntitySchema that returns null when no provider is present.
  * Used by UISlotRenderer which may render outside an EntitySchemaProvider (compiled mode).

package/dist/providers/EventBusProvider.d.ts

@@ -10,7 +10,8 @@
  * @packageDocumentation
  */
 import React, { type ReactNode } from 'react';
-import type { EventBusContextType } from '../hooks/event-bus-types';
+import type { EventBusContextType } from '../types/event-bus-types';
+import type { EntityRow } from '@almadar/core';
 /**
  * Extended context type for backward compatibility.
  *
@@ -19,7 +20,7 @@ import type { EventBusContextType } from '../hooks/event-bus-types';
  */
 export interface EventBusContextTypeExtended extends EventBusContextType {
     /** @deprecated Use useSelection from SelectionProvider instead. */
-    getSelectedEntity: () => unknown | null;
+    getSelectedEntity: () => EntityRow | null;
     /** @deprecated Use useSelection from SelectionProvider instead. */
     clearSelectedEntity: () => void;
 }

package/dist/providers/OfflineModeProvider.d.ts

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type UseOfflineExecutorOptions, type UseOfflineExecutorResult } from '../renderer/offline-executor';
+import { type UseOfflineExecutorOptions, type UseOfflineExecutorResult } from '../lib/offline-executor';
 export interface OfflineModeContextValue extends UseOfflineExecutorResult {
     /** Force offline mode for testing */
     forceOffline: boolean;

package/dist/providers/OrbitalProvider.d.ts

@@ -15,11 +15,12 @@
  * @packageDocumentation
  */
 import React, { type ReactNode } from 'react';
-import { type ThemeDefinition } from '../context/ThemeContext';
+import type { EntityRow } from '@almadar/core';
+import { type UIThemeDefinition } from './ThemeContext';
 export interface OrbitalProviderProps {
     children: ReactNode;
     /** Custom themes (merged with built-in themes) */
-    themes?: ThemeDefinition[];
+    themes?: UIThemeDefinition[];
     /** Default theme name */
     defaultTheme?: string;
     /** Default color mode */
@@ -32,7 +33,7 @@ export interface OrbitalProviderProps {
     debug?: boolean;
     /** Initial fetched data */
     /** @deprecated No longer used. Entity data flows through server response props. */
-    initialData?: Record<string, unknown[]>;
+    initialData?: Record<string, EntityRow[]>;
     /**
      * Enable Suspense mode. When true, UISlotRenderer wraps each slot in
      * `<ErrorBoundary><Suspense>` with Skeleton fallbacks.
@@ -104,6 +105,6 @@ export declare function OrbitalProvider({ children, themes, defaultTheme, defaul
 export declare namespace OrbitalProvider {
     var displayName: string;
 }
-export { ThemeProvider } from '../context/ThemeContext';
+export { ThemeProvider } from './ThemeContext';
 export { EventBusProvider } from './EventBusProvider';
 export { SelectionProvider } from './SelectionProvider';

package/dist/providers/SelectionProvider.d.ts

@@ -12,7 +12,8 @@
  * @packageDocumentation
  */
 import React, { type ReactNode } from 'react';
-export interface SelectionContextType<T = unknown> {
+import type { EntityRow } from '@almadar/core';
+export interface SelectionContextType<T = EntityRow> {
     /** The currently selected entity */
     selected: T | null;
     /** Manually set the selected entity */
@@ -22,13 +23,13 @@ export interface SelectionContextType<T = unknown> {
     /** Check if an entity is selected */
     isSelected: (entity: T) => boolean;
 }
-declare const SelectionContext: React.Context<SelectionContextType<unknown> | null>;
+declare const SelectionContext: React.Context<SelectionContextType<EntityRow> | null>;
 interface SelectionProviderProps {
     children: ReactNode;
     /** Enable debug logging */
     debug?: boolean;
     /** Custom comparison function for isSelected */
-    compareEntities?: (a: unknown, b: unknown) => boolean;
+    compareEntities?: (a: EntityRow, b: EntityRow) => boolean;
 }
 /**
  * Provider component for selection state.
@@ -70,12 +71,12 @@ export declare function SelectionProvider({ children, debug, compareEntities, }:
  * }
  * ```
  */
-export declare function useSelection<T = unknown>(): SelectionContextType<T>;
+export declare function useSelection<T = EntityRow>(): SelectionContextType<T>;
 /**
  * Hook to access selection state with fallback for components
  * that may be used outside SelectionProvider.
  *
  * Returns null if no SelectionProvider is found.
  */
-export declare function useSelectionOptional<T = unknown>(): SelectionContextType<T> | null;
+export declare function useSelectionOptional<T = EntityRow>(): SelectionContextType<T> | null;
 export { SelectionContext };

package/dist/{runtime → providers}/ServerBridge.d.ts

@@ -1,5 +1,8 @@
 import type { ReactNode } from 'react';
-import type { BusEventSource, EventPayload } from '@almadar/core';
+import type { BusEventSource, EntityRow, EventPayload, OrbitalSchema, SExpr } from '@almadar/core';
+import type { AnyPatternConfig } from '@almadar/patterns';
+/** Wire-format client effect tuple from the server response. */
+type ClientEffectTuple = ['render-ui', string, AnyPatternConfig | null, ...SExpr[]] | ['navigate', string, ...SExpr[]] | ['notify', string, ...SExpr[]];
 interface OrbitalEventResponse {
     success: boolean;
     transitioned: boolean;
@@ -15,8 +18,8 @@ interface OrbitalEventResponse {
         payload?: EventPayload;
         source?: BusEventSource;
     }>;
-    data?: Record<string, unknown[]>;
-    clientEffects?: unknown[];
+    data?: Record<string, EntityRow[]>;
+    clientEffects?: ClientEffectTuple[];
     /**
      * Same effects as `clientEffects`, paired with the trait that produced
      * each one. When present, prefer this for trait attribution. Falls back
@@ -24,16 +27,16 @@ interface OrbitalEventResponse {
      */
     clientEffectsByTrait?: Array<{
         traitName: string;
-        effect: unknown[];
+        effect: ClientEffectTuple;
     }>;
     error?: string;
 }
 export interface ServerClientEffect {
     type: 'render-ui' | 'navigate' | 'notify';
     slot?: string;
-    pattern?: Record<string, unknown>;
+    pattern?: AnyPatternConfig;
     route?: string;
-    params?: Record<string, unknown>;
+    params?: EventPayload;
     message?: string;
     /**
      * Trait that emitted this effect. Used by `<TraitFrame>` to resolve
@@ -48,7 +51,7 @@ export interface ServerResponseMeta {
     clientEffects: number;
     dataEntities: Record<string, number>;
     /** Raw entity data from server response (for EntityStore advancement) */
-    data?: Record<string, unknown[]>;
+    data?: Record<string, EntityRow[]>;
     emittedEvents: string[];
     error?: string;
 }
@@ -58,7 +61,7 @@ export interface SendEventResult {
 }
 export interface ServerBridgeContextValue {
     connected: boolean;
-    sendEvent: (orbitalName: string, event: string, payload?: Record<string, unknown>) => Promise<SendEventResult>;
+    sendEvent: (orbitalName: string, event: string, payload?: EventPayload) => Promise<SendEventResult>;
 }
 /**
  * Transport adapter for ServerBridgeProvider. Decouples the bridge's
@@ -75,16 +78,16 @@ export interface ServerBridgeContextValue {
  *   cascade-rebroadcast logic is identical downstream.
  */
 export interface ServerBridgeTransport {
-    register: (schema: unknown) => Promise<boolean>;
+    register: (schema: OrbitalSchema) => Promise<boolean>;
     unregister: () => Promise<void>;
-    sendEvent: (orbitalName: string, event: string, payload?: Record<string, unknown>) => Promise<OrbitalEventResponse>;
+    sendEvent: (orbitalName: string, event: string, payload?: EventPayload) => Promise<OrbitalEventResponse>;
 }
 /**
  * Access the server bridge. Returns a no-op stub when outside the provider.
  */
 export declare function useServerBridge(): ServerBridgeContextValue;
 export interface ServerBridgeProviderProps {
-    schema: unknown;
+    schema: OrbitalSchema;
     /** HTTP server URL (canonical playground-runtime / apps/builder-server). */
     serverUrl?: string;
     /**

package/dist/{context → providers}/ThemeContext.d.ts

@@ -14,7 +14,7 @@ export type ColorMode = "light" | "dark" | "system";
 /** Resolved color mode (what's actually applied) */
 export type ResolvedMode = "light" | "dark";
 /** Theme definition */
-export interface ThemeDefinition {
+export interface UIThemeDefinition {
     /** Theme identifier (e.g., "ocean", "wireframe") */
     name: string;
     /** Display name for UI (e.g., "Ocean Blue") */
@@ -25,7 +25,7 @@ export interface ThemeDefinition {
     hasDarkMode?: boolean;
 }
 /** Built-in themes available in the design system */
-export declare const BUILT_IN_THEMES: ThemeDefinition[];
+export declare const BUILT_IN_THEMES: UIThemeDefinition[];
 /** Theme context value */
 interface ThemeContextValue {
     /** Current theme name */
@@ -41,7 +41,7 @@ interface ThemeContextValue {
     /** Toggle between light and dark modes */
     toggleMode: () => void;
     /** Available themes */
-    availableThemes: ThemeDefinition[];
+    availableThemes: UIThemeDefinition[];
     /** The full theme string applied to data-theme (e.g., "ocean-light") */
     appliedTheme: string;
 }
@@ -49,7 +49,7 @@ declare const ThemeContext: React.Context<ThemeContextValue | undefined>;
 export interface ThemeProviderProps {
     children: React.ReactNode;
     /** Available themes (will be merged with built-in themes) */
-    themes?: readonly ThemeDefinition[] | ThemeDefinition[];
+    themes?: readonly UIThemeDefinition[] | UIThemeDefinition[];
     /** Default theme name */
     defaultTheme?: string;
     /** Default color mode */
@@ -100,5 +100,5 @@ export declare const ThemeProvider: React.FC<ThemeProviderProps>;
 export declare function useTheme(): ThemeContextValue;
 export type Theme = ColorMode;
 export type ResolvedTheme = ResolvedMode;
-export type DesignTheme = ThemeDefinition;
+export type DesignTheme = UIThemeDefinition;
 export default ThemeContext;

package/dist/{runtime → providers}/TraitProvider.d.ts

@@ -6,7 +6,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { ResolvedTrait, ResolvedTraitBinding, ResolvedEntity } from './types';
+import type { EventPayload } from '@almadar/core';
+import type { ResolvedTrait, ResolvedTraitBinding, ResolvedEntity } from '../types/runtime-types';
 export interface TraitInstance {
     /** Trait name */
     name: string;
@@ -15,7 +16,7 @@ export interface TraitInstance {
     /** Available events (can be triggered) */
     availableEvents: string[];
     /** Dispatch an event to the state machine */
-    dispatch: (eventKey: string, payload?: Record<string, unknown>) => void;
+    dispatch: (eventKey: string, payload?: EventPayload) => void;
     /** Check if an event can be dispatched */
     canDispatch: (eventKey: string) => boolean;
     /** Get the full trait definition */
@@ -27,7 +28,7 @@ export interface TraitContextValue {
     /** Get a trait instance by name */
     getTrait: (name: string) => TraitInstance | undefined;
     /** Dispatch an event to a specific trait */
-    dispatchToTrait: (traitName: string, eventKey: string, payload?: Record<string, unknown>) => void;
+    dispatchToTrait: (traitName: string, eventKey: string, payload?: EventPayload) => void;
     /** Check if an event can be dispatched to a trait */
     canDispatch: (traitName: string, eventKey: string) => boolean;
 }

package/dist/{context → providers}/UISlotContext.d.ts

@@ -19,7 +19,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type UISlotManager, type UISlot, type SlotContent, type SlotProps, type SlotPropValue, type SlotCallback, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback } from '../hooks/useUISlots';
+import { type UISlotManager, type UISlot, type SlotContent, type SlotProps, type SlotPropValue, type SlotCallback, type SlotRenderConfig, type SlotAnimation, type SlotChangeCallback } from '../hooks/useUISlots';
 /**
  * Context for the UI Slot Manager
  */
@@ -72,4 +72,4 @@ export declare function useSlotContent(slot: UISlot): SlotContent | null;
  * Hook to check if a slot has content.
  */
 export declare function useSlotHasContent(slot: UISlot): boolean;
-export { UISlotContext, type UISlotManager, type UISlot, type SlotContent, type SlotProps, type SlotPropValue, type SlotCallback, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback, };
+export { UISlotContext, type UISlotManager, type UISlot, type SlotContent, type SlotProps, type SlotPropValue, type SlotCallback, type SlotRenderConfig, type SlotAnimation, type SlotChangeCallback, };

package/dist/{context → providers}/UserContext.d.ts

@@ -20,6 +20,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { FieldValue } from '@almadar/core';
 /**
  * User data for @user bindings.
  * Matches UserContext type from evaluator/context.ts
@@ -36,7 +37,7 @@ export interface UserData {
     /** User's permissions */
     permissions?: string[];
     /** Additional custom profile fields */
-    [key: string]: unknown;
+    [key: string]: FieldValue | undefined;
 }
 /**
  * User context value.
@@ -55,7 +56,7 @@ export interface UserContextValue {
     /** Check if user has all of the specified permissions */
     hasAllPermissions: (permissions: string[]) => boolean;
     /** Get a user field by path (for @user.field bindings) */
-    getUserField: (path: string) => unknown;
+    getUserField: (path: string) => FieldValue | undefined;
 }
 /**
  * Anonymous user for when no user is logged in.

package/dist/providers/VerificationProvider.d.ts

@@ -16,6 +16,7 @@
  * @packageDocumentation
  */
 import React, { type ReactNode } from 'react';
+import type { FieldValue } from '@almadar/core';
 /**
  * Observer interface compatible with `StateMachineManager.setObserver()`.
  * Defined locally to avoid hard dependency on `@almadar/runtime`.
@@ -29,7 +30,7 @@ interface TransitionObserver {
         guardResult?: boolean;
         effects: Array<{
             type: string;
-            args: unknown[];
+            args: FieldValue[];
             status: 'executed' | 'failed' | 'skipped';
             error?: string;
             durationMs?: number;