@almadar/ui 5.78.0 → 5.79.1

package/dist/providers/TraitProvider.d.ts

@@ -1,53 +0,0 @@
-/**
- * TraitProvider Component
- *
- * Provides trait state machines to child components via React context.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { EventPayload } from '@almadar/core';
-import type { ResolvedTrait, ResolvedTraitBinding, ResolvedEntity } from '../types/runtime-types';
-export interface TraitInstance {
-    /** Trait name */
-    name: string;
-    /** Current state */
-    currentState: string;
-    /** Available events (can be triggered) */
-    availableEvents: string[];
-    /** Dispatch an event to the state machine */
-    dispatch: (eventKey: string, payload?: EventPayload) => void;
-    /** Check if an event can be dispatched */
-    canDispatch: (eventKey: string) => boolean;
-    /** Get the full trait definition */
-    trait: ResolvedTrait;
-}
-export interface TraitContextValue {
-    /** All trait instances on this page */
-    traits: Map<string, TraitInstance>;
-    /** Get a trait instance by name */
-    getTrait: (name: string) => TraitInstance | undefined;
-    /** Dispatch an event to a specific trait */
-    dispatchToTrait: (traitName: string, eventKey: string, payload?: EventPayload) => void;
-    /** Check if an event can be dispatched to a trait */
-    canDispatch: (traitName: string, eventKey: string) => boolean;
-}
-export declare const TraitContext: React.Context<TraitContextValue | null>;
-export interface TraitProviderProps {
-    /** Trait bindings for this page */
-    traits: ResolvedTraitBinding[];
-    /** Entity map for context */
-    entities: Map<string, ResolvedEntity>;
-    /** Children to render */
-    children: React.ReactNode;
-}
-export declare function TraitProvider({ traits: traitBindings, children, }: TraitProviderProps): React.ReactElement;
-/**
- * Access the trait context from within the TraitProvider.
- */
-export declare function useTraitContext(): TraitContextValue;
-/**
- * Access a specific trait instance.
- */
-export declare function useTrait(traitName: string): TraitInstance | undefined;
-export default TraitProvider;

package/dist/providers/TraitScopeProvider.d.ts

@@ -1,43 +0,0 @@
-/**
- * TraitScopeProvider
- *
- * Wraps a trait's rendered subtree with its owning `{ orbital, trait }`
- * pair. Pure components inside the subtree (Button, Form, etc.) keep
- * calling `useEventBus().emit('UI:X', ...)` exactly as today; the
- * scoped wrapper that `useEventBus` returns inside this provider
- * rewrites bare `UI:X` keys into the qualified
- * `UI:Orbital.Trait.X` form that `useTraitStateMachine` (and the rest
- * of the post-Phase 4 subscriber side) listens on.
- *
- * Producer-side fix for the gap where Button-emitted bare keys never
- * reached the trait state machine in the runtime path. The compiled
- * path's codegen wraps each trait view with the same provider so both
- * paths share the qualification contract.
- *
- * @packageDocumentation
- */
-import React from 'react';
-export interface TraitScope {
-    /** Owning orbital name (e.g. `"ContactOrbital"`). */
-    orbital: string;
-    /** Trait name within the orbital (e.g. `"ContactBrowse"`). */
-    trait: string;
-}
-export interface TraitScopeProviderProps {
-    orbital: string;
-    trait: string;
-    children: React.ReactNode;
-}
-/**
- * Wrap a trait's rendered subtree to qualify bare `UI:*` emits with the
- * trait's scope. Mount this at the slot-content boundary in runtime
- * mode (UISlotRenderer) and at each generated trait view's outermost
- * element in compiled mode (orbital-shell-typescript codegen).
- */
-export declare function TraitScopeProvider({ orbital, trait, children, }: TraitScopeProviderProps): React.ReactElement;
-/**
- * Read the current trait scope. Returns `null` when called outside
- * any `TraitScopeProvider` (e.g. Storybook, design-system catalog).
- */
-export declare function useTraitScope(): TraitScope | null;
-export default TraitScopeProvider;

package/dist/providers/UISlotContext.d.ts

@@ -1,75 +0,0 @@
-/**
- * UISlotContext
- *
- * React context for providing the UI Slot Manager throughout the application.
- * Traits use this context to render content into slots via render_ui effects.
- *
- * Usage:
- * ```tsx
- * // In App.tsx or layout
- * <UISlotProvider>
- *   <App />
- * </UISlotProvider>
- *
- * // In trait hooks or components
- * const { render, clear } = useUISlots();
- * render({ target: 'modal', pattern: 'form-section', props: {...} });
- * ```
- *
- * @packageDocumentation
- */
-import React from 'react';
-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
- */
-declare const UISlotContext: React.Context<UISlotManager | null>;
-export interface UISlotProviderProps {
-    children: React.ReactNode;
-}
-/**
- * Provider component that creates and provides the UI Slot Manager.
- *
- * Must wrap any components that use traits with render_ui effects.
- */
-export declare function UISlotProvider({ children }: UISlotProviderProps): React.ReactElement;
-/**
- * Hook to access the UI Slot Manager.
- *
- * Must be used within a UISlotProvider.
- *
- * @throws Error if used outside of UISlotProvider
- *
- * @example
- * ```tsx
- * function MyTraitHook() {
- *   const { render, clear } = useUISlots();
- *
- *   const showModal = () => {
- *     render({
- *       target: 'modal',
- *       pattern: 'form-section',
- *       props: { title: 'Create Item' },
- *     });
- *   };
- *
- *   const closeModal = () => {
- *     clear('modal');
- *   };
- *
- *   return { showModal, closeModal };
- * }
- * ```
- */
-export declare function useUISlots(): UISlotManager;
-/**
- * Hook to get content for a specific slot.
- *
- * Useful for components that only need to read slot state.
- */
-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 SlotRenderConfig, type SlotAnimation, type SlotChangeCallback, };

package/dist/providers/UserContext.d.ts

@@ -1,112 +0,0 @@
-/**
- * UserContext
- *
- * React context for providing user data throughout the application.
- * Enables @user bindings in S-expressions for role-based UI and permissions.
- *
- * Usage:
- * ```tsx
- * // In App.tsx or layout
- * <UserProvider user={{ id: '123', role: 'admin', permissions: ['read', 'write'] }}>
- *   <App />
- * </UserProvider>
- *
- * // In components - access via hook
- * const { user, hasRole, hasPermission } = useUser();
- * if (hasRole('admin')) { ... }
- * if (hasPermission('delete')) { ... }
- * ```
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { FieldValue } from '@almadar/core';
-/**
- * User data for @user bindings.
- * Matches UserContext type from evaluator/context.ts
- */
-export interface UserData {
-    /** User's unique ID */
-    id: string;
-    /** User's email */
-    email?: string;
-    /** User's display name */
-    name?: string;
-    /** User's role (for RBAC) */
-    role?: string;
-    /** User's permissions */
-    permissions?: string[];
-    /** Additional custom profile fields */
-    [key: string]: FieldValue | undefined;
-}
-/**
- * User context value.
- */
-export interface UserContextValue {
-    /** Current user data (null if not logged in) */
-    user: UserData | null;
-    /** Check if user is logged in */
-    isLoggedIn: boolean;
-    /** Check if user has a specific role */
-    hasRole: (role: string) => boolean;
-    /** Check if user has a specific permission */
-    hasPermission: (permission: string) => boolean;
-    /** Check if user has any of the specified roles */
-    hasAnyRole: (roles: string[]) => boolean;
-    /** 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) => FieldValue | undefined;
-}
-/**
- * Anonymous user for when no user is logged in.
- */
-declare const ANONYMOUS_USER: UserData;
-declare const UserContext: React.Context<UserContextValue | null>;
-export interface UserProviderProps {
-    /** User data (null if not logged in) */
-    user?: UserData | null;
-    /** Children to render */
-    children: React.ReactNode;
-}
-/**
- * Provider component that provides user context to the application.
- *
- * Provides RBAC helpers and field access for @user bindings.
- */
-export declare function UserProvider({ user, children, }: UserProviderProps): React.ReactElement;
-/**
- * Hook to access the user context.
- *
- * Returns default values if used outside of UserProvider (for resilience).
- *
- * @example
- * ```tsx
- * function AdminPanel() {
- *   const { user, hasRole, hasPermission } = useUser();
- *
- *   if (!hasRole('admin') && !hasPermission('admin:access')) {
- *     return <AccessDenied />;
- *   }
- *
- *   return <div>Welcome, {user?.name}</div>;
- * }
- * ```
- */
-export declare function useUser(): UserContextValue;
-/**
- * Hook to check if user has a specific role.
- * Convenience wrapper around useUser().hasRole().
- */
-export declare function useHasRole(role: string): boolean;
-/**
- * Hook to check if user has a specific permission.
- * Convenience wrapper around useUser().hasPermission().
- */
-export declare function useHasPermission(permission: string): boolean;
-/**
- * Hook to get user data for @user bindings in S-expressions.
- * Returns the user data object compatible with EvaluationContext.user
- */
-export declare function useUserForEvaluation(): UserData | undefined;
-export { UserContext, ANONYMOUS_USER };

package/dist/providers/VerificationProvider.d.ts

@@ -1,64 +0,0 @@
-/**
- * VerificationProvider
- *
- * Wires the verification registry to both compiled and runtime execution paths.
- *
- * **Compiled apps**: Intercepts event bus lifecycle events
- *   (`{traitName}:DISPATCH`, `{traitName}:{event}:SUCCESS`, `{traitName}:{event}:ERROR`)
- *   emitted by `useOrbitalBridge` and records transitions via `recordTransition()`.
- *
- * **Runtime apps**: Accepts an optional `StateMachineManager` and wires its
- *   `TransitionObserver` to `recordTransition()`.
- *
- * **Both**: Calls `bindEventBus()` and `bindTraitStateGetter()` to populate
- *   `window.__orbitalVerification` for Playwright/automation.
- *
- * @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`.
- */
-interface TransitionObserver {
-    onTransition(trace: {
-        traitName: string;
-        from: string;
-        to: string;
-        event: string;
-        guardResult?: boolean;
-        effects: Array<{
-            type: string;
-            args: FieldValue[];
-            status: 'executed' | 'failed' | 'skipped';
-            error?: string;
-            durationMs?: number;
-        }>;
-    }): void;
-}
-/**
- * Minimal interface for StateMachineManager — avoids importing the full runtime.
- */
-interface StateMachineManagerLike {
-    setObserver(observer: TransitionObserver): void;
-    getState?(traitName: string): string | undefined;
-}
-export interface VerificationProviderProps {
-    children: ReactNode;
-    /** Enable verification wiring (default: true in dev, false in prod) */
-    enabled?: boolean;
-    /** Optional runtime StateMachineManager for interpreted mode */
-    runtimeManager?: StateMachineManagerLike;
-    /** Optional trait state getter for compiled apps (maps traitName → currentState) */
-    traitStateGetter?: (traitName: string) => string | undefined;
-}
-/**
- * VerificationProvider — wires the verification registry to the event bus
- * and optional runtime manager. Renders children unchanged.
- */
-export declare function VerificationProvider({ children, enabled, runtimeManager, traitStateGetter, }: VerificationProviderProps): React.ReactElement;
-export declare namespace VerificationProvider {
-    var displayName: string;
-}
-export {};