@almadar/ui 2.15.13 → 2.16.0

package/dist/avl/index.d.cts

@@ -0,0 +1,312 @@
+import React from 'react';
+
+/**
+ * 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.
+ */
+interface AvlBaseProps {
+    x?: number;
+    y?: number;
+    color?: string;
+    opacity?: number;
+    className?: string;
+}
+type AvlEffectType = 'render-ui' | 'set' | 'persist' | 'fetch' | 'emit' | 'navigate' | 'notify' | 'call-service' | 'spawn' | 'despawn' | 'do' | 'if' | 'log';
+type AvlFieldTypeKind = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'object' | 'array';
+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>;
+
+interface AvlOrbitalProps {
+    cx?: number;
+    cy?: number;
+    r?: number;
+    label?: string;
+    color?: string;
+    opacity?: number;
+    className?: string;
+}
+declare const AvlOrbital: React.FC<AvlOrbitalProps>;
+
+interface AvlEntityProps extends AvlBaseProps {
+    r?: number;
+    fieldCount?: number;
+    persistence?: AvlPersistenceKind;
+    label?: string;
+}
+declare const AvlEntity: React.FC<AvlEntityProps>;
+
+interface AvlTraitProps {
+    cx?: number;
+    cy?: number;
+    rx?: number;
+    ry?: number;
+    rotation?: number;
+    label?: string;
+    color?: string;
+    opacity?: number;
+    className?: string;
+}
+declare const AvlTrait: React.FC<AvlTraitProps>;
+
+interface AvlPageProps extends AvlBaseProps {
+    size?: number;
+    label?: string;
+}
+declare const AvlPage: React.FC<AvlPageProps>;
+
+interface AvlApplicationProps extends AvlBaseProps {
+    width?: number;
+    height?: number;
+    label?: string;
+}
+declare const AvlApplication: React.FC<AvlApplicationProps>;
+
+interface AvlStateProps extends AvlBaseProps {
+    name?: string;
+    isInitial?: boolean;
+    isTerminal?: boolean;
+    width?: number;
+    height?: number;
+}
+declare const AvlState: React.FC<AvlStateProps>;
+
+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;
+}
+declare const AvlTransition: React.FC<AvlTransitionProps>;
+
+interface AvlEventProps extends AvlBaseProps {
+    size?: number;
+    label?: string;
+}
+declare const AvlEvent: React.FC<AvlEventProps>;
+
+interface AvlGuardProps extends AvlBaseProps {
+    size?: number;
+    label?: string;
+}
+declare const AvlGuard: React.FC<AvlGuardProps>;
+
+interface AvlEffectProps extends AvlBaseProps {
+    effectType: AvlEffectType;
+    size?: number;
+    label?: string;
+}
+declare const AvlEffect: React.FC<AvlEffectProps>;
+
+interface AvlFieldProps extends AvlBaseProps {
+    /** Angle in radians from entity center. */
+    angle?: number;
+    length?: number;
+    required?: boolean;
+    label?: string;
+}
+declare const AvlField: React.FC<AvlFieldProps>;
+
+interface AvlFieldTypeProps extends AvlBaseProps {
+    kind: AvlFieldTypeKind;
+    size?: number;
+    label?: string;
+}
+declare const AvlFieldType: React.FC<AvlFieldTypeProps>;
+
+interface AvlBindingProps {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    label?: string;
+    color?: string;
+    opacity?: number;
+    className?: string;
+}
+declare const AvlBinding: React.FC<AvlBindingProps>;
+
+interface AvlPersistenceProps extends AvlBaseProps {
+    kind: AvlPersistenceKind;
+    size?: number;
+    label?: string;
+}
+declare const AvlPersistence: React.FC<AvlPersistenceProps>;
+
+interface AvlOperatorProps extends AvlBaseProps {
+    name: string;
+    namespace?: AvlOperatorNamespace;
+    size?: number;
+}
+declare const AvlOperator: React.FC<AvlOperatorProps>;
+
+interface AvlSExprProps extends AvlBaseProps {
+    width?: number;
+    height?: number;
+    label?: string;
+}
+declare const AvlSExpr: React.FC<AvlSExprProps>;
+
+interface AvlLiteralProps extends AvlBaseProps {
+    value: string;
+    size?: number;
+}
+declare const AvlLiteral: React.FC<AvlLiteralProps>;
+
+interface AvlBindingRefProps extends AvlBaseProps {
+    path: string;
+    size?: number;
+}
+declare const AvlBindingRef: React.FC<AvlBindingRefProps>;
+
+interface AvlStateMachineState {
+    name: string;
+    isInitial?: boolean;
+    isTerminal?: boolean;
+}
+interface AvlStateMachineTransition {
+    from: string;
+    to: string;
+    event?: string;
+    guard?: string;
+    effects?: AvlEffectType[];
+}
+interface AvlStateMachineProps {
+    states: AvlStateMachineState[];
+    transitions: AvlStateMachineTransition[];
+    className?: string;
+    color?: string;
+    animated?: boolean;
+}
+declare const AvlStateMachine: React.FC<AvlStateMachineProps>;
+
+interface AvlOrbitalUnitTrait {
+    name: string;
+    color?: string;
+}
+interface AvlOrbitalUnitPage {
+    name: string;
+}
+interface AvlOrbitalUnitProps {
+    entityName: string;
+    fields?: number;
+    persistence?: AvlPersistenceKind;
+    traits: AvlOrbitalUnitTrait[];
+    pages: AvlOrbitalUnitPage[];
+    className?: string;
+    color?: string;
+    animated?: boolean;
+}
+declare const AvlOrbitalUnit: React.FC<AvlOrbitalUnitProps>;
+
+interface AvlClosedCircuitState {
+    name: string;
+}
+interface AvlClosedCircuitTransition {
+    from: string;
+    to: string;
+    event?: string;
+    guard?: string;
+    effects?: AvlEffectType[];
+}
+interface AvlClosedCircuitProps {
+    states: AvlClosedCircuitState[];
+    transitions: AvlClosedCircuitTransition[];
+    className?: string;
+    color?: string;
+    animated?: boolean;
+}
+declare const AvlClosedCircuit: React.FC<AvlClosedCircuitProps>;
+
+interface AvlEmitListenProps {
+    emitter: {
+        name: string;
+        fields?: number;
+    };
+    listener: {
+        name: string;
+        fields?: number;
+    };
+    eventName?: string;
+    className?: string;
+    color?: string;
+    animated?: boolean;
+}
+declare const AvlEmitListen: React.FC<AvlEmitListenProps>;
+
+interface AvlSlotMapSlot {
+    name: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface AvlSlotMapProps {
+    slots: AvlSlotMapSlot[];
+    pageWidth?: number;
+    pageHeight?: number;
+    className?: string;
+    color?: string;
+    animated?: boolean;
+}
+declare const AvlSlotMap: React.FC<AvlSlotMapProps>;
+
+interface AvlExprTreeNode {
+    label: string;
+    type: 'operator' | 'literal' | 'binding';
+    children?: AvlExprTreeNode[];
+}
+interface AvlExprTreeProps {
+    expression: AvlExprTreeNode;
+    className?: string;
+    color?: string;
+    animated?: boolean;
+}
+declare const AvlExprTree: React.FC<AvlExprTreeProps>;
+
+/**
+ * AVL layout utilities for positioning atoms in composed diagrams.
+ */
+/** Distribute N points evenly around a ring. */
+declare function ringPositions(cx: number, cy: number, r: number, count: number, startAngle?: number): Array<{
+    x: number;
+    y: number;
+    angle: number;
+}>;
+/** Create an SVG arc path between two angles on a circle. */
+declare function arcPath(cx: number, cy: number, r: number, startAngle: number, endAngle: number): string;
+/** Distribute N points radially from a center. */
+declare function radialPositions(cx: number, cy: number, innerR: number, outerR: number, count: number, startAngle?: number): Array<{
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    angle: number;
+}>;
+/** Simple grid layout: position items in columns and rows. */
+declare function gridPositions(startX: number, startY: number, cols: number, cellWidth: number, cellHeight: number, count: number): Array<{
+    x: number;
+    y: number;
+    col: number;
+    row: number;
+}>;
+/** Compute a quadratic bezier control point offset perpendicular to the line. */
+declare function curveControlPoint(x1: number, y1: number, x2: number, y2: number, offset: number): {
+    cpx: number;
+    cpy: number;
+};
+
+export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, AvlApplication, type AvlApplicationProps, type AvlBaseProps, AvlBinding, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, 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, 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, AvlTransition, type AvlTransitionProps, arcPath, curveControlPoint, gridPositions, radialPositions, ringPositions };

package/dist/avl/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @almadar/ui/avl
+ *
+ * Almadar Visual Language (AVL) - Formal visual notation for .orb constructs.
+ * Atoms render <g> elements for composition. Molecules render full <svg>.
+ */
+export { AvlOrbital, type AvlOrbitalProps } from '../components/atoms/avl';
+export { AvlEntity, type AvlEntityProps } from '../components/atoms/avl';
+export { AvlTrait, type AvlTraitProps } from '../components/atoms/avl';
+export { AvlPage, type AvlPageProps } from '../components/atoms/avl';
+export { AvlApplication, type AvlApplicationProps } from '../components/atoms/avl';
+export { AvlState, type AvlStateProps } from '../components/atoms/avl';
+export { AvlTransition, type AvlTransitionProps } from '../components/atoms/avl';
+export { AvlEvent, type AvlEventProps } from '../components/atoms/avl';
+export { AvlGuard, type AvlGuardProps } from '../components/atoms/avl';
+export { AvlEffect, type AvlEffectProps } from '../components/atoms/avl';
+export { AvlField, type AvlFieldProps } from '../components/atoms/avl';
+export { AvlFieldType, type AvlFieldTypeProps } from '../components/atoms/avl';
+export { AvlBinding, type AvlBindingProps } from '../components/atoms/avl';
+export { AvlPersistence, type AvlPersistenceProps } from '../components/atoms/avl';
+export { AvlOperator, type AvlOperatorProps } from '../components/atoms/avl';
+export { AvlSExpr, type AvlSExprProps } from '../components/atoms/avl';
+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 { 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';
+export { AvlEmitListen, type AvlEmitListenProps } from '../components/molecules/avl';
+export { AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot } from '../components/molecules/avl';
+export { AvlExprTree, type AvlExprTreeProps, type AvlExprTreeNode } from '../components/molecules/avl';
+export { ringPositions, arcPath, radialPositions, gridPositions, curveControlPoint } from '../components/molecules/avl';