@vocoweb/kernel 1.0.0

package/dist/react-CSDXc0m4.d.mts

@@ -0,0 +1,446 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+
+/**
+ * Shared type definitions for @vocoweb/kernel
+ */
+/**
+ * Base user identity
+ */
+interface UserId {
+    id: string;
+}
+/**
+ * Auth session information
+ */
+interface AuthSession {
+    user: {
+        id: string;
+        email: string;
+        role?: string;
+    };
+    accessToken: string;
+    expiresAt?: number;
+}
+/**
+ * API response wrapper
+ */
+interface ApiResponse<T> {
+    data: T;
+    error?: null;
+}
+/**
+ * API error wrapper
+ */
+interface ApiError {
+    data?: null;
+    error: {
+        message: string;
+        code?: string;
+        statusCode?: number;
+    };
+}
+/**
+ * Pagination parameters
+ */
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated response
+ */
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    };
+}
+/**
+ * Cookie consent choices
+ */
+type CookieConsentChoice = 'accept' | 'reject' | 'partial';
+/**
+ * Data residency region
+ */
+type DataRegion = 'eu' | 'us' | 'apac' | 'global';
+/**
+ * Request destination info
+ */
+interface RequestDestination {
+    url: string;
+    ip?: string;
+    region: DataRegion;
+    allowed: boolean;
+}
+
+/**
+ * VocoAuth Component
+ *
+ * A pre-styled, high-converting authentication component.
+ * Handles Google OAuth login with loading states and error handling.
+ *
+ * @example
+ * <VocoAuth redirectUrl="/dashboard" />
+ */
+interface VocoAuthProps {
+    /**
+     * URL to redirect to after successful authentication
+     */
+    redirectUrl?: string;
+    /**
+     * Custom CSS class name
+     */
+    className?: string;
+    /**
+     * Authentication mode
+     */
+    mode?: 'oauth' | 'password' | 'both';
+    /**
+     * OAuth providers to show
+     */
+    providers?: Array<'google' | 'github'>;
+    /**
+     * Show sign up form
+     */
+    showSignUp?: boolean;
+    /**
+     * Custom success callback
+     */
+    onSuccess?: (user: {
+        id: string;
+        email: string;
+    }) => void;
+    /**
+     * Custom error callback
+     */
+    onError?: (error: {
+        message: string;
+        code: string;
+    }) => void;
+}
+declare function VocoAuth({ redirectUrl, className, mode, providers, showSignUp, onSuccess, onError, }: VocoAuthProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Type definitions for the Legal module
+ */
+/**
+ * Privacy policy section types
+ */
+interface PrivacyPolicySection {
+    title: string;
+    content: string;
+}
+/**
+ * Privacy policy props
+ */
+interface PrivacyPolicyProps {
+    companyName: string;
+    email: string;
+    updatedAt?: string | Date;
+    websiteUrl?: string;
+    supportEmail?: string;
+    retentionDays?: number;
+    dataCategories?: string[];
+    sections?: Partial<Record<'dataCollection' | 'dataUsage' | 'dataSharing' | 'dataRetention' | 'userRights' | 'cookies' | 'security' | 'contact', PrivacyPolicySection>>;
+    className?: string;
+}
+/**
+ * Terms of service props
+ */
+interface TermsOfServiceProps {
+    companyName: string;
+    email: string;
+    updatedAt?: string | Date;
+    websiteUrl?: string;
+    jurisdiction?: string;
+    governingLaw?: string;
+    limitationOfLiability?: boolean;
+    intellectualProperty?: boolean;
+    terminationClause?: boolean;
+    className?: string;
+}
+/**
+ * Cookie category configuration
+ */
+interface CookieCategory {
+    id: string;
+    name: string;
+    description: string;
+    required: boolean;
+    scripts?: string[];
+}
+/**
+ * Cookie consent banner props
+ */
+interface CookieConsentProps {
+    onAccept?: () => void;
+    onReject?: () => void;
+    onCustomize?: (categories: Record<string, boolean>) => void;
+    position?: 'top' | 'bottom';
+    style?: 'banner' | 'modal' | 'bar';
+    categories?: CookieCategory[];
+    privacyPolicyUrl?: string;
+    acceptAllText?: string;
+    rejectAllText?: string;
+    customizeText?: string;
+    className?: string;
+}
+/**
+ * User data export result
+ */
+interface UserDataExport {
+    userId: string;
+    exportedAt: Date;
+    data: {
+        profile?: Record<string, unknown>;
+        projects?: Array<Record<string, unknown>>;
+        websites?: Array<Record<string, unknown>>;
+        usageLogs?: Array<Record<string, unknown>>;
+        subscriptions?: Array<Record<string, unknown>>;
+        invoices?: Array<Record<string, unknown>>;
+        auditLogs?: Array<Record<string, unknown>>;
+    };
+    format: 'json';
+    encrypted: boolean;
+}
+
+declare function PrivacyPolicy({ companyName, email, updatedAt, websiteUrl, supportEmail, retentionDays, dataCategories, sections, className, }: PrivacyPolicyProps): react_jsx_runtime.JSX.Element;
+
+declare function TermsOfService({ companyName, email, updatedAt, websiteUrl, jurisdiction, governingLaw, limitationOfLiability, intellectualProperty, terminationClause, className, }: TermsOfServiceProps): react_jsx_runtime.JSX.Element;
+
+declare function CookieConsent({ onAccept, onReject, onCustomize, position, style, categories, privacyPolicyUrl, acceptAllText, rejectAllText, customizeText, className, }: CookieConsentProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Accessibility type definitions for WCAG 2.1 AA compliance
+ */
+/**
+ * Accessibility props base interface
+ */
+interface AccessibilityProps {
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    role?: string;
+    className?: string;
+}
+/**
+ * Button component props with accessibility requirements
+ */
+interface ButtonProps extends AccessibilityProps {
+    children: React.ReactNode;
+    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
+    size?: 'default' | 'sm' | 'lg' | 'icon';
+    disabled?: boolean;
+    type?: 'button' | 'submit' | 'reset';
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+}
+/**
+ * Input component props with accessibility requirements
+ */
+interface InputProps extends AccessibilityProps {
+    id?: string;
+    label?: string;
+    error?: string;
+    hint?: string;
+    required?: boolean;
+    placeholder?: string;
+    type?: string;
+    disabled?: boolean;
+    name?: string;
+    value?: string;
+    onChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * Form component props with accessibility requirements
+ */
+interface FormProps extends AccessibilityProps {
+    children: React.ReactNode;
+    onSubmit?: (event: React.FormEvent<HTMLFormElement>) => void;
+    'aria-live'?: 'polite' | 'assertive' | 'off';
+    noValidate?: boolean;
+}
+/**
+ * WCAG compliance level
+ */
+type ComplianceLevel = 'A' | 'AA' | 'AAA';
+/**
+ * Color contrast result
+ */
+interface ContrastResult {
+    ratio: number;
+    aa: boolean;
+    aaa: boolean;
+    passesLargeText: boolean;
+    passesNormalText: boolean;
+    foreground: string;
+    background: string;
+}
+/**
+ * ARIA validation result
+ */
+interface AriaValidationResult {
+    valid: boolean;
+    element: string;
+    issues: Array<{
+        severity: 'error' | 'warning';
+        message: string;
+        attribute?: string;
+    }>;
+}
+/**
+ * Keyboard navigation result
+ */
+interface KeyboardNavigationResult {
+    navigable: boolean;
+    focusable: boolean;
+    tabOrder: number[];
+    issues: string[];
+}
+/**
+ * Accessibility violation
+ */
+interface AccessibilityViolation {
+    rule: string;
+    description: string;
+    impact: 'critical' | 'serious' | 'moderate' | 'minor';
+    element?: string;
+    help: string;
+    helpUrl: string;
+    wcagLevel: ComplianceLevel;
+    wcagCriteria: string;
+}
+/**
+ * Accessibility audit result
+ */
+interface AccessibilityAudit {
+    violations: AccessibilityViolation[];
+    passes: number;
+    incomplete: number;
+    url?: string;
+    timestamp: Date;
+}
+
+declare const VocoButton: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
+
+declare const VocoInput: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
+
+declare const VocoForm: react.ForwardRefExoticComponent<FormProps & react.RefAttributes<HTMLFormElement>>;
+
+/**
+ * Audit Log type definitions for enterprise compliance
+ */
+
+/**
+ * Audit action types
+ */
+type AuditAction = 'INSERT' | 'UPDATE' | 'DELETE' | 'SELECT' | 'LOGIN' | 'LOGOUT' | 'EXPORT' | 'DELETE_REQUEST';
+/**
+ * Audit log entry
+ */
+interface AuditLogEntry {
+    id: string;
+    tableName: string;
+    recordId: string;
+    action: AuditAction;
+    oldValue: Record<string, unknown> | null;
+    newValue: Record<string, unknown> | null;
+    userId: string;
+    userEmail?: string;
+    timestamp: Date;
+    ip?: string;
+    region?: DataRegion;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Audit record for storing changes
+ */
+interface AuditRecord {
+    id: string;
+    userId: string;
+    action: AuditAction;
+    tableName: string;
+    recordId: string;
+    changes: Array<{
+        field: string;
+        oldValue: unknown;
+        newValue: unknown;
+    }>;
+    timestamp: Date;
+    ip?: string;
+    userAgent?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Audit log query filters
+ */
+interface AuditQueryFilters {
+    userId?: string;
+    action?: AuditAction;
+    tableName?: string;
+    recordId?: string;
+    startDate?: Date;
+    endDate?: Date;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Audit log query result
+ */
+interface AuditQueryResult {
+    logs: AuditLogEntry[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Audit log export format
+ */
+interface AuditExport {
+    format: 'csv' | 'json';
+    data: AuditLogEntry[];
+    exportedAt: Date;
+    filters: AuditQueryFilters;
+}
+/**
+ * Database trigger configuration
+ */
+interface TriggerConfig {
+    tableName: string;
+    enabled: boolean;
+    trackFields?: string[];
+    excludeFields?: string[];
+}
+/**
+ * Audit recorder configuration
+ */
+interface AuditRecorderConfig {
+    enabled: boolean;
+    batchSize?: number;
+    flushInterval?: number;
+    excludeTables?: string[];
+    excludeFields?: Record<string, string[]>;
+}
+
+interface VocoAuditLogProps {
+    userId: string;
+    filters?: {
+        action?: AuditAction;
+        table?: string;
+        recordId?: string;
+        startDate?: Date;
+        endDate?: Date;
+    };
+    limit?: number;
+    className?: string;
+    onExport?: (format: 'csv' | 'json') => void;
+    onLogClick?: (logId: string) => void;
+    showFilters?: boolean;
+    showExport?: boolean;
+}
+declare function VocoAuditLog({ userId: _userId, filters, limit, className, onExport, onLogClick, showFilters, showExport, }: VocoAuditLogProps): react_jsx_runtime.JSX.Element;
+
+export { type AriaValidationResult as A, type ButtonProps as B, type ContrastResult as C, type DataRegion as D, VocoForm as E, type FormProps as F, VocoInput as G, type InputProps as I, type KeyboardNavigationResult as K, type PaginatedResponse as P, type RequestDestination as R, TermsOfService as T, type UserDataExport as U, VocoAuditLog as V, type ComplianceLevel as a, type AccessibilityViolation as b, type AuditRecorderConfig as c, type AuditAction as d, type AuditQueryFilters as e, type AccessibilityAudit as f, type AccessibilityProps as g, type ApiError as h, type ApiResponse as i, type AuditExport as j, type AuditLogEntry as k, type AuditQueryResult as l, type AuditRecord as m, type AuthSession as n, CookieConsent as o, type CookieConsentChoice as p, type CookieConsentProps as q, type PaginationParams as r, PrivacyPolicy as s, type PrivacyPolicyProps as t, type TermsOfServiceProps as u, type TriggerConfig as v, type UserId as w, type VocoAuditLogProps as x, VocoAuth as y, VocoButton as z };