@nice2dev/ui-core 1.0.10

package/dist/core/omniverkTypes.d.ts.map

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

package/dist/core/pluginSystem.d.ts

@@ -0,0 +1,97 @@
+/**
+ * NicePluginSystem — runtime plugin loading skeleton (v1.0.10 stub, E2.5).
+ *
+ * Goals:
+ *  - Discover, register, activate and deactivate plugins at runtime.
+ *  - Decouple plugin authors from internal modules via a typed `NicePluginContext`.
+ *  - Stay framework-agnostic: zero React imports, safe to use from SSR or workers.
+ *
+ * NOT IN SCOPE (deferred to v1.0.11+):
+ *  - Sandbox / iframe execution
+ *  - Permission prompts UI
+ *  - Marketplace fetching / version resolution
+ *  - Hot reload semantics
+ */
+/** Lifecycle phase a plugin is currently in. */
+export type NicePluginStatus = 'registered' | 'activating' | 'active' | 'deactivating' | 'inactive' | 'error';
+/** Permission a plugin may request. Coarse-grained by design. */
+export type NicePluginPermission = 'storage:read' | 'storage:write' | 'network:fetch' | 'ui:overlay' | 'ui:command' | 'theme:read' | 'i18n:contribute' | 'events:listen' | 'events:emit';
+/** Static metadata supplied by plugin authors. */
+export interface NicePluginManifest {
+    /** Stable, unique id (reverse-DNS recommended, e.g. `com.acme.timer`). */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** SemVer string. */
+    version: string;
+    /** Short description (≤ 160 chars). */
+    description?: string;
+    /** Author display name. */
+    author?: string;
+    /** Permissions the plugin requests. Empty = sandbox mode. */
+    permissions?: NicePluginPermission[];
+    /** IDs of other plugins this one depends on. */
+    dependsOn?: string[];
+    /** Optional entry-point hint (URL or module path). */
+    entry?: string;
+    /** Free-form metadata (icons, tags, marketplace info). */
+    meta?: Record<string, unknown>;
+}
+/** Runtime context handed to a plugin during activation. */
+export interface NicePluginContext {
+    /** The granted permissions (intersection of requested + host policy). */
+    readonly permissions: ReadonlySet<NicePluginPermission>;
+    /** Logger scoped to this plugin id. */
+    log: (level: 'debug' | 'info' | 'warn' | 'error', ...args: unknown[]) => void;
+    /** Subscribe to a host event. Returns an unsubscribe function. */
+    on: (event: string, handler: (payload: unknown) => void) => () => void;
+    /** Emit an event to the host (subject to `events:emit` permission). */
+    emit: (event: string, payload?: unknown) => void;
+    /** Persist a value (subject to `storage:write`). */
+    setItem: (key: string, value: unknown) => Promise<void>;
+    /** Read a previously stored value (subject to `storage:read`). */
+    getItem: <T = unknown>(key: string) => Promise<T | undefined>;
+}
+/** A loadable plugin module. */
+export interface NicePlugin {
+    manifest: NicePluginManifest;
+    /** Called once when the plugin is activated. */
+    activate(ctx: NicePluginContext): void | Promise<void>;
+    /** Called when the plugin is deactivated or unloaded. */
+    deactivate?(): void | Promise<void>;
+}
+/** Public registry record exposed to consumers. */
+export interface NicePluginRecord {
+    manifest: NicePluginManifest;
+    status: NicePluginStatus;
+    error?: string;
+    activatedAt?: number;
+}
+/** Options accepted by {@link createNicePluginSystem}. */
+export interface NicePluginSystemOptions {
+    /** Default permission policy. Returns the subset that should be granted. */
+    permissionPolicy?: (requested: ReadonlyArray<NicePluginPermission>, manifest: NicePluginManifest) => NicePluginPermission[];
+    /** Storage backend (defaults to in-memory map). */
+    storage?: {
+        getItem: (key: string) => Promise<unknown>;
+        setItem: (key: string, value: unknown) => Promise<void>;
+    };
+    /** Optional logger sink. */
+    logger?: (pluginId: string, level: 'debug' | 'info' | 'warn' | 'error', args: unknown[]) => void;
+}
+/** Public surface returned by {@link createNicePluginSystem}. */
+export interface NicePluginSystem {
+    register(plugin: NicePlugin): NicePluginRecord;
+    unregister(id: string): boolean;
+    activate(id: string): Promise<NicePluginRecord>;
+    deactivate(id: string): Promise<NicePluginRecord>;
+    list(): NicePluginRecord[];
+    get(id: string): NicePluginRecord | undefined;
+    on(event: 'register' | 'activate' | 'deactivate' | 'error', handler: (record: NicePluginRecord) => void): () => void;
+}
+/**
+ * Create a fresh plugin system instance. Multiple isolated systems can coexist
+ * (e.g. one per workspace, one for tests).
+ */
+export declare function createNicePluginSystem(options?: NicePluginSystemOptions): NicePluginSystem;
+//# sourceMappingURL=pluginSystem.d.ts.map

package/dist/core/pluginSystem.d.ts.map

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

package/dist/core/profiling.d.ts

@@ -0,0 +1,276 @@
+/**
+ * @file profiling.tsx
+ * @description Performance profiling tools for Nice2Dev UI components
+ *
+ * Features:
+ * - Component render profiling
+ * - Re-render detection
+ * - Performance marks and measures
+ * - React DevTools Profiler integration
+ * - User Timing API integration
+ * - Render count tracking
+ * - Performance regression detection
+ *
+ * @version 1.0.0
+ * @since 2026-03
+ * @license MIT
+ */
+import React from 'react';
+/**
+ * Render timing data
+ */
+export interface RenderTiming {
+    /** Component name */
+    componentName: string;
+    /** Unique render ID */
+    renderId: string;
+    /** Render phase */
+    phase: 'mount' | 'update' | 'nested-update';
+    /** Actual render duration (ms) */
+    actualDuration: number;
+    /** Base render duration without memoization (ms) */
+    baseDuration: number;
+    /** Start time relative to page load */
+    startTime: number;
+    /** Commit time */
+    commitTime: number;
+    /** Interactions that triggered render */
+    interactions: Set<{
+        id: number;
+        name: string;
+        timestamp: number;
+    }>;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Component render stats
+ */
+export interface RenderStats {
+    /** Component name */
+    componentName: string;
+    /** Total render count */
+    renderCount: number;
+    /** Mount count */
+    mountCount: number;
+    /** Update count */
+    updateCount: number;
+    /** Average render time (ms) */
+    avgRenderTime: number;
+    /** Max render time (ms) */
+    maxRenderTime: number;
+    /** Min render time (ms) */
+    minRenderTime: number;
+    /** Total render time (ms) */
+    totalRenderTime: number;
+    /** Last render timestamp */
+    lastRenderAt: number;
+    /** Slow render count (>16ms) */
+    slowRenderCount: number;
+}
+/**
+ * Profiler configuration
+ */
+export interface ProfilerConfig {
+    /** Enable profiling (default: true in dev) */
+    enabled?: boolean;
+    /** Log renders to console */
+    logToConsole?: boolean;
+    /** Slow render threshold (ms) */
+    slowRenderThreshold?: number;
+    /** Custom render callback */
+    onRender?: (timing: RenderTiming) => void;
+    /** Custom slow render callback */
+    onSlowRender?: (timing: RenderTiming) => void;
+    /** Sampling rate (0-1) */
+    samplingRate?: number;
+    /** Component names to ignore */
+    ignoreComponents?: string[];
+    /** Enable User Timing API marks */
+    enableUserTiming?: boolean;
+    /** Track individual props changes */
+    trackPropsChanges?: boolean;
+}
+/**
+ * Props change info
+ */
+export interface PropsChange {
+    propName: string;
+    oldValue: unknown;
+    newValue: unknown;
+    timestamp: number;
+}
+/**
+ * Performance mark
+ */
+export interface PerformanceMark {
+    name: string;
+    startTime: number;
+    duration?: number;
+    detail?: Record<string, unknown>;
+}
+/**
+ * Configure the profiler globally
+ *
+ * @example
+ * ```tsx
+ * configureProfiler({
+ *   enabled: true,
+ *   logToConsole: true,
+ *   slowRenderThreshold: 16,
+ *   onSlowRender: (timing) => reportSlowRender(timing),
+ * });
+ * ```
+ */
+export declare function configureProfiler(config: Partial<ProfilerConfig>): void;
+/**
+ * Get profiler stats for all components
+ */
+export declare function getProfilingStats(): Map<string, RenderStats>;
+/**
+ * Get profiling stats for a specific component
+ */
+export declare function getComponentStats(componentName: string): RenderStats | undefined;
+/**
+ * Get recent render timings
+ */
+export declare function getRecentTimings(limit?: number): RenderTiming[];
+/**
+ * Clear all profiling data
+ */
+export declare function clearProfilingData(): void;
+/**
+ * Get slow renders (above threshold)
+ */
+export declare function getSlowRenders(thresholdMs?: number): RenderTiming[];
+interface NiceProfilerProps {
+    /** Unique ID for the profiler */
+    id: string;
+    /** Children to profile */
+    children: React.ReactNode;
+    /** Additional render callback */
+    onRender?: (timing: RenderTiming) => void;
+    /** Additional slow render callback */
+    onSlowRender?: (timing: RenderTiming) => void;
+    /** Override slow threshold */
+    slowThreshold?: number;
+    /** Enable console logging for this profiler */
+    logToConsole?: boolean;
+}
+/**
+ * NiceProfiler - Wrapper component for profiling
+ *
+ * @example
+ * ```tsx
+ * <NiceProfiler id="DataGrid" onSlowRender={handleSlowRender}>
+ *   <NiceDataGrid data={data} />
+ * </NiceProfiler>
+ * ```
+ */
+export declare const NiceProfiler: React.FC<NiceProfilerProps>;
+/**
+ * Hook to track why a component re-rendered
+ *
+ * @example
+ * ```tsx
+ * function MyComponent({ items, onClick }) {
+ *   useWhyDidYouRender('MyComponent', { items, onClick });
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useWhyDidYouRender(componentName: string, props: Record<string, unknown>): void;
+/**
+ * HOC version of useWhyDidYouRender
+ */
+export declare function withWhyDidYouRender<P extends object>(Component: React.ComponentType<P>, displayName?: string): React.FC<P>;
+/**
+ * Hook to count component renders
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const renderCount = useRenderCount('MyComponent');
+ *   console.log('Render count:', renderCount);
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useRenderCount(componentName?: string): number;
+/**
+ * Start a performance mark
+ *
+ * @example
+ * ```tsx
+ * startMark('fetchData');
+ * await fetchData();
+ * const duration = endMark('fetchData');
+ * console.log('Fetch took:', duration, 'ms');
+ * ```
+ */
+export declare function startMark(name: string, detail?: Record<string, unknown>): void;
+/**
+ * End a performance mark and return duration
+ */
+export declare function endMark(name: string): number;
+/**
+ * Measure an async operation
+ */
+export declare function measureAsync<T>(name: string, operation: () => Promise<T>, detail?: Record<string, unknown>): Promise<T>;
+/**
+ * Measure a sync operation
+ */
+export declare function measureSync<T>(name: string, operation: () => T, detail?: Record<string, unknown>): T;
+/**
+ * Hook for measuring effect duration
+ */
+export declare function useMeasureEffect(name: string, effect: () => void | (() => void), deps: React.DependencyList): void;
+/**
+ * Get a complete performance report
+ */
+export declare function getPerformanceReport(): {
+    stats: RenderStats[];
+    slowRenders: RenderTiming[];
+    totalRenders: number;
+    avgRenderTime: number;
+    marks: PerformanceMark[];
+};
+/**
+ * Print performance report to console
+ */
+export declare function printPerformanceReport(): void;
+/**
+ * Save current stats as baseline for regression detection
+ */
+export declare function saveBaseline(): void;
+/**
+ * Compare current stats against baseline
+ */
+export declare function checkRegression(thresholdPercent?: number): Array<{
+    componentName: string;
+    metric: string;
+    baseline: number;
+    current: number;
+    changePercent: number;
+}>;
+interface ProfilerOverlayProps {
+    /** Position on screen */
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /** Initial collapsed state */
+    defaultCollapsed?: boolean;
+}
+/**
+ * Debug overlay showing profiling stats
+ *
+ * @example
+ * ```tsx
+ * {process.env.NODE_ENV === 'development' && <ProfilerOverlay position="bottom-right" />}
+ * ```
+ */
+export declare const ProfilerOverlay: React.FC<ProfilerOverlayProps>;
+/**
+ * Setup integration with React DevTools Profiler
+ */
+export declare function setupReactDevToolsIntegration(): void;
+export {};
+//# sourceMappingURL=profiling.d.ts.map

package/dist/core/profiling.d.ts.map

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

package/dist/core/responsive.d.ts

@@ -0,0 +1,107 @@
+export interface NiceBreakpoints {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    xxl: number;
+}
+export declare const NICE_BREAKPOINTS: NiceBreakpoints;
+export type NiceBreakpoint = keyof NiceBreakpoints;
+export interface UseBreakpointResult {
+    /** Current breakpoint name */
+    current: NiceBreakpoint;
+    /** Window width in pixels */
+    width: number;
+    /** True if viewport >= the given breakpoint */
+    isAbove: (bp: NiceBreakpoint) => boolean;
+    /** True if viewport < the given breakpoint */
+    isBelow: (bp: NiceBreakpoint) => boolean;
+    /** True if viewport is between two breakpoints (inclusive lower, exclusive upper) */
+    isBetween: (lower: NiceBreakpoint, upper: NiceBreakpoint) => boolean;
+    /** True if viewport is mobile (< md) */
+    isMobile: boolean;
+    /** True if viewport is tablet (md–lg) */
+    isTablet: boolean;
+    /** True if viewport is desktop (>= lg) */
+    isDesktop: boolean;
+}
+export declare function useBreakpoint(breakpoints?: NiceBreakpoints): UseBreakpointResult;
+export declare function useMediaQuery(query: string): boolean;
+/**
+ * Define a value per breakpoint. Missing breakpoints inherit from the
+ * nearest smaller breakpoint.
+ *
+ * @example
+ * const cols = useResponsiveValue({ xs: 1, sm: 2, lg: 4 });
+ * // On a 1024px screen (lg), cols = 4
+ * // On a 600px screen (sm), cols = 2
+ */
+export type NiceResponsiveValue<T> = T | Partial<Record<NiceBreakpoint, T>>;
+export declare function useResponsiveValue<T>(value: NiceResponsiveValue<T>, breakpoints?: NiceBreakpoints): T;
+export interface UseContainerSizeResult {
+    width: number;
+    height: number;
+}
+export declare function useContainerSize(ref: React.RefObject<HTMLElement | null>): UseContainerSizeResult;
+export interface UseDeviceResult {
+    /** Is a mobile device (phone/tablet based on screen + touch) */
+    isMobile: boolean;
+    /** Has touch capability */
+    isTouch: boolean;
+    /** Is a phone-sized device (< 768px and touch) */
+    isPhone: boolean;
+    /** Is a tablet-sized device (768-1024px and touch) */
+    isTablet: boolean;
+    /** Is a desktop device (no touch OR > 1024px) */
+    isDesktop: boolean;
+    /** Prefers reduced motion */
+    prefersReducedMotion: boolean;
+    /** Is in portrait orientation */
+    isPortrait: boolean;
+    /** Device pixel ratio */
+    pixelRatio: number;
+}
+export declare function useDevice(): UseDeviceResult;
+export type AdaptiveVariant = 'desktop' | 'tablet' | 'mobile';
+export interface UseAdaptiveVariantOptions {
+    /** Force a specific variant */
+    forceVariant?: AdaptiveVariant;
+    /** Breakpoints config */
+    breakpoints?: NiceBreakpoints;
+}
+/**
+ * Hook to determine which component variant to render.
+ * Returns 'mobile', 'tablet', or 'desktop' based on device.
+ */
+export declare function useAdaptiveVariant(options?: UseAdaptiveVariantOptions): AdaptiveVariant;
+export interface UseShowAtOptions {
+    /** Show at these breakpoints */
+    showAt?: NiceBreakpoint[];
+    /** Hide at these breakpoints */
+    hideAt?: NiceBreakpoint[];
+    /** Show only on mobile */
+    mobileOnly?: boolean;
+    /** Show only on desktop */
+    desktopOnly?: boolean;
+    /** Show only on tablet */
+    tabletOnly?: boolean;
+}
+/**
+ * Hook to determine visibility based on breakpoint.
+ */
+export declare function useShowAt(options?: UseShowAtOptions): boolean;
+export type ScreenOrientation = 'portrait' | 'landscape';
+export declare function useOrientation(): ScreenOrientation;
+export interface SafeAreaInsets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Hook to get safe area insets for notched devices.
+ * Returns CSS env() values as numbers.
+ */
+export declare function useSafeAreaInsets(): SafeAreaInsets;
+//# sourceMappingURL=responsive.d.ts.map

package/dist/core/responsive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../../src/core/responsive.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,gBAAgB,EAAE,eAO9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC;AAMnD,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,OAAO,CAAC;IACzC,8CAA8C;IAC9C,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,OAAO,CAAC;IACzC,qFAAqF;IACrF,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;IACrE,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAC3B,WAAW,GAAE,eAAkC,GAC9C,mBAAmB,CAuDrB;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAiBpD;AAID;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC7B,WAAW,GAAE,eAAkC,GAC9C,CAAC,CAkCH;AAID,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,sBAAsB,CAmBjG;AAID,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,IAAI,eAAe,CAkC3C;AAID,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,+BAA+B;IAC/B,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,yBAAyB;IACzB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CA4B3F;AAID,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,gCAAgC;IAChC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAsBjE;AAID,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD,wBAAgB,cAAc,IAAI,iBAAiB,CAGlD;AAID,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAsDlD"}

package/dist/core/rtl.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+export type NiceDirection = 'ltr' | 'rtl' | 'auto';
+export interface NiceRTLConfig {
+    direction: NiceDirection;
+}
+export interface NiceRTLProviderProps {
+    direction: NiceDirection;
+    children: React.ReactNode;
+}
+interface RTLContextValue {
+    direction: 'ltr' | 'rtl';
+    isRTL: boolean;
+    /**
+     * Flip a CSS logical value: swaps 'left' ↔ 'right',
+     * 'start' ↔ 'end' for RTL mode.
+     */
+    flip: (value: 'left' | 'right' | 'start' | 'end') => 'left' | 'right' | 'start' | 'end';
+    /**
+     * Flip a horizontal numeric value (e.g., margin-left → margin-right).
+     * Returns { marginInlineStart: v } style for use in inline styles.
+     */
+    flipStyle: (property: 'paddingLeft' | 'paddingRight' | 'marginLeft' | 'marginRight', value: string | number) => React.CSSProperties;
+}
+export declare const NiceRTLProvider: React.FC<NiceRTLProviderProps>;
+export declare function useNiceRTL(): RTLContextValue;
+/**
+ * Convert physical CSS properties to logical equivalents.
+ * Use these instead of left/right for RTL-safe components.
+ */
+export declare const logicalProps: {
+    marginStart: "marginInlineStart";
+    marginEnd: "marginInlineEnd";
+    paddingStart: "paddingInlineStart";
+    paddingEnd: "paddingInlineEnd";
+    borderStart: "borderInlineStart";
+    borderEnd: "borderInlineEnd";
+    insetStart: "insetInlineStart";
+    insetEnd: "insetInlineEnd";
+    start: "insetInlineStart";
+    end: "insetInlineEnd";
+    textAlign: {
+        start: "start";
+        end: "end";
+    };
+};
+export {};
+//# sourceMappingURL=rtl.d.ts.map

package/dist/core/rtl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl.d.ts","sourceRoot":"","sources":["../../src/core/rtl.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAqE,MAAM,OAAO,CAAC;AAI1F,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAID,UAAU,eAAe;IACvB,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,KAAK,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACxF;;;OAGG;IACH,SAAS,EAAE,CACT,QAAQ,EAAE,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,EACvE,KAAK,EAAE,MAAM,GAAG,MAAM,KACnB,KAAK,CAAC,aAAa,CAAC;CAC1B;AAWD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAgF1D,CAAC;AAMF,wBAAgB,UAAU,IAAI,eAAe,CAE5C;AAID;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;CAexB,CAAC"}

package/dist/core/sanitizeHtml.d.ts

@@ -0,0 +1,16 @@
+/**
+ * sanitizeHtml — lightweight HTML sanitizer for dangerouslySetInnerHTML.
+ *
+ * Strips known XSS vectors (script tags, event handlers, javascript: URIs)
+ * without requiring an external dependency. For full-featured sanitization,
+ * consider using DOMPurify.
+ */
+/** Remove <script> tags, event handler attributes, and dangerous URIs from HTML. */
+export declare function sanitizeHtml(html: string): string;
+/**
+ * Validate a URL for use in href/src attributes.
+ * Allows only http:, https:, data:image, blob:, and relative paths.
+ * Rejects javascript:, vbscript:, data:text/html, and other dangerous schemes.
+ */
+export declare function isSafeUrl(url: string): boolean;
+//# sourceMappingURL=sanitizeHtml.d.ts.map

package/dist/core/sanitizeHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeHtml.d.ts","sourceRoot":"","sources":["../../src/core/sanitizeHtml.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgB9C"}