@almadar/ui 5.77.0 → 5.78.0

package/dist/components/learning/atoms/LearningCanvas.d.ts

@@ -0,0 +1,80 @@
+/**
+ * LearningCanvas
+ *
+ * A pure, declarative HTML5 canvas atom for math and science visualizations.
+ * Accepts a list of primitive shapes (line, arrow, circle, rect, polygon, path,
+ * text, axis, grid) and renders them. Optional interactivity emits click/hover
+ * events, and optional animation drives a continuous render loop.
+ *
+ * This is the foundational atom for the `learning/` behavior family.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { UiError } from '../../core/atoms/types';
+export type LearningShapeType = 'line' | 'arrow' | 'circle' | 'rect' | 'polygon' | 'path' | 'text' | 'axis' | 'grid';
+export interface LearningPoint {
+    x: number;
+    y: number;
+}
+export interface LearningShape {
+    type: LearningShapeType;
+    /** Optional stable id for interaction payloads. */
+    id?: string;
+    x?: number;
+    y?: number;
+    x1?: number;
+    y1?: number;
+    x2?: number;
+    y2?: number;
+    radius?: number;
+    width?: number;
+    height?: number;
+    points?: LearningPoint[];
+    path?: string;
+    text?: string;
+    label?: string;
+    fontSize?: number;
+    align?: 'left' | 'center' | 'right';
+    axis?: 'x' | 'y';
+    min?: number;
+    max?: number;
+    step?: number;
+    color?: string;
+    fill?: string;
+    lineWidth?: number;
+    opacity?: number;
+}
+export interface LearningCanvasProps {
+    /** Additional CSS classes. */
+    className?: string;
+    /** Canvas width in CSS pixels. */
+    width?: number;
+    /** Canvas height in CSS pixels. */
+    height?: number;
+    /** Background color (default transparent). */
+    backgroundColor?: string;
+    /** Declarative shapes to draw. */
+    shapes?: LearningShape[];
+    /** Enable pointer interaction (click/hover). */
+    interactive?: boolean;
+    /** Enable continuous redraw loop. */
+    animate?: boolean;
+    /** Clicked shape payload: { id?, type?, index }. */
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    /** Hovered shape payload: { id?, type?, index }. */
+    onShapeHover?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    /** Loading state. */
+    isLoading?: boolean;
+    /** Error state. */
+    error?: UiError | null;
+}
+export declare const LearningCanvas: React.FC<LearningCanvasProps>;

package/dist/components/learning/molecules/BiologyCanvas.d.ts

@@ -0,0 +1,47 @@
+/**
+ * BiologyCanvas
+ *
+ * A field-scoped learning molecule for biology. Renders cells, organelles,
+ * membranes, and connections on top of the declarative `LearningCanvas` atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface BiologyNode {
+    id?: string;
+    x: number;
+    y: number;
+    radius?: number;
+    color?: string;
+    label?: string;
+    kind?: 'cell' | 'organelle' | 'molecule' | 'organism';
+}
+export interface BiologyEdge {
+    from: string;
+    to: string;
+    color?: string;
+    label?: string;
+}
+export interface BiologyCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    backgroundColor?: string;
+    nodes?: BiologyNode[];
+    edges?: BiologyEdge[];
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const BiologyCanvas: React.FC<BiologyCanvasProps>;

package/dist/components/learning/molecules/ChemistryCanvas.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ChemistryCanvas
+ *
+ * A field-scoped learning molecule for chemistry. Renders atoms, bonds, and
+ * reaction arrows on top of the declarative `LearningCanvas` atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface ChemistryAtom {
+    id?: string;
+    x: number;
+    y: number;
+    element?: string;
+    radius?: number;
+    color?: string;
+}
+export interface ChemistryBond {
+    from: string;
+    to: string;
+    type?: 'single' | 'double' | 'triple';
+    color?: string;
+}
+export interface ChemistryArrow {
+    x: number;
+    y: number;
+    angle?: number;
+    length?: number;
+    color?: string;
+    label?: string;
+}
+export interface ChemistryCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    backgroundColor?: string;
+    atoms?: ChemistryAtom[];
+    bonds?: ChemistryBond[];
+    arrows?: ChemistryArrow[];
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const ChemistryCanvas: React.FC<ChemistryCanvasProps>;

package/dist/components/learning/molecules/MathCanvas.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MathCanvas
+ *
+ * A field-scoped learning molecule for mathematics. Renders a coordinate plane
+ * with axes, grid, curves (sampled points), scatter points, and vectors on top
+ * of the declarative `LearningCanvas` atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape, LearningPoint } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface MathCurve {
+    label?: string;
+    color?: string;
+    /** Sampled {x,y} points in math coordinates. */
+    samples: LearningPoint[];
+}
+export interface MathPoint {
+    x: number;
+    y: number;
+    label?: string;
+    color?: string;
+    radius?: number;
+}
+export interface MathVector {
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    color?: string;
+    label?: string;
+}
+export interface MathCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    xMin?: number;
+    xMax?: number;
+    yMin?: number;
+    yMax?: number;
+    showAxes?: boolean;
+    showGrid?: boolean;
+    gridStep?: number;
+    curves?: MathCurve[];
+    points?: MathPoint[];
+    vectors?: MathVector[];
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const MathCanvas: React.FC<MathCanvasProps>;

package/dist/components/learning/molecules/PhysicsCanvas.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PhysicsCanvas
+ *
+ * A field-scoped learning molecule for physics. Renders bodies, constraints,
+ * velocity arrows, and force arrows on top of the declarative `LearningCanvas`
+ * atom.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { LearningShape } from '../atoms/LearningCanvas';
+import type { UiError } from '../../core/atoms/types';
+export interface LearningPhysicsBody {
+    id?: string;
+    x: number;
+    y: number;
+    radius?: number;
+    color?: string;
+    label?: string;
+    vx?: number;
+    vy?: number;
+    fx?: number;
+    fy?: number;
+}
+export interface LearningPhysicsConstraint {
+    from: string;
+    to: string;
+    color?: string;
+}
+export interface PhysicsCanvasProps {
+    className?: string;
+    width?: number;
+    height?: number;
+    title?: string;
+    backgroundColor?: string;
+    bodies?: LearningPhysicsBody[];
+    constraints?: LearningPhysicsConstraint[];
+    showVelocity?: boolean;
+    showForces?: boolean;
+    velocityScale?: number;
+    forceScale?: number;
+    /** Extra declarative shapes in canvas pixel coordinates. */
+    shapes?: LearningShape[];
+    interactive?: boolean;
+    animate?: boolean;
+    onShapeClick?: (payload: {
+        id?: string;
+        type?: string;
+        index: number;
+    }) => void;
+    isLoading?: boolean;
+    error?: UiError | null;
+}
+export declare const PhysicsCanvas: React.FC<PhysicsCanvasProps>;

package/dist/components/marketing/atoms/MarketingStatCard.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 export type StatCardSize = "sm" | "md" | "lg";
-export interface StatCardProps {
+export interface MarketingStatCardProps {
     /** The stat value to display prominently */
     value: string;
     /** Label describing the value */
@@ -10,4 +10,4 @@ export interface StatCardProps {
     /** Additional class names */
     className?: string;
 }
-export declare const MarketingStatCard: React.FC<StatCardProps>;
+export declare const MarketingStatCard: React.FC<MarketingStatCardProps>;