@sudobility/components 2.0.33 → 3.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/navigation/stepper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,WAAW;IAC1B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAyO1C,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/navigation/table-of-contents.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+interface TOCSection {
+    id: string;
+    title: string;
+    subsections?: TOCSection[];
+}
+interface TableOfContentsProps {
+    sections: TOCSection[];
+    selectedSection: string;
+    selectedSubsection?: string | null;
+    expandedSections: string[];
+    onSectionSelect: (sectionId: string) => void;
+    onSubsectionSelect?: (subsectionId: string, parentSectionId: string) => void;
+    onToggleSection: (sectionId: string) => void;
+    className?: string;
+}
+declare const TableOfContents: React.FC<TableOfContentsProps>;
+export { TableOfContents, type TOCSection };
+//# sourceMappingURL=table-of-contents.d.ts.map

package/dist/navigation/table-of-contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-of-contents.d.ts","sourceRoot":"","sources":["../../src/navigation/table-of-contents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAG3D,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmDD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAsDnD,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,CAAC"}

package/dist/navigation/tabs.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+declare const Tabs: React.ForwardRefExoticComponent<import('@radix-ui/react-tabs').TabsProps & React.RefAttributes<HTMLDivElement>>;
+declare const TabsList: React.ForwardRefExoticComponent<Omit<import('@radix-ui/react-tabs').TabsListProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const TabsTrigger: React.ForwardRefExoticComponent<Omit<import('@radix-ui/react-tabs').TabsTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare const TabsContent: React.ForwardRefExoticComponent<Omit<import('@radix-ui/react-tabs').TabsContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { Tabs, TabsList, TabsTrigger, TabsContent };
+//# sourceMappingURL=tabs.d.ts.map

package/dist/navigation/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/navigation/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,QAAA,MAAM,IAAI,iHAAO,CAAC;AAElB,QAAA,MAAM,QAAQ,wKASZ,CAAC;AAGH,QAAA,MAAM,WAAW,iLASf,CAAC;AAGH,QAAA,MAAM,WAAW,2KASf,CAAC;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC"}

package/dist/optimization/LoadingOptimizer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Advanced Loading Optimization Component
+ * @description Implements critical loading optimizations for better Core Web Vitals
+ */
+/**
+ * LoadingOptimizer component that implements advanced loading strategies
+ *
+ * @description Optimizations:
+ * 1. Resource prefetching based on user behavior
+ * 2. Intelligent preloading of likely routes
+ * 3. Critical resource prioritization
+ * 4. Performance monitoring and adjustment
+ *
+ * @example Basic Usage
+ * LoadingOptimizer component should be placed at the top level of your App.
+ * Import and use: import LoadingOptimizer from './components/LoadingOptimizer';
+ * Then add <LoadingOptimizer /> to your JSX.
+ */
+export declare const LoadingOptimizer: () => null;
+export default LoadingOptimizer;
+//# sourceMappingURL=LoadingOptimizer.d.ts.map

package/dist/optimization/LoadingOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingOptimizer.d.ts","sourceRoot":"","sources":["../../src/optimization/LoadingOptimizer.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,YA4N5B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/optimization/OptimizedRoutePreloader.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface OptimizedRoutePreloaderProps {
+    children: React.ReactNode;
+}
+declare const OptimizedRoutePreloader: React.FC<OptimizedRoutePreloaderProps>;
+export { OptimizedRoutePreloader };
+//# sourceMappingURL=OptimizedRoutePreloader.d.ts.map

package/dist/optimization/OptimizedRoutePreloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizedRoutePreloader.d.ts","sourceRoot":"","sources":["../../src/optimization/OptimizedRoutePreloader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,4BAA4B;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,QAAA,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAInE,CAAC;AAEF,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/optimization/PerformanceOptimizer.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+interface PerformanceOptimizerProps {
+    children: React.ReactNode;
+    appName: string;
+    appUrl: string;
+    apiUrl?: string;
+}
+declare const PerformanceOptimizer: React.FC<PerformanceOptimizerProps>;
+export default PerformanceOptimizer;
+//# sourceMappingURL=PerformanceOptimizer.d.ts.map

package/dist/optimization/PerformanceOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceOptimizer.d.ts","sourceRoot":"","sources":["../../src/optimization/PerformanceOptimizer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,UAAU,yBAAyB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA0R7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/optimization/criticalPathOptimizer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Critical rendering path optimizer for fastest possible page loads
+ */
+declare class CriticalPathOptimizer {
+    private criticalResources;
+    private observedMetrics;
+    constructor();
+    private defineCriticalResources;
+    private startPerformanceObservation;
+    private optimizeBasedOnFCP;
+    private optimizeBasedOnLCP;
+    private optimizeBasedOnTTFB;
+    private applyEmergencyOptimizations;
+    private applyMediumOptimizations;
+    private optimizeLCPElements;
+    private enableAggressiveCaching;
+    private preloadResource;
+    optimizeCriticalPath(): void;
+    private inlineCriticalCSS;
+    private optimizeFontLoading;
+    private removeRenderBlocking;
+    private setupProgressiveLoading;
+    private isSmallResource;
+    getPerformanceMetrics(): {
+        score: number;
+        fcp: number;
+        lcp: number;
+        fid: number;
+        cls: number;
+        ttfb: number;
+    };
+    private calculatePerformanceScore;
+}
+export declare function initializeCriticalPathOptimization(): void;
+export declare function getPerformanceMetrics(): {
+    score: number;
+    fcp: number;
+    lcp: number;
+    fid: number;
+    cls: number;
+    ttfb: number;
+} | undefined;
+export default CriticalPathOptimizer;
+//# sourceMappingURL=criticalPathOptimizer.d.ts.map

package/dist/optimization/criticalPathOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criticalPathOptimizer.d.ts","sourceRoot":"","sources":["../../src/optimization/criticalPathOptimizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,cAAM,qBAAqB;IACzB,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,eAAe,CAMrB;;IAOF,OAAO,CAAC,uBAAuB;IA2C/B,OAAO,CAAC,2BAA2B;IAuDnC,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,eAAe;IA4BhB,oBAAoB,IAAI,IAAI;IAqBnC,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,uBAAuB;IA+B/B,OAAO,CAAC,eAAe;IAMhB,qBAAqB;;;;;;;;IAO5B,OAAO,CAAC,yBAAyB;CAkBlC;AAID,wBAAgB,kCAAkC,IAAI,IAAI,CAYzD;AAED,wBAAgB,qBAAqB;;;;;;;cAEpC;AAED,eAAe,qBAAqB,CAAC"}

package/dist/optimization/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Optimization Components and Utilities - Performance and loading optimization
+ */
+export { default as PerformanceOptimizer } from './PerformanceOptimizer';
+export { default as LoadingOptimizer } from './LoadingOptimizer';
+export { OptimizedRoutePreloader } from './OptimizedRoutePreloader';
+export * from './optimization';
+export { default as criticalPathOptimizer } from './criticalPathOptimizer';
+export * from './performance';
+export * from './performance-monitoring';
+//# sourceMappingURL=index.d.ts.map

package/dist/optimization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/optimization/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC"}

package/dist/optimization/optimization/advancedLazyLoading.d.ts

@@ -0,0 +1,80 @@
+import { default as React, ComponentType } from 'react';
+interface LazyLoadConfig {
+    retries?: number;
+    timeout?: number;
+    fallback?: React.ReactNode;
+    preloadCondition?: () => boolean;
+    cacheStrategy?: 'memory' | 'session' | 'none';
+    priority?: 'critical' | 'high' | 'medium' | 'low';
+    onLoad?: (component: any) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Enhanced lazy loading with retry logic, caching, and predictive loading
+ */
+export declare function createAdvancedLazyComponent<T extends ComponentType<Record<string, unknown>>>(importFunc: () => Promise<{
+    default: T;
+}>, componentName: string, config?: LazyLoadConfig): ComponentType<Record<string, unknown>>;
+/**
+ * Route-based lazy loading with intelligent preloading
+ */
+export declare class RouteBasedLazyLoader {
+    private static routeMap;
+    private static routeUsageStats;
+    private static currentRoute;
+    static registerRoute(path: string, component: ComponentType<Record<string, unknown>>): void;
+    static setCurrentRoute(path: string): void;
+    private static preloadLikelyRoutes;
+    private static getRouteTransitionProbability;
+    static getStats(): {
+        routeCount: number;
+        cacheSize: number;
+        currentRoute: string;
+        usageStats: {
+            [k: string]: number;
+        };
+    };
+}
+/**
+ * Component for lazy loading images with intersection observer
+ */
+export declare const LazyImage: React.FC<{
+    src: string;
+    alt: string;
+    className?: string;
+    placeholder?: string;
+    priority?: 'high' | 'medium' | 'low';
+}>;
+/**
+ * Clear component cache (useful for development)
+ */
+export declare function clearComponentCache(): void;
+/**
+ * Get performance statistics
+ */
+export declare function getLazyLoadingStats(): {
+    cachedComponents: number;
+    preloadQueue: number;
+    networkSpeed: "medium" | "slow" | "fast";
+    isLowEndDevice: boolean;
+    cacheEntries: {
+        name: string;
+        loadTime: number;
+        age: number;
+    }[];
+};
+declare const _default: {
+    createAdvancedLazyComponent: typeof createAdvancedLazyComponent;
+    RouteBasedLazyLoader: typeof RouteBasedLazyLoader;
+    LazyImage: React.FC<{
+        src: string;
+        alt: string;
+        className?: string;
+        placeholder?: string;
+        priority?: "high" | "medium" | "low";
+    }>;
+    clearComponentCache: typeof clearComponentCache;
+    getLazyLoadingStats: typeof getLazyLoadingStats;
+};
+export default _default;
+//# sourceMappingURL=advancedLazyLoading.d.ts.map

package/dist/optimization/optimization/advancedLazyLoading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedLazyLoading.d.ts","sourceRoot":"","sources":["../../../src/optimization/optimization/advancedLazyLoading.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,EAGZ,aAAa,EAGd,MAAM,OAAO,CAAC;AAEf,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AA8CD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAEhD,UAAU,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,cAAmB,GAC1B,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkIxC;AAsDD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAGnB;IACJ,OAAO,CAAC,MAAM,CAAC,eAAe,CAA6B;IAC3D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAM;IAEjC,MAAM,CAAC,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMnD,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM;IAWnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAkBlC,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAmC5C,MAAM,CAAC,QAAQ;;;;;;;;CAQhB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACtC,CAyDA,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,SAIlC;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;;;;;;;EAYlC;;;;;aAxFM,MAAM;aACN,MAAM;oBACC,MAAM;sBACJ,MAAM;mBACT,MAAM,GAAG,QAAQ,GAAG,KAAK;;;;;AAsFtC,wBAME"}

package/dist/optimization/optimization/advancedPreloading.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Advanced preloading strategies for optimal user experience
+ */
+declare class AdvancedPreloader {
+    private preloaded;
+    private networkSpeedEstimate;
+    private isLowEndDevice;
+    private userActivityScore;
+    constructor();
+    private detectNetworkSpeed;
+    private detectDeviceCapability;
+    private startUserActivityTracking;
+    private shouldPreload;
+    private preloadChunk;
+    private getChunkHash;
+    private schedulePreload;
+    initializePreloading(): void;
+    private setupHoverPreloading;
+    private setupScrollPreloading;
+    private startIntelligentPreloading;
+    getPreloadingStats(): {
+        preloadedCount: number;
+        networkSpeed: string;
+        isLowEndDevice: boolean;
+        userActivity: number;
+    };
+}
+export declare function initializeAdvancedPreloading(): void;
+export declare function getPreloadingStats(): {
+    preloadedCount: number;
+    networkSpeed: string;
+    isLowEndDevice: boolean;
+    userActivity: number;
+} | undefined;
+export default AdvancedPreloader;
+//# sourceMappingURL=advancedPreloading.d.ts.map

package/dist/optimization/optimization/advancedPreloading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedPreloading.d.ts","sourceRoot":"","sources":["../../../src/optimization/optimization/advancedPreloading.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqHH,cAAM,iBAAiB;IACrB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,oBAAoB,CAAwC;IACpE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAK;;IAQ9B,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,aAAa;YAcP,YAAY;IAyC1B,OAAO,CAAC,YAAY;YAiBN,eAAe;IAkBtB,oBAAoB,IAAI,IAAI;IAkCnC,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,0BAA0B;IAoB3B,kBAAkB,IAAI;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,OAAO,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB;CAQF;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAanD;AAED,wBAAgB,kBAAkB;oBAhCd,MAAM;kBACR,MAAM;oBACJ,OAAO;kBACT,MAAM;cA+BvB;AAED,eAAe,iBAAiB,CAAC"}

package/dist/optimization/optimization/aiOptimization.d.ts

@@ -0,0 +1,139 @@
+export interface AIContentConfig {
+    contentType: 'article' | 'landing-page' | 'product-page' | 'governance-page' | 'documentation';
+    primaryTopic: string;
+    semanticKeywords: string[];
+    targetAudience: string[];
+    complexityLevel: 'beginner' | 'intermediate' | 'advanced';
+    contentPurpose: 'informational' | 'transactional' | 'navigational' | 'commercial';
+    industryVertical: string;
+    technicalTags: string[];
+    userIntent: string[];
+    conversionGoals: string[];
+}
+export interface AIStructuredData {
+    contentClassification: Record<string, string>;
+    semanticMarkup: Record<string, unknown>;
+    entityRecognition: string[];
+    topicClustering: string[];
+    contentRelationships: Array<{
+        type: string;
+        target: string;
+        strength: number;
+    }>;
+}
+/**
+ * Generates AI-optimized meta tags for enhanced machine learning comprehension
+ */
+export declare function generateAIMetaTags(config: AIContentConfig): Record<string, string>;
+/**
+ * Creates semantic HTML markup for AI comprehension
+ */
+export declare function generateSemanticMarkup(config: AIContentConfig): Record<string, unknown>;
+/**
+ * Generates content relationship mapping for AI understanding
+ */
+export declare function generateContentRelationships(_primaryUrl: string, relatedPages: Array<{
+    url: string;
+    topic: string;
+    relevance: number;
+}>): Array<{
+    type: string;
+    target: string;
+    strength: number;
+}>;
+/**
+ * Creates entity recognition data for AI systems
+ */
+export declare function generateEntityRecognition(config: AIContentConfig): string[];
+/**
+ * Generates topic clustering data for AI content categorization
+ */
+export declare function generateTopicClustering(config: AIContentConfig): string[];
+/**
+ * Creates comprehensive AI-optimized structured data
+ */
+export declare function generateAIStructuredData(config: AIContentConfig, additionalData?: Partial<AIStructuredData>): AIStructuredData;
+/**
+ * Generates performance tracking schema for AI analytics
+ */
+export declare function generatePerformanceTrackingSchema(pageName: string): {
+    '@context': string;
+    '@type': string;
+    name: string;
+    instrument: {
+        '@type': string;
+        name: string;
+    };
+    measurementTechnique: string[];
+    result: {
+        '@type': string;
+        name: string;
+        description: string;
+    };
+};
+/**
+ * Predefined configurations for common page types
+ */
+export declare const aiOptimizationPresets: {
+    governancePage: {
+        contentType: "governance-page";
+        primaryTopic: string;
+        semanticKeywords: string[];
+        targetAudience: string[];
+        complexityLevel: "intermediate";
+        contentPurpose: "commercial";
+        industryVertical: string;
+        technicalTags: string[];
+        userIntent: string[];
+        conversionGoals: string[];
+    };
+    landingPage: {
+        contentType: "landing-page";
+        primaryTopic: string;
+        semanticKeywords: string[];
+        targetAudience: string[];
+        complexityLevel: "beginner";
+        contentPurpose: "commercial";
+        industryVertical: string;
+        technicalTags: string[];
+        userIntent: string[];
+        conversionGoals: string[];
+    };
+};
+declare const _default: {
+    generateAIMetaTags: typeof generateAIMetaTags;
+    generateSemanticMarkup: typeof generateSemanticMarkup;
+    generateContentRelationships: typeof generateContentRelationships;
+    generateEntityRecognition: typeof generateEntityRecognition;
+    generateTopicClustering: typeof generateTopicClustering;
+    generateAIStructuredData: typeof generateAIStructuredData;
+    generatePerformanceTrackingSchema: typeof generatePerformanceTrackingSchema;
+    aiOptimizationPresets: {
+        governancePage: {
+            contentType: "governance-page";
+            primaryTopic: string;
+            semanticKeywords: string[];
+            targetAudience: string[];
+            complexityLevel: "intermediate";
+            contentPurpose: "commercial";
+            industryVertical: string;
+            technicalTags: string[];
+            userIntent: string[];
+            conversionGoals: string[];
+        };
+        landingPage: {
+            contentType: "landing-page";
+            primaryTopic: string;
+            semanticKeywords: string[];
+            targetAudience: string[];
+            complexityLevel: "beginner";
+            contentPurpose: "commercial";
+            industryVertical: string;
+            technicalTags: string[];
+            userIntent: string[];
+            conversionGoals: string[];
+        };
+    };
+};
+export default _default;
+//# sourceMappingURL=aiOptimization.d.ts.map

package/dist/optimization/optimization/aiOptimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiOptimization.d.ts","sourceRoot":"","sources":["../../../src/optimization/optimization/aiOptimization.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,WAAW,EACP,SAAS,GACT,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,eAAe,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IAC1D,cAAc,EACV,eAAe,GACf,eAAe,GACf,cAAc,GACd,YAAY,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,EAAE,KAAK,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8CxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2CzB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAM3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CA4B3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAoBzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,cAAc,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACzC,gBAAgB,CAgBlB;AAiBD;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;;;EAqBjE;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;CAyFjC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,wBASE"}

package/dist/optimization/optimization/apiOptimization.d.ts

@@ -0,0 +1,199 @@
+/**
+ * @fileoverview API Performance Optimization Utilities
+ * @description Provides intelligent caching, request batching, and retry mechanisms for API calls
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { optimizedFetch, batchRequests } from '@/utils/apiOptimization';
+ *
+ * // Cache user data for 5 minutes with stale-while-revalidate
+ * const userData = await optimizedFetch(
+ *   'user-123',
+ *   () => api.getUser('123'),
+ *   'user'
+ * );
+ *
+ * // Cache email messages for 30 seconds
+ * const messages = await optimizedFetch(
+ *   'messages-inbox',
+ *   () => api.getMessages('inbox'),
+ *   'messages'
+ * );
+ * ```
+ *
+ * @example Request Batching
+ * ```typescript
+ * // Batch multiple API calls to execute simultaneously
+ * const [user, messages, addresses] = await batchRequests([
+ *   () => optimizedFetch('user-123', () => api.getUser('123'), 'user'),
+ *   () => optimizedFetch('messages-inbox', () => api.getMessages('inbox'), 'messages'),
+ *   () => optimizedFetch('addresses-123', () => api.getAddresses('123'), 'addresses')
+ * ]);
+ * ```
+ *
+ * @description Caching Strategy:
+ * - **user**: 5min cache - Profile data changes rarely
+ * - **messages**: 30sec cache - Email lists update frequently
+ * - **messageDetails**: 2min cache - Individual emails change less often
+ * - **addresses**: 10min cache - Email addresses are relatively static
+ * - **messageCount**: 10sec cache - Real-time counts need frequent updates
+ *
+ * @description Features:
+ * - **Intelligent Caching**: Different TTLs for different data types
+ * - **Stale-While-Revalidate**: Serve cached data while fetching fresh data
+ * - **LRU Eviction**: Automatically removes oldest entries when cache is full
+ * - **Request Batching**: Execute multiple API calls simultaneously
+ * - **Retry Logic**: Automatic retries with exponential backoff
+ * - **Cache Invalidation**: Pattern-based cache clearing
+ */
+/**
+ * Cache configuration interface defining caching behavior
+ */
+interface CacheConfig {
+    /** Cache duration in milliseconds */
+    duration: number;
+    /** Maximum number of cached entries before LRU eviction */
+    maxSize: number;
+    /** Whether to serve stale data while revalidating in background */
+    staleWhileRevalidate: boolean;
+}
+/**
+ * Pre-configured cache settings optimized for different data types
+ *
+ * @description Cache Strategy Explanation:
+ *
+ * **Static Data (Long Cache):**
+ * - `user`: 5min - User profile data changes infrequently
+ * - `addresses`: 10min - Email addresses are relatively stable
+ * - `mailboxes`: 2min - Mailbox structure changes occasionally
+ *
+ * **Dynamic Data (Short Cache):**
+ * - `messages`: 30sec - Email lists update frequently
+ * - `messageCount`: 10sec - Real-time counters need frequent refresh
+ *
+ * **Content Data (Medium Cache):**
+ * - `messageDetails`: 2min - Individual email content is static once loaded
+ *
+ * @example Custom Cache Config
+ * ```typescript
+ * const customConfig: CacheConfig = {
+ *   duration: 60 * 1000,      // 1 minute cache
+ *   maxSize: 50,              // Store up to 50 entries
+ *   staleWhileRevalidate: true // Serve stale data while fetching fresh
+ * };
+ * ```
+ */
+declare const CACHE_CONFIGS: Record<string, CacheConfig>;
+/**
+ * Optimized fetch function with intelligent caching and request deduplication
+ *
+ * @template T - Type of data being fetched
+ * @param key - Unique cache key for the request (e.g., 'user-123', 'messages-inbox')
+ * @param fetcher - Function that performs the actual API call
+ * @param cacheType - Type of cache configuration to use (defaults to 'messages')
+ * @returns Promise resolving to the fetched data
+ *
+ * @description Optimization Features:
+ * 1. **Request Deduplication**: Multiple calls with same key return same Promise
+ * 2. **Intelligent Caching**: Uses different cache durations based on data type
+ * 3. **Stale-While-Revalidate**: Returns cached data immediately, updates in background
+ * 4. **Automatic Cache Management**: LRU eviction and TTL-based expiration
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { optimizedFetch } from '@/utils/apiOptimization';
+ * import { wildDuckApi } from '@/config/api';
+ *
+ * // Cache user data for 5 minutes
+ * const user = await optimizedFetch(
+ *   `user-${userId}`,
+ *   () => wildDuckApi.getUser(userId),
+ *   'user'
+ * );
+ *
+ * // Cache messages for 30 seconds with stale-while-revalidate
+ * const messages = await optimizedFetch(
+ *   `messages-${mailboxId}`,
+ *   () => wildDuckApi.getMessages(mailboxId),
+ *   'messages'
+ * );
+ * ```
+ *
+ * @example React Hook Integration
+ * ```typescript
+ * const useOptimizedUser = (userId: string) => {
+ *   const [user, setUser] = useState(null);
+ *
+ *   useEffect(() => {
+ *     optimizedFetch(
+ *       `user-${userId}`,
+ *       () => api.getUser(userId),
+ *       'user'
+ *     ).then(setUser);
+ *   }, [userId]);
+ *
+ *   return user;
+ * };
+ * ```
+ *
+ * @description Cache Types Available:
+ * - `user`: 5min cache - For profile data
+ * - `messages`: 30sec cache - For email lists
+ * - `messageDetails`: 2min cache - For email content
+ * - `addresses`: 10min cache - For address lists
+ * - `messageCount`: 10sec cache - For real-time counters
+ */
+export declare const optimizedFetch: <T>(key: string, fetcher: () => Promise<T>, cacheType?: keyof typeof CACHE_CONFIGS) => Promise<T>;
+export declare class OptimizedAPIClient {
+    private baseURL;
+    private defaultHeaders;
+    private requestInterceptors;
+    private responseInterceptors;
+    constructor(baseURL: string, defaultHeaders?: Record<string, string>);
+    addRequestInterceptor(interceptor: (config: globalThis.RequestInit) => globalThis.RequestInit): void;
+    addResponseInterceptor(interceptor: (response: Response) => Response | Promise<Response>): void;
+    request<T>(endpoint: string, options?: globalThis.RequestInit, cacheKey?: string, cacheType?: keyof typeof CACHE_CONFIGS): Promise<T>;
+    private shouldBatch;
+    get<T>(endpoint: string, cacheType?: keyof typeof CACHE_CONFIGS): Promise<T>;
+    post<T>(endpoint: string, data: any): Promise<T>;
+    put<T>(endpoint: string, data: any): Promise<T>;
+    delete<T>(endpoint: string): Promise<T>;
+}
+export declare const withRetry: <T>(operation: () => Promise<T>, maxRetries?: number, backoffMs?: number) => Promise<T>;
+export declare class CancellableRequest {
+    private abortController;
+    constructor();
+    request<T>(url: string, options?: globalThis.RequestInit): Promise<T>;
+    cancel(): void;
+}
+export declare const cacheUtils: {
+    invalidate: (pattern: string) => void;
+    clear: () => void;
+    getStats: () => {
+        size: number;
+        keys: string[];
+        memory: number;
+    };
+    warmUp: (warmUpFunctions: Array<() => Promise<unknown>>) => Promise<void>;
+    prefetch: (prefetchFunctions: Array<() => Promise<unknown>>) => Promise<void>;
+};
+declare const _default: {
+    optimizedFetch: <T>(key: string, fetcher: () => Promise<T>, cacheType?: keyof typeof CACHE_CONFIGS) => Promise<T>;
+    OptimizedAPIClient: typeof OptimizedAPIClient;
+    withRetry: <T>(operation: () => Promise<T>, maxRetries?: number, backoffMs?: number) => Promise<T>;
+    CancellableRequest: typeof CancellableRequest;
+    cacheUtils: {
+        invalidate: (pattern: string) => void;
+        clear: () => void;
+        getStats: () => {
+            size: number;
+            keys: string[];
+            memory: number;
+        };
+        warmUp: (warmUpFunctions: Array<() => Promise<unknown>>) => Promise<void>;
+        prefetch: (prefetchFunctions: Array<() => Promise<unknown>>) => Promise<void>;
+    };
+    CACHE_CONFIGS: Record<string, CacheConfig>;
+};
+export default _default;
+//# sourceMappingURL=apiOptimization.d.ts.map

package/dist/optimization/optimization/apiOptimization.d.ts.map

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