tekivex-ui 2.5.15 → 2.6.0

package/dist/src/engine/tkx.d.ts

@@ -1,57 +1,9 @@
 export type TkxInput = string | false | null | undefined | TkxInput[] | Record<string, boolean>;
-/**
- * TKX — The utility class engine.
- *
- * Better than Tailwind because:
- * - TRUE conflict resolution (p-4 p-8 → one class with padding:32px, no cascade hacks)
- * - Theme-aware tokens read from CSS variables automatically
- * - Single merged class per call — cleaner DOM
- * - No config, no plugins, no PostCSS, no purge
- * - Works SSR-first
- *
- * @example
- * tkx('flex items-center gap-4 p-4 bg-surface rounded-lg')
- * tkx('flex', { 'bg-primary': isActive, 'bg-surface': !isActive }, ['p-4', '@md:p-8'])
- * tkx('text-primary hover:text-secondary transition-colors duration-200')
- */
 export declare function tkx(...inputs: TkxInput[]): string;
-/** Alias — shorter to type in JSX */
 export declare const tx: typeof tkx;
-/** Extract all registered CSS for server-side rendering injection */
 export declare function extractAtomicCSS(): string;
-/** Reset registry (useful for per-request SSR isolation) */
 export declare function resetAtomicCSS(): void;
-/**
- * Merge existing class name strings without generating new CSS.
- * Use this to combine a tkx() result with a consumer-provided className prop.
- */
 export declare function cx(...classes: (string | false | null | undefined)[]): string;
-/**
- * TKX Plugin API — extend the utility engine with custom utilities.
- *
- * @example
- * ```tsx
- * import { tkxPlugin, tkx } from '@tekivex/ui';
- *
- * // Register custom utilities
- * tkxPlugin({
- *   name: 'brand',
- *   utilities: {
- *     'brand-gradient': { background: 'linear-gradient(135deg, #667eea, #764ba2)' },
- *     'brand-text': { color: '#667eea', fontWeight: '700' },
- *     'card-shadow': { boxShadow: '0 8px 32px rgba(102, 126, 234, 0.15)' },
- *     'glass': {
- *       background: 'rgba(255, 255, 255, 0.05)',
- *       backdropFilter: 'blur(12px)',
- *       border: '1px solid rgba(255, 255, 255, 0.1)',
- *     },
- *   },
- * });
- *
- * // Use them like any built-in utility
- * const cls = tkx('brand-gradient p-6 rounded-xl card-shadow');
- * ```
- */
 export interface TkxPluginDef {
     name: string;
     utilities: Record<string, Record<string, string>>;
@@ -59,9 +11,4 @@ export interface TkxPluginDef {
 export declare function tkxPlugin(plugin: TkxPluginDef): void;
 export declare function tkxRemovePlugin(name: string): void;
 export declare function tkxListPlugins(): string[];
-/**
- * Resolve a plugin utility to CSS properties.
- * Called internally by the TKX engine — but also exported for inspection.
- */
 export declare function resolvePluginUtility(name: string): Record<string, string> | null;
-//# sourceMappingURL=tkx.d.ts.map

package/dist/src/engine/wcag.d.ts

@@ -31,4 +31,3 @@ export declare const WCAGEngine: {
     prefersHighContrast: typeof prefersHighContrast;
     announce: typeof announceToScreenReader;
 };
-//# sourceMappingURL=wcag.d.ts.map

package/dist/src/headless/index.d.ts

@@ -21,4 +21,3 @@ export { useSSE } from './useSSE';
 export type { SSEOptions, SSEState } from './useSSE';
 export { useInfiniteQuery } from './useInfiniteQuery';
 export type { InfiniteQueryOptions, InfiniteQueryState } from './useInfiniteQuery';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/headless/useControllable.d.ts

@@ -1,20 +1,5 @@
-/**
- * Unified controlled/uncontrolled state management.
- * The component accepts both a controlled `value` + `onChange` pair
- * OR works standalone with internal state when they're not provided.
- *
- * This is the same pattern used by Radix UI, Mantine, and Ant Design internally.
- *
- * @example — in a custom Select component:
- * const [currentValue, setCurrentValue] = useControllable({
- *   value: props.value,       // may be undefined (uncontrolled)
- *   onChange: props.onChange, // may be undefined
- *   defaultValue: '',
- * });
- */
 export declare function useControllable<T>({ value, onChange, defaultValue, }: {
     value?: T;
     onChange?: (value: T) => void;
     defaultValue: T;
 }): [T, (next: T) => void];
-//# sourceMappingURL=useControllable.d.ts.map

package/dist/src/headless/useDebounce.d.ts

@@ -1,14 +1,2 @@
-/**
- * Returns a debounced version of the value that only updates after the
- * specified delay has passed without changes.
- *
- * @example
- * const debouncedSearch = useDebounce(searchQuery, 300);
- * useEffect(() => { fetchResults(debouncedSearch); }, [debouncedSearch]);
- */
 export declare function useDebounce<T>(value: T, delay: number): T;
-/**
- * Returns a debounced callback that only fires after the delay.
- */
 export declare function useDebouncedCallback<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
-//# sourceMappingURL=useDebounce.d.ts.map

package/dist/src/headless/useDisclosure.d.ts

@@ -4,17 +4,4 @@ export interface UseDisclosureReturn {
     close: () => void;
     toggle: () => void;
 }
-/**
- * Manages boolean open/close state for modals, drawers, popovers, dropdowns, etc.
- *
- * @example
- * const { isOpen, open, close, toggle } = useDisclosure();
- * return (
- *   <>
- *     <button onClick={open}>Open</button>
- *     {isOpen && <MyModal onClose={close} />}
- *   </>
- * );
- */
 export declare function useDisclosure(initialState?: boolean): UseDisclosureReturn;
-//# sourceMappingURL=useDisclosure.d.ts.map

package/dist/src/headless/useFormState.d.ts

@@ -28,17 +28,4 @@ export interface UseFormStateReturn<T extends Record<string, FormFieldValue>> {
         'aria-describedby': string | undefined;
     };
 }
-/**
- * Headless form state manager — no components, no context, no validation library required.
- * Works with any input elements.
- *
- * @example
- * const { values, errors, getFieldProps, validate } = useFormState({
- *   initialValues: { email: '', password: '' },
- *   validate: ({ email }) => ({
- *     email: !email.includes('@') ? 'Invalid email' : undefined,
- *   }),
- * });
- */
 export declare function useFormState<T extends Record<string, FormFieldValue>>({ initialValues, validate: validateFn, }: UseFormStateOptions<T>): UseFormStateReturn<T>;
-//# sourceMappingURL=useFormState.d.ts.map

package/dist/src/headless/useInfiniteQuery.d.ts

@@ -21,15 +21,4 @@ export interface InfiniteQueryState<T, C = unknown> {
     pageIndex: number;
     totalLoaded: number;
 }
-/**
- * Headless infinite-scroll / pagination hook with cursor-based querying,
- * dedup protection, and safe unmount cleanup.
- *
- * @example
- * const query = useInfiniteQuery({
- *   queryFn: async (cursor) => fetchPosts({ cursor }),
- * });
- * // In your component: query.data, query.fetchMore(), query.hasMore
- */
 export declare function useInfiniteQuery<T, C = unknown>(options: InfiniteQueryOptions<T, C>): InfiniteQueryState<T, C>;
-//# sourceMappingURL=useInfiniteQuery.d.ts.map

package/dist/src/headless/useIntersectionObserver.d.ts

@@ -3,7 +3,6 @@ export interface UseIntersectionObserverOptions {
     threshold?: number | number[];
     rootMargin?: string;
     root?: Element | null;
-    /** Unobserve after first intersection (useful for lazy-load). Default: false */
     once?: boolean;
 }
 export interface UseIntersectionObserverReturn {
@@ -11,13 +10,4 @@ export interface UseIntersectionObserverReturn {
     isIntersecting: boolean;
     entry: IntersectionObserverEntry | null;
 }
-/**
- * Observe when an element enters or leaves the viewport.
- * Perfect for lazy loading, infinite scroll, and scroll-triggered animations.
- *
- * @example
- * const { ref, isIntersecting } = useIntersectionObserver({ threshold: 0.1 });
- * return <div ref={ref} style={{ opacity: isIntersecting ? 1 : 0 }}>Animated content</div>;
- */
 export declare function useIntersectionObserver({ threshold, rootMargin, root, once, }?: UseIntersectionObserverOptions): UseIntersectionObserverReturn;
-//# sourceMappingURL=useIntersectionObserver.d.ts.map

package/dist/src/headless/useListSelection.d.ts

@@ -1,7 +1,6 @@
 export interface UseListSelectionOptions {
     items: string[];
     initialSelected?: string[];
-    /** Allow selecting multiple items. Default: true */
     multiple?: boolean;
 }
 export interface UseListSelectionReturn {
@@ -18,12 +17,4 @@ export interface UseListSelectionReturn {
     selectedCount: number;
     selectedArray: string[];
 }
-/**
- * Manages selection state for lists, tables, and grids.
- * Supports single and multi-select modes.
- *
- * @example
- * const { isSelected, toggle, selectedArray } = useListSelection({ items: rows.map(r => r.id) });
- */
 export declare function useListSelection({ items, initialSelected, multiple, }: UseListSelectionOptions): UseListSelectionReturn;
-//# sourceMappingURL=useListSelection.d.ts.map

package/dist/src/headless/useLocalStorage.d.ts

@@ -1,9 +1 @@
-/**
- * Persists state to localStorage. Falls back to in-memory on parse errors or
- * SSR (where localStorage is unavailable).
- *
- * @example
- * const [theme, setTheme] = useLocalStorage('theme', 'dark');
- */
 export declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void, () => void];
-//# sourceMappingURL=useLocalStorage.d.ts.map

package/dist/src/headless/useMediaQuery.d.ts

@@ -1,13 +1,4 @@
-/**
- * Reactive media query hook. Returns true while the query matches.
- *
- * @example
- * const isMobile = useMediaQuery('(max-width: 767px)');
- * const isDark = useMediaQuery('(prefers-color-scheme: dark)');
- * const isTouch = useMediaQuery('(hover: none) and (pointer: coarse)');
- */
 export declare function useMediaQuery(query: string): boolean;
-/** Preset breakpoint hooks matching TekiVex's breakpoint scale. */
 export declare function useBreakpoint(): {
     sm: boolean;
     md: boolean;
@@ -18,4 +9,3 @@ export declare function useBreakpoint(): {
     isTablet: boolean;
     isDesktop: boolean;
 };
-//# sourceMappingURL=useMediaQuery.d.ts.map

package/dist/src/headless/useRovingTabIndex.d.ts

@@ -3,7 +3,6 @@ export interface UseRovingTabIndexOptions {
     count: number;
     initialIndex?: number;
     orientation?: 'horizontal' | 'vertical' | 'both';
-    /** Wrap around at boundaries. Default: true */
     loop?: boolean;
 }
 export interface UseRovingTabIndexReturn {
@@ -16,18 +15,4 @@ export interface UseRovingTabIndexReturn {
         'data-focused': boolean;
     };
 }
-/**
- * Implements the WAI-ARIA roving tabIndex pattern for composite widgets
- * (toolbars, tab lists, radio groups, menu items, etc.)
- *
- * Only one item in the group is in the tab sequence at a time.
- * Arrow keys move focus within the group.
- *
- * @example
- * const { getItemProps } = useRovingTabIndex({ count: tabs.length });
- * return tabs.map((tab, i) => (
- *   <button key={tab.id} {...getItemProps(i)}>{tab.label}</button>
- * ));
- */
 export declare function useRovingTabIndex({ count, initialIndex, orientation, loop, }: UseRovingTabIndexOptions): UseRovingTabIndexReturn;
-//# sourceMappingURL=useRovingTabIndex.d.ts.map

package/dist/src/headless/useSSE.d.ts

@@ -24,13 +24,4 @@ export interface SSEState<T = unknown> {
     disconnect: () => void;
     eventCount: number;
 }
-/**
- * Headless Server-Sent Events hook supporting multiple named event types,
- * auto-reconnect, and JSON auto-parsing.
- *
- * @example
- * const sse = useSSE({ url: '/api/stream', events: ['update', 'notification'] });
- * console.log(sse.lastEvent);
- */
 export declare function useSSE<T = unknown>(options: SSEOptions): SSEState<T>;
-//# sourceMappingURL=useSSE.d.ts.map

package/dist/src/headless/useThrottle.d.ts

@@ -1,9 +1,2 @@
-/**
- * Returns a throttled version of the value — updates at most once per interval.
- */
 export declare function useThrottle<T>(value: T, interval: number): T;
-/**
- * Returns a throttled callback — executes at most once per interval.
- */
 export declare function useThrottledCallback<T extends (...args: any[]) => any>(fn: T, interval: number): (...args: Parameters<T>) => void;
-//# sourceMappingURL=useThrottle.d.ts.map

package/dist/src/headless/useWebSocket.d.ts

@@ -21,13 +21,4 @@ export interface WebSocketState<T = unknown> {
     reconnectCount: number;
     latency: number | null;
 }
-/**
- * Headless WebSocket hook with auto-reconnect, heartbeat, latency tracking,
- * and a send queue that flushes on connect.
- *
- * @example
- * const ws = useWebSocket({ url: 'wss://example.com/ws' });
- * ws.send({ type: 'subscribe', channel: 'updates' });
- */
 export declare function useWebSocket<T = unknown>(options: WebSocketOptions): WebSocketState<T>;
-//# sourceMappingURL=useWebSocket.d.ts.map

package/dist/src/hooks/index.d.ts

@@ -5,4 +5,3 @@ export declare function useFocusTrap(active: boolean): RefObject<HTMLElement | n
 export declare function useAnnounce(): (message: string, politeness?: 'polite' | 'assertive') => void;
 export declare function useEscapeKey(handler: () => void, active?: boolean): void;
 export declare function useClickOutside(ref: RefObject<HTMLElement | null>, handler: () => void): void;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/i18n/I18nProvider.d.ts

@@ -7,4 +7,3 @@ export interface I18nProviderProps {
     children: ReactNode;
 }
 export declare function I18nProvider({ locale, direction, strings: overrides, children, }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=I18nProvider.d.ts.map

package/dist/src/i18n/index.d.ts

@@ -92,4 +92,3 @@ export declare const I18nContext: import("react").Context<I18nContextValue>;
 export declare function useI18n(): I18nContextValue;
 export declare function useLocale(): LocaleStrings;
 export declare function useDirection(): Direction;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/quantum/index.d.ts

@@ -6,4 +6,3 @@ export { TkxPlayground } from '../components/TkxPlayground';
 export type { TkxPlaygroundProps, PlaygroundExample } from '../components/TkxPlayground';
 export { QuantumAI, inferFieldIntelligence, optimizeThemeColors, hslToHex, Qubit, QuantumRegister, QuantumAnnealer, QuantumBoltzmannMachine, AmplitudeAmplifier, } from '../engine/quantum-ai';
 export type { FieldIntelligence, ValidationSuggestion, ThemeColorState, AnnealerResult, QBMInference, AmplifiedResult, } from '../engine/quantum-ai';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/realtime/index.d.ts

@@ -6,4 +6,3 @@ export { TkxRealTimeChart } from '../components/TkxRealTimeChart';
 export type { TkxRealTimeChartProps, ChartDataPoint } from '../components/TkxRealTimeChart';
 export { TkxLiveLog } from '../components/TkxLiveLog';
 export type { TkxLiveLogProps, LogEntry, LogLevel } from '../components/TkxLiveLog';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/themes/index.d.ts

@@ -131,4 +131,3 @@ export declare const radii: {
     readonly '2xl': "16px";
     readonly full: "9999px";
 };
-//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tekivex-ui",
-  "version": "2.5.15",
+  "version": "2.6.0",
   "description": "Production-grade React component library — 70+ components, WCAG 2.1 AAA, WAI-ARIA 1.2, built-in charts, headless primitives, zero-runtime CSS engine, TypeScript-first.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -46,11 +46,12 @@
   },
   "sideEffects": [
     "*.css",
-    "./src/styles/global.css"
+    "./dist/style.css"
   ],
   "files": [
     "dist",
-    "src"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "vite build && tsc --emitDeclarationOnly",
@@ -94,6 +95,7 @@
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "recharts": "^3.8.1",
+    "terser": "^5.46.1",
     "typescript": "^5.9.3",
     "vite": "^8.0.9",
     "vitest": "^4.1.4"