@omnitron-dev/prism 0.1.3 → 0.3.0

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

@@ -0,0 +1,184 @@
+/**
+ * Table Component
+ *
+ * Enhanced table component with sorting, selection, and pagination.
+ *
+ * @module components/table
+ */
+import type { ReactNode, Ref } from 'react';
+import type { TableProps as MuiTableProps } from '@mui/material/Table';
+import type { SxProps, Theme } from '@mui/material/styles';
+export type SortOrder = 'asc' | 'desc';
+export interface TableColumn<T> {
+    /** Unique column identifier */
+    id: keyof T | string;
+    /** Column header label */
+    label: string;
+    /** Column width */
+    width?: number | string;
+    /** Minimum width */
+    minWidth?: number;
+    /** Alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Whether column is sortable */
+    sortable?: boolean;
+    /** Custom render function */
+    render?: (row: T, index: number) => ReactNode;
+    /** Format value for display */
+    format?: (value: unknown) => string;
+}
+export interface TableProps<T> extends Omit<MuiTableProps, 'children'> {
+    /** Table columns configuration */
+    columns: TableColumn<T>[];
+    /** Data rows */
+    data: T[];
+    /** Row key accessor */
+    rowKey?: keyof T | ((row: T) => string | number);
+    /** Enable row selection */
+    selectable?: boolean;
+    /** Selected row keys */
+    selected?: (string | number)[];
+    /** Selection change handler */
+    onSelectChange?: (selected: (string | number)[]) => void;
+    /** Enable sorting */
+    sortable?: boolean;
+    /** Current sort column */
+    sortBy?: string;
+    /** Current sort order */
+    sortOrder?: SortOrder;
+    /** Sort change handler */
+    onSortChange?: (column: string, order: SortOrder) => void;
+    /** Enable pagination */
+    paginated?: boolean;
+    /** Current page (0-indexed) */
+    page?: number;
+    /** Rows per page */
+    rowsPerPage?: number;
+    /** Total row count (for server-side pagination) */
+    totalRows?: number;
+    /** Page change handler */
+    onPageChange?: (page: number) => void;
+    /** Rows per page change handler */
+    onRowsPerPageChange?: (rowsPerPage: number) => void;
+    /** Rows per page options */
+    rowsPerPageOptions?: number[];
+    /** Empty state content */
+    emptyContent?: ReactNode;
+    /**
+     * Loading state. Renders placeholder rows in the body and suppresses the
+     * empty state, so the header and column widths stay put while data arrives.
+     */
+    loading?: boolean;
+    /** Placeholder rows drawn while `loading`. */
+    loadingRows?: number;
+    /** Dense padding */
+    dense?: boolean;
+    /** Sticky header */
+    stickyHeader?: boolean;
+    /** Container max height */
+    maxHeight?: number | string;
+    /** Row click handler */
+    onRowClick?: (row: T, index: number) => void;
+    /** Container styles */
+    containerSx?: SxProps<Theme>;
+}
+/**
+ * Table - Enhanced data table with sorting, selection, and pagination.
+ *
+ * @example
+ * ```tsx
+ * const columns: TableColumn<User>[] = [
+ *   { id: 'name', label: 'Name', sortable: true },
+ *   { id: 'email', label: 'Email' },
+ *   { id: 'status', label: 'Status', render: (row) => <Label>{row.status}</Label> },
+ * ];
+ *
+ * <Table
+ *   columns={columns}
+ *   data={users}
+ *   rowKey="id"
+ *   selectable
+ *   paginated
+ * />
+ * ```
+ */
+export declare function Table<T>({ columns, data, rowKey, selectable, selected, onSelectChange, sortable, sortBy, sortOrder, onSortChange, paginated, page, rowsPerPage, totalRows, onPageChange, onRowsPerPageChange, rowsPerPageOptions, emptyContent, loading, loadingRows, dense, stickyHeader, maxHeight, onRowClick, containerSx, sx, ref, ...other }: TableProps<T> & {
+    ref?: Ref<HTMLTableElement>;
+}): ReactNode;
+export interface UseTableOptions<T> {
+    /** Initial data */
+    data: T[];
+    /** Row key accessor */
+    rowKey?: keyof T | ((row: T) => string | number);
+    /** Default page */
+    defaultPage?: number;
+    /** Default rows per page */
+    defaultRowsPerPage?: number;
+    /** Default sort column */
+    defaultSortBy?: string;
+    /** Default sort order */
+    defaultSortOrder?: SortOrder;
+}
+export interface UseTableReturn<T> {
+    /** Current page */
+    page: number;
+    /** Set page */
+    setPage: (page: number) => void;
+    /** Rows per page */
+    rowsPerPage: number;
+    /** Set rows per page */
+    setRowsPerPage: (rowsPerPage: number) => void;
+    /** Sort column */
+    sortBy: string | undefined;
+    /** Sort order */
+    sortOrder: SortOrder;
+    /** Sort handler */
+    handleSort: (column: string, order: SortOrder) => void;
+    /** Selected keys */
+    selected: (string | number)[];
+    /** Set selected */
+    setSelected: (selected: (string | number)[]) => void;
+    /** Sorted and paginated data */
+    displayData: T[];
+    /** Total row count */
+    totalRows: number;
+    /** Reset all state */
+    reset: () => void;
+}
+/**
+ * useTable - Hook for managing table state.
+ *
+ * @example
+ * ```tsx
+ * function UserTable() {
+ *   const table = useTable({
+ *     data: users,
+ *     rowKey: 'id',
+ *     defaultSortBy: 'name',
+ *   });
+ *
+ *   return (
+ *     <Table
+ *       columns={columns}
+ *       data={table.displayData}
+ *       rowKey="id"
+ *       selectable
+ *       selected={table.selected}
+ *       onSelectChange={table.setSelected}
+ *       sortable
+ *       sortBy={table.sortBy}
+ *       sortOrder={table.sortOrder}
+ *       onSortChange={table.handleSort}
+ *       paginated
+ *       page={table.page}
+ *       rowsPerPage={table.rowsPerPage}
+ *       totalRows={table.totalRows}
+ *       onPageChange={table.setPage}
+ *       onRowsPerPageChange={table.setRowsPerPage}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useTable<T>({ data, defaultPage, defaultRowsPerPage, defaultSortBy, defaultSortOrder, }: UseTableOptions<T>): UseTableReturn<T>;
+//# sourceMappingURL=table.d.ts.map

package/dist/components/table/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/components/table/table.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+/**
+ * Tabs Component Exports
+ *
+ * @module components/tabs
+ */
+export { Tabs, TabPanel, useTabs, type TabsProps, type TabItem, type TabPanelProps, type UseTabsOptions, type UseTabsReturn, } from './tabs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tabs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tabs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC"}

package/dist/components/tabs/tabs.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Tabs Component
+ *
+ * Tabbed interface with panel support.
+ *
+ * @module components/tabs
+ */
+import type { ReactNode, ReactElement, ComponentProps } from 'react';
+import MuiTabs from '@mui/material/Tabs';
+/**
+ * Tab item definition.
+ */
+export interface TabItem {
+    /** Unique value for the tab */
+    value: string;
+    /** Tab label */
+    label: string;
+    /** Optional icon (must be a React element, not arbitrary ReactNode) */
+    icon?: ReactElement;
+    /** Tab content */
+    content?: ReactNode;
+    /** Disabled state */
+    disabled?: boolean;
+}
+/**
+ * Props for Tabs component.
+ */
+export interface TabsProps extends Omit<ComponentProps<typeof MuiTabs>, 'onChange' | 'value' | 'action'> {
+    /** Tab items configuration */
+    tabs?: TabItem[];
+    /** Controlled value */
+    value?: string;
+    /** Default value (uncontrolled) */
+    defaultValue?: string;
+    /** Change handler */
+    onChange?: (value: string) => void;
+    /** Tab panel children (alternative to tabs prop) */
+    children?: ReactNode;
+    /** Keep unmounted tabs in DOM */
+    keepMounted?: boolean;
+    /**
+     * Optional actions area rendered to the right of the tab strip
+     * (e.g. a primary "Create" button). Mirrors the action slot on
+     * `Breadcrumbs`. When set, the tab strip's bottom border moves
+     * onto the surrounding flex row so the divider runs full-width
+     * past the action area without breaking.
+     */
+    action?: ReactNode;
+}
+/**
+ * Tabs - Tabbed interface component.
+ *
+ * @example
+ * ```tsx
+ * // Using tabs prop
+ * <Tabs
+ *   tabs={[
+ *     { value: 'tab1', label: 'General', content: <GeneralSettings /> },
+ *     { value: 'tab2', label: 'Security', content: <SecuritySettings /> },
+ *     { value: 'tab3', label: 'Notifications', content: <NotificationSettings /> },
+ *   ]}
+ *   defaultValue="tab1"
+ * />
+ *
+ * // Using children
+ * <Tabs defaultValue="overview">
+ *   <TabPanel value="overview" label="Overview">
+ *     Overview content
+ *   </TabPanel>
+ *   <TabPanel value="details" label="Details">
+ *     Details content
+ *   </TabPanel>
+ * </Tabs>
+ * ```
+ */
+export declare function Tabs({ tabs, value: controlledValue, defaultValue, onChange, children, keepMounted, action, ...muiProps }: TabsProps): ReactNode;
+/**
+ * Props for TabPanel component.
+ */
+export interface TabPanelProps {
+    /** Unique value (must match Tabs value) */
+    value: string;
+    /** Tab label */
+    label?: string;
+    /** Optional icon (must be a React element, not arbitrary ReactNode) */
+    icon?: ReactElement;
+    /** Panel content */
+    children?: ReactNode;
+    /** Disabled state */
+    disabled?: boolean;
+}
+/**
+ * TabPanel - Individual tab panel for use with Tabs children pattern.
+ *
+ * @example
+ * ```tsx
+ * <Tabs defaultValue="tab1">
+ *   <TabPanel value="tab1" label="First">
+ *     First panel content
+ *   </TabPanel>
+ *   <TabPanel value="tab2" label="Second">
+ *     Second panel content
+ *   </TabPanel>
+ * </Tabs>
+ * ```
+ */
+export declare function TabPanel({ children }: TabPanelProps): ReactNode;
+/**
+ * Hook for managing tab state externally.
+ */
+export interface UseTabsOptions {
+    /** Initial tab value */
+    defaultValue?: string;
+    /** Callback when tab changes */
+    onChange?: (value: string) => void;
+}
+export interface UseTabsReturn {
+    /** Current tab value */
+    value: string;
+    /** Set the active tab */
+    setValue: (value: string) => void;
+    /** Props to spread on Tabs component */
+    tabsProps: {
+        value: string;
+        onChange: (value: string) => void;
+    };
+}
+/**
+ * useTabs - Hook for external tab state management.
+ *
+ * Uses proper memoization to prevent unnecessary re-renders.
+ *
+ * @example
+ * ```tsx
+ * const { tabsProps, value, setValue } = useTabs({ defaultValue: 'tab1' });
+ *
+ * return (
+ *   <>
+ *     <button onClick={() => setValue('tab2')}>Go to Tab 2</button>
+ *     <Tabs {...tabsProps} tabs={tabs} />
+ *   </>
+ * );
+ * ```
+ */
+export declare function useTabs({ defaultValue, onChange }?: UseTabsOptions): UseTabsReturn;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/components/tabs/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../src/components/tabs/tabs.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAkB,cAAc,EAAE,MAAM,OAAO,CAAC;AAErF,OAAO,OAAO,MAAM,oBAAoB,CAAC;AAIzC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,kBAAkB;IAClB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AAIH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtG,8BAA8B;IAC9B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAmB,EACnB,MAAM,EACN,GAAG,QAAQ,EACZ,EAAE,SAAS,GAAG,SAAS,CAoGvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,GAAG,SAAS,CAI/D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,wCAAwC;IACxC,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACnC,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,EAAE,YAAiB,EAAE,QAAQ,EAAE,GAAE,cAAmB,GAAG,aAAa,CAuB3F"}

package/dist/components/tag-cloud/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tag Cloud Component Exports
+ *
+ * @module components/tag-cloud
+ */
+export { TagCloud, type TagCloudProps, type TagCloudItem } from './tag-cloud.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tag-cloud/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tag-cloud/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/tag-cloud/tag-cloud.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Tag Cloud — visualises a list of tags as either a sized chip cloud
+ * (font-size proportional to popularity) or a vertical list with
+ * count + description.
+ *
+ * Generic over `T extends TagCloudItem` so callers pass their domain
+ * tag DTOs directly without mapping. Renders no domain assumptions;
+ * navigation is delegated via `onTagClick`, which is the consumer's
+ * job (react-router, next/link, etc.).
+ *
+ * Accessibility:
+ *  - List variant: each item is a button (MUI ListItemButton) with
+ *    aria-label that spells out the popularity rather than relying
+ *    on the visible count alone ("4 posts" not just "4").
+ *  - Cloud variant: chips carry an aria-label that names both the
+ *    tag and the relative weight, so screen readers don't see only
+ *    a font-size signal.
+ *  - Optional `trending` flag highlights a tag visually AND
+ *    semantically (aria-label suffix).
+ *
+ * @module components/tag-cloud
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+export interface TagCloudItem {
+    id: string;
+    name: string;
+    slug: string;
+    postCount: number;
+    description?: string | null;
+    /** Optional badge — drives the trending highlight. */
+    trending?: boolean;
+    /** Optional moderation status — 'featured' adds a subtle accent. */
+    status?: string;
+}
+export interface TagCloudProps<T extends TagCloudItem = TagCloudItem> {
+    tags: T[];
+    variant?: 'cloud' | 'list';
+    /** Called on activation. The consumer routes to the tag page. */
+    onTagClick?: (tag: T) => void;
+    /** Truncate to first N items. */
+    maxItems?: number;
+    /**
+     * Render the right-hand stat of a list-variant row. Defaults to
+     * the formatted postCount; override for custom signals
+     * (e.g. follower count, freshness).
+     */
+    renderStat?: (tag: T) => ReactNode;
+    /**
+     * Optional adornment shown after the tag name on cloud variant.
+     * Used to slot in a 🔥 / ⭐ icon component without bloating this
+     * file with icon assets.
+     */
+    renderAdornment?: (tag: T) => ReactNode;
+    sx?: SxProps<Theme>;
+}
+export declare function TagCloud<T extends TagCloudItem = TagCloudItem>({ tags, variant, onTagClick, maxItems, renderStat, renderAdornment, sx, }: TagCloudProps<T>): ReactNode;
+//# sourceMappingURL=tag-cloud.d.ts.map

package/dist/components/tag-cloud/tag-cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-cloud.d.ts","sourceRoot":"","sources":["../../../src/components/tag-cloud/tag-cloud.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAClE,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,iEAAiE;IACjE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC;IACnC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC;IACxC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAeD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EAC9D,IAAI,EACJ,OAAiB,EACjB,UAAU,EACV,QAAQ,EACR,UAAU,EACV,eAAe,EACf,EAAE,GACH,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAyH9B"}

package/dist/components/tiptap-renderer/index.d.ts

@@ -0,0 +1,2 @@
+export { TipTapRenderer, registerTipTapNode, type TipTapRendererProps, type TipTapDoc, type TipTapNode, type TipTapMark, } from './tiptap-renderer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tiptap-renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tiptap-renderer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/components/tiptap-renderer/tiptap-renderer.d.ts

@@ -0,0 +1,45 @@
+import { type ReactNode, type ComponentType, type ElementType } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+/** Return the URL if safe to interpolate into href/src; otherwise undefined. */
+export declare function sanitizeHref(url: unknown): string | undefined;
+export interface TipTapMark {
+    type: string;
+    attrs?: Record<string, any>;
+}
+export interface TipTapNode {
+    type: string;
+    content?: TipTapNode[];
+    text?: string;
+    marks?: TipTapMark[];
+    attrs?: Record<string, any>;
+}
+export interface TipTapDoc {
+    type: 'doc';
+    content: TipTapNode[];
+}
+type CustomNodeRenderer = ComponentType<{
+    node: TipTapNode;
+}>;
+export declare function registerTipTapNode(type: string, component: CustomNodeRenderer): void;
+export interface TipTapRendererProps {
+    /** TipTap JSON document */
+    content: TipTapDoc | Record<string, unknown> | null;
+    /** Additional CSS class */
+    className?: string;
+    /** MUI sx prop */
+    sx?: SxProps<Theme>;
+    /** Compact mode for chat messages, comments, etc. */
+    compact?: boolean;
+    /**
+     * Component used to render `internalLink` marks. Pass a router-aware
+     * component (e.g. `Link` from react-router-dom) to avoid full reloads.
+     */
+    linkComponent?: ElementType<{
+        to: string;
+        children?: ReactNode;
+        className?: string;
+    }>;
+}
+export declare function TipTapRenderer({ content, className, sx, compact, linkComponent }: TipTapRendererProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=tiptap-renderer.d.ts.map

package/dist/components/tiptap-renderer/tiptap-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiptap-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/tiptap-renderer/tiptap-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAMjB,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AA8B3D,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE7D;AAwBD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAMD,KAAK,kBAAkB,GAAG,aAAa,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAG9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,QAE7E;AA6aD,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpD,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvF;AAED,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,mBAAmB,sCAmBrG"}

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

@@ -0,0 +1,7 @@
+/**
+ * Tooltip Component Exports
+ *
+ * @module components/tooltip
+ */
+export { Tooltip, type TooltipProps } from './tooltip.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/tooltip/tooltip.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Tooltip Component
+ *
+ * Enhanced tooltip with custom styling and arrow support.
+ *
+ * @module components/tooltip
+ */
+import type { ReactNode, ReactElement } from 'react';
+import type { TooltipProps as MuiTooltipProps } from '@mui/material/Tooltip';
+/**
+ * Props for Tooltip component.
+ */
+export interface TooltipProps extends Omit<MuiTooltipProps, 'children'> {
+    /** Tooltip content */
+    title: ReactNode;
+    /** Element to attach tooltip to */
+    children: ReactElement;
+    /** Show arrow */
+    arrow?: boolean;
+    /** Tooltip placement */
+    placement?: MuiTooltipProps['placement'];
+    /** Max width */
+    maxWidth?: number | string;
+}
+/**
+ * Tooltip - Enhanced tooltip with custom styling.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip title="Delete item" placement="top">
+ *   <IconButton>
+ *     <DeleteIcon />
+ *   </IconButton>
+ * </Tooltip>
+ * ```
+ */
+export declare function Tooltip({ title, children, arrow, placement, maxWidth, ...other }: TooltipProps): ReactNode;
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/components/tooltip/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/tooltip.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IACrE,sBAAsB;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wBAAwB;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IACzC,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,KAAY,EACZ,SAAiB,EACjB,QAAc,EACd,GAAG,KAAK,EACT,EAAE,YAAY,GAAG,SAAS,CAuB1B"}

package/dist/components/virtual-list/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * VirtualList Component Exports
+ *
+ * @module components/virtual-list
+ */
+export { VirtualList, type VirtualListProps } from './virtual-list.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/virtual-list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/virtual-list/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/virtual-list/virtual-list.d.ts

@@ -0,0 +1,64 @@
+/**
+ * VirtualList — windowed list for variable-height rows.
+ *
+ * Wraps `@tanstack/react-virtual` with the most common ergonomic
+ * defaults: a scrolling viewport, dynamic height measurement (rows
+ * may expand and the list rebalances), and an optional infinite-load
+ * hook that fires when the user scrolls within `loadMoreThreshold`
+ * px of the bottom.
+ *
+ * Use cases that drove the API: audit log dialogs (rows can expand
+ * to reveal payloads), chat/message histories, paginated transaction
+ * tables. Items are keyed by the caller-supplied `getKey` so row
+ * identity survives reorder.
+ *
+ * @example
+ * ```tsx
+ * <VirtualList
+ *   items={trades}
+ *   getKey={(t) => t.id}
+ *   estimateSize={48}
+ *   maxHeight={500}
+ *   onEndReached={() => fetchNextPage()}
+ * >
+ *   {(trade) => <TradeRow trade={trade} />}
+ * </VirtualList>
+ * ```
+ */
+import { type ReactNode } from 'react';
+import { type BoxProps } from '@mui/material/Box';
+export interface VirtualListProps<T> {
+    /** Source items, in render order. */
+    items: readonly T[];
+    /** Stable key for each row — needed for reorders and dynamic measurement. */
+    getKey: (item: T, index: number) => string | number;
+    /** Render a single row. */
+    children: (item: T, index: number) => ReactNode;
+    /**
+     * Initial size estimate per row in px. The virtualizer will replace
+     * this with the measured size once each row mounts.
+     */
+    estimateSize?: number;
+    /**
+     * Number of items to render outside the visible window on each
+     * side. Higher values reduce blank flashes on fast scroll at the
+     * cost of more DOM. Default 5.
+     */
+    overscan?: number;
+    /**
+     * Cap on the scroll viewport height. The Box auto-fills its parent
+     * if not supplied — set this when the parent isn't height-bounded
+     * (e.g. inside a Dialog without `fullHeight`).
+     */
+    maxHeight?: number | string;
+    /** Fires when the user scrolls within `loadMoreThreshold` of the bottom. */
+    onEndReached?: () => void;
+    /** Distance from the bottom (px) at which `onEndReached` fires. Default 200. */
+    loadMoreThreshold?: number;
+    /** Forwarded to the outer scrolling Box for layout overrides. */
+    sx?: BoxProps['sx'];
+    /** Inner padding (px) — applied as content offset, not scroll padding. */
+    paddingY?: number;
+}
+export declare function VirtualList<T>({ items, getKey, children, estimateSize, overscan, maxHeight, onEndReached, loadMoreThreshold, sx, paddingY, }: VirtualListProps<T>): ReactNode;
+//# sourceMappingURL=virtual-list.d.ts.map

package/dist/components/virtual-list/virtual-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-list.d.ts","sourceRoot":"","sources":["../../../src/components/virtual-list/virtual-list.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,qCAAqC;IACrC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IACpD,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAChD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,EAAE,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAC7B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,YAAiB,EACjB,QAAY,EACZ,SAAS,EACT,YAAY,EACZ,iBAAuB,EACvB,EAAE,EACF,QAAY,GACb,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CA2EjC"}