ghostfill 0.2.2

package/dist/types-B3DGbZyx.d.mts

@@ -0,0 +1,83 @@
+/** Configuration options for GhostFill */
+interface GhostFillOptions {
+    /**
+     * @deprecated Browser API keys are insecure and ignored.
+     * Configure `ai` and keep provider credentials on your backend instead.
+     */
+    apiKey?: string;
+    /** Keyboard shortcut to toggle GhostFill (default: "Alt+G") */
+    shortcut?: string;
+    /** Custom system prompt to prepend */
+    systemPrompt?: string;
+    /** Secure AI transport configuration */
+    ai?: GhostFillAIOptions;
+}
+type Provider = "openai" | "xai" | "moonshot";
+declare const PROVIDERS: Record<Provider, {
+    label: string;
+    model: string;
+    baseURL: string;
+    helpText: string;
+}>;
+/** Non-secret field metadata sent to an AI backend */
+interface GhostFillPromptField {
+    index: number;
+    type: string;
+    name: string;
+    label: string;
+    options?: string[];
+    required: boolean;
+    min?: string;
+    max?: string;
+    pattern?: string;
+}
+/** Secure AI request payload for a backend route or callback */
+interface GhostFillAIRequest {
+    provider: Provider;
+    prompt: string;
+    systemPrompt?: string;
+    fields: GhostFillPromptField[];
+}
+type GhostFillAIHandler = (request: GhostFillAIRequest) => Promise<FieldFillData[]>;
+/** Secure AI configuration. Requests must go through a backend or custom handler. */
+interface GhostFillAIOptions {
+    /** Same-origin backend route. Defaults to `/api/ghostfill` when `ai` is enabled. */
+    endpoint?: string;
+    /** Optional custom transport that forwards requests to a secure backend. */
+    requestFillData?: GhostFillAIHandler;
+    /** Default provider shown in the UI. */
+    provider?: Provider;
+}
+/** 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;
+}
+
+export { type DetectedField as D, type FieldFillData as F, type GhostFillAIOptions as G, type Provider as P, type GhostFillOptions as a, type GhostFillAIRequest as b, type GhostFillPromptField as c, PROVIDERS as d };

package/dist/types-B3DGbZyx.d.ts

@@ -0,0 +1,83 @@
+/** Configuration options for GhostFill */
+interface GhostFillOptions {
+    /**
+     * @deprecated Browser API keys are insecure and ignored.
+     * Configure `ai` and keep provider credentials on your backend instead.
+     */
+    apiKey?: string;
+    /** Keyboard shortcut to toggle GhostFill (default: "Alt+G") */
+    shortcut?: string;
+    /** Custom system prompt to prepend */
+    systemPrompt?: string;
+    /** Secure AI transport configuration */
+    ai?: GhostFillAIOptions;
+}
+type Provider = "openai" | "xai" | "moonshot";
+declare const PROVIDERS: Record<Provider, {
+    label: string;
+    model: string;
+    baseURL: string;
+    helpText: string;
+}>;
+/** Non-secret field metadata sent to an AI backend */
+interface GhostFillPromptField {
+    index: number;
+    type: string;
+    name: string;
+    label: string;
+    options?: string[];
+    required: boolean;
+    min?: string;
+    max?: string;
+    pattern?: string;
+}
+/** Secure AI request payload for a backend route or callback */
+interface GhostFillAIRequest {
+    provider: Provider;
+    prompt: string;
+    systemPrompt?: string;
+    fields: GhostFillPromptField[];
+}
+type GhostFillAIHandler = (request: GhostFillAIRequest) => Promise<FieldFillData[]>;
+/** Secure AI configuration. Requests must go through a backend or custom handler. */
+interface GhostFillAIOptions {
+    /** Same-origin backend route. Defaults to `/api/ghostfill` when `ai` is enabled. */
+    endpoint?: string;
+    /** Optional custom transport that forwards requests to a secure backend. */
+    requestFillData?: GhostFillAIHandler;
+    /** Default provider shown in the UI. */
+    provider?: Provider;
+}
+/** 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;
+}
+
+export { type DetectedField as D, type FieldFillData as F, type GhostFillAIOptions as G, type Provider as P, type GhostFillOptions as a, type GhostFillAIRequest as b, type GhostFillPromptField as c, PROVIDERS as d };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "ghostfill",
+  "version": "0.2.2",
+  "description": "Stop demoing with test123. Realistic, domain-aware form data in one click.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "demo": "npx serve demo"
+  },
+  "keywords": [
+    "form-filler",
+    "ai",
+    "openai",
+    "fake-data",
+    "testing",
+    "developer-tool"
+  ],
+  "author": "afkhalid",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/afkhalid/ghostfill.git"
+  },
+  "homepage": "https://github.com/afkhalid/ghostfill#readme",
+  "bugs": {
+    "url": "https://github.com/afkhalid/ghostfill/issues"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  }
+}