@almadar/ui 5.79.0 → 5.79.1

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

@@ -1,80 +0,0 @@
-/**
- * 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

@@ -1,47 +0,0 @@
-/**
- * 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

@@ -1,55 +0,0 @@
-/**
- * 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

@@ -1,61 +0,0 @@
-/**
- * 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

@@ -1,54 +0,0 @@
-/**
- * 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/AnimatedCounter.d.ts

@@ -1,20 +0,0 @@
-/**
- * AnimatedCounter Atom Component
- *
- * Animates a number from its previous value to the current value
- * using requestAnimationFrame and ease-out easing.
- */
-import React from "react";
-export interface AnimatedCounterProps {
-    /** The target value to animate to. Strings are parsed numerically (e.g. "500", "99.9"). */
-    value: number | string;
-    /** Animation duration in milliseconds */
-    duration?: number;
-    /** Text to display before the number */
-    prefix?: string;
-    /** Text to display after the number */
-    suffix?: string;
-    /** Additional class names */
-    className?: string;
-}
-export declare const AnimatedCounter: React.FC<AnimatedCounterProps>;

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

@@ -1,32 +0,0 @@
-import React from 'react';
-import type { AssetUrl } from '@almadar/core';
-export type GraphicAnimation = 'draw' | 'fill' | 'pulse' | 'morph';
-export interface AnimatedGraphicProps extends React.HTMLAttributes<HTMLDivElement> {
-    /** Additional CSS classes applied to the root element. */
-    className?: string;
-    /** URL to an SVG file. Fetched and inlined to enable stroke/fill animations. */
-    src?: AssetUrl;
-    /** Inline SVG string. Takes precedence over src if both provided. */
-    svgContent?: string;
-    /** Animation type applied to SVG paths/shapes */
-    animation?: GraphicAnimation;
-    /** Whether to run the animation (default: false). Controlled externally or via AnimatedReveal. */
-    animate?: boolean;
-    /** Animation duration in ms (default: 1200) */
-    duration?: number;
-    /** Delay before animation starts in ms (default: 0) */
-    delay?: number;
-    /** Easing function (default: cubic-bezier(0.16, 1, 0.3, 1)) */
-    easing?: string;
-    /** Width of the graphic container */
-    width?: string | number;
-    /** Height of the graphic container */
-    height?: string | number;
-    /** Stroke color override for SVG paths */
-    strokeColor?: string;
-    /** Fill color for the 'fill' animation end state */
-    fillColor?: string;
-    /** Alt text for accessibility */
-    alt?: string;
-}
-export declare const AnimatedGraphic: React.ForwardRefExoticComponent<AnimatedGraphicProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,26 +0,0 @@
-import React from 'react';
-export type RevealTrigger = 'scroll' | 'hover' | 'manual';
-export type RevealAnimation = 'fade-up' | 'fade-down' | 'fade-in' | 'fade-left' | 'fade-right' | 'scale' | 'scale-up' | 'none';
-export interface AnimatedRevealProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
-    /** Additional CSS classes applied to the root element. */
-    className?: string;
-    /** What triggers the animation */
-    trigger?: RevealTrigger;
-    /** Built-in animation preset */
-    animation?: RevealAnimation;
-    /** Animation duration in ms (default: 600) */
-    duration?: number;
-    /** Delay before animation starts in ms (default: 0) */
-    delay?: number;
-    /** How much of the element must be visible before triggering, 0-1 (default: 0.15) */
-    threshold?: number;
-    /** Animate only the first time the element enters the viewport (default: true) */
-    once?: boolean;
-    /** Manual control: when trigger='manual', set this to true to animate */
-    animate?: boolean;
-    /** Easing function (default: cubic-bezier(0.16, 1, 0.3, 1)) */
-    easing?: string;
-    /** Children: ReactNode or render function receiving animated state */
-    children: React.ReactNode | ((animated: boolean) => React.ReactNode);
-}
-export declare const AnimatedReveal: React.ForwardRefExoticComponent<AnimatedRevealProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,16 +0,0 @@
-import React from "react";
-export type ContentSectionBackground = "default" | "alt" | "dark" | "gradient";
-export type ContentSectionPadding = "sm" | "md" | "lg";
-export interface ContentSectionProps {
-    /** Section content */
-    children: React.ReactNode;
-    /** Background style */
-    background?: ContentSectionBackground;
-    /** Vertical padding size */
-    padding?: ContentSectionPadding;
-    /** HTML id for anchor linking */
-    id?: string;
-    /** Additional class names */
-    className?: string;
-}
-export declare const ContentSection: React.ForwardRefExoticComponent<ContentSectionProps & React.RefAttributes<HTMLDivElement>>;

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

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

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

@@ -1,41 +0,0 @@
-/**
- * PatternTile Atom
- *
- * Mathematically correct Islamic geometric pattern tiles using the
- * Polygons-in-Contact (PIC) method (Hankin 1925, formalized by Kaplan 2005).
- *
- * Construction: A regular polygon tiling is overlaid with star motifs.
- * Each motif touches the enclosing polygon at EDGE MIDPOINTS only.
- * Two rays emanate from each midpoint into the polygon at a specific
- * CONTACT ANGLE (theta). Where rays from adjacent midpoints intersect,
- * they form the star points. Gap tiles (squares, triangles) between
- * polygons receive inferred geometry by extending boundary rays inward.
- *
- * Variants:
- *   star8  — 8-fold star-and-cross on 4.8.8 tiling (theta = 67.5 deg)
- *   star6  — 6-fold star on hexagonal tiling (theta = 60 deg)
- *   khatam — 8-fold rosette with interlocking kites (theta = 72 deg)
- *   star10 — 10-fold girih on decagonal tiling (theta = 72 deg)
- *   star12 — 12-fold on dodecagonal tiling (theta = 75 deg)
- *
- * All tiles use stroke only (no fill), rendering as transparent overlays.
- */
-import React from 'react';
-export type PatternVariant = 'star8' | 'star6' | 'khatam' | 'star10' | 'star12' | 'rosette-double' | 'rosette-filled' | 'seigaiha' | 'greek-key' | 'celtic-knot' | 'kolam' | 'arch' | 'arabesque-vine' | 'arabesque-net';
-export interface PatternTileProps {
-    /** Which geometric pattern to render */
-    variant?: PatternVariant;
-    /** Tile unit size in SVG units */
-    size?: number;
-    /** Stroke color (CSS variable or hex) */
-    color?: string;
-    /** Line thickness */
-    strokeWidth?: number;
-    className?: string;
-}
-export declare const PatternTile: React.FC<PatternTileProps>;
-/** Returns the tile dimensions for a given variant and size */
-export declare function getTileDimensions(variant: PatternVariant, size: number): {
-    width: number;
-    height: number;
-};

package/dist/components/marketing/molecules/ArticleSection.d.ts

@@ -1,18 +0,0 @@
-/**
- * ArticleSection Molecule Component
- *
- * A centered content section with a title and constrained max-width,
- * suitable for article or documentation layouts.
- */
-import React from 'react';
-export interface ArticleSectionProps {
-    /** Section title */
-    title: string;
-    /** Section content */
-    children: React.ReactNode;
-    /** Maximum width constraint */
-    maxWidth?: 'sm' | 'md' | 'lg';
-    /** Additional class names */
-    className?: string;
-}
-export declare const ArticleSection: React.FC<ArticleSectionProps>;

package/dist/components/marketing/molecules/CTABanner.d.ts

@@ -1,26 +0,0 @@
-/**
- * CTABanner Molecule Component
- *
- * A call-to-action banner with title, subtitle, and action buttons.
- * Uses the site's theme naturally - no forced color inversions.
- */
-import React from 'react';
-import type { LinkAction } from '../../core/atoms/types';
-export type CTABannerBackground = 'default' | 'alt' | 'dark' | 'gradient' | 'primary';
-export interface CTABannerProps {
-    /** Banner headline */
-    title: string;
-    /** Supporting text below the title */
-    subtitle?: string;
-    /** Primary action button config */
-    primaryAction?: LinkAction;
-    /** Secondary action button config */
-    secondaryAction?: LinkAction;
-    /** Background style */
-    background?: CTABannerBackground;
-    /** Content alignment */
-    align?: 'center' | 'left';
-    /** Additional class names */
-    className?: string;
-}
-export declare const CTABanner: React.FC<CTABannerProps>;

package/dist/components/marketing/molecules/CaseStudyCard.d.ts

@@ -1,24 +0,0 @@
-/**
- * CaseStudyCard Molecule Component
- *
- * A card for displaying case studies with category badge, title,
- * description, and a call-to-action link button.
- */
-import React from 'react';
-export interface CaseStudyCardProps {
-    /** Case study title */
-    title: string;
-    /** Short description of the case study */
-    description: string;
-    /** Category label shown as a badge */
-    category: string;
-    /** Custom background color for the category badge (CSS value) */
-    categoryColor?: string;
-    /** URL the card links to */
-    href: string;
-    /** Label for the link button */
-    linkLabel?: string;
-    /** Additional class names */
-    className?: string;
-}
-export declare const CaseStudyCard: React.FC<CaseStudyCardProps>;

package/dist/components/marketing/molecules/CommunityLinks.d.ts

@@ -1,28 +0,0 @@
-/**
- * CommunityLinks Molecule Component
- *
- * Displays community platform links (GitHub, Discord, Twitter) as styled buttons.
- * Composes VStack, HStack, Typography, Button, and Icon atoms.
- */
-import React from 'react';
-export interface GithubLink {
-    url: string;
-    stars?: number;
-}
-export interface DiscordLink {
-    url: string;
-    members?: number;
-}
-export interface TwitterLink {
-    url: string;
-    followers?: number;
-}
-export interface CommunityLinksProps {
-    github?: GithubLink;
-    discord?: DiscordLink;
-    twitter?: TwitterLink;
-    heading?: string;
-    subtitle?: string;
-    className?: string;
-}
-export declare const CommunityLinks: React.FC<CommunityLinksProps>;

package/dist/components/marketing/molecules/FeatureCard.d.ts

@@ -1,26 +0,0 @@
-/**
- * FeatureCard Molecule Component
- *
- * A card highlighting a feature with icon, title, description, and optional link.
- * Composes Card, VStack, Icon, Typography, and Button atoms.
- */
-import React from 'react';
-import { type IconInput } from '../../core/atoms/Icon';
-export interface FeatureCardProps {
-    icon?: IconInput;
-    /** Feature title */
-    title: string;
-    /** Feature description */
-    description: string;
-    /** Optional link URL */
-    href?: string;
-    /** Label for the link button */
-    linkLabel?: string;
-    /** Card visual variant */
-    variant?: 'default' | 'bordered' | 'elevated' | 'interactive';
-    /** Card size affecting icon and spacing */
-    size?: 'sm' | 'md' | 'lg';
-    /** Additional class names */
-    className?: string;
-}
-export declare const FeatureCard: React.FC<FeatureCardProps>;

package/dist/components/marketing/molecules/GeometricPattern.d.ts

@@ -1,33 +0,0 @@
-/**
- * GeometricPattern Molecule
- *
- * Composes PatternTile into reusable layout modes for Islamic geometric
- * background decoration. Supports four modes:
- *
- *   background — full tiling fill behind content
- *   left/right — pattern fades from one side toward the other
- *   frame      — thin decorative strips above and below content
- *
- * Uses SVG <pattern> for efficient tiling and <mask> for fade effects.
- * All rendering is pure SVG (SSR-safe, no browser APIs).
- */
-import React from 'react';
-import type { PatternVariant } from '../atoms/PatternTile';
-export interface GeometricPatternProps {
-    /** Which geometric tile design */
-    variant?: PatternVariant;
-    /** Layout mode */
-    mode?: 'background' | 'left' | 'right' | 'dual' | 'around' | 'frame';
-    /** Overall opacity (default: 0.06) */
-    opacity?: number;
-    /** Stroke color passed to PatternTile */
-    color?: string;
-    /** Tile scale multiplier (default: 1) */
-    scale?: number;
-    /** Stroke width passed to PatternTile */
-    strokeWidth?: number;
-    /** Content to wrap (used in frame mode) */
-    children?: React.ReactNode;
-    className?: string;
-}
-export declare const GeometricPattern: React.FC<GeometricPatternProps>;

package/dist/components/marketing/molecules/HeroSection.d.ts

@@ -1,28 +0,0 @@
-/**
- * HeroSection Molecule Component
- *
- * A full-width hero section for landing pages and marketing content.
- * Composes atoms: Box, VStack, HStack, Badge, Typography, Button.
- * Optionally includes an InstallBox molecule for CLI commands.
- */
-import React from 'react';
-import type { LinkAction, ImageSource } from '../../core/atoms/types';
-export interface HeroSectionProps {
-    tag?: string;
-    tagVariant?: 'primary' | 'secondary' | 'accent';
-    title: string;
-    titleAccent?: string;
-    subtitle: string;
-    primaryAction?: LinkAction;
-    secondaryAction?: LinkAction;
-    installCommand?: string;
-    image?: ImageSource;
-    imagePosition?: 'below' | 'right' | 'background';
-    background?: 'dark' | 'gradient' | 'subtle';
-    align?: 'center' | 'left';
-    /** Background element (SVG animation, etc.) rendered behind hero content */
-    backgroundElement?: React.ReactNode;
-    children?: React.ReactNode;
-    className?: string;
-}
-export declare const HeroSection: React.FC<HeroSectionProps>;

package/dist/components/marketing/molecules/InstallBox.d.ts

@@ -1,16 +0,0 @@
-/**
- * InstallBox Molecule Component
- *
- * A copyable command display box for install/CLI commands.
- * Shows a monospace command with a copy-to-clipboard button.
- */
-import React from 'react';
-export interface InstallBoxProps {
-    /** The command to display and copy */
-    command: string;
-    /** Optional label above the command */
-    label?: string;
-    /** Additional class names */
-    className?: string;
-}
-export declare const InstallBox: React.FC<InstallBoxProps>;