@almadar/ui 2.0.1 → 2.0.2

package/dist/context/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 RenderUIConfig, 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 RenderUIConfig, type SlotAnimation, type SlotChangeCallback, };

package/dist/context/UserContext.d.ts

@@ -1,111 +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';
-/**
- * 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]: unknown;
-}
-/**
- * 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) => unknown;
-}
-/**
- * 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/context/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Context barrel export
- */
-export { UISlotProvider, useUISlots, useSlotContent, useSlotHasContent, UISlotContext, type UISlotManager, type UISlot, type SlotContent, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback, } from "./UISlotContext";
-export { ThemeProvider, useTheme, BUILT_IN_THEMES, type ThemeDefinition, type ThemeProviderProps, type ColorMode, type ResolvedMode, type DesignTheme, } from "./ThemeContext";
-export { default as ThemeContext } from "./ThemeContext";
-export { DesignThemeProvider, useDesignTheme } from "./DesignThemeContext";
-export { UserProvider, UserContext, useUser, useHasRole, useHasPermission, useUserForEvaluation, ANONYMOUS_USER, type UserData, type UserContextValue, type UserProviderProps, } from "./UserContext";

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

@@ -1,71 +0,0 @@
-/**
- * Event Bus Types
- *
- * Type definitions for the page event bus system.
- *
- * @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;
-/**
- * Event bus context type.
- */
-export interface EventBusContextType {
-    /**
-     * Emit an event to all listeners.
-     *
-     * @param type - Event type identifier
-     * @param payload - Optional payload data
-     */
-    emit: (type: string, payload?: Record<string, unknown>) => void;
-    /**
-     * Subscribe to an event type.
-     *
-     * @param type - Event type to listen for
-     * @param listener - Callback function
-     * @returns Unsubscribe function
-     */
-    on: (type: string, listener: EventListener) => Unsubscribe;
-    /**
-     * Subscribe to an event type, but only fire once.
-     *
-     * @param type - Event type to listen for
-     * @param listener - Callback function
-     * @returns Unsubscribe function
-     */
-    once: (type: string, listener: EventListener) => Unsubscribe;
-    /**
-     * Check if there are any listeners for an event type.
-     *
-     * @param type - Event type to check
-     * @returns True if there are listeners
-     */
-    hasListeners: (type: string) => boolean;
-    /**
-     * Subscribe to ALL events regardless of type.
-     * Useful for verification, debugging, and analytics.
-     *
-     * @param listener - Callback function invoked for every emitted event
-     * @returns Unsubscribe function
-     */
-    onAny?: (listener: EventListener) => Unsubscribe;
-}

package/dist/hooks/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * Hooks barrel export
- */
-export { useOrbitalHistory, type HistoryTimelineItem, type RevertResult, type ChangeSummary, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, } from './useOrbitalHistory';
-export { useFileSystem, type FileSystemStatus, type FileSystemFile, type SelectedFile, type UseFileSystemResult, } from './useFileSystem';
-export { useExtensions, type Extension, type ExtensionManifest, type UseExtensionsOptions, type UseExtensionsResult, } from './useExtensions';
-export { useFileEditor, type OpenFile, type UseFileEditorOptions, type UseFileEditorResult, } from './useFileEditor';
-export { useCompile, type CompileStage, type CompileResult, type UseCompileResult, } from './useCompile';
-export { usePreview } from './usePreview';
-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 { 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';
-export { useQuerySingleton, parseQueryBinding, type QueryState, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, } from './useQuerySingleton';
-export { useEntityMutations, useCreateEntity, useUpdateEntity, useDeleteEntity, type EntityMutationResult, type UseEntityMutationsOptions, } from './useEntityMutations';
-export { useOrbitalMutations, useSendOrbitalEvent, ENTITY_EVENTS, type OrbitalEventPayload, type OrbitalEventResponse, } from './useOrbitalMutations';
-export { useEntities, useEntity as useEntityById, useEntitiesByType, useSingletonEntity, usePlayer, usePhysics, useInput, spawnEntity, updateEntity, updateSingleton, removeEntity, clearEntities, getEntity, getByType, getAllEntities, getSingleton, type Entity, } from './useEntities';
-export { useTranslate, I18nProvider, createTranslate, type TranslateFunction, type I18nContextValue, } from './useTranslate';
-export { useResolvedEntity, type ResolvedEntity, } from './useResolvedEntity';
-export { useAuthContext, type AuthUser, type AuthContextValue, } from './useAuthContext';
-export { useGitHubStatus, useConnectGitHub, useDisconnectGitHub, useGitHubRepos, useGitHubRepo, useGitHubBranches, type GitHubStatus, type GitHubRepo, } from './useGitHub';

package/dist/hooks/useAgentChat.d.ts

@@ -1,104 +0,0 @@
-import type { DeepAgentInterrupt } from './useDeepAgentGeneration';
-export interface ChatMessage {
-    id: string;
-    role: 'user' | 'assistant' | 'system';
-    content: string;
-    timestamp: number;
-}
-export type AvatarRole = 'user' | 'assistant' | 'system';
-export type FileOperation = 'ls' | 'read_file' | 'write_file' | 'edit_file';
-export type Activity = {
-    type: 'message';
-    role: AvatarRole;
-    content: string;
-    timestamp: number;
-    isStreaming?: boolean;
-} | {
-    type: 'tool_call';
-    tool: string;
-    args: Record<string, unknown>;
-    timestamp: number;
-    isExecuting?: boolean;
-} | {
-    type: 'tool_result';
-    tool: string;
-    result: unknown;
-    success: boolean;
-    timestamp: number;
-} | {
-    type: 'file_operation';
-    operation: FileOperation;
-    path: string;
-    success?: boolean;
-    timestamp: number;
-} | {
-    type: 'schema_diff';
-    filePath: string;
-    hunks: DiffHunk[];
-    timestamp: number;
-} | {
-    type: 'error';
-    message: string;
-    code?: string;
-    timestamp: number;
-};
-export interface TodoActivity {
-    type: 'thinking' | 'tool_call' | 'tool_result' | 'code_change';
-    content: string;
-    timestamp: number;
-    tool?: string;
-    success?: boolean;
-    filePath?: string;
-    diff?: string;
-}
-export interface Todo {
-    id: string;
-    task: string;
-    status: 'pending' | 'in_progress' | 'completed';
-    latestActivity?: TodoActivity;
-    activityHistory?: TodoActivity[];
-}
-export interface DiffHunk {
-    oldStart: number;
-    oldLines: number;
-    newStart: number;
-    newLines: number;
-    lines: Array<{
-        type: 'add' | 'remove' | 'context';
-        content: string;
-    }>;
-}
-export interface SchemaDiff {
-    id: string;
-    filePath: string;
-    hunks: DiffHunk[];
-    timestamp: number;
-    addedLines: number;
-    removedLines: number;
-}
-export type AgentStatus = 'idle' | 'running' | 'complete' | 'error' | 'interrupted';
-export interface UseAgentChatOptions {
-    appId?: string;
-    onComplete?: (schema?: unknown) => void;
-    onSchemaChange?: (diff?: unknown) => void;
-    onError?: (error: Error | string) => void;
-}
-export interface UseAgentChatResult {
-    messages: ChatMessage[];
-    status: AgentStatus;
-    activities: Activity[];
-    todos: Todo[];
-    schemaDiffs: SchemaDiff[];
-    isLoading: boolean;
-    error: string | null;
-    threadId: string | null;
-    interrupt: DeepAgentInterrupt | null;
-    sendMessage: (content: string) => Promise<void>;
-    startGeneration: (skill: string | string[], prompt: string, options?: Record<string, unknown>) => Promise<void>;
-    continueConversation: (message: string | string[]) => Promise<void>;
-    resumeWithDecision: (decisions: unknown[]) => Promise<void>;
-    cancel: () => void;
-    clearMessages: () => void;
-    clearHistory: () => void;
-}
-export declare function useAgentChat(options?: UseAgentChatOptions): UseAgentChatResult;

package/dist/hooks/useAuthContext.d.ts

@@ -1,25 +0,0 @@
-/**
- * Auth Context Hook Stub
- *
- * Provides a placeholder auth context for the design system.
- * Applications should provide their own AuthContext provider
- * that implements this interface.
- */
-export interface AuthUser {
-    uid: string;
-    email: string | null;
-    displayName: string | null;
-    photoURL: string | null;
-}
-export interface AuthContextValue {
-    user: AuthUser | null;
-    loading: boolean;
-    signIn?: () => Promise<void>;
-    signOut?: () => Promise<void>;
-}
-/**
- * Stub hook that returns empty auth context.
- * Applications should wrap their app with an AuthProvider
- * that supplies real auth state.
- */
-export declare function useAuthContext(): AuthContextValue;

package/dist/hooks/useCompile.d.ts

@@ -1,22 +0,0 @@
-export interface SchemaLike {
-    name: string;
-    version?: string;
-    [key: string]: unknown;
-}
-export type CompileStage = 'idle' | 'compiling' | 'done' | 'error';
-export interface CompileResult {
-    success: boolean;
-    files?: Array<{
-        path: string;
-        content: string;
-    }>;
-    errors?: string[];
-}
-export interface UseCompileResult {
-    isCompiling: boolean;
-    stage: CompileStage;
-    lastResult: CompileResult | null;
-    error: string | null;
-    compileSchema: (schema: SchemaLike) => Promise<CompileResult | null>;
-}
-export declare function useCompile(): UseCompileResult;

package/dist/hooks/useDeepAgentGeneration.d.ts

@@ -1,46 +0,0 @@
-import type { OrbitalSchema } from '@almadar/core';
-export interface DeepAgentActionRequest {
-    id: string;
-    type: string;
-    tool: string;
-    args: Record<string, unknown>;
-    description?: string;
-    allowedDecisions: ('approve' | 'edit' | 'reject')[];
-    status: 'pending' | 'approved' | 'rejected' | 'edited';
-}
-export interface DeepAgentInterrupt {
-    id: string;
-    type: 'tool_calls' | 'confirmation' | 'error';
-    message?: string;
-    actionRequests: DeepAgentActionRequest[];
-    timestamp: number;
-    threadId?: string;
-}
-export interface GenerationRequest {
-    id: string;
-    prompt: string;
-    status: 'pending' | 'running' | 'completed' | 'failed';
-    result?: OrbitalSchema;
-    error?: string;
-}
-export interface GenerationProgress {
-    stage: string;
-    percent: number;
-    message: string;
-}
-export interface UseDeepAgentGenerationResult {
-    requests: GenerationRequest[];
-    currentRequest: GenerationRequest | null;
-    isGenerating: boolean;
-    isLoading: boolean;
-    isComplete: boolean;
-    progress: GenerationProgress;
-    error: string | null;
-    interrupt: DeepAgentInterrupt | null;
-    generate: (prompt: string) => Promise<OrbitalSchema | null>;
-    startGeneration: (skill: string, prompt: string, options?: Record<string, unknown>) => Promise<void>;
-    cancelGeneration: () => void;
-    clearRequests: () => void;
-    submitInterruptDecisions: (decisions: unknown[]) => void;
-}
-export declare function useDeepAgentGeneration(): UseDeepAgentGenerationResult;

package/dist/hooks/useEntities.d.ts

@@ -1,52 +0,0 @@
-import { getEntity, getByType, getAllEntities, getSingleton, spawnEntity, updateEntity, updateSingleton, removeEntity, clearEntities } from '../stores/entityStore';
-import type { Entity } from '../stores/entityStore';
-export type { Entity };
-/**
- * Hook to access all entities
- */
-export declare function useEntities(): {
-    entities: Map<string, Entity>;
-    getEntity: typeof getEntity;
-    getByType: typeof getByType;
-    getAllEntities: typeof getAllEntities;
-    getSingleton: typeof getSingleton;
-    spawnEntity: typeof spawnEntity;
-    updateEntity: typeof updateEntity;
-    updateSingleton: typeof updateSingleton;
-    removeEntity: typeof removeEntity;
-    clearEntities: typeof clearEntities;
-};
-/**
- * Hook to access a specific entity by ID
- */
-export declare function useEntity(id: string): Entity | undefined;
-/**
- * Hook to access entities of a specific type
- */
-export declare function useEntitiesByType(type: string): Entity[];
-/**
- * Hook to access a singleton entity by type
- */
-export declare function useSingletonEntity<T extends Entity = Entity>(type: string): T | undefined;
-/**
- * Hook for Player entity (convenience)
- */
-export declare function usePlayer(): {
-    player: Entity | undefined;
-    updatePlayer: (updates: Partial<Entity>) => void;
-};
-/**
- * Hook for Physics entity (convenience)
- */
-export declare function usePhysics(): {
-    physics: Entity | undefined;
-    updatePhysics: (updates: Partial<Entity>) => void;
-};
-/**
- * Hook for Input entity (convenience)
- */
-export declare function useInput(): {
-    input: Entity | undefined;
-    updateInput: (updates: Partial<Entity>) => void;
-};
-export { spawnEntity, updateEntity, updateSingleton, removeEntity, clearEntities, getEntity, getByType, getAllEntities, getSingleton, };