@almadar/ui 5.78.0 → 5.79.1

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

@@ -1,28 +0,0 @@
-import React from "react";
-import type { EventKey, EventPayload } from "@almadar/core";
-export type NumberStepperSize = "sm" | "md" | "lg";
-export interface NumberStepperProps {
-    /** Current value */
-    value?: number;
-    /** Minimum value */
-    min?: number;
-    /** Maximum value */
-    max?: number;
-    /** Step increment */
-    step?: number;
-    /** Size variant */
-    size?: NumberStepperSize;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Direct onChange callback */
-    onChange?: (value: number) => void;
-    /** Declarative event name for value changes */
-    action?: EventKey;
-    /** Payload to include with the action event */
-    actionPayload?: EventPayload;
-    /** Additional CSS classes */
-    className?: string;
-    /** Accessible label */
-    label?: string;
-}
-export declare const NumberStepper: React.FC<NumberStepperProps>;

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

@@ -1,27 +0,0 @@
-/**
- * OnboardingSpotlight Molecule
- *
- * Optional first-run welcome: a dimmed backdrop with a cut-out over the current
- * step's anchor, plus a stepped Coachmark bubble (Next / Skip). The backdrop is
- * four dim rectangles around the anchor rect so the highlighted element stays
- * lit and clickable-looking; the bubble and step dots reuse Coachmark.
- */
-import React from "react";
-import { type CoachmarkAnchor, type CoachmarkPlacement } from "./Coachmark";
-export interface SpotlightStep {
-    anchor: CoachmarkAnchor;
-    placement?: CoachmarkPlacement;
-    title: string;
-    body: string;
-}
-export interface OnboardingSpotlightProps {
-    steps: SpotlightStep[];
-    /** Index of the active step. Out-of-range hides the spotlight. */
-    stepIndex: number;
-    onNext: () => void;
-    onSkip: () => void;
-    onFinish: () => void;
-    /** Padding around the cut-out, in px. @default 6 */
-    cutoutPadding?: number;
-}
-export declare const OnboardingSpotlight: React.FC<OnboardingSpotlightProps>;

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

@@ -1,44 +0,0 @@
-/**
- * OptionConstraintGroup Molecule Component
- *
- * Generic constrained option selector (radio for "single", checkbox for "multi") with required/optional/multi
- * constraints. Renders radio inputs for `single` constraint and checkboxes for
- * `multi`. Reports validation errors inline when the current selection
- * violates the constraint.
- *
- * **Atomic Design**: Composed using Typography atom and native form controls.
- */
-import React from 'react';
-import type { EventEmit } from '@almadar/core';
-export type OptionConstraintOption = {
-    id: string;
-    label: string;
-    priceDelta?: number;
-    disabled?: boolean;
-    outOfStock?: boolean;
-};
-export type OptionConstraint = {
-    type: 'single';
-    required?: boolean;
-} | {
-    type: 'multi';
-    min?: number;
-    max?: number;
-};
-export interface OptionConstraintGroupProps {
-    groupId: string;
-    title: string;
-    description?: string;
-    options: OptionConstraintOption[];
-    /** Selection constraint. Optional — defaults to single-select (the generic
-     *  factory can't author a discriminated-union value; an author overrides it). */
-    constraint?: OptionConstraint;
-    selected?: string[];
-    onChange?: (selected: string[]) => void;
-    changeEvent?: EventEmit<{
-        selected: string[];
-    }>;
-    size?: 'sm' | 'md';
-    className?: string;
-}
-export declare const OptionConstraintGroup: React.FC<OptionConstraintGroupProps>;

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

@@ -1,48 +0,0 @@
-/**
- * OrbitalVisualization Component
- *
- * Visualizes KFlow schemas as atomic orbitals based on complexity.
- * Uses CSS 3D transforms for lightweight rendering without Three.js.
- *
- * Orbital Types (based on complexity score):
- * - 1s (1-3): Simple sphere - Red
- * - 2s (4-8): Larger sphere - Orange
- * - 2p (9-15): Dumbbell shape - Yellow
- * - 3s (16-25): Sphere with node - Green
- * - 3p (26-40): Complex dumbbell - Blue
- * - 3d (41-60): Cloverleaf - Indigo
- * - 4f (61+): Multi-lobe - Violet
- */
-import React from "react";
-import type { UiError } from '../atoms/types';
-import type { JsonValue } from '@almadar/core';
-export interface OrbitalVisualizationProps {
-    /** Full KFlow schema object */
-    schema?: {
-        dataEntities?: JsonValue[];
-        ui?: {
-            pages?: {
-                sections?: JsonValue[];
-            }[];
-        };
-        traits?: JsonValue[];
-    };
-    /** Direct complexity override (1-100+) */
-    complexity?: number;
-    /** Size of the visualization */
-    size?: "sm" | "md" | "lg" | "xl";
-    /** Show complexity label */
-    showLabel?: boolean;
-    /** Animation enabled */
-    animated?: boolean;
-    /** Click handler */
-    onClick?: () => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-}
-export declare const OrbitalVisualization: React.FC<OrbitalVisualizationProps>;
-export default OrbitalVisualization;

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

@@ -1,60 +0,0 @@
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-import type { IconInput } from "../atoms/index";
-import type { UiError } from '../atoms/types';
-export interface PageBreadcrumb {
-    label: string;
-    href?: string;
-}
-/**
- * Schema-based action definition
- */
-export interface SchemaAction {
-    label: string;
-    /** Navigate to URL when clicked */
-    navigatesTo?: string;
-    /** Custom click handler */
-    onClick?: () => void;
-    /** Event to dispatch via event bus (for trait state machine integration) */
-    event?: string;
-    variant?: "primary" | "secondary" | "ghost" | "danger";
-    icon?: IconInput;
-    loading?: boolean;
-    disabled?: boolean;
-}
-export interface PageHeaderStatus {
-    label: string;
-    variant?: "default" | "success" | "warning" | "danger" | "info";
-}
-export interface PageHeaderProps {
-    /** Page title - accepts string or number from generated code accessing dynamic entity data */
-    title?: string | number;
-    /** Optional subtitle/description */
-    subtitle?: string | number;
-    /** Show back button */
-    showBack?: boolean;
-    /** Event to emit when back is clicked (default: BACK) */
-    backEvent?: EventEmit<Record<string, never>>;
-    /** Breadcrumbs */
-    breadcrumbs?: readonly PageBreadcrumb[];
-    /** Status badge */
-    status?: PageHeaderStatus;
-    /** Actions array - first action with variant='primary' (or first action) is the main action */
-    actions?: readonly Readonly<SchemaAction>[];
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Tabs for sub-navigation */
-    tabs?: ReadonlyArray<{
-        label: string;
-        value: string;
-        count?: number;
-    }>;
-    activeTab?: string;
-    onTabChange?: (value: string) => void;
-    /** Custom content in the header */
-    children?: React.ReactNode;
-    className?: string;
-}
-export declare const PageHeader: React.FC<PageHeaderProps>;

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

@@ -1,71 +0,0 @@
-/**
- * Pagination Molecule Component
- *
- * A pagination component with page numbers, previous/next buttons, and ellipsis.
- * Uses Button, Icon, Typography, and Input atoms.
- */
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-export interface PaginationProps {
-    /**
-     * Current page (1-indexed)
-     */
-    currentPage: number;
-    /**
-     * Total number of pages
-     */
-    totalPages: number;
-    /**
-     * Callback when page changes (optional - can be a no-op if not interactive)
-     */
-    onPageChange?: (page: number) => void;
-    /**
-     * Show page size selector
-     * @default false
-     */
-    showPageSize?: boolean;
-    /**
-     * Page size options
-     */
-    pageSizeOptions?: number[];
-    /**
-     * Current page size
-     */
-    pageSize?: number;
-    /**
-     * Callback when page size changes
-     */
-    onPageSizeChange?: (size: number) => void;
-    /**
-     * Show jump to page input
-     * @default false
-     */
-    showJumpToPage?: boolean;
-    /**
-     * Show total count
-     * @default false
-     */
-    showTotal?: boolean;
-    /**
-     * Total items count
-     */
-    totalItems?: number;
-    /**
-     * Maximum number of page buttons to show
-     * @default 7
-     */
-    maxVisiblePages?: number;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /** Declarative page change event — emits UI:{pageChangeEvent} with { page } */
-    pageChangeEvent?: EventEmit<{
-        page: number;
-    }>;
-    /** Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize } */
-    pageSizeChangeEvent?: EventEmit<{
-        pageSize: number;
-    }>;
-}
-export declare const Pagination: React.FC<PaginationProps>;

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

@@ -1,39 +0,0 @@
-/**
- * Popover Molecule Component
- *
- * A popover component with position variants and click/hover triggers.
- * Uses Button, Typography, and Icon atoms.
- */
-import React from "react";
-export type PopoverPosition = "top" | "bottom" | "left" | "right";
-export type PopoverTrigger = "click" | "hover";
-export interface PopoverProps {
-    /**
-     * Popover content
-     */
-    content: React.ReactNode;
-    /**
-     * Popover trigger element (ReactElement or ReactNode that will be wrapped in span)
-     */
-    children: React.ReactNode;
-    /**
-     * Popover position
-     * @default 'bottom'
-     */
-    position?: PopoverPosition;
-    /**
-     * Trigger type
-     * @default 'click'
-     */
-    trigger?: PopoverTrigger;
-    /**
-     * Show arrow
-     * @default true
-     */
-    showArrow?: boolean;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-}
-export declare const Popover: React.FC<PopoverProps>;

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

@@ -1,40 +0,0 @@
-import React from "react";
-import type { EventEmit, EntityWith } from "@almadar/core";
-export type CanvasItemStatus = 'empty' | 'seated' | 'ordered' | 'awaiting-bill' | 'cleaning';
-export type CanvasItemShape = 'round' | 'rectangle' | 'square';
-/** The per-item entity fields this canvas reads. `x`/`y` are pixel coordinates
- *  in the canvas plane; `status`/`shape` are string literal unions widened to
- *  `string` at the row level. */
-export interface CanvasItemRow {
-    label: string;
-    x: number;
-    y: number;
-    capacity: number;
-    partySize?: number;
-    serverName?: string;
-    status?: CanvasItemStatus;
-    shape?: CanvasItemShape;
-}
-export interface PositionedCanvasProps {
-    /**
-     * Items to render. The molecule narrows non-array values to `[]` and reads
-     * each row's `id` / `x` / `y` / `label` fields at render time.
-     */
-    items: readonly EntityWith<CanvasItemRow>[];
-    width?: number;
-    height?: number;
-    selectedId?: string | null;
-    editable?: boolean;
-    onSelect?: (id: string | null) => void;
-    onMove?: (id: string, x: number, y: number) => void;
-    selectEvent?: EventEmit<{
-        id: string | null;
-    }>;
-    moveEvent?: EventEmit<{
-        id: string;
-        x: number;
-        y: number;
-    }>;
-    className?: string;
-}
-export declare const PositionedCanvas: React.FC<PositionedCanvasProps>;

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

@@ -1,24 +0,0 @@
-/**
- * ProgressDots Molecule Component
- *
- * Step indicator dots for multi-step flows.
- * Pure UI molecule with no entity binding.
- */
-import React from 'react';
-export type DotState = 'active' | 'complete' | 'pending';
-export type DotSize = 'sm' | 'md' | 'lg';
-export interface ProgressDotsProps {
-    /** Total number of dots */
-    count: number;
-    /** Current active index (0-based) */
-    currentIndex: number;
-    /** Custom state resolver per dot index */
-    getState?: (index: number) => DotState;
-    /** Callback when a dot is clicked */
-    onDotClick?: (index: number) => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Dot size */
-    size?: DotSize;
-}
-export declare const ProgressDots: React.FC<ProgressDotsProps>;

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

@@ -1,36 +0,0 @@
-import React from 'react';
-import type { DeclaredTraitConfig, ConfigFieldDeclaration, TraitConfig, TraitConfigValue, AssetCatalog } from '@almadar/core';
-import type { DisplayStateProps } from '../organisms/types';
-/**
- * PropertyInspector — Storybook-style controls panel for a trait's `config`.
- *
- * Derives one control per declared config field directly from the schema
- * (`@almadar/core` `DeclaredTraitConfig`), dispatching on the field's `type`:
- * `icon → IconPicker`, `asset → AssetPicker`, `boolean → Switch`, `string` with
- * `values → Select`, `number → numeric Input`, `string → Input`. Non-scalar
- * fields (array/object/node/SExpr) are shown read-only. Fields group + collapse
- * by `@tier`. The component is controlled — it emits `onChange(field, value)`;
- * text/number commit on blur (so the host can re-render without hammering it).
- */
-export interface PropertyInspectorProps extends DisplayStateProps {
-    /** The trait's declared config schema (field name → declaration). */
-    config: DeclaredTraitConfig;
-    /** Current override values keyed by field name (falls back to each field's `default`). */
-    values?: TraitConfig;
-    /** Fired when a control commits a new value. */
-    onChange: (field: string, value: TraitConfigValue) => void;
-    /** Optional reset-to-defaults handler. */
-    onReset?: () => void;
-    /** Panel heading (e.g. the trait name). */
-    title?: string;
-    /** Browsable asset catalog supplied to `asset`-typed fields' AssetPicker. */
-    assets?: AssetCatalog;
-}
-export declare function FieldControl({ name, decl, value, onChange, assets, }: {
-    name: string;
-    decl: ConfigFieldDeclaration;
-    value: TraitConfigValue | undefined;
-    onChange: (field: string, value: TraitConfigValue) => void;
-    assets?: AssetCatalog;
-}): React.ReactElement;
-export declare const PropertyInspector: React.FC<PropertyInspectorProps>;

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

@@ -1,22 +0,0 @@
-/**
- * PullToRefresh Molecule Component
- *
- * Wrapper that adds pull-to-refresh gesture to children.
- * Shows a spinner indicator as the user pulls down, and emits
- * a refresh event via the event bus when the threshold is met.
- */
-import React from 'react';
-import type { EventKey, EventPayload } from "@almadar/core";
-export interface PullToRefreshProps {
-    /** Event name to emit on refresh (emitted as UI:{refreshEvent}) */
-    refreshEvent: EventKey;
-    /** Payload to include with the refresh event */
-    refreshPayload?: EventPayload;
-    /** Pull distance threshold to trigger refresh in px (default: 60) */
-    threshold?: number;
-    /** Content to wrap */
-    children: React.ReactNode;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const PullToRefresh: React.FC<PullToRefreshProps>;

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

@@ -1,24 +0,0 @@
-import React from "react";
-import type { EventEmit, EventPayload } from "@almadar/core";
-/**
- * QR scan callback payload. Extends `EventPayload` (string-indexed
- * `EventPayloadValue` map) so the result is directly assignable to a
- * render-ui dispatched event payload without re-shaping.
- */
-export type QrScanResult = EventPayload & {
-    text: string;
-    format: string;
-    timestamp: number;
-};
-export interface QrScannerProps {
-    onScan?: (result: QrScanResult) => void;
-    scanEvent?: EventEmit<QrScanResult>;
-    onError?: (error: Error) => void;
-    facingMode?: 'environment' | 'user';
-    paused?: boolean;
-    showOverlay?: boolean;
-    showCameraControls?: boolean;
-    fallback?: React.ReactNode;
-    className?: string;
-}
-export declare const QrScanner: React.FC<QrScannerProps>;

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

@@ -1,20 +0,0 @@
-/**
- * QuizBlock Molecule Component
- *
- * A collapsible Q&A block for embedded quiz questions in content.
- * Shows the question with a reveal button for the answer.
- *
- * Event Contract:
- * - No events emitted (self-contained interaction)
- * - entityAware: false
- */
-import React from 'react';
-export interface QuizBlockProps {
-    /** The quiz question */
-    question: string;
-    /** The quiz answer (revealed on toggle) */
-    answer: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const QuizBlock: React.FC<QuizBlockProps>;

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

@@ -1,23 +0,0 @@
-/**
- * ReflectionBlock Molecule Component
- *
- * Inline reflection prompt for deep processing. Emits `UI:SAVE_REFLECTION { index, note }`.
- *
- * Event Contract:
- * - Emits: UI:SAVE_REFLECTION { index, note }
- * - entityAware: false
- */
-import React from 'react';
-export interface ReflectionBlockProps {
-    /** The reflection prompt */
-    prompt: string;
-    /** Zero-based index of this block (used in the emitted event payload) */
-    index: number;
-    /** Pre-filled note from saved state */
-    savedNote?: string;
-    /** Event name emitted on save (as `UI:<saveEvent>`). Defaults to 'SAVE_REFLECTION'. */
-    saveEvent?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const ReflectionBlock: React.FC<ReflectionBlockProps>;

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

@@ -1,48 +0,0 @@
-/**
- * RelationSelect Molecule Component
- *
- * A searchable select component for relation fields.
- * Allows users to search and select from related entities.
- *
- * Composed from: Box, HStack, VStack, Input, Button, Spinner, Typography atoms
- */
-import React from "react";
-export interface RelationOption {
-    /** The value to store (typically the ID) */
-    value: string;
-    /** The display label */
-    label: string;
-    /** Optional description */
-    description?: string;
-    /** Whether this option is disabled */
-    disabled?: boolean;
-}
-export interface RelationSelectProps {
-    /** Current value (ID) */
-    value?: string;
-    /** Callback when value changes */
-    onChange?: (value: string | undefined) => void;
-    /** Available options - accepts readonly for compatibility with generated const arrays */
-    options: readonly RelationOption[];
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether the field is required */
-    required?: boolean;
-    /** Whether the field is disabled */
-    disabled?: boolean;
-    /** Whether data is loading */
-    isLoading?: boolean;
-    /** Error message */
-    error?: string;
-    /** Allow clearing the selection */
-    clearable?: boolean;
-    /** Name attribute for forms */
-    name?: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Search placeholder */
-    searchPlaceholder?: string;
-    /** Empty state message */
-    emptyMessage?: string;
-}
-export declare const RelationSelect: React.FC<RelationSelectProps>;

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

@@ -1,60 +0,0 @@
-/**
- * RepeatableFormSection
- *
- * A form section that can be repeated multiple times.
- * Used for collecting multiple entries (participants, findings, etc.)
- *
- * Enhanced with trackAddedInState for inspection audit trails.
- *
- * Event Contract:
- * - Emits: UI:SECTION_ADDED { sectionType, index, addedInState? }
- * - Emits: UI:SECTION_REMOVED { sectionType, index, itemId }
- */
-import React from "react";
-import type { JsonValue } from "@almadar/core";
-export type RepeatableItem = {
-    id: string;
-    /** State in which this item was added (for audit trails). Optional — only
-     *  consumers using `trackAddedInState`/`showAuditInfo` populate it. */
-    addedInState?: string | null;
-    /** Timestamp when item was added. Optional — see `addedInState`. */
-    addedAt?: string | null;
-    [key: string]: JsonValue | undefined;
-};
-export interface RepeatableFormSectionProps {
-    /** Section type identifier */
-    sectionType: string;
-    /** Section title */
-    title: string;
-    /** Items in the section */
-    items: RepeatableItem[];
-    /** Render function for each item */
-    renderItem: (item: RepeatableItem, index: number) => React.ReactNode;
-    /** Minimum items required */
-    minItems?: number;
-    /** Maximum items allowed */
-    maxItems?: number;
-    /** Allow reordering */
-    allowReorder?: boolean;
-    /** Add button label */
-    addLabel?: string;
-    /** Empty state message */
-    emptyMessage?: string;
-    /** Read-only mode */
-    readOnly?: boolean;
-    /** Additional CSS classes */
-    className?: string;
-    /** Add handler */
-    onAdd?: () => void;
-    /** Remove handler */
-    onRemove?: (itemId: string, index: number) => void;
-    /** Reorder handler */
-    onReorder?: (fromIndex: number, toIndex: number) => void;
-    /** Track the state in which items are added (for inspection audit) */
-    trackAddedInState?: boolean;
-    /** Current inspection state (used when trackAddedInState is true) */
-    currentState?: string;
-    /** Show audit metadata (addedInState, addedAt) */
-    showAuditInfo?: boolean;
-}
-export declare const RepeatableFormSection: React.FC<RepeatableFormSectionProps>;

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

@@ -1,46 +0,0 @@
-/**
- * ReplyTree Organism Component
- *
- * Recursive nested-thread reply renderer with collapse, per-node mod actions, and vote.
- * Composes the VoteStack molecule + Avatar/Typography/Button atoms.
- */
-import React from "react";
-import type { EventEmit, EntityWith } from "@almadar/core";
-import { type VoteValue } from "./VoteStack";
-/** The per-node entity fields this tree reads. `replies` is the same row shape
- *  nested recursively; `userVote` carries the `VoteValue` literal union. */
-export interface ReplyNodeRow {
-    authorName: string;
-    content: string;
-    authorAvatarUrl?: string;
-    postedAt?: string;
-    voteCount?: number;
-    userVote?: VoteValue;
-    collapsed?: boolean;
-    replies?: readonly EntityWith<ReplyNodeRow>[];
-}
-export interface ReplyTreeProps {
-    nodes: readonly EntityWith<ReplyNodeRow>[];
-    maxDepth?: number;
-    onVote?: (nodeId: string, vote: VoteValue) => void;
-    onReply?: (parentNodeId: string) => void;
-    onFlag?: (nodeId: string) => void;
-    onContinueThread?: (nodeId: string) => void;
-    voteEvent?: EventEmit<{
-        nodeId: string;
-        vote: VoteValue;
-    }>;
-    replyEvent?: EventEmit<{
-        parentNodeId: string;
-        content: string;
-    }>;
-    flagEvent?: EventEmit<{
-        nodeId: string;
-    }>;
-    continueThreadEvent?: EventEmit<{
-        nodeId: string;
-    }>;
-    showActions?: boolean;
-    className?: string;
-}
-export declare const ReplyTree: React.FC<ReplyTreeProps>;