@nice2dev/ui-ai 1.0.2

package/dist/integrations.d.ts

@@ -0,0 +1,287 @@
+import { AIHintContext } from './types';
+import { UseNiceAIHintOptions } from './useNiceAIHint';
+
+/** Build AIHintContext for a text input/textarea. */
+export declare function buildTextInputContext(label: string, value?: string, opts?: {
+    placeholder?: string;
+    maxLength?: number;
+    pattern?: string;
+}): AIHintContext;
+/** Build AIHintContext for a number input/slider. */
+export declare function buildNumberInputContext(label: string, value?: number, opts?: {
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+}): AIHintContext;
+/** Build AIHintContext for a select/autocomplete/lookup. */
+export declare function buildSelectContext(label: string, value?: unknown, opts?: {
+    options?: Array<{
+        label: string;
+        value: unknown;
+    }>;
+    multiple?: boolean;
+}): AIHintContext;
+/** Build AIHintContext for a date picker/calendar. */
+export declare function buildDatePickerContext(label: string, value?: string | Date, opts?: {
+    min?: string;
+    max?: string;
+    disableWeekends?: boolean;
+}): AIHintContext;
+/** Build AIHintContext for a color picker. */
+export declare function buildColorPickerContext(label: string, value?: string, opts?: {
+    palette?: string[];
+    industry?: string;
+}): AIHintContext;
+/** Build AIHintContext for a data grid. */
+export declare function buildDataGridContext(label: string, opts?: {
+    columns?: string[];
+    rowCount?: number;
+    currentFilters?: Record<string, unknown>;
+    currentSorts?: string[];
+}): AIHintContext;
+/** Build AIHintContext for a chart. */
+export declare function buildChartContext(label: string, opts?: {
+    currentType?: string;
+    seriesCount?: number;
+    pointCount?: number;
+    dataDescription?: string;
+}): AIHintContext;
+/** Build AIHintContext for form-level AI fill. */
+export declare function buildFormFillContext(description: string, fields: Array<{
+    label: string;
+    type: string;
+    required?: boolean;
+}>): AIHintContext;
+/** Build AIHintContext for AI-powered validation messages. */
+export declare function buildValidationContext(fieldLabel: string, fieldType: string, value: unknown, error: string, opts?: {
+    rules?: Record<string, unknown>;
+}): AIHintContext;
+/** AI hint hook for text inputs — suggests content, corrects grammar. */
+export declare function useAITextHint(label: string, value?: string, opts?: {
+    placeholder?: string;
+    maxLength?: number;
+    pattern?: string;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for number inputs — suggests reasonable values/ranges. */
+export declare function useAINumberHint(label: string, value?: number, opts?: {
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for select/autocomplete — suggests best option. */
+export declare function useAISelectHint(label: string, value?: unknown, opts?: {
+    options?: Array<{
+        label: string;
+        value: unknown;
+    }>;
+    multiple?: boolean;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for date pickers — suggests relevant dates. */
+export declare function useAIDateHint(label: string, value?: string | Date, opts?: {
+    min?: string;
+    max?: string;
+    disableWeekends?: boolean;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for color pickers — suggests palettes. */
+export declare function useAIColorHint(label: string, value?: string, opts?: {
+    palette?: string[];
+    industry?: string;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI-powered validation messages — turns generic errors into friendly explanations. */
+export declare function useAIValidation(fieldLabel: string, fieldType: string, value: unknown, error: string | null, opts?: {
+    rules?: Record<string, unknown>;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI form-fill — parses a text description into form field values. */
+export declare function useAIFormFill(description: string, fields: Array<{
+    label: string;
+    type: string;
+    required?: boolean;
+}>, opts?: UseNiceAIHintOptions): import('./types').AIHintResult;
+/** Build AIHintContext for a code editor (Monaco/CodeMirror).
+ *  Returns inline completion suggestions or code review hints. */
+export declare function buildCodeEditorContext(language: string, value?: string, opts?: {
+    cursorLine?: number;
+    cursorCol?: number;
+    maxSuggestLines?: number;
+    framework?: string;
+}): AIHintContext;
+/** Build AIHintContext for HTML / rich-text editors.
+ *  Modes: seo | accessibility | grammar | cleanup */
+export declare function buildHtmlEditorContext(label: string, html?: string, opts?: {
+    mode?: 'seo' | 'accessibility' | 'grammar' | 'cleanup';
+    targetKeywords?: string[];
+    locale?: string;
+}): AIHintContext;
+/** Build AIHintContext for audio editors.
+ *  Modes: tag | bpm | mix | transcribe */
+export declare function buildAudioContext(fileName: string, opts?: {
+    bpm?: number;
+    key?: string;
+    duration?: number;
+    genre?: string;
+    mode?: 'tag' | 'bpm' | 'mix' | 'transcribe';
+}): AIHintContext;
+/** Build AIHintContext for 3D scene editors.
+ *  Modes: material | optimize | lighting | animation */
+export declare function build3DSceneContext(sceneName: string, opts?: {
+    meshCount?: number;
+    triangleCount?: number;
+    materials?: string[];
+    targetDevice?: 'web' | 'mobile' | 'desktop' | 'vr';
+    mode?: 'material' | 'optimize' | 'lighting' | 'animation';
+}): AIHintContext;
+/** Build AIHintContext for graphics / pixel-art editors.
+ *  Modes: filter | palette | upscale | style-transfer */
+export declare function buildGraphicsContext(imageName: string, opts?: {
+    width?: number;
+    height?: number;
+    mode?: 'filter' | 'palette' | 'upscale' | 'style-transfer';
+    targetStyle?: string;
+}): AIHintContext;
+/** Build AIHintContext for icon picker — semantic search over an icon set. */
+export declare function buildIconSearchContext(query: string, opts?: {
+    availableIcons?: string[];
+    limit?: number;
+    style?: 'outline' | 'solid' | 'duotone';
+}): AIHintContext;
+/** AI code completion hook for Monaco/CodeMirror editors. */
+export declare function useAICodeHint(language: string, value?: string, opts?: {
+    cursorLine?: number;
+    cursorCol?: number;
+    maxSuggestLines?: number;
+    framework?: string;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for HTML/rich-text editors — SEO, accessibility, grammar, cleanup. */
+export declare function useAIHtmlHint(label: string, html?: string, opts?: {
+    mode?: 'seo' | 'accessibility' | 'grammar' | 'cleanup';
+    targetKeywords?: string[];
+    locale?: string;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for audio editors — tagging, BPM detection, mix advice, transcription. */
+export declare function useAIAudioHint(fileName: string, opts?: {
+    bpm?: number;
+    key?: string;
+    duration?: number;
+    genre?: string;
+    mode?: 'tag' | 'bpm' | 'mix' | 'transcribe';
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for 3D scene editors — material suggestions, optimization, lighting, animation. */
+export declare function useAI3DHint(sceneName: string, opts?: {
+    meshCount?: number;
+    triangleCount?: number;
+    materials?: string[];
+    targetDevice?: 'web' | 'mobile' | 'desktop' | 'vr';
+    mode?: 'material' | 'optimize' | 'lighting' | 'animation';
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI hint hook for graphics/pixel-art editors — filter params, palette, upscale, style-transfer. */
+export declare function useAIGraphicsHint(imageName: string, opts?: {
+    width?: number;
+    height?: number;
+    mode?: 'filter' | 'palette' | 'upscale' | 'style-transfer';
+    targetStyle?: string;
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+/** AI icon search hook — returns semantically relevant icon names for a text query. */
+export declare function useAIIconSearch(query: string, opts?: {
+    availableIcons?: string[];
+    limit?: number;
+    style?: 'outline' | 'solid' | 'duotone';
+} & UseNiceAIHintOptions): import('./types').AIHintResult;
+export interface GameEngineAIContext {
+    /** Name or ID of the NPC / entity */
+    npcName: string;
+    /** Current game state relevant to the NPC (position, health, nearby entities, etc.) */
+    gameState?: Record<string, unknown>;
+    /** Current behaviour tree status (node names + statuses) */
+    btStatus?: Array<{
+        node: string;
+        status: 'success' | 'failure' | 'running';
+    }>;
+    /** Mode: choose the AI task */
+    mode?: 'npc-decision' | 'dialogue' | 'procedural-level' | 'quest-description' | 'item-description';
+    /** Genre / setting: fantasy, sci-fi, horror, western, etc. */
+    genre?: string;
+    /** Max output tokens override */
+    maxTokens?: number;
+}
+export declare function buildGameEngineContext(npcName: string, opts?: Omit<GameEngineAIContext, 'npcName'>): AIHintContext;
+/** Game Engine AI hook — NPC decisions, dialogue, procedural content, quest & item descriptions. */
+export declare function useAINpcHint(npcName: string, opts?: Omit<GameEngineAIContext, 'npcName'> & UseNiceAIHintOptions): import('./types').AIHintResult;
+export interface DiagramAIContext {
+    /** Node data with positions and connections */
+    nodes: Array<{
+        id: string;
+        type?: string;
+        label?: string;
+        x: number;
+        y: number;
+        width?: number;
+        height?: number;
+    }>;
+    /** Edge data showing connections */
+    edges: Array<{
+        id: string;
+        source: string;
+        target: string;
+        type?: string;
+    }>;
+    /** Diagram type: flowchart, org-chart, bpmn, network, etc. */
+    diagramType?: string;
+    /** Mode for AI suggestions */
+    mode?: 'layout' | 'structure' | 'simplify' | 'group';
+    /** Container dimensions */
+    containerSize?: {
+        width: number;
+        height: number;
+    };
+}
+/** Build AIHintContext for diagram layout suggestions. */
+export declare function buildDiagramLayoutContext(nodes: DiagramAIContext['nodes'], edges: DiagramAIContext['edges'], opts?: Omit<DiagramAIContext, 'nodes' | 'edges'>): AIHintContext;
+/** AI hook for diagram layout suggestions.
+ *  Returns suggested node positions and structural improvements. */
+export declare function useAIDiagramLayout(nodes: DiagramAIContext['nodes'], edges: DiagramAIContext['edges'], opts?: Omit<DiagramAIContext, 'nodes' | 'edges'> & UseNiceAIHintOptions): import('./types').AIHintResult;
+export interface PresentationAIContext {
+    /** User's prompt or description for the presentation */
+    prompt: string;
+    /** Presentation type: business, educational, pitch, report, etc. */
+    presentationType?: string;
+    /** Target audience */
+    audience?: string;
+    /** Estimated duration in minutes */
+    duration?: number;
+    /** Available data context (charts, tables, etc.) */
+    dataContext?: Record<string, unknown>;
+    /** Mode for AI generation */
+    mode?: 'generate' | 'summarize' | 'expand' | 'improve';
+}
+/** Build AIHintContext for AI presentation generation. */
+export declare function buildPresentationGenerateContext(prompt: string, opts?: Omit<PresentationAIContext, 'prompt'>): AIHintContext;
+/** AI hook for presentation generation.
+ *  Returns slide outline from text description. */
+export declare function useAIPresentationGenerate(prompt: string, opts?: Omit<PresentationAIContext, 'prompt'> & UseNiceAIHintOptions): import('./types').AIHintResult;
+export interface SlideDesignAIContext {
+    /** Current slide content */
+    slide: {
+        title?: string;
+        content?: string;
+        layout?: string;
+        elements?: Array<{
+            type: string;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    };
+    /** Theme/brand colors */
+    brandColors?: string[];
+    /** Mode for design suggestions */
+    mode?: 'alignment' | 'contrast' | 'spacing' | 'typography' | 'all';
+}
+/** Build AIHintContext for slide design suggestions. */
+export declare function buildSlideDesignContext(slide: SlideDesignAIContext['slide'], opts?: Omit<SlideDesignAIContext, 'slide'>): AIHintContext;
+/** AI hook for slide design suggestions.
+ *  Returns alignment, contrast, spacing, and typography improvements. */
+export declare function useAISlideDesign(slide: SlideDesignAIContext['slide'], opts?: Omit<SlideDesignAIContext, 'slide'> & UseNiceAIHintOptions): import('./types').AIHintResult;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/integrations.d.ts.map

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

package/dist/rateLimiter.d.ts

@@ -0,0 +1,23 @@
+import { RateLimitConfig, RateLimitStatus } from './types';
+
+export declare class RateLimiter {
+    private timestamps;
+    private tokenCount;
+    private readonly config;
+    private onWarning?;
+    private warningEmitted;
+    constructor(config?: RateLimitConfig, onWarning?: () => void);
+    /** Check whether a new request is allowed. */
+    canRequest(): boolean;
+    /** Record a new request. Returns false if rate-limited. */
+    recordRequest(): boolean;
+    /** Record token usage from a completed/streaming response. */
+    recordTokens(count: number): void;
+    /** Get current rate limit status. */
+    getStatus(): RateLimitStatus;
+    /** Reset all counters. */
+    reset(): void;
+    private pruneOldTimestamps;
+    private checkWarning;
+}
+//# sourceMappingURL=rateLimiter.d.ts.map

package/dist/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../src/rateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAMhE,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,eAAoB,EAAE,SAAS,CAAC,EAAE,MAAM,IAAI;IAShE,8CAA8C;IAC9C,UAAU,IAAI,OAAO;IAOrB,2DAA2D;IAC3D,aAAa,IAAI,OAAO;IAMxB,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,qCAAqC;IACrC,SAAS,IAAI,eAAe;IAqB5B,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,YAAY;CAQrB"}

package/dist/streaming.d.ts

@@ -0,0 +1,25 @@
+import { StreamChunk } from './types';
+
+/**
+ * Parse an SSE (Server-Sent Events) stream from a fetch Response.
+ * Yields text tokens as they arrive.
+ *
+ * Supports:
+ * - OpenAI streaming format (`data: {"choices":[{"delta":{"content":"..."}}]}`)
+ * - Plain text streaming (each line is a token)
+ * - NDJSON streaming (each line is a JSON object with a `text` or `content` field)
+ */
+export declare function parseSSEStream(response: Response, signal?: AbortSignal): AsyncGenerator<{
+    token: string;
+    done: boolean;
+    usage?: StreamChunk['usage'];
+}>;
+/**
+ * Parse a non-streaming JSON response (single completion).
+ * Returns the full text content.
+ */
+export declare function parseJSONResponse(response: Response): Promise<{
+    text: string;
+    usage?: StreamChunk['usage'];
+}>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAO3C;;;;;;;;GAQG;AACH,wBAAuB,cAAc,CACnC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CA8EhF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CA4BzD"}

package/dist/style.css

@@ -0,0 +1 @@
+:root{--ntd-ai-bg: #1e1e2e;--ntd-ai-fg: #cdd6f4;--ntd-ai-border: #45475a;--ntd-ai-trigger-color: #a78bfa;--ntd-ai-error: #f38ba8}.ntd-ai-trigger:hover{opacity:1!important;transform:scale(1.15)}.ntd-ai-trigger:focus-visible{outline:2px solid var(--ntd-ai-trigger-color);outline-offset:2px}.ntd-ai-popover{animation:ntd-ai-fade-in .15s ease-out}.ntd-ai-action:hover{background-color:var(--ntd-ai-border)!important}@keyframes ntd-ai-spin{to{transform:rotate(360deg)}}@keyframes ntd-ai-blink{0%,to{opacity:1}50%{opacity:0}}@keyframes ntd-ai-fade-in{0%{opacity:0;transform:translate(-50%) translateY(4px)}to{opacity:1;transform:translate(-50%) translateY(0)}}@media (prefers-color-scheme: light){:root{--ntd-ai-bg: #ffffff;--ntd-ai-fg: #1e1e2e;--ntd-ai-border: #dce0e8;--ntd-ai-trigger-color: #7c3aed;--ntd-ai-error: #dc2626}}

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+/** Configuration for the AI endpoint connection. */
+export interface NiceAIConfig {
+    /** Full URL of the chat completions endpoint (e.g. https://api.openai.com/v1/chat/completions). */
+    endpoint: string;
+    /** API key / bearer token. Sent as Authorization header. */
+    apiKey?: string;
+    /** Model identifier (e.g. "gpt-4o", "gpt-3.5-turbo", "llama3"). */
+    model?: string;
+    /** System prompt prepended to every AI request. */
+    systemPrompt?: string;
+    /** Sampling temperature (0-2). @default 0.7 */
+    temperature?: number;
+    /** Maximum tokens in the response. @default 256 */
+    maxTokens?: number;
+    /** Additional headers sent with every request. */
+    headers?: Record<string, string>;
+    /**
+     * Privacy mode — when enabled, field values are NOT sent to the AI endpoint.
+     * Only metadata (label, type, validation rules) is included.
+     * @default false
+     */
+    privacyMode?: boolean;
+    /** Enable streaming responses (SSE). @default true */
+    stream?: boolean;
+    /** Rate limiting settings. */
+    rateLimit?: RateLimitConfig | {
+        maxRequestsPerMinute?: number;
+        maxTokensPerMinute?: number;
+        cooldownMs?: number;
+    };
+}
+/** Rate limiting configuration. */
+export interface RateLimitConfig {
+    /** Maximum requests per minute. @default 30 */
+    maxRequestsPerMinute?: number;
+    /** Maximum tokens per session (cost guard). @default 10000 */
+    maxTokensPerSession?: number;
+    /** Percentage threshold to show a warning. @default 80 */
+    warnThresholdPercent?: number;
+}
+/** Context passed to the AI for generating a hint. */
+export interface AIHintContext {
+    /** Human-readable label of the field. */
+    fieldLabel?: string;
+    /** Field type (e.g. "text", "number", "date", "select"). */
+    fieldType?: string;
+    /** Current field value (omitted in privacy mode). */
+    fieldValue?: unknown;
+    /** Validation rules applied to the field. */
+    validationRules?: Record<string, unknown>;
+    /** Key-value pairs of other form fields as context. */
+    formContext?: Record<string, unknown>;
+    /** Schema / data model description. */
+    schema?: Record<string, unknown>;
+    /** Custom user-provided prompt fragment appended to the AI request. */
+    customPrompt?: string;
+    /** Short textual hint describing field expectations. */
+    hint?: string;
+    /** Business context description for the AI. */
+    businessContext?: string;
+}
+/** Result returned by the useNiceAIHint hook. */
+export interface AIHintResult {
+    /** The AI-generated hint text (incrementally updated during streaming). */
+    text: string;
+    /** Whether a request is in-flight. */
+    loading: boolean;
+    /** Error message if the request failed. */
+    error: string | null;
+    /** Whether tokens are currently streaming in. */
+    streaming: boolean;
+    /** Abort the current request. */
+    abort: () => void;
+    /** Trigger a new request (discards cache). */
+    refresh: () => void;
+    /** Structured hint result with content and suggestions. */
+    hint?: {
+        content?: string;
+        suggestions?: string[];
+    } | null;
+    /** Fetch a hint for the given context. */
+    fetchHint: (context?: AIHintContext) => Promise<void>;
+}
+/** Rate limiter status exposed via context. */
+export interface RateLimitStatus {
+    requestsThisMinute: number;
+    tokensThisSession: number;
+    isLimited: boolean;
+    isWarning: boolean;
+}
+/** Bubble/popover position relative to the trigger icon. */
+export type AIHintPosition = 'top' | 'bottom' | 'left' | 'right' | 'auto';
+/** Props for the NiceAIHintBubble component. */
+export interface NiceAIHintBubbleProps {
+    /** Context describing the field for the AI. */
+    context: AIHintContext;
+    /** Popover position. @default 'auto' */
+    position?: AIHintPosition;
+    /** Debounce delay in ms before triggering the AI request. @default 500 */
+    debounceMs?: number;
+    /** Show hint on hover instead of click. @default false */
+    showOnHover?: boolean;
+    /** Custom trigger icon (defaults to ✨ sparkle). */
+    triggerIcon?: React.ReactNode;
+    /** Additional class name on the trigger button. */
+    className?: string;
+    /** Additional styles on the trigger button. */
+    style?: React.CSSProperties;
+    /** When to show the hint bubble. @default 'click' */
+    triggerOn?: 'hover' | 'focus' | 'click';
+}
+/** Internal chat message format (OpenAI-compatible). */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** OpenAI-compatible streaming chunk. */
+export interface StreamChunk {
+    id?: string;
+    choices?: Array<{
+        delta?: {
+            content?: string;
+            role?: string;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/useNiceAIHint.d.ts

@@ -0,0 +1,10 @@
+import { AIHintContext, AIHintResult } from './types';
+
+export interface UseNiceAIHintOptions {
+    /** Debounce delay in ms. @default 500 */
+    debounceMs?: number;
+    /** Disable the hook (useful for conditional enabling). @default false */
+    disabled?: boolean;
+}
+export declare function useNiceAIHint(context?: AIHintContext, options?: UseNiceAIHintOptions): AIHintResult;
+//# sourceMappingURL=useNiceAIHint.d.ts.map

package/dist/useNiceAIHint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNiceAIHint.d.ts","sourceRoot":"","sources":["../src/useNiceAIHint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAA6B,MAAM,SAAS,CAAC;AA8EtF,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAC3B,OAAO,GAAE,aAAkB,EAC3B,OAAO,GAAE,oBAAyB,GACjC,YAAY,CA+Kd"}

package/dist/wrappers.d.ts

@@ -0,0 +1,66 @@
+import { ComponentType, ReactNode } from 'react';
+import { AIHintContext, AIHintPosition } from './types';
+
+export interface WithAIHintProps {
+    /** Enable AI hint bubble. @default true */
+    aiEnabled?: boolean;
+    /** Position of the AI hint bubble. @default 'right' */
+    aiPosition?: AIHintPosition;
+    /** Custom AI prompt for this field. */
+    aiPrompt?: string;
+    /** Debounce delay for AI requests in ms. @default 500 */
+    aiDebounceMs?: number;
+    /** Show AI hint on hover instead of click. @default false */
+    aiShowOnHover?: boolean;
+    /** Custom trigger icon for the AI hint. */
+    aiTriggerIcon?: ReactNode;
+}
+/**
+ * Higher-order component that wraps any control with an AI hint bubble.
+ *
+ * @example
+ * const AITextInput = withAIHint(NiceTextInput, (props) => ({
+ *   fieldLabel: props.label,
+ *   fieldType: 'text',
+ *   fieldValue: props.value,
+ * }));
+ */
+export declare function withAIHint<P extends object>(WrappedComponent: ComponentType<P>, buildContext: (props: P) => AIHintContext, displayName?: string): ComponentType<P & WithAIHintProps>;
+/** Context builder for text-like controls (TextInput, TextArea). */
+export declare function textControlContext(props: {
+    label?: string;
+    value?: string;
+    placeholder?: string;
+    maxLength?: number;
+}): AIHintContext;
+/** Context builder for number controls (NumberInput, Slider). */
+export declare function numberControlContext(props: {
+    label?: string;
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}): AIHintContext;
+/** Context builder for select controls (Select, Autocomplete, Lookup). */
+export declare function selectControlContext(props: {
+    label?: string;
+    value?: unknown;
+    options?: Array<{
+        label: string;
+        value: unknown;
+    }>;
+    multiple?: boolean;
+}): AIHintContext;
+/** Context builder for date controls (DatePicker, Calendar, DateRangeBox). */
+export declare function dateControlContext(props: {
+    label?: string;
+    value?: string | Date;
+    min?: string;
+    max?: string;
+}): AIHintContext;
+/** Context builder for color controls (ColorPicker, ColorPalette, GradientPicker). */
+export declare function colorControlContext(props: {
+    label?: string;
+    value?: string;
+}): AIHintContext;
+//# sourceMappingURL=wrappers.d.ts.map

package/dist/wrappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrappers.d.ts","sourceRoot":"","sources":["../src/wrappers.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAY7D,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC,EAClC,YAAY,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,aAAa,EACzC,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAAC,CAAC,GAAG,eAAe,CAAC,CAoCpC;AAID,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,aAAa,CAMhB;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,CAMhB;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,aAAa,CAMhB;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,aAAa,CAMhB;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,aAAa,CAKhB"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@nice2dev/ui-ai",
+  "version": "1.0.2",
+  "description": "Nice2Dev AI Hints — LLM-powered contextual suggestions for UI controls (OpenAI, Azure OpenAI, Ollama, custom endpoints)",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": ["dist", "LICENSE", "CHANGELOG.md", "README.md"],
+  "sideEffects": ["*.css"],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^14.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "react", "ai", "llm", "hints", "suggestions", "openai", "azure-openai",
+    "ollama", "streaming", "sse", "smart-forms", "nice2dev"
+  ],
+  "author": "NiceToDev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicetoDev/NiceToDev.UI",
+    "directory": "packages/ui-ai"
+  }
+}