@almadar/ui 2.22.2 → 2.24.0

package/dist/avl/index.d.cts

@@ -20,6 +20,40 @@ type AvlPersistenceKind = 'persistent' | 'runtime' | 'singleton' | 'instance';
 type AvlOperatorNamespace = 'arithmetic' | 'comparison' | 'logic' | 'string' | 'collection' | 'time' | 'control' | 'async';
 declare const AVL_OPERATOR_COLORS: Record<AvlOperatorNamespace, string>;
 declare const AVL_FIELD_TYPE_SHAPES: Record<AvlFieldTypeKind, string>;
+type StateRole = 'initial' | 'terminal' | 'hub' | 'error' | 'default';
+declare const STATE_COLORS: Record<StateRole, {
+    fill: string;
+    border: string;
+}>;
+type EffectCategory = 'ui' | 'data' | 'communication' | 'lifecycle' | 'control';
+declare const EFFECT_CATEGORY_COLORS: Record<EffectCategory, {
+    color: string;
+    bg: string;
+}>;
+declare const EFFECT_TYPE_TO_CATEGORY: Record<AvlEffectType, EffectCategory>;
+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";
+    };
+};
+declare function getStateRole(name: string, isInitial?: boolean, isTerminal?: boolean, transitionCount?: number, maxTransitionCount?: number): StateRole;
 
 interface AvlOrbitalProps {
     cx?: number;
@@ -72,6 +106,10 @@ interface AvlStateProps extends AvlBaseProps {
     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;
 }
 declare const AvlState: React.FC<AvlStateProps>;
 
@@ -109,6 +147,8 @@ interface AvlEffectProps extends AvlBaseProps {
     effectType: AvlEffectType;
     size?: number;
     label?: string;
+    /** V2: Render a category-colored background circle behind the icon. */
+    showBackground?: boolean;
 }
 declare const AvlEffect: React.FC<AvlEffectProps>;
 
@@ -525,10 +565,10 @@ interface AvlOrbitalSceneProps {
 declare const AvlOrbitalScene: React.FC<AvlOrbitalSceneProps>;
 
 /**
- * AvlTraitScene - Zoom Level 3
+ * AvlTraitScene V2 - Zoom Level 3
  *
- * Shows a trait's state machine using ELK (elkjs) for automatic
- * node and edge label placement. No label overlap.
+ * Left-to-right horizontal flow with color-coded states,
+ * transition lanes, and swim lanes for emit/listen events.
  */
 
 interface AvlTraitSceneProps {
@@ -542,13 +582,10 @@ interface AvlTraitSceneProps {
 declare const AvlTraitScene: React.FC<AvlTraitSceneProps>;
 
 /**
- * AvlTransitionScene - Zoom Level 4
- *
- * Shows a single transition in detail as a vertical flow:
- * FromState -> Event card -> Guard -> Effects -> ToState
+ * AvlTransitionScene V2 - Zoom Level 4
  *
- * Labels are placed in cards between arrow segments,
- * never overlapping the lines.
+ * Card layout replacing vertical waterfall.
+ * Reads like a spec card: from → to, trigger, guard, effects.
  */
 
 interface AvlTransitionSceneProps {
@@ -589,4 +626,4 @@ interface AvlClickTargetProps {
 }
 declare const AvlClickTarget: React.FC<AvlClickTargetProps>;
 
-export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlApplicationScene, type AvlApplicationSceneProps, type AvlBaseProps, AvlBinding, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, type AvlOrbitalProps, AvlOrbitalScene, type AvlOrbitalSceneProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlPage, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type CrossLink, type OrbitalLevelData, type TraitLevelData, type TransitionLevelData, type ZoomLevel, arcPath, curveControlPoint, gridPositions, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, ringPositions };
+export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlApplicationScene, type AvlApplicationSceneProps, type AvlBaseProps, AvlBinding, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, type AvlOrbitalProps, AvlOrbitalScene, type AvlOrbitalSceneProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlPage, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, CONNECTION_COLORS, type CrossLink, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type OrbitalLevelData, STATE_COLORS, type StateRole, type TraitLevelData, type TransitionLevelData, type ZoomLevel, arcPath, curveControlPoint, getStateRole, gridPositions, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, ringPositions };

package/dist/avl/index.d.ts

@@ -24,6 +24,8 @@ export { AvlLiteral, type AvlLiteralProps } from '../components/atoms/avl';
 export { AvlBindingRef, type AvlBindingRefProps } from '../components/atoms/avl';
 export type { AvlBaseProps, AvlEffectType, AvlFieldTypeKind, AvlPersistenceKind, AvlOperatorNamespace, } from '../components/atoms/avl';
 export { AVL_OPERATOR_COLORS, AVL_FIELD_TYPE_SHAPES } from '../components/atoms/avl';
+export type { StateRole, EffectCategory } from '../components/atoms/avl';
+export { STATE_COLORS, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, CONNECTION_COLORS, getStateRole } from '../components/atoms/avl';
 export { AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition } from '../components/molecules/avl';
 export { AvlOrbitalUnit, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, type AvlOrbitalUnitPage } from '../components/molecules/avl';
 export { AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition } from '../components/molecules/avl';