brix-runtime-sdk-api-web 1.0.0

package/dist/types/types/ui/adapter.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file UI Adapter Interface Definition
+ * @description Defines the core UIAdapter interface that all UI library implementations must follow
+ * @module @brix/runtime-sdk-api-web/types/ui/adapter
+ * @version 3.2.0
+ *
+ * [Architectural Constraints - v3.0.4 Blueprint]
+ * ❌ Layout components (Sidebar, Header, Layout) are FORBIDDEN in UIAdapter
+ * ❌ Direct dependency on specific UI libraries (MUI, Ant Design) in contract layer is FORBIDDEN
+ * ✅ UIAdapter only defines atomic component contracts
+ * ✅ Shell layer assembles layout using atomic components from UIAdapter
+ * ✅ Host layer selects UI adapter implementation via configuration
+ */
+import type { FC } from 'react';
+import type { ButtonProps } from './button';
+import type { InputProps } from './input';
+import type { SelectProps } from './select';
+import type { CardProps } from './card';
+import type { AvatarProps } from './avatar';
+import type { BadgeProps } from './badge';
+import type { TooltipProps } from './tooltip';
+import type { MenuProps, MenuItemProps } from './menu';
+import type { ModalProps } from './modal';
+import type { MessageAPI } from './message';
+import type { ThemeTokens, ThemeProviderProps } from './theme-tokens';
+import type { IconProps } from './icon';
+/**
+ * UI Adapter Interface
+ *
+ * Defines the contract for UI library implementations. All UI adapters
+ * (MUI, Ant Design, Native CSS) must implement this interface.
+ *
+ * **Architectural Constraints (v3.0.4 Blueprint):**
+ * - This interface only contains ATOMIC components
+ * - Layout components (Sidebar, Header, Layout) are FORBIDDEN here
+ * - Shell layer assembles layouts using these atomic components
+ * - Host layer selects adapter via configuration
+ *
+ * @example
+ * ```typescript
+ * // MUI Adapter Implementation
+ * export const muiAdapter: UIAdapter = {
+ *   Button: MuiButton,
+ *   Input: MuiInput,
+ *   Select: MuiSelect,
+ *   Card: MuiCard,
+ *   Avatar: MuiAvatar,
+ *   Badge: MuiBadge,
+ *   Tooltip: MuiTooltip,
+ *   Menu: MuiMenu,
+ *   MenuItem: MuiMenuItem,
+ *   Modal: MuiModal,
+ *   message: createMuiMessageAPI(),
+ *   ThemeProvider: MuiThemeProvider,
+ *   getThemeTokens: () => MUI_THEME_TOKENS,
+ *   Icon: MuiIcon,
+ * };
+ * ```
+ */
+export interface UIAdapter {
+    /**
+     * Button Component
+     *
+     * Primary action trigger component.
+     */
+    Button: FC<ButtonProps>;
+    /**
+     * Input Component
+     *
+     * Text input field component.
+     */
+    Input: FC<InputProps>;
+    /**
+     * Select Component
+     *
+     * Dropdown selection component.
+     */
+    Select: FC<SelectProps>;
+    /**
+     * Card Component
+     *
+     * Content container component.
+     */
+    Card: FC<CardProps>;
+    /**
+     * Avatar Component
+     *
+     * User avatar display component.
+     */
+    Avatar: FC<AvatarProps>;
+    /**
+     * Badge Component
+     *
+     * Status indicator component.
+     */
+    Badge: FC<BadgeProps>;
+    /**
+     * Tooltip Component
+     *
+     * Hover information component.
+     */
+    Tooltip: FC<TooltipProps>;
+    /**
+     * Menu Component
+     *
+     * Navigation menu list component. Used by Shell layer to assemble Sidebar.
+     */
+    Menu: FC<MenuProps>;
+    /**
+     * Menu Item Component
+     *
+     * Single menu item for custom rendering scenarios.
+     */
+    MenuItem: FC<MenuItemProps>;
+    /**
+     * Modal Component
+     *
+     * Dialog/overlay component.
+     */
+    Modal: FC<ModalProps>;
+    /**
+     * Message API
+     *
+     * Imperative toast/snackbar API.
+     */
+    message: MessageAPI;
+    /**
+     * Theme Provider Component
+     *
+     * Wraps the application to provide theme context.
+     */
+    ThemeProvider: FC<ThemeProviderProps>;
+    /**
+     * Get Theme Tokens
+     *
+     * Returns the current theme tokens for use in styled components.
+     */
+    getThemeTokens: () => ThemeTokens;
+    /**
+     * Icon Component
+     *
+     * Name-based icon lookup component.
+     */
+    Icon: FC<IconProps>;
+}
+/**
+ * UI Capability Type Symbol
+ *
+ * Symbol used to retrieve UIAdapter from RuntimeContext.
+ * Use with context.getCapability() to obtain the UI adapter instance.
+ *
+ * @example
+ * ```typescript
+ * // Get UI adapter from context
+ * const ui = context.getCapability<UIAdapter>(UICapabilityType);
+ * if (ui) {
+ *   const { Button, Menu, Icon } = ui;
+ *   // Use components...
+ * }
+ * ```
+ *
+ * @see UIAdapter
+ * @see RuntimeContext
+ */
+export declare const UICapabilityType: unique symbol;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/types/types/ui/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/types/ui/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,SAAS;IAKxB;;;;OAIG;IACH,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;IAExB;;;;OAIG;IACH,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IAEtB;;;;OAIG;IACH,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;IAMxB;;;;OAIG;IACH,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IAEpB;;;;OAIG;IACH,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;IAExB;;;;OAIG;IACH,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IAEtB;;;;OAIG;IACH,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IAQ1B;;;;OAIG;IACH,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;IAM5B;;;;OAIG;IACH,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IAEtB;;;;OAIG;IACH,OAAO,EAAE,UAAU,CAAC;IAMpB;;;;OAIG;IACH,aAAa,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAEtC;;;;OAIG;IACH,cAAc,EAAE,MAAM,WAAW,CAAC;IAMlC;;;;OAIG;IACH,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC"}

package/dist/types/types/ui/avatar.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Avatar Component Type Definitions
+ * @description Defines types for the Avatar component in the UI adapter system
+ * @module @brix/runtime-sdk-api-web/types/ui/avatar
+ * @version 3.2.0
+ */
+import type { ReactNode, CSSProperties } from 'react';
+import type { ComponentSize } from './common';
+/**
+ * Avatar Shape Variants
+ */
+export type AvatarShape = 'circle' | 'square' | 'rounded';
+/**
+ * Avatar Component Props
+ *
+ * User avatar or icon display component with various presentation options.
+ *
+ * @example
+ * ```tsx
+ * <Avatar
+ *   src={user.avatarUrl}
+ *   alt={user.name}
+ *   size="large"
+ *   fallback={user.initials}
+ * />
+ * ```
+ */
+export interface AvatarProps {
+    /**
+     * Image Source URL
+     *
+     * URL of the avatar image.
+     */
+    src?: string;
+    /**
+     * Alt Text
+     *
+     * Alternative text for accessibility.
+     */
+    alt?: string;
+    /**
+     * Fallback Content
+     *
+     * Content to display when image fails to load (e.g., initials).
+     */
+    fallback?: ReactNode;
+    /**
+     * Avatar Size
+     *
+     * Predefined size or custom pixel value.
+     * @default 'medium'
+     */
+    size?: ComponentSize | number;
+    /**
+     * Avatar Shape
+     *
+     * @default 'circle'
+     */
+    shape?: AvatarShape;
+    /**
+     * Background Color
+     *
+     * Custom background color (CSS value).
+     */
+    backgroundColor?: string;
+    /**
+     * Icon Name
+     *
+     * Icon to display when no image or fallback is provided.
+     */
+    icon?: string;
+    /**
+     * Custom Inline Styles
+     */
+    style?: CSSProperties;
+    /**
+     * Custom CSS Class Name
+     */
+    className?: string;
+    /**
+     * Avatar Content
+     *
+     * Direct content to display (e.g., text initials).
+     */
+    children?: ReactNode;
+}
+//# sourceMappingURL=avatar.d.ts.map

package/dist/types/types/ui/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../../../src/types/ui/avatar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAE9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB"}

package/dist/types/types/ui/badge.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Badge Component Type Definitions
+ * @description Defines types for the Badge component in the UI adapter system
+ * @module @brix/runtime-sdk-api-web/types/ui/badge
+ * @version 3.2.0
+ */
+import type { ReactNode, CSSProperties } from 'react';
+/**
+ * Badge Color Variants
+ */
+export type BadgeColor = 'primary' | 'secondary' | 'error' | 'warning' | 'info' | 'success';
+/**
+ * Badge Component Props
+ *
+ * Small status indicator that can be attached to other elements.
+ *
+ * @example
+ * ```tsx
+ * <Badge count={5} color="error" showZero={false}>
+ *   <Icon name="notification" />
+ * </Badge>
+ * ```
+ */
+export interface BadgeProps {
+    /**
+     * Badge Count
+     *
+     * Numeric value to display. If 0 and showZero is false, badge is hidden.
+     */
+    count?: number;
+    /**
+     * Maximum Count
+     *
+     * Maximum count to display. Exceeding values show as "max+".
+     * @default 99
+     */
+    max?: number;
+    /**
+     * Show Zero
+     *
+     * When true, displays the badge even when count is 0.
+     * @default false
+     */
+    showZero?: boolean;
+    /**
+     * Dot Mode
+     *
+     * When true, displays a simple dot instead of count.
+     * @default false
+     */
+    dot?: boolean;
+    /**
+     * Badge Color
+     *
+     * @default 'primary'
+     */
+    color?: BadgeColor;
+    /**
+     * Badge Position Offset
+     *
+     * Offset from the default position [horizontal, vertical].
+     */
+    offset?: [number, number];
+    /**
+     * Invisible Mode
+     *
+     * When true, the badge is not rendered.
+     * @default false
+     */
+    invisible?: boolean;
+    /**
+     * Custom Inline Styles
+     */
+    style?: CSSProperties;
+    /**
+     * Custom CSS Class Name
+     */
+    className?: string;
+    /**
+     * Badge Target Element
+     *
+     * The element that the badge is attached to.
+     */
+    children?: ReactNode;
+}
+//# sourceMappingURL=badge.d.ts.map

package/dist/types/types/ui/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../../src/types/ui/badge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB"}

package/dist/types/types/ui/button.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Button Component Type Definitions
+ * @description Defines types for the Button component in the UI adapter system
+ * @module @brix/runtime-sdk-api-web/types/ui/button
+ * @version 3.2.0
+ */
+import type { ReactNode, MouseEvent, CSSProperties } from 'react';
+import type { ComponentSize } from './common';
+/**
+ * Button Style Variants
+ *
+ * Defines the visual style of the button:
+ * - primary: Solid background, high emphasis
+ * - secondary: Outlined style, medium emphasis
+ * - text: Text only, low emphasis
+ * - danger: Destructive action indicator
+ */
+export type ButtonVariant = 'primary' | 'secondary' | 'text' | 'danger';
+/**
+ * Button Component Props
+ *
+ * UI library agnostic button properties. All UI adapter implementations
+ * must support these properties to ensure consistent behavior across
+ * different UI framework implementations.
+ *
+ * @example
+ * ```tsx
+ * <Button
+ *   variant="primary"
+ *   size="medium"
+ *   startIcon="save"
+ *   onClick={handleSave}
+ * >
+ *   Save Changes
+ * </Button>
+ * ```
+ */
+export interface ButtonProps {
+    /**
+     * Button Visual Variant
+     *
+     * Determines the visual style of the button.
+     * @default 'primary'
+     */
+    variant?: ButtonVariant;
+    /**
+     * Button Size
+     *
+     * Controls the button dimensions and font size.
+     * @default 'medium'
+     */
+    size?: ComponentSize;
+    /**
+     * Loading State
+     *
+     * When true, displays a loading spinner and disables interaction.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Disabled State
+     *
+     * When true, the button is non-interactive and visually dimmed.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Full Width Mode
+     *
+     * When true, the button expands to fill its container width.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * Start Icon Name
+     *
+     * Icon name to display before the button text.
+     * The actual icon is resolved by the Icon component from UIAdapter.
+     */
+    startIcon?: string;
+    /**
+     * End Icon Name
+     *
+     * Icon name to display after the button text.
+     * The actual icon is resolved by the Icon component from UIAdapter.
+     */
+    endIcon?: string;
+    /**
+     * Click Event Handler
+     *
+     * Callback fired when the button is clicked.
+     */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * HTML Button Type
+     *
+     * Native HTML button type attribute for form integration.
+     * @default 'button'
+     */
+    type?: 'button' | 'submit' | 'reset';
+    /**
+     * Custom Inline Styles
+     *
+     * CSS properties applied directly to the button element.
+     */
+    style?: CSSProperties;
+    /**
+     * Custom CSS Class Name
+     *
+     * Additional CSS class names for styling customization.
+     */
+    className?: string;
+    /**
+     * Button Content
+     *
+     * The text or elements displayed inside the button.
+     */
+    children: ReactNode;
+}
+//# sourceMappingURL=button.d.ts.map

package/dist/types/types/ui/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../../src/types/ui/button.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IAErB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAEzD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAErC;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB"}

package/dist/types/types/ui/card.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Card Component Type Definitions
+ * @description Defines types for the Card component in the UI adapter system
+ * @module @brix/runtime-sdk-api-web/types/ui/card
+ * @version 3.2.0
+ */
+import type { ReactNode, MouseEvent, CSSProperties } from 'react';
+/**
+ * Card Component Props
+ *
+ * Container component for grouping related content with optional
+ * elevation and interactive states.
+ *
+ * @example
+ * ```tsx
+ * <Card
+ *   title="User Profile"
+ *   hoverable
+ *   onClick={handleCardClick}
+ * >
+ *   <p>Card content here</p>
+ * </Card>
+ * ```
+ */
+export interface CardProps {
+    /**
+     * Card Title
+     *
+     * Optional title displayed at the top of the card.
+     */
+    title?: ReactNode;
+    /**
+     * Card Subtitle
+     *
+     * Optional subtitle displayed below the title.
+     */
+    subtitle?: ReactNode;
+    /**
+     * Elevation Level
+     *
+     * Shadow depth level. 0 means no shadow.
+     * @default 1
+     */
+    elevation?: number;
+    /**
+     * Hoverable State
+     *
+     * When true, the card shows hover effects on mouse over.
+     * @default false
+     */
+    hoverable?: boolean;
+    /**
+     * Bordered Style
+     *
+     * When true, displays a border instead of/in addition to shadow.
+     * @default false
+     */
+    bordered?: boolean;
+    /**
+     * Click Event Handler
+     *
+     * Callback fired when the card is clicked.
+     */
+    onClick?: (event: MouseEvent<HTMLDivElement>) => void;
+    /**
+     * Header Actions
+     *
+     * Action elements displayed in the card header area.
+     */
+    headerActions?: ReactNode;
+    /**
+     * Footer Content
+     *
+     * Content displayed in the card footer area.
+     */
+    footer?: ReactNode;
+    /**
+     * Custom Inline Styles
+     */
+    style?: CSSProperties;
+    /**
+     * Custom CSS Class Name
+     */
+    className?: string;
+    /**
+     * Card Content
+     */
+    children?: ReactNode;
+}
+//# sourceMappingURL=card.d.ts.map

package/dist/types/types/ui/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../../src/types/ui/card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAElE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAEtD;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB"}

package/dist/types/types/ui/common.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2026 Brix Platform Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @file Common UI Type Definitions
+ * @description Shared type definitions used across UI components
+ * @module @brix/runtime-sdk-api-web/types/ui/common
+ * @version 3.2.0
+ */
+/**
+ * Component Size Variants
+ *
+ * Standard size variants used across all UI components for visual consistency.
+ * These sizes map to specific pixel values defined by each UI adapter implementation.
+ */
+export type ComponentSize = 'small' | 'medium' | 'large';
+//# sourceMappingURL=common.d.ts.map

package/dist/types/types/ui/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/types/ui/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC"}