@nice2dev/ui-ai 1.0.2

package/dist/index.mjs

@@ -0,0 +1,1078 @@
+import { jsx as x, jsxs as R } from "react/jsx-runtime";
+import { useRef as E, useCallback as I, useMemo as s, useContext as Z, createContext as p, useState as O, useEffect as H, forwardRef as j } from "react";
+class ee {
+  constructor(e = {}, n) {
+    this.timestamps = [], this.tokenCount = 0, this.warningEmitted = !1, this.config = {
+      maxRequestsPerMinute: e.maxRequestsPerMinute ?? 30,
+      maxTokensPerSession: e.maxTokensPerSession ?? 1e4,
+      warnThresholdPercent: e.warnThresholdPercent ?? 80
+    }, this.onWarning = n;
+  }
+  /** Check whether a new request is allowed. */
+  canRequest() {
+    return this.pruneOldTimestamps(), !(this.timestamps.length >= this.config.maxRequestsPerMinute || this.tokenCount >= this.config.maxTokensPerSession);
+  }
+  /** Record a new request. Returns false if rate-limited. */
+  recordRequest() {
+    return this.canRequest() ? (this.timestamps.push(Date.now()), !0) : !1;
+  }
+  /** Record token usage from a completed/streaming response. */
+  recordTokens(e) {
+    this.tokenCount += e, this.checkWarning();
+  }
+  /** Get current rate limit status. */
+  getStatus() {
+    this.pruneOldTimestamps();
+    const e = this.config.maxTokensPerSession > 0 ? this.tokenCount / this.config.maxTokensPerSession * 100 : 0, n = this.config.maxRequestsPerMinute > 0 ? this.timestamps.length / this.config.maxRequestsPerMinute * 100 : 0;
+    return {
+      requestsThisMinute: this.timestamps.length,
+      tokensThisSession: this.tokenCount,
+      isLimited: !this.canRequest(),
+      isWarning: e >= this.config.warnThresholdPercent || n >= this.config.warnThresholdPercent
+    };
+  }
+  /** Reset all counters. */
+  reset() {
+    this.timestamps = [], this.tokenCount = 0, this.warningEmitted = !1;
+  }
+  pruneOldTimestamps() {
+    const e = Date.now() - 6e4;
+    this.timestamps = this.timestamps.filter((n) => n > e);
+  }
+  checkWarning() {
+    var n;
+    if (this.warningEmitted) return;
+    this.getStatus().isWarning && (this.warningEmitted = !0, (n = this.onWarning) == null || n.call(this));
+  }
+}
+const B = p(null);
+function ke({
+  config: r,
+  rateLimits: e,
+  enabled: n = !0,
+  onRateLimitWarning: i,
+  children: t
+}) {
+  const a = E(null);
+  a.current || (a.current = new ee(e, i));
+  const u = I(() => a.current.getStatus(), []), w = s(
+    () => ({
+      config: r,
+      enabled: n,
+      rateLimiter: a.current,
+      getRateLimitStatus: u
+    }),
+    [r, n, u]
+  );
+  return /* @__PURE__ */ x(B.Provider, { value: w, children: t });
+}
+function Y() {
+  return Z(B);
+}
+async function* ne(r, e) {
+  var a, u, w, d, o, y, T, m, S;
+  const n = (a = r.body) == null ? void 0 : a.getReader();
+  if (!n)
+    throw new Error("Response body is not readable");
+  const i = new TextDecoder();
+  let t = "";
+  try {
+    for (; !(e != null && e.aborted); ) {
+      const { done: C, value: c } = await n.read();
+      if (C) break;
+      t += i.decode(c, { stream: !0 });
+      const P = t.split(`
+`);
+      t = P.pop() ?? "";
+      for (const $ of P) {
+        const l = $.trim();
+        if (!(!l || l === ":")) {
+          if (l.startsWith("data:")) {
+            const f = l.slice(5).trim();
+            if (f === "[DONE]") {
+              yield { token: "", done: !0 };
+              return;
+            }
+            try {
+              const k = JSON.parse(f), h = ((d = (w = (u = k.choices) == null ? void 0 : u[0]) == null ? void 0 : w.delta) == null ? void 0 : d.content) ?? "", b = ((y = (o = k.choices) == null ? void 0 : o[0]) == null ? void 0 : y.finish_reason) === "stop";
+              (h || b) && (yield { token: h, done: b, usage: k.usage });
+            } catch {
+              f && (yield { token: f, done: !1 });
+            }
+            continue;
+          }
+          try {
+            const f = JSON.parse(l), k = f.text ?? f.content ?? f.token ?? "";
+            k && (yield { token: k, done: !1 });
+          } catch {
+            l && (yield { token: l, done: !1 });
+          }
+        }
+      }
+    }
+    if (t.trim()) {
+      const C = t.trim();
+      if (C.startsWith("data:")) {
+        const c = C.slice(5).trim();
+        if (c && c !== "[DONE]")
+          try {
+            const $ = ((S = (m = (T = JSON.parse(c).choices) == null ? void 0 : T[0]) == null ? void 0 : m.delta) == null ? void 0 : S.content) ?? "";
+            $ && (yield { token: $, done: !0 });
+          } catch {
+            yield { token: c, done: !0 };
+          }
+      }
+    }
+  } finally {
+    n.releaseLock();
+  }
+}
+async function re(r) {
+  var n, i, t, a;
+  const e = await r.json();
+  if ((t = (i = (n = e.choices) == null ? void 0 : n[0]) == null ? void 0 : i.message) != null && t.content)
+    return {
+      text: e.choices[0].message.content,
+      usage: e.usage
+    };
+  if ((a = e.message) != null && a.content)
+    return { text: e.message.content };
+  if (typeof e.text == "string")
+    return { text: e.text };
+  if (typeof e.content == "string")
+    return { text: e.content };
+  if (typeof e.response == "string")
+    return { text: e.response };
+  throw new Error("Unrecognized AI response format");
+}
+const z = /* @__PURE__ */ new Map();
+function W(r, e) {
+  const n = e ? { ...r, fieldValue: void 0, formContext: void 0 } : r;
+  return JSON.stringify(n);
+}
+function ie(r, e) {
+  const n = [], i = e.systemPrompt ?? "You are a helpful assistant providing concise contextual hints for form fields. Keep responses short (1-3 sentences). Be specific and actionable.";
+  n.push({ role: "system", content: i });
+  const t = [];
+  if (r.fieldLabel && t.push(`Field: "${r.fieldLabel}"`), r.fieldType && t.push(`Type: ${r.fieldType}`), !e.privacyMode && r.fieldValue !== void 0) {
+    const u = typeof r.fieldValue == "string" ? r.fieldValue : JSON.stringify(r.fieldValue);
+    t.push(`Current value: ${u}`);
+  }
+  r.validationRules && Object.keys(r.validationRules).length > 0 && t.push(`Validation: ${JSON.stringify(r.validationRules)}`), r.schema && Object.keys(r.schema).length > 0 && t.push(`Schema: ${JSON.stringify(r.schema)}`), !e.privacyMode && r.formContext && Object.keys(r.formContext).length > 0 && t.push(`Form context: ${JSON.stringify(r.formContext)}`), r.customPrompt && t.push(r.customPrompt);
+  const a = t.length > 0 ? `Provide a helpful hint for this field:
+${t.join(`
+`)}` : "Provide a helpful suggestion.";
+  return n.push({ role: "user", content: a }), n;
+}
+function g(r = {}, e = {}) {
+  r = r ?? {}, e = e ?? {};
+  const { debounceMs: n = 500, disabled: i = !1 } = e, t = Y(), [a, u] = O(""), [w, d] = O(!1), [o, y] = O(null), [T, m] = O(!1), S = E(null), C = E(0), c = I(async () => {
+    var J, V, q;
+    if (!t || !t.enabled || i) return;
+    const { config: l, rateLimiter: f } = t;
+    if (!f.recordRequest()) {
+      y("Rate limit exceeded. Please wait before requesting another hint.");
+      return;
+    }
+    const k = W(r, l.privacyMode ?? !1), h = z.get(k);
+    if (h) {
+      u(h), d(!1), y(null), m(!1);
+      return;
+    }
+    (J = S.current) == null || J.abort();
+    const b = new AbortController();
+    S.current = b, d(!0), y(null), u(""), m(!1);
+    const D = ie(r, l), M = l.stream !== !1;
+    try {
+      const L = {
+        "Content-Type": "application/json",
+        ...l.headers
+      };
+      l.apiKey && (L.Authorization = `Bearer ${l.apiKey}`);
+      const Q = JSON.stringify({
+        model: l.model ?? "gpt-3.5-turbo",
+        messages: D,
+        temperature: l.temperature ?? 0.7,
+        max_tokens: l.maxTokens ?? 256,
+        stream: M
+      }), N = await fetch(l.endpoint, {
+        method: "POST",
+        headers: L,
+        body: Q,
+        signal: b.signal
+      });
+      if (!N.ok) {
+        const v = await N.text().catch(() => N.statusText);
+        throw new Error(`AI request failed (${N.status}): ${v}`);
+      }
+      if (M) {
+        m(!0);
+        let v = "";
+        for await (const A of ne(N, b.signal))
+          if (b.signal.aborted || (v += A.token, u(v), (V = A.usage) != null && V.completion_tokens && f.recordTokens(A.usage.completion_tokens), A.done)) break;
+        if (v.length > 0) {
+          const A = Math.ceil(v.length / 4);
+          f.recordTokens(A);
+        }
+        z.set(k, v);
+      } else {
+        const v = await re(N);
+        u(v.text), z.set(k, v.text), (q = v.usage) != null && q.completion_tokens ? f.recordTokens(v.usage.completion_tokens) : f.recordTokens(Math.ceil(v.text.length / 4));
+      }
+    } catch (L) {
+      if (L instanceof DOMException && L.name === "AbortError") return;
+      y(L instanceof Error ? L.message : "AI hint request failed");
+    } finally {
+      b.signal.aborted || (d(!1), m(!1));
+    }
+  }, [t, r, i]);
+  H(() => {
+    if (!t || !t.enabled || i) return;
+    const l = setTimeout(c, n);
+    return () => clearTimeout(l);
+  }, [
+    // Only re-trigger on meaningful context changes
+    r == null ? void 0 : r.fieldLabel,
+    r == null ? void 0 : r.fieldType,
+    r == null ? void 0 : r.fieldValue,
+    r == null ? void 0 : r.customPrompt,
+    n,
+    i,
+    t == null ? void 0 : t.enabled,
+    C.current
+  ]), H(() => () => {
+    var l;
+    (l = S.current) == null || l.abort();
+  }, []);
+  const P = I(() => {
+    var l;
+    (l = S.current) == null || l.abort(), d(!1), m(!1);
+  }, []), $ = I(() => {
+    if (t) {
+      const l = W(r, t.config.privacyMode ?? !1);
+      z.delete(l);
+    }
+    C.current += 1, c();
+  }, [t, r, c]);
+  return !t || !t.enabled ? {
+    text: "",
+    loading: !1,
+    error: null,
+    streaming: !1,
+    abort: () => {
+    },
+    refresh: () => {
+    },
+    hint: null,
+    fetchHint: async () => {
+    }
+  } : { text: a, loading: w, error: o, streaming: T, abort: P, refresh: $, hint: a ? { content: a } : null, fetchHint: async () => {
+    await c();
+  } };
+}
+function te() {
+  return /* @__PURE__ */ R(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      viewBox: "0 0 24 24",
+      width: "16",
+      height: "16",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: 2,
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": !0,
+      children: [
+        /* @__PURE__ */ x("path", { d: "M12 3l1.5 5.5L19 10l-5.5 1.5L12 17l-1.5-5.5L5 10l5.5-1.5z" }),
+        /* @__PURE__ */ x("path", { d: "M19 15l.5 2 2 .5-2 .5-.5 2-.5-2-2-.5 2-.5z" }),
+        /* @__PURE__ */ x("path", { d: "M5 19l.5 1.5 1.5.5-1.5.5-.5 1.5-.5-1.5-1.5-.5 1.5-.5z" })
+      ]
+    }
+  );
+}
+function ae(r, e) {
+  if (r !== "auto" || !e) return r === "auto" ? "top" : r;
+  const n = e.top, i = window.innerHeight - e.bottom, t = e.left, a = window.innerWidth - e.right, u = Math.max(n, i, t, a);
+  return u === n ? "top" : u === i ? "bottom" : u === a ? "right" : "left";
+}
+function le(r) {
+  const e = {
+    position: "absolute",
+    zIndex: 9999,
+    minWidth: 200,
+    maxWidth: 320,
+    padding: "8px 12px",
+    borderRadius: 8,
+    fontSize: 13,
+    lineHeight: 1.5,
+    backgroundColor: "var(--ntd-ai-bg, #1e1e2e)",
+    color: "var(--ntd-ai-fg, #cdd6f4)",
+    border: "1px solid var(--ntd-ai-border, #45475a)",
+    boxShadow: "0 4px 16px rgba(0,0,0,0.25)",
+    wordWrap: "break-word"
+  };
+  switch (r) {
+    case "top":
+      return { ...e, bottom: "100%", left: "50%", transform: "translateX(-50%)", marginBottom: 6 };
+    case "bottom":
+      return { ...e, top: "100%", left: "50%", transform: "translateX(-50%)", marginTop: 6 };
+    case "left":
+      return { ...e, right: "100%", top: "50%", transform: "translateY(-50%)", marginRight: 6 };
+    case "right":
+      return { ...e, left: "100%", top: "50%", transform: "translateY(-50%)", marginLeft: 6 };
+    default:
+      return { ...e, bottom: "100%", left: "50%", transform: "translateX(-50%)", marginBottom: 6 };
+  }
+}
+const G = j(
+  ({
+    context: r,
+    position: e = "auto",
+    debounceMs: n = 500,
+    showOnHover: i = !1,
+    triggerIcon: t,
+    className: a,
+    style: u
+  }, w) => {
+    var k;
+    const d = Y(), [o, y] = O(!1), [T, m] = O(!1), S = E(null), C = E(null), c = g(r, {
+      debounceMs: n,
+      disabled: !T
+    });
+    H(() => {
+      if (!o) return;
+      const h = (b) => {
+        var M, J;
+        const D = b.target;
+        (M = S.current) != null && M.contains(D) || (J = C.current) != null && J.contains(D) || (y(!1), m(!1));
+      };
+      return document.addEventListener("mousedown", h), () => document.removeEventListener("mousedown", h);
+    }, [o]), H(() => {
+      if (!o) return;
+      const h = (b) => {
+        b.key === "Escape" && (y(!1), m(!1), c.abort());
+      };
+      return document.addEventListener("keydown", h), () => document.removeEventListener("keydown", h);
+    }, [o, c]);
+    const P = I(
+      (h) => {
+        if (h.stopPropagation(), i) return;
+        const b = !o;
+        y(b), m(b);
+      },
+      [o, i]
+    ), $ = I(() => {
+      i && (y(!0), m(!0));
+    }, [i]), l = I(() => {
+      i && (y(!1), m(!1));
+    }, [i]);
+    if (!d || !d.enabled) return null;
+    const f = ae(
+      e,
+      ((k = S.current) == null ? void 0 : k.getBoundingClientRect()) ?? null
+    );
+    return /* @__PURE__ */ R(
+      "span",
+      {
+        ref: w,
+        className: a,
+        style: {
+          position: "relative",
+          display: "inline-flex",
+          ...u
+        },
+        onMouseEnter: $,
+        onMouseLeave: l,
+        children: [
+          /* @__PURE__ */ x(
+            "button",
+            {
+              ref: S,
+              type: "button",
+              onClick: P,
+              "aria-label": "AI hint",
+              "aria-expanded": o,
+              className: "ntd-ai-trigger",
+              style: {
+                display: "inline-flex",
+                alignItems: "center",
+                justifyContent: "center",
+                border: "none",
+                background: "transparent",
+                cursor: "pointer",
+                padding: 2,
+                borderRadius: 4,
+                color: "var(--ntd-ai-trigger-color, #a78bfa)",
+                opacity: 0.7,
+                transition: "opacity 0.2s, transform 0.2s"
+              },
+              children: t ?? /* @__PURE__ */ x(te, {})
+            }
+          ),
+          o && /* @__PURE__ */ R(
+            "div",
+            {
+              ref: C,
+              role: "tooltip",
+              className: "ntd-ai-popover",
+              style: le(f),
+              children: [
+                c.loading && !c.text && /* @__PURE__ */ R("div", { className: "ntd-ai-loading", style: { display: "flex", alignItems: "center", gap: 6 }, children: [
+                  /* @__PURE__ */ x(
+                    "span",
+                    {
+                      style: {
+                        display: "inline-block",
+                        width: 12,
+                        height: 12,
+                        border: "2px solid var(--ntd-ai-border, #45475a)",
+                        borderTopColor: "var(--ntd-ai-trigger-color, #a78bfa)",
+                        borderRadius: "50%",
+                        animation: "ntd-ai-spin 0.8s linear infinite"
+                      }
+                    }
+                  ),
+                  /* @__PURE__ */ x("span", { style: { opacity: 0.6 }, children: "Thinking..." })
+                ] }),
+                c.text && /* @__PURE__ */ R("div", { className: "ntd-ai-content", children: [
+                  c.text,
+                  c.streaming && /* @__PURE__ */ x(
+                    "span",
+                    {
+                      className: "ntd-ai-cursor",
+                      style: {
+                        display: "inline-block",
+                        width: 2,
+                        height: "1em",
+                        backgroundColor: "var(--ntd-ai-trigger-color, #a78bfa)",
+                        marginLeft: 1,
+                        animation: "ntd-ai-blink 0.8s step-end infinite",
+                        verticalAlign: "text-bottom"
+                      }
+                    }
+                  )
+                ] }),
+                c.error && /* @__PURE__ */ x("div", { className: "ntd-ai-error", style: { color: "var(--ntd-ai-error, #f38ba8)" }, children: c.error }),
+                c.text && !c.streaming && /* @__PURE__ */ R(
+                  "div",
+                  {
+                    style: {
+                      display: "flex",
+                      justifyContent: "flex-end",
+                      gap: 4,
+                      marginTop: 6,
+                      paddingTop: 6,
+                      borderTop: "1px solid var(--ntd-ai-border, #45475a)"
+                    },
+                    children: [
+                      /* @__PURE__ */ x(
+                        "button",
+                        {
+                          type: "button",
+                          onClick: () => c.refresh(),
+                          className: "ntd-ai-action",
+                          style: {
+                            fontSize: 11,
+                            padding: "2px 6px",
+                            border: "1px solid var(--ntd-ai-border, #45475a)",
+                            borderRadius: 4,
+                            background: "transparent",
+                            color: "inherit",
+                            cursor: "pointer"
+                          },
+                          children: "↻ Refresh"
+                        }
+                      ),
+                      /* @__PURE__ */ x(
+                        "button",
+                        {
+                          type: "button",
+                          onClick: () => {
+                            var h;
+                            (h = navigator.clipboard) == null || h.writeText(c.text);
+                          },
+                          className: "ntd-ai-action",
+                          style: {
+                            fontSize: 11,
+                            padding: "2px 6px",
+                            border: "1px solid var(--ntd-ai-border, #45475a)",
+                            borderRadius: 4,
+                            background: "transparent",
+                            color: "inherit",
+                            cursor: "pointer"
+                          },
+                          children: "⎘ Copy"
+                        }
+                      )
+                    ]
+                  }
+                )
+              ]
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+G.displayName = "NiceAIHintBubble";
+function F(r, e, n) {
+  return {
+    fieldLabel: r,
+    fieldType: "text",
+    fieldValue: e,
+    validationRules: {
+      ...(n == null ? void 0 : n.maxLength) != null ? { maxLength: n.maxLength } : {},
+      ...n != null && n.pattern ? { pattern: n.pattern } : {}
+    },
+    customPrompt: n != null && n.placeholder ? `Placeholder: "${n.placeholder}". Suggest content or correct grammar.` : "Suggest content, correct grammar, or auto-complete the text."
+  };
+}
+function K(r, e, n) {
+  return {
+    fieldLabel: r,
+    fieldType: "number",
+    fieldValue: e,
+    validationRules: {
+      ...(n == null ? void 0 : n.min) != null ? { min: n.min } : {},
+      ...(n == null ? void 0 : n.max) != null ? { max: n.max } : {},
+      ...(n == null ? void 0 : n.step) != null ? { step: n.step } : {}
+    },
+    customPrompt: n != null && n.unit ? `Unit: ${n.unit}. Suggest a reasonable value or range for this field.` : "Suggest a reasonable value or range for this field based on the label and constraints."
+  };
+}
+function _(r, e, n) {
+  return {
+    fieldLabel: r,
+    fieldType: n != null && n.multiple ? "multi-select" : "select",
+    fieldValue: e,
+    schema: n != null && n.options ? { availableOptions: n.options.slice(0, 20).map((i) => i.label) } : {},
+    customPrompt: "Suggest the most likely selection. Explain why this option is recommended."
+  };
+}
+function X(r, e, n) {
+  const i = e instanceof Date ? e.toISOString().split("T")[0] : e;
+  return {
+    fieldLabel: r,
+    fieldType: "date",
+    fieldValue: i,
+    validationRules: {
+      ...n != null && n.min ? { min: n.min } : {},
+      ...n != null && n.max ? { max: n.max } : {},
+      ...n != null && n.disableWeekends ? { noWeekends: !0 } : {}
+    },
+    customPrompt: 'Suggest a date. For example: "next business day", "end of month", "in 2 weeks". Explain your suggestion briefly.'
+  };
+}
+function U(r, e, n) {
+  return {
+    fieldLabel: r,
+    fieldType: "color",
+    fieldValue: e,
+    schema: n != null && n.palette ? { currentPalette: n.palette } : {},
+    customPrompt: n != null && n.industry ? `Industry: ${n.industry}. Suggest a color palette (3-5 hex colors) suitable for this context.` : "Suggest a color or palette of colors that works well for this context. Provide hex values."
+  };
+}
+function ve(r, e) {
+  return {
+    fieldLabel: r,
+    fieldType: "data-grid",
+    schema: {
+      ...e != null && e.columns ? { columns: e.columns } : {},
+      ...(e == null ? void 0 : e.rowCount) != null ? { totalRows: e.rowCount } : {}
+    },
+    formContext: {
+      ...e != null && e.currentFilters ? { filters: e.currentFilters } : {},
+      ...e != null && e.currentSorts ? { sorts: e.currentSorts } : {}
+    },
+    customPrompt: "Suggest column configuration, useful filters, or highlight potential data anomalies."
+  };
+}
+function we(r, e) {
+  return {
+    fieldLabel: r,
+    fieldType: "chart",
+    schema: {
+      ...e != null && e.currentType ? { chartType: e.currentType } : {},
+      ...(e == null ? void 0 : e.seriesCount) != null ? { series: e.seriesCount } : {},
+      ...(e == null ? void 0 : e.pointCount) != null ? { dataPoints: e.pointCount } : {}
+    },
+    customPrompt: e != null && e.dataDescription ? `Data: ${e.dataDescription}. Suggest the best chart type and labeling strategy.` : "Suggest the most effective chart type for this data. Explain your recommendation."
+  };
+}
+function ue(r, e) {
+  return {
+    fieldLabel: "Form auto-fill",
+    fieldType: "form",
+    schema: { fields: e },
+    customPrompt: `User description: "${r}"
+Parse this description and return suggested values for each field as JSON: { ${e.map((n) => `"${n.label}": "value"`).join(", ")} }`
+  };
+}
+function ce(r, e, n, i, t) {
+  return {
+    fieldLabel: r,
+    fieldType: e,
+    fieldValue: n,
+    validationRules: t == null ? void 0 : t.rules,
+    customPrompt: `Current validation error: "${i}". Provide a friendly, specific error message with an example of a valid value. Do NOT say "field is required" — instead explain what the user should enter.`
+  };
+}
+function Te(r, e, n) {
+  const i = s(
+    () => F(r, e, n),
+    [r, e, n == null ? void 0 : n.placeholder, n == null ? void 0 : n.maxLength, n == null ? void 0 : n.pattern]
+  );
+  return g(i, n);
+}
+function $e(r, e, n) {
+  const i = s(
+    () => K(r, e, n),
+    [r, e, n == null ? void 0 : n.min, n == null ? void 0 : n.max, n == null ? void 0 : n.step, n == null ? void 0 : n.unit]
+  );
+  return g(i, n);
+}
+function Pe(r, e, n) {
+  const i = s(
+    () => _(r, e, n),
+    [r, e, n == null ? void 0 : n.multiple]
+  );
+  return g(i, n);
+}
+function Le(r, e, n) {
+  const i = s(
+    () => X(r, e, n),
+    [r, e, n == null ? void 0 : n.min, n == null ? void 0 : n.max, n == null ? void 0 : n.disableWeekends]
+  );
+  return g(i, n);
+}
+function Re(r, e, n) {
+  const i = s(
+    () => U(r, e, n),
+    [r, e, n == null ? void 0 : n.industry]
+  );
+  return g(i, n);
+}
+function Ie(r, e, n, i, t) {
+  const a = s(
+    () => i ? ce(r, e, n, i, t) : { fieldLabel: r, fieldType: e },
+    [r, e, n, i]
+  );
+  return g(a, { ...t, disabled: !i || (t == null ? void 0 : t.disabled) });
+}
+function Ne(r, e, n) {
+  const i = s(
+    () => r ? ue(r, e) : { fieldLabel: "Form" },
+    [r, e]
+  );
+  return g(i, {
+    ...n,
+    disabled: !r || (n == null ? void 0 : n.disabled)
+  });
+}
+function de(r, e, n) {
+  const t = (e == null ? void 0 : e.split(`
+`)) ?? [], a = (n == null ? void 0 : n.cursorLine) != null ? t.slice(Math.max(0, n.cursorLine - 8), n.cursorLine + 3).join(`
+`) : t.slice(0, 8 * 2).join(`
+`);
+  return {
+    fieldLabel: `Code editor (${r})`,
+    fieldType: "code-editor",
+    fieldValue: a || e,
+    schema: {
+      language: r,
+      ...n != null && n.framework ? { framework: n.framework } : {},
+      ...(n == null ? void 0 : n.cursorLine) != null ? { cursorLine: n.cursorLine, cursorCol: n.cursorCol } : {}
+    },
+    customPrompt: `Language: ${r}${n != null && n.framework ? `, framework: ${n.framework}` : ""}.
+Provide a concise inline completion or improvement hint for the code near the cursor. Limit response to ${(n == null ? void 0 : n.maxSuggestLines) ?? 5} lines of code. If unsure, suggest the most idiomatic approach for this language/framework.`
+  };
+}
+function se(r, e, n) {
+  var a;
+  const i = (n == null ? void 0 : n.mode) ?? "grammar", t = {
+    seo: "Analyze this HTML for SEO: missing meta tags, heading hierarchy (h1→h2→h3), keyword density, image alt attributes. Return a prioritized list of improvements.",
+    accessibility: "Audit this HTML for WCAG 2.1 AA issues: missing aria labels, alt text, heading structure, color contrast hints, keyboard navigation. List specific fixes.",
+    grammar: "Fix grammar, punctuation, and writing style in the visible text content. Return the corrected text only (no HTML tags in response).",
+    cleanup: "Clean up malformed, redundant, or overly nested HTML. Simplify structure while preserving semantics and content."
+  };
+  return {
+    fieldLabel: r,
+    fieldType: "html-editor",
+    fieldValue: e == null ? void 0 : e.slice(0, 2e3),
+    schema: {
+      mode: i,
+      ...(a = n == null ? void 0 : n.targetKeywords) != null && a.length ? { targetKeywords: n.targetKeywords } : {},
+      ...n != null && n.locale ? { locale: n.locale } : {}
+    },
+    customPrompt: t[i]
+  };
+}
+function oe(r, e) {
+  const n = (e == null ? void 0 : e.mode) ?? "tag", i = `"${r}"` + ((e == null ? void 0 : e.bpm) != null ? `, BPM: ${e.bpm}` : "") + (e != null && e.key ? `, Key: ${e.key}` : "") + (e != null && e.genre ? `, Genre: ${e.genre}` : "") + ((e == null ? void 0 : e.duration) != null ? `, Duration: ${e.duration}s` : ""), t = {
+    tag: `Audio: ${i}. Suggest genre tags, mood descriptors and playlist categories. Return as JSON array of strings.`,
+    bpm: `Audio: ${i}. Suggest likely BPM range and musical key based on metadata. Return as JSON: { bpm: number, key: string }.`,
+    mix: `Track: ${i}. Suggest EQ curve (JSON array of {freq, gain, q}), compression settings, and 2-3 compatible tracks for mixing.`,
+    transcribe: "Return a transcription of the spoken audio content as JSON: { transcript: string, language: string, confidence: number }."
+  };
+  return {
+    fieldLabel: `Audio: ${r}`,
+    fieldType: "audio",
+    schema: {
+      mode: n,
+      ...(e == null ? void 0 : e.bpm) != null ? { bpm: e.bpm } : {},
+      ...e != null && e.key ? { key: e.key } : {},
+      ...(e == null ? void 0 : e.duration) != null ? { duration: e.duration } : {},
+      ...e != null && e.genre ? { genre: e.genre } : {}
+    },
+    customPrompt: t[n]
+  };
+}
+function me(r, e) {
+  var a;
+  const n = (e == null ? void 0 : e.mode) ?? "material", i = (e == null ? void 0 : e.targetDevice) ?? "web", t = {
+    material: `Scene "${r}", ${(e == null ? void 0 : e.meshCount) ?? "?"} meshes. Materials: ${((a = e == null ? void 0 : e.materials) == null ? void 0 : a.join(", ")) || "none"}. Suggest PBR properties (roughness, metalness, baseColor) and texture maps for each material.`,
+    optimize: `Scene "${r}", triangles: ${(e == null ? void 0 : e.triangleCount) ?? "?"}, target: ${i}. Identify budget issues and suggest LOD levels, mesh merging, and texture atlas strategy.`,
+    lighting: `Scene "${r}", target: ${i}. Suggest a complete lighting setup (types, intensity, color, shadow settings) for realistic rendering.`,
+    animation: `Rig in scene "${r}". Suggest animation approach (FK/IK, bone count), keyframe timing and easing curves for natural movement.`
+  };
+  return {
+    fieldLabel: `3D scene: ${r}`,
+    fieldType: "3d-scene",
+    schema: {
+      mode: n,
+      ...(e == null ? void 0 : e.meshCount) != null ? { meshes: e.meshCount } : {},
+      ...(e == null ? void 0 : e.triangleCount) != null ? { triangles: e.triangleCount } : {},
+      ...e != null && e.targetDevice ? { target: e.targetDevice } : {}
+    },
+    customPrompt: t[n]
+  };
+}
+function ge(r, e) {
+  const n = (e == null ? void 0 : e.mode) ?? "palette", i = (e == null ? void 0 : e.width) != null ? `${e.width}×${e.height ?? "?"}px` : "unknown dimensions", t = {
+    filter: `Image "${r}" (${i}). Suggest CSS/SVG filter parameters (brightness, contrast, saturate, hue-rotate, blur) as JSON: { brightness, contrast, saturate, hueRotate, blur }.`,
+    palette: `Image "${r}". Extract or suggest a harmonious 5-color palette as JSON: { primary, secondary, accent, background, text }.`,
+    upscale: `Image "${r}" at ${i}. Recommend upscaling strategy: model (ESRGAN/RealSR/SRCNN), scale factor, and expected quality gain.`,
+    "style-transfer": `Image "${r}", target style: "${(e == null ? void 0 : e.targetStyle) ?? "artistic"}". Suggest style-transfer settings as JSON: { contentWeight, styleWeight, iterations, patchSize }.`
+  };
+  return {
+    fieldLabel: `Graphics: ${r}`,
+    fieldType: "graphics",
+    schema: {
+      mode: n,
+      ...(e == null ? void 0 : e.width) != null ? { width: e.width, height: e.height } : {},
+      ...e != null && e.targetStyle ? { targetStyle: e.targetStyle } : {}
+    },
+    customPrompt: t[n]
+  };
+}
+function fe(r, e) {
+  var n;
+  return {
+    fieldLabel: "Icon search",
+    fieldType: "icon-picker",
+    fieldValue: r,
+    schema: {
+      ...e != null && e.style ? { iconStyle: e.style } : {},
+      ...(e == null ? void 0 : e.limit) != null ? { maxResults: e.limit } : {},
+      ...(n = e == null ? void 0 : e.availableIcons) != null && n.length ? { sampleIcons: e.availableIcons.slice(0, 30) } : {}
+    },
+    customPrompt: `User query: "${r}"
+Return the ${(e == null ? void 0 : e.limit) ?? 5} most semantically relevant icon names from the available set as a JSON array of strings, ordered by relevance. Prefer specific over generic names.`
+  };
+}
+function Ae(r, e, n) {
+  const i = s(
+    () => de(r, e, n),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e, n == null ? void 0 : n.cursorLine, n == null ? void 0 : n.cursorCol, n == null ? void 0 : n.framework]
+  );
+  return g(i, n);
+}
+function Oe(r, e, n) {
+  const i = s(
+    () => se(r, e, n),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e, n == null ? void 0 : n.mode, n == null ? void 0 : n.locale]
+  );
+  return g(i, n);
+}
+function Me(r, e) {
+  const n = s(
+    () => oe(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e == null ? void 0 : e.bpm, e == null ? void 0 : e.key, e == null ? void 0 : e.duration, e == null ? void 0 : e.mode]
+  );
+  return g(n, e);
+}
+function Je(r, e) {
+  const n = s(
+    () => me(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e == null ? void 0 : e.meshCount, e == null ? void 0 : e.triangleCount, e == null ? void 0 : e.targetDevice, e == null ? void 0 : e.mode]
+  );
+  return g(n, e);
+}
+function Ee(r, e) {
+  const n = s(
+    () => ge(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e == null ? void 0 : e.width, e == null ? void 0 : e.height, e == null ? void 0 : e.mode, e == null ? void 0 : e.targetStyle]
+  );
+  return g(n, e);
+}
+function De(r, e) {
+  const n = s(
+    () => fe(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e == null ? void 0 : e.limit, e == null ? void 0 : e.style]
+  );
+  return g(n, { ...e, disabled: !r || (e == null ? void 0 : e.disabled) });
+}
+function he(r, e) {
+  var a;
+  const n = (e == null ? void 0 : e.mode) ?? "npc-decision", i = (e == null ? void 0 : e.genre) ?? "fantasy", t = {
+    "npc-decision": `You are an AI game director. The NPC "${r}" must make a decision. Available BT nodes: ${JSON.stringify((e == null ? void 0 : e.btStatus) ?? [])}. Game state: ${JSON.stringify((e == null ? void 0 : e.gameState) ?? {})}. Return the name of the BT node to activate next, and one sentence of reasoning.`,
+    dialogue: `You are a ${i} RPG writer. Write a short in-character dialogue line for NPC "${r}". Game state: ${JSON.stringify((e == null ? void 0 : e.gameState) ?? {})}. Max 2 sentences, no narrative descriptions.`,
+    "procedural-level": `You are a ${i} game designer. Suggest a procedural level layout for a zone containing "${r}". Describe room count, enemy placement, loot, and one unique mechanic. Keep it under 150 words.`,
+    "quest-description": `You are a ${i} quest designer. Write a compelling quest description involving "${r}". Include: objective, giver NPC, rewards, and a short flavour paragraph. Keep it under 120 words.`,
+    "item-description": `You are a ${i} lore writer. Write a short item description for an item related to "${r}". Include: item name, rarity, flavour text, and one special property. Keep it under 80 words.`
+  };
+  return {
+    fieldLabel: r,
+    fieldType: `game-engine:${n}`,
+    fieldValue: e == null ? void 0 : e.gameState,
+    customPrompt: t[n],
+    schema: {
+      genre: i,
+      mode: n,
+      btNodes: (a = e == null ? void 0 : e.btStatus) == null ? void 0 : a.map((u) => u.node)
+    }
+  };
+}
+function ze(r, e) {
+  const n = s(
+    () => he(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e == null ? void 0 : e.mode, e == null ? void 0 : e.genre, JSON.stringify(e == null ? void 0 : e.btStatus), JSON.stringify(e == null ? void 0 : e.gameState)]
+  );
+  return g(n, e);
+}
+function ye(r, e, n) {
+  const i = (n == null ? void 0 : n.mode) ?? "layout", t = (n == null ? void 0 : n.diagramType) ?? "flowchart", a = {
+    layout: `You are a diagram layout optimizer. Given this ${t} with ${r.length} nodes and ${e.length} edges, suggest optimal positions for each node to minimize edge crossings and improve readability. Return JSON: { suggestions: [{ id: string, x: number, y: number, reason: string }] }. Consider flow direction (top-to-bottom or left-to-right) and grouping related nodes.`,
+    structure: `You are a diagram analyst. Analyze this ${t} structure. Identify: 1) Missing connections, 2) Potential bottlenecks, 3) Orphan nodes, 4) Cycles or loops. Return JSON: { issues: [{ type: string, description: string, nodeIds: string[] }], score: number }`,
+    simplify: `You are a diagram simplifier. Suggest how to simplify this ${t} while preserving meaning. Identify: nodes that could be merged, redundant edges, or overly complex branches. Return JSON: { simplifications: [{ action: 'merge'|'remove'|'group', ids: string[], reason: string }] }`,
+    group: `You are a diagram organizer. Suggest logical groupings for nodes in this ${t}. Consider semantic relationships, data flow patterns, and visual clustering. Return JSON: { groups: [{ name: string, nodeIds: string[], color?: string }] }`
+  }, u = r.map((d) => {
+    var o;
+    return {
+      id: d.id,
+      type: d.type,
+      label: (o = d.label) == null ? void 0 : o.slice(0, 30),
+      pos: [Math.round(d.x), Math.round(d.y)]
+    };
+  }), w = e.map((d) => ({
+    id: d.id,
+    src: d.source,
+    tgt: d.target
+  }));
+  return {
+    fieldLabel: `Diagram (${t})`,
+    fieldType: `diagram:${i}`,
+    fieldValue: JSON.stringify({ nodes: u, edges: w }),
+    schema: {
+      diagramType: t,
+      mode: i,
+      nodeCount: r.length,
+      edgeCount: e.length,
+      containerSize: n == null ? void 0 : n.containerSize
+    },
+    customPrompt: a[i]
+  };
+}
+function He(r, e, n) {
+  const i = s(
+    () => ye(r, e, n),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [JSON.stringify(r), JSON.stringify(e), n == null ? void 0 : n.mode, n == null ? void 0 : n.diagramType]
+  );
+  return g(i, { ...n, disabled: r.length === 0 || (n == null ? void 0 : n.disabled) });
+}
+function be(r, e) {
+  const n = (e == null ? void 0 : e.mode) ?? "generate", i = (e == null ? void 0 : e.presentationType) ?? "business", t = (e == null ? void 0 : e.duration) ?? 15, a = Math.ceil(t / 2), u = {
+    generate: `You are a presentation designer. Create a ${i} presentation outline based on: "${r}". Target audience: ${(e == null ? void 0 : e.audience) ?? "general"}. Duration: ${t} minutes (~${a} slides). Return JSON: { title: string, slides: [{ title: string, layout: 'title'|'content'|'two-column'|'chart'|'image', bullets?: string[], chartType?: string, speakerNotes?: string }] }. Include: clear slide titles, 3-5 bullet points per content slide, and brief speaker notes.`,
+    summarize: `You are a presentation optimizer. Summarize this presentation to be more concise: "${r}". Reduce slide count by 30% while preserving key messages. Return JSON: { summary: string, reducedSlides: [{ title: string, keyPoints: string[] }] }`,
+    expand: `You are a presentation expert. Expand this brief outline into a detailed presentation: "${r}". Add supporting details, examples, and transitions. Target: ${a} slides. Return JSON: { slides: [{ title: string, content: string, transitions?: string, animations?: string[] }] }`,
+    improve: `You are a presentation coach. Review and improve this presentation structure: "${r}". Suggest: better flow, stronger opening/closing, clearer data visualization. Return JSON: { improvements: [{ slide: number, issue: string, suggestion: string }], score: number }`
+  };
+  return {
+    fieldLabel: `Presentation (${i})`,
+    fieldType: `presentation:${n}`,
+    fieldValue: r,
+    schema: {
+      presentationType: i,
+      mode: n,
+      duration: t,
+      slideCount: a,
+      audience: e == null ? void 0 : e.audience,
+      hasData: (e == null ? void 0 : e.dataContext) != null
+    },
+    customPrompt: u[n]
+  };
+}
+function Ve(r, e) {
+  const n = s(
+    () => be(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [r, e == null ? void 0 : e.mode, e == null ? void 0 : e.presentationType, e == null ? void 0 : e.duration, e == null ? void 0 : e.audience]
+  );
+  return g(n, { ...e, disabled: !r || (e == null ? void 0 : e.disabled) });
+}
+function xe(r, e) {
+  var t;
+  const n = (e == null ? void 0 : e.mode) ?? "all", i = {
+    alignment: "Analyze element alignment on this slide. Suggest adjustments to create visual harmony. Return JSON: { suggestions: [{ elementIndex: number, issue: string, fixX?: number, fixY?: number }] }",
+    contrast: "Analyze color contrast and readability. Suggest improvements for accessibility (WCAG AA). Return JSON: { suggestions: [{ area: string, currentContrast: number, suggestedFix: string }] }",
+    spacing: "Analyze whitespace and element spacing. Apply the rule of thirds and consistent margins. Return JSON: { suggestions: [{ elementIndex: number, issue: string, suggestedMargin: number }] }",
+    typography: "Analyze typography: hierarchy, font sizes, line heights, readability. Return JSON: { suggestions: [{ area: string, issue: string, suggestedFontSize?: number }] }",
+    all: "Perform a complete design review of this slide. Check alignment, contrast, spacing, and typography. Return JSON: { score: number, suggestions: [{ category: string, issue: string, fix: string }] }. Prioritize issues by impact on visual clarity."
+  };
+  return {
+    fieldLabel: r.title ?? "Slide Design",
+    fieldType: `slide-design:${n}`,
+    fieldValue: JSON.stringify(r),
+    schema: {
+      mode: n,
+      hasElements: (((t = r.elements) == null ? void 0 : t.length) ?? 0) > 0,
+      layout: r.layout,
+      brandColors: e == null ? void 0 : e.brandColors
+    },
+    customPrompt: i[n]
+  };
+}
+function qe(r, e) {
+  const n = s(
+    () => xe(r, e),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [JSON.stringify(r), e == null ? void 0 : e.mode, JSON.stringify(e == null ? void 0 : e.brandColors)]
+  );
+  return g(n, e);
+}
+function We(r, e, n) {
+  const i = j((t, a) => {
+    const {
+      aiEnabled: u = !0,
+      aiPosition: w = "right",
+      aiPrompt: d,
+      aiDebounceMs: o = 500,
+      aiShowOnHover: y = !1,
+      aiTriggerIcon: T,
+      ...m
+    } = t, S = s(() => {
+      const C = e(m);
+      return d && (C.customPrompt = d), C;
+    }, [m, d]);
+    return /* @__PURE__ */ R("span", { style: { display: "inline-flex", alignItems: "center", gap: 4 }, children: [
+      /* @__PURE__ */ x(r, { ...m, ref: a }),
+      u && /* @__PURE__ */ x(
+        G,
+        {
+          context: S,
+          position: w,
+          debounceMs: o,
+          showOnHover: y,
+          triggerIcon: T
+        }
+      )
+    ] });
+  });
+  return i.displayName = n ?? `withAIHint(${r.displayName ?? r.name ?? "Component"})`, i;
+}
+function je(r) {
+  return F(
+    r.label ?? "Text",
+    r.value,
+    { placeholder: r.placeholder, maxLength: r.maxLength }
+  );
+}
+function Be(r) {
+  return K(
+    r.label ?? "Number",
+    r.value,
+    { min: r.min, max: r.max, step: r.step }
+  );
+}
+function Ye(r) {
+  return _(
+    r.label ?? "Select",
+    r.value,
+    { options: r.options, multiple: r.multiple }
+  );
+}
+function Ge(r) {
+  return X(
+    r.label ?? "Date",
+    r.value,
+    { min: r.min, max: r.max }
+  );
+}
+function Fe(r) {
+  return U(
+    r.label ?? "Color",
+    r.value
+  );
+}
+export {
+  G as NiceAIHintBubble,
+  ke as NiceAIProvider,
+  ee as RateLimiter,
+  me as build3DSceneContext,
+  oe as buildAudioContext,
+  we as buildChartContext,
+  de as buildCodeEditorContext,
+  U as buildColorPickerContext,
+  ve as buildDataGridContext,
+  X as buildDatePickerContext,
+  ye as buildDiagramLayoutContext,
+  ue as buildFormFillContext,
+  he as buildGameEngineContext,
+  ge as buildGraphicsContext,
+  se as buildHtmlEditorContext,
+  fe as buildIconSearchContext,
+  K as buildNumberInputContext,
+  be as buildPresentationGenerateContext,
+  _ as buildSelectContext,
+  xe as buildSlideDesignContext,
+  F as buildTextInputContext,
+  ce as buildValidationContext,
+  Fe as colorControlContext,
+  Ge as dateControlContext,
+  Be as numberControlContext,
+  re as parseJSONResponse,
+  ne as parseSSEStream,
+  Ye as selectControlContext,
+  je as textControlContext,
+  Je as useAI3DHint,
+  Me as useAIAudioHint,
+  Ae as useAICodeHint,
+  Re as useAIColorHint,
+  Y as useAIContext,
+  Le as useAIDateHint,
+  He as useAIDiagramLayout,
+  Ne as useAIFormFill,
+  Ee as useAIGraphicsHint,
+  Oe as useAIHtmlHint,
+  De as useAIIconSearch,
+  ze as useAINpcHint,
+  $e as useAINumberHint,
+  Ve as useAIPresentationGenerate,
+  Pe as useAISelectHint,
+  qe as useAISlideDesign,
+  Te as useAITextHint,
+  Ie as useAIValidation,
+  g as useNiceAIHint,
+  We as withAIHint
+};