ghostfill 0.1.2 → 0.2.0

package/README.md

@@ -28,7 +28,14 @@ import { useEffect } from "react";
 
 function GhostFill() {
   useEffect(() => {
-    import("ghostfill").then((m) => m.init());
+    import("ghostfill").then((m) =>
+      m.init({
+        ai: {
+          endpoint: "/api/ghostfill",
+          provider: "openai",
+        },
+      })
+    );
   }, []);
   return null;
 }
@@ -51,22 +58,94 @@ await fill({ container: document.querySelector("form") });
 2. Click it to enter selection mode — hover and click a form area
 3. Click the sparkles button to fill all detected fields
 4. By default, generates random sample data locally (no API needed)
-5. Optionally enable AI mode in settings for context-aware data generation
+5. Optionally enable AI mode in settings for context-aware data generation through your backend
+
+## Secure AI Setup
+
+GhostFill no longer accepts provider API keys in the browser. To use OpenAI, xAI, or Moonshot safely, expose a backend route and keep provider credentials server-side.
+
+Install a server-side SDK in your app:
+
+```bash
+npm install openai
+```
+
+Example Next.js route:
+
+```ts
+// app/api/ghostfill/route.ts
+import OpenAI from "openai";
+import {
+  buildFillMessages,
+  parseFillDataPayload,
+  type GhostFillAIRequest,
+  type Provider,
+} from "ghostfill/server";
+
+const clients: Record<Provider, OpenAI> = {
+  openai: new OpenAI({
+    apiKey: process.env.OPENAI_API_KEY,
+  }),
+  xai: new OpenAI({
+    apiKey: process.env.XAI_API_KEY,
+    baseURL: "https://api.x.ai/v1",
+  }),
+  moonshot: new OpenAI({
+    apiKey: process.env.MOONSHOT_API_KEY,
+    baseURL: "https://api.moonshot.cn/v1",
+  }),
+};
+
+const models: Record<Provider, string> = {
+  openai: process.env.GHOSTFILL_OPENAI_MODEL || "gpt-4o-mini",
+  xai: process.env.GHOSTFILL_XAI_MODEL || "grok-4-fast",
+  moonshot: process.env.GHOSTFILL_MOONSHOT_MODEL || "moonshot-v1-8k",
+};
+
+function isProvider(value: unknown): value is Provider {
+  return value === "openai" || value === "xai" || value === "moonshot";
+}
+
+export async function POST(req: Request) {
+  const body = (await req.json()) as Partial<GhostFillAIRequest>;
+
+  if (!isProvider(body.provider) || !Array.isArray(body.fields)) {
+    return Response.json({ error: "Invalid GhostFill request" }, { status: 400 });
+  }
+
+  const completion = await clients[body.provider].chat.completions.create({
+    model: models[body.provider],
+    messages: buildFillMessages({
+      provider: body.provider,
+      prompt: typeof body.prompt === "string" ? body.prompt : "",
+      systemPrompt:
+        typeof body.systemPrompt === "string" ? body.systemPrompt : undefined,
+      fields: body.fields,
+    }),
+  });
+
+  const content = completion.choices[0]?.message?.content || "";
+  return Response.json(parseFillDataPayload(content));
+}
+```
+
+This route supports all three providers, keeps secrets server-side, and only sends non-secret field metadata to the model. If you expose it outside local development, add your app's auth, rate limits, and request-size validation.
 
 ## Settings
 
 Click the gear icon to configure:
 
 - **Highlight Colour** — pick the selection overlay color
-- **Use AI** — toggle AI-powered fills (requires API key)
-- **Provider** — cycle between OpenAI (gpt-4o-mini), xAI (Grok 4 Fast), Moonshot (Kimi K2)
-- **API Key** — your provider API key
-- **Presets** — save prompt templates for domain-specific data (e.g. D365, healthcare)
+- **Use AI** — toggle AI-powered fills when a secure backend route is configured
+- **Provider** — cycle between OpenAI, xAI, and Moonshot
+- **Backend** — shows the secure route or handler being used for AI fills
+- **Presets** — save prompt templates for domain-specific data (e.g. D365, healthcare); keep them non-secret because they are stored locally
 - **Dark/Light theme** — toggle with the sun/moon icon
 
 ## Features
 
 - **Zero config** — works out of the box with random sample data
+- **Secure by default** — AI mode uses a backend route instead of browser-held provider keys
 - **Shadow DOM** — styles don't leak into your app
 - **Framework-aware** — uses native value setters so React/Vue/Angular pick up changes
 - **Smart detection** — labels from `<label>`, `aria-label`, placeholder, preceding siblings
@@ -84,9 +163,13 @@ Initialize GhostFill and add the UI to the page.
 
 ```ts
 init({
-  apiKey?: string,      // API key (can also set in UI)
-  shortcut?: string,    // Keyboard shortcut (default: "Alt+G")
-  systemPrompt?: string // Custom system prompt to prepend
+  ai?: {
+    endpoint?: string,         // Same-origin backend route (default: "/api/ghostfill")
+    requestFillData?: (request: GhostFillAIRequest) => Promise<FieldFillData[]>,
+    provider?: "openai" | "xai" | "moonshot"
+  },
+  shortcut?: string,           // Keyboard shortcut (default: "Alt+G")
+  systemPrompt?: string        // Custom system prompt to prepend
 })
 ```
 
@@ -99,7 +182,14 @@ Programmatic fill without the UI.
 ```ts
 await fill({
   container: HTMLElement,  // The element containing form fields
-  prompt?: string          // Optional prompt for AI mode
+  prompt?: string,         // Optional prompt for AI mode
+  ai?: {
+    endpoint?: string,
+    requestFillData?: (request: GhostFillAIRequest) => Promise<FieldFillData[]>,
+    provider?: "openai" | "xai" | "moonshot"
+  },
+  provider?: "openai" | "xai" | "moonshot",
+  systemPrompt?: string
 })
 ```
 

package/dist/chunk-VMCU3BNJ.mjs

@@ -0,0 +1,275 @@
+// src/types.ts
+var PROVIDERS = {
+  openai: { label: "OpenAI", model: "gpt-4o-mini", baseURL: "https://api.openai.com/v1", helpText: "Uses gpt-4o-mini \u2014 fast & cheap" },
+  xai: { label: "xAI", model: "grok-4-fast", baseURL: "https://api.x.ai/v1", helpText: "Uses Grok 4 Fast" },
+  moonshot: { label: "Moonshot", model: "kimi-k2", baseURL: "https://api.moonshot.ai/v1", helpText: "Uses Kimi K2 \u2014 fast & cheap" }
+};
+
+// src/detector.ts
+var INPUT_SELECTORS = [
+  "input:not([type=hidden]):not([type=submit]):not([type=button]):not([type=reset]):not([type=image])",
+  "textarea",
+  "select",
+  // Custom dropdown triggers (Headless UI Listbox, Radix, etc.)
+  "button[role=combobox]",
+  "[role=combobox]:not(input)",
+  "button[aria-haspopup=listbox]"
+].join(", ");
+function findLabel(el) {
+  if (el.id) {
+    const label = document.querySelector(
+      `label[for="${CSS.escape(el.id)}"]`
+    );
+    if (label?.textContent?.trim()) return label.textContent.trim();
+  }
+  const parentLabel = el.closest("label");
+  if (parentLabel) {
+    const clone = parentLabel.cloneNode(true);
+    clone.querySelectorAll("input, textarea, select").forEach((c) => c.remove());
+    const text = clone.textContent?.trim();
+    if (text) return text;
+  }
+  const ariaLabel = el.getAttribute("aria-label");
+  if (ariaLabel?.trim()) return ariaLabel.trim();
+  const labelledBy = el.getAttribute("aria-labelledby");
+  if (labelledBy) {
+    const parts = labelledBy.split(/\s+/).map((id) => document.getElementById(id)?.textContent?.trim()).filter(Boolean);
+    if (parts.length) return parts.join(" ");
+  }
+  if ("placeholder" in el) {
+    const ph = el.placeholder;
+    if (ph?.trim()) return ph.trim();
+  }
+  const title = el.getAttribute("title");
+  if (title?.trim()) return title.trim();
+  const prev = el.previousElementSibling;
+  if (prev && !["INPUT", "TEXTAREA", "SELECT"].includes(prev.tagName)) {
+    const prevText = prev.textContent?.trim();
+    if (prevText && prevText.length < 60) return prevText;
+  }
+  const parent = el.parentElement;
+  if (parent) {
+    for (const child of Array.from(parent.children)) {
+      if (child === el) break;
+      if (["LABEL", "SPAN", "P", "H1", "H2", "H3", "H4", "H5", "H6", "LEGEND", "DIV"].includes(child.tagName)) {
+        const text = child.textContent?.trim();
+        if (text && text.length < 60 && !child.querySelector("input, textarea, select")) {
+          return text;
+        }
+      }
+    }
+  }
+  if (el.id) return el.id.replace(/[_\-]/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").trim();
+  const name = el.getAttribute("name");
+  if (name) return name.replace(/[_\-[\]]/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").trim();
+  return "unknown";
+}
+function detectFields(container) {
+  const elements = container.querySelectorAll(INPUT_SELECTORS);
+  const fields = [];
+  elements.forEach((el) => {
+    if (el.disabled) return;
+    if (el.readOnly) return;
+    if (el.offsetParent === null && el.type !== "hidden") return;
+    const isCustomDropdown = el.getAttribute("role") === "combobox" && !(el instanceof HTMLInputElement) || el.getAttribute("aria-haspopup") === "listbox";
+    if (isCustomDropdown) {
+      const listboxId = el.getAttribute("aria-controls");
+      let listbox = listboxId ? document.getElementById(listboxId) : null;
+      if (!listbox) {
+        listbox = el.parentElement?.querySelector("[role=listbox]") || null;
+      }
+      const options = [];
+      if (listbox) {
+        listbox.querySelectorAll("[role=option]").forEach((opt) => {
+          const text = opt.textContent?.trim();
+          if (text) options.push(text);
+        });
+      }
+      const buttonText = el.textContent?.trim() || "";
+      const looksLikePlaceholder = buttonText.toLowerCase().startsWith("select") || buttonText === "";
+      const field2 = {
+        element: el,
+        type: "select",
+        name: el.id || el.getAttribute("name") || "",
+        label: findLabel(el),
+        required: el.getAttribute("aria-required") === "true",
+        currentValue: looksLikePlaceholder ? "" : buttonText,
+        options: options.length > 0 ? options : void 0
+      };
+      fields.push(field2);
+      return;
+    }
+    const field = {
+      element: el,
+      type: el instanceof HTMLSelectElement ? "select" : el.type || "text",
+      name: el.name || el.id || "",
+      label: findLabel(el),
+      required: el.required || el.getAttribute("aria-required") === "true",
+      currentValue: el.value
+    };
+    if (el instanceof HTMLSelectElement) {
+      field.options = Array.from(el.options).filter((opt) => opt.value && !opt.disabled).map((opt) => opt.textContent?.trim() || opt.value);
+    }
+    if ("min" in el && el.min) {
+      field.min = el.min;
+    }
+    if ("max" in el && el.max) {
+      field.max = el.max;
+    }
+    if ("pattern" in el && el.pattern) {
+      field.pattern = el.pattern;
+    }
+    fields.push(field);
+  });
+  return fields;
+}
+function describeFields(fields) {
+  return fields.map((f, i) => {
+    let desc = `[${i}] "${f.label}" (type: ${f.type}`;
+    if (f.required) desc += ", required";
+    if (f.options?.length) desc += `, options: [${f.options.join(", ")}]`;
+    if (f.min) desc += `, min: ${f.min}`;
+    if (f.max) desc += `, max: ${f.max}`;
+    if (f.pattern) desc += `, pattern: ${f.pattern}`;
+    desc += ")";
+    return desc;
+  }).join("\n");
+}
+
+// src/ai.ts
+var SYSTEM_PROMPT = `You are a form-filling assistant. Given a list of form fields and an optional user prompt, generate realistic fake data to fill ALL fields.
+
+Rules:
+- Return ONLY a JSON object with a "fields" array of objects, each with "index" and "value" keys
+- You MUST fill EVERY field \u2014 do not skip any
+- Match the field type (email \u2192 valid email, phone \u2192 valid phone with country code, date \u2192 YYYY-MM-DD, datetime-local \u2192 YYYY-MM-DDTHH:MM, etc.)
+- For select/dropdown fields: you MUST pick one of the listed options EXACTLY as written
+- For checkboxes: add a "checked" boolean (true or false)
+- For radio buttons: only fill one per group, use the option value
+- Respect min/max constraints and patterns
+- Generate contextually coherent data (same person's name, matching city/state/zip, etc.)
+- If no user prompt is given, infer appropriate data from the field labels
+- Do NOT request or rely on secrets, tokens, passwords, or existing form values
+- Do NOT wrap the JSON in markdown code blocks \u2014 return raw JSON only`;
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function toFieldFillData(value) {
+  if (!isRecord(value)) {
+    throw new Error("AI response item is not an object");
+  }
+  const index = value.index;
+  const rawValue = value.value;
+  const checked = value.checked;
+  if (typeof index !== "number" || !Number.isInteger(index)) {
+    throw new Error("AI response item is missing a numeric index");
+  }
+  if (typeof rawValue !== "string") {
+    throw new Error("AI response item is missing a string value");
+  }
+  return {
+    index,
+    value: rawValue,
+    checked: typeof checked === "boolean" ? checked : void 0
+  };
+}
+function toPromptFields(fields) {
+  return fields.map((field, index) => ({
+    index,
+    type: field.type,
+    name: field.name,
+    label: field.label,
+    options: field.options,
+    required: field.required,
+    min: field.min,
+    max: field.max,
+    pattern: field.pattern
+  }));
+}
+function buildFillMessages(request) {
+  const fieldDescription = describeFields(request.fields);
+  let userContent = `Form fields:
+${fieldDescription}`;
+  if (request.prompt) {
+    userContent += `
+
+User instructions: ${request.prompt}`;
+  } else {
+    userContent += "\n\nNo specific instructions \u2014 generate realistic, contextually appropriate data for all fields.";
+  }
+  return [
+    {
+      role: "system",
+      content: request.systemPrompt ? `${request.systemPrompt}
+
+${SYSTEM_PROMPT}` : SYSTEM_PROMPT
+    },
+    {
+      role: "user",
+      content: userContent
+    }
+  ];
+}
+function parseFillDataPayload(payload) {
+  if (typeof payload === "string") {
+    const jsonMatch = payload.match(/```(?:json)?\s*([\s\S]*?)```/) || [null, payload];
+    return parseFillDataPayload(JSON.parse(jsonMatch[1].trim()));
+  }
+  if (Array.isArray(payload)) {
+    return payload.map(toFieldFillData);
+  }
+  if (isRecord(payload)) {
+    if (Array.isArray(payload.choices)) {
+      const content = payload.choices[0]?.message;
+      if (typeof content?.content === "string") {
+        return parseFillDataPayload(content.content);
+      }
+    }
+    const candidate = payload.fields ?? payload.data ?? payload.items ?? payload.result;
+    if (Array.isArray(candidate)) {
+      return candidate.map(toFieldFillData);
+    }
+  }
+  throw new Error("AI response is not an array of field fills");
+}
+function createRequest(fields, userPrompt, provider, systemPrompt) {
+  return {
+    provider,
+    prompt: userPrompt,
+    systemPrompt,
+    fields: toPromptFields(fields)
+  };
+}
+async function generateFillData(fields, userPrompt, provider, transport, systemPrompt) {
+  const request = createRequest(fields, userPrompt, provider, systemPrompt);
+  if (transport.requestFillData) {
+    return transport.requestFillData(request);
+  }
+  const endpoint = transport.endpoint ?? "/api/ghostfill";
+  const response = await fetch(endpoint, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`AI API error (${response.status}): ${error}`);
+  }
+  const contentType = response.headers.get("content-type") || "";
+  const payload = contentType.includes("application/json") ? await response.json() : await response.text();
+  return parseFillDataPayload(payload);
+}
+
+export {
+  PROVIDERS,
+  detectFields,
+  describeFields,
+  SYSTEM_PROMPT,
+  toPromptFields,
+  buildFillMessages,
+  parseFillDataPayload,
+  generateFillData
+};
+//# sourceMappingURL=chunk-VMCU3BNJ.mjs.map

package/dist/chunk-VMCU3BNJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/detector.ts","../src/ai.ts"],"sourcesContent":["/** Configuration options for GhostFill */\nexport interface GhostFillOptions {\n  /**\n   * @deprecated Browser API keys are insecure and ignored.\n   * Configure `ai` and keep provider credentials on your backend instead.\n   */\n  apiKey?: string;\n  /** Keyboard shortcut to toggle GhostFill (default: \"Alt+G\") */\n  shortcut?: string;\n  /** Custom system prompt to prepend */\n  systemPrompt?: string;\n  /** Secure AI transport configuration */\n  ai?: GhostFillAIOptions;\n}\n\nexport type Provider = \"openai\" | \"xai\" | \"moonshot\";\n\nexport const PROVIDERS: Record<Provider, { label: string; model: string; baseURL: string; helpText: string }> = {\n  openai: { label: \"OpenAI\", model: \"gpt-4o-mini\", baseURL: \"https://api.openai.com/v1\", helpText: \"Uses gpt-4o-mini — fast & cheap\" },\n  xai: { label: \"xAI\", model: \"grok-4-fast\", baseURL: \"https://api.x.ai/v1\", helpText: \"Uses Grok 4 Fast\" },\n  moonshot: { label: \"Moonshot\", model: \"kimi-k2\", baseURL: \"https://api.moonshot.ai/v1\", helpText: \"Uses Kimi K2 — fast & cheap\" },\n};\n\n/** Non-secret field metadata sent to an AI backend */\nexport interface GhostFillPromptField {\n  index: number;\n  type: string;\n  name: string;\n  label: string;\n  options?: string[];\n  required: boolean;\n  min?: string;\n  max?: string;\n  pattern?: string;\n}\n\n/** Secure AI request payload for a backend route or callback */\nexport interface GhostFillAIRequest {\n  provider: Provider;\n  prompt: string;\n  systemPrompt?: string;\n  fields: GhostFillPromptField[];\n}\n\nexport type GhostFillAIHandler = (\n  request: GhostFillAIRequest\n) => Promise<FieldFillData[]>;\n\n/** Secure AI configuration. Requests must go through a backend or custom handler. */\nexport interface GhostFillAIOptions {\n  /** Same-origin backend route. Defaults to `/api/ghostfill` when `ai` is enabled. */\n  endpoint?: string;\n  /** Optional custom transport that forwards requests to a secure backend. */\n  requestFillData?: GhostFillAIHandler;\n  /** Default provider shown in the UI. */\n  provider?: Provider;\n}\n\n/** A saved prompt preset */\nexport interface Preset {\n  id: string;\n  name: string;\n  prompt: string;\n}\n\n/** Persisted settings (localStorage) */\nexport interface GhostFillSettings {\n  apiKey: string;\n  provider: Provider;\n  highlightColor: string;\n  theme: \"dark\" | \"light\";\n  useAI: boolean;\n  presets: Preset[];\n  activePresetId: string | null;\n}\n\n/** A detected form field */\nexport interface DetectedField {\n  /** The DOM element */\n  element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;\n  /** Field type: text, email, number, select, textarea, checkbox, radio, date, etc. */\n  type: string;\n  /** Field name attribute */\n  name: string;\n  /** Field label (from <label>, aria-label, or placeholder) */\n  label: string;\n  /** For <select>, the available options */\n  options?: string[];\n  /** Whether the field is required */\n  required: boolean;\n  /** Current value */\n  currentValue: string;\n  /** Min/max for number/date fields */\n  min?: string;\n  max?: string;\n  /** Pattern attribute */\n  pattern?: string;\n}\n\n/** Field data returned by the AI */\nexport interface FieldFillData {\n  /** Index matching the DetectedField array */\n  index: number;\n  /** Value to fill */\n  value: string;\n  /** For checkboxes: whether to check */\n  checked?: boolean;\n}\n\n/** Internal state */\nexport interface GhostFillState {\n  active: boolean;\n  selecting: boolean;\n  selectedBlock: HTMLElement | null;\n  fields: DetectedField[];\n  overlay: HTMLElement | null;\n  shadowRoot: ShadowRoot | null;\n}\n","import type { DetectedField, GhostFillPromptField } from \"./types\";\n\nconst INPUT_SELECTORS = [\n  \"input:not([type=hidden]):not([type=submit]):not([type=button]):not([type=reset]):not([type=image])\",\n  \"textarea\",\n  \"select\",\n  // Custom dropdown triggers (Headless UI Listbox, Radix, etc.)\n  \"button[role=combobox]\",\n  \"[role=combobox]:not(input)\",\n  \"button[aria-haspopup=listbox]\",\n].join(\", \");\n\n/** Find the label text for a form field */\nfunction findLabel(el: HTMLElement): string {\n  // 1. Explicit <label for=\"id\">\n  if (el.id) {\n    const label = document.querySelector<HTMLLabelElement>(\n      `label[for=\"${CSS.escape(el.id)}\"]`\n    );\n    if (label?.textContent?.trim()) return label.textContent.trim();\n  }\n\n  // 2. Wrapping <label>\n  const parentLabel = el.closest(\"label\");\n  if (parentLabel) {\n    // Get text content excluding the input itself\n    const clone = parentLabel.cloneNode(true) as HTMLElement;\n    clone.querySelectorAll(\"input, textarea, select\").forEach((c) => c.remove());\n    const text = clone.textContent?.trim();\n    if (text) return text;\n  }\n\n  // 3. aria-label\n  const ariaLabel = el.getAttribute(\"aria-label\");\n  if (ariaLabel?.trim()) return ariaLabel.trim();\n\n  // 4. aria-labelledby\n  const labelledBy = el.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const parts = labelledBy\n      .split(/\\s+/)\n      .map((id) => document.getElementById(id)?.textContent?.trim())\n      .filter(Boolean);\n    if (parts.length) return parts.join(\" \");\n  }\n\n  // 5. placeholder\n  if (\"placeholder\" in el) {\n    const ph = (el as HTMLInputElement).placeholder;\n    if (ph?.trim()) return ph.trim();\n  }\n\n  // 6. title\n  const title = el.getAttribute(\"title\");\n  if (title?.trim()) return title.trim();\n\n  // 7. Preceding sibling text (common pattern: <span>Label</span><input>)\n  const prev = el.previousElementSibling;\n  if (prev && ![\"INPUT\", \"TEXTAREA\", \"SELECT\"].includes(prev.tagName)) {\n    const prevText = prev.textContent?.trim();\n    if (prevText && prevText.length < 60) return prevText;\n  }\n\n  // 8. Parent's first text node or heading\n  const parent = el.parentElement;\n  if (parent) {\n    // Look for a heading or label-like element before this input in the parent\n    for (const child of Array.from(parent.children)) {\n      if (child === el) break;\n      if ([\"LABEL\", \"SPAN\", \"P\", \"H1\", \"H2\", \"H3\", \"H4\", \"H5\", \"H6\", \"LEGEND\", \"DIV\"].includes(child.tagName)) {\n        const text = child.textContent?.trim();\n        if (text && text.length < 60 && !child.querySelector(\"input, textarea, select\")) {\n          return text;\n        }\n      }\n    }\n  }\n\n  // 9. id attribute humanized\n  if (el.id) return el.id.replace(/[_\\-]/g, \" \").replace(/([a-z])([A-Z])/g, \"$1 $2\").trim();\n\n  // 10. name attribute as fallback\n  const name = el.getAttribute(\"name\");\n  if (name) return name.replace(/[_\\-[\\]]/g, \" \").replace(/([a-z])([A-Z])/g, \"$1 $2\").trim();\n\n  return \"unknown\";\n}\n\n/** Detect all fillable fields within a container element */\nexport function detectFields(container: HTMLElement): DetectedField[] {\n  const elements = container.querySelectorAll<\n    HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement\n  >(INPUT_SELECTORS);\n\n  const fields: DetectedField[] = [];\n\n  elements.forEach((el) => {\n    // Skip disabled fields\n    if ((el as HTMLInputElement).disabled) return;\n    if ((el as HTMLInputElement).readOnly) return;\n    // Skip hidden elements\n    if (el.offsetParent === null && (el as HTMLInputElement).type !== \"hidden\") return;\n\n    // Custom combobox / listbox (Headless UI, Radix, etc.)\n    const isCustomDropdown =\n      (el.getAttribute(\"role\") === \"combobox\" && !(el instanceof HTMLInputElement)) ||\n      el.getAttribute(\"aria-haspopup\") === \"listbox\";\n    if (isCustomDropdown) {\n      // Find listbox options: aria-controls, sibling [role=listbox], or Headless UI pattern\n      const listboxId = el.getAttribute(\"aria-controls\");\n      let listbox: Element | null = listboxId ? document.getElementById(listboxId) : null;\n      if (!listbox) {\n        // Headless UI puts the listbox as a sibling inside the same relative container\n        listbox = el.parentElement?.querySelector(\"[role=listbox]\") || null;\n      }\n\n      const options: string[] = [];\n      if (listbox) {\n        listbox.querySelectorAll(\"[role=option]\").forEach((opt) => {\n          const text = opt.textContent?.trim();\n          if (text) options.push(text);\n        });\n      }\n\n      // Get current display value from button text\n      const buttonText = el.textContent?.trim() || \"\";\n      // Check if it looks like a placeholder\n      const looksLikePlaceholder = buttonText.toLowerCase().startsWith(\"select\") || buttonText === \"\";\n\n      const field: DetectedField = {\n        element: el as any,\n        type: \"select\",\n        name: el.id || el.getAttribute(\"name\") || \"\",\n        label: findLabel(el),\n        required: el.getAttribute(\"aria-required\") === \"true\",\n        currentValue: looksLikePlaceholder ? \"\" : buttonText,\n        options: options.length > 0 ? options : undefined,\n      };\n      fields.push(field);\n      return;\n    }\n\n    const field: DetectedField = {\n      element: el as HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement,\n      type: el instanceof HTMLSelectElement ? \"select\" : (el as HTMLInputElement).type || \"text\",\n      name: (el as HTMLInputElement).name || el.id || \"\",\n      label: findLabel(el),\n      required: (el as HTMLInputElement).required || el.getAttribute(\"aria-required\") === \"true\",\n      currentValue: (el as HTMLInputElement).value,\n    };\n\n    // Collect select options\n    if (el instanceof HTMLSelectElement) {\n      field.options = Array.from(el.options)\n        .filter((opt) => opt.value && !opt.disabled)\n        .map((opt) => opt.textContent?.trim() || opt.value);\n    }\n\n    // Collect constraints\n    if (\"min\" in el && (el as HTMLInputElement).min) {\n      field.min = (el as HTMLInputElement).min;\n    }\n    if (\"max\" in el && (el as HTMLInputElement).max) {\n      field.max = (el as HTMLInputElement).max;\n    }\n    if (\"pattern\" in el && (el as HTMLInputElement).pattern) {\n      field.pattern = (el as HTMLInputElement).pattern;\n    }\n\n    fields.push(field);\n  });\n\n  return fields;\n}\n\n/** Build a description of fields for the AI prompt */\nexport function describeFields(\n  fields: Array<\n    Pick<\n      DetectedField | GhostFillPromptField,\n      \"type\" | \"label\" | \"required\" | \"options\" | \"min\" | \"max\" | \"pattern\"\n    >\n  >\n): string {\n  return fields\n    .map((f, i) => {\n      let desc = `[${i}] \"${f.label}\" (type: ${f.type}`;\n      if (f.required) desc += \", required\";\n      if (f.options?.length) desc += `, options: [${f.options.join(\", \")}]`;\n      if (f.min) desc += `, min: ${f.min}`;\n      if (f.max) desc += `, max: ${f.max}`;\n      if (f.pattern) desc += `, pattern: ${f.pattern}`;\n      desc += \")\";\n      return desc;\n    })\n    .join(\"\\n\");\n}\n","import { describeFields } from \"./detector\";\nimport type {\n  DetectedField,\n  FieldFillData,\n  GhostFillAIOptions,\n  GhostFillAIRequest,\n  GhostFillPromptField,\n  Provider,\n} from \"./types\";\n\nexport const SYSTEM_PROMPT = `You are a form-filling assistant. Given a list of form fields and an optional user prompt, generate realistic fake data to fill ALL fields.\n\nRules:\n- Return ONLY a JSON object with a \"fields\" array of objects, each with \"index\" and \"value\" keys\n- You MUST fill EVERY field — do not skip any\n- Match the field type (email → valid email, phone → valid phone with country code, date → YYYY-MM-DD, datetime-local → YYYY-MM-DDTHH:MM, etc.)\n- For select/dropdown fields: you MUST pick one of the listed options EXACTLY as written\n- For checkboxes: add a \"checked\" boolean (true or false)\n- For radio buttons: only fill one per group, use the option value\n- Respect min/max constraints and patterns\n- Generate contextually coherent data (same person's name, matching city/state/zip, etc.)\n- If no user prompt is given, infer appropriate data from the field labels\n- Do NOT request or rely on secrets, tokens, passwords, or existing form values\n- Do NOT wrap the JSON in markdown code blocks — return raw JSON only`;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction toFieldFillData(value: unknown): FieldFillData {\n  if (!isRecord(value)) {\n    throw new Error(\"AI response item is not an object\");\n  }\n\n  const index = value.index;\n  const rawValue = value.value;\n  const checked = value.checked;\n\n  if (typeof index !== \"number\" || !Number.isInteger(index)) {\n    throw new Error(\"AI response item is missing a numeric index\");\n  }\n\n  if (typeof rawValue !== \"string\") {\n    throw new Error(\"AI response item is missing a string value\");\n  }\n\n  return {\n    index,\n    value: rawValue,\n    checked: typeof checked === \"boolean\" ? checked : undefined,\n  };\n}\n\nexport function toPromptFields(fields: DetectedField[]): GhostFillPromptField[] {\n  return fields.map((field, index) => ({\n    index,\n    type: field.type,\n    name: field.name,\n    label: field.label,\n    options: field.options,\n    required: field.required,\n    min: field.min,\n    max: field.max,\n    pattern: field.pattern,\n  }));\n}\n\nexport function buildFillMessages(\n  request: GhostFillAIRequest\n): Array<{ role: \"system\" | \"user\"; content: string }> {\n  const fieldDescription = describeFields(request.fields);\n  let userContent = `Form fields:\\n${fieldDescription}`;\n\n  if (request.prompt) {\n    userContent += `\\n\\nUser instructions: ${request.prompt}`;\n  } else {\n    userContent +=\n      \"\\n\\nNo specific instructions — generate realistic, contextually appropriate data for all fields.\";\n  }\n\n  return [\n    {\n      role: \"system\",\n      content: request.systemPrompt\n        ? `${request.systemPrompt}\\n\\n${SYSTEM_PROMPT}`\n        : SYSTEM_PROMPT,\n    },\n    {\n      role: \"user\",\n      content: userContent,\n    },\n  ];\n}\n\nexport function parseFillDataPayload(payload: unknown): FieldFillData[] {\n  if (typeof payload === \"string\") {\n    const jsonMatch =\n      payload.match(/```(?:json)?\\s*([\\s\\S]*?)```/) || [null, payload];\n    return parseFillDataPayload(JSON.parse(jsonMatch[1]!.trim()));\n  }\n\n  if (Array.isArray(payload)) {\n    return payload.map(toFieldFillData);\n  }\n\n  if (isRecord(payload)) {\n    if (Array.isArray(payload.choices)) {\n      const content = (payload.choices[0] as Record<string, unknown> | undefined)\n        ?.message as Record<string, unknown> | undefined;\n      if (typeof content?.content === \"string\") {\n        return parseFillDataPayload(content.content);\n      }\n    }\n\n    const candidate =\n      payload.fields ?? payload.data ?? payload.items ?? payload.result;\n    if (Array.isArray(candidate)) {\n      return candidate.map(toFieldFillData);\n    }\n  }\n\n  throw new Error(\"AI response is not an array of field fills\");\n}\n\nfunction createRequest(\n  fields: DetectedField[],\n  userPrompt: string,\n  provider: Provider,\n  systemPrompt?: string\n): GhostFillAIRequest {\n  return {\n    provider,\n    prompt: userPrompt,\n    systemPrompt,\n    fields: toPromptFields(fields),\n  };\n}\n\n/** Call a secure backend or callback to generate fill data. */\nexport async function generateFillData(\n  fields: DetectedField[],\n  userPrompt: string,\n  provider: Provider,\n  transport: GhostFillAIOptions,\n  systemPrompt?: string\n): Promise<FieldFillData[]> {\n  const request = createRequest(fields, userPrompt, provider, systemPrompt);\n\n  if (transport.requestFillData) {\n    return transport.requestFillData(request);\n  }\n\n  const endpoint = transport.endpoint ?? \"/api/ghostfill\";\n  const response = await fetch(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify(request),\n  });\n\n  if (!response.ok) {\n    const error = await response.text();\n    throw new Error(`AI API error (${response.status}): ${error}`);\n  }\n\n  const contentType = response.headers.get(\"content-type\") || \"\";\n  const payload = contentType.includes(\"application/json\")\n    ? await response.json()\n    : await response.text();\n\n  return parseFillDataPayload(payload);\n}\n"],"mappings":"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","names":["field"]}

package/dist/index.d.mts

@@ -1,43 +1,5 @@
-/** Configuration options for GhostFill */
-interface GhostFillOptions {
-    /** API key (optional — can be set via settings UI) */
-    apiKey?: string;
-    /** Keyboard shortcut to toggle GhostFill (default: "Alt+G") */
-    shortcut?: string;
-    /** Custom system prompt to prepend */
-    systemPrompt?: string;
-}
-/** A detected form field */
-interface DetectedField {
-    /** The DOM element */
-    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
-    /** Field type: text, email, number, select, textarea, checkbox, radio, date, etc. */
-    type: string;
-    /** Field name attribute */
-    name: string;
-    /** Field label (from <label>, aria-label, or placeholder) */
-    label: string;
-    /** For <select>, the available options */
-    options?: string[];
-    /** Whether the field is required */
-    required: boolean;
-    /** Current value */
-    currentValue: string;
-    /** Min/max for number/date fields */
-    min?: string;
-    max?: string;
-    /** Pattern attribute */
-    pattern?: string;
-}
-/** Field data returned by the AI */
-interface FieldFillData {
-    /** Index matching the DetectedField array */
-    index: number;
-    /** Value to fill */
-    value: string;
-    /** For checkboxes: whether to check */
-    checked?: boolean;
-}
+import { G as GhostFillAIOptions, P as Provider, a as GhostFillOptions } from './types-B3DGbZyx.mjs';
+export { D as DetectedField, F as FieldFillData, b as GhostFillAIRequest, c as GhostFillPromptField, d as PROVIDERS } from './types-B3DGbZyx.mjs';
 
 /**
  * Initialize GhostFill — adds a floating ghost icon to the page.
@@ -57,9 +19,12 @@ declare function init(options?: GhostFillOptions): {
 declare function fill(params: {
     container: HTMLElement;
     prompt?: string;
+    ai?: GhostFillAIOptions;
+    provider?: Provider;
+    systemPrompt?: string;
 }): Promise<{
     filled: number;
     errors: string[];
 }>;
 
-export { type DetectedField, type FieldFillData, type GhostFillOptions, fill, init };
+export { GhostFillAIOptions, GhostFillOptions, Provider, fill, init };

package/dist/index.d.ts

@@ -1,43 +1,5 @@
-/** Configuration options for GhostFill */
-interface GhostFillOptions {
-    /** API key (optional — can be set via settings UI) */
-    apiKey?: string;
-    /** Keyboard shortcut to toggle GhostFill (default: "Alt+G") */
-    shortcut?: string;
-    /** Custom system prompt to prepend */
-    systemPrompt?: string;
-}
-/** A detected form field */
-interface DetectedField {
-    /** The DOM element */
-    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
-    /** Field type: text, email, number, select, textarea, checkbox, radio, date, etc. */
-    type: string;
-    /** Field name attribute */
-    name: string;
-    /** Field label (from <label>, aria-label, or placeholder) */
-    label: string;
-    /** For <select>, the available options */
-    options?: string[];
-    /** Whether the field is required */
-    required: boolean;
-    /** Current value */
-    currentValue: string;
-    /** Min/max for number/date fields */
-    min?: string;
-    max?: string;
-    /** Pattern attribute */
-    pattern?: string;
-}
-/** Field data returned by the AI */
-interface FieldFillData {
-    /** Index matching the DetectedField array */
-    index: number;
-    /** Value to fill */
-    value: string;
-    /** For checkboxes: whether to check */
-    checked?: boolean;
-}
+import { G as GhostFillAIOptions, P as Provider, a as GhostFillOptions } from './types-B3DGbZyx.js';
+export { D as DetectedField, F as FieldFillData, b as GhostFillAIRequest, c as GhostFillPromptField, d as PROVIDERS } from './types-B3DGbZyx.js';
 
 /**
  * Initialize GhostFill — adds a floating ghost icon to the page.
@@ -57,9 +19,12 @@ declare function init(options?: GhostFillOptions): {
 declare function fill(params: {
     container: HTMLElement;
     prompt?: string;
+    ai?: GhostFillAIOptions;
+    provider?: Provider;
+    systemPrompt?: string;
 }): Promise<{
     filled: number;
     errors: string[];
 }>;
 
-export { type DetectedField, type FieldFillData, type GhostFillOptions, fill, init };
+export { GhostFillAIOptions, GhostFillOptions, Provider, fill, init };