@muraldevkit/ui-toolkit 4.66.0-dev-7XJy.1 → 4.66.0-dev-avUr.1

package/dist/types/components/svg/config.d.ts

@@ -0,0 +1,112 @@
+/** Storybook configurations allowed for the SVG component. */
+export interface SvgArgs {
+    color: string;
+}
+export declare const storyData: {
+    args: {
+        color: string;
+        size: import("./constants").SVGSize;
+    };
+    argTypes: {
+        color: {
+            control: {
+                type: string;
+            };
+        };
+        size: {
+            control: {
+                options: string[];
+                type: string;
+            };
+        };
+    };
+    manifest: {
+        scans: {
+            size: string[];
+        };
+    };
+    title: string;
+};
+export declare const iconStoryData: {
+    manifest: {
+        exclude: {
+            default: string[];
+        };
+    };
+    title: string;
+};
+export declare const pictogramStoryData: {
+    manifest: {
+        exclude: {
+            default: string[];
+        };
+    };
+    title: string;
+};
+export declare const visualThinkingContainerStyles: {
+    display: string;
+    flexDirection: string;
+};
+export declare const brandContainerStyles: {
+    background: string;
+    width: string;
+};
+export declare const headingStyles: {
+    marginTop: string;
+};
+export declare const colorPictoStoryData: {
+    args: {
+        state: string;
+    };
+    argTypes: {
+        state: {
+            control: {
+                options: string[];
+                type: string;
+            };
+        };
+    };
+    manifest: {
+        exclude: {
+            default: string[];
+        };
+        scans: {
+            state: string[];
+        };
+    };
+    name: string;
+    title: string;
+};
+export declare const animateStoryData: {
+    args: {
+        delay: number;
+        state: "stop" | "play";
+    };
+    argTypes: {
+        delay: {
+            max: number;
+            min: number;
+            name: string;
+            step: number;
+            type: string;
+        };
+        state: {
+            control: {
+                options: readonly ["stop", "play"];
+                type: string;
+            };
+        };
+    };
+    manifest: {
+        exclude: {
+            default: string[];
+        };
+    };
+    name: string;
+    title: string;
+};
+export declare const animateContainerStyles: {
+    backgroundColor: string;
+    height: string;
+    width: string;
+};

package/dist/types/components/svg/constants.d.ts

@@ -0,0 +1,36 @@
+import { AttrsObject } from '../../utils';
+import { AnimationConfigWithData } from 'lottie-web';
+export type SVGSize = 'small' | 'medium' | 'large' | 'auto';
+export interface SVGDefaults {
+    attrs: AttrsObject;
+    size: SVGSize;
+}
+interface AllowedValues {
+    sizes: Array<string>;
+}
+/**
+ * Defines all of values allowed for attributes with limited values;
+ * used for Storybook and testing
+ */
+export declare const allowedSvgValues: AllowedValues;
+/**
+ * Default values for props on the SVG component;
+ * Shared between the component and Storybook
+ */
+export declare const svgDefaults: SVGDefaults;
+export type SVGObject = Record<string, any>;
+export type LottieConfig = Omit<AnimationConfigWithPath, 'container'>;
+export declare const baseLottieConfig: LottieConfig;
+interface AnimationConfigWithPath extends AnimationConfigWithData<'svg'> {
+    path?: string;
+}
+export declare const allowedAnimatedValues: {
+    states: readonly ["stop", "play"];
+};
+export type AnimatedState = (typeof allowedAnimatedValues.states)[number];
+export interface AnimatedDefaults {
+    delay: number;
+    state: AnimatedState;
+}
+export declare const animatedDefaults: AnimatedDefaults;
+export {};

package/dist/types/components/svg/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./MrlSvg/MrlSvg";
+export * from "./MrlSvgAnimate/MrlSvgAnimate";
+export * from './constants';

package/dist/types/components/table/MrlSmartTable/MrlSmartTable.d.ts

@@ -0,0 +1,224 @@
+import * as React from 'react';
+import { MrlTableProps } from '../MrlTable';
+import { MrlSortDirection, MrlTableCellHorizontalAlign, MrlTableColumnId, MrlTableColumnSortDescriptor, MrlTableItemId, MrlTableSelectionMode } from '../constants';
+export interface MrlSmartColumnRendererProps {
+    /**
+     * The column being rendered.
+     */
+    column: MrlSmartTableColumn;
+    /**
+     * A function to change current sort descriptor.
+     */
+    handleSortClick: ({ column, direction, name }: {
+        column: MrlSmartTableColumn['id'];
+        direction: MrlSortDirection;
+        name: string;
+    }) => void;
+    /**
+     * The element id of the table.
+     */
+    tableElementId: string;
+    /**
+     * The data-qa prefix of the table.
+     */
+    dataQaPrefix: string;
+    /**
+     * The current sort descriptor.
+     */
+    sortDescriptor?: MrlTableColumnSortDescriptor;
+    hasScrollShadowLeft: boolean;
+    hasScrollShadowRight: boolean;
+    horizontalAlign?: MrlTableCellHorizontalAlign;
+}
+export interface MrlSmartCellRendererProps {
+    /**
+     * The item for the cell being rendered.
+     */
+    item: MrlTableItem;
+    /**
+     * The column for the cell being rendered.
+     */
+    column: MrlSmartTableColumn;
+    /**
+     * The element id of the table.
+     */
+    tableElementId: string;
+    /**
+     * The data-qa prefix of the table.
+     */
+    dataQaPrefix: string;
+    hasScrollShadowLeft: boolean;
+    hasScrollShadowRight: boolean;
+}
+export interface MrlTableItem extends Record<string, unknown> {
+    /**
+     * A unique identifier for the row item.
+     */
+    id: MrlTableItemId;
+    /**
+     * This makes the row item not selectable.
+     */
+    isSelectable?: boolean;
+    /**
+     * This makes the row item visually disabled.
+     */
+    isDisabled?: boolean;
+    /**
+     * A ref to the table row element
+     * The ref is an object where the key is the item id and the value is the table row element
+     */
+    rowRef?: React.MutableRefObject<Record<MrlTableItemId, HTMLTableRowElement>>;
+}
+export type MrlTableColumnSticky = 'left' | 'right';
+export interface MrlSmartTableColumn {
+    /**
+     * The key used to retrieve the cell value from the item object,
+     * e.g. `item[key]`.
+     */
+    id: MrlTableColumnId;
+    /**
+     * The display name of the column.
+     */
+    name: string;
+    /**
+     * The horizontal alignment of the column content.
+     * If not provided, the default alignment is left.
+     */
+    horizontalAlign?: MrlTableCellHorizontalAlign;
+    /**
+     * A component used to override rendering for each column cell. The
+     * component is expected to render a MrlTableColumn.
+     */
+    renderColumn?: (props: MrlSmartColumnRendererProps) => JSX.Element;
+    /**
+     * A component used to override rendering for each row cell. The
+     * component is expected to render a MrlTableCell.
+     */
+    renderCell?: (props: MrlSmartCellRendererProps) => JSX.Element;
+    /**
+     * Whether the column allows sorting.
+     */
+    allowsSorting?: boolean;
+    /**
+     * A sort comparator function for the column.
+     *
+     * @default sortAlphabeticallyAsCoercedStrings
+     */
+    sortBy?: (aValue: unknown, bValue: unknown) => number;
+    /**
+     * A sort comparator function for the column that receives the entire
+     * row context. Will override the `sortBy` function (if provided).
+     *
+     * @param aValue
+     * @param bValue
+     * @returns number
+     */
+    sortByRowContext?: (aValue: unknown, bValue: unknown) => number;
+    /**
+     * Whether the column is sticky
+     * the sticky effect will only work on the first or last column.
+     * Set to 'left' for the first column and 'right' for the last column
+     *
+     * @example The container of the table will need overflow:scroll/auto
+     * and the width will need to be constrained in order for
+     * the columns to be 'sticky'
+     */
+    sticky?: MrlTableColumnSticky;
+    /**
+     * A tooltip to display on the column header.
+     */
+    tooltip?: string;
+}
+/**
+ * A set of item ids.
+ */
+export type MrlTableSelection = Set<MrlTableItemId>;
+export interface MrlSmartTableSelectionOptions {
+    /**
+     * The type of selection that is allowed in the collection.
+     *
+     * @default none
+     */
+    mode: MrlTableSelectionMode;
+    /**
+     * The currently selected keys in the collection (controlled).
+     */
+    selectedKeys: MrlTableSelection;
+    /**
+     * Handler that is called when the selection changes.
+     */
+    onSelectionChange: (keys: MrlTableSelection) => void;
+}
+export interface MrlTableColumnSortOptions {
+    /**
+     * The column to sort by.
+     */
+    sortColumn: MrlSmartTableColumn;
+    /**
+     * The details of the sort.
+     */
+    sortDescriptor: MrlTableColumnSortDescriptor;
+}
+export interface MrlSmartTableProps extends Partial<Pick<MrlTableProps, 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'aria-details'>> {
+    /**
+     * A list of table columns.
+     */
+    columns: MrlSmartTableColumn[];
+    /**
+     * A list of items to populate the table.
+     */
+    items: MrlTableItem[];
+    /**
+     * When provided, enables and controls table selection.
+     */
+    selectionOptions?: MrlSmartTableSelectionOptions;
+    /**
+     * A prefix applied to each data-qa element within the table.
+     *
+     * @default "mrl-smart-table"
+     */
+    dataQaPrefix?: string;
+    /**
+     * Text to be displayed when there are no rows in the table.
+     * Will be ignored if `emptyState` is provided.
+     *
+     * @default "There's no data available to be displayed in this table."
+     */
+    emptyStateText?: string;
+    /**
+     * Provides content to display when there are no rows in the table.
+     *
+     * @default MrlTableEmptyState
+     */
+    emptyState?: JSX.Element;
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default ${id}-mrl-smart-table
+     */
+    id?: string;
+    /**
+     * A function to override the default sort items when a sort descriptor is set.
+     */
+    customSortItems?: ({ sortColumn, sortDescriptor }: MrlTableColumnSortOptions) => void;
+    /**
+     * Provides information on how the table should be sorted on initialization.
+     */
+    defaultSortDescriptor?: MrlTableColumnSortDescriptor;
+    /**
+     * Enables row virtualization using @tanstack/react-virtual. The table must live
+     * inside a container with a fixed height and vertical scroll for virtualization
+     * to function correctly.
+     *
+     * @default false
+     */
+    enableVirtualization?: boolean;
+}
+/**
+ * MrlSmartTable Component
+ *
+ * @param {MrlSmartTableProps} props - MrlSmartTable component props
+ * @returns a table
+ */
+export declare function MrlSmartTable(props: MrlSmartTableProps): JSX.Element;

package/dist/types/components/table/MrlSmartTable/components/DefaultCellContent.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { MrlSmartCellRendererProps } from '../MrlSmartTable';
+export declare const DefaultCellContent: ({ item, column, dataQaPrefix, tableElementId, hasScrollShadowLeft, hasScrollShadowRight }: MrlSmartCellRendererProps) => React.JSX.Element;
+export declare const MemoizedDefaultCellContent: React.MemoExoticComponent<({ item, column, dataQaPrefix, tableElementId, hasScrollShadowLeft, hasScrollShadowRight }: MrlSmartCellRendererProps) => React.JSX.Element>;

package/dist/types/components/table/MrlSmartTable/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlSmartTable';

package/dist/types/components/table/MrlSmartTable/storybook-utils.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+import { MrlSmartCellRendererProps, MrlSmartTableColumn } from './MrlSmartTable';
+export declare const LicenseCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const MemberSinceCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const LastSeenCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const CreateRoomCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const SeeOpenRoomsCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const PublishTemplatesCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const WorkspaceAdminCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const ActionsCell: ((props: MrlSmartCellRendererProps) => JSX.Element) | undefined;
+export declare const SAMPLE_COLUMNS_WITH_EDIT_ICON_BUTTON: MrlSmartTableColumn[];

package/dist/types/components/table/MrlTable/MrlTable.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+export interface MrlTableProps extends React.ComponentPropsWithoutRef<'table'> {
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default `${id}-mrl-table`
+     */
+    id?: string;
+}
+/**
+ * MrlTable Component
+ *
+ * @param {MrlTable} props - MrlTable component props
+ * @returns a table element
+ */
+export declare const MrlTable: React.ForwardRefExoticComponent<MrlTableProps & React.RefAttributes<HTMLTableElement>>;

package/dist/types/components/table/MrlTable/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTable';

package/dist/types/components/table/MrlTableBody/MrlTableBody.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+export interface MrlTableBodyProps extends React.ComponentPropsWithoutRef<'tbody'> {
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default `${id}-mrl-table-body`
+     */
+    id?: string;
+}
+/**
+ * MrlTableBody Component
+ *
+ * @param {MrlTableBodyProps} props - MrlTableBody component props
+ * @returns a table body element
+ */
+export declare function MrlTableBody({ className, ...rest }: MrlTableBodyProps): JSX.Element;

package/dist/types/components/table/MrlTableBody/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTableBody';

package/dist/types/components/table/MrlTableCell/MrlTableCell.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { MrlTableColumnSticky } from '../MrlSmartTable';
+import { MrlTableCellHorizontalAlign } from '../constants';
+export interface MrlTableCellProps extends React.ComponentPropsWithoutRef<'td'> {
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default `${id}-mrl-table-cell`
+     */
+    id?: string;
+    /**
+     * Whether this cell is sticky 'left' or sticky 'right' or not sticky at all
+     */
+    sticky?: MrlTableColumnSticky;
+    hasScrollShadowLeft?: boolean;
+    hasScrollShadowRight?: boolean;
+    horizontalAlign?: MrlTableCellHorizontalAlign;
+}
+/**
+ * MrlTableCell Component
+ *
+ * @param {MrlTableCellProps} props - MrlTableCell component props
+ * @returns a table cell element
+ */
+export declare function MrlTableCell(props: MrlTableCellProps): JSX.Element;

package/dist/types/components/table/MrlTableCell/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTableCell';

package/dist/types/components/table/MrlTableColumn/MrlTableColumn.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { MrlTableColumnSticky } from '../MrlSmartTable';
+import { MrlTableCellHorizontalAlign } from '../constants';
+export interface MrlTableColumnProps extends React.ComponentPropsWithoutRef<'th'> {
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default `${id}-mrl-table-column`
+     */
+    id?: string;
+    /**
+     * Whether this column is sticky 'left' or sticky 'right' or not sticky at all
+     */
+    sticky?: MrlTableColumnSticky;
+    hasScrollShadowLeft?: boolean;
+    hasScrollShadowRight?: boolean;
+    horizontalAlign?: MrlTableCellHorizontalAlign;
+}
+/**
+ * MrlTableColumn Component
+ *
+ * @param {MrlTableColumnProps} props - MrlTableColumn component props
+ * @returns a table column element
+ */
+export declare function MrlTableColumn(props: MrlTableColumnProps): JSX.Element;

package/dist/types/components/table/MrlTableColumn/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTableColumn';

package/dist/types/components/table/MrlTableEmptyState/MrlTableEmptyState.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="react" />
+interface MrlTableEmptyStateProps {
+    /**
+     * Text to be displayed in the empty state.
+     */
+    text?: string;
+}
+/**
+ * MrlTableEmptyState Component
+ * @param {MrlTableEmptyStateProps} props - MrlTableEmptyState component props
+ * @returns an empty state element
+ */
+export declare function MrlTableEmptyState({ text, ...rest }: MrlTableEmptyStateProps): JSX.Element;
+export {};

package/dist/types/components/table/MrlTableEmptyState/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTableEmptyState';

package/dist/types/components/table/MrlTableHeader/MrlTableHeader.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+export interface MrlTableHeaderProps extends React.ComponentPropsWithoutRef<'thead'> {
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default `${id}-mrl-table-header`
+     */
+    id?: string;
+}
+/**
+ * MrlTableHeader Component
+ *
+ * @param {MrlTableHeaderProps} props - MrlTableHeader component props
+ * @returns a table header element with a nested table row element
+ */
+export declare function MrlTableHeader({ children, className, ...rest }: MrlTableHeaderProps): JSX.Element;

package/dist/types/components/table/MrlTableHeader/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTableHeader';

package/dist/types/components/table/MrlTableRow/MrlTableRow.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+export interface MrlTableRowProps extends React.ComponentPropsWithoutRef<'tr'> {
+    /**
+     * An element id (and if not provided, a unique value decorated
+     * to prevent conflict with aria controls will be generated).
+     *
+     * @default `${id}-mrl-table-row`
+     */
+    id?: string;
+    /**
+     * Id of the MrlTableItem associated with the table row
+     */
+    itemId?: string;
+    /**
+     *
+     * Custom click handler to be used for mouse and keyboard selection of table row
+     */
+    onClick?: (e: React.MouseEvent<HTMLElement> | React.KeyboardEvent) => void;
+}
+/**
+ * MrlTableRow Component
+ *
+ * @param {MrlTableRowProps} props - MrlTableRow component props
+ * @returns a table row element
+ */
+export declare const MrlTableRow: React.ForwardRefExoticComponent<MrlTableRowProps & React.RefAttributes<Record<string, HTMLTableRowElement>>>;

package/dist/types/components/table/MrlTableRow/index.d.ts

@@ -0,0 +1 @@
+export * from './MrlTableRow';

package/dist/types/components/table/constants.d.ts

@@ -0,0 +1,22 @@
+export type MrlTableItemId = string;
+export type MrlTableColumnId = string;
+export declare enum MrlSortDirection {
+    ASC = 1,
+    DESC = -1
+}
+export interface MrlTableColumnSortDescriptor {
+    /**
+     * The key of the column to sort by.
+     */
+    column: MrlTableColumnId;
+    /**
+     * The direction to sort by.
+     */
+    direction: MrlSortDirection;
+    /**
+     * The name of the column to sort by.
+     */
+    name: string;
+}
+export type MrlTableSelectionMode = 'single' | 'multiple';
+export type MrlTableCellHorizontalAlign = 'left' | 'right';