@pattern-stack/frontend-patterns 0.0.5 → 0.1.0

package/dist/atoms/utils/metric-engine.d.ts

@@ -0,0 +1,30 @@
+import type { MetricConfig, MetricValue, EntityData, TrendDataPoint } from '../types';
+export declare class MetricCalculationEngine {
+    static calculateMetric(config: MetricConfig, data: EntityData[], previousData?: EntityData[]): MetricValue;
+    private static aggregateValue;
+    private static extractValue;
+    private static calculateTrend;
+    private static formatValue;
+    private static formatDuration;
+    static calculateTrendData(config: MetricConfig, data: EntityData[], dateField?: string, periods?: number): TrendDataPoint[];
+    private static groupByPeriod;
+    private static formatDateLabel;
+    static calculateCategoryBreakdown(data: EntityData[], categoryField: string, valueField: string, maxCategories?: number): {
+        category: string;
+        value: number;
+        percentage: number;
+    }[];
+    static detectInsights(metrics: Record<string, MetricValue>, thresholds?: Record<string, {
+        warning: number;
+        critical: number;
+    }>): ({
+        type: "negative";
+        message: string;
+        value: number;
+    } | {
+        type: "positive";
+        message: string;
+        value: number;
+    })[];
+}
+//# sourceMappingURL=metric-engine.d.ts.map

package/dist/atoms/utils/metric-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-engine.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/metric-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAgB,cAAc,EAAE,MAAM,UAAU,CAAC;AAEpG,qBAAa,uBAAuB;IAClC,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,EAAE,EAClB,YAAY,CAAC,EAAE,UAAU,EAAE,GAC1B,WAAW;IAoBd,OAAO,CAAC,MAAM,CAAC,cAAc;IA4B7B,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B,OAAO,CAAC,MAAM,CAAC,WAAW;IAuC1B,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,EAAE,EAClB,SAAS,GAAE,MAAe,EAC1B,OAAO,GAAE,MAAW,GACnB,cAAc,EAAE;IAWnB,OAAO,CAAC,MAAM,CAAC,aAAa;IAc5B,OAAO,CAAC,MAAM,CAAC,eAAe;IAQ9B,MAAM,CAAC,0BAA0B,CAC/B,IAAI,EAAE,UAAU,EAAE,EAClB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,aAAa,GAAE,MAAU;;;;;IAuC3B,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACpC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAM;;;;;;;;;CAkCzE"}

package/dist/atoms/utils/tooltip-helpers.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Hook to detect if an element's text is truncated/overflowing
+ * Useful for conditionally showing tooltips only when needed
+ */
+export declare const useTextOverflow: () => {
+    ref: import("react").RefObject<HTMLElement | null>;
+    isOverflowing: boolean;
+};
+/**
+ * Formats large numbers with abbreviations
+ * Useful for StatCard values with tooltips showing full numbers
+ */
+export declare const formatNumberWithTooltip: (value: number) => {
+    display: string;
+    tooltip: string;
+};
+/**
+ * Standard tooltip content for common UI patterns
+ */
+export declare const tooltipContent: {
+    refresh: string;
+    download: string;
+    upload: string;
+    edit: string;
+    delete: string;
+    view: string;
+    filter: string;
+    search: string;
+    settings: string;
+    help: string;
+    export: string;
+    import: string;
+    add: string;
+    create: string;
+    back: string;
+    forward: string;
+    menu: string;
+    more: string;
+    copy: string;
+    paste: string;
+    share: string;
+    print: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    pending: string;
+    save: string;
+    cancel: string;
+    close: string;
+    expand: string;
+    collapse: string;
+    minimize: string;
+    maximize: string;
+    previous: string;
+    next: string;
+    first: string;
+    last: string;
+    home: string;
+    sort: string;
+    sortAsc: string;
+    sortDesc: string;
+    clearSort: string;
+    clearFilters: string;
+    clearSearch: string;
+    login: string;
+    logout: string;
+    profile: string;
+    account: string;
+};
+//# sourceMappingURL=tooltip-helpers.d.ts.map

package/dist/atoms/utils/tooltip-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-helpers.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/tooltip-helpers.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAoC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAyBzF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D1B,CAAC"}

package/dist/atoms/utils/ui-mapping.d.ts

@@ -0,0 +1,17 @@
+/**
+ * UI Component Mapping System
+ *
+ * Maps field types to their corresponding UI components
+ */
+import React from 'react';
+import type { UIFieldType, FieldRendererRegistry } from '../types/ui-config';
+import type { Breakpoint } from '../config/responsive';
+/**
+ * Default field renderers for each UI type
+ */
+export declare const defaultFieldRenderers: FieldRendererRegistry;
+/**
+ * Render a field value using the appropriate component
+ */
+export declare function renderField(value: any, fieldName: string, fieldType: UIFieldType, breakpoint: Breakpoint, item?: any, customRenderers?: Partial<FieldRendererRegistry>): React.ReactNode;
+//# sourceMappingURL=ui-mapping.d.ts.map

package/dist/atoms/utils/ui-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-mapping.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/ui-mapping.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAmFvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBA0KnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,UAAU,EACtB,IAAI,CAAC,EAAE,GAAG,EACV,eAAe,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAC/C,KAAK,CAAC,SAAS,CAUjB"}

package/dist/atoms/utils/utils.d.ts

@@ -0,0 +1,9 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+export * from './tooltip-helpers';
+export * from './metric-engine';
+export { Icon, getIcon, isValidIcon } from './icon-resolver';
+export * from './field-detection';
+export * from './ui-mapping';
+export * from './color-manager';
+//# sourceMappingURL=utils.d.ts.map

package/dist/atoms/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAGD,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7D,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/codegen/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Code Generation Utilities
+ *
+ * Build-time tools for generating code from specifications
+ */
+export * from './openapi';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC"}

package/dist/codegen/openapi/bulk-hook-generator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Bulk Operations Hook Generator
+ *
+ * Generates specialized React hooks for bulk operations with proper typing,
+ * error handling, and progress tracking.
+ *
+ * Part of FRO-35: Bulk Operations Hook Generation
+ */
+import type { ParsedEndpoint } from './parser';
+export declare class BulkHookGenerator {
+    /**
+     * Generate a bulk mutation hook with progress tracking and retry logic
+     */
+    generateBulkMutationHook(endpoint: ParsedEndpoint, hookName: string, operationName: string): string;
+    /**
+     * Generate optimistic updates for bulk operations
+     */
+    private generateBulkOptimisticUpdate;
+    /**
+     * Generate cache invalidation for bulk operations
+     */
+    private generateBulkCacheInvalidation;
+    /**
+     * Generate bulk mutation hook name
+     */
+    generateBulkMutationHookName(endpoint: ParsedEndpoint, resourceName: string): string | null;
+    /**
+     * Check if endpoint is a bulk operation
+     */
+    isBulkEndpoint(endpoint: ParsedEndpoint): boolean;
+    /**
+     * Helper to convert to camelCase
+     */
+    private camelCase;
+    /**
+     * Helper to capitalize string
+     */
+    private capitalize;
+}
+//# sourceMappingURL=bulk-hook-generator.d.ts.map

package/dist/codegen/openapi/bulk-hook-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-hook-generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/bulk-hook-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAO9C,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAgHnG;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAkFpC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAQrC;;OAEG;IACH,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAgB3F;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAKjD;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAWnB"}

package/dist/codegen/openapi/bulk-types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Bulk Operations Types
+ *
+ * Standard types for bulk operations in generated hooks
+ * Part of FRO-35: Bulk Operations Hook Generation
+ */
+/**
+ * Standard bulk operation request format
+ */
+export interface BulkOperationRequest<T = unknown> {
+    /** Array of IDs to operate on */
+    ids: Array<string | number>;
+    /** Optional additional data for the operation */
+    data?: T;
+    /** Optional operation-specific options */
+    options?: BulkOperationOptions;
+}
+/**
+ * Options for bulk operations
+ */
+export interface BulkOperationOptions {
+    /** Continue processing if some items fail */
+    continueOnError?: boolean;
+    /** Batch size for processing */
+    batchSize?: number;
+    /** Progress callback */
+    onProgress?: (progress: BulkOperationProgress) => void;
+}
+/**
+ * Progress tracking for bulk operations
+ */
+export interface BulkOperationProgress {
+    /** Total number of items to process */
+    total: number;
+    /** Number of items processed so far */
+    processed: number;
+    /** Number of successful operations */
+    succeeded: number;
+    /** Number of failed operations */
+    failed: number;
+    /** Percentage complete (0-100) */
+    percentage: number;
+    /** Current status */
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+}
+/**
+ * Standard bulk operation response format
+ */
+export interface BulkOperationResponse<T = unknown> {
+    /** Overall operation success */
+    success: boolean;
+    /** Results for successful operations */
+    succeeded: BulkOperationResult<T>[];
+    /** Results for failed operations */
+    failed: BulkOperationError[];
+    /** Summary statistics */
+    summary: BulkOperationSummary;
+}
+/**
+ * Individual result for a successful bulk operation
+ */
+export interface BulkOperationResult<T = unknown> {
+    /** ID of the processed item */
+    id: string | number;
+    /** Result data */
+    data?: T;
+    /** Operation-specific message */
+    message?: string;
+}
+/**
+ * Individual error for a failed bulk operation
+ */
+export interface BulkOperationError {
+    /** ID of the failed item */
+    id: string | number;
+    /** Error code */
+    code?: string;
+    /** Error message */
+    message: string;
+    /** Detailed error information */
+    details?: unknown;
+    /** Whether this error is retryable */
+    retryable?: boolean;
+}
+/**
+ * Summary statistics for bulk operations
+ */
+export interface BulkOperationSummary {
+    /** Total items requested */
+    total: number;
+    /** Successfully processed items */
+    succeeded: number;
+    /** Failed items */
+    failed: number;
+    /** Processing duration in ms */
+    duration?: number;
+    /** Operation timestamp */
+    timestamp: string;
+}
+/**
+ * Retry configuration for bulk operations
+ */
+export interface BulkRetryConfig {
+    /** Maximum number of retry attempts */
+    maxAttempts?: number;
+    /** Initial delay between retries (ms) */
+    initialDelay?: number;
+    /** Maximum delay between retries (ms) */
+    maxDelay?: number;
+    /** Backoff multiplier */
+    backoffMultiplier?: number;
+    /** Which errors should trigger a retry */
+    retryOn?: (error: BulkOperationError) => boolean;
+}
+/**
+ * Hook options specific to bulk operations
+ */
+export interface BulkMutationOptions<TData = unknown, TError = unknown, TVariables = unknown> {
+    /** Retry configuration */
+    retry?: BulkRetryConfig;
+    /** Progress tracking */
+    onProgress?: (progress: BulkOperationProgress) => void;
+    /** Callback for partial success */
+    onPartialSuccess?: (response: BulkOperationResponse<TData>) => void;
+    /** Transform function for request */
+    transformRequest?: (request: BulkOperationRequest<TVariables>) => unknown;
+    /** Transform function for response */
+    transformResponse?: (response: unknown) => BulkOperationResponse<TData>;
+}
+/**
+ * Type guard to check if an endpoint handles bulk operations
+ */
+export declare function isBulkOperation(path: string, method: string, requestBody?: unknown): boolean;
+/**
+ * Detect bulk operation type from endpoint
+ */
+export declare function detectBulkOperationType(path: string, method: string): 'create' | 'update' | 'delete' | 'mixed' | null;
+/**
+ * Generate a descriptive bulk operation name
+ */
+export declare function generateBulkOperationName(resource: string, operationType: string): string;
+//# sourceMappingURL=bulk-types.d.ts.map

package/dist/codegen/openapi/bulk-types.d.ts.map

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

package/dist/codegen/openapi/client-generator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * API Client Generator
+ *
+ * Creates a type-safe API client with interceptors and error handling
+ * based on parsed OpenAPI specifications.
+ *
+ * Part of FRO-12: API Client Generator
+ */
+import type { ParsedOpenAPI } from './parser';
+export interface ClientGeneratorOptions {
+    clientType: 'axios' | 'fetch';
+    baseUrl?: string;
+    includeAuth?: boolean;
+    authType?: 'bearer' | 'apiKey' | 'basic';
+    timeout?: number;
+    retries?: number;
+    includeInterceptors?: boolean;
+}
+export interface GeneratedClient {
+    client: string;
+    methods: string;
+    types: string;
+    config: string;
+    index: string;
+}
+export declare class APIClientGenerator {
+    private options;
+    constructor(options?: Partial<ClientGeneratorOptions>);
+    generate(parsedAPI: ParsedOpenAPI): GeneratedClient;
+    private generateClientSetup;
+    private generateAxiosClient;
+    private generateFetchClient;
+    private generateAxiosInterceptors;
+    private generateAuthInjection;
+    private generateFetchAuthInjection;
+    private generateApiMethods;
+    private generateEndpointMethod;
+    private generateClientTypes;
+    private generateAuthTypes;
+    private generateConfiguration;
+    private generateIndexFile;
+    private generateFileHeader;
+    private getMethodName;
+    private generatePathWithParams;
+    private getParameterType;
+    private getResponseType;
+    private groupEndpoints;
+    private camelCase;
+    private capitalize;
+}
+export declare function generateAPIClient(parsedAPI: ParsedOpenAPI, options?: ClientGeneratorOptions): GeneratedClient;
+//# sourceMappingURL=client-generator.d.ts.map

package/dist/codegen/openapi/client-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/client-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAmC,MAAM,UAAU,CAAA;AAE9E,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAkC;gBAErC,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAYzD,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,eAAe;IAUnD,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,mBAAmB;IA4G3B,OAAO,CAAC,mBAAmB;IAuI3B,OAAO,CAAC,yBAAyB;IAmEjC,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,0BAA0B;IA+BlC,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,sBAAsB;IAiE9B,OAAO,CAAC,mBAAmB;IA8C3B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;CAGnB;AAGD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAG7G"}

package/dist/codegen/openapi/confidence-scorer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Confidence scoring for generated hook names
+ * Helps identify names that may need human review
+ */
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+export interface ScoredHookName {
+    name: string;
+    confidence: ConfidenceLevel;
+    score: number;
+    issues: string[];
+    suggestions: string[];
+}
+export declare class ConfidenceScorer {
+    /**
+     * Score a generated hook name based on various quality indicators
+     */
+    scoreHookName(generatedName: string, originalOperationId: string, path: string, method: string): ScoredHookName;
+    private isProperCamelCase;
+    private hasConsecutiveUppercase;
+    private hasRepeatedWords;
+    private matchesCommonPattern;
+    private hasWordBoundaryIssues;
+    private suggestFixForConsecutiveUppercase;
+    private camelCaseToWords;
+    /**
+     * Generate a confidence report for review
+     */
+    generateReport(scoredNames: ScoredHookName[]): string;
+}
+//# sourceMappingURL=confidence-scorer.d.ts.map

package/dist/codegen/openapi/confidence-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-scorer.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/confidence-scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,eAAe,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,aAAa,CACX,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,EAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,cAAc;IA8DjB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,iCAAiC;IA2CzC,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM;CAuCtD"}

package/dist/codegen/openapi/hook-config.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Hook generation configuration system
+ * Stores learned patterns and manual overrides for hook name generation
+ */
+export interface HookNameOverride {
+    original: string;
+    override: string;
+    confidence: 'high' | 'medium' | 'low';
+    reason?: string;
+    path?: string;
+    method?: string;
+    approvedAt?: string;
+    approvedBy?: 'human' | 'auto';
+}
+export interface HookGenerationConfig {
+    version: string;
+    nameOverrides: Record<string, string>;
+    reviewedNames: HookNameOverride[];
+    patterns: {
+        removeDoubleWords: boolean;
+        smartCasing: boolean;
+        deduplicateSegments: boolean;
+    };
+    statistics?: {
+        totalGenerated: number;
+        highConfidence: number;
+        mediumConfidence: number;
+        lowConfidence: number;
+        humanReviewed: number;
+        lastUpdated: string;
+    };
+}
+export declare class HookConfigManager {
+    private configPath;
+    private config;
+    constructor(configPath?: string);
+    load(): Promise<void>;
+    save(): Promise<void>;
+    getOverride(operationId: string): string | undefined;
+    addOverride(override: HookNameOverride): void;
+    getPatterns(): {
+        removeDoubleWords: boolean;
+        smartCasing: boolean;
+        deduplicateSegments: boolean;
+    };
+    updateStatistics(stats: Partial<HookGenerationConfig['statistics']>): void;
+    getReviewedNames(): HookNameOverride[];
+    hasBeenReviewed(operationId: string): boolean;
+}
+//# sourceMappingURL=hook-config.d.ts.map

package/dist/codegen/openapi/hook-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-config.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/hook-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,aAAa,EAAE,gBAAgB,EAAE,CAAA;IACjC,QAAQ,EAAE;QACR,iBAAiB,EAAE,OAAO,CAAA;QAC1B,WAAW,EAAE,OAAO,CAAA;QACpB,mBAAmB,EAAE,OAAO,CAAA;KAC7B,CAAA;IACD,UAAU,CAAC,EAAE;QACX,cAAc,EAAE,MAAM,CAAA;QACtB,cAAc,EAAE,MAAM,CAAA;QACtB,gBAAgB,EAAE,MAAM,CAAA;QACxB,aAAa,EAAE,MAAM,CAAA;QACrB,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAaD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAuC;gBAEzC,UAAU,GAAE,MAA8B;IAIhD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAQ7C,WAAW;2BA5DU,OAAO;qBACb,OAAO;6BACC,OAAO;;IA8D9B,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAQnE,gBAAgB,IAAI,gBAAgB,EAAE;IAItC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAG9C"}

package/dist/codegen/openapi/hook-generator.d.ts

@@ -0,0 +1,108 @@
+/**
+ * React Hook Generator
+ *
+ * Generates React hooks with TanStack Query integration for API endpoints
+ * with proper TypeScript typing and error/loading states.
+ *
+ * Part of FRO-3: React Hook Generator
+ */
+import type { ParsedOpenAPI } from './parser';
+export interface HookGeneratorOptions {
+    queryKeyPrefix?: string;
+    includeInfiniteQueries?: boolean;
+    includeOptimisticUpdates?: boolean;
+    includeMutationHelpers?: boolean;
+    authenticationRequired?: boolean;
+    errorHandling?: 'throw' | 'return' | 'callback';
+    configPath?: string;
+    enableConfidenceScoring?: boolean;
+}
+export interface GeneratedHooks {
+    queries: string;
+    mutations: string;
+    keys: string;
+    types: string;
+    index: string;
+    report?: string;
+}
+export declare class ReactHookGenerator {
+    private options;
+    private configManager;
+    private confidenceScorer;
+    private bulkHookGenerator;
+    private scoredNames;
+    private resourceConfigs;
+    constructor(options?: HookGeneratorOptions);
+    /**
+     * Detect resource operations from endpoints
+     */
+    private detectResourceOperations;
+    /**
+     * Extract resource name from path
+     */
+    private extractResourceName;
+    /**
+     * Create default API config for a resource
+     */
+    private createDefaultConfig;
+    generate(parsedAPI: ParsedOpenAPI): Promise<GeneratedHooks>;
+    private generateQueryHooks;
+    private generateQueryHook;
+    private generateInfiniteQueryHook;
+    private generateMutationHooks;
+    private generateMutationHook;
+    private generateOptimisticUpdate;
+    private generateCacheInvalidation;
+    private generateQueryKeys;
+    private generateHookTypes;
+    private generateIndexFile;
+    private generateFileHeader;
+    private generateQueryHookName;
+    private generateMutationHookName;
+    private getOperationName;
+    private cleanOperationId;
+    /**
+     * Parse operation ID into structured components
+     */
+    private parseOperationId;
+    /**
+     * Extract meaningful prefix from operation ID parts
+     */
+    private extractPrefix;
+    /**
+     * Extract resources from API path
+     */
+    private extractResourcesFromPath;
+    /**
+     * Generate clean hook name from parsed components
+     */
+    private generateNameFromParsed;
+    /**
+     * Check if prefix adds meaningful context
+     */
+    private isMeaningfulPrefix;
+    /**
+     * Format name with meaningful prefix
+     */
+    private formatWithPrefix;
+    /**
+     * Format standard REST operation
+     */
+    private formatStandardOperation;
+    private generateCleanName;
+    private pluralize;
+    private singularize;
+    private hasRequiredParams;
+    private generateParamType;
+    private generateMutationType;
+    private getParameterType;
+    private isListEndpoint;
+    private groupEndpointsByResource;
+    private getRelatedQueryTags;
+    private camelCase;
+    private capitalize;
+    private getMethodPrefix;
+    private removeDuplicateSegments;
+}
+export declare function generateHooks(parsedAPI: ParsedOpenAPI, options?: HookGeneratorOptions): Promise<GeneratedHooks>;
+//# sourceMappingURL=hook-generator.d.ts.map

package/dist/codegen/openapi/hook-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/hook-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAA;AAM7D,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,aAAa,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAgDD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,eAAe,CAAoC;gBAE/C,OAAO,GAAE,oBAAyB;IAiB9C;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2EhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQrB,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA2CjE,OAAO,CAAC,kBAAkB;IAyE1B,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,yBAAyB;IAgCjC,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,wBAAwB;IAuGhC,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,iBAAiB;IAkFzB,OAAO,CAAC,iBAAiB;IAwCzB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,gBAAgB;IA2DxB,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyC/B,OAAO,CAAC,iBAAiB;IAoDzB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,uBAAuB;CAgBhC;AAGD,wBAAsB,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAGrH"}

package/dist/codegen/openapi/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OpenAPI Services
+ *
+ * Complete OpenAPI processing pipeline from specification to generated code
+ */
+export * from './parser';
+export * from './type-generator';
+export * from './client-generator';
+export * from './hook-generator';
+export * from './bulk-types';
+export * from './bulk-hook-generator';
+export { parseOpenAPI, loadOpenAPISpec } from './parser';
+export { generateTypes } from './type-generator';
+export { generateAPIClient } from './client-generator';
+export { generateHooks } from './hook-generator';
+export { BulkHookGenerator } from './bulk-hook-generator';
+export declare function processOpenAPI(spec: string | object, options?: {
+    typeOptions?: any;
+    clientOptions?: any;
+    hookOptions?: any;
+}): Promise<{
+    parsed: import("./parser").ParsedOpenAPI;
+    types: import("./type-generator").GeneratedTypes;
+    client: import("./client-generator").GeneratedClient;
+    hooks: Promise<import("./hook-generator").GeneratedHooks>;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/codegen/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AAGrC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGzD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,GAAG,CAAA;IACjB,aAAa,CAAC,EAAE,GAAG,CAAA;IACnB,WAAW,CAAC,EAAE,GAAG,CAAA;CAClB;;;;;GA4BF"}