@almadar/ui 5.111.0 → 5.113.0

package/dist/components/core/atoms/svg/SvgMesh.d.ts

@@ -1,16 +0,0 @@
-import React from 'react';
-export interface SvgMeshProps {
-    cx?: number;
-    cy?: number;
-    nodes?: number;
-    radius?: number;
-    color?: string;
-    connectionDensity?: number;
-    opacity?: number;
-    className?: string;
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    width?: number;
-    height?: number;
-}
-export declare const SvgMesh: React.FC<SvgMeshProps>;

package/dist/components/core/atoms/svg/SvgMorph.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-export interface SvgMorphProps {
-    x?: number;
-    y?: number;
-    size?: number;
-    variant?: 'text-to-code' | 'code-to-app' | 'generic';
-    color?: string;
-    opacity?: number;
-    className?: string;
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    width?: number;
-    height?: number;
-}
-export declare const SvgMorph: React.FC<SvgMorphProps>;

package/dist/components/core/atoms/svg/SvgNode.d.ts

@@ -1,16 +0,0 @@
-import React from 'react';
-export interface SvgNodeProps {
-    x?: number;
-    y?: number;
-    r?: number;
-    variant?: 'filled' | 'stroked' | 'pulse';
-    color?: string;
-    opacity?: number;
-    className?: string;
-    label?: string;
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    width?: number;
-    height?: number;
-}
-export declare const SvgNode: React.FC<SvgNodeProps>;

package/dist/components/core/atoms/svg/SvgPulse.d.ts

@@ -1,16 +0,0 @@
-import React from 'react';
-export interface SvgPulseProps {
-    cx?: number;
-    cy?: number;
-    rings?: number;
-    maxRadius?: number;
-    color?: string;
-    animated?: boolean;
-    opacity?: number;
-    className?: string;
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    width?: number;
-    height?: number;
-}
-export declare const SvgPulse: React.FC<SvgPulseProps>;

package/dist/components/core/atoms/svg/SvgRing.d.ts

@@ -1,17 +0,0 @@
-import React from 'react';
-export interface SvgRingProps {
-    cx?: number;
-    cy?: number;
-    r?: number;
-    variant?: 'solid' | 'dashed' | 'glow';
-    color?: string;
-    strokeWidth?: number;
-    opacity?: number;
-    className?: string;
-    label?: string;
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    width?: number;
-    height?: number;
-}
-export declare const SvgRing: React.FC<SvgRingProps>;

package/dist/components/core/atoms/svg/SvgShield.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-export interface SvgShieldProps {
-    x?: number;
-    y?: number;
-    size?: number;
-    variant?: 'outline' | 'filled' | 'check';
-    color?: string;
-    opacity?: number;
-    className?: string;
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    width?: number;
-    height?: number;
-}
-export declare const SvgShield: React.FC<SvgShieldProps>;

package/dist/components/core/atoms/svg/SvgStack.d.ts

@@ -1,17 +0,0 @@
-import React from 'react';
-export interface SvgStackProps {
-    x?: number;
-    y?: number;
-    layers?: number;
-    width?: number;
-    height?: number;
-    color?: string;
-    opacity?: number;
-    className?: string;
-    labels?: string[];
-    /** When true (default), wraps in a standalone <svg> so the shape is visible without a parent SVG context. */
-    asRoot?: boolean;
-    svgWidth?: number;
-    svgHeight?: number;
-}
-export declare const SvgStack: React.FC<SvgStackProps>;

package/dist/components/core/atoms/svg/index.d.ts

@@ -1,12 +0,0 @@
-export { SvgBranch, type SvgBranchProps } from './SvgBranch';
-export { SvgConnection, type SvgConnectionProps } from './SvgConnection';
-export { SvgFlow, type SvgFlowProps } from './SvgFlow';
-export { SvgGrid, type SvgGridProps } from './SvgGrid';
-export { SvgLobe, type SvgLobeProps } from './SvgLobe';
-export { SvgMesh, type SvgMeshProps } from './SvgMesh';
-export { SvgMorph, type SvgMorphProps } from './SvgMorph';
-export { SvgNode, type SvgNodeProps } from './SvgNode';
-export { SvgPulse, type SvgPulseProps } from './SvgPulse';
-export { SvgRing, type SvgRingProps } from './SvgRing';
-export { SvgShield, type SvgShieldProps } from './SvgShield';
-export { SvgStack, type SvgStackProps } from './SvgStack';

package/dist/components/core/atoms/types.d.ts

@@ -1,47 +0,0 @@
-/**
- * Cross-cutting atom-level prop shapes shared across the design system.
- */
-import type { AssetUrl } from "@almadar/core";
-/**
- * Canonical semantic color palette.  Values are the Tailwind / CSS-var token
- * names that every component in the design system understands.  Prefer this
- * over a bare `string` for any `color` or `variant` prop.
- */
-export type ColorToken = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'muted';
-/**
- * Concrete error-state shape read by display components (`error.message`,
- * occasionally `error.stack`). Structurally assignable from the global `Error`,
- * so existing call sites passing an `Error` keep working — this just gives the
- * pattern extractor a readable field schema instead of the opaque `Error` global.
- */
-export type UiError = {
-    message: string;
-    name?: string;
-    code?: string;
-    stack?: string;
-};
-/**
- * A labelled link/CTA used by marketing molecules (HeroSection, CTABanner,
- * PricingCard) for their primary/secondary call-to-action props.
- */
-export type LinkAction = {
-    label: string;
-    href: string;
-};
-/** An image with its required alt text. */
-export type ImageSource = {
-    src: AssetUrl;
-    alt: string;
-};
-/** A 2D point in canvas/layout coordinates. */
-export type Point = {
-    x: number;
-    y: number;
-};
-/** A 2D rectangle in canvas coordinates (`w`/`h` = width/height). */
-export type Rect = {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-};

package/dist/components/core/molecules/Accordion.d.ts

@@ -1,71 +0,0 @@
-/**
- * Accordion Molecule Component
- *
- * A collapsible content component with single or multiple open items.
- * Uses Button, Icon, Typography, and Divider atoms.
- */
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-export interface AccordionItem {
-    /**
-     * Item ID (auto-generated from header/title if not provided)
-     */
-    id?: string;
-    /**
-     * Item header/title
-     */
-    header?: React.ReactNode;
-    /**
-     * Alias for header (pattern compatibility)
-     */
-    title?: React.ReactNode;
-    /**
-     * Item content
-     */
-    content: React.ReactNode;
-    /**
-     * Disable item
-     */
-    disabled?: boolean;
-    /**
-     * Default open state
-     */
-    defaultOpen?: boolean;
-}
-export interface AccordionProps {
-    /**
-     * Accordion items
-     */
-    items: AccordionItem[];
-    /**
-     * Allow multiple items open at once
-     * @default false
-     */
-    multiple?: boolean;
-    /**
-     * Default open items (IDs)
-     */
-    defaultOpenItems?: string[];
-    /**
-     * Default open items by index (pattern compatibility)
-     */
-    defaultOpen?: number[];
-    /**
-     * Controlled open items (IDs)
-     */
-    openItems?: string[];
-    /**
-     * Callback when item opens/closes
-     */
-    onItemToggle?: (itemId: string, isOpen: boolean) => void;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /** Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen } */
-    toggleEvent?: EventEmit<{
-        itemId: string;
-        isOpen: boolean;
-    }>;
-}
-export declare const Accordion: React.FC<AccordionProps>;

package/dist/components/core/molecules/ActivationBlock.d.ts

@@ -1,22 +0,0 @@
-/**
- * ActivationBlock Molecule Component
- *
- * Pre-lesson activation prompt. Invites learners to surface prior knowledge
- * before content begins. Emits `UI:SAVE_ACTIVATION { response }`.
- *
- * Event Contract:
- * - Emits: UI:SAVE_ACTIVATION { response }
- * - entityAware: false
- */
-import React from 'react';
-export interface ActivationBlockProps {
-    /** The prior-knowledge question */
-    question: string;
-    /** Pre-filled response from saved state */
-    savedResponse?: string;
-    /** Event name emitted on save/skip (as `UI:<saveEvent>`). Defaults to 'SAVE_ACTIVATION'. */
-    saveEvent?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const ActivationBlock: React.FC<ActivationBlockProps>;

package/dist/components/core/molecules/Alert.d.ts

@@ -1,25 +0,0 @@
-/**
- * Alert Molecule Component
- *
- * A component for displaying alert messages with different variants and actions.
- * Uses theme-aware CSS variables for styling.
- */
-import React from "react";
-import type { EventKey } from "@almadar/core";
-export type AlertVariant = "info" | "success" | "warning" | "error";
-export interface AlertProps {
-    /** Alert content (children or message) */
-    children?: React.ReactNode;
-    /** Alert message (alias for children) */
-    message?: string;
-    variant?: AlertVariant;
-    title?: string;
-    dismissible?: boolean;
-    onDismiss?: () => void;
-    onClose?: () => void;
-    actions?: React.ReactNode;
-    className?: string;
-    /** Declarative dismiss event — emits UI:{dismissEvent} via eventBus when alert is dismissed */
-    dismissEvent?: EventKey;
-}
-export declare const Alert: React.FC<AlertProps>;

package/dist/components/core/molecules/AnimatedCounter.d.ts

@@ -1,18 +0,0 @@
-/**
- * AnimatedCounter Molecule Component
- *
- * Counts from 0 to a target value on scroll-into-view using IntersectionObserver.
- * Replaces static stat numbers with animated versions for visual impact.
- */
-import React from 'react';
-export interface AnimatedCounterProps {
-    /** Target value to count to. Strings allow display formats (e.g. "500+", "99.9%", "3x"); numbers are coerced. */
-    value: string | number;
-    /** Label displayed below the number */
-    label: string;
-    /** Animation duration in ms */
-    duration?: number;
-    /** Additional class names */
-    className?: string;
-}
-export declare const AnimatedCounter: React.FC<AnimatedCounterProps>;

package/dist/components/core/molecules/AssetPicker.d.ts

@@ -1,21 +0,0 @@
-/**
- * AssetPicker Molecule Component
- *
- * Catalog-driven asset chooser built on the GridPicker base. Maps an
- * AssetCatalog into picker cells and renders a kind-aware thumbnail: an
- * <img> for visual kinds, an Icon affordance for audio/model/other. Pure
- * presentational — the host supplies the catalog and owns the selected url.
- */
-import React from 'react';
-import type { AssetCatalog } from '@almadar/core';
-export interface AssetPickerProps {
-    /** Browsable asset catalog supplied by the host. */
-    assets: AssetCatalog;
-    /** Currently selected asset url (controlled highlight). */
-    value?: string;
-    /** Fired with the chosen asset's url. */
-    onChange: (url: string) => void;
-    /** Additional CSS classes applied to the root. */
-    className?: string;
-}
-export declare const AssetPicker: React.FC<AssetPickerProps>;

package/dist/components/core/molecules/BloomQuizBlock.d.ts

@@ -1,25 +0,0 @@
-/**
- * BloomQuizBlock Molecule Component
- *
- * Practice Q&A with Bloom's Taxonomy level badge. Emits `UI:ANSWER_BLOOM { index, level }`.
- *
- * Event Contract:
- * - Emits: UI:ANSWER_BLOOM { index, level }
- * - entityAware: false
- */
-import React from 'react';
-export type BloomLevel = 'remember' | 'understand' | 'apply' | 'analyze' | 'evaluate' | 'create';
-export interface BloomQuizBlockProps {
-    level: BloomLevel;
-    question: string;
-    answer: string;
-    /** Zero-based index (used in the emitted event payload) */
-    index?: number;
-    /** Whether the learner has already answered */
-    isAnswered?: boolean;
-    /** Event name emitted on first reveal (as `UI:<answerEvent>`). Defaults to 'ANSWER_BLOOM'. */
-    answerEvent?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const BloomQuizBlock: React.FC<BloomQuizBlockProps>;

package/dist/components/core/molecules/BranchingLogicBuilder.d.ts

@@ -1,33 +0,0 @@
-import React from 'react';
-import type { EventEmit, EventPayload, EventPayloadValue } from '@almadar/core';
-export interface BranchingQuestion {
-    id: string;
-    label: string;
-    optionValues?: string[];
-}
-export type BranchingOperator = 'equals' | 'not-equals' | 'contains' | 'in';
-export declare const END_OF_SURVEY = "end-of-survey";
-export interface BranchingRule extends EventPayload {
-    id: string;
-    sourceQuestionId: string;
-    operator: BranchingOperator;
-    value: string | string[];
-    targetQuestionId: string | typeof END_OF_SURVEY;
-}
-export interface BranchingLogicBuilderProps {
-    questions: readonly BranchingQuestion[] | EventPayloadValue;
-    /**
-     * Rules. Accepts either a typed array (direct consumers) or the runtime
-     * payload shape from a render-ui binding (`@payload.data`). Narrowed to
-     * `[]` internally when the value isn't an array.
-     */
-    rules: readonly BranchingRule[] | EventPayloadValue;
-    onRulesChange?: (rules: BranchingRule[]) => void;
-    /** Event name dispatched via event bus when rules change. Payload: `{ rules }`. */
-    rulesChangeEvent?: EventEmit<{
-        rules: BranchingRule[];
-    }>;
-    readOnly?: boolean;
-    className?: string;
-}
-export declare const BranchingLogicBuilder: React.FC<BranchingLogicBuilderProps>;

package/dist/components/core/molecules/Breadcrumb.d.ts

@@ -1,55 +0,0 @@
-/**
- * Breadcrumb Molecule Component
- *
- * A breadcrumb navigation component with separators and icons.
- * Uses Button, Icon, and Typography atoms.
- */
-import React from "react";
-import type { IconInput } from "../atoms/index";
-export interface BreadcrumbItem {
-    /**
-     * Item label
-     */
-    label: string;
-    /**
-     * Item href (if provided, renders as link)
-     */
-    href?: string;
-    /**
-     * Item path (alias for href, for schema compatibility)
-     */
-    path?: string;
-    /**
-     * Item icon (canonical kebab-case name or LucideIcon component)
-     */
-    icon?: IconInput;
-    /**
-     * Click handler (if href not provided)
-     */
-    onClick?: () => void;
-    /**
-     * Is current page
-     */
-    isCurrent?: boolean;
-    /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
-}
-export interface BreadcrumbProps {
-    /**
-     * Breadcrumb items
-     */
-    items: BreadcrumbItem[];
-    /**
-     * Separator icon (canonical kebab-case name or LucideIcon component)
-     */
-    separator?: IconInput;
-    /**
-     * Maximum items to show (truncates with ellipsis)
-     */
-    maxItems?: number;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-}
-export declare const Breadcrumb: React.FC<BreadcrumbProps>;

package/dist/components/core/molecules/ButtonGroup.d.ts

@@ -1,77 +0,0 @@
-/**
- * ButtonGroup Molecule Component
- *
- * A component for grouping buttons together with connected styling.
- * Supports both children-based and form-actions pattern (primary/secondary) usage.
- * Uses Button atoms.
- */
-import React from 'react';
-export type ButtonGroupVariant = 'default' | 'segmented' | 'toggle';
-/**
- * Layer 2 visual treatment for the action-cluster (form-actions) pattern —
- * orthogonal to the semantic `variant` (which conveys grouping shape).
- */
-export type ActionClusterLook = 'right-aligned-buttons' | 'floating-bar' | 'inline-row' | 'dropdown-menu' | 'command-palette-trigger';
-/** Action button config for form-actions pattern */
-export interface ActionButton {
-    label: string;
-    /** Action type - 'submit' renders as submit button, others render as button */
-    actionType?: string;
-    event?: string;
-    navigatesTo?: string;
-    /** Button variant - matches Button component variants. Accepts string for schema compatibility. */
-    variant?: string;
-}
-/** Filter definition for filter-group pattern */
-export interface FilterDefinition {
-    field: string;
-    label: string;
-    /** Filter type (checkbox, select, etc.) */
-    type?: 'checkbox' | 'select' | 'toggle';
-    /** Options for select filters */
-    options?: readonly string[];
-}
-export interface ButtonGroupProps {
-    /**
-     * Button group content (Button components) - use this OR primary/secondary
-     */
-    children?: React.ReactNode;
-    /**
-     * Primary action button config (for form-actions pattern)
-     * Accepts Readonly for compatibility with generated const objects
-     */
-    primary?: Readonly<ActionButton>;
-    /**
-     * Secondary action buttons config (for form-actions pattern)
-     * Accepts readonly array for compatibility with generated const arrays
-     */
-    secondary?: readonly Readonly<ActionButton>[];
-    /**
-     * Visual variant
-     * @default 'default'
-     */
-    variant?: ButtonGroupVariant;
-    /**
-     * Orientation
-     * @default 'horizontal'
-     */
-    orientation?: 'horizontal' | 'vertical';
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /**
-     * Entity type for filter-group pattern (schema metadata)
-     */
-    entity?: string;
-    /**
-     * Filter definitions for filter-group pattern
-     */
-    filters?: readonly FilterDefinition[];
-    /**
-     * Layer 2 visual treatment for the action-cluster (form-actions) pattern.
-     * @default 'right-aligned-buttons'
-     */
-    look?: ActionClusterLook;
-}
-export declare const ButtonGroup: React.FC<ButtonGroupProps>;

package/dist/components/core/molecules/CalendarGrid.d.ts

@@ -1,61 +0,0 @@
-/**
- * CalendarGrid
- *
- * Pure presentational weekly calendar grid molecule.
- * No entity binding, no event bus, no translations.
- * Composes DayCell and TimeSlotCell atoms into a 7-day grid.
- */
-import React from "react";
-import type { EventEmit, EventPayload, EntityRow, EntityWith } from "@almadar/core";
-/**
- * Number of day columns rendered at once. Matches the responsiveness-
- * audit tiers exactly: 1 day on mobile (≤640), 3 on tablet (641–1024),
- * 7 on laptop+ (≥1025).
- */
-export type CalendarDayWindow = 1 | 3 | 7;
-/** The per-event entity fields this grid reads. `startTime`/`endTime` are ISO
- *  strings; `color` is a Tailwind class string applied to the event chip. */
-export interface CalendarEventRow {
-    title: string;
-    startTime: string;
-    endTime?: string;
-    color?: string;
-}
-export interface CalendarGridProps {
-    /** Start of the week (defaults to current week's Monday) */
-    weekStart?: Date;
-    /** Time slot labels (defaults to 09:00-17:00) */
-    timeSlots?: string[];
-    /** Events to display on the grid */
-    events?: readonly EntityWith<CalendarEventRow>[];
-    /** Called when a time slot is clicked */
-    onSlotClick?: (day: Date, time: string) => void;
-    /** Called when a day header is clicked */
-    onDayClick?: (day: Date) => void;
-    /** Called when an event is clicked */
-    onEventClick?: (event: EntityRow) => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload } */
-    longPressEvent?: EventEmit<{
-        date: string;
-        time?: string;
-    }>;
-    /** Additional payload for long-press events */
-    longPressPayload?: EventPayload;
-    /** Event emitted on swipe left (next week): UI:{swipeLeftEvent} */
-    swipeLeftEvent?: EventEmit<Record<string, never>>;
-    /** Event emitted on swipe right (prev week): UI:{swipeRightEvent} */
-    swipeRightEvent?: EventEmit<Record<string, never>>;
-    /**
-     * Override the viewport-driven day window. `'auto'` (default) tracks
-     * `window.innerWidth` — 1 day on mobile, 3 on tablet, 7 on laptop+.
-     * Pass an explicit number to force a fixed window (useful for print
-     * layouts or screenshot tests).
-     */
-    dayWindow?: CalendarDayWindow | 'auto';
-}
-export declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, }: CalendarGridProps): React.JSX.Element;
-export declare namespace CalendarGrid {
-    var displayName: string;
-}

package/dist/components/core/molecules/Card.d.ts

@@ -1,58 +0,0 @@
-/**
- * Card Component
- *
- * A generic card container for displaying content with optional title,
- * subtitle, and action buttons.
- *
- * @generated by Orbital Compiler
- */
-import React from "react";
-import type { AssetUrl, EventEmit, EventKey, EventPayload } from "@almadar/core";
-import type { IconInput } from "../atoms/index";
-export interface CardAction {
-    label: string;
-    onClick?: () => void;
-    /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
-    variant?: "default" | "primary" | "danger";
-    icon?: IconInput;
-    disabled?: boolean;
-}
-export interface CardProps {
-    /** Card title */
-    title?: string;
-    /** Card subtitle or description */
-    subtitle?: string;
-    /** Image URL to display at top of card */
-    image?: AssetUrl;
-    /** Action buttons to display in card footer */
-    actions?: CardAction[];
-    /** Card content */
-    children?: React.ReactNode;
-    /** Click handler for the entire card */
-    onClick?: () => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Declarative event name — emits UI:{action} via eventBus on card click */
-    action?: EventKey;
-    /** Whether the card is selected (highlighted state) */
-    isSelected?: boolean;
-    /** Card name (alias for title) */
-    name?: string;
-    /** Level indicator */
-    level?: number;
-    /** Maximum level */
-    maxLevel?: number;
-    /** Event emitted on long press: UI:{longPressEvent} (payload: longPressPayload spread — variable) */
-    longPressEvent?: EventEmit<EventPayload>;
-    /** Additional payload for long-press events */
-    longPressPayload?: EventPayload;
-}
-/**
- * Card component for displaying content in a contained box
- */
-export declare function Card({ title, subtitle, image, actions, children, onClick, className, action, longPressEvent, longPressPayload, }: CardProps): React.JSX.Element;
-export declare namespace Card {
-    var displayName: string;
-}
-export default Card;