@almadar/ui 5.111.0 → 5.113.0

package/dist/avl/index.d.ts

@@ -1,64 +0,0 @@
-/**
- * @almadar/ui/avl
- *
- * Almadar Visual Language (AVL) — Formal visual notation for .orb constructs.
- * V3: Unified with React Flow. AVL primitives render inside React Flow nodes.
- */
-export { AvlOrbital, type AvlOrbitalProps } from '../components/avl/atoms/index';
-export { AvlEntity, type AvlEntityProps } from '../components/avl/atoms/index';
-export { AvlTrait, type AvlTraitProps } from '../components/avl/atoms/index';
-export { AvlPage, type AvlPageProps } from '../components/avl/atoms/index';
-export { AvlApplication, type AvlApplicationProps } from '../components/avl/atoms/index';
-export { AvlState, type AvlStateProps } from '../components/avl/atoms/index';
-export { AvlTransition, type AvlTransitionProps } from '../components/avl/atoms/index';
-export { AvlEvent, type AvlEventProps } from '../components/avl/atoms/index';
-export { AvlGuard, type AvlGuardProps } from '../components/avl/atoms/index';
-export { AvlEffect, type AvlEffectProps } from '../components/avl/atoms/index';
-export { AvlField, type AvlFieldProps } from '../components/avl/atoms/index';
-export { AvlFieldType, type AvlFieldTypeProps } from '../components/avl/atoms/index';
-export { AvlBinding, type AvlBindingProps } from '../components/avl/atoms/index';
-export { AvlPersistence, type AvlPersistenceProps } from '../components/avl/atoms/index';
-export { AvlOperator, type AvlOperatorProps } from '../components/avl/atoms/index';
-export { AvlSExpr, type AvlSExprProps } from '../components/avl/atoms/index';
-export { AvlLiteral, type AvlLiteralProps } from '../components/avl/atoms/index';
-export { AvlBindingRef, type AvlBindingRefProps } from '../components/avl/atoms/index';
-export type { AvlBaseProps, AvlEffectType, AvlFieldTypeKind, AvlPersistenceKind, AvlOperatorNamespace, } from '../components/avl/atoms/index';
-export { AVL_OPERATOR_COLORS, AVL_FIELD_TYPE_SHAPES } from '../components/avl/atoms/index';
-export type { StateRole, EffectCategory } from '../components/avl/atoms/index';
-export { STATE_COLORS, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, CONNECTION_COLORS, getStateRole } from '../components/avl/atoms/index';
-export { AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition } from '../components/avl/molecules/index';
-export { AvlOrbitalUnit, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, type AvlOrbitalUnitPage } from '../components/avl/molecules/index';
-export { AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition } from '../components/avl/molecules/index';
-export { AvlEmitListen, type AvlEmitListenProps } from '../components/avl/molecules/index';
-export { AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot } from '../components/avl/molecules/index';
-export { AvlExprTree, type AvlExprTreeProps, type AvlExprTreeNode } from '../components/avl/molecules/index';
-export { AvlBehaviorGlyph, type AvlBehaviorGlyphProps, type BehaviorLevel, type GlyphSize, type BehaviorGlyphChild, type BehaviorGlyphConnection, DOMAIN_COLORS } from '../components/avl/molecules/index';
-export { AvlTransitionLane, type AvlTransitionLaneProps } from '../components/avl/molecules/index';
-export { AvlSwimLane, type AvlSwimLaneProps } from '../components/avl/molecules/index';
-export { ringPositions, arcPath, radialPositions, gridPositions, curveControlPoint } from '../components/avl/molecules/index';
-export { type ZoomBand, type AvlNodeData, type AvlEdgeData, ZOOM_BAND_THRESHOLDS } from '../components/avl/types/avl-canvas-types';
-export { computeZoomBand, zoomProgress, useZoomBand, ZoomBandContext } from '../components/avl/lib/avl-zoom-band';
-export { schemaToFlowGraph } from '../components/avl/lib/avl-flow-converter';
-export { SystemNode } from '../components/avl/molecules/SystemNode';
-export { ModuleCard } from '../components/avl/molecules/ModuleCard';
-export { MiniStateMachine } from '../components/avl/molecules/MiniStateMachine';
-export { BehaviorView } from '../components/avl/molecules/BehaviorView';
-export { DetailView } from '../components/avl/molecules/DetailView';
-export { AvlOrbitalNode } from '../components/avl/molecules/AvlOrbitalNode';
-export { AvlTransitionEdge, type AvlTransitionEdgeData } from '../components/avl/molecules/AvlTransitionEdge';
-export { AvlEventWireEdge, type AvlEventWireEdgeData } from '../components/avl/molecules/AvlEventWireEdge';
-export { AvlBackwardEdge } from '../components/avl/molecules/AvlBackwardEdge';
-export { AvlPageEdge } from '../components/avl/molecules/AvlPageEdge';
-export { AvlBindingEdge } from '../components/avl/molecules/AvlBindingEdge';
-export { computeTraitLayout, edgePath, type LayoutNode, type LayoutEdge, type ElkLayout } from '../components/avl/lib/avl-elk-layout';
-export { type ViewLevel, type PreviewNodeData, type EventEdgeData, type PatternEventSource, type RenderUIEntry } from '../components/avl/types/avl-preview-types';
-export { schemaToOverviewGraph, orbitalToExpandedGraph } from '../components/avl/lib/avl-preview-converter';
-export { OrbPreviewNode } from '../components/avl/molecules/OrbPreviewNode';
-export { EventFlowEdge } from '../components/avl/molecules/EventFlowEdge';
-export { deriveEditFocusFromElement } from '../components/avl/lib/derive-edit-focus';
-export { CanvasDndProvider, useCanvasDraggable, useCanvasDroppable, type CanvasDragKind, type CanvasDragPayload, type CanvasContainerNode, type CanvasDropTarget, type CanvasDropEvent, type CanvasDndProviderProps, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, } from '../components/avl/hooks/useCanvasDnd';
-export { type ComposeViewLevel, type BehaviorComposeNodeData, type BehaviorWireEdgeData, type BehaviorCanvasEntry, type ConnectableEvent } from '../components/avl/types/avl-behavior-compose-types';
-export { BehaviorComposeNode } from '../components/avl/molecules/BehaviorComposeNode';
-export { behaviorsToComposeGraph, registryEntryToCanvasEntry, type BehaviorRegistryRecord } from '../components/avl/lib/avl-behavior-compose-converter';
-export { OrbInspector, type OrbInspectorProps } from '../components/avl/organisms/OrbInspector';
-export { FlowCanvas, type FlowCanvasProps, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, AvlCosmicZoom, type AvlCosmicZoomProps, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransitionScene, type AvlTransitionSceneProps, AvlClickTarget, type AvlClickTargetProps, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, type ApplicationLevelData, type OrbitalLevelData, type TraitLevelData, type TransitionLevelData, type CrossLink, type ZoomLevel, } from '../components/avl/organisms/index';

package/dist/components/avl/atoms/Avl3DLabel.d.ts

@@ -1,23 +0,0 @@
-/**
- * Avl3DLabel - Billboard text label for 3D AVL visualizations.
- *
- * Uses drei's Html component to render text that always faces the camera.
- *
- * @packageDocumentation
- */
-import React from 'react';
-export interface Avl3DLabelProps {
-    /** 3D position [x, y, z] */
-    position: [number, number, number];
-    /** Label text */
-    text: string;
-    /** Text color (CSS) */
-    color?: string;
-    /** Font size in px */
-    fontSize?: number;
-    /** CSS class */
-    className?: string;
-    /** Hide label when behind other objects */
-    occlude?: boolean;
-}
-export declare const Avl3DLabel: React.FC<Avl3DLabelProps>;

package/dist/components/avl/atoms/Avl3DTooltip.d.ts

@@ -1,25 +0,0 @@
-/**
- * Avl3DTooltip - Styled tooltip card for 3D AVL hover info.
- *
- * Uses drei's Html to render a DOM card in 3D space that always
- * faces the camera. Shows contextual info based on the hovered node.
- *
- * @packageDocumentation
- */
-import React from 'react';
-export interface Avl3DTooltipProps {
-    /** 3D position [x, y, z] */
-    position: [number, number, number];
-    /** Tooltip title (bold, top line) */
-    title: string;
-    /** Key-value rows to display */
-    rows: Array<{
-        label: string;
-        value: string;
-    }>;
-    /** Optional accent color for the left border */
-    accentColor?: string;
-    /** CSS class */
-    className?: string;
-}
-export declare const Avl3DTooltip: React.FC<Avl3DTooltipProps>;

package/dist/components/avl/atoms/AvlApplication.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlApplicationProps extends AvlBaseProps {
-    width?: number;
-    height?: number;
-    label?: string;
-}
-export declare const AvlApplication: React.FC<AvlApplicationProps>;

package/dist/components/avl/atoms/AvlBinding.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-export interface AvlBindingProps {
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    label?: string;
-    color?: string;
-    opacity?: number;
-    className?: string;
-}
-export declare const AvlBinding: React.FC<AvlBindingProps>;

package/dist/components/avl/atoms/AvlBindingRef.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlBindingRefProps extends AvlBaseProps {
-    path: string;
-    size?: number;
-}
-export declare const AvlBindingRef: React.FC<AvlBindingRefProps>;

package/dist/components/avl/atoms/AvlEffect.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps, AvlEffectType } from '../types/avl-atom-types';
-export interface AvlEffectProps extends AvlBaseProps {
-    effectType: AvlEffectType;
-    size?: number;
-    label?: string;
-    /** V2: Render a category-colored background circle behind the icon. */
-    showBackground?: boolean;
-}
-export declare const AvlEffect: React.FC<AvlEffectProps>;

package/dist/components/avl/atoms/AvlEntity.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps, AvlPersistenceKind } from '../types/avl-atom-types';
-export interface AvlEntityProps extends AvlBaseProps {
-    r?: number;
-    fieldCount?: number;
-    persistence?: AvlPersistenceKind;
-    label?: string;
-}
-export declare const AvlEntity: React.FC<AvlEntityProps>;

package/dist/components/avl/atoms/AvlEvent.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlEventProps extends AvlBaseProps {
-    size?: number;
-    label?: string;
-}
-export declare const AvlEvent: React.FC<AvlEventProps>;

package/dist/components/avl/atoms/AvlField.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlFieldProps extends AvlBaseProps {
-    /** Angle in radians from entity center. */
-    angle?: number;
-    length?: number;
-    required?: boolean;
-    label?: string;
-}
-export declare const AvlField: React.FC<AvlFieldProps>;

package/dist/components/avl/atoms/AvlFieldType.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps, AvlFieldTypeKind } from '../types/avl-atom-types';
-export interface AvlFieldTypeProps extends AvlBaseProps {
-    kind: AvlFieldTypeKind;
-    size?: number;
-    label?: string;
-}
-export declare const AvlFieldType: React.FC<AvlFieldTypeProps>;

package/dist/components/avl/atoms/AvlGuard.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlGuardProps extends AvlBaseProps {
-    size?: number;
-    label?: string;
-}
-export declare const AvlGuard: React.FC<AvlGuardProps>;

package/dist/components/avl/atoms/AvlLiteral.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlLiteralProps extends AvlBaseProps {
-    value: string;
-    size?: number;
-}
-export declare const AvlLiteral: React.FC<AvlLiteralProps>;

package/dist/components/avl/atoms/AvlOperator.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps, AvlOperatorNamespace } from '../types/avl-atom-types';
-export interface AvlOperatorProps extends AvlBaseProps {
-    name: string;
-    namespace?: AvlOperatorNamespace;
-    size?: number;
-}
-export declare const AvlOperator: React.FC<AvlOperatorProps>;

package/dist/components/avl/atoms/AvlOrbital.d.ts

@@ -1,11 +0,0 @@
-import React from 'react';
-export interface AvlOrbitalProps {
-    cx?: number;
-    cy?: number;
-    r?: number;
-    label?: string;
-    color?: string;
-    opacity?: number;
-    className?: string;
-}
-export declare const AvlOrbital: React.FC<AvlOrbitalProps>;

package/dist/components/avl/atoms/AvlPage.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlPageProps extends AvlBaseProps {
-    size?: number;
-    label?: string;
-}
-export declare const AvlPage: React.FC<AvlPageProps>;

package/dist/components/avl/atoms/AvlPersistence.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps, AvlPersistenceKind } from '../types/avl-atom-types';
-export interface AvlPersistenceProps extends AvlBaseProps {
-    kind: AvlPersistenceKind;
-    size?: number;
-    label?: string;
-}
-export declare const AvlPersistence: React.FC<AvlPersistenceProps>;

package/dist/components/avl/atoms/AvlSExpr.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-export interface AvlSExprProps extends AvlBaseProps {
-    width?: number;
-    height?: number;
-    label?: string;
-}
-export declare const AvlSExpr: React.FC<AvlSExprProps>;

package/dist/components/avl/atoms/AvlState.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { AvlBaseProps } from '../types/avl-atom-types';
-import { type StateRole } from '../types/avl-atom-types';
-export interface AvlStateProps extends AvlBaseProps {
-    name?: string;
-    isInitial?: boolean;
-    isTerminal?: boolean;
-    width?: number;
-    height?: number;
-    /** V2: Role-based fill color. When set, overrides monochrome rendering. */
-    role?: StateRole;
-    /** V2: Number of transitions touching this state. Drives proportional width. */
-    transitionCount?: number;
-}
-export declare const AvlState: React.FC<AvlStateProps>;

package/dist/components/avl/atoms/AvlTrait.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-export interface AvlTraitProps {
-    cx?: number;
-    cy?: number;
-    rx?: number;
-    ry?: number;
-    rotation?: number;
-    label?: string;
-    color?: string;
-    opacity?: number;
-    className?: string;
-}
-export declare const AvlTrait: React.FC<AvlTraitProps>;

package/dist/components/avl/atoms/AvlTransition.d.ts

@@ -1,18 +0,0 @@
-import React from 'react';
-export interface AvlTransitionProps {
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    curved?: boolean;
-    /** Center point to curve away from (curves outward if provided). */
-    curveAwayFrom?: {
-        x: number;
-        y: number;
-    };
-    label?: string;
-    color?: string;
-    opacity?: number;
-    className?: string;
-}
-export declare const AvlTransition: React.FC<AvlTransitionProps>;

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

@@ -1,24 +0,0 @@
-export type { AvlBaseProps, AvlEffectType, AvlFieldTypeKind, AvlPersistenceKind, AvlOperatorNamespace, } from '../types/avl-atom-types';
-export { AVL_OPERATOR_COLORS, AVL_FIELD_TYPE_SHAPES } from '../types/avl-atom-types';
-export type { StateRole, EffectCategory } from '../types/avl-atom-types';
-export { STATE_COLORS, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, CONNECTION_COLORS, getStateRole } from '../types/avl-atom-types';
-export { AvlOrbital, type AvlOrbitalProps } from './AvlOrbital';
-export { AvlEntity, type AvlEntityProps } from './AvlEntity';
-export { AvlTrait, type AvlTraitProps } from './AvlTrait';
-export { AvlPage, type AvlPageProps } from './AvlPage';
-export { AvlApplication, type AvlApplicationProps } from './AvlApplication';
-export { AvlState, type AvlStateProps } from './AvlState';
-export { AvlTransition, type AvlTransitionProps } from './AvlTransition';
-export { AvlEvent, type AvlEventProps } from './AvlEvent';
-export { AvlGuard, type AvlGuardProps } from './AvlGuard';
-export { AvlEffect, type AvlEffectProps } from './AvlEffect';
-export { AvlField, type AvlFieldProps } from './AvlField';
-export { AvlFieldType, type AvlFieldTypeProps } from './AvlFieldType';
-export { AvlBinding, type AvlBindingProps } from './AvlBinding';
-export { AvlPersistence, type AvlPersistenceProps } from './AvlPersistence';
-export { AvlOperator, type AvlOperatorProps } from './AvlOperator';
-export { AvlSExpr, type AvlSExprProps } from './AvlSExpr';
-export { AvlLiteral, type AvlLiteralProps } from './AvlLiteral';
-export { AvlBindingRef, type AvlBindingRefProps } from './AvlBindingRef';
-export { Avl3DLabel, type Avl3DLabelProps } from './Avl3DLabel';
-export { Avl3DTooltip, type Avl3DTooltipProps } from './Avl3DTooltip';

package/dist/components/avl/hooks/useCanvasDnd.d.ts

@@ -1,155 +0,0 @@
-/**
- * useCanvasDnd — drag/drop primitives for the AVL canvas surface.
- *
- * Shares the sensor stack + collision waterfall with `useDataDnd` (both
- * import from `hooks/useAlmadarDndCollision`); diverges on drop semantics
- * because palette → canvas is a cursor-resolved tree insert, not a
- * sortable-list reorder.
- *
- * Pointer-sensor based so it works inside React Flow nodes (the native
- * HTML5 DnD path was swallowed by React Flow's pan/zoom handlers).
- *
- * Event contract (defaults — overridable via `CanvasDndProvider.onDrop`):
- *   - On drag start: emits `UI:DRAG_START` { kind, data }
- *   - On drag end:   emits `UI:DRAG_END`   { kind, data }
- *   - On 'pattern' drop:   emits `UI:PATTERN_DROP`  { patternType, containerNode, parentPath?, index? }
- *   - On 'behavior' drop:  emits `UI:BEHAVIOR_DROP` { behaviorName, containerNode }
- *
- * The `onDrop` callback lets consumers route OTHER payload kinds (e.g.
- * `'pattern-instance'` for in-canvas reorder of an existing pattern) to
- * their own bus events or schema mutations. Reorder semantics belong in
- * the consumer because they touch the SExpr tree directly — this primitive
- * only resolves payload + target + cursor and hands them off.
- */
-import React from 'react';
-import { useDraggable as dndKitUseDraggable } from '@dnd-kit/core';
-import type { EventPayload } from '@almadar/core';
-/**
- * Drag kinds the canvas understands. Open-ended `string` so consumers can
- * introduce new kinds (e.g. `'pattern-instance'` for in-canvas reorder of an
- * existing pattern) without touching this file — the provider's defaults
- * cover `'pattern'` and `'behavior'`; everything else routes through the
- * consumer's `onDrop`.
- */
-export type CanvasDragKind = 'pattern' | 'behavior' | (string & {});
-/**
- * Payload carried by a draggable. For `'pattern'` tiles `data` is
- * `{ type: string }`, for `'behavior'` tiles `{ name: string }`. For consumer
- * kinds (e.g. `'pattern-instance'`) the shape is whatever the consumer
- * agrees on with its own `onDrop`.
- */
-export interface CanvasDragPayload {
-    kind: CanvasDragKind;
-    data: EventPayload;
-}
-/**
- * Orbital/trait/transition context a drop will mutate.
- *
- * Has an explicit `[key: string]: string | undefined` index signature so it
- * structurally matches `EventPayload` — required because we pass the whole
- * object as a field on the `UI:PATTERN_DROP` payload.
- */
-export interface CanvasContainerNode {
-    orbitalName?: string;
-    traitName?: string;
-    transitionEvent?: string;
-    [key: string]: string | undefined;
-}
-/** Drop-target metadata stored on each droppable's `data` field. */
-export interface CanvasDropTarget {
-    /**
-     * `l1` = outer orbital frame (overview level).
-     * `l2` = render-ui slot inside an expanded orbital.
-     * `wrapper` = page-level catch-all fired when nothing inner caught the drop.
-     */
-    level: 'l1' | 'l2' | 'wrapper' | (string & {});
-    /** Full or partial container context this drop will mutate. */
-    containerNode: CanvasContainerNode;
-    /**
-     * Optional resolver called at drop time to derive `parentPath` + `index`
-     * from the pointer's final client position. L2 slots use this to walk the
-     * DOM under their `contentRef` and find the nearest `data-accepts-children`
-     * container plus the cursor-relative insertion index.
-     */
-    resolvePath?: (cursor: {
-        x: number;
-        y: number;
-    }) => {
-        parentPath: string;
-        index: number;
-    } | null;
-}
-export interface CanvasDropEvent {
-    payload: CanvasDragPayload;
-    target: CanvasDropTarget;
-    /** Final pointer client position, when dnd-kit could compute it. */
-    cursor: {
-        x: number;
-        y: number;
-    } | null;
-    /**
-     * Resolved insertion path/index from `target.resolvePath(cursor)`. Null
-     * when the target has no resolver or the cursor was unavailable.
-     */
-    resolved: {
-        parentPath: string;
-        index: number;
-    } | null;
-}
-export interface UseCanvasDraggableArgs {
-    /** Unique id (per-tile). dnd-kit uses this to track the active drag. */
-    id: string;
-    payload: CanvasDragPayload;
-    disabled?: boolean;
-}
-export interface UseCanvasDraggableResult {
-    setNodeRef: (node: HTMLElement | null) => void;
-    attributes: ReturnType<typeof dndKitUseDraggable>['attributes'];
-    listeners: ReturnType<typeof dndKitUseDraggable>['listeners'];
-    isDragging: boolean;
-    /** Spread on the tile — live transform + grab cursor + touch-action. */
-    style: React.CSSProperties;
-}
-export declare function useCanvasDraggable({ id, payload, disabled, }: UseCanvasDraggableArgs): UseCanvasDraggableResult;
-export interface UseCanvasDroppableArgs {
-    id: string;
-    target: CanvasDropTarget;
-    /** Which drag kinds this zone accepts. Defaults to ['pattern','behavior']. */
-    accepts?: readonly CanvasDragKind[];
-    disabled?: boolean;
-}
-export interface UseCanvasDroppableResult {
-    setNodeRef: (node: HTMLElement | null) => void;
-    isOver: boolean;
-}
-export declare function useCanvasDroppable({ id, target, accepts, disabled, }: UseCanvasDroppableArgs): UseCanvasDroppableResult;
-export interface CanvasDndProviderProps {
-    children: React.ReactNode;
-    /**
-     * Override the default drop behavior. The default emits `UI:PATTERN_DROP`
-     * / `UI:BEHAVIOR_DROP` based on payload kind. Pass an `onDrop` to route
-     * additional kinds (e.g. `'pattern-instance'` reorder) elsewhere, or to
-     * mutate schema directly without going through the bus.
-     *
-     * Return `true` from `onDrop` to suppress the default emit; return
-     * `false`/`undefined` to fall through to defaults after running your code.
-     */
-    onDrop?: (drop: CanvasDropEvent) => boolean | void;
-    /**
-     * Renders the floating preview that follows the cursor during a drag.
-     * @dnd-kit moves the source DOM node via CSS transform, which gets clipped
-     * by any ancestor with `overflow: hidden|auto|scroll` (e.g. a scrollable
-     * palette column). Returning a node here mounts a portal-attached overlay
-     * outside the clip so the user always sees what they're dragging.
-     *
-     * Receives the active payload (or null between drags) and returns the
-     * preview element — typically the same JSX the tile renders inline.
-     */
-    renderOverlay?: (payload: CanvasDragPayload | null) => React.ReactNode;
-}
-/**
- * Wraps a canvas subtree in one DndContext + sensors + collision waterfall.
- * Every `useCanvasDraggable` / `useCanvasDroppable` inside this provider
- * participates in the same drag session.
- */
-export declare function CanvasDndProvider({ children, onDrop, renderOverlay, }: CanvasDndProviderProps): React.ReactElement;

package/dist/components/avl/lib/avl-3d-layout.d.ts

@@ -1,116 +0,0 @@
-/**
- * avl-3d-layout.ts
- *
- * Pure math utilities for 3D positioning of AVL visualization nodes.
- * The 3D equivalent of avl-layout.ts (2D positioning helpers).
- *
- * @packageDocumentation
- */
-import { QuadraticBezierCurve3 } from 'three';
-export interface Position3D {
-    x: number;
-    y: number;
-    z: number;
-}
-export interface ExprTreeNode3D {
-    label: string;
-    type: 'operator' | 'literal' | 'binding';
-    children?: ExprTreeNode3D[];
-}
-export interface TreeLayoutResult {
-    node: ExprTreeNode3D;
-    position: Position3D;
-}
-/**
- * Refined palette following Almadar UI Beauty principles:
- * - No pure black: deep navy tint (#0c1222) instead of #0A0A1A
- * - 60-30-10 rule: 60% deep background, 30% muted blues/grays, 10% bright accents
- * - Desaturated for dark backgrounds: softer blues, warmer golds
- * - Depth through color layering: surfaces get progressively lighter
- */
-export declare const AVL_3D_COLORS: {
-    readonly orbitalSphere: "#161b2e";
-    readonly orbitalRim: "#5b9bd5";
-    readonly entityCore: "#f0c040";
-    readonly entityCoreGlow: "#ffd866";
-    readonly traitOrbit: "#5b9bd5";
-    readonly traitOrbitHighlight: "#7ab8f5";
-    readonly stateIdle: "#1e2a3a";
-    readonly stateEdge: "#5b9bd5";
-    readonly stateActive: "#4ecb71";
-    readonly transitionArc: "#e0944a";
-    readonly transitionArcHover: "#f0a860";
-    readonly guardPass: "#4ecb71";
-    readonly guardFail: "#f06060";
-    readonly crossWire: "#a78bda";
-    readonly crossWireGlow: "#c4a8f0";
-    readonly pagePortal: "#40c8aa";
-    readonly background: "#0c1222";
-    readonly backgroundSurface: "#111a2e";
-    readonly fog: "#0c1222";
-    readonly sparkle: "#7ab8f5";
-    readonly sparkleWarm: "#f0c040";
-};
-/**
- * Positions N nodes on a golden-ratio spiral in the XZ plane (y=0).
- * Used as initial positions for the force-directed layout.
- */
-export declare function goldenSpiralPositions(count: number, baseRadius: number): Position3D[];
-interface ForceEdge {
-    from: number;
-    to: number;
-}
-/**
- * Runs a simple force-directed simulation to cluster connected nodes.
- * Connected nodes attract, all nodes repel. Runs for a fixed number of iterations.
- *
- * @param count Number of nodes
- * @param edges Connections between nodes (indices)
- * @param baseRadius Approximate spread radius
- * @param iterations Simulation steps (default 80)
- */
-export declare function forceDirectedPositions(count: number, edges: ForceEdge[], baseRadius: number, iterations?: number): Position3D[];
-/**
- * Distributes N points on a sphere surface using Fibonacci lattice.
- * Produces near-uniform spacing regardless of count.
- */
-export declare function fibonacciSpherePositions(count: number, radius: number): Position3D[];
-/**
- * Evenly spaces N points on a tilted ring (elliptical orbit).
- * `tilt` is the ring's inclination in radians relative to the XZ plane.
- */
-export declare function orbitRingPositions(count: number, radius: number, tilt: number): Position3D[];
-/**
- * Creates a QuadraticBezierCurve3 between two 3D points with a control
- * point offset perpendicular to the from-to line. The offset direction
- * is computed in 3D using a cross product with the up vector.
- */
-export declare function arcCurve3D(from: [number, number, number], to: [number, number, number], offset: number): QuadraticBezierCurve3;
-/**
- * Creates a loop curve above a point for self-transitions.
- */
-export declare function selfLoopCurve3D(position: [number, number, number], loopRadius: number): QuadraticBezierCurve3;
-/**
- * Recursively positions an expression tree in 3D space.
- * Root at origin, children spread horizontally, depth goes downward (negative Y).
- */
-export declare function treeLayout3D(node: ExprTreeNode3D, origin: Position3D, horizontalSpacing: number, verticalSpacing?: number): TreeLayoutResult[];
-export declare const CAMERA_POSITIONS: {
-    readonly application: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-    readonly orbital: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-    readonly trait: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-    readonly transition: {
-        readonly position: [number, number, number];
-        readonly target: [number, number, number];
-    };
-};
-export {};