@almadar/ui 5.111.0 → 5.113.0

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,38 +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;
-    /** If provided, only fields whose `@tier` is in this list are rendered. */
-    tiers?: ReadonlyArray<string>;
-}
-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>;

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

@@ -1,43 +0,0 @@
-/**
- * RichBlockEditor Organism Component
- *
- * Notion / Lexical-style block authoring editor. Internal state owns the
- * block tree; contentEditable spans flow updates back through onInput.
- *
- * TODO(phase-11): collaboration / undo-redo / markdown export are out of
- * scope for the Phase 10 scaffold.
- */
-import React from "react";
-import type { EntityRow, EventEmit, EventPayloadValue } from '@almadar/core';
-export type BlockType = "paragraph" | "heading-1" | "heading-2" | "heading-3" | "bullet-list" | "numbered-list" | "quote" | "code" | "divider" | "image";
-export interface RichBlock {
-    id: string;
-    type: BlockType;
-    content?: string;
-    metadata?: Record<string, string | number | boolean>;
-    children?: RichBlock[];
-    [key: string]: EventPayloadValue;
-}
-export interface RichBlockEditorProps {
-    /**
-     * Initial block payload — the rows that orb-bound traits emit. Items missing
-     * id/type are normalized into paragraph blocks at mount.
-     */
-    initialBlocks?: readonly EntityRow[];
-    onChange?: (blocks: RichBlock[]) => void;
-    changeEvent?: EventEmit<{
-        blocks: RichBlock[];
-    }>;
-    readOnly?: boolean;
-    placeholder?: string;
-    /**
-     * Opt-in to the Notion-style block authoring chrome (insert toolbar, per-row
-     * +/menu gutter, turn-into menu). Off by default: the editor renders as a
-     * plain rich text surface that edits block content inline without any
-     * add-block affordances.
-     */
-    enableBlocks?: boolean;
-    showToolbar?: boolean;
-    className?: string;
-}
-export declare const RichBlockEditor: React.FC<RichBlockEditorProps>;

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

@@ -1,20 +0,0 @@
-/**
- * ScaledDiagram Molecule
- *
- * Wraps a fixed-size diagram (like JazariStateMachine / StateMachineView)
- * and CSS-scales it to fit the parent container width.
- *
- * The diagram renders at its natural (large) size. We observe the content
- * element and once the diagram is measured we apply transform:scale() with
- * a corrected container height so surrounding layout flows correctly.
- *
- * Event Contract:
- * - No events emitted (layout-only wrapper)
- * - entityAware: false
- */
-import React from 'react';
-export interface ScaledDiagramProps {
-    children: React.ReactNode;
-    className?: string;
-}
-export declare const ScaledDiagram: React.FC<ScaledDiagramProps>;

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

@@ -1,60 +0,0 @@
-/**
- * SearchInput Molecule Component
- *
- * A search input component with icon, clear button, and loading state.
- * Uses Input, Icon, Button, and Spinner atoms.
- *
- * Supports Query Singleton pattern via `query` prop for std/Search behavior.
- */
-import React from 'react';
-export interface SearchInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type'> {
-    /**
-     * Search value (controlled mode)
-     */
-    value?: string;
-    /**
-     * Callback when search value changes
-     */
-    onSearch?: (value: string) => void;
-    /**
-     * Debounce delay in milliseconds
-     * @default 300
-     */
-    debounceMs?: number;
-    /**
-     * Show loading state
-     * @default false
-     */
-    isLoading?: boolean;
-    /**
-     * Placeholder text
-     * @default 'Search...'
-     */
-    placeholder?: string;
-    /**
-     * Show clear button
-     * @default true
-     */
-    clearable?: boolean;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /**
-     * Event name to dispatch on search (schema metadata, wired by trait)
-     * This is metadata used by the trait generator, not by the component.
-     */
-    event?: string;
-    /**
-     * Entity type for context-aware search.
-     * When provided, search events include entity context.
-     */
-    entity?: string;
-    /**
-     * Query singleton binding for state management.
-     * When provided, syncs search state with the query singleton.
-     * Example: "@TaskQuery"
-     */
-    query?: string;
-}
-export declare const SearchInput: React.FC<SearchInputProps>;

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

@@ -1,43 +0,0 @@
-/**
- * Section Component
- *
- * A semantic section wrapper with optional title, description, and action.
- * Perfect for grouping related content with consistent spacing.
- */
-import React from 'react';
-import type { UiError } from '../atoms/types';
-export type SectionPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
-export type SectionVariant = 'default' | 'card' | 'bordered' | 'filled';
-export interface SectionProps {
-    /** Section title */
-    title?: string;
-    /** Section subtitle/description */
-    description?: string;
-    /** Action element (e.g., button, link) */
-    action?: React.ReactNode;
-    /** Padding amount */
-    padding?: SectionPadding;
-    /** Visual variant */
-    variant?: SectionVariant;
-    /** Show divider below header */
-    divider?: boolean;
-    /** Custom class name */
-    className?: string;
-    /** Children elements */
-    children: React.ReactNode;
-    /** Header custom class name */
-    headerClassName?: string;
-    /** Content custom class name */
-    contentClassName?: string;
-    /** HTML element to render as */
-    as?: React.ElementType;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-}
-/**
- * Section - Semantic content grouping with header
- */
-export declare const Section: React.FC<SectionProps>;
-export default Section;

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

@@ -1,53 +0,0 @@
-/**
- * SidePanel — fixed side panel for contextual detail on top of the page layout.
- * Distinct from Drawer: Drawer is driven by the UI Slot system (render_ui drawer)
- * and is generic. SidePanel is a direct-render component with its own close event
- * API, used where the panel is always present in the component tree.
- */
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-export interface SidePanelProps {
-    /**
-     * Panel title
-     */
-    title: string;
-    /**
-     * Panel content
-     */
-    children: React.ReactNode;
-    /**
-     * Is panel open
-     */
-    isOpen: boolean;
-    /**
-     * On close handler
-     */
-    onClose: () => void;
-    /**
-     * Panel width as Tailwind class string. Default fills the viewport on
-     * mobile and snaps to `w-96` (384 px) at `sm:` and above so phones
-     * don't lose content to a fixed 384 px column. Consumers passing a
-     * custom value should include a `w-full` mobile fallback in the same
-     * string (e.g. `"w-full sm:w-[480px]"`) — Tailwind's JIT can't see
-     * dynamically-concatenated class names.
-     * @default 'w-full sm:w-96'
-     */
-    width?: string;
-    /**
-     * Panel position
-     * @default 'right'
-     */
-    position?: "left" | "right";
-    /**
-     * Show overlay on mobile
-     * @default true
-     */
-    showOverlay?: boolean;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /** Declarative close event — emits UI:{closeEvent} via eventBus when panel should close */
-    closeEvent?: EventEmit<Record<string, never>>;
-}
-export declare const SidePanel: React.FC<SidePanelProps>;

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

@@ -1,72 +0,0 @@
-/**
- * Sidebar Organism Component
- *
- * A sidebar component with logo, navigation items, user section, and collapse/expand.
- * Styled to match the main Layout component with theme-aware CSS variables.
- *
- * Events:
- * - collapseChangeEvent — emitted when sidebar collapse state changes, payload: { collapsed: boolean }
- * - closeEvent — emitted when close button clicked (mobile)
- * - logoClickEvent — emitted when logo/brand area clicked
- */
-import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IconInput } from '../atoms/index';
-import type { UiError } from '../atoms/types';
-export interface SidebarItem {
-    /** Item ID */
-    id: string;
-    /** Item label */
-    label: string;
-    /** Item icon — Lucide icon name or component */
-    icon?: IconInput;
-    /** Item badge */
-    badge?: string | number;
-    /** Item href */
-    href?: string;
-    /** Item click handler */
-    onClick?: () => void;
-    /** Is active */
-    active?: boolean;
-    /** @deprecated Use `active` instead */
-    isActive?: boolean;
-    /** Sub-items (for nested navigation) */
-    subItems?: SidebarItem[];
-}
-export interface SidebarProps {
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Logo/Brand content - can be a ReactNode or logo config */
-    logo?: React.ReactNode;
-    /** Logo image source */
-    logoSrc?: AssetUrl;
-    /** Brand/App name */
-    brandName?: string;
-    /** Navigation items */
-    items: SidebarItem[];
-    /** User section content */
-    userSection?: React.ReactNode;
-    /** Footer content (e.g., theme toggle) */
-    footerContent?: React.ReactNode;
-    /** Collapsed state (controlled) */
-    collapsed?: boolean;
-    /** Default collapsed state */
-    defaultCollapsed?: boolean;
-    /** Event emitted when collapse state changes, payload: { collapsed: boolean } */
-    collapseChangeEvent?: EventEmit<{
-        collapsed: boolean;
-    }>;
-    /** Hide the collapse/expand button */
-    hideCollapseButton?: boolean;
-    /** Show a close button (for mobile) */
-    showCloseButton?: boolean;
-    /** Event emitted when close button is clicked */
-    closeEvent?: EventEmit<Record<string, never>>;
-    /** Event emitted when logo/brand is clicked */
-    logoClickEvent?: EventEmit<Record<string, never>>;
-}
-export declare const Sidebar: React.FC<SidebarProps>;