@banzamel/mineralui 1.9.1 → 1.10.2

package/dist/components/cards/index.d.ts

@@ -8,10 +8,6 @@ export { MCardPayment } from './MCardPayment';
 export type { MCardPaymentProps, MCardPaymentBrand } from './MCardPayment';
 export { MCardPaymentMethod } from './MCardPaymentMethod';
 export type { MCardPaymentMethodProps } from './MCardPaymentMethod';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MCardBusiness } from './MCardBusiness';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MCardBusinessProps, MCardBusinessVariant, MCardBusinessSocial, MCardBusinessAddress, MCardBusinessContact, } from './MCardBusiness';
 export { MCardOffer } from './MCardOffer';
 export type { MCardOfferProps } from './MCardOffer';
 export { MCardCourse } from './MCardCourse';
@@ -27,11 +23,7 @@ export type { MCardWidgetProps, MCardWidgetTrendType } from './MCardWidget';
 export { MCardStat } from './MStatCard';
 export type { MCardStatProps, MCardStatTrendType } from './MStatCard';
 export { MCardGrid } from './MCardGrid';
-export type { MCardGridProps, MCardGridFilterKey, MCardGridSortKey, MCardGridResponsiveColumns } from './MCardGrid';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MCardFinance } from './MCardFinance';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MCardFinanceProps, MCardFinanceChangeType } from './MCardFinance';
+export type { MCardGridProps, MCardGridFilterKey, MCardGridSortKey, MCardGridSort, MCardGridResponsiveColumns } from './MCardGrid';
 export { MCardDaySchedule } from './MCardDaySchedule';
 export type { MCardDayScheduleProps, MCardDayScheduleTab, MCardDayScheduleTabType, MDayScheduleEntry, } from './MCardDaySchedule';
 export { MCardDocumentTree } from './MCardDocumentTree';

package/dist/components/data/index.d.ts

@@ -1,30 +1,10 @@
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MChat, MChatHeader, MChatBody, MChatMessage, MChatInput, MChatTypingIndicator, MChatConversationList, MChatConversationItem, } from './MChat';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MChatProps, MChatVariant, MChatHeaderProps, MChatBodyProps, MChatMessageProps, MChatMessageData, MChatMessageStatus, MChatUser, MChatInputProps, MChatTypingIndicatorProps, MChatConversation, MChatConversationListProps, MChatConversationItemProps, MChatEmojiCategory, } from './MChat';
 export { MDataTable } from './MDataTable';
 export type { MDataTableProps, MDataTableColumn, MDataTableSort, MDataTableSortDir } from './MDataTable';
 export { MTreeView } from './MTreeView';
 export type { MTreeViewProps, MTreeNode, MTreeViewContextMenuItem, MTreeViewMoveEvent } from './MTreeView';
 export { MTaskList } from './MTaskList';
 export type { MTaskListProps, MTaskItem } from './MTaskList';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MTimelineCalendar } from './MTimelineCalendar';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MTimelineCalendarEvent, MTimelineCalendarEventMenuItem, MTimelineCalendarLocale, MTimelineCalendarPerson, MTimelineCalendarProps, MTimelineCalendarRange, MTimelineCalendarRow, } from './MTimelineCalendar';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MFileManager } from './MFileManager';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MFileManagerActionEvent, MFileManagerLocale, MFileManagerMoveEvent, MFileManagerNode, MFileManagerProps, MFileManagerSelectionEvent, MFileManagerToolbarAction, MFileManagerView, } from './MFileManager';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MCalendarBoard, MCalendarDayCell, MCalendarEventList, MCalendarEventItem, MCalendarEventPopover, MCalendarHourBar, MCalendarTimeline, } from './MCalendarBoard';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MCalendarBoardProps, MCalendarBoardLocale, MCalendarDetailsMode, MCalendarBoardView, MCalendarEvent, MCalendarEventActionItem, MCalendarDayActionItem, MCalendarEventProps, MCalendarFilterOption, MCalendarEventItemProps, MCalendarEventListProps, MCalendarEventPopoverProps, MCalendarEventStatus, MCalendarEventUser, MCalendarDayCellProps, MCalendarDayRenderContext, MCalendarHourBarProps, MCalendarTimelineProps, MCalendarTimelineSlotState, } from './MCalendarBoard';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MLineChart, MBarChart, MAreaChart, MPieChart } from './MChart';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MLineChartProps, MBarChartProps, MAreaChartProps, MPieChartProps, MChartDataset, MChartAxisConfig, MChartTooltipData, } from './MChart';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MSparkline } from './MSparkline';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MSparklineProps, MSparklineType } from './MSparkline';
+export { useMTable } from './useMTable';
+export type { MTableQuery, MTableResponse, MTableFetcher, MTableOptions, MTableHandle, MTableProps } from './useMTable';
+export { useMCardGrid } from './useMCardGrid';
+export type { MCardGridProps as MCardGridManualProps, MCardGridHandle } from './useMCardGrid';

package/dist/components/data/useMCardGrid.d.ts

@@ -0,0 +1,36 @@
+import { MCardGridSort } from '../cards/MCardGrid';
+import { MTableFetcher, MTableOptions } from './useMTable';
+/**
+ * Card-grid analog of `useMTable`. Same fetcher-agnostic pattern; returns props
+ * spreadable onto `<MCardGrid>` in manual mode. Note that `MCardGridSort` uses
+ * `direction` (vs `MDataTableSort.dir`) — convert if you reuse a fetcher.
+ */
+export interface MCardGridProps<T> {
+    items: T[];
+    total: number;
+    page: number;
+    onPageChange: (page: number) => void;
+    sort: MCardGridSort<T> | null;
+    onSortChange: (sort: MCardGridSort<T> | null) => void;
+    search: string;
+    onSearchChange: (search: string) => void;
+    filters: Record<string, string[]>;
+    onFiltersChange: (filters: Record<string, string[]>) => void;
+    manualSearch: true;
+    manualFilters: true;
+    manualSort: true;
+    manualPagination: true;
+    pageSize: number;
+}
+export interface MCardGridHandle<T> {
+    /** Spread directly onto `<MCardGrid>`. */
+    gridProps: MCardGridProps<T>;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Adapter hook for `MCardGrid` in manual mode. Owns search / filters / sort /
+ * page state, calls a generic `MTableFetcher`, returns `gridProps` to spread.
+ */
+export declare function useMCardGrid<T>(fetcher: MTableFetcher<T>, options?: MTableOptions): MCardGridHandle<T>;

package/dist/components/data/useMTable.d.ts

@@ -0,0 +1,69 @@
+import { MDataTableSort } from './MDataTable';
+/**
+ * Generic query shape that backend lists can satisfy. Drop-in adapter between
+ * `useMTable` and the API call. The framework does not assume axios/fetch/swr —
+ * the consumer plugs whatever fetcher they want.
+ */
+export interface MTableQuery {
+    page?: number;
+    perPage?: number;
+    search?: string;
+    filters?: Record<string, string[]>;
+    sort?: MDataTableSort | null;
+}
+/**
+ * Standard list response. Mirrors the most common server convention
+ * (data + meta with pagination total). Adapt your fetcher to this shape if your
+ * backend uses different envelope keys.
+ */
+export interface MTableResponse<T> {
+    data: T[];
+    meta: {
+        total: number;
+        page: number;
+        perPage: number;
+        totalPages: number;
+    };
+}
+export type MTableFetcher<T> = (query: MTableQuery, signal?: AbortSignal) => Promise<MTableResponse<T>>;
+export interface MTableOptions {
+    perPage?: number;
+    initialPage?: number;
+    initialSearch?: string;
+    initialFilters?: Record<string, string[]>;
+    initialSort?: MDataTableSort | null;
+    /** Bump to force a refetch (e.g. after a mutation invalidates the list). */
+    invalidationKey?: number | string;
+}
+export interface MTableProps<T> {
+    data: T[];
+    total: number;
+    page: number;
+    onPageChange: (page: number) => void;
+    sort: MDataTableSort | null;
+    onSortChange: (sort: MDataTableSort | null) => void;
+    search: string;
+    onSearchChange: (search: string) => void;
+    filters: Record<string, string[]>;
+    onFiltersChange: (filters: Record<string, string[]>) => void;
+    manualSearch: true;
+    manualFilters: true;
+    manualSort: true;
+    manualPagination: true;
+    pageSize: number;
+}
+export interface MTableHandle<T> {
+    /** Spread directly onto `<MDataTable>` — wires up all manual* + state props. */
+    tableProps: MTableProps<T>;
+    isLoading: boolean;
+    error: Error | null;
+    /** Trigger a fresh fetch with current query. */
+    refetch: () => void;
+}
+/**
+ * Adapter hook that bridges a fetcher returning `MTableResponse<T>` with
+ * `MDataTable` in manual mode. Owns the search / filters / sort / page state,
+ * debounces nothing on its own (fetcher decides), and aborts in-flight
+ * requests when the query changes. Spread `tableProps` onto your table.
+ */
+export declare function useMTable<T>(fetcher: MTableFetcher<T>, options?: MTableOptions): MTableHandle<T>;

package/dist/components/display/index.d.ts

@@ -22,15 +22,7 @@ export { MDetailList } from './MDetailList';
 export type { MDetailListProps, MDetailListItem } from './MDetailList';
 export { MBlur } from './MBlur';
 export type { MBlurProps, MBlurTrigger } from './MBlur';
-/** Marked as a Pro component in MineralUI licensing metadata. */
 export { MStepper, MStep } from './MStepper';
-/** Types for a Pro component in MineralUI licensing metadata. */
 export type { MStepperProps, MStepProps } from './MStepper';
-/** Marked as a Pro component in MineralUI licensing metadata. */
 export { MTimeline, MTimelineItem } from './MTimeline';
-/** Types for a Pro component in MineralUI licensing metadata. */
 export type { MTimelineProps, MTimelineItemProps } from './MTimeline';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MQrCode } from './MQrCode';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MQrCodeProps, MQrCodeStatus } from './MQrCode';

package/dist/components/feedback/MProgressRing/MProgressRing.d.ts

@@ -0,0 +1,8 @@
+import { MProgressRingProps } from './MProgressRing.types';
+/**
+ * Determinate ring progress — 0–100 with optional centered percent label.
+ * Visually consistent with `MLoader`/`MSpinner`: same MColor palette, same
+ * size tokens (xs/sm/md/lg/xl). Use a number for a custom diameter when the
+ * design needs an off-token size.
+ */
+export declare function MProgressRing({ value, size, color, thickness, showPercent, label, ariaLabel, className, style, ...rest }: MProgressRingProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/feedback/MProgressRing/MProgressRing.types.d.ts

@@ -0,0 +1,21 @@
+import { HTMLAttributes, ReactNode } from 'react';
+import { MColor, MSize } from '../../../theme';
+export interface MProgressRingProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {
+    /** Progress value, 0–100. Values outside the range are clamped. */
+    value: number;
+    /** Token-aware size palette (xs/sm/md/lg/xl) or a custom diameter in px. Default `md`. */
+    size?: MSize | number;
+    /** Stroke color. Default `primary`. Pass `inherit` to take from CSS context. */
+    color?: MColor | 'inherit';
+    /** Stroke thickness in px. Default scales with `size`. */
+    thickness?: number;
+    /** Render the centered percentage label. Default `true`. */
+    showPercent?: boolean;
+    /**
+     * Override the centered label content (e.g. `12 / 100`, an icon, etc.).
+     * When set, takes precedence over `showPercent`.
+     */
+    label?: ReactNode;
+    /** Accessible label announced to screen readers. Default `Loading {value}%`. */
+    ariaLabel?: string;
+}

package/dist/components/feedback/MProgressRing/index.d.ts

@@ -0,0 +1,2 @@
+export { MProgressRing } from './MProgressRing';
+export type { MProgressRingProps } from './MProgressRing.types';

package/dist/components/feedback/index.d.ts

@@ -10,8 +10,9 @@ export { MSpinner } from './MSpinner';
 export type { MSpinnerProps } from './MSpinner';
 export { MLoader } from './MLoader';
 export type { MLoaderProps } from './MLoader';
+export { MProgressRing } from './MProgressRing';
+export type { MProgressRingProps } from './MProgressRing';
 export { MToastProvider, useMToast } from './MToast';
 export type { MToastProviderProps, MToastOptions, MToastEntry, MToastPosition, MToastContext } from './MToast';
-export * from './MCookie';
 export { MSkeleton } from './MSkeleton';
 export type { MSkeletonProps, MSkeletonVariant } from './MSkeleton';

package/dist/components/layout/MCanvasGrid/MCanvasGrid.d.ts

@@ -0,0 +1,5 @@
+import { ReactElement, Ref } from 'react';
+import { MCanvasGridItem, MCanvasGridProps } from './MCanvasGrid.types';
+export declare const MCanvasGrid: <T extends MCanvasGridItem>(props: MCanvasGridProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReactElement | null;

package/dist/components/layout/MCanvasGrid/MCanvasGrid.types.d.ts

@@ -0,0 +1,43 @@
+import { CSSProperties, ReactNode } from 'react';
+export interface MCanvasGridPosition {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface MCanvasGridItem {
+    id: string;
+    position: MCanvasGridPosition;
+}
+export type MCanvasGridGuides = 'always' | 'never' | 'on-edit' | 'on-drag';
+export interface MCanvasGridProps<T extends MCanvasGridItem> {
+    columns?: number;
+    rows?: number;
+    snap?: number;
+    items: T[];
+    renderItem: (item: T) => ReactNode;
+    minItemSize?: (item: T) => {
+        w: number;
+        h: number;
+    };
+    maxItemSize?: (item: T) => {
+        w: number;
+        h: number;
+    };
+    editable?: boolean;
+    onItemMove?: (id: string, position: MCanvasGridPosition) => void;
+    onItemResize?: (id: string, position: MCanvasGridPosition) => void;
+    onItemRemove?: (id: string) => void;
+    onItemEdit?: (id: string) => void;
+    onItemExpand?: (id: string) => void;
+    guides?: MCanvasGridGuides;
+    compactBreakpoint?: number;
+    mobileBreakpoint?: number;
+    height?: number | string;
+    /** How tile content behaves when it overflows the cell. `'scroll'` (default) shows a native scrollbar; `'scale'` proportionally shrinks the content via CSS transform. */
+    fitContent?: 'scroll' | 'scale';
+    /** When `fitContent='scale'`, render width used as the natural content size before scaling. Default 480. */
+    fitContentBaseWidth?: number;
+    className?: string;
+    style?: CSSProperties;
+}

package/dist/components/layout/MCanvasGrid/ScaleToFit.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+interface ScaleToFitProps {
+    /**
+     * Minimum render width (in CSS px). When the parent is narrower, content
+     * is rendered at this width and scaled down. When the parent is wider,
+     * content is rendered at the parent's width (no scale-up, no padding).
+     */
+    baseWidth?: number;
+    children: ReactNode;
+}
+/**
+ * Renders `children` at `max(baseWidth, parentWidth)`, then applies
+ * `transform: scale(...)` so the rendered block fits the parent box without
+ * scrollbars. Scale never exceeds 1 (no blurry up-scaling). When the parent
+ * is wider than baseWidth, render width tracks the parent so content fills
+ * the available space natively (no horizontal padding).
+ */
+export declare function ScaleToFit({ baseWidth, children }: ScaleToFitProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/layout/MCanvasGrid/index.d.ts

@@ -0,0 +1,2 @@
+export { MCanvasGrid } from './MCanvasGrid';
+export type { MCanvasGridProps, MCanvasGridItem, MCanvasGridPosition, MCanvasGridGuides, } from './MCanvasGrid.types';

package/dist/components/layout/index.d.ts

@@ -6,10 +6,6 @@ export { MFooter } from './MFooter';
 export type { MFooterProps } from './MFooter';
 export { MNavbar } from './MNavbar';
 export type { MNavbarProps, MNavbarTone, MNavbarJustify } from './MNavbar';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MTopbar } from './MTopbar';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MTopbarProps, MTopbarItem, MTopbarTone, MTopbarJustify } from './MTopbar';
 export { MNavs } from './MNavs';
 export type { MNavsProps, MNavsItem, MNavsOrientation } from './MNavs';
 export { MTabs } from './MTabs';
@@ -38,3 +34,5 @@ export { MPagination } from './MPagination';
 export type { MPaginationProps } from './MPagination';
 export { MAppShell, MBody } from './MAppShell';
 export type { MAppShellProps, MBodyProps } from './MAppShell';
+export { MCanvasGrid } from './MCanvasGrid';
+export type { MCanvasGridProps, MCanvasGridItem, MCanvasGridPosition, MCanvasGridGuides } from './MCanvasGrid';

package/dist/components/media/MAvatar/MAvatar.d.ts

@@ -1,2 +1,2 @@
 import { MAvatarProps } from './MAvatar.types';
-export declare function MAvatar({ src, alt, name, initials, size, shape, hidden, color, badge, badgeColor, badgePulsing, backgroundColor, clickEffect, rippleColor, skeleton, className, style, onPointerDown, ...rest }: MAvatarProps): import("react/jsx-runtime").JSX.Element;
+export declare function MAvatar({ src, alt, name, initials, size, shape, hidden, color, badge, badgeColor, badgePulsing, presence, backgroundColor, clickEffect, rippleColor, skeleton, className, style, onPointerDown, ...rest }: MAvatarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/media/MAvatar/MAvatar.types.d.ts

@@ -3,6 +3,7 @@ import { MColor, MHiddenProps, MSize } from '../../../theme';
 import { MClickEffect } from '../../../utils/useInteractionEffect';
 export type MAvatarSize = MSize | number;
 export type MAvatarShape = 'circle' | 'rounded' | 'square';
+export type MAvatarPresence = 'online' | 'offline' | 'away' | 'busy';
 export interface MAvatarProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'color' | 'hidden'>, MHiddenProps {
     src?: string;
     alt?: string;
@@ -14,6 +15,14 @@ export interface MAvatarProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'col
     badge?: ReactNode | number | boolean;
     badgeColor?: MColor;
     badgePulsing?: boolean;
+    /**
+     * Convenience preset for staff/team avatars showing online status. When set:
+     * - badge auto-enabled (unless explicit `badge` overrides),
+     * - badgeColor auto-mapped: `online → success`, `offline → neutral`, `away → warning`, `busy → error`,
+     * - badgePulsing auto-enabled.
+     * Explicit `badge`/`badgeColor`/`badgePulsing` always win over the preset.
+     */
+    presence?: MAvatarPresence;
     backgroundColor?: string;
     clickEffect?: MClickEffect;
     rippleColor?: string;

package/dist/components/media/MAvatar/index.d.ts

@@ -1,2 +1,2 @@
 export { MAvatar } from './MAvatar';
-export type { MAvatarProps, MAvatarSize, MAvatarShape } from './MAvatar.types';
+export type { MAvatarProps, MAvatarSize, MAvatarShape, MAvatarPresence } from './MAvatar.types';

package/dist/components/media/index.d.ts

@@ -5,21 +5,5 @@ export type { MGalleryProps, MGalleryItem, MGalleryColumns } from './MGallery';
 export type { MMediaHoverEffect } from './mediaInteraction';
 export { MCarousel } from './MCarousel';
 export type { MCarouselProps, MCarouselTransition } from './MCarousel';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MShowcaseCarousel } from './MShowcaseCarousel';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MShowcaseCarouselSlide, MShowcaseCarouselProps } from './MShowcaseCarousel';
-export { MShowcaseCarouselItem } from './MShowcaseCarouselItem';
-export type { MShowcaseCarouselItemProps } from './MShowcaseCarouselItem';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MMasonry } from './MMasonry';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MMasonryProps } from './MMasonry';
-export { MMasonryItem } from './MMasonryItem';
-export type { MMasonryItemProps } from './MMasonryItem';
 export { MAvatar } from './MAvatar';
-export type { MAvatarProps, MAvatarSize, MAvatarShape } from './MAvatar';
-/** Marked as a Pro component in MineralUI licensing metadata. */
-export { MAvatarStack } from './MAvatarStack';
-/** Types for a Pro component in MineralUI licensing metadata. */
-export type { MAvatarStackProps, MAvatarStackItem } from './MAvatarStack';
+export type { MAvatarProps, MAvatarSize, MAvatarShape, MAvatarPresence } from './MAvatar';

package/dist/components/typography/MHeading/MHeading.d.ts

@@ -235,6 +235,7 @@ export declare function MHeading({ level, tone, hidden, color, truncate, classNa
     onTransitionStartCapture?: import('react').TransitionEventHandler<HTMLHeadingElement> | undefined;
     title?: string | undefined | undefined;
     content?: string | undefined | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
     defaultChecked?: boolean | undefined | undefined;
     defaultValue?: string | number | readonly string[] | undefined;
     suppressContentEditableWarning?: boolean | undefined | undefined;
@@ -269,7 +270,6 @@ export declare function MHeading({ level, tone, hidden, color, truncate, classNa
     results?: number | undefined | undefined;
     security?: string | undefined | undefined;
     unselectable?: "on" | "off" | undefined | undefined;
-    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
     popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
     popoverTarget?: string | undefined | undefined;
     inert?: boolean | undefined | undefined;