@almadar/ui 5.111.0 → 5.113.0

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

@@ -1,87 +0,0 @@
-/**
- * MapView Molecule Component
- *
- * Interactive map using react-leaflet with OpenStreetMap tiles.
- * Supports both programmatic callbacks (onMapClick) and schema-driven
- * event dispatch (mapClickEvent) via the event bus.
- *
- * Why this file looks weird: Leaflet's core/Util.js evaluates
- * `window.requestAnimationFrame` at module load time, which crashes any
- * SSR/SSG environment (Docusaurus, Next.js RSC, etc.) the moment a
- * consumer statically imports something that transitively reaches MapView.
- * To stay SSR-safe, the actual leaflet bindings are loaded lazily inside
- * a `React.lazy(async () => …)` callback so the leaflet module is only
- * evaluated when the component is rendered for the first time, which
- * never happens on the server because Suspense shows the fallback there.
- */
-import React from 'react';
-import type { EventEmit } from '@almadar/core';
-export type MapMarkerData = {
-    /** Unique marker identifier */
-    id: string | number;
-    /** Latitude */
-    lat: number;
-    /** Longitude */
-    lng: number;
-    /** Label shown in popup */
-    label?: string;
-    /** Optional category for styling */
-    category?: string;
-};
-export interface MapRouteWaypoint {
-    lat: number;
-    lng: number;
-}
-export interface MapRouteData {
-    /** Unique route identifier */
-    id: string | number;
-    /** Ordered waypoints rendered as a polyline */
-    waypoints: MapRouteWaypoint[];
-    /** Stroke color (CSS color). Defaults to a theme-aware accent. */
-    color?: string;
-    /** Stroke weight in pixels (default 4) */
-    weight?: number;
-    /** Stroke opacity 0..1 (default 0.8) */
-    opacity?: number;
-    /** Optional dashed pattern (e.g. "8 4") */
-    dashArray?: string;
-    /** Label shown in a popup at the midpoint */
-    label?: string;
-}
-export interface MapViewProps {
-    /** Array of markers to display */
-    markers?: MapMarkerData[];
-    /** Routes (polylines with optional popups) drawn over the tile layer */
-    routes?: MapRouteData[];
-    /** Map center latitude */
-    centerLat?: number;
-    /** Map center longitude */
-    centerLng?: number;
-    /** Zoom level (1-18, default 13) */
-    zoom?: number;
-    /** Height of the map container (default "400px") */
-    height?: string;
-    /** Callback when a marker is clicked (programmatic use) */
-    onMarkerClick?: (marker: MapMarkerData) => void;
-    /** Callback when the map is clicked (programmatic use) */
-    onMapClick?: (lat: number, lng: number) => void;
-    /** Event name dispatched via event bus when the map is clicked. Payload: { latitude, longitude } */
-    mapClickEvent?: EventEmit<{
-        latitude: number;
-        longitude: number;
-    }>;
-    /** Event name dispatched via event bus when a marker is clicked. Payload: full MapMarkerData spread. */
-    markerClickEvent?: EventEmit<MapMarkerData>;
-    /** Whether to show a pin at the clicked location */
-    showClickedPin?: boolean;
-    /** Additional CSS classes */
-    className?: string;
-    /** Show attribution (default true) */
-    showAttribution?: boolean;
-}
-/**
- * Server-safe wrapper. Renders an empty Box on the server (or until the
- * lazy implementation finishes loading on the client) so SSR never reaches
- * the leaflet code.
- */
-export declare function MapView(props: MapViewProps): React.JSX.Element;

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

@@ -1,35 +0,0 @@
-import React from "react";
-import type { EventEmit } from '@almadar/core';
-export interface MatrixRow {
-    id: string;
-    label: string;
-}
-export interface MatrixColumn {
-    value: number | string;
-    label: string;
-}
-export interface MatrixQuestionProps {
-    /** Optional title rendered above the matrix */
-    title?: string;
-    /** Question rows */
-    rows: MatrixRow[];
-    /** Column definitions; defaults to 5-point Likert */
-    columns?: MatrixColumn[];
-    /** Selected value per row, keyed by rowId */
-    values?: Record<string, number | string>;
-    /** Change handler invoked with rowId and selected column value */
-    onChange?: (rowId: string, value: number | string) => void;
-    /** Event name dispatched via event bus when a row's value changes. Payload: { rowId, value } */
-    changeEvent?: EventEmit<{
-        rowId: string;
-        value: number | string;
-    }>;
-    /** Disable all inputs */
-    disabled?: boolean;
-    /** Visual size */
-    size?: 'sm' | 'md';
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const DEFAULT_MATRIX_COLUMNS: MatrixColumn[];
-export declare const MatrixQuestion: React.FC<MatrixQuestionProps>;

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

@@ -1,44 +0,0 @@
-/**
- * Menu Molecule Component
- *
- * A dropdown menu component with items, icons, dividers, and sub-menus.
- * Uses theme-aware CSS variables for styling.
- */
-import React from "react";
-import type { IconInput } from "../atoms/index";
-export interface MenuItem {
-    /** Item ID (auto-generated from label if not provided) */
-    id?: string;
-    /** Item label */
-    label: string;
-    /** Item icon (Lucide icon name or component) */
-    icon?: IconInput;
-    /** Item badge */
-    badge?: string | number;
-    /** Disable item */
-    disabled?: boolean;
-    /** Item click handler */
-    onClick?: () => void;
-    /** Event name for pattern compatibility */
-    event?: string;
-    /** Variant for styling (pattern compatibility) */
-    variant?: "default" | "danger";
-    /** Sub-menu items */
-    subMenu?: MenuItem[];
-}
-export type MenuPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-start" | "top-end" | "bottom-start" | "bottom-end";
-export interface MenuProps {
-    /** Menu trigger element */
-    trigger: React.ReactNode;
-    /** Menu items */
-    items: MenuItem[];
-    /** Menu position */
-    position?: MenuPosition;
-    /** Additional CSS classes */
-    className?: string;
-    /** Optional slot rendered above the items. */
-    header?: React.ReactNode;
-    /** Optional slot rendered below the items. */
-    footer?: React.ReactNode;
-}
-export declare const Menu: React.FC<MenuProps>;

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

@@ -1,52 +0,0 @@
-/**
- * Meter Molecule
- *
- * A gauge/meter component for displaying a value within a range.
- * Supports linear, radial, and segmented display modes.
- * Pure molecule: no entity prop, no data fetching.
- */
-import React from "react";
-import type { UiError } from '../atoms/types';
-export type MeterVariant = "linear" | "radial" | "segmented";
-export interface MeterThreshold {
-    value: number;
-    color: string;
-    label?: string;
-}
-export interface MeterAction {
-    label: string;
-    event?: string;
-    navigatesTo?: string;
-    variant?: "primary" | "secondary" | "ghost";
-}
-export interface MeterProps {
-    /** Current value */
-    value: number;
-    /** Minimum value */
-    min?: number;
-    /** Maximum value */
-    max?: number;
-    /** Display label */
-    label?: string;
-    /** Unit suffix (e.g., '%', 'MB', 'credits') */
-    unit?: string;
-    /** Display variant */
-    variant?: MeterVariant;
-    /** Color thresholds */
-    thresholds?: readonly MeterThreshold[];
-    /** Number of segments (for segmented variant) */
-    segments?: number;
-    /** Show value text */
-    showValue?: boolean;
-    /** Size (for radial variant) */
-    size?: "sm" | "md" | "lg";
-    /** Actions */
-    actions?: readonly MeterAction[];
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const Meter: React.FC<MeterProps>;

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

@@ -1,36 +0,0 @@
-/**
- * Modal Molecule Component
- *
- * A modal dialog component with overlay, header, content, and footer.
- * Uses theme-aware CSS variables for styling.
- */
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-export type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
-/**
- * Layer 2 visual treatment for the modal pattern — orthogonal to the semantic
- * `size` (which conveys content scale).
- */
-export type ModalLook = "centered-card" | "top-sheet" | "side-drawer" | "full-screen";
-export interface ModalProps {
-    /** Whether the modal is open (defaults to true when rendered by slot wrapper) */
-    isOpen?: boolean;
-    /** Callback when modal should close (injected by slot wrapper) */
-    onClose?: () => void;
-    title?: string;
-    /** Modal content (can be empty if using slot content) */
-    children?: React.ReactNode;
-    footer?: React.ReactNode;
-    size?: ModalSize;
-    showCloseButton?: boolean;
-    closeOnOverlayClick?: boolean;
-    closeOnEscape?: boolean;
-    className?: string;
-    /** Declarative close event — emits UI:{closeEvent} via eventBus when modal should close */
-    closeEvent?: EventEmit<Record<string, never>>;
-    /** Enable swipe-down-to-close on mobile bottom sheet (default: true) */
-    swipeDownToClose?: boolean;
-    /** Layer 2 visual treatment — orthogonal to the semantic variant. */
-    look?: ModalLook;
-}
-export declare const Modal: React.FC<ModalProps>;

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

@@ -1,67 +0,0 @@
-/**
- * Navigation Organism Component
- *
- * A navigation component with items, active indicators, icons, and badges.
- * Uses Menu, ButtonGroup molecules and Button, Icon, Badge, Typography, Divider atoms.
- */
-import React from 'react';
-import type { IconInput } from '../atoms/index';
-import type { UiError } from '../atoms/types';
-export interface NavigationItem {
-    /**
-     * Item ID
-     */
-    id: string;
-    /**
-     * Item label
-     */
-    label: string;
-    /**
-     * Item icon
-     */
-    icon?: IconInput;
-    /**
-     * Item badge
-     */
-    badge?: string | number;
-    /**
-     * Item href
-     */
-    href?: string;
-    /**
-     * Item click handler
-     */
-    onClick?: () => void;
-    /**
-     * Is active
-     */
-    isActive?: boolean;
-    /**
-     * Disable item
-     */
-    disabled?: boolean;
-    /**
-     * Sub-menu items
-     */
-    subMenu?: NavigationItem[];
-}
-export interface NavigationProps {
-    /**
-     * Navigation items
-     */
-    items: NavigationItem[];
-    /**
-     * Navigation orientation
-     * @default 'horizontal'
-     */
-    orientation?: 'horizontal' | 'vertical';
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-}
-export declare const Navigation: React.FC<NavigationProps>;

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

@@ -1,17 +0,0 @@
-import React from 'react';
-import type { TraitConfigValue } from '@almadar/core';
-export interface NodeSlotEditorProps {
-    /** Current node-slot value (a render-ui pattern config, or nothing). */
-    value: TraitConfigValue | undefined;
-    /** Fired with the next value. */
-    onChange: (next: TraitConfigValue) => void;
-    /** Additional CSS classes. */
-    className?: string;
-}
-/**
- * NodeSlotEditor — edits a `node` config slot (e.g. `children`/`hud`/`debugPanel`).
- * A node slot renders a nested render-ui pattern, so this picks the pattern TYPE
- * from the known-pattern registry and edits that pattern's props as a tree — instead
- * of the read-only "edit in source" fallback. Self-contained `@almadar/ui` atoms.
- */
-export declare const NodeSlotEditor: React.FC<NodeSlotEditorProps>;

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>;