@omnitron-dev/prism 0.2.0 → 0.3.1

package/dist/components/scrollbar/scrollbar.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Scrollbar Component
+ *
+ * Custom scrollbar wrapper with themed styling.
+ *
+ * @module components/scrollbar
+ */
+import type { ReactNode, Ref } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+export interface ScrollbarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Content to scroll */
+    children?: ReactNode;
+    /** Additional styles */
+    sx?: SxProps<Theme>;
+    /** Fill available content space */
+    fillContent?: boolean;
+    /** Hide scrollbar (content still scrollable) */
+    hideScrollbar?: boolean;
+    /** Reveal on hover or keyboard focus; native visibility on touch/high contrast. */
+    autoHide?: boolean;
+    /** Scrollbar axis */
+    axis?: 'x' | 'y' | 'both';
+    /** Max height constraint */
+    maxHeight?: number | string;
+    /** Min height constraint */
+    minHeight?: number | string;
+    /** Additional class name */
+    className?: string;
+    /** Scroll event handler */
+    onScroll?: React.UIEventHandler<HTMLDivElement>;
+}
+/**
+ * Scrollbar - Custom scrollbar wrapper with themed styling.
+ *
+ * @example
+ * ```tsx
+ * <Scrollbar maxHeight={400}>
+ *   <List>...</List>
+ * </Scrollbar>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Horizontal scrollbar
+ * <Scrollbar axis="x">
+ *   <Stack direction="row" spacing={2}>...</Stack>
+ * </Scrollbar>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Fill available space
+ * <Scrollbar fillContent>
+ *   {content}
+ * </Scrollbar>
+ * ```
+ */
+export declare function Scrollbar({ children, sx, fillContent, hideScrollbar, autoHide, axis, maxHeight, minHeight, className, ref, ...other }: ScrollbarProps & {
+    ref?: Ref<HTMLDivElement>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=scrollbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollbar.d.ts","sourceRoot":"","sources":["../../../src/components/scrollbar/scrollbar.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAI5C,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5F,wBAAwB;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,wBAAwB;IACxB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;CACjD;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,EAAE,EACF,WAAmB,EACnB,aAAqB,EACrB,QAAe,EACf,IAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,+BAyBhD"}

package/dist/components/search-input/index.d.ts

@@ -0,0 +1,2 @@
+export { SearchInput, type SearchInputProps } from './search-input.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/search-input/index.d.ts.map

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

package/dist/components/search-input/search-input.d.ts

@@ -0,0 +1,36 @@
+import type { Ref } from 'react';
+import { type SxProps, type Theme } from '@mui/material/styles';
+export interface SearchInputProps {
+    /** Current value (controlled). */
+    value?: string;
+    /** Change handler. Receives the raw string (or debounced string if `debounce` > 0). */
+    onChange?: (value: string) => void;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Debounce delay in ms. 0 = no debounce (default). */
+    debounce?: number;
+    /** Compact mode — smaller padding, for sidebars and tight spaces. */
+    compact?: boolean;
+    /** Full width. Default true. */
+    fullWidth?: boolean;
+    /** Fixed or min width. */
+    width?: number | string;
+    /** Min width. */
+    minWidth?: number | string;
+    /** Clear button tooltip text. */
+    clearTooltip?: string;
+    /** Autofocus on mount. */
+    autoFocus?: boolean;
+    /** Focus handler. */
+    onFocus?: () => void;
+    /** Blur handler. */
+    onBlur?: () => void;
+    /** Keyboard handler. */
+    onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    /** Custom sx overrides. */
+    sx?: SxProps<Theme>;
+}
+export declare function SearchInput({ value: controlledValue, onChange, placeholder, debounce, compact, fullWidth, width, minWidth, clearTooltip, autoFocus, onFocus, onBlur, onKeyDown, sx, ref, }: SearchInputProps & {
+    ref?: Ref<HTMLInputElement>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=search-input.d.ts.map

package/dist/components/search-input/search-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-input.d.ts","sourceRoot":"","sources":["../../../src/components/search-input/search-input.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,OAAO,EAAmB,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAkBjF,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wBAAwB;IACxB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC/D,2BAA2B;IAC3B,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EACR,WAAyB,EACzB,QAAY,EACZ,OAAe,EACf,SAAgB,EAChB,KAAK,EACL,QAAQ,EACR,YAAsB,EACtB,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,EAAE,EACF,GAAG,GACJ,EAAE,gBAAgB,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;CAAE,+BAiHpD"}

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

@@ -0,0 +1,10 @@
+/**
+ * Settings Components
+ *
+ * Provider and drawer for application settings management.
+ *
+ * @module components/settings
+ */
+export { SettingsProvider, useSettings, useSettingsDrawer, type SettingsProviderProps, type SettingsContextValue, type SettingsDrawerState, } from './settings-provider.js';
+export { SettingsDrawer, type SettingsDrawerProps, type SettingsSection } from './settings-drawer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/settings/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/components/settings/settings-drawer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Settings Drawer
+ *
+ * UI component for managing application settings.
+ * Displays configurable sections for theme, layout, and preferences.
+ *
+ * @module components/settings
+ */
+import { type ReactNode } from 'react';
+/**
+ * Settings drawer props.
+ */
+export interface SettingsDrawerProps {
+    /** Drawer width */
+    width?: number;
+    /** Sections to display */
+    sections?: SettingsSection[];
+}
+/**
+ * Available settings sections.
+ */
+export type SettingsSection = 'mode' | 'contrast' | 'direction' | 'presets' | 'primaryColor' | 'fontSize' | 'density' | 'navLayout' | 'stretch';
+/**
+ * Settings Drawer - Configurable settings panel.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage - must be inside SettingsProvider
+ * <SettingsDrawer />
+ *
+ * // With custom sections
+ * <SettingsDrawer
+ *   sections={['mode', 'presets', 'primaryColor']}
+ *   width={320}
+ * />
+ * ```
+ */
+export declare function SettingsDrawer({ width, sections }: SettingsDrawerProps): ReactNode;
+//# sourceMappingURL=settings-drawer.d.ts.map

package/dist/components/settings/settings-drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-drawer.d.ts","sourceRoot":"","sources":["../../../src/components/settings/settings-drawer.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA8BvC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,cAAc,GACd,UAAU,GACV,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AA6ed;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAW,EAAE,QAA2B,EAAE,EAAE,mBAAmB,GAAG,SAAS,CA2D3G"}

package/dist/components/settings/settings-provider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Settings Provider
+ *
+ * Provides settings context and drawer state management.
+ * Wraps the application to enable settings drawer access anywhere.
+ *
+ * @module components/settings
+ */
+import { type ReactNode } from 'react';
+import { type SettingsState, type SettingsValues } from '../../state/stores/settings.js';
+/**
+ * Settings drawer state and controls.
+ */
+export interface SettingsDrawerState {
+    /** Whether the drawer is open */
+    open: boolean;
+    /** Open the drawer */
+    onOpen: () => void;
+    /** Close the drawer */
+    onClose: () => void;
+    /** Toggle the drawer */
+    onToggle: () => void;
+}
+/**
+ * Settings context value.
+ */
+export interface SettingsContextValue {
+    /** Current settings values */
+    settings: SettingsValues;
+    /** Settings actions */
+    actions: Pick<SettingsState, 'setMode' | 'toggleMode' | 'setPreset' | 'setPrimaryColor' | 'setContrast' | 'setDirection' | 'setFontSize' | 'setFontFamily' | 'setDensity' | 'setCompactSidebar' | 'setNavLayout' | 'setNavColor' | 'setStretch' | 'updateSettings' | 'reset'>;
+    /** Whether settings can be reset (differ from defaults) */
+    canReset: boolean;
+    /** Drawer state and controls */
+    drawer: SettingsDrawerState;
+}
+/**
+ * Settings provider props.
+ */
+export interface SettingsProviderProps {
+    /** Child components */
+    children: ReactNode;
+    /** Initial drawer open state */
+    defaultOpen?: boolean;
+}
+/**
+ * Settings Provider - Provides settings state and drawer controls.
+ *
+ * @example
+ * ```tsx
+ * // In your app root
+ * function App() {
+ *   return (
+ *     <SettingsProvider>
+ *       <ThemeProvider theme={theme}>
+ *         <MyApp />
+ *         <SettingsDrawer />
+ *       </ThemeProvider>
+ *     </SettingsProvider>
+ *   );
+ * }
+ *
+ * // In any component
+ * function Header() {
+ *   const { drawer } = useSettings();
+ *   return <IconButton onClick={drawer.onOpen}><SettingsIcon /></IconButton>;
+ * }
+ * ```
+ */
+export declare function SettingsProvider({ children, defaultOpen }: SettingsProviderProps): ReactNode;
+/**
+ * Hook to access settings context.
+ *
+ * @returns Settings context value
+ * @throws If used outside of SettingsProvider
+ *
+ * @example
+ * ```tsx
+ * function ThemeToggle() {
+ *   const { settings, actions } = useSettings();
+ *   return (
+ *     <Switch
+ *       checked={settings.mode === 'dark'}
+ *       onChange={() => actions.toggleMode()}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useSettings(): SettingsContextValue;
+/**
+ * Hook to access only the drawer controls.
+ *
+ * @returns Drawer state and controls
+ * @throws If used outside of SettingsProvider
+ *
+ * @example
+ * ```tsx
+ * function SettingsButton() {
+ *   const drawer = useSettingsDrawer();
+ *   return <IconButton onClick={drawer.onOpen}><SettingsIcon /></IconButton>;
+ * }
+ * ```
+ */
+export declare function useSettingsDrawer(): SettingsDrawerState;
+//# sourceMappingURL=settings-provider.d.ts.map

package/dist/components/settings/settings-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-provider.d.ts","sourceRoot":"","sources":["../../../src/components/settings/settings-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAA6D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClG,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAM3G;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,uBAAuB;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,uBAAuB;IACvB,OAAO,EAAE,IAAI,CACX,aAAa,EACX,SAAS,GACT,YAAY,GACZ,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,aAAa,GACb,eAAe,GACf,YAAY,GACZ,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,OAAO,CACV,CAAC;IACF,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAYD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,WAAmB,EAAE,EAAE,qBAAqB,GAAG,SAAS,CAkGpG;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,IAAI,oBAAoB,CAQlD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAGvD"}

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

@@ -0,0 +1,7 @@
+/**
+ * Skeleton Component Exports
+ *
+ * @module components/skeleton
+ */
+export { Skeleton, CardSkeleton, TableSkeleton, type SkeletonProps, type SkeletonVariant, type CardSkeletonProps, type TableSkeletonProps, } from './skeleton.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/components/skeleton/skeleton.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Skeleton Component
+ *
+ * Loading placeholder with multiple variants.
+ *
+ * @module components/skeleton
+ */
+import type { ReactNode, ComponentProps } from 'react';
+import MuiSkeleton from '@mui/material/Skeleton';
+/**
+ * Skeleton variant types.
+ */
+export type SkeletonVariant = 'text' | 'circular' | 'rectangular' | 'rounded';
+/**
+ * Props for Skeleton component.
+ */
+export interface SkeletonProps extends ComponentProps<typeof MuiSkeleton> {
+    /** Skeleton variant */
+    variant?: SkeletonVariant;
+}
+/**
+ * Skeleton - Loading placeholder component.
+ *
+ * @example
+ * ```tsx
+ * // Text skeleton
+ * <Skeleton variant="text" width={200} />
+ *
+ * // Circular skeleton (avatar placeholder)
+ * <Skeleton variant="circular" width={40} height={40} />
+ *
+ * // Rectangular skeleton (image placeholder)
+ * <Skeleton variant="rectangular" width={210} height={118} />
+ * ```
+ */
+export declare function Skeleton({ variant, ...props }: SkeletonProps): ReactNode;
+/**
+ * Props for CardSkeleton component.
+ */
+export interface CardSkeletonProps {
+    /** Show avatar placeholder */
+    hasAvatar?: boolean;
+    /** Number of text lines */
+    lines?: number;
+    /** Card width */
+    width?: number | string;
+}
+/**
+ * CardSkeleton - Pre-composed card loading skeleton.
+ *
+ * @example
+ * ```tsx
+ * <CardSkeleton hasAvatar lines={3} />
+ * ```
+ */
+export declare function CardSkeleton({ hasAvatar, lines, width }: CardSkeletonProps): ReactNode;
+/**
+ * Props for TableSkeleton component.
+ */
+export interface TableSkeletonProps {
+    /** Number of rows */
+    rows?: number;
+    /** Number of columns */
+    columns?: number;
+    /** Show header */
+    hasHeader?: boolean;
+}
+/**
+ * TableSkeleton - Pre-composed table loading skeleton.
+ *
+ * @example
+ * ```tsx
+ * <TableSkeleton rows={5} columns={4} />
+ * ```
+ */
+export declare function TableSkeleton({ rows, columns, hasHeader }: TableSkeletonProps): ReactNode;
+//# sourceMappingURL=skeleton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../../src/components/skeleton/skeleton.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,WAAW,MAAM,wBAAwB,CAAC;AAGjD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,OAAO,WAAW,CAAC;IACvE,uBAAuB;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAgB,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAgB,EAAE,KAAS,EAAE,KAAc,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAoB1G;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,IAAQ,EAAE,OAAW,EAAE,SAAgB,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAmBxG"}

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

@@ -0,0 +1,7 @@
+/**
+ * Snackbar Component Exports
+ *
+ * @module components/snackbar
+ */
+export { SnackbarProvider, SimpleSnackbar, useSnackbar, type SnackbarOptions, type SnackbarContextValue, type SnackbarProviderProps, type SimpleSnackbarProps, } from './snackbar.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/snackbar/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC"}

package/dist/components/snackbar/snackbar.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Snackbar Component
+ *
+ * Enhanced snackbar with context-based API for easy notifications.
+ *
+ * @module components/snackbar
+ */
+import type { ReactNode } from 'react';
+import type { AlertColor } from '@mui/material/Alert';
+import type { SnackbarOrigin } from '@mui/material/Snackbar';
+import type { SxProps, Theme } from '@mui/material/styles';
+export interface SnackbarOptions {
+    /** Message to display */
+    message: string;
+    /** Severity/type of the snackbar */
+    severity?: AlertColor;
+    /** Auto-hide duration in milliseconds */
+    duration?: number;
+    /** Position on screen */
+    position?: SnackbarOrigin;
+    /** Action button */
+    action?: ReactNode;
+    /** Unique key for the snackbar */
+    key?: string | number;
+}
+export interface SnackbarContextValue {
+    /** Show a snackbar notification */
+    show: (options: SnackbarOptions | string) => void;
+    /** Show a success notification */
+    success: (message: string, options?: Partial<SnackbarOptions>) => void;
+    /** Show an error notification */
+    error: (message: string, options?: Partial<SnackbarOptions>) => void;
+    /** Show a warning notification */
+    warning: (message: string, options?: Partial<SnackbarOptions>) => void;
+    /** Show an info notification */
+    info: (message: string, options?: Partial<SnackbarOptions>) => void;
+    /** Close the current snackbar */
+    close: () => void;
+}
+export interface SnackbarProviderProps {
+    /** Children to wrap */
+    children: ReactNode;
+    /** Default auto-hide duration */
+    defaultDuration?: number;
+    /** Default position */
+    defaultPosition?: SnackbarOrigin;
+    /** Maximum number of snackbars to show */
+    maxSnackbars?: number;
+    /** Additional styles */
+    sx?: SxProps<Theme>;
+}
+/**
+ * useSnackbar - Hook for showing snackbar notifications.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const snackbar = useSnackbar();
+ *
+ *   const handleSave = async () => {
+ *     try {
+ *       await saveData();
+ *       snackbar.success('Data saved successfully!');
+ *     } catch (err) {
+ *       snackbar.error('Failed to save data');
+ *     }
+ *   };
+ * }
+ * ```
+ */
+export declare function useSnackbar(): SnackbarContextValue;
+/**
+ * SnackbarProvider - Provider for snackbar notifications.
+ *
+ * @example
+ * ```tsx
+ * // Wrap your app with the provider
+ * function App() {
+ *   return (
+ *     <SnackbarProvider>
+ *       <MyApp />
+ *     </SnackbarProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function SnackbarProvider({ children, defaultDuration, defaultPosition, sx, }: SnackbarProviderProps): ReactNode;
+export interface SimpleSnackbarProps {
+    /** Whether the snackbar is open */
+    open: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Message to display */
+    message: string;
+    /** Severity/type */
+    severity?: AlertColor;
+    /** Auto-hide duration in milliseconds */
+    duration?: number;
+    /** Position on screen */
+    position?: SnackbarOrigin;
+    /** Additional styles */
+    sx?: SxProps<Theme>;
+}
+/**
+ * SimpleSnackbar - Standalone snackbar component (without context).
+ *
+ * @example
+ * ```tsx
+ * const [open, setOpen] = useState(false);
+ *
+ * <SimpleSnackbar
+ *   open={open}
+ *   onClose={() => setOpen(false)}
+ *   message="Changes saved!"
+ *   severity="success"
+ * />
+ * ```
+ */
+export declare function SimpleSnackbar({ open, onClose, message, severity, duration, position, sx, }: SimpleSnackbarProps): ReactNode;
+//# sourceMappingURL=snackbar.d.ts.map

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

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

package/dist/components/sponsored-slot/index.d.ts

@@ -0,0 +1,3 @@
+export { SponsoredSlot } from './sponsored-slot.js';
+export { DEFAULT_SPONSORED_SLOT_LABELS, type SponsoredSlotContent, type SponsoredSlotLabels, type SponsoredSlotProps, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/sponsored-slot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/sponsored-slot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC"}

package/dist/components/sponsored-slot/sponsored-slot.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One advertising placement, as every page draws it.
+ *
+ * Always marked as advertising, by whom, and why it is here — the page's own
+ * context, never anything about the reader. Its words are the caller's (it
+ * knows the placement and the reader's language); the one word the slot says
+ * itself comes through `labels`.
+ *
+ * Its geometry is fixed by its variant, so a page can reserve the box while
+ * the placement is asked for (`loading`) and nothing moves when it arrives. A
+ * slot with nothing to show collapses to nothing: an empty frame reads as a
+ * broken page, and a placeholder «your ad here» is an ad for advertising.
+ */
+import { type SponsoredSlotProps } from './types.js';
+export declare function SponsoredSlot({ content, variant, loading, labels: labelsProp, icon, link, onOpen, id, }: SponsoredSlotProps): import("react").JSX.Element | null;
+//# sourceMappingURL=sponsored-slot.d.ts.map

package/dist/components/sponsored-slot/sponsored-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsored-slot.d.ts","sourceRoot":"","sources":["../../../src/components/sponsored-slot/sponsored-slot.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKpF,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,OAAgB,EAChB,OAAe,EACf,MAAM,EAAE,UAAU,EAClB,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,EAAE,GACH,EAAE,kBAAkB,sCA8EpB"}

package/dist/components/sponsored-slot/types.d.ts

@@ -0,0 +1,45 @@
+import type { ElementType, ReactNode } from 'react';
+/** The words a sponsored slot says itself; every other word is the caller's content. */
+export interface SponsoredSlotLabels {
+    /** What marks the slot as advertising when no advertiser is named. */
+    sponsored: string;
+}
+export declare const DEFAULT_SPONSORED_SLOT_LABELS: SponsoredSlotLabels;
+/** What one placement shows — already in the reader's language. */
+export interface SponsoredSlotContent {
+    title: string;
+    body?: string | null;
+    image?: string | null;
+    /** A logo is fitted, never cropped; a cover fills its frame. */
+    imageFit?: 'cover' | 'contain';
+    /** «By <advertiser>» — the caller's sentence; `labels.sponsored` when absent. */
+    byline?: string | null;
+    /** Why it is here: the page's own context, never anything about the reader. */
+    because?: string | null;
+    /** The call to action, when the slot leads somewhere. */
+    cta?: string | null;
+}
+export interface SponsoredSlotProps {
+    /** Nothing to show collapses the slot: no frame, no gap, no «empty ad». */
+    content: SponsoredSlotContent | null | undefined;
+    /** `tile` sits in a row of cards; `banner` takes a column's width. */
+    variant?: 'tile' | 'banner';
+    /**
+     * The placement is still being asked for: the slot keeps its box so the page
+     * does not jump when it arrives — and collapses if nothing does.
+     */
+    loading?: boolean;
+    labels?: Partial<SponsoredSlotLabels>;
+    /** The mark beside the byline; the caller's icon set. */
+    icon?: ReactNode;
+    /** Where the slot leads — a router link, an anchor. Absent, it is not clickable. */
+    link?: {
+        component: ElementType;
+        props?: Record<string, unknown>;
+    };
+    /** Called when the reader follows the link, after the navigation starts. */
+    onOpen?: () => void;
+    /** Rendered as `data-sponsored`, for the caller's own reporting and tests. */
+    id?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/sponsored-slot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/sponsored-slot/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpD,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAE3C,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,yDAAyD;IACzD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,SAAS,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACnE,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

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

@@ -0,0 +1,7 @@
+/**
+ * Stepper Component Exports
+ *
+ * @module components/stepper
+ */
+export { Stepper, StepperActions, useStepper, type StepperProps, type StepItem, type UseStepperReturn, type UseStepperOptions, type StepperActionsProps, } from './stepper.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/stepper/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EACP,cAAc,EACd,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC"}