@mt-gloss/ui 0.0.9 → 0.0.10

package/lib/composites/inputs/MultiSelect.d.ts

@@ -0,0 +1,38 @@
+import { default as React } from 'react';
+export interface MultiSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface MultiSelectProps {
+    /** Available options */
+    options: MultiSelectOption[];
+    /** Currently selected values */
+    value: string[];
+    /** Called when selection changes */
+    onChange: (values: string[]) => void;
+    /** Custom tag chip rendering for selected values */
+    tagSlot?: (option: MultiSelectOption, onRemove: () => void) => React.ReactNode;
+    /** Custom dropdown option rendering */
+    dropdownSlot?: (option: MultiSelectOption, isSelected: boolean) => React.ReactNode;
+    /** Content when no options available */
+    emptySlot?: React.ReactNode;
+    placeholder?: string;
+    label?: string;
+    helperText?: string;
+    error?: boolean;
+    errorText?: string;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    maxSelected?: number;
+    searchable?: boolean;
+    className?: string;
+}
+/**
+ * MultiSelect composite -- multi-value select with tag chips, dropdown,
+ * and keyboard navigation. Uses named slot props (no children).
+ */
+export declare function MultiSelect(props: MultiSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace MultiSelect {
+    var displayName: string;
+}

package/lib/composites/inputs/index.d.ts

@@ -0,0 +1,8 @@
+export { FilterChip } from './FilterChip';
+export type { FilterChipProps, FilterValue } from './FilterChip';
+export { Autocomplete } from './Autocomplete';
+export type { AutocompleteProps } from './Autocomplete';
+export { MultiSelect } from './MultiSelect';
+export type { MultiSelectProps, MultiSelectOption } from './MultiSelect';
+export { EntityPicker } from './EntityPicker';
+export type { EntityPickerProps, EntityPickerEntity } from './EntityPicker';

package/lib/composites/navigation/Stepper.d.ts

@@ -0,0 +1,40 @@
+import { default as React } from 'react';
+export type StepStatus = 'completed' | 'active' | 'upcoming' | 'error';
+export interface StepDefinition {
+    key: string;
+    label: string;
+    description?: string;
+}
+export interface StepperProps {
+    /** Step definitions */
+    steps: StepDefinition[];
+    /** Current active step index (0-based) */
+    activeStep: number;
+    /** Called before advancing -- return false to block */
+    onStepValidate?: (stepIndex: number) => boolean | Promise<boolean>;
+    /** Called when step changes */
+    onStepChange?: (stepIndex: number) => void;
+    /** Custom step indicator rendering */
+    stepSlot?: (step: StepDefinition, status: StepStatus, index: number) => React.ReactNode;
+    /** Content for each step (keyed by step index) */
+    contentSlot: (stepIndex: number) => React.ReactNode;
+    /** Custom action buttons (replaces default next/back) */
+    actionSlot?: (stepIndex: number, helpers: {
+        goNext: () => void;
+        goBack: () => void;
+        isFirst: boolean;
+        isLast: boolean;
+    }) => React.ReactNode;
+    /** Step indicator layout */
+    orientation?: 'horizontal' | 'vertical';
+    /** Additional class name */
+    className?: string;
+}
+/**
+ * Stepper composite -- numbered steps with linear progression, validation,
+ * and named slots for custom step indicators, content, and actions.
+ */
+export declare function Stepper(props: StepperProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Stepper {
+    var displayName: string;
+}

package/lib/composites/navigation/index.d.ts

@@ -0,0 +1,2 @@
+export { Stepper } from './Stepper';
+export type { StepperProps, StepDefinition } from './Stepper';

package/lib/composites/overlay/Dropdown/Dropdown.d.ts

@@ -0,0 +1,22 @@
+import { default as React } from 'react';
+export interface DropdownItem {
+    label: string;
+    value: string;
+    icon?: string;
+}
+export interface DropdownProps {
+    trigger?: React.ReactNode;
+    items: DropdownItem[];
+    value?: string;
+    onChange?: (value: string) => void;
+}
+/**
+ * Dropdown -- Composite tier. Self-contained dropdown with trigger and menu.
+ * Orchestrates trigger + menu primitives. Strips className/style from consumer API.
+ */
+export declare function Dropdown(props: DropdownProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Dropdown {
+    var displayName: string;
+}
+export { Dropdown as PresetDropdown };
+export type { DropdownProps as PresetDropdownProps };

package/lib/composites/overlay/Dropdown/index.d.ts

@@ -0,0 +1,2 @@
+export { Dropdown, type DropdownProps, type DropdownItem } from './Dropdown';
+export { Dropdown as PresetDropdown, type DropdownProps as PresetDropdownProps } from './Dropdown';

package/lib/composites/overlay/FormDialog.d.ts

@@ -0,0 +1,38 @@
+import { default as React } from 'react';
+export interface FormDialogProps {
+    /** Control open state */
+    open: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Submit handler -- called when submit button clicked */
+    onSubmit?: () => void | Promise<void>;
+    /** Cancel handler (defaults to onClose) */
+    onCancel?: () => void;
+    /** Dialog title */
+    title: string;
+    /** Submit button label */
+    submitLabel?: string;
+    /** Cancel button label */
+    cancelLabel?: string;
+    /** Visual variant */
+    variant?: 'default' | 'destructive';
+    /** Dialog size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Show loading state on submit button */
+    isSubmitting?: boolean;
+    /** Form content rendered in Dialog.Body */
+    bodySlot: React.ReactNode;
+    /** Custom footer content (replaces default submit/cancel buttons) */
+    footerSlot?: React.ReactNode;
+    /** Additional class name */
+    className?: string;
+}
+/**
+ * FormDialog composite -- wraps ContainerDialog with form submit/cancel lifecycle.
+ * Does NOT own form field state (per Research Pitfall 6). Form content is
+ * injected via bodySlot; consumer manages field state.
+ */
+export declare function FormDialog(props: FormDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace FormDialog {
+    var displayName: string;
+}

package/lib/composites/overlay/InlineNudge/InlineNudge.d.ts

@@ -0,0 +1,26 @@
+export interface InlineNudgeProps {
+    /** The nudge message shown to the user. Plain text — no HTML injection. */
+    message: string;
+    /** The primary call-to-action button. */
+    primaryAction: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Called when the user dismisses the nudge. */
+    onDismiss: () => void;
+    /**
+     * DOM element to anchor the nudge near.
+     * REQUIRED: provide anchorEl OR anchorSelector.
+     */
+    anchorEl?: HTMLElement | null;
+    /**
+     * CSS selector to resolve the anchor element.
+     * Used as fallback when anchorEl is not provided.
+     * REQUIRED: provide anchorEl OR anchorSelector.
+     */
+    anchorSelector?: string;
+}
+export declare function InlineNudge({ message, primaryAction, onDismiss, anchorEl, anchorSelector, }: InlineNudgeProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace InlineNudge {
+    var displayName: string;
+}

package/lib/composites/overlay/InlineNudge/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * InlineNudge composite barrel export.
+ *
+ * AP-07: InlineNudge MUST be mounted with anchorEl or anchorSelector.
+ *   FORBIDDEN mount locations: app/components/Layout/**, app/_app.tsx
+ *   Enforced in reptime-cloud/.eslintrc via no-restricted-syntax rule (see 15-03-PLAN).
+ *
+ * VO-04: Props are strictly {message, primaryAction, onDismiss, anchorEl?, anchorSelector?}.
+ *   NO nudgeType prop. The behavior tracker decides content; InlineNudge is the dumb renderer.
+ */
+export { InlineNudge } from './InlineNudge';
+export type { InlineNudgeProps } from './InlineNudge';

package/lib/composites/overlay/MergePrompt/MergePrompt.d.ts

@@ -0,0 +1,16 @@
+import { MergePromptProps } from './types';
+/**
+ * MergePrompt — non-blocking floating overlay that presents two card summaries
+ * and accept/dismiss actions for a merge suggestion.
+ *
+ * Non-blocking: the outermost wrapper has pointerEvents:'none'; only the
+ * inner content div has pointerEvents:'auto' to prevent blocking dashboard
+ * interaction while the prompt is visible.
+ *
+ * 200ms click-ignore window: prevents accidental drop-click-dismiss when
+ * the prompt appears immediately after a drag-drop action.
+ */
+export declare function MergePrompt({ open, cardA, cardB, categoryLabel, onAccept, onDismiss, anchorRef, }: MergePromptProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace MergePrompt {
+    var displayName: string;
+}

package/lib/composites/overlay/MergePrompt/index.d.ts

@@ -0,0 +1,2 @@
+export { MergePrompt } from './MergePrompt';
+export type { MergePromptProps, MergePromptCardSummary } from './types';

package/lib/composites/overlay/MergePrompt/types.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export interface MergePromptCardSummary {
+    label: string;
+    previewValue: string;
+}
+export interface MergePromptProps {
+    open: boolean;
+    cardA: MergePromptCardSummary;
+    cardB: MergePromptCardSummary;
+    /** Generic category label shown in the prompt heading, e.g. "status breakdown" */
+    categoryLabel: string;
+    onAccept: () => void;
+    onDismiss: () => void;
+    anchorRef?: React.RefObject<HTMLElement | null>;
+}

package/lib/composites/overlay/SplitButton/SplitButton.d.ts

@@ -0,0 +1,27 @@
+import { default as React } from 'react';
+import { PresetButtonVariant } from '../../../presets/PresetButton/PresetButton';
+import { IconValue } from '../../../types/icon';
+export interface SplitButtonMenuItem {
+    label: React.ReactNode;
+    onClick: () => void;
+    icon?: IconValue;
+    disabled?: boolean;
+    divider?: boolean;
+}
+export interface SplitButtonProps {
+    children: React.ReactNode;
+    onClick?: () => void;
+    menuItems: SplitButtonMenuItem[];
+    variant?: PresetButtonVariant;
+    size?: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    dropdownIcon?: React.ReactNode;
+    leftIcon?: React.ReactNode;
+}
+/**
+ * SplitButton -- Composite tier. Main action button with dropdown menu.
+ * Orchestrates Button + ButtonGroup + dropdown menu.
+ */
+export declare const SplitButton: React.ForwardRefExoticComponent<SplitButtonProps & React.RefAttributes<HTMLDivElement>>;
+export { SplitButton as PresetSplitButton };
+export type { SplitButtonProps as PresetSplitButtonProps };

package/lib/composites/overlay/SplitButton/index.d.ts

@@ -0,0 +1,2 @@
+export { SplitButton, type SplitButtonProps, type SplitButtonMenuItem } from './SplitButton';
+export { SplitButton as PresetSplitButton, type SplitButtonProps as PresetSplitButtonProps } from './SplitButton';

package/lib/composites/overlay/index.d.ts

@@ -0,0 +1,6 @@
+export { FormDialog } from './FormDialog';
+export type { FormDialogProps } from './FormDialog';
+export { Dropdown, type DropdownProps, type DropdownItem } from './Dropdown';
+export { SplitButton, type SplitButtonProps, type SplitButtonMenuItem } from './SplitButton';
+export { MergePrompt, type MergePromptProps, type MergePromptCardSummary } from './MergePrompt';
+export { InlineNudge, type InlineNudgeProps } from './InlineNudge';

package/lib/compositions/feedback/DestructiveModal.d.ts

@@ -28,4 +28,4 @@ export interface DestructiveModalProps {
     icon?: string;
 }
 export declare const metadata: PatternMetadata;
-export default function DestructiveModal({ isOpen, onClose, onConfirm, title, description, confirmLabel, cancelLabel, requireConfirmation, confirmationText, confirmationPlaceholder, isLoading, resourceName, icon, }: DestructiveModalProps): import("react/jsx-runtime").JSX.Element | null;
+export default function DestructiveModal({ isOpen, onClose, onConfirm, title, description, confirmLabel, cancelLabel, requireConfirmation, confirmationText, confirmationPlaceholder, isLoading, resourceName, icon, }: DestructiveModalProps): import("react/jsx-runtime").JSX.Element;

package/lib/compositions/filters/OrderFilterBar.d.ts

@@ -0,0 +1,35 @@
+import { DateRange } from '../../presets/PresetDateRangePicker/PresetDateRangePicker';
+import { SelectOption } from '../../presets/PresetSelect/PresetSelect';
+import { SegmentedControlOption } from '../../presets/PresetSegmentedControl/PresetSegmentedControl';
+import { MultiSelectOption } from '../../composites/inputs/MultiSelect';
+export interface OrderFilterState {
+    dateRange?: DateRange;
+    status?: string;
+    categories?: string[];
+    view?: string;
+}
+export interface OrderFilterBarProps {
+    /** Current filter state */
+    value: OrderFilterState;
+    /** Called when any filter changes */
+    onChange: (state: OrderFilterState) => void;
+    /** Status options for the status Select */
+    statusOptions?: SelectOption[];
+    /** Category options for the category MultiSelect */
+    categoryOptions?: MultiSelectOption[];
+    /** View options for segmented control */
+    viewOptions?: SegmentedControlOption[];
+    /** Reset handler */
+    onReset?: () => void;
+    /** Additional class name */
+    className?: string;
+}
+/**
+ * OrderFilterBar -- Composition that arranges date/select/multi-select filter controls
+ * in a horizontal bar for filtering orders or similar entities.
+ * Non-form composition: no Zod schema (per D-07).
+ */
+export declare function OrderFilterBar(props: OrderFilterBarProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace OrderFilterBar {
+    var displayName: string;
+}

package/lib/compositions/filters/index.d.ts

@@ -0,0 +1,2 @@
+export { OrderFilterBar } from './OrderFilterBar';
+export type { OrderFilterBarProps, OrderFilterState } from './OrderFilterBar';

package/lib/compositions/forms/AddressGroup.d.ts

@@ -1,3 +1,4 @@
+import { default as React } from 'react';
 import { z } from 'zod';
 import { PatternMetadata } from '../types';
 export declare const addressSchema: z.ZodObject<{
@@ -33,5 +34,16 @@ export interface AddressGroupProps {
     /** External validation errors */
     errors?: Partial<Record<keyof AddressFormValues, string>>;
 }
+/** Imperative ref API for AddressGroup -- use when embedded in a parent form */
+export interface AddressGroupRef {
+    /** Validate all fields against the address schema */
+    validate: () => {
+        success: boolean;
+        errors: Record<string, string>;
+    };
+    /** Get current field values */
+    getValues: () => AddressFormValues;
+}
 export declare const metadata: PatternMetadata;
-export default function AddressGroup({ legend, compact, showStreet2, showCountry, defaultCountry, disabled, required, defaultValues, onChange, onBlur, errors: externalErrors, }: AddressGroupProps): import("react/jsx-runtime").JSX.Element;
+declare const AddressGroup: React.ForwardRefExoticComponent<AddressGroupProps & React.RefAttributes<AddressGroupRef>>;
+export default AddressGroup;

package/lib/compositions/forms/ContactForm.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { PatternMetadata } from '../types';
+export declare const contactSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    subject: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type ContactFormValues = z.infer<typeof contactSchema>;
+export interface ContactFormProps {
+    /** Called when form is submitted with valid data */
+    onSubmit?: (values: ContactFormValues) => void | Promise<void>;
+    /** Raw FormData submit handler (bypasses Zod validation) */
+    onSubmitRaw?: (data: FormData) => void;
+    /** Loading state for the submit button */
+    isLoading?: boolean;
+    /** Disable the entire form */
+    disabled?: boolean;
+    /** Default form values */
+    defaultValues?: Partial<ContactFormValues>;
+    /** Text for the submit button */
+    submitLabel?: string;
+    /** If provided, renders a Select instead of text Input for subject */
+    subjectOptions?: string[];
+    /** Title displayed at the top of the form */
+    title?: string;
+    /** Subtitle/description below the title */
+    subtitle?: string;
+}
+export declare const metadata: PatternMetadata;
+export default function ContactForm({ onSubmit, onSubmitRaw, isLoading, disabled, defaultValues, submitLabel, subjectOptions, title, subtitle, }: ContactFormProps): import("react/jsx-runtime").JSX.Element;

package/lib/compositions/forms/CreditCardForm.d.ts

@@ -32,10 +32,12 @@ export interface CreditCardFormProps {
     defaultValues?: Partial<CreditCardFormValues>;
     /** Called when form is submitted with valid data */
     onSubmit?: (values: CreditCardFormValues) => void | Promise<void>;
+    /** Raw FormData submit handler (bypasses Zod validation) */
+    onSubmitRaw?: (data: FormData) => void;
     /** Called when cancel button is clicked */
     onCancel?: () => void;
     /** Called when card number changes (for async BIN validation) */
     onCardNumberChange?: (cardNumber: string) => void;
 }
 export declare const metadata: PatternMetadata;
-export default function CreditCardForm({ title, subtitle, submitLabel, amount, showCancel, cancelLabel, isLoading, isValidating, disabled, showSecureIcon, defaultValues, onSubmit, onCancel, onCardNumberChange, }: CreditCardFormProps): import("react/jsx-runtime").JSX.Element;
+export default function CreditCardForm({ title, subtitle, submitLabel, amount, showCancel, cancelLabel, isLoading, isValidating, disabled, showSecureIcon, defaultValues, onSubmit, onSubmitRaw, onCancel, onCardNumberChange, }: CreditCardFormProps): import("react/jsx-runtime").JSX.Element;

package/lib/compositions/forms/LoginForm.d.ts

@@ -31,8 +31,10 @@ export interface LoginFormProps {
     defaultValues?: Partial<LoginFormValues>;
     /** Called when form is submitted with valid data */
     onSubmit?: (values: LoginFormValues) => void | Promise<void>;
+    /** Raw FormData submit handler (bypasses Zod validation) */
+    onSubmitRaw?: (data: FormData) => void;
     /** Called when forgot password link is clicked */
     onForgotPassword?: () => void;
 }
 export declare const metadata: PatternMetadata;
-export default function LoginForm({ title, subtitle, submitLabel, showRememberMe, showForgotPassword, forgotPasswordUrl, showRegisterLink, registerUrl, isLoading, disabled, defaultValues, onSubmit, onForgotPassword, }: LoginFormProps): import("react/jsx-runtime").JSX.Element;
+export default function LoginForm({ title, subtitle, submitLabel, showRememberMe, showForgotPassword, forgotPasswordUrl, showRegisterLink, registerUrl, isLoading, disabled, defaultValues, onSubmit, onSubmitRaw, onForgotPassword, }: LoginFormProps): import("react/jsx-runtime").JSX.Element;

package/lib/compositions/forms/PaymentForm.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { PaymentMethod } from '../../composites/forms/PaymentMethodSelect';
+import { PatternMetadata } from '../types';
+export declare const paymentSchema: z.ZodObject<{
+    paymentMethod: z.ZodEnum<{
+        credit_card: "credit_card";
+        debit_card: "debit_card";
+        bank_transfer: "bank_transfer";
+    }>;
+    card: z.ZodOptional<z.ZodObject<{
+        cardNumber: z.ZodString;
+        expiryDate: z.ZodString;
+        cvv: z.ZodString;
+        cardholderName: z.ZodString;
+    }, z.core.$strip>>;
+    billingAddress: z.ZodObject<{
+        street: z.ZodString;
+        street2: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodString;
+        zip: z.ZodString;
+        country: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    savePaymentMethod: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PaymentFormValues = z.infer<typeof paymentSchema>;
+export interface PaymentFormProps {
+    /** Called when form is submitted with valid data */
+    onSubmit?: (values: PaymentFormValues) => void | Promise<void>;
+    /** Raw FormData submit handler (bypasses Zod validation) */
+    onSubmitRaw?: (data: FormData) => void;
+    /** Loading state for the submit button */
+    isLoading?: boolean;
+    /** Disable the entire form */
+    disabled?: boolean;
+    /** Default form values */
+    defaultValues?: Partial<PaymentFormValues>;
+    /** Text for the submit button */
+    submitLabel?: string;
+    /** Cancel button label */
+    cancelLabel?: string;
+    /** Called when cancel is clicked */
+    onCancel?: () => void;
+    /** Available payment methods (for saved cards selector) */
+    paymentMethods?: PaymentMethod[];
+    /** Show save payment method checkbox */
+    showSaveMethod?: boolean;
+}
+export declare const metadata: PatternMetadata;
+export default function PaymentForm({ onSubmit, onSubmitRaw, isLoading, disabled, defaultValues, submitLabel, cancelLabel, onCancel, paymentMethods, showSaveMethod, }: PaymentFormProps): import("react/jsx-runtime").JSX.Element;

package/lib/compositions/forms/RegistrationForm.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { PatternMetadata } from '../types';
+export declare const registrationSchema: z.ZodObject<{
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    email: z.ZodString;
+    password: z.ZodString;
+    confirmPassword: z.ZodString;
+    acceptTerms: z.ZodBoolean;
+}, z.core.$strip>;
+export type RegistrationFormValues = z.infer<typeof registrationSchema>;
+export interface RegistrationFormProps {
+    /** Called when form is submitted with valid data */
+    onSubmit?: (values: RegistrationFormValues) => void | Promise<void>;
+    /** Raw FormData submit handler (bypasses Zod validation) */
+    onSubmitRaw?: (data: FormData) => void;
+    /** Loading state for the submit button */
+    isLoading?: boolean;
+    /** Disable the entire form */
+    disabled?: boolean;
+    /** Default form values */
+    defaultValues?: Partial<RegistrationFormValues>;
+    /** Text for the submit button */
+    submitLabel?: string;
+    /** Show a link to the terms of service */
+    showTermsLink?: boolean;
+    /** URL for terms of service */
+    termsUrl?: string;
+    /** Show a login link */
+    showLoginLink?: boolean;
+    /** URL for the login page */
+    loginUrl?: string;
+    /** Title displayed at the top of the form */
+    title?: string;
+    /** Subtitle/description below the title */
+    subtitle?: string;
+}
+export declare const metadata: PatternMetadata;
+export default function RegistrationForm({ onSubmit, onSubmitRaw, isLoading, disabled, defaultValues, submitLabel, showTermsLink, termsUrl, showLoginLink, loginUrl, title, subtitle, }: RegistrationFormProps): import("react/jsx-runtime").JSX.Element;

package/lib/compositions/forms/index.d.ts

@@ -1,3 +1,6 @@
 export { default as LoginForm, metadata as loginFormMetadata, loginSchema, type LoginFormProps, } from './LoginForm';
 export { default as AddressGroup, metadata as addressGroupMetadata, addressSchema, type AddressGroupProps, } from './AddressGroup';
 export { default as CreditCardForm, metadata as creditCardFormMetadata, creditCardSchema, type CreditCardFormProps, } from './CreditCardForm';
+export { default as RegistrationForm, metadata as registrationFormMetadata, registrationSchema, type RegistrationFormProps, type RegistrationFormValues, } from './RegistrationForm';
+export { default as ContactForm, metadata as contactFormMetadata, contactSchema, type ContactFormProps, type ContactFormValues, } from './ContactForm';
+export { default as PaymentForm, metadata as paymentFormMetadata, paymentSchema, type PaymentFormProps, type PaymentFormValues, } from './PaymentForm';

package/lib/compositions/index.d.ts

@@ -1,3 +1,6 @@
 export type { PatternMetadata, PatternPropDefinition, PatternCategory, PatternRecord, } from './types';
 export * from './forms';
 export * from './feedback';
+export * from './panels';
+export * from './filters';
+export * from './navigation';

package/lib/compositions/navigation/ImportWizard.d.ts

@@ -0,0 +1,28 @@
+import { DataTableColumn } from '../../composites/data/DataTable';
+export interface ImportWizardProps<T = Record<string, unknown>> {
+    /** Accepted file types (e.g., '.csv,.xlsx') */
+    acceptedTypes?: string;
+    /** Called when file is uploaded and parsed */
+    onFileParsed?: (data: T[]) => void;
+    /** Column definitions for preview table */
+    previewColumns?: DataTableColumn<T>[];
+    /** Row key for preview table */
+    previewRowKey?: keyof T & string;
+    /** Called when import is confirmed */
+    onImport: (data: T[]) => void | Promise<void>;
+    /** Loading/progress state */
+    isImporting?: boolean;
+    /** Import progress (0-100) */
+    progress?: number;
+    /** Additional class name */
+    className?: string;
+}
+/**
+ * ImportWizard -- Composition that orchestrates Stepper + FileUpload + DataTable
+ * for multi-step file import workflows.
+ * Non-form composition: no Zod schema (per D-07).
+ */
+export declare function ImportWizard<T extends Record<string, unknown>>(props: ImportWizardProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare namespace ImportWizard {
+    var displayName: string;
+}

package/lib/compositions/navigation/index.d.ts

@@ -0,0 +1,2 @@
+export { ImportWizard } from './ImportWizard';
+export type { ImportWizardProps } from './ImportWizard';

package/lib/compositions/panels/EntitySearchPanel.d.ts

@@ -0,0 +1,41 @@
+import { FilterValue } from '../../composites/inputs/FilterChip';
+import { DataTableColumn } from '../../composites/data/DataTable';
+export interface EntitySearchPanelProps<T extends Record<string, unknown>> {
+    /** Search handler */
+    onSearch: (query: string) => void;
+    /** Active filters */
+    filters?: FilterValue[];
+    /** Filter toggle handler */
+    onFilterToggle?: (filter: FilterValue) => void;
+    /** Filter remove handler */
+    onFilterRemove?: (filter: FilterValue) => void;
+    /** Data for the results table */
+    data: T[];
+    /** Column definitions for results */
+    columns: DataTableColumn<T>[];
+    /** Row key */
+    rowKey: keyof T & string;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Selected row keys */
+    selectedKeys?: Set<string>;
+    /** Selection handler */
+    onSelectionChange?: (keys: Set<string>) => void;
+    /** Title text */
+    title?: string;
+    /** Search placeholder */
+    searchPlaceholder?: string;
+    /** Search value (controlled) */
+    searchValue?: string;
+    /** Additional class name */
+    className?: string;
+}
+/**
+ * EntitySearchPanel -- Composition that arranges SearchInput + FilterChip + DataTable
+ * for a dashboard-style entity search experience.
+ * Non-form composition: no Zod schema (per D-07).
+ */
+export declare function EntitySearchPanel<T extends Record<string, unknown>>(props: EntitySearchPanelProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare namespace EntitySearchPanel {
+    var displayName: string;
+}

package/lib/compositions/panels/ProfileCard.d.ts

@@ -0,0 +1,34 @@
+import { PresetBadgeVariant } from '../../presets/PresetBadge/PresetBadge';
+export interface ProfileCardBadge {
+    label: string;
+    variant?: PresetBadgeVariant;
+}
+export interface ProfileCardMetadata {
+    label: string;
+    value: string;
+}
+export interface ProfileCardProps {
+    /** Display name */
+    name: string;
+    /** Subtitle text (e.g. role, email) */
+    subtitle?: string;
+    /** Avatar image URL */
+    avatarUrl?: string;
+    /** Avatar fallback initials */
+    avatarFallback?: string;
+    /** Badges to display */
+    badges?: ProfileCardBadge[];
+    /** Metadata key-value pairs */
+    metadata?: ProfileCardMetadata[];
+    /** Additional class name */
+    className?: string;
+}
+/**
+ * ProfileCard -- Composition that arranges Avatar + Text + Badges + Metadata
+ * inside a Card layout for user/entity profile display.
+ * Non-form composition: no Zod schema (per D-07).
+ */
+export declare function ProfileCard(props: ProfileCardProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ProfileCard {
+    var displayName: string;
+}

package/lib/compositions/panels/index.d.ts

@@ -0,0 +1,4 @@
+export { EntitySearchPanel } from './EntitySearchPanel';
+export type { EntitySearchPanelProps } from './EntitySearchPanel';
+export { ProfileCard } from './ProfileCard';
+export type { ProfileCardProps, ProfileCardBadge, ProfileCardMetadata } from './ProfileCard';