@almadar/ui 2.0.1 → 2.0.3

package/dist/lib/parseContentSegments.d.ts

@@ -1,41 +0,0 @@
-/**
- * Content Segment Parsing Utilities
- *
- * Parses rich content with code blocks and quiz tags into structured
- * segments for rendering. Detects orbital schemas in JSON code blocks
- * and marks them for JazariStateMachine rendering.
- */
-/** Segment types for content rendering */
-export type ContentSegment = {
-    type: 'markdown';
-    content: string;
-} | {
-    type: 'code';
-    language: string;
-    content: string;
-} | {
-    type: 'orbital';
-    language: string;
-    content: string;
-    schema: unknown;
-} | {
-    type: 'quiz';
-    question: string;
-    answer: string;
-};
-/**
- * Parse markdown content to extract code blocks.
- *
- * Splits markdown into segments of plain markdown and fenced code blocks.
- * JSON/orb code blocks containing orbital schemas are tagged as 'orbital'.
- */
-export declare function parseMarkdownWithCodeBlocks(content: string | undefined | null): ContentSegment[];
-/**
- * Parse content to extract all segments including quiz tags and code blocks.
- *
- * Supported tags:
- * - <question>q</question><answer>a</answer> — Quiz Q&A
- *
- * Also handles fenced code blocks (```language...```) with orbital detection.
- */
-export declare function parseContentSegments(content: string | undefined | null): ContentSegment[];

package/dist/lib/tickRegistry.d.ts

@@ -1,40 +0,0 @@
-/**
- * Tick Registry - Tracks scheduled tick executions for debugging
- *
- * @packageDocumentation
- */
-export interface TickExecution {
-    id: string;
-    traitName: string;
-    /** Tick name (display name) */
-    name: string;
-    /** Tick identifier */
-    tickName: string;
-    interval: number;
-    /** Last execution timestamp */
-    lastRun: number;
-    lastExecuted: number | null;
-    nextExecution: number | null;
-    /** Number of times this tick has run */
-    runCount: number;
-    executionCount: number;
-    /** Average execution time in ms */
-    executionTime: number;
-    /** Whether the tick is currently active */
-    active: boolean;
-    isActive: boolean;
-    /** Guard name if this tick has a guard */
-    guardName?: string;
-    /** Whether the guard passed on last evaluation */
-    guardPassed?: boolean;
-}
-type ChangeListener = () => void;
-export declare function registerTick(tick: TickExecution): void;
-export declare function updateTickExecution(id: string, timestamp: number): void;
-export declare function setTickActive(id: string, isActive: boolean): void;
-export declare function unregisterTick(id: string): void;
-export declare function getAllTicks(): TickExecution[];
-export declare function getTick(id: string): TickExecution | undefined;
-export declare function subscribeToTickChanges(listener: ChangeListener): () => void;
-export declare function clearTicks(): void;
-export {};

package/dist/lib/traitRegistry.d.ts

@@ -1,34 +0,0 @@
-/**
- * Trait Registry - Tracks active traits and their state machines for debugging
- *
- * @packageDocumentation
- */
-export interface TraitTransition {
-    from: string;
-    to: string;
-    event: string;
-    guard?: string;
-}
-export interface TraitGuard {
-    name: string;
-    lastResult?: boolean;
-}
-export interface TraitDebugInfo {
-    id: string;
-    name: string;
-    currentState: string;
-    states: string[];
-    transitions: TraitTransition[];
-    guards: TraitGuard[];
-    transitionCount: number;
-}
-type ChangeListener = () => void;
-export declare function registerTrait(info: TraitDebugInfo): void;
-export declare function updateTraitState(id: string, newState: string): void;
-export declare function updateGuardResult(traitId: string, guardName: string, result: boolean): void;
-export declare function unregisterTrait(id: string): void;
-export declare function getAllTraits(): TraitDebugInfo[];
-export declare function getTrait(id: string): TraitDebugInfo | undefined;
-export declare function subscribeToTraitChanges(listener: ChangeListener): () => void;
-export declare function clearTraits(): void;
-export {};

package/dist/lib/verificationRegistry.d.ts

@@ -1,107 +0,0 @@
-/**
- * Verification Registry - Tracks runtime verification checks and transition traces
- *
- * Provides:
- * 1. A checklist of pass/fail checks (INIT has fetch, bridge connected, etc.)
- * 2. A full transition timeline with effect execution results
- * 3. ServerBridge health snapshot
- * 4. window.__orbitalVerification for Playwright/automation
- *
- * @packageDocumentation
- */
-export type CheckStatus = "pass" | "fail" | "pending" | "warn";
-export interface VerificationCheck {
-    id: string;
-    label: string;
-    status: CheckStatus;
-    details?: string;
-    /** Timestamp when status last changed */
-    updatedAt: number;
-}
-export interface EffectTrace {
-    type: string;
-    args: unknown[];
-    status: "executed" | "failed" | "skipped";
-    error?: string;
-    durationMs?: number;
-}
-export interface TransitionTrace {
-    id: string;
-    traitName: string;
-    from: string;
-    to: string;
-    event: string;
-    guardExpression?: string;
-    guardResult?: boolean;
-    effects: EffectTrace[];
-    timestamp: number;
-}
-export interface BridgeHealth {
-    connected: boolean;
-    eventsForwarded: number;
-    eventsReceived: number;
-    lastError?: string;
-    lastHeartbeat: number;
-}
-export interface VerificationSummary {
-    totalChecks: number;
-    passed: number;
-    failed: number;
-    warnings: number;
-    pending: number;
-}
-export interface VerificationSnapshot {
-    checks: VerificationCheck[];
-    transitions: TransitionTrace[];
-    bridge: BridgeHealth | null;
-    summary: VerificationSummary;
-}
-type ChangeListener = () => void;
-export declare function registerCheck(id: string, label: string, status?: CheckStatus, details?: string): void;
-export declare function updateCheck(id: string, status: CheckStatus, details?: string): void;
-export declare function getAllChecks(): VerificationCheck[];
-export declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
-export declare function getTransitions(): TransitionTrace[];
-export declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
-export declare function updateBridgeHealth(health: BridgeHealth): void;
-export declare function getBridgeHealth(): BridgeHealth | null;
-export declare function getSummary(): VerificationSummary;
-export declare function getSnapshot(): VerificationSnapshot;
-export declare function subscribeToVerification(listener: ChangeListener): () => void;
-/** Exposed on window for Playwright to query */
-interface OrbitalVerificationAPI {
-    getSnapshot: () => VerificationSnapshot;
-    getChecks: () => VerificationCheck[];
-    getTransitions: () => TransitionTrace[];
-    getBridge: () => BridgeHealth | null;
-    getSummary: () => VerificationSummary;
-    /** Wait for a specific event to be processed */
-    waitForTransition: (event: string, timeoutMs?: number) => Promise<TransitionTrace | null>;
-    /** Send an event into the runtime (requires eventBus binding) */
-    sendEvent?: (event: string, payload?: Record<string, unknown>) => void;
-    /** Get current trait state */
-    getTraitState?: (traitName: string) => string | undefined;
-}
-declare global {
-    interface Window {
-        __orbitalVerification?: OrbitalVerificationAPI;
-    }
-}
-/**
- * Wait for a transition matching the given event to appear.
- * Returns the trace or null on timeout.
- */
-export declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
-/**
- * Bind the EventBus so automation can send events.
- * Call this during app initialization.
- */
-export declare function bindEventBus(eventBus: {
-    emit: (type: string, payload?: Record<string, unknown>) => void;
-}): void;
-/**
- * Bind a trait state getter so automation can query current states.
- */
-export declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
-export declare function clearVerification(): void;
-export {};

package/dist/lib/visualizer/index.d.ts

@@ -1,143 +0,0 @@
-/**
- * Orbital State Machine Visualizer
- *
- * Renders SVG diagrams from Orbital schemas and Trait definitions.
- * Can be used in documentation, IDE previews, and other tools.
- */
-export interface VisualizerConfig {
-    nodeRadius: number;
-    nodeSpacing: number;
-    initialIndicatorOffset: number;
-    arrowSize: number;
-    colors: {
-        background: string;
-        node: string;
-        nodeBorder: string;
-        nodeText: string;
-        initialNode: string;
-        finalNode: string;
-        arrow: string;
-        arrowText: string;
-        effectText: string;
-        guardText: string;
-        initial: string;
-    };
-    fonts: {
-        node: string;
-        event: string;
-        effect: string;
-    };
-}
-export interface StateDefinition {
-    name: string;
-    isInitial?: boolean;
-    isFinal?: boolean;
-    description?: string;
-}
-export interface TransitionDefinition {
-    from: string;
-    to: string;
-    event: string;
-    guard?: unknown;
-    effects?: unknown[];
-}
-export interface StateMachineDefinition {
-    states: StateDefinition[];
-    transitions: TransitionDefinition[];
-}
-export interface EntityDefinition {
-    name: string;
-    fields?: (string | {
-        name: string;
-    })[];
-}
-export interface RenderOptions {
-    title?: string;
-    entity?: EntityDefinition;
-}
-/** Position data for a state node in DOM layout */
-export interface DomStateNode {
-    id: string;
-    name: string;
-    x: number;
-    y: number;
-    radius: number;
-    isInitial: boolean;
-    isFinal: boolean;
-    description?: string;
-}
-/** Position data for a transition arrow */
-export interface DomTransitionPath {
-    id: string;
-    from: string;
-    to: string;
-    /** SVG path data for the curved arrow */
-    pathData: string;
-    /** Midpoint for label positioning */
-    labelX: number;
-    labelY: number;
-}
-/** Position data for a transition label with guard/effect details */
-export interface DomTransitionLabel {
-    id: string;
-    from: string;
-    to: string;
-    event: string;
-    x: number;
-    y: number;
-    /** Human-readable guard text (e.g., "if amount > 100") */
-    guardText?: string;
-    /** Human-readable effect texts */
-    effectTexts: string[];
-    /** Whether this transition has details to show in tooltip */
-    hasDetails: boolean;
-}
-/** Entity input box data */
-export interface DomEntityBox {
-    name: string;
-    fields: string[];
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** Output effects box data */
-export interface DomOutputsBox {
-    outputs: string[];
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** Complete DOM layout data for rendering */
-export interface DomLayoutData {
-    width: number;
-    height: number;
-    title?: string;
-    states: DomStateNode[];
-    paths: DomTransitionPath[];
-    labels: DomTransitionLabel[];
-    entity?: DomEntityBox;
-    outputs?: DomOutputsBox;
-    config: VisualizerConfig;
-}
-export declare const DEFAULT_CONFIG: VisualizerConfig;
-declare function formatGuard(guard: unknown): string;
-export declare function getEffectSummary(effects: unknown[]): string;
-declare function extractOutputsFromTransitions(transitions: TransitionDefinition[]): string[];
-/**
- * Render a state machine to an SVG string.
- * Works in both browser and Node.js environments.
- */
-export declare function renderStateMachineToSvg(stateMachine: StateMachineDefinition, options?: RenderOptions, config?: VisualizerConfig): string;
-/**
- * Extract state machine from various data formats (Trait, Orbital, or raw)
- */
-export declare function extractStateMachine(data: unknown): StateMachineDefinition | null;
-/**
- * Render a state machine to DOM layout data.
- * This is used by the DOM-based visualizer component for hybrid SVG/DOM rendering.
- * Unlike renderStateMachineToSvg, this returns structured data instead of an SVG string.
- */
-export declare function renderStateMachineToDomData(stateMachine: StateMachineDefinition, options?: RenderOptions, config?: VisualizerConfig): DomLayoutData;
-export { formatGuard, extractOutputsFromTransitions };

package/dist/locales/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Core locale loader for @almadar/ui.
- *
- * Exports message maps for en/ar/sl and a helper to merge
- * project-specific messages on top of core.
- */
-export type SupportedLocale = 'en' | 'ar' | 'sl';
-export interface LocaleMeta {
-    locale: string;
-    direction: 'ltr' | 'rtl';
-}
-/** Core messages keyed by locale */
-export declare const coreMessages: Record<SupportedLocale, Record<string, string>>;
-/** Locale metadata */
-export declare const localeMeta: Record<SupportedLocale, LocaleMeta>;
-/**
- * Merge core messages with project-specific messages.
- * Project keys override core keys.
- */
-export declare function mergeMessages(locale: SupportedLocale, projectMessages: Record<string, string>): Record<string, string>;

package/dist/providers/EventBusProvider.d.ts

@@ -1,60 +0,0 @@
-/**
- * EventBusProvider - React context provider for the event bus
- *
- * Provides a page-scoped event bus for trait communication.
- * Each page has its own event bus instance.
- *
- * NOTE: Selection state has been moved to SelectionProvider.
- * Use SelectionProvider for tracking selected entities.
- *
- * @packageDocumentation
- */
-import React, { type ReactNode } from 'react';
-import type { EventBusContextType } from '../hooks/event-bus-types';
-/**
- * Extended context type for backward compatibility.
- *
- * @deprecated getSelectedEntity and clearSelectedEntity are deprecated.
- * Use SelectionProvider and useSelection hook instead.
- */
-export interface EventBusContextTypeExtended extends EventBusContextType {
-    /**
-     * @deprecated Use useSelection from SelectionProvider instead.
-     * This method now returns null - selection state moved to SelectionProvider.
-     */
-    getSelectedEntity: () => unknown | null;
-    /**
-     * @deprecated Use useSelection from SelectionProvider instead.
-     * This method is now a no-op - selection state moved to SelectionProvider.
-     */
-    clearSelectedEntity: () => void;
-}
-export declare const EventBusContext: React.Context<EventBusContextTypeExtended | null>;
-interface EventBusProviderProps {
-    children: ReactNode;
-    /** Enable debug logging in development */
-    debug?: boolean;
-}
-/**
- * Provider component for the page event bus.
- *
- * This is a pure pub/sub event bus. For selection state,
- * use SelectionProvider which listens to events and maintains state.
- *
- * @example
- * ```tsx
- * function TaskDetailPage() {
- *   return (
- *     <EventBusProvider debug={process.env.NODE_ENV === 'development'}>
- *       <SelectionProvider>
- *         <TaskHeader />
- *         <TaskForm />
- *         <TaskActions />
- *       </SelectionProvider>
- *     </EventBusProvider>
- *   );
- * }
- * ```
- */
-export declare function EventBusProvider({ children, debug }: EventBusProviderProps): import("react/jsx-runtime").JSX.Element;
-export type { EventBusContextType };

package/dist/providers/FetchedDataProvider.d.ts

@@ -1,105 +0,0 @@
-/**
- * FetchedDataProvider
- *
- * Provides server-fetched entity data to the client runtime.
- * This context stores data returned from compiled event handlers
- * via the `data` field in EventResponse.
- *
- * Data Flow:
- * 1. Client sends event to server
- * 2. Server executes compiled handler with fetch effects
- * 3. Server returns { data: { EntityName: [...records] }, clientEffects: [...] }
- * 4. Provider stores data in this context
- * 5. Pattern components access data via useFetchedData hook
- *
- * Used by both Builder preview and compiled shell.
- *
- * @packageDocumentation
- */
-import React from 'react';
-export interface EntityRecord {
-    id: string;
-    [key: string]: unknown;
-}
-export interface FetchedDataState {
-    /** Entity data by entity name (e.g., { Task: [...], User: [...] }) */
-    data: Record<string, EntityRecord[]>;
-    /** Timestamp of last fetch per entity */
-    fetchedAt: Record<string, number>;
-    /** Whether data is currently being fetched */
-    loading: boolean;
-    /** Last error message */
-    error: string | null;
-}
-export interface FetchedDataContextValue {
-    /** Get all records for an entity */
-    getData: (entityName: string) => EntityRecord[];
-    /** Get a single record by ID */
-    getById: (entityName: string, id: string) => EntityRecord | undefined;
-    /** Check if entity data exists */
-    hasData: (entityName: string) => boolean;
-    /** Get fetch timestamp for entity */
-    getFetchedAt: (entityName: string) => number | undefined;
-    /** Update data from server response */
-    setData: (data: Record<string, unknown[]>) => void;
-    /** Clear all fetched data */
-    clearData: () => void;
-    /** Clear data for specific entity */
-    clearEntity: (entityName: string) => void;
-    /** Current loading state */
-    loading: boolean;
-    /** Set loading state */
-    setLoading: (loading: boolean) => void;
-    /** Current error */
-    error: string | null;
-    /** Set error */
-    setError: (error: string | null) => void;
-}
-export declare const FetchedDataContext: React.Context<FetchedDataContextValue | null>;
-export interface FetchedDataProviderProps {
-    /** Initial data (optional) */
-    initialData?: Record<string, unknown[]>;
-    /** Children */
-    children: React.ReactNode;
-}
-/**
- * FetchedDataProvider - Provides server-fetched entity data
- *
- * @example
- * ```tsx
- * <FetchedDataProvider>
- *   <OrbitalProvider>
- *     <App />
- *   </OrbitalProvider>
- * </FetchedDataProvider>
- * ```
- */
-export declare function FetchedDataProvider({ initialData, children, }: FetchedDataProviderProps): React.ReactElement;
-/**
- * Access the fetched data context.
- * Returns null if not within a FetchedDataProvider.
- */
-export declare function useFetchedDataContext(): FetchedDataContextValue | null;
-/**
- * Access fetched data with fallback behavior.
- * If not in a provider, returns empty data.
- */
-export declare function useFetchedData(): FetchedDataContextValue;
-/**
- * Access fetched data for a specific entity.
- * Provides a convenient API for entity-specific operations.
- */
-export declare function useFetchedEntity(entityName: string): {
-    /** All fetched records for this entity */
-    records: EntityRecord[];
-    /** Get a record by ID */
-    getById: (id: string) => EntityRecord | undefined;
-    /** Whether data has been fetched for this entity */
-    hasData: boolean;
-    /** When data was last fetched */
-    fetchedAt: number | undefined;
-    /** Whether data is loading */
-    loading: boolean;
-    /** Current error */
-    error: string | null;
-};

package/dist/providers/OfflineModeProvider.d.ts

@@ -1,79 +0,0 @@
-/**
- * OfflineModeProvider
- *
- * Context provider that wraps useOfflineExecutor with force-offline toggle support.
- * Enables testing offline behavior without actually disconnecting.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import { type UseOfflineExecutorOptions, type UseOfflineExecutorResult } from '../renderer/offline-executor';
-export interface OfflineModeContextValue extends UseOfflineExecutorResult {
-    /** Force offline mode for testing */
-    forceOffline: boolean;
-    /** Toggle force offline mode */
-    setForceOffline: (value: boolean) => void;
-    /** Whether effectively offline (real or forced) */
-    effectivelyOffline: boolean;
-}
-export interface OfflineModeProviderProps extends UseOfflineExecutorOptions {
-    children: React.ReactNode;
-}
-/**
- * OfflineModeProvider - Wraps offline executor with force-offline support.
- *
- * @example
- * ```tsx
- * function App() {
- *   return (
- *     <OfflineModeProvider
- *       serverUrl="/api/orbitals"
- *       authToken={token}
- *       autoSync={true}
- *       renderToSlot={slotManager.render}
- *       navigate={router.push}
- *       notify={toast.show}
- *       eventBus={{ emit: bus.emit }}
- *     >
- *       <PreviewPage />
- *     </OfflineModeProvider>
- *   );
- * }
- * ```
- */
-export declare function OfflineModeProvider({ children, ...executorOptions }: OfflineModeProviderProps): React.ReactElement;
-/**
- * Access offline mode context.
- *
- * @example
- * ```tsx
- * function OfflineToggle() {
- *   const {
- *     effectivelyOffline,
- *     forceOffline,
- *     setForceOffline,
- *     pendingCount,
- *     sync,
- *   } = useOfflineMode();
- *
- *   return (
- *     <div>
- *       <Toggle
- *         checked={forceOffline}
- *         onChange={setForceOffline}
- *       >
- *         Test Offline
- *       </Toggle>
- *       {pendingCount > 0 && <Badge>{pendingCount} pending</Badge>}
- *       <Button onClick={sync}>Sync Now</Button>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useOfflineMode(): OfflineModeContextValue;
-/**
- * Check if offline mode provider is available (optional usage).
- */
-export declare function useOptionalOfflineMode(): OfflineModeContextValue | null;
-export default OfflineModeProvider;