@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/components/emoji-picker/twemoji-url.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Map a unicode emoji string to the Twemoji SVG URL on jsDelivr.
+ *
+ * Twitter's twemoji project ships one SVG per emoji codepoint sequence
+ * (e.g. `1f44d.svg`, `1f1ea-1f1fa.svg`). We don't bundle the SVGs — the
+ * CDN already does, and the browser caches them per session, so the
+ * net cost is one HTTP/2-multiplexed request per unique emoji.
+ *
+ * The dataset's `i` field already gives us the canonical hex sequence,
+ * but we also accept a raw unicode string so the standalone `<Emoji>`
+ * component doesn't need a lookup just to render an arbitrary glyph
+ * (e.g. when it comes back from the backend as a stored reaction).
+ *
+ * Implementation notes:
+ *   - Skip the variation-selector codepoint U+FE0F when present. Twemoji
+ *     filenames omit it (e.g. `2764.svg` not `2764-fe0f.svg`). This is
+ *     the most common reason a "valid" emoji shows the broken-image
+ *     icon if you mirror unicode naïvely.
+ *   - Skip the zero-width joiner only at the end of a sequence (it's
+ *     significant in ZWJ sequences and must stay between codepoints).
+ */
+/** Pre-built hexcode → URL form for the dataset's `i` field. */
+export declare function twemojiUrlFromHex(hexcode: string): string;
+/** Twemoji URL derived from a raw unicode string (e.g. "👍" or "👍🏻"). */
+export declare function twemojiUrlFromNative(native: string): string;
+//# sourceMappingURL=twemoji-url.d.ts.map

package/dist/components/emoji-picker/twemoji-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twemoji-url.d.ts","sourceRoot":"","sources":["../../../src/components/emoji-picker/twemoji-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAS3D"}

package/dist/components/emoji-picker/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Public types for the prism EmojiPicker.
+ *
+ * The picker is built around two surfaces: a one-line standalone
+ * `<Emoji>` renderer (used wherever a single emoji is shown — reaction
+ * chips, message content, etc.) and a `<EmojiPicker>` for selecting
+ * one. The `set` axis (native vs twitter) flows through both so a
+ * component tree can be locked to a consistent rendering scheme.
+ */
+/** Top-level dataset shape, loaded once per session via dynamic import. */
+export interface EmojiDataset {
+    v: number;
+    groups: string[];
+    emojis: EmojiEntry[];
+}
+/** A single emoji + its metadata, stored in a dense shape on disk. */
+export interface EmojiEntry {
+    /** Hex codepoint sequence, dash-separated for multi-cp (e.g. `1F1EA-1F1FA`). */
+    i: string;
+    /** Unicode form, ready to render natively. */
+    e: string;
+    /** Human-readable label (English). */
+    n: string;
+    /** Lower-cased search tokens (tags + label tokens, de-duped). */
+    k: string[];
+    /** Compact group index — see `EmojiDataset.groups`. */
+    g: number;
+}
+/** Visual style used to render an emoji. */
+export type EmojiSet = 'native' | 'twitter';
+/**
+ * Payload returned by `<EmojiPicker onSelect>` when the user picks
+ * an emoji. The fields mirror the public surface of every
+ * persisting caller in the downstream project so the picker is a drop-in for
+ * `emoji-mart`'s `{ native }` callback shape.
+ */
+export interface PickedEmoji {
+    /** The rendered unicode glyph. */
+    native: string;
+    /** Stable codepoint id (hexcode form, e.g. `1F44D`). */
+    id: string;
+    /** Human-readable label. */
+    name: string;
+}
+/** Props for the standalone `<Emoji>` renderer. */
+export interface EmojiProps {
+    /** The unicode glyph to render. */
+    native: string;
+    /** Visual set. Defaults to `'twitter'`. */
+    set?: EmojiSet;
+    /** Pixel size (square). Defaults to inherit (1em). */
+    size?: number;
+    /** Optional label for screen readers; falls back to `native`. */
+    alt?: string;
+}
+/** Props for the main `<EmojiPicker>` component. */
+export interface EmojiPickerProps {
+    /** Called when the user picks an emoji. */
+    onSelect: (emoji: PickedEmoji) => void;
+    /** Visual set used for emoji rendering inside the grid. */
+    set?: EmojiSet;
+    /** Emojis per row in the grid. Defaults to 8. */
+    perLine?: number;
+    /** Rendered emoji pixel size. Defaults to 24. */
+    emojiSize?: number;
+    /** Max emojis shown in the "Recent" row (capped at 32). */
+    maxRecent?: number;
+    /** Localised strings shown in the chrome. */
+    i18n?: Partial<EmojiPickerI18n>;
+    /** Optional className on the outer container. */
+    className?: string;
+}
+/** All localisable strings inside the picker. */
+export interface EmojiPickerI18n {
+    searchPlaceholder: string;
+    searchResults: string;
+    noResults: string;
+    loading: string;
+    previewHint: string;
+    clear: string;
+    categories: {
+        recent: string;
+        smileys: string;
+        people: string;
+        nature: string;
+        food: string;
+        travel: string;
+        activities: string;
+        objects: string;
+        symbols: string;
+        flags: string;
+    };
+}
+/** Default English copy used when no `i18n` prop is supplied. */
+export declare const DEFAULT_I18N: EmojiPickerI18n;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/emoji-picker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/emoji-picker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,CAAC,EAAE,MAAM,CAAC;IACV,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,iEAAiE;IACjE,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,uDAAuD;IACvD,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAChC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,iEAAiE;AACjE,eAAO,MAAM,YAAY,EAAE,eAmB1B,CAAC"}

package/dist/components/emoji-picker/use-emoji-data.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Module-level cached loader for the bundled emoji dataset.
+ *
+ * The JSON ships inside the `components/emoji-picker` chunk (see
+ * `tsup.config.ts`). Apps that lazy-load this chunk (via React.lazy /
+ * dynamic import) pay zero until the picker mounts — that's the
+ * intended pattern documented in this component's README.
+ *
+ * Once the chunk is loaded, parsing the JSON is synchronous and
+ * memoised here so a second `<EmojiPicker>` mount in the same session
+ * reuses the indexed structures rather than rebuilding the search
+ * blob (~1900 string concatenations).
+ */
+import type { EmojiDataset, EmojiEntry } from './types.js';
+interface LoadedData {
+    dataset: EmojiDataset;
+    indexById: Map<string, EmojiEntry>;
+    /** Lower-cased "name + keywords" string per emoji, in dataset order. */
+    searchTokens: string[];
+}
+export declare function useEmojiData(): {
+    data: LoadedData | null;
+    error: Error | null;
+};
+export {};
+//# sourceMappingURL=use-emoji-data.d.ts.map

package/dist/components/emoji-picker/use-emoji-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-emoji-data.d.ts","sourceRoot":"","sources":["../../../src/components/emoji-picker/use-emoji-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,UAAU,UAAU;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,wEAAwE;IACxE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAkBD,wBAAgB,YAAY,IAAI;IAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAc/E"}

package/dist/components/emoji-picker/use-recent-emojis.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Persists the user's recently-picked emojis in localStorage.
+ *
+ * Storage key is namespaced so multiple apps consuming prism don't
+ * step on each other's MRU lists. Values are stored as a JSON array of
+ * `id` strings (hexcode + optional tone suffix) — the picker
+ * re-resolves to the full emoji entry at render time via the dataset
+ * index, so we don't keep stale labels around if the dataset bumps.
+ */
+export interface UseRecentEmojis {
+    recent: string[];
+    push: (id: string) => void;
+    clear: () => void;
+}
+export declare function useRecentEmojis(limit?: number): UseRecentEmojis;
+//# sourceMappingURL=use-recent-emojis.d.ts.map

package/dist/components/emoji-picker/use-recent-emojis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-recent-emojis.d.ts","sourceRoot":"","sources":["../../../src/components/emoji-picker/use-recent-emojis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4BH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,eAAe,CAoCnE"}

package/dist/components/empty-content/empty-content.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Empty Content Component
+ *
+ * Universal placeholder for empty states across the application.
+ * Supports icon-based illustrations, multiple action buttons,
+ * filled backgrounds, and compact mode.
+ *
+ * @module components/empty-content
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+export interface EmptyContentProps {
+    /** Custom illustration (SVG, image, or any ReactNode) */
+    illustration?: ReactNode;
+    /** Icon element — rendered inside a circular colored wrapper */
+    icon?: ReactNode;
+    /** Color for the icon wrapper background (palette path like 'primary.main') */
+    iconColor?: string;
+    /** Size of the icon wrapper (default 64) */
+    iconSize?: number;
+    /** Main title text */
+    title?: string;
+    /** Description text or ReactNode */
+    description?: ReactNode;
+    /** Single action button (backward compatible) */
+    action?: ReactNode;
+    /** Multiple action buttons rendered in a row */
+    actions?: ReactNode[];
+    /** Max width of the container */
+    maxWidth?: number | string;
+    /** Fill the entire available space (height: 100%) */
+    filled?: boolean;
+    /** Additional styles for root container */
+    sx?: SxProps<Theme>;
+    /** Illustration wrapper styles */
+    illustrationSx?: SxProps<Theme>;
+    /** Slot overrides */
+    slotProps?: {
+        title?: SxProps<Theme>;
+        description?: SxProps<Theme>;
+        actions?: SxProps<Theme>;
+    };
+    /** Compact mode — reduces spacing and font sizes */
+    compact?: boolean;
+}
+/**
+ * EmptyContent - Universal empty state placeholder.
+ *
+ * @example Basic
+ * ```tsx
+ * <EmptyContent title="No data found" description="Try adjusting your filters" />
+ * ```
+ *
+ * @example With icon
+ * ```tsx
+ * <EmptyContent
+ *   icon={<ChatIcon sx={{ width: 28, height: 28, color: 'primary.main', opacity: 0.6 }} />}
+ *   title="Select a conversation"
+ *   description="Choose a room from the sidebar"
+ * />
+ * ```
+ *
+ * @example With multiple actions
+ * ```tsx
+ * <EmptyContent
+ *   icon={<FolderIcon sx={{ fontSize: 28, color: 'text.disabled' }} />}
+ *   title="No files yet"
+ *   description="Upload files or create a folder to get started"
+ *   actions={[
+ *     <Button variant="contained" startIcon={<UploadIcon />}>Upload</Button>,
+ *     <Button variant="outlined" startIcon={<FolderIcon />}>New folder</Button>,
+ *   ]}
+ * />
+ * ```
+ *
+ * @example Filled (full height)
+ * ```tsx
+ * <EmptyContent filled title="No messages" compact />
+ * ```
+ */
+export declare function EmptyContent({ illustration, icon, iconColor, iconSize, title, description, action, actions, maxWidth, filled, sx, illustrationSx, slotProps, compact, }: EmptyContentProps): ReactNode;
+/**
+ * Search Empty Content - Specialized empty state for search results.
+ */
+export declare function SearchEmptyContent({ query, ...props }: Omit<EmptyContentProps, 'title' | 'description'> & {
+    query?: string;
+}): ReactNode;
+/**
+ * Loading Empty Content - Placeholder while loading.
+ */
+export declare function LoadingEmptyContent({ ...props }: Omit<EmptyContentProps, 'title'>): ReactNode;
+//# sourceMappingURL=empty-content.d.ts.map

package/dist/components/empty-content/empty-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-content.d.ts","sourceRoot":"","sources":["../../../src/components/empty-content/empty-content.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gEAAgE;IAChE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,kCAAkC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,qBAAqB;IACrB,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;KAC1B,CAAC;IACF,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY,CAAC,EAC3B,YAAY,EACZ,IAAI,EACJ,SAA0B,EAC1B,QAAa,EACb,KAAiB,EACjB,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAc,EACd,MAAc,EACd,EAAE,EACF,cAAc,EACd,SAAS,EACT,OAAe,GAChB,EAAE,iBAAiB,GAAG,SAAS,CAwG/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,aAAa,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAUnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,SAAS,CAyB7F"}

package/dist/components/empty-content/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Empty Content Component Exports
+ *
+ * @module components/empty-content
+ */
+export { EmptyContent, SearchEmptyContent, LoadingEmptyContent, type EmptyContentProps } from './empty-content.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/empty-content/index.d.ts.map

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

package/dist/components/error-boundary/error-boundary.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Error Boundary Component
+ *
+ * React error boundary for graceful error handling.
+ * Includes stack trace parsing for improved debugging.
+ *
+ * @module components/error-boundary
+ */
+import { Component, type ReactNode, type ErrorInfo } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+/**
+ * Parsed stack frame information.
+ */
+export interface StackFrame {
+    /** Function or method name */
+    functionName: string | null;
+    /** Source file path */
+    filePath: string | null;
+    /** Line number in the file */
+    lineNumber: number | null;
+    /** Column number in the file */
+    columnNumber: number | null;
+    /** Whether this frame is from app code (src/) vs node_modules */
+    isAppCode: boolean;
+}
+/**
+ * Parsed stack trace result.
+ */
+export interface ParsedStackTrace {
+    /** Primary error location (first app code frame) */
+    primary: StackFrame | null;
+    /** All parsed frames */
+    frames: StackFrame[];
+    /** Original stack trace string */
+    raw: string;
+}
+/**
+ * Parse an error stack trace into structured data.
+ *
+ * Extracts function names, file paths, and line numbers from stack traces.
+ * Identifies app code vs library code for better debugging.
+ *
+ * @param stack - Error stack trace string
+ * @returns Parsed stack trace with frames
+ *
+ * @example
+ * ```tsx
+ * try {
+ *   throw new Error('Something went wrong');
+ * } catch (error) {
+ *   const parsed = parseStackTrace(error.stack);
+ *   console.log('Error in:', parsed.primary?.filePath);
+ *   console.log('Function:', parsed.primary?.functionName);
+ *   console.log('Line:', parsed.primary?.lineNumber);
+ * }
+ * ```
+ */
+export declare function parseStackTrace(stack?: string): ParsedStackTrace;
+/**
+ * Get a summary of the error location.
+ *
+ * @param error - Error object
+ * @returns Human-readable error location
+ */
+export declare function getErrorLocation(error: Error): string;
+/**
+ * Error fallback component props.
+ */
+export interface FallbackProps {
+    /** The error that was caught */
+    error: Error;
+    /** Error info from React */
+    errorInfo: ErrorInfo | null;
+    /** Parsed stack trace for debugging */
+    parsedStack: ParsedStackTrace;
+    /** Reset error boundary state */
+    resetErrorBoundary: () => void;
+}
+/**
+ * Error boundary props.
+ */
+export interface ErrorBoundaryProps {
+    /** Child components to render */
+    children: ReactNode;
+    /** Custom fallback component */
+    fallback?: ReactNode | ((props: FallbackProps) => ReactNode);
+    /** Callback when error is caught */
+    onError?: (error: Error, errorInfo: ErrorInfo, parsedStack: ParsedStackTrace) => void;
+    /** Callback when error is reset */
+    onReset?: () => void;
+    /** Reset keys - boundary resets when these change */
+    resetKeys?: unknown[];
+    /** Custom sx props for default fallback */
+    sx?: SxProps<Theme>;
+    /** Show detailed stack info in default fallback (auto-detects dev mode if not set) */
+    showDetails?: boolean;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+    errorInfo: ErrorInfo | null;
+}
+/**
+ * Error Boundary - Catches JavaScript errors in child components.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary
+ *   fallback={({ error, resetErrorBoundary }) => (
+ *     <div>
+ *       <p>Error: {error.message}</p>
+ *       <button onClick={resetErrorBoundary}>Retry</button>
+ *     </div>
+ *   )}
+ *   onError={(error, info) => logErrorToService(error, info)}
+ * >
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With reset keys
+ * <ErrorBoundary resetKeys={[userId, postId]}>
+ *   <UserPost userId={userId} postId={postId} />
+ * </ErrorBoundary>
+ * ```
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
+    resetErrorBoundary: () => void;
+    render(): ReactNode;
+}
+/**
+ * Hook to throw errors from event handlers.
+ * Useful for triggering error boundary from async code.
+ *
+ * @returns Function to throw an error
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const throwError = useErrorBoundary();
+ *
+ *   const handleClick = async () => {
+ *     try {
+ *       await fetchData();
+ *     } catch (error) {
+ *       throwError(error as Error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleClick}>Fetch</button>;
+ * }
+ * ```
+ */
+export declare function useErrorBoundary(): (error: Error) => void;
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/components/error-boundary/error-boundary.d.ts.map

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

package/dist/components/error-boundary/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error Boundary Component
+ *
+ * @module components/error-boundary
+ */
+export { ErrorBoundary, useErrorBoundary, parseStackTrace, getErrorLocation, type ErrorBoundaryProps, type FallbackProps, type StackFrame, type ParsedStackTrace, } from './error-boundary.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/error-boundary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/error-boundary/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/components/field/field-autocomplete.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Field.Autocomplete Component
+ *
+ * React Hook Form integrated autocomplete with search.
+ *
+ * @module components/field
+ */
+import type { ReactNode } from 'react';
+import type { TextFieldProps } from '@mui/material/TextField';
+/**
+ * Option for autocomplete.
+ */
+export interface AutocompleteOption {
+    /** Option value */
+    value: string | number;
+    /** Display label */
+    label: string;
+    /** Optional group */
+    group?: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+/**
+ * Props for Field.Autocomplete component.
+ */
+export interface FieldAutocompleteProps {
+    /** Field name in the form */
+    name: string;
+    /** Autocomplete options */
+    options: AutocompleteOption[];
+    /** Field label */
+    label?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Helper text */
+    helperText?: string;
+    /** Props passed to TextField */
+    textFieldProps?: Partial<TextFieldProps>;
+    /** Disable clearable */
+    disableClearable?: boolean;
+    /** Disable close on select */
+    disableCloseOnSelect?: boolean;
+    /** Loading state */
+    loading?: boolean;
+    /** Loading text */
+    loadingText?: ReactNode;
+    /** No options text */
+    noOptionsText?: ReactNode;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Read only state */
+    readOnly?: boolean;
+    /** Full width */
+    fullWidth?: boolean;
+    /** Size */
+    size?: 'small' | 'medium';
+}
+/**
+ * Field.Autocomplete - Autocomplete with React Hook Form integration.
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Autocomplete
+ *     name="country"
+ *     label="Country"
+ *     options={countries}
+ *     placeholder="Select a country..."
+ *   />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldAutocomplete({ name, options, label, placeholder, helperText, textFieldProps, disableClearable, disableCloseOnSelect, loading, loadingText, noOptionsText, disabled, readOnly, fullWidth, size, }: FieldAutocompleteProps): ReactNode;
+//# sourceMappingURL=field-autocomplete.d.ts.map

package/dist/components/field/field-autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-autocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-autocomplete.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8BAA8B;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB;IACnB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,sBAAsB;IACtB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW;IACX,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,OAAO,EACP,KAAK,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAgB,EAChB,IAAI,GACL,EAAE,sBAAsB,GAAG,SAAS,CA8CpC"}

package/dist/components/field/field-checkbox.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Field.Checkbox Component
+ *
+ * React Hook Form integrated checkbox field with full accessibility support.
+ *
+ * @module components/field
+ */
+import type { ReactNode, ComponentProps } from 'react';
+import { type RegisterOptions } from 'react-hook-form';
+import Checkbox from '@mui/material/Checkbox';
+/**
+ * Props for Field.Checkbox component.
+ */
+export interface FieldCheckboxProps extends Omit<ComponentProps<typeof Checkbox>, 'name'> {
+    /** Field name in the form */
+    name: string;
+    /** Checkbox label */
+    label?: ReactNode;
+    /** Helper text */
+    helperText?: string;
+    /** Validation rules for react-hook-form */
+    rules?: RegisterOptions;
+}
+/**
+ * Field.Checkbox - Checkbox with React Hook Form integration.
+ *
+ * Includes comprehensive accessibility attributes:
+ * - aria-describedby for helper text and error messages
+ * - aria-invalid for error states
+ * - aria-required for required fields
+ * - Proper label associations
+ *
+ * @example
+ * ```tsx
+ * <FormProvider {...methods}>
+ *   <Field.Checkbox name="terms" label="I agree to the terms" />
+ *   <Field.Checkbox name="newsletter" label="Subscribe to newsletter" />
+ * </FormProvider>
+ * ```
+ */
+export declare function FieldCheckbox({ name, label, helperText, rules, required, indeterminate, ...other }: FieldCheckboxProps): ReactNode;
+//# sourceMappingURL=field-checkbox.d.ts.map

package/dist/components/field/field-checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/field/field-checkbox.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAK9C;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,EAAE,MAAM,CAAC;IACvF,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,UAAU,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,SAAS,CAwChC"}