@nice2dev/ui-core 1.0.10

package/dist/core/adapters.d.ts

@@ -0,0 +1,178 @@
+/**
+ * adapters.ts — Integration adapters for popular state management & data libraries.
+ *
+ * React Query, Zustand, Redux, GraphQL subscriptions, OpenAPI.
+ */
+export interface NiceDataSourceConfig<T = unknown> {
+    load: (params?: Record<string, unknown>) => Promise<T[]>;
+    insert?: (item: T) => Promise<T>;
+    update?: (key: unknown, values: Partial<T>) => Promise<T>;
+    remove?: (key: unknown) => Promise<void>;
+}
+/**
+ * Creates a NiceDataSource-compatible config from React Query hooks.
+ *
+ * Usage:
+ *   const config = createReactQueryAdapter({
+ *     queryKey: ['users'],
+ *     queryFn: () => fetch('/api/users').then(r => r.json()),
+ *     mutationFn: (item) => fetch('/api/users', { method: 'POST', body: JSON.stringify(item) }),
+ *   });
+ */
+export interface ReactQueryAdapterConfig<T> {
+    queryKey: unknown[];
+    queryFn: (params?: Record<string, unknown>) => Promise<T[]>;
+    mutationFn?: (item: T) => Promise<T>;
+    updateMutationFn?: (args: {
+        key: unknown;
+        values: Partial<T>;
+    }) => Promise<T>;
+    deleteMutationFn?: (key: unknown) => Promise<void>;
+    /** React Query's QueryClient instance. */
+    queryClient?: {
+        invalidateQueries: (opts: {
+            queryKey: unknown[];
+        }) => void;
+    };
+}
+export declare function createReactQueryAdapter<T>(config: ReactQueryAdapterConfig<T>): NiceDataSourceConfig<T>;
+/**
+ * Connects a Zustand store to NiceDataSource.
+ *
+ * Usage:
+ *   const adapter = createZustandAdapter(useUserStore, {
+ *     getData: (state) => state.users,
+ *     addItem: (state) => state.addUser,
+ *     updateItem: (state) => state.updateUser,
+ *     removeItem: (state) => state.removeUser,
+ *   });
+ */
+export interface ZustandAdapterConfig<TStore, T> {
+    getData: (state: TStore) => T[];
+    addItem?: (state: TStore) => (item: T) => void;
+    updateItem?: (state: TStore) => (key: unknown, values: Partial<T>) => void;
+    removeItem?: (state: TStore) => (key: unknown) => void;
+}
+export declare function createZustandAdapter<TStore, T>(useStore: {
+    getState: () => TStore;
+}, config: ZustandAdapterConfig<TStore, T>): NiceDataSourceConfig<T>;
+/**
+ * Redux middleware that syncs NiceDataGrid/NiceForm state with Redux store.
+ *
+ * Usage:
+ *   const middleware = createNiceReduxMiddleware({
+ *     actionPrefix: 'nice',
+ *     onGridStateChange: (gridId, state) => store.dispatch(setGridState(gridId, state)),
+ *   });
+ *   const store = configureStore({ middleware: [middleware] });
+ */
+export interface NiceReduxMiddlewareConfig {
+    actionPrefix?: string;
+    onGridStateChange?: (gridId: string, state: Record<string, unknown>) => void;
+    onFormStateChange?: (formId: string, values: Record<string, unknown>) => void;
+}
+export interface ReduxAction {
+    type: string;
+    payload?: unknown;
+    meta?: Record<string, unknown>;
+}
+export type ReduxMiddleware = (store: {
+    getState: () => unknown;
+    dispatch: (action: ReduxAction) => void;
+}) => (next: (action: ReduxAction) => unknown) => (action: ReduxAction) => unknown;
+export declare function createNiceReduxMiddleware(config?: NiceReduxMiddlewareConfig): ReduxMiddleware;
+/** Redux actions for Nice components. */
+export declare function niceReduxActions(prefix?: string): {
+    setGridState: (gridId: string, state: Record<string, unknown>) => ReduxAction;
+    setGridFilter: (gridId: string, filter: unknown) => ReduxAction;
+    setGridSort: (gridId: string, sort: unknown) => ReduxAction;
+    setFormValues: (formId: string, values: Record<string, unknown>) => ReduxAction;
+    resetForm: (formId: string) => ReduxAction;
+};
+/** Redux reducer for Nice component state. */
+export declare function niceReduxReducer(prefix?: string): (state: Record<string, Record<string, unknown>> | undefined, action: ReduxAction) => Record<string, Record<string, unknown>>;
+/**
+ * Creates a data source backed by GraphQL subscriptions for real-time data.
+ *
+ * Usage:
+ *   const source = createGraphQLSubscriptionSource({
+ *     url: 'wss://api.example.com/graphql',
+ *     query: 'subscription { usersUpdated { id name } }',
+ *     queryFn: () => fetch('/api/users').then(r => r.json()),
+ *   });
+ */
+export interface GraphQLSubscriptionConfig<T> {
+    url: string;
+    query: string;
+    variables?: Record<string, unknown>;
+    queryFn: () => Promise<T[]>;
+    onData?: (data: T[]) => void;
+    extractData?: (payload: unknown) => T[];
+    connectionParams?: Record<string, unknown>;
+}
+export interface GraphQLSubscriptionSource<T> extends NiceDataSourceConfig<T> {
+    subscribe: () => () => void;
+    unsubscribe: () => void;
+}
+export declare function createGraphQLSubscriptionSource<T>(config: GraphQLSubscriptionConfig<T>): GraphQLSubscriptionSource<T>;
+/**
+ * Generates NiceDataGrid columns and NiceForm fields from an OpenAPI schema.
+ *
+ * Usage:
+ *   const { columns, formFields } = await generateFromOpenAPI('/api/swagger.json', 'User');
+ */
+export interface OpenAPIProperty {
+    type?: string;
+    format?: string;
+    title?: string;
+    description?: string;
+    enum?: string[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    readOnly?: boolean;
+    nullable?: boolean;
+    $ref?: string;
+    items?: OpenAPIProperty;
+}
+export interface OpenAPISchema {
+    type?: string;
+    properties?: Record<string, OpenAPIProperty>;
+    required?: string[];
+}
+export interface GridColumnDef {
+    dataField: string;
+    caption: string;
+    dataType: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'object';
+    width?: number;
+    allowEditing?: boolean;
+    visible?: boolean;
+    validationRules?: Record<string, unknown>[];
+    lookup?: {
+        dataSource: string[];
+        valueExpr: string;
+        displayExpr: string;
+    };
+}
+export interface FormFieldDef {
+    dataField: string;
+    label: string;
+    editorType: string;
+    editorOptions?: Record<string, unknown>;
+    validationRules?: Record<string, unknown>[];
+    isRequired?: boolean;
+    colSpan?: number;
+}
+export interface OpenAPIGeneratedUI {
+    columns: GridColumnDef[];
+    formFields: FormFieldDef[];
+    schema: OpenAPISchema;
+}
+export declare function generateFromOpenAPI(swaggerUrl: string, schemaName: string): Promise<OpenAPIGeneratedUI>;
+/** Generate columns from schema object directly (no fetch). */
+export declare function generateColumnsFromSchema(schema: OpenAPISchema): GridColumnDef[];
+/** Generate form fields from schema object directly (no fetch). */
+export declare function generateFormFieldsFromSchema(schema: OpenAPISchema): FormFieldDef[];
+//# sourceMappingURL=adapters.d.ts.map

package/dist/core/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/core/adapters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACrC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,0CAA0C;IAC1C,WAAW,CAAC,EAAE;QACZ,iBAAiB,EAAE,CAAC,IAAI,EAAE;YAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;SAAE,KAAK,IAAI,CAAC;KAC5D,CAAC;CACH;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACjC,oBAAoB,CAAC,CAAC,CAAC,CA4BzB;AAID;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB,CAAC,MAAM,EAAE,CAAC;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAC5C,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;CAAE,EACpC,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,GACtC,oBAAoB,CAAC,CAAC,CAAC,CAwBzB;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7E,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC/E;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE;IACpC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACzC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,KAAK,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;AAEnF,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,yBAA8B,GAAG,eAAe,CAwBjG;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,MAAM,SAAS;2BAErB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,WAAW;4BAInD,MAAM,UAAU,OAAO,KAAG,WAAW;0BAIvC,MAAM,QAAQ,OAAO,KAAG,WAAW;4BAIjC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,WAAW;wBAIzD,MAAM,KAAG,WAAW;EAI3C;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,wEAEX,WAAW,6CA2B/C;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,EAAE,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC;IAC3E,SAAS,EAAE,MAAM,MAAM,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,+BAA+B,CAAC,CAAC,EAC/C,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACnC,yBAAyB,CAAC,CAAC,CAAC,CAoE9B;AAID;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA6C7B;AAED,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,CAWhF;AAED,mEAAmE;AACnE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,EAAE,CAclF"}

package/dist/core/ai.d.ts

@@ -0,0 +1,191 @@
+import React from 'react';
+/** Supported AI providers */
+export type AIProvider = 'openai' | 'anthropic' | 'azure-openai' | 'local' | 'custom';
+/** AI request message */
+export interface AIMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** AI completion options */
+export interface AICompletionOptions {
+    /** Model to use (e.g., 'gpt-4', 'claude-3') */
+    model?: string;
+    /** Temperature (0-2, lower = more deterministic) */
+    temperature?: number;
+    /** Max tokens to generate */
+    maxTokens?: number;
+    /** Stop sequences */
+    stop?: string[];
+    /** Enable streaming */
+    stream?: boolean;
+    /** Tool/function definitions for function calling */
+    tools?: AIToolDefinition[];
+    /** System prompt override */
+    systemPrompt?: string;
+}
+/** AI tool/function definition */
+export interface AIToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** AI tool call result */
+export interface AIToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** AI completion response */
+export interface AICompletionResponse {
+    content: string;
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    toolCalls?: AIToolCall[];
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** Streaming chunk */
+export interface AIStreamChunk {
+    content: string;
+    done: boolean;
+    toolCalls?: AIToolCall[];
+}
+/** AI provider configuration */
+export interface AIProviderConfig {
+    /** Provider type */
+    provider: AIProvider;
+    /** API key (for hosted providers) */
+    apiKey?: string;
+    /** API endpoint URL */
+    endpoint?: string;
+    /** Default model */
+    defaultModel?: string;
+    /** Organization ID (for OpenAI) */
+    organizationId?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Custom request handler for 'custom' provider */
+    customHandler?: (messages: AIMessage[], options: AICompletionOptions) => Promise<AICompletionResponse>;
+    /** Custom streaming handler */
+    customStreamHandler?: (messages: AIMessage[], options: AICompletionOptions, onChunk: (chunk: AIStreamChunk) => void) => Promise<void>;
+}
+/** AI context value */
+export interface NiceAIContextValue {
+    /** Check if AI is configured */
+    isConfigured: boolean;
+    /** Current provider */
+    provider: AIProvider | null;
+    /** Default model */
+    defaultModel: string | null;
+    /** Complete a prompt (non-streaming) */
+    complete: (messages: AIMessage[], options?: AICompletionOptions) => Promise<AICompletionResponse>;
+    /** Stream a completion */
+    stream: (messages: AIMessage[], onChunk: (chunk: AIStreamChunk) => void, options?: AICompletionOptions) => Promise<void>;
+    /** Cancel ongoing requests */
+    cancel: () => void;
+    /** Check if a request is in progress */
+    isLoading: boolean;
+    /** Last error */
+    error: Error | null;
+}
+/** AI provider props */
+export interface NiceAIProviderProps {
+    /** AI configuration */
+    config: AIProviderConfig;
+    /** Children */
+    children: React.ReactNode;
+}
+export declare const NiceAIProvider: React.FC<NiceAIProviderProps>;
+export declare function useNiceAI(): NiceAIContextValue;
+export interface UseAICompletionOptions {
+    /** Initial system prompt */
+    systemPrompt?: string;
+    /** Model to use */
+    model?: string;
+    /** Temperature */
+    temperature?: number;
+    /** Enable streaming by default */
+    streaming?: boolean;
+}
+export interface UseAICompletionResult {
+    /** Generated response */
+    response: string;
+    /** Is request in progress */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Send a message */
+    send: (message: string) => Promise<string>;
+    /** Send with streaming */
+    sendStreaming: (message: string, onChunk?: (content: string) => void) => Promise<string>;
+    /** Clear response */
+    clear: () => void;
+    /** Cancel ongoing request */
+    cancel: () => void;
+    /** Conversation history */
+    history: AIMessage[];
+    /** Clear history */
+    clearHistory: () => void;
+}
+export declare function useAICompletion(options?: UseAICompletionOptions): UseAICompletionResult;
+/** Code completion options */
+export interface UseCodeCompletionOptions {
+    /** Programming language */
+    language?: string;
+    /** Model to use */
+    model?: string;
+}
+/** Code completion hook for inline code suggestions */
+export declare function useCodeCompletion(options?: UseCodeCompletionOptions): {
+    suggestion: string;
+    isLoading: boolean;
+    complete: (prefix: string, suffix?: string) => Promise<string>;
+    explain: (code: string) => Promise<string>;
+    refactor: (code: string, instruction: string) => Promise<string>;
+    generateFromComment: (comment: string) => Promise<string>;
+};
+/** Natural language filter hook for DataGrid */
+export declare function useNaturalLanguageFilter(): {
+    parseFilter: (query: string, columns: {
+        field: string;
+        type: string;
+        label?: string;
+    }[]) => Promise<{
+        field: string;
+        operator: string;
+        value: unknown;
+    }[]>;
+    isLoading: boolean;
+};
+/** Chart type suggestion hook */
+export declare function useChartSuggestion(): {
+    suggestChartType: (data: unknown[], description?: string) => Promise<{
+        type: string;
+        reason: string;
+        config: Record<string, unknown>;
+    }>;
+    generateInsights: (data: unknown[], chartType: string) => Promise<string[]>;
+    isLoading: boolean;
+};
+/** Form generation hook */
+export declare function useFormGeneration(): {
+    generateForm: (description: string) => Promise<{
+        label: string;
+        field: string;
+        type: string;
+        required?: boolean;
+        options?: string[];
+    }[]>;
+    isLoading: boolean;
+};
+/** Text improvement hook for HtmlEditor */
+export declare function useTextImprovement(): {
+    improveText: (text: string, style?: "professional" | "casual" | "formal" | "concise") => Promise<string>;
+    translate: (text: string, targetLanguage: string) => Promise<string>;
+    generateHtml: (prompt: string) => Promise<string>;
+    isLoading: boolean;
+};
+export default NiceAIProvider;
+//# sourceMappingURL=ai.d.ts.map

package/dist/core/ai.d.ts.map

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

package/dist/core/animations.d.ts

@@ -0,0 +1,48 @@
+export type NiceAnimationPreset = 'fade' | 'slideUp' | 'slideDown' | 'slideLeft' | 'slideRight' | 'scaleUp' | 'scaleDown' | 'zoom' | 'flip' | 'none';
+export type NiceAnimationTiming = 'fast' | 'normal' | 'slow' | number;
+export interface NiceAnimationConfig {
+    /** Animation preset or 'none' to disable */
+    type: NiceAnimationPreset;
+    /** Duration: 'fast'=120ms, 'normal'=200ms, 'slow'=300ms, or number in ms */
+    duration?: NiceAnimationTiming;
+    /** CSS easing function */
+    easing?: string;
+    /** Delay before animation starts (ms) */
+    delay?: number;
+}
+export type NiceTransitionState = 'entering' | 'entered' | 'exiting' | 'exited';
+export interface UseNiceTransitionOptions {
+    /** Whether the element is visible/shown */
+    visible: boolean;
+    /** Animation preset */
+    animation?: NiceAnimationPreset;
+    /** Duration */
+    duration?: NiceAnimationTiming;
+    /** Called when enter transition completes */
+    onEntered?: () => void;
+    /** Called when exit transition completes */
+    onExited?: () => void;
+}
+export interface UseNiceTransitionResult {
+    /** Current transition state */
+    state: NiceTransitionState;
+    /** Whether element should be rendered in DOM */
+    shouldRender: boolean;
+    /** CSS class name to apply */
+    className: string;
+    /** Inline style with transition duration */
+    style: React.CSSProperties;
+}
+export declare function useNiceTransition(options: UseNiceTransitionOptions): UseNiceTransitionResult;
+export interface UseNiceCollapseOptions {
+    expanded: boolean;
+    duration?: NiceAnimationTiming;
+}
+export declare function useNiceCollapse(ref: React.RefObject<HTMLElement | null>, options: UseNiceCollapseOptions): React.CSSProperties;
+/**
+ * Returns animation-delay for staggering child animations.
+ * Usage: style={{ animationDelay: niceStaggerDelay(index, 50) }}
+ */
+export declare function niceStaggerDelay(index: number, interval?: number): string;
+export declare function getNiceAnimationClass(preset: NiceAnimationPreset, phase: 'enter' | 'exit'): string;
+//# sourceMappingURL=animations.d.ts.map

package/dist/core/animations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animations.d.ts","sourceRoot":"","sources":["../../src/core/animations.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,GACZ,SAAS,GACT,WAAW,GACX,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyCD,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,eAAe;IACf,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAsE5F;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACxC,OAAO,EAAE,sBAAsB,GAC9B,KAAK,CAAC,aAAa,CA8BrB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAE7E;AAID,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,OAAO,GAAG,MAAM,GACtB,MAAM,CAER"}

package/dist/core/colorBlind.d.ts

@@ -0,0 +1,22 @@
+export type NiceColorBlindMode = 'none' | 'protanopia' | 'protanomaly' | 'deuteranopia' | 'deuteranomaly' | 'tritanopia' | 'tritanomaly' | 'achromatopsia' | 'achromatomaly';
+export declare const NICE_COLOR_BLIND_MODES: NiceColorBlindMode[];
+/** Apply a color-blind simulation filter to the given element. */
+export declare function applyColorBlindMode(mode: NiceColorBlindMode, target?: HTMLElement | null): void;
+export interface UseColorBlindModeOptions {
+    /** Element to filter. Defaults to <html>. */
+    target?: HTMLElement | null;
+}
+/**
+ * React hook that applies the chosen color-blind simulation filter to the
+ * target element (defaults to <html>) and cleans up automatically on unmount.
+ *
+ * Useful for accessibility audits — drop into your app shell and expose a
+ * select control to QA teams or designers.
+ */
+export declare function useColorBlindMode(mode: NiceColorBlindMode, options?: UseColorBlindModeOptions): void;
+/** Imperative helper exposed to controls outside React. */
+export declare function createColorBlindController(target?: HTMLElement | null): {
+    set: (mode: NiceColorBlindMode) => void;
+    clear: () => void;
+};
+//# sourceMappingURL=colorBlind.d.ts.map

package/dist/core/colorBlind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorBlind.d.ts","sourceRoot":"","sources":["../../src/core/colorBlind.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,YAAY,GACZ,aAAa,GACb,cAAc,GACd,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,GACf,eAAe,CAAC;AAEpB,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,EAUtD,CAAC;AAmEF,kEAAkE;AAClE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,MAAM,GAAE,WAAW,GAAG,IAAwE,GAC7F,IAAI,CASN;AAED,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAeN;AAED,2DAA2D;AAC3D,wBAAgB,0BAA0B,CACxC,MAAM,GAAE,WAAW,GAAG,IAAwE,GAC7F;IACD,GAAG,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CASA"}