@almadar/ui 5.111.0 → 5.113.0

package/dist/components/avl/types/avl-behavior-compose-types.d.ts

@@ -1,120 +0,0 @@
-/**
- * AVL Behavior Compose Types
- *
- * Types for behavior-level composition canvas.
- * At this level, each node represents a BEHAVIOR (not an orbital).
- * A behavior is a higher-level unit: atom (1 orbital), molecule (1 orbital
- * with composed traits), or organism (multiple orbitals).
- *
- * Three navigation levels:
- *   Behavior (compose): One node per behavior showing AvlBehaviorGlyph
- *   Overview: One node per orbital showing live UI (OrbPreviewNode)
- *   Expanded: One node per UI state within an orbital (OrbPreviewNode)
- */
-import type { JsonObject } from '@almadar/core';
-import type { BehaviorLevel } from '../molecules/AvlBehaviorGlyph';
-/** Serializable payload field — mirrors EventPayloadField from @almadar/core. */
-export interface SerializedPayloadField extends JsonObject {
-    name: string;
-    type: string;
-    required: boolean | null;
-    description: string | null;
-}
-/** Serializable behavior glyph child — mirrors BehaviorGlyphChild from AvlBehaviorGlyph. */
-export interface SerializedGlyphChild extends JsonObject {
-    name: string;
-    fieldCount: number | null;
-    stateCount: number | null;
-    persistence: string | null;
-    effectTypes: string[];
-}
-/** Serializable behavior glyph connection — mirrors BehaviorGlyphConnection from AvlBehaviorGlyph. */
-export interface SerializedGlyphConnection extends JsonObject {
-    from: string;
-    to: string;
-    event: string;
-}
-/** Extended view level adding 'behavior' to the existing overview/expanded. */
-export type ComposeViewLevel = 'behavior' | 'overview' | 'expanded';
-/** An event that can be wired between behaviors. */
-export interface ConnectableEvent extends JsonObject {
-    /** Event name (e.g., "ADD_TO_CART"). */
-    event: string;
-    /** Typed payload fields if declared. */
-    payloadFields: SerializedPayloadField[] | null;
-    /** Vertical position hint (0..1) for handle placement on the node. */
-    positionHint: number;
-}
-/** Data for a BehaviorComposeNode in React Flow. */
-export interface BehaviorComposeNodeData extends JsonObject {
-    /** Behavior name from registry (e.g., "std-cart"). */
-    behaviorName: string;
-    /** Composition level: atom, molecule, organism. */
-    level: string;
-    /** Domain for color coding (e.g., "commerce"). */
-    domain: string | null;
-    /** Layer classification (e.g., "Domain", "UI Patterns"). */
-    layer: string | null;
-    /** Primary entity name (e.g., "CartItem"). */
-    entityName: string;
-    /** Number of states in the behavior. */
-    stateCount: number;
-    /** Number of entity fields. */
-    fieldCount: number | null;
-    /** Persistence kind. */
-    persistence: string | null;
-    /** Effect types used by this behavior. */
-    effectTypes: string[] | null;
-    /** Child behaviors for molecule/organism glyphs. */
-    children: SerializedGlyphChild[] | null;
-    /** Connections between children (for organism glyphs). */
-    connections: SerializedGlyphConnection[] | null;
-    /** Events this behavior can emit (source handles). */
-    connectableEvents: ConnectableEvent[];
-    /** Behaviors this is composable with (for palette hints). */
-    composableWith: string[] | null;
-    /** Names of orbitals produced by this behavior (for drill-down). */
-    orbitalNames: string[];
-}
-/** Edge data for behavior-level wiring. */
-export interface BehaviorWireEdgeData extends JsonObject {
-    /** The event name displayed on the edge. */
-    event: string;
-    /** Source behavior name. */
-    sourceBehavior: string;
-    /** Target behavior name. */
-    targetBehavior: string;
-    /** Typed payload fields if declared. */
-    payloadFields: SerializedPayloadField[] | null;
-}
-/** Mapping from behavior name to its metadata + produced orbitals. */
-export interface BehaviorCanvasEntry {
-    /** Behavior name (e.g., "std-cart"). */
-    behaviorName: string;
-    /** Composition level. */
-    level: BehaviorLevel;
-    /** Domain for color coding. */
-    domain?: string;
-    /** Layer classification. */
-    layer?: string;
-    /** Primary entity name. */
-    entityName: string;
-    /** Number of states. */
-    stateCount: number;
-    /** Number of entity fields. */
-    fieldCount?: number;
-    /** Persistence kind. */
-    persistence?: string;
-    /** Effect types used. */
-    effectTypes?: string[];
-    /** Child behaviors (molecule/organism). */
-    children?: SerializedGlyphChild[];
-    /** Connections between children (organism). */
-    connections?: SerializedGlyphConnection[];
-    /** Events available for wiring. */
-    connectableEvents: ConnectableEvent[];
-    /** Compatible behavior names. */
-    composableWith?: string[];
-    /** Orbital names produced by this behavior (for drill-down mapping). */
-    orbitalNames: string[];
-}

package/dist/components/avl/types/avl-canvas-types.d.ts

@@ -1,39 +0,0 @@
-/**
- * AVL Canvas Types
- *
- * Types for the unified AVL + Flow canvas. These define the data shapes
- * for React Flow nodes and edges that render AVL primitives.
- */
-import type { JsonObject } from '@almadar/core';
-import type { FieldInfo, OrbitalTraitInfo, OrbitalPageInfo, ExternalLink, TraitLevelData } from '../lib/avl-schema-parser';
-/** The four zoom bands of the unified AVL canvas. */
-export type ZoomBand = 'system' | 'module' | 'behavior' | 'detail';
-/** Thresholds for zoom band transitions (React Flow viewport zoom). */
-export declare const ZOOM_BAND_THRESHOLDS: {
-    readonly system: readonly [0.1, 0.4];
-    readonly module: readonly [0.4, 1];
-    readonly behavior: readonly [1, 2.5];
-    readonly detail: readonly [2.5, 5];
-};
-/** Data carried by every orbital node in the unified canvas. */
-export interface AvlNodeData extends JsonObject {
-    orbitalName: string;
-    entityName: string;
-    persistence: string;
-    fields: FieldInfo[];
-    traits: OrbitalTraitInfo[];
-    pages: OrbitalPageInfo[];
-    traitDetails: {
-        [k: string]: TraitLevelData;
-    };
-    externalLinks: ExternalLink[];
-}
-/** Edge kind determines visual style. */
-export type AvlEdgeKind = 'eventWire' | 'page';
-/** Data carried by edges in the unified canvas. */
-export interface AvlEdgeData extends JsonObject {
-    edgeKind: string;
-    event: string | null;
-    fromTrait: string | null;
-    toTrait: string | null;
-}

package/dist/components/avl/types/avl-preview-types.d.ts

@@ -1,240 +0,0 @@
-/**
- * AVL Preview Types
- *
- * Types for the V3 FlowCanvas: UI projection mode.
- * Nodes show rendered UI thumbnails, edges show events.
- * Two levels: overview (one node per orbital) and expanded (one node per UI state).
- *
- * Uses @almadar/core types for schema-level constructs.
- */
-import type { Expression, EntityData, OrbitalSchema, UISlot } from '@almadar/core';
-import type { AnyPatternConfig } from '@almadar/patterns';
-/**
- * The navigation levels of the FlowCanvas.
- *
- * - `overview` (L1) — one card per orbital, showing the orbital's composed
- *   render-ui at INIT.
- * - `expanded` (L2) — one card per organism-authored transition + one
- *   grouped card per imported-behavior alias.
- * - `behavior-expanded` (L3) — drilled into a single imported behavior at
- *   L2: one card per transition of THAT behavior. Used to inspect what an
- *   import contributes without leaving the canvas.
- * - `trait-expanded` — one card per trait of a single orbital, connected
- *   by intra-orbital `emits → listens` edges. Used by the cosmic tab to
- *   render the trait-level circuit when the user drills into an orbital
- *   from the L1 grid. Not used by the canvas tab today.
- */
-export type ViewLevel = 'overview' | 'expanded' | 'behavior-expanded' | 'trait-expanded';
-/**
- * Screen size preset for OrbPreview rendering inside nodes.
- *
- * Aligned with the four-breakpoint responsiveness audit:
- *   mobile  — phone portrait  (≤640px)
- *   tablet  — iPad / small landscape (641–1024px)
- *   laptop  — 13–15" notebook (1025–1440px)
- *   wide    — desktop / monitor (≥1441px)
- *
- * Preset widths are representative viewport widths within each range; the
- * preview renders at exactly this width so the embedded UI experiences
- * the same media-query / container-query behavior it would at the real
- * viewport. `minHeight` only floors the preview frame; vertical sizing is
- * content-driven (BrowserPlayground height="auto").
- */
-export type ScreenSize = 'mobile' | 'tablet' | 'laptop' | 'wide';
-export declare const SCREEN_SIZE_PRESETS: Record<ScreenSize, {
-    width: number;
-    minHeight: number;
-    label: string;
-    icon: string;
-}>;
-/**
- * Map a raw viewport width (px) to the nearest preset. Used by FlowCanvas
- * to auto-pick the default ScreenSize based on the user's actual canvas
- * pane width on mount + on window resize. The breakpoint edges match the
- * responsiveness-audit tiers exactly (640 / 1024 / 1440) so what the
- * preview renders matches the tier the audit graded against.
- */
-export declare function detectScreenSize(viewportWidth: number): ScreenSize;
-/**
- * An interactive element inside a render-ui pattern that fires an event.
- * For example, a button with `event: "CHECKOUT"` is an event source.
- * These are used to draw edges from the specific trigger element to the
- * target screen, making the prototype flow concrete.
- */
-export interface PatternEventSource {
-    /** The event name fired by this element (e.g., "CHECKOUT"). */
-    event: string;
-    /** The pattern type of the trigger element (e.g., "button", "link", "icon-button"). */
-    patternType: string;
-    /** Human label if available (e.g., "Checkout", "Submit"). */
-    label?: string;
-    /**
-     * Path within the pattern tree (e.g., "children.2" means third child).
-     * Used to position the handle near the trigger element.
-     */
-    path: string;
-    /** Vertical position hint (0..1) for handle placement on the node. */
-    positionHint: number;
-    /** Typed payload fields if this event carries data. */
-    payloadFields?: Array<{
-        name: string;
-        type: string;
-        required?: boolean;
-    }>;
-}
-/** A slot + pattern config pair extracted from a render-ui effect. */
-export interface RenderUIEntry {
-    slot: UISlot | string;
-    pattern: AnyPatternConfig;
-}
-/** Data for a preview node (used at both overview and expanded levels). */
-export interface PreviewNodeData {
-    [key: string]: string | number | boolean | string[] | Expression | null | RenderUIEntry[] | PatternEventSource[] | Array<{
-        event: string;
-        fromState: string;
-        toState: string;
-    }> | OrbitalSchema | EntityData | undefined;
-    /** Orbital this node belongs to. */
-    orbitalName: string;
-    /** Trait name (only at expanded level). */
-    traitName?: string;
-    /** State name after this transition fires (expanded level). */
-    stateName?: string;
-    /** Event that triggers this transition (expanded level). */
-    transitionEvent?: string;
-    /** From state (expanded level). */
-    fromState?: string;
-    /** To state (expanded level). */
-    toState?: string;
-    /**
-     * Render-ui patterns extracted from the transition's effects.
-     * Each entry is a slot + pattern config pair.
-     */
-    patterns: RenderUIEntry[];
-    /**
-     * Interactive elements within the patterns that fire events.
-     * Each one becomes a source handle on the node, allowing edges
-     * to connect from the specific button/link to the target screen.
-     */
-    eventSources: PatternEventSource[];
-    /** Behavior layer for visual indicator (color band). */
-    layer?: string;
-    /** State role for visual indicator. */
-    stateRole?: 'initial' | 'terminal' | 'hub' | 'error' | 'default';
-    /** All effect types on this transition (for overlay). */
-    effectTypes?: string[];
-    /** Guard expression (for overlay). */
-    guard?: Expression | null;
-    entityName?: string;
-    persistence?: string;
-    fieldCount?: number;
-    traitCount?: number;
-    pageRoutes?: string[];
-    /**
-     * Generation status for this orbital. When `'running'`, the overview node
-     * renders a spinner overlay + accent border so the user can see which
-     * orbital the coordinator is currently dispatching to. Other states are
-     * available so consumers can also paint success/error treatments
-     * (e.g. green border on completion, red on failure). Default is `'idle'`.
-     *
-     * Set by FlowCanvasProps.orbitalStatus and threaded through the converter.
-     * Future expansion: hover over a `'running'` node to surface the subagent
-     * trace inline.
-     */
-    status?: 'idle' | 'running' | 'success' | 'error';
-    /**
-     * The `OrbitalSchema.name` this node was derived from. The reserved value
-     * `'__design_system__'` identifies nodes belonging to the Design System
-     * tab's synthesized catalog schema, so downstream event handlers can route
-     * mutation events to the project theme manifest instead of the project's
-     * orbital schema. Unset for project orbitals — handlers treat absence as
-     * "project schema".
-     */
-    sourceSchemaName?: string;
-    /**
-     * Set when this L2 card represents a grouped imported-behavior bucket
-     * (one card per `uses[]` alias instead of one per transition). The alias
-     * comes from `Trait.sourceBehavior.alias` populated by the inline phase.
-     * Double-clicking such a card drills into L3 (`behavior-expanded`) to
-     * see that alias's transitions.
-     *
-     * Absent on organism-authored transition cards and L1 overview cards.
-     */
-    behaviorAlias?: string;
-    /**
-     * Human-readable behavior name for a grouped imported-behavior card
-     * (e.g. `'std/behaviors/std-stat-card'`). Comes from
-     * `Trait.sourceBehavior.behavior`. Renderer surfaces it as a label.
-     */
-    behaviorName?: string;
-    /**
-     * How many transitions are collapsed into this grouped imported-behavior
-     * card. Renderer can surface it as a "+N screens" badge.
-     */
-    transitionCount?: number;
-    /**
-     * Discriminator for the node variant. Absent on overview/expanded/
-     * behavior-expanded cards (those use field-presence-based discrimination
-     * via `behaviorAlias`/`transitionEvent`). Set to `'trait-card'` for nodes
-     * produced by `orbitalToTraitGraph` so renderers can branch cleanly.
-     */
-    kind?: 'trait-card';
-    /**
-     * Trait-card transitions (`kind === 'trait-card'` only). One row per
-     * transition; each row is clickable and drills to L4 transition detail
-     * in cosmic. `event` is the trigger; `fromState` / `toState` mirror the
-     * underlying state-machine edge.
-     */
-    transitions?: Array<{
-        event: string;
-        fromState: string;
-        toState: string;
-    }>;
-    /**
-     * Trait-card `emits` event names (`kind === 'trait-card'` only). One
-     * source handle per entry on the right edge of the card. Drives the
-     * outgoing wire endpoints in `orbitalToTraitGraph`.
-     */
-    emits?: string[];
-    /**
-     * Trait-card `listens` event names (`kind === 'trait-card'` only). One
-     * target handle per entry on the left edge of the card. Drives the
-     * incoming wire endpoints in `orbitalToTraitGraph`.
-     */
-    listens?: string[];
-    /**
-     * Trait-card `linkedEntity` (`kind === 'trait-card'` only). Surfaced as a
-     * subtitle/badge next to the trait name so users can see what entity the
-     * trait operates on. Mirrors `Trait.linkedEntity` from the resolved schema.
-     */
-    linkedEntity?: string;
-    /** Full parsed schema threaded to node renderers (e.g. TraitCardNode). */
-    _fullSchema?: OrbitalSchema;
-    /** Mock entity data for the orbital preview. */
-    _mockData?: EntityData;
-}
-/** Data for event flow edges. */
-export interface EventEdgeData {
-    [key: string]: string | boolean | undefined;
-    /** The event name displayed on the edge. */
-    event: string;
-    /** Source state name (expanded level). */
-    fromState?: string;
-    /** Target state name (expanded level). */
-    toState?: string;
-    /** Whether this is a backward/retry transition. */
-    isBackward?: boolean;
-    /** Whether this is a cross-orbital event wire (overview level). */
-    isCrossOrbital?: boolean;
-    /** Source trait (for cross-orbital wires). */
-    fromTrait?: string;
-    /** Target trait (for cross-orbital wires). */
-    toTrait?: string;
-    /**
-     * The pattern type that triggers this event (e.g., "button").
-     * Displayed on the edge label for context.
-     */
-    triggerPatternType?: string;
-    /** The trigger element's label (e.g., "Checkout"). */
-    triggerLabel?: string;
-}

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

@@ -1,15 +0,0 @@
-/**
- * Aside Atom Component
- *
- * Semantic wrapper for the native `<aside>` landmark. Owns raw HTML so
- * molecules (SidePanel, navigation rails, callouts) can compose the
- * semantic-aside primitive without falling back to a raw element.
- */
-import React from "react";
-export interface AsideProps extends React.HTMLAttributes<HTMLElement> {
-    /** Additional CSS classes */
-    className?: string;
-    /** Aside contents */
-    children?: React.ReactNode;
-}
-export declare const Aside: React.ForwardRefExoticComponent<AsideProps & React.RefAttributes<HTMLElement>>;

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

@@ -1,58 +0,0 @@
-import * as React from 'react';
-import { type SpriteRef } from '../../../lib/atlasSlice';
-/** Asset-compatible input: sheet url + optional atlas sub-texture reference. */
-export interface AtlasImageAsset extends SpriteRef {
-    name?: string;
-    category?: string;
-}
-export interface AtlasImageProps {
-    asset?: AtlasImageAsset;
-    /** Square pixel size (icon usage). Ignored when `fill`. */
-    size?: number;
-    width?: number;
-    height?: number;
-    /** Absolutely fill the nearest positioned ancestor (background usage). */
-    fill?: boolean;
-    fit?: 'contain' | 'cover' | 'fill';
-    alt?: string;
-    className?: string;
-    style?: React.CSSProperties;
-    'aria-hidden'?: boolean;
-}
-/**
- * Resolve an atlas slice to a standalone dataURL (extracted once, cached) so CSS can 9-slice or
- * tile it — `border-image`/`background-repeat` can't crop a packed sheet. Returns undefined until
- * the sheet + atlas are loaded; `onReady` re-fires the caller when they land.
- */
-export declare function useAtlasSliceDataUrl(asset: AtlasImageAsset | undefined): string | undefined;
-export interface AtlasPanelProps {
-    asset?: AtlasImageAsset;
-    /** Border thickness (source pixels) for the 9-slice cut. */
-    borderSlice?: number;
-    /** Rendered border width in CSS px. */
-    borderWidth?: number;
-    /** 'nineSlice' scales edges crisp (panels/buttons); 'repeat' tiles the slice (pattern fills). */
-    mode?: 'nineSlice' | 'repeat';
-    className?: string;
-    style?: React.CSSProperties;
-    children?: React.ReactNode;
-    'aria-hidden'?: boolean;
-}
-/**
- * A container skinned by an atlas slice: 9-sliced panel chrome or a tiled pattern. The pack sheet
- * is cropped once to a dataURL; CSS border-image / background-repeat does the scaling. Falls back
- * to a plain container while the sheet/atlas load.
- */
-export declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden }: AtlasPanelProps): React.JSX.Element;
-export declare namespace AtlasPanel {
-    var displayName: string;
-}
-/**
- * The one chrome-side renderer for `Asset` images. With `atlas`+`sprite` it draws EXACTLY that
- * sub-rect of the packed sheet into a canvas (never the whole sheet); otherwise it renders the
- * plain `<img>` path. `fill` + `fit` cover background/panel usage (GameShell, card frames).
- */
-export declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, }: AtlasImageProps): React.JSX.Element | null;
-export declare namespace AtlasImage {
-    var displayName: string;
-}

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

@@ -1,61 +0,0 @@
-/**
- * Avatar Atom Component
- *
- * A versatile avatar component supporting images, initials, icons, and status indicators.
- */
-import React from "react";
-import type { AssetUrl, EventKey, EventPayload } from "@almadar/core";
-import { type IconInput } from "./Icon";
-export type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
-export type AvatarStatus = "online" | "offline" | "away" | "busy";
-export interface AvatarProps {
-    /**
-     * Image source URL
-     */
-    src?: AssetUrl;
-    /**
-     * Alt text for the image
-     */
-    alt?: string;
-    /**
-     * Full name - initials will be generated automatically
-     */
-    name?: string;
-    /**
-     * Initials to display (e.g., "JD" for John Doe)
-     * If not provided but name is, initials will be auto-generated
-     */
-    initials?: string;
-    /**
-     * Icon to display when no image or initials. Accepts a Lucide component
-     * directly, or a canonical kebab-case icon name string (resolved via
-     * `resolveIcon`) so trait/factory authors can pass an icon by name.
-     */
-    icon?: IconInput;
-    /**
-     * Size of the avatar
-     * @default 'md'
-     */
-    size?: AvatarSize;
-    /**
-     * Status indicator
-     */
-    status?: AvatarStatus;
-    /**
-     * Badge content (e.g., notification count)
-     */
-    badge?: string | number;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /**
-     * Click handler
-     */
-    onClick?: () => void;
-    /** Declarative event name — emits UI:{action} via eventBus on click */
-    action?: EventKey;
-    /** Payload to include with the action event */
-    actionPayload?: EventPayload;
-}
-export declare const Avatar: React.FC<AvatarProps>;

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

@@ -1,29 +0,0 @@
-import React from "react";
-import { type IconInput } from "./Icon";
-import type { Asset } from "@almadar/core";
-export type BadgeVariant = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral";
-export type BadgeSize = "sm" | "md" | "lg";
-export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
-    /** Additional CSS classes applied to the root element. */
-    className?: string;
-    variant?: BadgeVariant;
-    size?: BadgeSize;
-    /** Numeric count or amount to display in badge */
-    amount?: number;
-    /** Badge label text (alternative to children for schema-driven rendering).
-     *  Numeric values are auto-coerced to string for rendering — common case
-     *  is unread counts, error counts, status codes, etc. */
-    label?: string | number;
-    /** Lucide icon component or canonical kebab-case icon name string */
-    icon?: IconInput;
-    /** Asset image rendered as the badge icon; takes precedence over icon when provided. */
-    iconAsset?: Asset;
-    /** When set, renders a small X button on the right of the badge that
-     *  invokes this handler — turns the badge into a removable chip.
-     *  Used by the TagInput molecule and other "list of removable values"
-     *  surfaces. */
-    onRemove?: () => void;
-    /** Accessible label for the remove button. Defaults to "Remove". */
-    removeLabel?: string;
-}
-export declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;

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

@@ -1,68 +0,0 @@
-/**
- * Box Component
- *
- * A versatile layout primitive that provides spacing, background, border, and shadow controls.
- * Think of it as a styled div with consistent design tokens.
- */
-import React from "react";
-import type { EventKey, EventPayload } from "@almadar/core";
-export type BoxPadding = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
-export type BoxMargin = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "auto";
-export type BoxBg = "transparent" | "primary" | "secondary" | "muted" | "accent" | "surface" | "overlay";
-export type BoxRounded = "none" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
-export type BoxShadow = "none" | "sm" | "md" | "lg" | "xl";
-export interface BoxProps extends React.HTMLAttributes<HTMLDivElement> {
-    /** Additional CSS classes applied to the root element. */
-    className?: string;
-    /** Data-theme attribute applied to the root element for CSS theme scoping (e.g. almadar-website-dark). */
-    'data-theme'?: string;
-    /** Padding on all sides */
-    padding?: BoxPadding;
-    /** Horizontal padding (overrides padding for x-axis) */
-    paddingX?: BoxPadding;
-    /** Vertical padding (overrides padding for y-axis) */
-    paddingY?: BoxPadding;
-    /** Margin on all sides */
-    margin?: BoxMargin;
-    /** Horizontal margin */
-    marginX?: BoxMargin;
-    /** Vertical margin */
-    marginY?: BoxMargin;
-    /** Background color */
-    bg?: BoxBg;
-    /** Show border */
-    border?: boolean;
-    /** Border radius */
-    rounded?: BoxRounded;
-    /** Box shadow */
-    shadow?: BoxShadow;
-    /** Display type */
-    display?: "block" | "inline" | "inline-block" | "flex" | "inline-flex" | "grid";
-    /** Fill available width */
-    fullWidth?: boolean;
-    /** Fill available height */
-    fullHeight?: boolean;
-    /** Overflow behavior */
-    overflow?: "auto" | "hidden" | "visible" | "scroll";
-    /** Position */
-    position?: "relative" | "absolute" | "fixed" | "sticky";
-    /** HTML element to render as */
-    as?: React.ElementType;
-    /** Declarative event name — emits UI:{action} via eventBus on click */
-    action?: EventKey;
-    /** Payload to include with the action event */
-    actionPayload?: EventPayload;
-    /** Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave */
-    hoverEvent?: EventKey;
-    /** When true (default), a touch/pen tap also fires `hoverEvent` (toggling hovered) so hover-only reveals work on touch. */
-    tapReveal?: boolean;
-    /** Maximum width (CSS value, e.g., "550px", "80rem") */
-    maxWidth?: string;
-    /** Children elements */
-    children?: React.ReactNode;
-}
-/**
- * Box - Versatile container component with design tokens
- */
-export declare const Box: React.ForwardRefExoticComponent<BoxProps & React.RefAttributes<HTMLDivElement>>;
-export default Box;

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

@@ -1,33 +0,0 @@
-import React from "react";
-import type { Asset, EventKey, EventPayload } from "@almadar/core";
-import { type IconInput } from "./Icon";
-export type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "success" | "warning" | "default";
-export type ButtonSize = "sm" | "md" | "lg";
-export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-    /** Additional CSS classes applied to the root element. */
-    className?: string;
-    variant?: ButtonVariant;
-    size?: ButtonSize;
-    isLoading?: boolean;
-    /** Left icon: a Lucide component or a canonical icon name string (e.g. "plus", "trash"). */
-    leftIcon?: IconInput;
-    /** Right icon: a Lucide component or a canonical icon name string. */
-    rightIcon?: IconInput;
-    /** Alias for leftIcon */
-    icon?: IconInput;
-    /** Alias for rightIcon */
-    iconRight?: IconInput;
-    /** Asset image rendered as the leading icon; takes precedence over icon/leftIcon when provided. */
-    iconAsset?: Asset;
-    /** Declarative event name — emits UI:{action} via eventBus on click */
-    action?: EventKey;
-    /** Payload to include with the action event */
-    actionPayload?: EventPayload;
-    /** Button label text (alternative to children for schema-driven rendering) */
-    label?: string;
-    /** Disable the button (greys out, blocks click events) */
-    disabled?: boolean;
-    /** Test identifier for automated tests */
-    'data-testid'?: string;
-}
-export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;