@almadar/ui 5.111.0 → 5.113.0

package/dist/components/avl/organisms/Avl3DViewer.d.ts

@@ -1,40 +0,0 @@
-/**
- * Avl3DViewer - Interactive 3D Orbital Visualization
- *
- * The host organism that owns the R3F Canvas and delegates to 3D scene
- * renderers at each zoom level. The 3D equivalent of AvlCosmicZoom.
- *
- * Reuses avl-schema-parser.ts and avl-zoom-state.ts directly.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { OrbitalSchema } from '@almadar/core';
-import { type ZoomLevel } from '../lib/avl-zoom-state';
-import { type Avl3DModelOverrides } from '../providers/avl-3d-context';
-export interface Avl3DViewerProps {
-    /** The orbital schema (parsed object or JSON string) */
-    schema: OrbitalSchema | string;
-    /** CSS class for the outer container */
-    className?: string;
-    /** Enable animations (default: true) */
-    animated?: boolean;
-    /** Pre-select an orbital on mount */
-    initialOrbital?: string;
-    /** Pre-select a trait on mount */
-    initialTrait?: string;
-    /** Callback when zoom level changes */
-    onZoomChange?: (level: ZoomLevel, context: {
-        orbital?: string;
-        trait?: string;
-    }) => void;
-    /** Container width */
-    width?: number | string;
-    /** Container height */
-    height?: number | string;
-    /** Enable postprocessing effects (bloom, DOF, vignette). Default: true */
-    effects?: boolean;
-    /** Custom 3D model URLs to replace default primitive geometry */
-    modelOverrides?: Avl3DModelOverrides;
-}
-export declare const Avl3DViewer: React.FC<Avl3DViewerProps>;

package/dist/components/avl/organisms/AvlClickTarget.d.ts

@@ -1,31 +0,0 @@
-/**
- * AvlClickTarget
- *
- * Transparent SVG rect overlay that makes AVL atoms clickable.
- * AVL atoms render <g> elements which don't natively support
- * bounding-box click events. This wrapper adds an invisible
- * rect with pointer events and optional hover glow.
- *
- * @packageDocumentation
- */
-import React from 'react';
-export interface AvlClickTargetProps {
-    /** Bounding box position */
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    /** Click handler */
-    onClick: () => void;
-    /** Hover callback */
-    onHover?: (hovering: boolean) => void;
-    /** Cursor style (default: pointer) */
-    cursor?: string;
-    /** Glow color on hover */
-    glowColor?: string;
-    /** Accessible label */
-    label?: string;
-    /** Children (the AVL atoms to render on top) */
-    children: React.ReactNode;
-}
-export declare const AvlClickTarget: React.FC<AvlClickTargetProps>;

package/dist/components/avl/organisms/AvlCosmicZoom.d.ts

@@ -1,41 +0,0 @@
-/**
- * AvlCosmicZoom — Interactive Orbital Visualization
- *
- * V3: Delegates to FlowCanvas. Nodes are live OrbPreview renders
- * of each orbital/transition. Two-level navigation (overview + expanded).
- * Props interface preserved for backward compatibility with callers.
- */
-import React from 'react';
-import type { OrbitalSchema } from '@almadar/core';
-import type { ZoomLevel } from '../lib/avl-zoom-state';
-export interface AvlCosmicZoomProps {
-    /** The orbital schema (parsed object or JSON string) */
-    schema: OrbitalSchema | string;
-    /** CSS class for the outer container */
-    className?: string;
-    /** Primary color for the visualization */
-    color?: string;
-    /** Enable animations (default: true) */
-    animated?: boolean;
-    /** Pre-select an orbital on mount */
-    initialOrbital?: string;
-    /** Pre-select a trait on mount */
-    initialTrait?: string;
-    /** Callback when zoom level changes */
-    onZoomChange?: (level: ZoomLevel, context: {
-        orbital?: string;
-        trait?: string;
-    }) => void;
-    /** Container width */
-    width?: number | string;
-    /** Container height */
-    height?: number | string;
-    /** Coverage data for verification overlay */
-    stateCoverage?: Record<string, 'covered' | 'uncovered' | 'partial'>;
-    /** Dynamic focus target. Changes animate the zoom to the specified orbital/trait. */
-    focusTarget?: {
-        type: 'orbital' | 'trait';
-        name: string;
-    };
-}
-export declare const AvlCosmicZoom: React.FC<AvlCosmicZoomProps>;

package/dist/components/avl/organisms/AvlLegend.d.ts

@@ -1,15 +0,0 @@
-/**
- * AvlLegend - Compact legend showing AVL symbol definitions.
- *
- * Each scene passes the set of symbol types it uses, and
- * the legend renders only those symbols with labels.
- */
-import React from 'react';
-import type { ZoomLevel } from '../lib/avl-zoom-state';
-export interface AvlLegendProps {
-    level: ZoomLevel;
-    color?: string;
-    x?: number;
-    y?: number;
-}
-export declare const AvlLegend: React.FC<AvlLegendProps>;

package/dist/components/avl/organisms/AvlOrbitalsCosmicZoom.d.ts

@@ -1,54 +0,0 @@
-/**
- * AvlOrbitalsCosmicZoom — Orbital Interaction Visualization
- *
- * Composed organism: renders AvlOrbitalUnit molecules positioned on a canvas,
- * connected by cross-orbital event wire arrows. No React Flow dependency.
- * Designed for documentation use.
- *
- * Composition:
- *   - AvlOrbitalUnit (molecule) for each orbital
- *   - SVG overlay for event wires between orbitals
- *   - Click to select an orbital and show info panel
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { OrbitalSchema } from '@almadar/core';
-export interface AvlOrbitalsCosmicZoomProps {
-    /** The orbital schema (parsed object or JSON string) */
-    schema: OrbitalSchema | string;
-    /** CSS class for the outer container */
-    className?: string;
-    /** Primary color for the visualization */
-    color?: string;
-    /** Enable animations (default: true) */
-    animated?: boolean;
-    /** Container width */
-    width?: number | string;
-    /** Container height */
-    height?: number | string;
-    /**
-     * GAP-52: name of the orbital to highlight with a persistent ring/glow.
-     * Independent from user-driven selection (click). Used by the builder workspace
-     * when entering cosmic mode from a focused orbital — the focused orbital is
-     * highlighted while the user can still click any other orbital to select it.
-     */
-    highlightedOrbital?: string;
-    /**
-     * GAP-55: fired when the user clicks an orbital tile. Consumers (e.g. the
-     * builder workspace) use this as the trigger to drill INTO the clicked
-     * orbital — typically by switching back to the canvas tab and opening the
-     * clicked orbital at L2 expanded. Local `selected` toggle (visual highlight +
-     * info panel) still fires regardless of whether the callback is provided.
-     */
-    onOrbitalSelect?: (orbital: string) => void;
-    /**
-     * GAP-54: minimum zoom factor when scroll-wheel zooming. Default 0.4.
-     */
-    minZoom?: number;
-    /**
-     * GAP-54: maximum zoom factor when scroll-wheel zooming. Default 3.
-     */
-    maxZoom?: number;
-}
-export declare const AvlOrbitalsCosmicZoom: React.FC<AvlOrbitalsCosmicZoomProps>;

package/dist/components/avl/organisms/AvlTraitScene.d.ts

@@ -1,17 +0,0 @@
-/**
- * AvlTraitScene V2 - Zoom Level 3
- *
- * Left-to-right horizontal flow with color-coded states,
- * transition lanes, and swim lanes for emit/listen events.
- */
-import React from 'react';
-import type { TraitLevelData } from '../lib/avl-schema-parser';
-export interface AvlTraitSceneProps {
-    data: TraitLevelData;
-    color?: string;
-    onTransitionClick?: (transitionIndex: number, position: {
-        x: number;
-        y: number;
-    }) => void;
-}
-export declare const AvlTraitScene: React.FC<AvlTraitSceneProps>;

package/dist/components/avl/organisms/AvlTransitionDetail.d.ts

@@ -1,20 +0,0 @@
-/**
- * AvlTransitionDetail — HTML transition detail view for cosmic L4.
- *
- * Renders the same `TransitionLevelData` that `AvlTransitionScene`
- * (the SVG variant used by the 3D viewer) renders, but in plain HTML
- * so long effect arguments — most commonly the JSON-stringified
- * `render-ui` pattern config — wrap properly and live inside a
- * collapsible accordion. Each effect becomes one accordion item with
- * a `CodeBlock` body so the operator's full JSON code is visible at
- * one click.
- *
- * Composition: Card / Box / Stack atoms + Typography + Badge +
- * Accordion (molecule) + CodeBlock (molecule). No raw HTML.
- */
-import React from 'react';
-import type { TransitionLevelData } from '../lib/avl-schema-parser';
-export interface AvlTransitionDetailProps {
-    data: TransitionLevelData;
-}
-export declare const AvlTransitionDetail: React.FC<AvlTransitionDetailProps>;

package/dist/components/avl/organisms/AvlTransitionScene.d.ts

@@ -1,13 +0,0 @@
-/**
- * AvlTransitionScene V2 - Zoom Level 4
- *
- * Card layout replacing vertical waterfall.
- * Reads like a spec card: from → to, trigger, guard, effects.
- */
-import React from 'react';
-import type { TransitionLevelData } from '../lib/avl-schema-parser';
-export interface AvlTransitionSceneProps {
-    data: TransitionLevelData;
-    color?: string;
-}
-export declare const AvlTransitionScene: React.FC<AvlTransitionSceneProps>;

package/dist/components/avl/organisms/FlowCanvas.d.ts

@@ -1,134 +0,0 @@
-/**
- * FlowCanvas — V3 UI Projection Canvas
- *
- * The canvas IS the app. Nodes show rendered UI thumbnails from
- * render-ui effects. Edges show events connecting screens.
- *
- * Two navigation levels:
- *   Level 1 (Overview): One node per orbital showing INIT UI
- *   Level 2 (Expanded): One node per UI state within an orbital
- *
- * Double-click to expand an orbital. Click a node for code callback.
- * Escape to go back. AVL overlays on hover (future).
- */
-import React from 'react';
-import type { OrbitalSchema, ThemeDefinition, EntityData } from '@almadar/core';
-import type { ViewLevel, PreviewNodeData } from '../types/avl-preview-types';
-import type { ComposeViewLevel, BehaviorCanvasEntry, BehaviorWireEdgeData } from '../types/avl-behavior-compose-types';
-export interface FlowCanvasProps {
-    schema: OrbitalSchema | string;
-    mockData?: EntityData;
-    className?: string;
-    width?: number | string;
-    height?: number | string;
-    onNodeClick?: (context: {
-        level: ViewLevel | 'code' | 'transition';
-        orbital: string;
-        trait?: string;
-        transition?: string;
-    }) => void;
-    onLevelChange?: (level: ViewLevel, orbital?: string) => void;
-    /**
-     * GAP-52: fired when the user double-clicks an orbital. Consumers (e.g. the
-     * builder workspace) use this as the trigger to enter cosmic mode
-     * (`AvlOrbitalsCosmicZoom`) for the focused orbital.
-     *
-     * The level at which this fires is controlled by `cosmicEntryLevel` (default
-     * `'expanded'`). At `'expanded'` the existing overview→expanded drill is
-     * preserved — the callback fires only on the second double-click. At
-     * `'overview'` the callback fires on the FIRST double-click and the existing
-     * drill is suppressed for that interaction. `'both'` fires at either level.
-     *
-     * The callback runs unconditionally — persona / permission gating is the
-     * consumer's responsibility.
-     */
-    onOrbitalDoubleClick?: (orbital: string) => void;
-    /**
-     * GAP-53: which level the `onOrbitalDoubleClick` callback fires at.
-     * - `'expanded'` (default, non-breaking) — fires only at L2 expanded; the
-     *   first overview double-click still drills overview→expanded.
-     * - `'overview'` — fires at L1 overview on the FIRST double-click. The
-     *   overview→expanded drill is suppressed when the callback is provided.
-     * - `'both'` — fires at either level.
-     */
-    cosmicEntryLevel?: 'expanded' | 'overview' | 'both';
-    initialOrbital?: string;
-    /** Start at Level 2 (expanded) when initialOrbital is set. Default: 'overview'. */
-    initialLevel?: ViewLevel;
-    /** Pre-select a node on mount (opens OrbInspector). */
-    initialSelectedNode?: PreviewNodeData;
-    /** Enable editing in the inspector. When true, fields become inputs. */
-    editable?: boolean;
-    /** Called when the user edits the schema via the inspector. */
-    onSchemaChange?: (schema: OrbitalSchema) => void;
-    /** Called when the user presses Delete/Backspace with a pattern selected. */
-    onPatternDelete?: (context: {
-        patternId: string;
-        nodeData: PreviewNodeData;
-    }) => void;
-    /** Called when the user drags from a source handle to a target handle (event wiring). */
-    onEventWire?: (wire: {
-        eventName: string;
-        sourceOrbital: string;
-        targetOrbital: string;
-        sourceTraitName?: string;
-        targetTraitName?: string;
-    }) => void;
-    /** Behavior layer metadata for node styling (layer color bands). */
-    behaviorMeta?: Record<string, {
-        layer: string;
-    }>;
-    /**
-     * Per-orbital generation status. Keyed by orbital name. Drives the spinner
-     * + accent border treatment on the overview node and (future) the hover
-     * trace surface. Defaults to `'idle'` for missing entries. Consumers
-     * derive this from agent subagent_start/complete SSE events.
-     */
-    orbitalStatus?: Record<string, PreviewNodeData['status']>;
-    /**
-     * Hover handler for overview-level orbital nodes. Fires with the orbital
-     * name on enter and `null` on leave. Reserved for the upcoming trace
-     * tooltip: consumers will use it to anchor a popover that shows the
-     * subagent's live trace + reasoning for the hovered orbital.
-     */
-    onOrbitalHover?: (orbitalName: string | null) => void;
-    /** Layout hint: 'pipeline' renders nodes left-to-right, 'grid' (default) uses sqrt-based grid. */
-    layoutHint?: 'pipeline' | 'grid';
-    /** Called when the user clicks a node in overview level (for composition hints). */
-    onNodeSelect?: (orbitalName: string) => void;
-    /** When 'behavior', shows behavior-level glyph nodes instead of orbital previews. */
-    composeLevel?: ComposeViewLevel;
-    /** Behavior entries for compose mode (only when composeLevel='behavior'). */
-    behaviorEntries?: BehaviorCanvasEntry[];
-    /** Event wires between behaviors (only when composeLevel='behavior'). */
-    behaviorWires?: BehaviorWireEdgeData[];
-    /** @deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat. */
-    onZoomChange?: (level: string, context: Record<string, string | undefined>) => void;
-    /** @deprecated Not used in V3. */
-    focusTarget?: {
-        type: string;
-        name: string;
-    };
-    /** @deprecated Not used in V3. */
-    color?: string;
-    /** @deprecated Not used in V3. */
-    animated?: boolean;
-    /** @deprecated Not used in V3. */
-    initialTrait?: string;
-    /** @deprecated Not used in V3. */
-    stateCoverage?: Record<string, string>;
-    /**
-     * Studio persona viewing the canvas. Drives `OrbInspector` tab/section
-     * visibility — designers and builders hide the raw `code` tab and the
-     * architect-only Entity / raw-guard / raw-effects sections; architects see
-     * everything. Default `'builder'` preserves pre-Phase-2 behavior.
-     */
-    userType?: 'builder' | 'designer' | 'architect';
-    /**
-     * Project theme tokens (Design System tab only). Forwarded to `OrbInspector`
-     * so the Styles tab can render an editable token list when the selection
-     * originates from the synthesized `__design_system__` schema.
-     */
-    themeManifest?: ThemeDefinition;
-}
-export declare const FlowCanvas: React.FC<FlowCanvasProps>;

package/dist/components/avl/organisms/OrbInspector.d.ts

@@ -1,45 +0,0 @@
-/**
- * OrbInspector
- *
- * Universal contextual inspector for .orb programs. Built into FlowCanvas.
- * Two tabs: Inspector (contextual sections) and Code (.orb syntax view).
- *
- * Inspector shows different sections based on what was clicked:
- *   - Orbital header → entity fields, traits, pages
- *   - Pattern element → pattern props, entity (if entity-aware), transition (if fires event)
- *   - Transition node → state diagram, guard, effects, render-ui source
- *
- * Code tab shows the .orb representation of the selected context.
- *
- * When `editable` is true, inspector fields become inputs.
- */
-import React from 'react';
-import type { OrbitalSchema, ThemeDefinition } from '@almadar/core';
-import type { PreviewNodeData } from '../types/avl-preview-types';
-export interface OrbInspectorProps {
-    node: PreviewNodeData;
-    schema: OrbitalSchema;
-    editable?: boolean;
-    /**
-     * Studio persona viewing the inspector. Controls tab visibility (Code is
-     * architect-only, Styles is universal) and section visibility (Entity,
-     * raw guard, raw effects are architect-only). Default `'builder'` matches
-     * pre-Phase-2 behavior except for the new Styles tab, which every persona
-     * gets.
-     */
-    userType?: 'builder' | 'designer' | 'architect';
-    /**
-     * Project theme tokens (Design System tab only). When provided AND the
-     * selection originates from the synthesized `__design_system__` schema,
-     * the Styles tab renders an editable token-row list; edits emit
-     * `UI:PROP_CHANGE` with `propName: '__token__.<group>.<key>'` and the
-     * page-level dispatcher routes them to `themeManifest.setToken`.
-     */
-    themeManifest?: ThemeDefinition;
-    onSchemaChange?: (schema: OrbitalSchema) => void;
-    onClose: () => void;
-}
-export declare function OrbInspector({ node, schema, editable, userType, themeManifest, onSchemaChange, onClose }: OrbInspectorProps): React.ReactElement;
-export declare namespace OrbInspector {
-    var displayName: string;
-}

package/dist/components/avl/organisms/ZoomBreadcrumb.d.ts

@@ -1,16 +0,0 @@
-/**
- * ZoomBreadcrumb — HTML overlay showing current zoom band context.
- *
- * Positioned absolute top-left of the FlowCanvas.
- * Shows AVL primitive icons inline with breadcrumb segments.
- */
-import React from 'react';
-import type { ZoomBand } from '../types/avl-canvas-types';
-export interface ZoomBreadcrumbProps {
-    band: ZoomBand;
-    applicationName?: string;
-    orbitalName?: string;
-    traitName?: string;
-    eventName?: string;
-}
-export declare const ZoomBreadcrumb: React.FC<ZoomBreadcrumbProps>;

package/dist/components/avl/organisms/ZoomLegend.d.ts

@@ -1,10 +0,0 @@
-/**
- * ZoomLegend — Collapsible HTML overlay showing AVL primitives
- * relevant to the current zoom band.
- */
-import React from 'react';
-import type { ZoomBand } from '../types/avl-canvas-types';
-export interface ZoomLegendProps {
-    band: ZoomBand;
-}
-export declare const ZoomLegend: React.FC<ZoomLegendProps>;

package/dist/components/avl/organisms/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * AVL Organisms - Interactive orbital visualizations.
- *
- * V3: FlowCanvas is the primary organism. AvlCosmicZoom delegates to it.
- *
- * @packageDocumentation
- */
-export { FlowCanvas, type FlowCanvasProps } from './FlowCanvas';
-export { OrbInspector, type OrbInspectorProps } from './OrbInspector';
-export { ZoomBreadcrumb, type ZoomBreadcrumbProps } from './ZoomBreadcrumb';
-export { ZoomLegend, type ZoomLegendProps } from './ZoomLegend';
-export { AvlCosmicZoom, type AvlCosmicZoomProps } from './AvlCosmicZoom';
-export { AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps } from './AvlOrbitalsCosmicZoom';
-export { AvlTraitScene, type AvlTraitSceneProps } from './AvlTraitScene';
-export { AvlTransitionScene, type AvlTransitionSceneProps } from './AvlTransitionScene';
-export { AvlClickTarget, type AvlClickTargetProps } from './AvlClickTarget';
-export { AvlLegend, type AvlLegendProps } from './AvlLegend';
-export { parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, type ApplicationLevelData, type OrbitalLevelData, type TraitLevelData, type TransitionLevelData, type CrossLink, type ExprTreeNode, } from '../lib/avl-schema-parser';
-export { zoomReducer, initialZoomState, getBreadcrumbs, type ZoomLevel, type ZoomState, type ZoomAction, type BreadcrumbSegment, } from '../lib/avl-zoom-state';

package/dist/components/avl/providers/avl-3d-context.d.ts

@@ -1,32 +0,0 @@
-/**
- * avl-3d-context.ts
- *
- * React context for AVL 3D model overrides and configuration.
- * Allows replacing primitive geometry with custom GLB/GLTF models.
- *
- * @packageDocumentation
- */
-export interface Avl3DModelOverrides {
-    /** GLB URL for orbital nodes (replaces sphere) */
-    orbital?: string;
-    /** GLB URL for entity core (replaces icosahedron) */
-    entity?: string;
-    /** GLB URL for state nodes (replaces sphere) */
-    state?: string;
-    /** GLB URL for guard gates (replaces octahedron) */
-    guard?: string;
-    /** GLB URL for page portals (replaces plane) */
-    page?: string;
-}
-export interface Avl3DConfig {
-    /** Custom 3D model URLs to replace default primitive geometry */
-    modelOverrides: Avl3DModelOverrides;
-    /** Whether postprocessing effects are enabled */
-    effectsEnabled: boolean;
-}
-export declare const Avl3DContext: import("react").Context<Avl3DConfig>;
-/**
- * Access the current AVL 3D configuration.
- * Returns model overrides and effect settings.
- */
-export declare function useAvl3DConfig(): Avl3DConfig;

package/dist/components/avl/types/avl-atom-types.d.ts

@@ -1,53 +0,0 @@
-/**
- * Almadar Visual Language (AVL) shared types.
- *
- * Every AVL atom renders a `<g>` element (not `<svg>`) and accepts
- * AvlBaseProps for positioning and styling within a parent SVG.
- */
-export interface AvlBaseProps {
-    x?: number;
-    y?: number;
-    color?: string;
-    opacity?: number;
-    className?: string;
-}
-export type AvlEffectType = 'render-ui' | 'set' | 'persist' | 'fetch' | 'emit' | 'navigate' | 'notify' | 'call-service' | 'spawn' | 'despawn' | 'do' | 'if' | 'log';
-export type AvlFieldTypeKind = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'object' | 'array';
-export type AvlPersistenceKind = 'persistent' | 'runtime' | 'singleton' | 'instance';
-export type AvlOperatorNamespace = 'arithmetic' | 'comparison' | 'logic' | 'string' | 'collection' | 'time' | 'control' | 'async';
-export declare const AVL_OPERATOR_COLORS: Record<AvlOperatorNamespace, string>;
-export declare const AVL_FIELD_TYPE_SHAPES: Record<AvlFieldTypeKind, string>;
-export type StateRole = 'initial' | 'terminal' | 'hub' | 'error' | 'default';
-export declare const STATE_COLORS: Record<StateRole, {
-    fill: string;
-    border: string;
-}>;
-export type EffectCategory = 'ui' | 'data' | 'communication' | 'lifecycle' | 'control';
-export declare const EFFECT_CATEGORY_COLORS: Record<EffectCategory, {
-    color: string;
-    bg: string;
-}>;
-export declare const EFFECT_TYPE_TO_CATEGORY: Record<AvlEffectType, EffectCategory>;
-export declare const CONNECTION_COLORS: {
-    readonly forward: {
-        readonly color: "#1E293B";
-        readonly width: 2;
-        readonly dash: "none";
-    };
-    readonly backward: {
-        readonly color: "#94A3B8";
-        readonly width: 1.5;
-        readonly dash: "6 3";
-    };
-    readonly selfLoop: {
-        readonly color: "#CBD5E1";
-        readonly width: 1;
-        readonly dash: "3 2";
-    };
-    readonly emitListen: {
-        readonly color: "#F97316";
-        readonly width: 1.5;
-        readonly dash: "4 3";
-    };
-};
-export declare function getStateRole(name: string, isInitial?: boolean, isTerminal?: boolean, transitionCount?: number, maxTransitionCount?: number): StateRole;