@homlista-devs/ui 1.6.0 → 1.6.2

package/dist/types/shared/lib/design-system.d.ts

@@ -0,0 +1,307 @@
+/**
+ * Design System Utilities
+ *
+ * This file contains utility functions and constants for the design system,
+ * providing consistent styling and behavior across components.
+ */
+import { type ClassValue } from "clsx";
+/**
+ * Utility function to merge and conditionally apply CSS classes
+ * Combines clsx for conditional classes with tailwind-merge for proper precedence
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Design system constants
+ */
+declare const designSystemConstants: {
+    readonly spacing: {
+        readonly xs: "0.25rem";
+        readonly sm: "0.5rem";
+        readonly md: "1rem";
+        readonly lg: "1.5rem";
+        readonly xl: "2rem";
+        readonly "2xl": "3rem";
+        readonly "3xl": "4rem";
+    };
+    readonly radius: {
+        readonly none: "0";
+        readonly sm: "0.125rem";
+        readonly DEFAULT: "0.25rem";
+        readonly md: "0.375rem";
+        readonly lg: "0.5rem";
+        readonly xl: "0.75rem";
+        readonly "2xl": "1rem";
+        readonly "3xl": "1.5rem";
+        readonly full: "9999px";
+    };
+    readonly typography: {
+        readonly fontSize: {
+            readonly xs: readonly ["0.75rem", {
+                readonly lineHeight: "1rem";
+            }];
+            readonly sm: readonly ["0.875rem", {
+                readonly lineHeight: "1.25rem";
+            }];
+            readonly base: readonly ["1rem", {
+                readonly lineHeight: "1.5rem";
+            }];
+            readonly lg: readonly ["1.125rem", {
+                readonly lineHeight: "1.75rem";
+            }];
+            readonly xl: readonly ["1.25rem", {
+                readonly lineHeight: "1.75rem";
+            }];
+            readonly "2xl": readonly ["1.5rem", {
+                readonly lineHeight: "2rem";
+            }];
+            readonly "3xl": readonly ["1.875rem", {
+                readonly lineHeight: "2.25rem";
+            }];
+            readonly "4xl": readonly ["2.25rem", {
+                readonly lineHeight: "2.5rem";
+            }];
+        };
+        readonly fontWeight: {
+            readonly thin: "100";
+            readonly light: "300";
+            readonly normal: "400";
+            readonly medium: "500";
+            readonly semibold: "600";
+            readonly bold: "700";
+            readonly extrabold: "800";
+            readonly black: "900";
+        };
+    };
+    readonly shadows: {
+        readonly none: "none";
+        readonly xs: "0 1px 2px 0 rgb(0 0 0 / 0.05)";
+        readonly sm: "0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)";
+        readonly DEFAULT: "0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)";
+        readonly md: "0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)";
+        readonly lg: "0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)";
+        readonly xl: "0 25px 50px -12px rgb(0 0 0 / 0.25)";
+    };
+    readonly zIndex: {
+        readonly dropdown: 1000;
+        readonly sticky: 1020;
+        readonly fixed: 1030;
+        readonly modalBackdrop: 1040;
+        readonly modal: 1050;
+        readonly popover: 1060;
+        readonly tooltip: 1070;
+        readonly toast: 1080;
+    };
+    readonly duration: {
+        readonly instant: "0ms";
+        readonly fast: "150ms";
+        readonly normal: "300ms";
+        readonly slow: "500ms";
+    };
+    readonly easing: {
+        readonly linear: "linear";
+        readonly in: "ease-in";
+        readonly out: "ease-out";
+        readonly inOut: "ease-in-out";
+    };
+};
+/**
+ * Component variant utilities
+ */
+export declare const componentVariants: {
+    readonly button: {
+        readonly size: {
+            readonly sm: "h-9 px-3 text-sm";
+            readonly md: "h-10 px-4 py-2";
+            readonly lg: "h-11 px-8";
+            readonly icon: "h-10 w-10";
+        };
+        readonly variant: {
+            readonly default: "bg-primary text-primary-foreground hover:bg-primary/90";
+            readonly secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80";
+            readonly destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90";
+            readonly outline: "border border-input bg-background hover:bg-accent hover:text-accent-foreground";
+            readonly ghost: "hover:bg-accent hover:text-accent-foreground";
+            readonly link: "text-primary underline-offset-4 hover:underline";
+        };
+    };
+    readonly input: {
+        readonly size: {
+            readonly sm: "h-9 px-3 text-sm";
+            readonly md: "h-10 px-3 py-2";
+            readonly lg: "h-11 px-3 py-2";
+        };
+    };
+    readonly card: {
+        readonly variant: {
+            readonly default: "bg-card text-card-foreground";
+            readonly elevated: "bg-card text-card-foreground shadow-lg";
+            readonly outlined: "bg-card text-card-foreground border-2";
+        };
+    };
+};
+/**
+ * Responsive breakpoint utilities
+ */
+export declare const responsiveBreakpoints: {
+    readonly sm: "640px";
+    readonly md: "768px";
+    readonly lg: "1024px";
+    readonly xl: "1280px";
+    readonly "2xl": "1536px";
+};
+/**
+ * Color utility functions
+ */
+export declare const colorUtils: {
+    /**
+     * Get a color value with opacity support
+     */
+    readonly withOpacity: (variable: string, opacity?: number) => string;
+    /**
+     * Get a color from the design system palette
+     */
+    readonly get: (color: string) => string;
+};
+/**
+ * Accessibility utilities
+ */
+export declare const accessibilityUtils: {
+    /**
+     * Generate a unique ID for form elements and their labels
+     */
+    readonly generateId: (prefix?: string) => string;
+    /**
+     * Focus management utilities
+     */
+    readonly focus: {
+        readonly visible: "focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2";
+        readonly within: "focus-within:outline-none focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2";
+    };
+    /**
+     * Screen reader utilities
+     */
+    readonly sr: {
+        readonly only: "absolute w-px h-px p-0 -m-px overflow-hidden whitespace-nowrap border-0";
+        readonly not: "not-sr-only";
+    };
+};
+/**
+ * Component size utilities
+ */
+export declare const componentSizes: {
+    readonly icon: {
+        readonly xs: "w-3 h-3";
+        readonly sm: "w-4 h-4";
+        readonly md: "w-5 h-5";
+        readonly lg: "w-6 h-6";
+        readonly xl: "w-8 h-8";
+    };
+    readonly avatar: {
+        readonly xs: "w-6 h-6";
+        readonly sm: "w-8 h-8";
+        readonly md: "w-10 h-10";
+        readonly lg: "w-12 h-12";
+        readonly xl: "w-16 h-16";
+    };
+};
+/**
+ * Animation utilities
+ */
+export declare const animationUtils: {
+    /**
+     * Fade animations
+     */
+    readonly fade: {
+        readonly in: "animate-in fade-in duration-200";
+        readonly out: "animate-out fade-out duration-200";
+    };
+    /**
+     * Slide animations
+     */
+    readonly slide: {
+        readonly inFromLeft: "animate-in slide-in-from-left duration-200";
+        readonly inFromRight: "animate-in slide-in-from-right duration-200";
+        readonly inFromTop: "animate-in slide-in-from-top duration-200";
+        readonly inFromBottom: "animate-in slide-in-from-bottom duration-200";
+    };
+    /**
+     * Scale animations
+     */
+    readonly scale: {
+        readonly in: "animate-in scale-in duration-200";
+        readonly out: "animate-out scale-out duration-200";
+    };
+};
+/**
+ * Layout utilities
+ */
+export declare const layoutUtils: {
+    /**
+     * Container utilities
+     */
+    readonly container: {
+        readonly responsive: "container mx-auto px-4 sm:px-6 lg:px-8";
+        readonly fluid: "w-full max-w-none";
+        readonly centered: "container mx-auto px-4 flex items-center justify-center min-h-screen";
+    };
+    /**
+     * Grid utilities
+     */
+    readonly grid: {
+        readonly responsive: "grid gap-4 sm:gap-6 lg:gap-8";
+        readonly cols: {
+            readonly 1: "grid-cols-1";
+            readonly 2: "grid-cols-1 sm:grid-cols-2";
+            readonly 3: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3";
+            readonly 4: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-4";
+            readonly 5: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-5";
+            readonly 6: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-6";
+        };
+    };
+    /**
+     * Flex utilities
+     */
+    readonly flex: {
+        readonly center: "flex items-center justify-center";
+        readonly between: "flex items-center justify-between";
+        readonly start: "flex items-center justify-start";
+        readonly end: "flex items-center justify-end";
+        readonly col: "flex flex-col";
+        readonly colCenter: "flex flex-col items-center justify-center";
+    };
+};
+/**
+ * Theme utilities
+ */
+export declare const themeUtils: {
+    /**
+     * Check if dark mode is active
+     */
+    readonly isDark: () => boolean;
+    /**
+     * Toggle dark mode
+     */
+    readonly toggle: () => void;
+    /**
+     * Set theme explicitly
+     */
+    readonly set: (theme: "light" | "dark") => void;
+};
+/**
+ * Performance utilities
+ */
+export declare const performanceUtils: {
+    /**
+     * Debounce function for performance optimization
+     */
+    readonly debounce: <T extends (...args: unknown[]) => unknown>(func: T, wait: number) => ((...args: Parameters<T>) => void);
+    /**
+     * Throttle function for performance optimization
+     */
+    readonly throttle: <T extends (...args: unknown[]) => unknown>(func: T, limit: number) => ((...args: Parameters<T>) => void);
+};
+/**
+ * Export all utilities
+ */
+export { designSystemConstants as designSystem, componentVariants as variants, responsiveBreakpoints as breakpoints, colorUtils as colors, accessibilityUtils as a11y, componentSizes as sizes, animationUtils as animations, layoutUtils as layout, themeUtils as theme, performanceUtils as performance, };
+//# sourceMappingURL=design-system.d.ts.map

package/dist/types/shared/lib/design-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-system.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/design-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED;;GAEG;AACH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuFjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB;;OAEG;qCACqB,MAAM,YAAY,MAAM;IAOhD;;OAEG;0BACU,MAAM;CAGV,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC9B;;OAEG;;IAIH;;OAEG;;;;;IAQH;;OAEG;;;;;CAKM,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAgBjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;IAC1B;;OAEG;;;;;IAMH;;OAEG;;;;;;;IAQH;;OAEG;;;;;CAKM,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;IACvB;;OAEG;;;;;;IAQH;;OAEG;;;;;;;;;;;;IAaH;;OAEG;;;;;;;;;CASM,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB;;OAEG;;IAMH;;OAEG;;IAMH;;OAEG;0BACU,OAAO,GAAG,MAAM;CAIpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC5B;;OAEG;wBACQ,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,QAC7C,CAAC,QACD,MAAM,KACV,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAQrC;;OAEG;wBACQ,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,QAC7C,CAAC,SACA,MAAM,KACX,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAU5B,CAAC;AAEX;;GAEG;AAEH,OAAO,EACN,qBAAqB,IAAI,YAAY,EACrC,iBAAiB,IAAI,QAAQ,EAC7B,qBAAqB,IAAI,WAAW,EACpC,UAAU,IAAI,MAAM,EACpB,kBAAkB,IAAI,IAAI,EAC1B,cAAc,IAAI,KAAK,EACvB,cAAc,IAAI,UAAU,EAC5B,WAAW,IAAI,MAAM,EACrB,UAAU,IAAI,KAAK,EACnB,gBAAgB,IAAI,WAAW,GAC/B,CAAC"}

package/dist/types/shared/lib/governance/components.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+export interface DeprecationNoticeProps {
+    component: string;
+    replacement?: string;
+    removalVersion?: string;
+    migrationGuide?: string;
+    showInProduction?: boolean;
+}
+export declare const DeprecationNotice: React.FC<DeprecationNoticeProps>;
+//# sourceMappingURL=components.d.ts.map

package/dist/types/shared/lib/governance/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../../../src/shared/lib/governance/components.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA6C9D,CAAC"}

package/dist/types/shared/lib/governance/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Governance & Versioning Policies - Industry Best Practice
+ * Component lifecycle management, breaking change policies, and migration strategies
+ */
+import React from "react";
+export interface Version {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+}
+export declare const parseVersion: (versionString: string) => Version;
+export declare const compareVersions: (v1: Version, v2: Version) => number;
+export declare const isBreakingChange: (oldVersion: Version, newVersion: Version) => boolean;
+export declare const isFeatureAddition: (oldVersion: Version, newVersion: Version) => boolean;
+export declare const isPatchFix: (oldVersion: Version, newVersion: Version) => boolean;
+export interface ComponentMetadata {
+    name: string;
+    version: string;
+    status: ComponentStatus;
+    breaking: boolean;
+    deprecated: boolean;
+    replacement?: string;
+    migrationGuide?: string;
+    lastUpdated: Date;
+    author: string;
+    reviewers: string[];
+    tags: string[];
+    dependencies: string[];
+    consumers: string[];
+}
+export type ComponentStatus = "experimental" | "stable" | "deprecated" | "removed";
+declare class ComponentRegistry {
+    private components;
+    register(metadata: ComponentMetadata): void;
+    get(name: string): ComponentMetadata | undefined;
+    getAll(): ComponentMetadata[];
+    getByStatus(status: ComponentStatus): ComponentMetadata[];
+    getDeprecated(): ComponentMetadata[];
+    updateStatus(name: string, status: ComponentStatus): void;
+    deprecate(name: string, replacement?: string, migrationGuide?: string): void;
+}
+export declare const componentRegistry: ComponentRegistry;
+export interface BreakingChangePolicy {
+    allowedIn: ("major" | "minor" | "patch")[];
+    requires: ("migration-guide" | "deprecation-period" | "communication")[];
+    reviewRequired: boolean;
+    testingRequired: boolean;
+}
+export declare const breakingChangePolicies: Record<string, BreakingChangePolicy>;
+export interface MigrationStrategy {
+    fromVersion: string;
+    toVersion: string;
+    type: "automated" | "manual" | "hybrid";
+    codemod?: string;
+    guide: string;
+    breaking: boolean;
+    effort: "low" | "medium" | "high";
+    risk: "low" | "medium" | "high";
+}
+export declare const migrationStrategies: MigrationStrategy[];
+export declare const DeprecationWarning: React.FC<{
+    component: string;
+    replacement?: string;
+    removalVersion?: string;
+    migrationGuide?: string;
+}>;
+export declare const checkCompatibility: (consumerVersion: string, componentVersion: string) => {
+    compatible: boolean;
+    warnings: string[];
+    errors: string[];
+};
+export interface ComponentUsage {
+    component: string;
+    consumer: string;
+    version: string;
+    timestamp: Date;
+    frequency: number;
+    context: string[];
+}
+declare class UsageTracker {
+    private usage;
+    track(usage: ComponentUsage): void;
+    getUsage(component: string): ComponentUsage[];
+    getTopConsumers(component: string, limit?: number): ComponentUsage[];
+    getAdoptionMetrics(): {
+        totalComponents: number;
+        totalConsumers: number;
+        averageUsage: number;
+    };
+}
+export declare const usageTracker: UsageTracker;
+export interface GovernanceRule {
+    name: string;
+    description: string;
+    severity: "error" | "warning" | "info";
+    check: (component: ComponentMetadata) => boolean;
+    fix?: (component: ComponentMetadata) => ComponentMetadata;
+}
+export declare const governanceRules: GovernanceRule[];
+export declare const checkGovernance: (component: ComponentMetadata) => {
+    passed: boolean;
+    violations: Array<{
+        rule: string;
+        severity: string;
+        message: string;
+    }>;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/shared/lib/governance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared/lib/governance/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,GAAI,eAAe,MAAM,KAAG,OAUpD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,IAAI,OAAO,EAAE,IAAI,OAAO,KAAG,MAI1D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC5B,YAAY,OAAO,EACnB,YAAY,OAAO,KACjB,OAEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC7B,YAAY,OAAO,EACnB,YAAY,OAAO,KACjB,OAIF,CAAC;AAEF,eAAO,MAAM,UAAU,GACtB,YAAY,OAAO,EACnB,YAAY,OAAO,KACjB,OAMF,CAAC;AAGF,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GACxB,cAAc,GACd,QAAQ,GACR,YAAY,GACZ,SAAS,CAAC;AAEb,cAAM,iBAAiB;IACtB,OAAO,CAAC,UAAU,CAAwC;IAE1D,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,MAAM,IAAI,iBAAiB,EAAE;IAI7B,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAIzD,aAAa,IAAI,iBAAiB,EAAE;IAIpC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAQzD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;CAU5E;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAGzD,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;IAC3C,QAAQ,EAAE,CAAC,iBAAiB,GAAG,oBAAoB,GAAG,eAAe,CAAC,EAAE,CAAC;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAyBvE,CAAC;AAGF,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAWlD,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAUA,CAAC;AAGF,eAAO,MAAM,kBAAkB,GAC9B,iBAAiB,MAAM,EACvB,kBAAkB,MAAM,KACtB;IACF,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CA2BjB,CAAC;AAGF,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,cAAM,YAAY;IACjB,OAAO,CAAC,KAAK,CAAuC;IAEpD,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAOlC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAM7C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE;IAMhE,kBAAkB,IAAI;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACrB;CAYD;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC;AAG/C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACjD,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,iBAAiB,CAAC;CAC1D;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,EA+B3C,CAAC;AAGF,eAAO,MAAM,eAAe,GAC3B,WAAW,iBAAiB,KAC1B;IACF,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmBvE,CAAC"}

package/dist/types/shared/lib/governance/migrations.d.ts

@@ -0,0 +1,2 @@
+export { DeprecationNotice } from "./components";
+//# sourceMappingURL=migrations.d.ts.map

package/dist/types/shared/lib/governance/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../../../src/shared/lib/governance/migrations.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/shared/lib/governance/policies.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Governance Policies - Industry Best Practice
+ * Component lifecycle management, usage policies, and contribution guidelines
+ */
+import type { ComponentMetadata } from "./index";
+export interface GovernancePolicy {
+    id: string;
+    name: string;
+    description: string;
+    category: "design" | "development" | "accessibility" | "performance" | "testing";
+    severity: "error" | "warning" | "info";
+    check: (component: ComponentMetadata) => boolean | Promise<boolean>;
+    fix?: (component: ComponentMetadata) => ComponentMetadata | Promise<ComponentMetadata>;
+    documentation?: string;
+}
+export declare const governancePolicies: GovernancePolicy[];
+export interface VersioningPolicy {
+    type: "semantic" | "calendar" | "internal";
+    breakingChangePolicy: "major" | "minor" | "patch";
+    prereleaseFormat: string;
+    changelogRequired: boolean;
+    migrationGuideRequired: boolean;
+}
+export declare const versioningPolicy: VersioningPolicy;
+export interface ContributionGuideline {
+    id: string;
+    title: string;
+    description: string;
+    category: "code" | "design" | "documentation" | "testing";
+    required: boolean;
+    checklist: string[];
+}
+export declare const contributionGuidelines: ContributionGuideline[];
+export interface DeprecationPolicy {
+    noticePeriod: number;
+    removalPeriod: number;
+    communicationChannels: string[];
+    migrationSupport: boolean;
+    backwardCompatibility: boolean;
+}
+export declare const deprecationPolicy: DeprecationPolicy;
+export interface QualityGate {
+    id: string;
+    name: string;
+    description: string;
+    check: (component: ComponentMetadata) => Promise<boolean>;
+    blocking: boolean;
+}
+export declare const qualityGates: QualityGate[];
+export declare class GovernanceChecker {
+    checkComponent(component: ComponentMetadata): Promise<{
+        passed: boolean;
+        violations: Array<{
+            policy: string;
+            severity: string;
+            message: string;
+            category: string;
+        }>;
+        suggestions: string[];
+    }>;
+    checkAllComponents(components: ComponentMetadata[]): Promise<{
+        summary: {
+            total: number;
+            passed: number;
+            failed: number;
+            warnings: number;
+        };
+        results: Array<{
+            component: string;
+            passed: boolean;
+            violations: Array<{
+                policy: string;
+                severity: string;
+                message: string;
+                category: string;
+            }>;
+        }>;
+    }>;
+}
+export declare const governanceChecker: GovernanceChecker;
+//# sourceMappingURL=policies.d.ts.map

package/dist/types/shared/lib/governance/policies.d.ts.map

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

package/dist/types/shared/lib/governance/utils.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Migration & Deprecation Strategies - Industry Best Practice
+ * Safe component evolution and backward compatibility management
+ */
+import React from "react";
+import type { ComponentMetadata, Version } from "./index";
+export interface MigrationStrategy {
+    id: string;
+    component: string;
+    fromVersion: Version;
+    toVersion: Version;
+    type: "automated" | "manual" | "hybrid";
+    codemod?: string;
+    guide: string;
+    breaking: boolean;
+    effort: "low" | "medium" | "high";
+    risk: "low" | "medium" | "high";
+    prerequisites?: string[];
+    postMigrationSteps?: string[];
+    rollbackStrategy?: string;
+}
+export declare const migrationStrategies: MigrationStrategy[];
+export declare class MigrationManager {
+    private strategies;
+    constructor();
+    getMigrationStrategy(component: string, fromVersion: Version, toVersion: Version): MigrationStrategy | null;
+    getAvailableMigrations(component?: string): MigrationStrategy[];
+    executeMigration(strategy: MigrationStrategy, sourceCode: string): Promise<{
+        success: boolean;
+        result: string;
+        errors: string[];
+    }>;
+    private runCodemod;
+    validateMigrationPrerequisites(strategy: MigrationStrategy): {
+        valid: boolean;
+        missing: string[];
+    };
+}
+export declare const migrationManager: MigrationManager;
+export interface CompatibilityLayer {
+    component: string;
+    version: Version;
+    wrapper: React.ComponentType<Record<string, unknown>>;
+    deprecationNotice: boolean;
+}
+export declare const compatibilityLayers: CompatibilityLayer[];
+export declare const checkVersionCompatibility: (consumerVersion: string, componentVersion: string) => {
+    compatible: boolean;
+    warnings: string[];
+    errors: string[];
+    suggestedMigrations: MigrationStrategy[];
+};
+export declare const generateMigrationReport: (component: ComponentMetadata) => void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/shared/lib/governance/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/shared/lib/governance/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAG1D,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAiClD,CAAC;AAGF,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,UAAU,CAAwC;;IAQ1D,oBAAoB,CACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,GAChB,iBAAiB,GAAG,IAAI;IAa3B,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAMzD,gBAAgB,CACrB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;YAqBpD,UAAU;IAuBxB,8BAA8B,CAAC,QAAQ,EAAE,iBAAiB,GAAG;QAC5D,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KAClB;CAgBD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAGvD,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,iBAAiB,EAAE,OAAO,CAAC;CAC3B;AAGD,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAgBnD,CAAC;AAGF,eAAO,MAAM,yBAAyB,GACrC,iBAAiB,MAAM,EACvB,kBAAkB,MAAM,KACtB;IACF,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;CA6CzC,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAAI,WAAW,iBAAiB,SA+BnE,CAAC"}