@omnitron-dev/prism 0.1.3 → 0.3.0

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"}

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

@@ -0,0 +1,145 @@
+/**
+ * Stepper Component
+ *
+ * Multi-step wizard/stepper with custom styling.
+ *
+ * @module components/stepper
+ */
+import { type ReactNode } from 'react';
+import type { StepperProps as MuiStepperProps } from '@mui/material/Stepper';
+/**
+ * Step definition.
+ */
+export interface StepItem {
+    /** Step label */
+    label: string;
+    /** Step description */
+    description?: string;
+    /** Step content */
+    content?: ReactNode;
+    /** Optional step (can be skipped) */
+    optional?: boolean;
+    /** Step icon */
+    icon?: ReactNode;
+    /** Step is completed */
+    completed?: boolean;
+    /** Step has error */
+    error?: boolean;
+}
+/**
+ * Props for Stepper component.
+ */
+export interface StepperProps extends Omit<MuiStepperProps, 'children'> {
+    /** Steps to display */
+    steps: StepItem[];
+    /** Active step index */
+    activeStep?: number;
+    /** On step change */
+    onStepChange?: (step: number) => void;
+    /** Stepper orientation */
+    orientation?: 'horizontal' | 'vertical';
+    /** Allow non-linear navigation */
+    nonLinear?: boolean;
+    /** Alternative label placement (horizontal only) */
+    alternativeLabel?: boolean;
+    /** Show step content (vertical only) */
+    showContent?: boolean;
+}
+/**
+ * Stepper - Multi-step wizard/stepper.
+ *
+ * @example
+ * ```tsx
+ * <Stepper
+ *   steps={[
+ *     { label: 'Account', description: 'Create account' },
+ *     { label: 'Profile', description: 'Complete profile', optional: true },
+ *     { label: 'Verify', description: 'Verify email' },
+ *   ]}
+ *   activeStep={1}
+ *   onStepChange={(step) => setActiveStep(step)}
+ * />
+ * ```
+ */
+export declare function Stepper({ steps, activeStep, onStepChange, orientation, nonLinear, alternativeLabel, showContent, ...other }: StepperProps): ReactNode;
+/**
+ * Return type for useStepper hook.
+ */
+export interface UseStepperReturn {
+    /** Current active step */
+    activeStep: number;
+    /** Go to next step */
+    nextStep: () => void;
+    /** Go to previous step */
+    prevStep: () => void;
+    /** Go to specific step */
+    goToStep: (step: number) => void;
+    /** Reset to first step */
+    reset: () => void;
+    /** Is first step */
+    isFirstStep: boolean;
+    /** Is last step */
+    isLastStep: boolean;
+    /** Step is completed */
+    isCompleted: boolean;
+}
+/**
+ * Options for useStepper hook.
+ */
+export interface UseStepperOptions {
+    /** Initial step */
+    initialStep?: number;
+    /** Total steps */
+    totalSteps: number;
+    /** On step change callback */
+    onStepChange?: (step: number) => void;
+    /** On complete callback */
+    onComplete?: () => void;
+}
+/**
+ * useStepper - Hook for managing stepper state.
+ *
+ * @example
+ * ```tsx
+ * const stepper = useStepper({
+ *   totalSteps: 3,
+ *   onComplete: () => console.log('Done!'),
+ * });
+ *
+ * <Stepper steps={steps} activeStep={stepper.activeStep} />
+ * <Button onClick={stepper.prevStep} disabled={stepper.isFirstStep}>
+ *   Back
+ * </Button>
+ * <Button onClick={stepper.nextStep}>
+ *   {stepper.isLastStep ? 'Finish' : 'Next'}
+ * </Button>
+ * ```
+ */
+export declare function useStepper({ initialStep, totalSteps, onStepChange, onComplete, }: UseStepperOptions): UseStepperReturn;
+/**
+ * Props for StepperActions component.
+ */
+export interface StepperActionsProps {
+    /** Stepper hook return */
+    stepper: UseStepperReturn;
+    /** Back button label */
+    backLabel?: string;
+    /** Next button label */
+    nextLabel?: string;
+    /** Finish button label */
+    finishLabel?: string;
+    /** Disable next button */
+    disableNext?: boolean;
+    /** Custom actions */
+    actions?: ReactNode;
+}
+/**
+ * StepperActions - Common action buttons for stepper.
+ *
+ * @example
+ * ```tsx
+ * <StepperActions stepper={stepper} />
+ * ```
+ */
+export declare function StepperActions({ stepper, backLabel, nextLabel, finishLabel, disableNext, actions, }: StepperActionsProps): ReactNode;
+//# sourceMappingURL=stepper.d.ts.map

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

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

package/dist/components/svg-color/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SvgColor Component Exports
+ *
+ * @module components/svg-color
+ */
+export { SvgColor, createIconComponent, type SvgColorProps, type IconProps } from './svg-color.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/svg-color/index.d.ts.map

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

package/dist/components/svg-color/svg-color.d.ts

@@ -0,0 +1,80 @@
+/**
+ * SvgColor Component
+ *
+ * Colorable SVG icon component using CSS mask.
+ *
+ * @module components/svg-color
+ */
+import type { ReactNode, Ref } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+export interface SvgColorProps {
+    /** SVG file URL */
+    src: string;
+    /** Color (uses currentColor by default, inheriting from parent) */
+    color?: string;
+    /** Width and height */
+    size?: number | string;
+    /** Width */
+    width?: number | string;
+    /** Height */
+    height?: number | string;
+    /** Additional class name */
+    className?: string;
+    /** Additional styles */
+    sx?: SxProps<Theme>;
+}
+/**
+ * SvgColor - Colorable SVG component.
+ *
+ * This component uses CSS mask to allow SVG icons to inherit text color.
+ * The SVG file is loaded via URL and can be colored using the color prop
+ * or by inheriting from parent's color/text color.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <SvgColor src="/icons/check.svg" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom color
+ * <SvgColor
+ *   src="/icons/star.svg"
+ *   color="primary.main"
+ *   size={32}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Inherit color from parent
+ * <Box color="error.main">
+ *   <SvgColor src="/icons/alert.svg" />
+ *   Error message
+ * </Box>
+ * ```
+ */
+export declare function SvgColor({ src, color, size, width, height, className, sx, ref }: SvgColorProps & {
+    ref?: Ref<HTMLSpanElement>;
+}): import("react").JSX.Element;
+export interface IconProps extends Omit<SvgColorProps, 'src'> {
+    /** Icon name (without extension) */
+    name: string;
+    /** Base path for icons */
+    basePath?: string;
+}
+/**
+ * Creates an Icon component factory with a custom base path.
+ *
+ * @example
+ * ```tsx
+ * // Create icon component
+ * const Icon = createIconComponent('/assets/icons');
+ *
+ * // Use it
+ * <Icon name="home" size={24} />
+ * ```
+ */
+export declare function createIconComponent(basePath: string): ({ name, ...props }: IconProps) => ReactNode;
+//# sourceMappingURL=svg-color.d.ts.map

package/dist/components/svg-color/svg-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-color.d.ts","sourceRoot":"","sources":["../../../src/components/svg-color/svg-color.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CAAC,EAAC,GAAG,EAAE,KAAK,EAAE,IAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,aAAa,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;CAAE,+BAoBnI;AAMD,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;IAC3D,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,wBAChB,SAAS,KAAG,SAAS,CAIxD"}

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

@@ -0,0 +1,7 @@
+/**
+ * Table Component Exports
+ *
+ * @module components/table
+ */
+export { Table, useTable, type TableProps, type TableColumn, type SortOrder, type UseTableOptions, type UseTableReturn, } from './table.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/table/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,EACL,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}