@almadar/ui 5.75.0 → 5.76.1

package/dist/{renderer → lib}/client-effect-executor.d.ts

@@ -9,7 +9,8 @@
  *
  * @packageDocumentation
  */
-import type { ClientEffect, ClientEffectExecutorConfig, PatternConfig, NotifyOptions } from './types';
+import type { FieldValue } from '@almadar/core';
+import type { ClientEffect, ClientEffectExecutorConfig, PatternConfig, NotifyOptions } from '../types/renderer-types';
 /**
  * Execute an array of client effects.
  *
@@ -40,29 +41,17 @@ export declare function executeClientEffects(effects: ClientEffect[], config: Cl
  * Parse a raw effect array into a typed ClientEffect.
  * Handles unknown effect formats gracefully.
  */
-export declare function parseClientEffect(raw: unknown[]): ClientEffect | null;
+export declare function parseClientEffect(raw: FieldValue[]): ClientEffect | null;
 /**
  * Parse an array of raw effects into typed ClientEffects.
  * Filters out invalid effects.
  */
-export declare function parseClientEffects(raw: unknown[] | undefined): ClientEffect[];
-/**
- * Filter effects by type.
- */
-export declare function filterEffectsByType<T extends ClientEffect[0]>(effects: ClientEffect[], type: T): Extract<ClientEffect, [T, ...unknown[]]>[];
+export declare function parseClientEffects(raw: FieldValue[] | undefined): ClientEffect[];
 /**
  * Get all render-ui effects.
  */
 export declare function getRenderUIEffects(effects: ClientEffect[]): Array<['render-ui', string, PatternConfig | null]>;
-/**
- * Get all navigate effects.
- */
-export declare function getNavigateEffects(effects: ClientEffect[]): Array<['navigate', string, Record<string, unknown>?]>;
 /**
  * Get all notify effects.
  */
 export declare function getNotifyEffects(effects: ClientEffect[]): Array<['notify', string, NotifyOptions?]>;
-/**
- * Get all emit effects.
- */
-export declare function getEmitEffects(effects: ClientEffect[]): Array<['emit', string, unknown?]>;

package/dist/{runtime → lib}/createClientEffectHandlers.d.ts

@@ -5,19 +5,19 @@
  *
  * @packageDocumentation
  */
-import type { EventPayload, EntityRow, ServiceParams } from '@almadar/core';
+import type { EventPayload, EntityRow, FieldValue, ServiceParams, PatternConfig } from '@almadar/core';
 import type { EffectHandlers } from '@almadar/runtime';
 export interface ClientEventBus {
     emit: (type: string, payload?: EventPayload) => void;
 }
 export interface SlotSetter {
-    addPattern: (slot: string, pattern: unknown, props?: Record<string, unknown>) => void;
+    addPattern: (slot: string, pattern: PatternConfig | null, props?: Record<string, FieldValue | undefined>) => void;
     clearSlot: (slot: string) => void;
 }
 export interface CreateClientEffectHandlersOptions {
     eventBus: ClientEventBus;
     slotSetter: SlotSetter;
-    navigate?: (path: string, params?: Record<string, unknown>) => void;
+    navigate?: (path: string, params?: Record<string, string>) => void;
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
     /**
      * Live client-entity write target for `[runtime]` entities. `(set
@@ -37,6 +37,6 @@ export interface CreateClientEffectHandlersOptions {
      * mock result so service-atom chains advance end-to-end in offline /
      * standalone-preview mode (see OrbitalServerRuntime's mock parallel).
      */
-    callService?: (service: string, action: string, params?: ServiceParams) => Promise<unknown>;
+    callService?: (service: string, action: string, params?: ServiceParams) => Promise<EventPayload>;
 }
 export declare function createClientEffectHandlers(options: CreateClientEffectHandlersOptions): EffectHandlers;

package/dist/{renderer → lib}/data-resolver.d.ts

@@ -11,7 +11,8 @@
  *
  * @packageDocumentation
  */
-import type { DataContext, DataResolution } from './types';
+import type { EntityRow } from '@almadar/core';
+import type { DataContext, DataResolution } from '../types/renderer-types';
 /**
  * Resolve entity data from available sources.
  *
@@ -47,22 +48,8 @@ export declare function resolveEntityDataWithQuery(entityName: string, queryRef:
 /**
  * Get a single entity record by ID.
  */
-export declare function resolveEntityById(entityName: string, id: string | number, context: DataContext): unknown | null;
-/**
- * Get the count of entities matching criteria.
- */
-export declare function resolveEntityCount(entityName: string, context: DataContext, filters?: Record<string, unknown>): number;
+export declare function resolveEntityById(entityName: string, id: string | number, context: DataContext): EntityRow | null;
 /**
  * Check if any entities exist for a given entity name.
  */
 export declare function hasEntities(entityName: string, context: DataContext): boolean;
-/**
- * Create a data context from fetched data only.
- * Convenience function for compiled shells.
- */
-export declare function createFetchedDataContext(data: Record<string, unknown[]>): DataContext;
-/**
- * Merge multiple data contexts.
- * Later contexts take precedence.
- */
-export declare function mergeDataContexts(...contexts: DataContext[]): DataContext;

package/dist/lib/debugRegistry.d.ts

@@ -3,23 +3,24 @@
  *
  * @packageDocumentation
  */
+import type { FieldValue } from '@almadar/core';
 export type DebugEventType = 'state-change' | 'event-fired' | 'effect-executed' | 'guard-evaluated' | 'error' | 'warning' | 'info';
 export interface DebugEvent {
     id: string;
     type: DebugEventType;
     source: string;
     message: string;
-    data?: Record<string, unknown>;
+    data?: Record<string, FieldValue>;
     timestamp: number;
 }
 type ChangeListener = () => void;
-export declare function logDebugEvent(type: DebugEventType, source: string, message: string, data?: Record<string, unknown>): void;
+export declare function logDebugEvent(type: DebugEventType, source: string, message: string, data?: Record<string, FieldValue>): void;
 export declare function logStateChange(source: string, from: string, to: string, event?: string): void;
-export declare function logEventFired(source: string, eventName: string, payload?: unknown): void;
-export declare function logEffectExecuted(source: string, effectType: string, details?: unknown): void;
-export declare function logError(source: string, message: string, error?: unknown): void;
-export declare function logWarning(source: string, message: string, data?: Record<string, unknown>): void;
-export declare function logInfo(source: string, message: string, data?: Record<string, unknown>): void;
+export declare function logEventFired(source: string, eventName: string, payload?: FieldValue): void;
+export declare function logEffectExecuted(source: string, effectType: string, details?: FieldValue): void;
+export declare function logError(source: string, message: string, error?: Error | null): void;
+export declare function logWarning(source: string, message: string, data?: Record<string, FieldValue>): void;
+export declare function logInfo(source: string, message: string, data?: Record<string, FieldValue>): void;
 export declare function getDebugEvents(): DebugEvent[];
 export declare function getRecentEvents(count: number): DebugEvent[];
 export declare function getEventsByType(type: DebugEventType): DebugEvent[];

package/dist/lib/entityDebug.d.ts

@@ -3,16 +3,17 @@
  *
  * @packageDocumentation
  */
+import type { FieldValue, EntityRow } from '@almadar/core';
 export interface EntityState {
     id: string;
     type: string;
-    fields: Record<string, unknown>;
+    fields: Record<string, FieldValue>;
     lastUpdated: number;
 }
 export interface RuntimeEntity {
     id: string;
     type: string;
-    data: Record<string, unknown>;
+    data: Record<string, FieldValue>;
 }
 export interface PersistentEntityInfo {
     loaded: boolean;
@@ -23,7 +24,7 @@ export interface EntitySnapshot {
     timestamp: number;
     totalCount: number;
     /** Singleton entities by name */
-    singletons: Record<string, unknown>;
+    singletons: Record<string, EntityRow>;
     /** Runtime entities (in-memory) */
     runtime: RuntimeEntity[];
     /** Persistent entities info by type */

package/dist/lib/getNestedValue.d.ts

@@ -1,4 +1,4 @@
-import type { FieldValue } from '@almadar/core';
+import type { EventPayload, FieldValue } from '@almadar/core';
 /**
  * Get Nested Value Utility
  *
@@ -7,8 +7,20 @@ import type { FieldValue } from '@almadar/core';
  *
  * @packageDocumentation
  */
-export declare function getNestedValue(obj: Record<string, FieldValue | undefined> | null | undefined, path: string): FieldValue | undefined;
-export declare function getNestedValue(obj: Record<string, unknown> | null | undefined, path: string): unknown;
+/**
+ * Get a nested value from an object using dot-notation path.
+ *
+ * @param obj - The object to traverse
+ * @param path - Dot-notation path (e.g., "company.name", "address.city")
+ * @returns The value at the path, or undefined if not found
+ *
+ * @example
+ * const data = { company: { name: "Acme Corp", address: { city: "NYC" } } };
+ * getNestedValue(data, "company.name");         // => "Acme Corp"
+ * getNestedValue(data, "company.address.city"); // => "NYC"
+ * getNestedValue(data, "company.missing");      // => undefined
+ */
+export declare function getNestedValue(obj: EventPayload | Record<string, FieldValue | undefined> | null | undefined, path: string): FieldValue | undefined;
 /**
  * Format a nested field path as a human-readable label.
  *

package/dist/lib/guardRegistry.d.ts

@@ -3,13 +3,14 @@
  *
  * @packageDocumentation
  */
+import type { FieldValue } from '@almadar/core';
 export interface GuardContext {
     traitName?: string;
     type?: "transition" | "tick";
     transitionFrom?: string;
     transitionTo?: string;
     tickName?: string;
-    [key: string]: unknown;
+    [key: string]: FieldValue | undefined;
 }
 export interface GuardEvaluation {
     id: string;
@@ -20,7 +21,7 @@ export interface GuardEvaluation {
     context: GuardContext;
     timestamp: number;
     /** Input values used in guard evaluation */
-    inputs: Record<string, unknown>;
+    inputs: Record<string, FieldValue>;
 }
 type ChangeListener = () => void;
 export declare function recordGuardEvaluation(evaluation: Omit<GuardEvaluation, "id" | "timestamp">): void;

package/dist/lib/index.cjs

@@ -279,16 +279,16 @@ function logDebugEvent(type, source, message, data) {
   notifyListeners();
 }
 function logStateChange(source, from, to, event) {
-  logDebugEvent("state-change", source, `${from} \u2192 ${to}`, { from, to, event });
+  logDebugEvent("state-change", source, `${from} \u2192 ${to}`, { from, to, event: event ?? null });
 }
 function logEventFired(source, eventName, payload) {
-  logDebugEvent("event-fired", source, eventName, { eventName, payload });
+  logDebugEvent("event-fired", source, eventName, { eventName, payload: payload ?? null });
 }
 function logEffectExecuted(source, effectType, details) {
-  logDebugEvent("effect-executed", source, effectType, { effectType, details });
+  logDebugEvent("effect-executed", source, effectType, { effectType, details: details ?? null });
 }
 function logError(source, message, error) {
-  logDebugEvent("error", source, message, { error });
+  logDebugEvent("error", source, message, { error: error?.message ?? null });
 }
 function logWarning(source, message, data) {
   logDebugEvent("warning", source, message, data);
@@ -766,7 +766,7 @@ function getNestedValue(obj, path) {
     if (value === null || value === void 0) {
       return void 0;
     }
-    if (typeof value !== "object") {
+    if (typeof value !== "object" || Array.isArray(value)) {
       return void 0;
     }
     value = value[part];
@@ -1132,7 +1132,7 @@ function drawTransitionLabelsSvg(from, to, transitions, positions, config) {
     svg += `<g class="transition-group" ${dataAttrs}>`;
     svg += `<text class="transition-label transition-event" x="${midX}" y="${labelY}" text-anchor="middle" fill="${config.colors.arrowText}" font-family="JetBrains Mono, monospace" font-size="14px" font-weight="600">${escapeXml(transition.event)}</text>`;
     const hasGuard = !!transition.guard;
-    const guardText = hasGuard ? formatGuardHuman(transition.guard) : "";
+    const guardText = hasGuard && transition.guard !== void 0 ? formatGuardHuman(transition.guard) : "";
     const effectLines = transition.effects ? formatEffectsHuman(transition.effects) : [];
     const hasEffects = effectLines.length > 0;
     if (hasGuard || hasEffects) {
@@ -1279,16 +1279,14 @@ function extractStateMachine(data) {
   if (!data || typeof data !== "object") return null;
   const obj = data;
   if (obj.states && obj.transitions) {
-    return obj;
+    return { states: obj.states, transitions: obj.transitions };
   }
   if (obj.stateMachine) {
     return obj.stateMachine;
   }
   if (Array.isArray(obj.traits)) {
-    const traitWithSM = obj.traits.find(
-      (t) => typeof t === "object" && t !== null && "stateMachine" in t
-    );
-    if (traitWithSM && typeof traitWithSM === "object" && "stateMachine" in traitWithSM) {
+    const traitWithSM = obj.traits.find((t) => t.stateMachine != null);
+    if (traitWithSM?.stateMachine) {
       return traitWithSM.stateMachine;
     }
   }
@@ -1462,7 +1460,8 @@ function renderStateMachineToDomData(stateMachine, options = {}, config = DEFAUL
 function tryParseOrbitalSchema(code) {
   try {
     const parsed = JSON.parse(code);
-    if (parsed.states && parsed.transitions || Array.isArray(parsed.orbitals)) {
+    if (typeof parsed !== "object" || parsed === null) return null;
+    if ("states" in parsed && "transitions" in parsed || Array.isArray(parsed.orbitals)) {
       return parsed;
     }
   } catch {

package/dist/lib/index.d.ts

@@ -14,5 +14,5 @@ export * from './tickRegistry';
 export * from './traitRegistry';
 export * from './verificationRegistry';
 export * from './getNestedValue';
-export * from './visualizer';
+export * from './visualizer/index';
 export * from './parseContentSegments';

package/dist/lib/index.js

@@ -277,16 +277,16 @@ function logDebugEvent(type, source, message, data) {
   notifyListeners();
 }
 function logStateChange(source, from, to, event) {
-  logDebugEvent("state-change", source, `${from} \u2192 ${to}`, { from, to, event });
+  logDebugEvent("state-change", source, `${from} \u2192 ${to}`, { from, to, event: event ?? null });
 }
 function logEventFired(source, eventName, payload) {
-  logDebugEvent("event-fired", source, eventName, { eventName, payload });
+  logDebugEvent("event-fired", source, eventName, { eventName, payload: payload ?? null });
 }
 function logEffectExecuted(source, effectType, details) {
-  logDebugEvent("effect-executed", source, effectType, { effectType, details });
+  logDebugEvent("effect-executed", source, effectType, { effectType, details: details ?? null });
 }
 function logError(source, message, error) {
-  logDebugEvent("error", source, message, { error });
+  logDebugEvent("error", source, message, { error: error?.message ?? null });
 }
 function logWarning(source, message, data) {
   logDebugEvent("warning", source, message, data);
@@ -764,7 +764,7 @@ function getNestedValue(obj, path) {
     if (value === null || value === void 0) {
       return void 0;
     }
-    if (typeof value !== "object") {
+    if (typeof value !== "object" || Array.isArray(value)) {
       return void 0;
     }
     value = value[part];
@@ -1130,7 +1130,7 @@ function drawTransitionLabelsSvg(from, to, transitions, positions, config) {
     svg += `<g class="transition-group" ${dataAttrs}>`;
     svg += `<text class="transition-label transition-event" x="${midX}" y="${labelY}" text-anchor="middle" fill="${config.colors.arrowText}" font-family="JetBrains Mono, monospace" font-size="14px" font-weight="600">${escapeXml(transition.event)}</text>`;
     const hasGuard = !!transition.guard;
-    const guardText = hasGuard ? formatGuardHuman(transition.guard) : "";
+    const guardText = hasGuard && transition.guard !== void 0 ? formatGuardHuman(transition.guard) : "";
     const effectLines = transition.effects ? formatEffectsHuman(transition.effects) : [];
     const hasEffects = effectLines.length > 0;
     if (hasGuard || hasEffects) {
@@ -1277,16 +1277,14 @@ function extractStateMachine(data) {
   if (!data || typeof data !== "object") return null;
   const obj = data;
   if (obj.states && obj.transitions) {
-    return obj;
+    return { states: obj.states, transitions: obj.transitions };
   }
   if (obj.stateMachine) {
     return obj.stateMachine;
   }
   if (Array.isArray(obj.traits)) {
-    const traitWithSM = obj.traits.find(
-      (t) => typeof t === "object" && t !== null && "stateMachine" in t
-    );
-    if (traitWithSM && typeof traitWithSM === "object" && "stateMachine" in traitWithSM) {
+    const traitWithSM = obj.traits.find((t) => t.stateMachine != null);
+    if (traitWithSM?.stateMachine) {
       return traitWithSM.stateMachine;
     }
   }
@@ -1460,7 +1458,8 @@ function renderStateMachineToDomData(stateMachine, options = {}, config = DEFAUL
 function tryParseOrbitalSchema(code) {
   try {
     const parsed = JSON.parse(code);
-    if (parsed.states && parsed.transitions || Array.isArray(parsed.orbitals)) {
+    if (typeof parsed !== "object" || parsed === null) return null;
+    if ("states" in parsed && "transitions" in parsed || Array.isArray(parsed.orbitals)) {
       return parsed;
     }
   } catch {

package/dist/lib/jazari/layout.d.ts

@@ -7,6 +7,7 @@
  * 3. Transition arm routing: forward arcs above, backward arcs below, self-loops above.
  * 4. Guard icons at 30% along arm, effect icons at 70%.
  */
+import type { FieldValue } from '@almadar/core';
 import type { JazariLayout } from './types.js';
 export interface LayoutState {
     name: string;
@@ -18,8 +19,8 @@ export interface LayoutTransition {
     from: string;
     to: string;
     event: string;
-    guard?: unknown;
-    effects?: unknown[];
+    guard?: FieldValue;
+    effects?: FieldValue[];
 }
 export interface LayoutInput {
     states: LayoutState[];

package/dist/{renderer → lib}/offline-executor.d.ts

@@ -11,7 +11,8 @@
  *
  * @packageDocumentation
  */
-import type { ClientEffect, ClientEffectExecutorConfig, EventResponse } from './types';
+import type { EntityRow, FieldValue } from '@almadar/core';
+import type { ClientEffect, ClientEffectExecutorConfig, EventResponse } from '../types/renderer-types';
 /**
  * Effect that needs to be synced to server when online
  */
@@ -23,7 +24,7 @@ export interface PendingSyncEffect {
     /** Effect type (persist, call-service, etc.) */
     type: string;
     /** Effect payload */
-    payload: unknown;
+    payload: Record<string, FieldValue>;
     /** Number of retry attempts */
     retries: number;
     /** Maximum retries before giving up */
@@ -37,7 +38,7 @@ export interface OfflineExecutorConfig extends ClientEffectExecutorConfig {
      * Mock data provider for simulating fetch responses.
      * Returns data for a given entity name.
      */
-    mockDataProvider?: (entityName: string) => unknown[];
+    mockDataProvider?: (entityName: string) => EntityRow[];
     /**
      * Whether to queue server effects for sync when online.
      * Default: true
@@ -140,7 +141,7 @@ export declare class OfflineExecutor {
      * Client effects are executed immediately.
      * Server effects are queued for sync.
      */
-    processEventOffline(event: string, payload?: Record<string, unknown>, effects?: Array<unknown[]>): EventResponse;
+    processEventOffline(event: string, payload?: Record<string, FieldValue>, effects?: Array<FieldValue[]>): EventResponse;
     /**
      * Sync pending effects to server.
      *
@@ -205,7 +206,7 @@ export interface UseOfflineExecutorResult {
     /** Execute client effects */
     executeClientEffects: (effects: ClientEffect[]) => void;
     /** Process event offline */
-    processEventOffline: (event: string, payload?: Record<string, unknown>, effects?: Array<unknown[]>) => EventResponse;
+    processEventOffline: (event: string, payload?: Record<string, FieldValue>, effects?: Array<FieldValue[]>) => EventResponse;
     /** Manually trigger sync */
     sync: () => Promise<number>;
     /** Clear the queue */

package/dist/lib/parseContentSegments.d.ts

@@ -5,6 +5,7 @@
  * segments for rendering. Detects orbital schemas in JSON code blocks
  * and marks them for JazariStateMachine rendering.
  */
+import type { OrbitalSchema } from '@almadar/core';
 /** Segment types for content rendering */
 export type ContentSegment = {
     type: 'markdown';
@@ -17,7 +18,7 @@ export type ContentSegment = {
     type: 'orbital';
     language: string;
     content: string;
-    schema: unknown;
+    schema: OrbitalSchema;
 } | {
     type: 'quiz';
     question: string;

package/dist/{renderer → lib}/pattern-resolver.d.ts

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 import type { PatternPropDef } from '@almadar/patterns';
-import type { PatternConfig, ResolvedPattern } from './types';
+import type { PatternConfig, MappedPattern } from '../types/renderer-types';
 /**
  * Component mapping entry from component-mapping.json
  */
@@ -64,7 +64,7 @@ export declare function setPatternRegistry(registry: Record<string, PatternDefin
  * // resolved.importPath === '@/components/organisms/DataTable'
  * ```
  */
-export declare function resolvePattern(config: PatternConfig): ResolvedPattern;
+export declare function resolvePattern(config: PatternConfig): MappedPattern;
 /**
  * Check if a pattern type is known.
  */

package/dist/{runtime → lib}/perf.d.ts

@@ -27,8 +27,6 @@ export declare function perfTime<T>(name: string, fn: () => T, detail?: Record<s
  * Phase is `"mount" | "update" | "nested-update"`.
  */
 export declare const profilerOnRender: ProfilerOnRenderCallback;
-/** Snapshot in insertion order (oldest first). Stable identity until next push. */
-export declare function getPerfSnapshot(): readonly PerfEntry[];
 /** React hook: returns the current ring snapshot, re-renders on push. */
 export declare function usePerfBuffer(): readonly PerfEntry[];
 export declare function clearPerf(): void;

package/dist/{renderer → lib}/slot-definitions.d.ts

@@ -7,38 +7,26 @@
  *
  * @packageDocumentation
  */
-import type { UISlot, SlotDefinition, SlotType } from './types';
+import type { UISlot, SlotDefinition } from '../types/renderer-types';
 /**
  * Definitions for all available UI slots.
  *
  * Inline slots render within the component hierarchy.
  * Portal slots render to document.body, breaking out of overflow containers.
  */
-export declare const SLOT_DEFINITIONS: Record<UISlot, SlotDefinition>;
+export declare const SLOT_DEFINITIONS: Partial<Record<UISlot, SlotDefinition>> & Record<'main' | 'sidebar' | 'modal' | 'drawer' | 'overlay' | 'center' | 'toast' | 'hud-top' | 'hud-bottom' | 'floating', SlotDefinition>;
 /**
  * Get the slot definition for a slot name.
  */
-export declare function getSlotDefinition(slot: UISlot): SlotDefinition;
+export declare function getSlotDefinition(slot: UISlot): SlotDefinition | undefined;
 /**
  * Check if a slot is a portal slot.
  */
 export declare function isPortalSlot(slot: string): boolean;
-/**
- * Check if a slot is an inline slot.
- */
-export declare function isInlineSlot(slot: UISlot): boolean;
-/**
- * Get all slots of a specific type.
- */
-export declare function getSlotsByType(type: SlotType): UISlot[];
 /**
  * Get all inline slots.
  */
 export declare function getInlineSlots(): UISlot[];
-/**
- * Get all portal slots.
- */
-export declare function getPortalSlots(): UISlot[];
 /**
  * All valid slot names.
  */

package/dist/{renderer → lib}/trait-binding-resolver.d.ts

@@ -22,6 +22,8 @@
  *
  * @see docs/Almadar_Std_Gaps.md §3.8
  */
+import React from "react";
+import type { FieldValue } from "@almadar/core";
 export interface ResolveTraitBindingsContext {
     /**
      * Depth cap — the walker refuses to descend deeper than this to
@@ -44,10 +46,12 @@ export interface ResolveTraitBindingsContext {
  * `content.props` with `currentSlot` bound to the slot whose render-ui
  * is being composed.
  */
-export declare function resolveTraitBindingsInPattern(value: unknown, ctx: ResolveTraitBindingsContext): unknown;
+type PatternTreeNode = FieldValue | React.ReactElement | undefined;
+export declare function resolveTraitBindingsInPattern(value: PatternTreeNode, ctx: ResolveTraitBindingsContext): PatternTreeNode;
 /**
  * Lower-level helper: is this string a `@trait.*` binding the resolver
  * would handle? Useful for consumers that need to treat the trait case
  * specially before handing the string back to the walker.
  */
-export declare function isTraitBinding(value: unknown): value is string;
+export declare function isTraitBinding(value: PatternTreeNode): value is string;
+export {};

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

@@ -5,6 +5,7 @@
  * It exports the visualizer to the global `OrbitalVisualizer` object.
  */
 import { renderStateMachineToSvg, extractStateMachine, getEffectSummary, extractOutputsFromTransitions, type RenderOptions, type VisualizerConfig } from './index.js';
+import type { OrbitalSchema } from '@almadar/core';
 type SExpr = string | number | boolean | SExpr[];
 declare function formatSExprHumanReadable(expr: SExpr, indent?: number): string;
 interface BrowserRenderOptions extends RenderOptions {
@@ -13,7 +14,7 @@ interface BrowserRenderOptions extends RenderOptions {
 /**
  * Render a state machine into a container element
  */
-declare function render(container: HTMLElement, data: unknown, options?: BrowserRenderOptions): void;
+declare function render(container: HTMLElement, data: OrbitalSchema | object, options?: BrowserRenderOptions): void;
 /**
  * Auto-initialize diagrams from data attributes
  */
@@ -26,7 +27,7 @@ declare let pinnedTooltip: {
  * Render a state machine into a container element using DOM-based approach
  * This matches the React DomStateMachineVisualizer component
  */
-declare function renderDom(container: HTMLElement, data: unknown, options?: BrowserRenderOptions): void;
+declare function renderDom(container: HTMLElement, data: OrbitalSchema | object, options?: BrowserRenderOptions): void;
 declare const OrbitalVisualizer: {
     render: typeof render;
     renderDom: typeof renderDom;

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

@@ -4,6 +4,7 @@
  * Renders SVG diagrams from Orbital schemas and Trait definitions.
  * Can be used in documentation, IDE previews, and other tools.
  */
+import type { Effect, OrbitalSchema, SExpr } from '@almadar/core';
 export interface VisualizerConfig {
     nodeRadius: number;
     nodeSpacing: number;
@@ -38,8 +39,8 @@ export interface TransitionDefinition {
     from: string;
     to: string;
     event: string;
-    guard?: unknown;
-    effects?: unknown[];
+    guard?: SExpr | null;
+    effects?: Effect[];
 }
 export interface StateMachineDefinition {
     states: StateDefinition[];
@@ -122,8 +123,8 @@ export interface DomLayoutData {
     config: VisualizerConfig;
 }
 export declare const DEFAULT_CONFIG: VisualizerConfig;
-declare function formatGuard(guard: unknown): string;
-export declare function getEffectSummary(effects: unknown[]): string;
+declare function formatGuard(guard: SExpr | null | undefined): string;
+export declare function getEffectSummary(effects: Effect[]): string;
 declare function extractOutputsFromTransitions(transitions: TransitionDefinition[]): string[];
 /**
  * Render a state machine to an SVG string.
@@ -133,7 +134,7 @@ export declare function renderStateMachineToSvg(stateMachine: StateMachineDefini
 /**
  * Extract state machine from various data formats (Trait, Orbital, or raw)
  */
-export declare function extractStateMachine(data: unknown): StateMachineDefinition | null;
+export declare function extractStateMachine(data: OrbitalSchema | object): StateMachineDefinition | null;
 /**
  * Render a state machine to DOM layout data.
  * This is used by the DOM-based visualizer component for hybrid SVG/DOM rendering.