@llmnative/react 0.1.1 → 1.1.0

package/dist/types/src/providers/storage/StorageProvider.d.ts

@@ -1,7 +1,158 @@
 import type { ProviderConfigurable } from '../ProviderConfiguration';
+export interface UploadOptions {
+    /** Target bucket. Falls back to the provider's default bucket if omitted. */
+    bucket?: string;
+    /** MIME type hint (e.g. 'image/png'). Provider may infer it from the file when omitted. */
+    contentType?: string;
+    /** Called during upload with the completion percentage (0-100). */
+    onProgress?: (percent: number) => void;
+}
+export interface StorageOptions {
+    /** Target bucket. Falls back to the provider's default bucket if omitted. */
+    bucket?: string;
+}
+export interface DeleteOptions extends StorageOptions {
+    /**
+     * When true, deletes all files under the given path prefix (folder delete).
+     * Returns the total number of files deleted.
+     * Default: false - deletes a single file and returns 0 (not found) or 1 (deleted).
+     */
+    recursive?: boolean;
+}
+export interface MoveOptions extends StorageOptions {
+    /**
+     * Destination bucket. Falls back to the source bucket if omitted.
+     * Only relevant for cross-bucket moves.
+     */
+    destBucket?: string;
+    /**
+     * When true, treats `from` as a folder prefix and moves every file under it
+     * to the corresponding path under `to`. Returns the number of files moved.
+     * Default: false - moves a single file.
+     */
+    recursive?: boolean;
+}
+export interface ListOptions extends StorageOptions {
+    /** Traverse sub-folders and return files at any depth. Default: false (direct children only). */
+    recursive?: boolean;
+    /**
+     * Include file entries in the results.
+     * Default: true.
+     */
+    includeFiles?: boolean;
+    /**
+     * Include virtual folder/directory entries in the results.
+     * Default: false. When true, folder entries have isFolder: true.
+     */
+    includeFolders?: boolean;
+    /**
+     * Only return files whose extension matches.
+     * Case-insensitive. Pass a single string ('jpg') or an array (['jpg', 'png']).
+     * Has no effect on folder entries.
+     */
+    filterByExtension?: string | string[];
+    /**
+     * Maximum number of entries to return (applied after all other filters).
+     * Omit for no limit.
+     */
+    limit?: number;
+    /**
+     * When true, fetches size / contentType / updatedAt for each file.
+     * On Firebase this requires one extra network call per file (N+1).
+     * On Supabase metadata is always available at no extra cost.
+     * Default: false.
+     */
+    metadata?: boolean;
+}
+export interface StorageFileInfo {
+    /** Filename without the directory prefix. */
+    name: string;
+    /** Full path as stored in the provider (e.g. "images/avatar.png"). */
+    path: string;
+    size?: number;
+    contentType?: string;
+    updatedAt?: string;
+    /** Present and true when this entry represents a virtual folder (only when includeFolders: true). */
+    isFolder?: boolean;
+}
+/**
+ * Handle returned by createUpload - allows pause, resume and cancel mid-flight.
+ * pause() and resume() are no-ops on providers that do not support them (e.g. Supabase via fetch).
+ */
+export interface UploadHandle {
+    /** Resolves to the public download URL when the upload completes, or undefined on failure/cancel. */
+    readonly url: Promise<string | undefined>;
+    /** Pauses the upload. No-op if the provider does not support it. */
+    pause(): void;
+    /** Resumes a paused upload. No-op if the provider does not support it. */
+    resume(): void;
+    /** Cancels the upload. Always supported. */
+    cancel(): void;
+}
+/**
+ * Common storage interface (Ports & Adapters).
+ * Concrete implementations: FirebaseStorageProvider, SupabaseStorageProvider.
+ *
+ * All methods accept an optional `opts.bucket` to target a specific bucket
+ * instead of the provider's configured default.
+ */
 export interface StorageProviderAdapter extends ProviderConfigurable {
-    upload(file: string, path: string): Promise<string | undefined>;
-    getURL(path: string): Promise<string | undefined>;
-    download(path: string): Promise<Blob | undefined>;
-    delete(path: string): Promise<boolean>;
+    /**
+     * Upload a file and return its public download URL.
+     * Accepts a data URL string, a File, or a Blob.
+     * Fire-and-forget: no pause/resume. Use createUpload() for controllable uploads.
+     */
+    upload(file: string | File | Blob, path: string, opts?: UploadOptions): Promise<string | undefined>;
+    /**
+     * Start a controllable upload and return a handle with pause / resume / cancel.
+     * pause() and resume() are no-ops on Supabase (only Firebase supports them natively).
+     */
+    createUpload(file: string | File | Blob, path: string, opts?: UploadOptions): UploadHandle;
+    /**
+     * Rename a file or folder in place (same parent directory, new name).
+     * For folder rename, set opts.recursive = true.
+     * Semantically equivalent to move() - use rename() when only the name changes,
+     * move() when relocating across directories or buckets.
+     * Returns true if at least one file was successfully renamed.
+     */
+    rename(from: string, to: string, opts?: MoveOptions): Promise<boolean>;
+    /**
+     * Move a file or folder to a different path, directory, or bucket.
+     * For folder move, set opts.recursive = true.
+     * Use opts.destBucket to move across buckets.
+     * Returns the number of files successfully moved (0 on failure, 1 for single file).
+     */
+    move(from: string, to: string, opts?: MoveOptions): Promise<number>;
+    /** Return the public download URL for a stored file. */
+    getURL(path: string, opts?: StorageOptions): Promise<string | undefined>;
+    /**
+     * Return metadata for a single file.
+     * Returns undefined if the file does not exist.
+     */
+    getFileInfo(path: string, opts?: StorageOptions): Promise<StorageFileInfo | undefined>;
+    /** Download a file as a Blob. */
+    download(path: string, opts?: StorageOptions): Promise<Blob | undefined>;
+    /**
+     * Delete a file or all files under a folder prefix.
+     * Returns the number of files deleted:
+     *   - Single file (default): 0 if not found, 1 if deleted.
+     *   - Folder (opts.recursive = true): total files deleted.
+     */
+    delete(path: string, opts?: DeleteOptions): Promise<number>;
+    /**
+     * List files (and optionally folders) under a path prefix.
+     *
+     * Key options:
+     *   recursive       - traverse sub-folders (default: false, direct children only)
+     *   includeFiles    - include file entries (default: true)
+     *   includeFolders  - include folder entries with isFolder: true (default: false)
+     *   filterByExtension - case-insensitive extension filter: 'jpg' or ['jpg','png']
+     *   limit           - cap the number of results after all other filters
+     *   metadata        - fetch size/contentType/updatedAt (N+1 cost on Firebase)
+     */
+    list(path: string, opts?: ListOptions): Promise<StorageFileInfo[]>;
 }
+/** Returns true if `filename` matches any of the allowed extensions. Case-insensitive. */
+export declare function matchesExtension(filename: string, filter: string | string[]): boolean;
+/** Apply limit and extension filter to a list of StorageFileInfo entries. */
+export declare function applyListFilters(items: StorageFileInfo[], opts: ListOptions): StorageFileInfo[];

package/dist/types/src/providers/storage/dropbox.d.ts

@@ -10,7 +10,7 @@ type PathEntry = {
 };
 type ThumbnailEntry = {
     path: string;
-    [key: string]: any;
+    [key: string]: unknown;
 };
 type ThumbnailRequestOptions = {
     thumbnailsRequest: ThumbnailEntry[];
@@ -25,7 +25,7 @@ type ThumbnailResult = {
         mimetype: string;
         width: number;
         height: number;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 };
 export declare const resolvePath: (path: string, includeHost?: boolean) => string;
@@ -36,7 +36,7 @@ export declare const dropBox: {
     setRootPath: (path: string) => void;
     resolvePath: (path: string, includeHost?: boolean) => string;
     createFolders: (paths: string[], basePath?: string) => Promise<any>;
-    deleteBulk: (paths: string[], basePath?: string) => Promise<any>;
+    deleteBulk: (paths: string[], basePath?: string) => Promise<unknown[] | undefined>;
     addTags: (paths: Record<string, string[]>, basePath?: string) => Promise<void>;
     listFolders: ({ path, recursive }?: ListFoldersParams) => Promise<any[]>;
     getThumbnails: ({ thumbnailsRequest, size, format, mode, }: ThumbnailRequestOptions, setThumbnails?: (thumbs: ThumbnailResult) => void) => Promise<ThumbnailResult>;

package/dist/types/src/providers/storage/firebase.d.ts

@@ -1,13 +1,50 @@
-import "firebase/compat/storage";
-import { StorageProviderAdapter } from "./StorageProvider";
-import type { ProviderConfigurationState } from "../ProviderConfiguration";
+import type { StorageProviderAdapter, UploadOptions, StorageOptions, DeleteOptions, MoveOptions, ListOptions, StorageFileInfo, UploadHandle } from './StorageProvider';
+import type { ProviderConfigurationState } from '../ProviderConfiguration';
+export interface FirebaseStorageProviderConfig {
+    /** Used when a call doesn't pass its own `opts.bucket` — omit for the project's default bucket. */
+    defaultBucket?: string;
+}
 export declare class FirebaseStorageProvider implements StorageProviderAdapter {
+    private static listenerRegistered;
+    private defaultBucket?;
+    constructor(config?: FirebaseStorageProviderConfig);
+    private resolveBucket;
     getConfigurationState(): ProviderConfigurationState;
     isConfigured(): boolean;
-    upload: (file: string, path: string) => Promise<string | undefined>;
-    getURL: (path: string) => Promise<string | undefined>;
-    download: (path: string) => Promise<Blob | undefined>;
-    delete: (path: string) => Promise<boolean>;
+    upload: (file: string | File | Blob, path: string, opts?: UploadOptions) => Promise<string | undefined>;
+    createUpload: (file: string | File | Blob, path: string, opts?: UploadOptions) => UploadHandle;
+    /**
+     * Rename a file or folder. Semantically: change the name in place.
+     * Internally identical to move() - Firebase has no native rename/move API.
+     */
+    rename: (from: string, to: string, opts?: MoveOptions) => Promise<boolean>;
+    /**
+     * Move a file or folder (download → upload to new path → delete old).
+     * Firebase has no native move/rename API.
+     * For folder moves, set opts.recursive = true.
+     * Returns the number of files successfully moved.
+     */
+    move: (from: string, to: string, opts?: MoveOptions) => Promise<number>;
+    private _moveFile;
+    getURL: (path: string, opts?: StorageOptions) => Promise<string | undefined>;
+    getFileInfo: (path: string, opts?: StorageOptions) => Promise<StorageFileInfo | undefined>;
+    download: (path: string, opts?: StorageOptions) => Promise<Blob | undefined>;
+    /**
+     * Delete a single file or all files under a folder prefix.
+     * Returns the number of files deleted (0 or 1 for single file, N for recursive).
+     */
+    delete: (path: string, opts?: DeleteOptions) => Promise<number>;
+    private _deleteFolder;
+    /**
+     * List files (and optionally folders) under a path prefix.
+     *
+     * Firebase note: the SDK's listAll() means "list all pages without pagination" -
+     * it is NOT recursive. Recursion over sub-folders is performed manually here.
+     *
+     * opts.metadata = true fetches size/contentType/updatedAt (one extra call per file).
+     */
+    list: (path: string, opts?: ListOptions) => Promise<StorageFileInfo[]>;
+    private _listLevel;
 }
 declare const _default: FirebaseStorageProvider;
 export default _default;

package/dist/types/src/providers/storage/supabase.d.ts

@@ -1,19 +1,59 @@
-import { StorageProviderAdapter } from "./StorageProvider";
-import { type ProviderConfigurationState } from "../ProviderConfiguration";
+import type { StorageProviderAdapter, UploadOptions, StorageOptions, DeleteOptions, MoveOptions, ListOptions, StorageFileInfo, UploadHandle } from './StorageProvider';
+import { type ProviderConfigurationState } from '../ProviderConfiguration';
 interface SupabaseStorageConfig {
     url: string;
     anonKey: string;
+    /** Default bucket name. Falls back to "public" if omitted. */
     bucket?: string;
+    /**
+     * Tenant-session JWT signed by the control-plane, scoped to this project.
+     * When present, requests authenticate as this session instead of the bare
+     * anon key — needed for RLS-protected buckets. `apikey` stays the anon key
+     * regardless (Supabase always requires it alongside the bearer token).
+     */
+    accessToken?: string;
 }
 export declare class SupabaseStorageProvider implements StorageProviderAdapter {
     private config;
     constructor(config: SupabaseStorageConfig);
     getConfigurationState(): ProviderConfigurationState;
     isConfigured(): boolean;
-    private get bucket();
-    upload: (file: string, path: string) => Promise<string | undefined>;
-    getURL: (path: string) => Promise<string | undefined>;
-    download: (path: string) => Promise<Blob | undefined>;
-    delete: (path: string) => Promise<boolean>;
+    private resolveBucket;
+    private authHeaders;
+    upload: (file: string | File | Blob, path: string, opts?: UploadOptions) => Promise<string | undefined>;
+    /**
+     * Supabase upload with cancel support via AbortController.
+     * pause() and resume() are no-ops - Supabase fetch has no native pause/resume.
+     */
+    createUpload: (file: string | File | Blob, path: string, opts?: UploadOptions) => UploadHandle;
+    /**
+     * Rename a file or folder. Internally calls move().
+     * For Supabase, single-file rename uses the native move API (one round-trip).
+     */
+    rename: (from: string, to: string, opts?: MoveOptions) => Promise<boolean>;
+    /**
+     * Move a file or folder.
+     * Single file: uses Supabase's native move API (one round-trip).
+     * Folder (opts.recursive = true): lists all files then moves each via native API.
+     * Returns the number of files successfully moved.
+     */
+    move: (from: string, to: string, opts?: MoveOptions) => Promise<number>;
+    private _moveFile;
+    getURL: (path: string, opts?: StorageOptions) => Promise<string | undefined>;
+    getFileInfo: (path: string, opts?: StorageOptions) => Promise<StorageFileInfo | undefined>;
+    download: (path: string, opts?: StorageOptions) => Promise<Blob | undefined>;
+    /**
+     * Delete a single file or all files under a folder prefix.
+     * Uses Supabase's bulk-delete API - single request even for N files.
+     * Returns the number of files deleted.
+     */
+    delete: (path: string, opts?: DeleteOptions) => Promise<number>;
+    /**
+     * List files (and optionally folders) under a path prefix.
+     * Supabase always returns metadata in the same response (no N+1 cost).
+     * Folder entries have id === null in the Supabase response.
+     */
+    list: (path: string, opts?: ListOptions) => Promise<StorageFileInfo[]>;
+    private _listLevel;
 }
 export {};

package/dist/types/src/providers/supabase-init.d.ts

@@ -0,0 +1,35 @@
+import { type SupabaseClient } from '@supabase/supabase-js';
+import { type ProviderConfigurationState } from './ProviderConfiguration';
+/**
+ * Returns a shared SupabaseClient for the given project.
+ * One client per URL - subsequent calls with the same URL return the same instance.
+ * For single-project apps only. Multi-tenant session switching must use
+ * createSupabaseClient() instead — see below.
+ */
+export declare function getSupabaseClient(url: string, anonKey: string): SupabaseClient;
+/**
+ * Creates a fresh, uncached SupabaseClient scoped to one tenant session.
+ *
+ * Unlike getSupabaseClient(), this never persists a session (Supabase's default
+ * client persists to localStorage) and is never reused across calls — each tenant
+ * switch must produce a brand new instance with the freshly-resolved credential,
+ * never a stale one left over from a previous project.
+ *
+ * Supabase has no "sign in with custom token" step equivalent to Firebase: the
+ * control-plane mints a JWT signed with the tenant project's own JWT secret, and
+ * that JWT is simply attached as the Authorization header on every request —
+ * PostgREST/Realtime verify it directly, no separate session exchange call.
+ */
+export declare function createSupabaseClient(url: string, anonKey: string, accessToken?: string): SupabaseClient;
+/**
+ * Tears down a scoped client before it's discarded: force-closes any realtime
+ * channels a caller may have failed to unsubscribe from. Safety net, not a
+ * replacement for callers unsubscribing their own subscribe() calls.
+ */
+export declare function disposeSupabaseClient(client: SupabaseClient): Promise<void>;
+export declare function getSupabaseConfigurationState(config: {
+    url?: string;
+    anonKey?: string;
+} | undefined): ProviderConfigurationState;
+/** Clears all cached clients - useful for tests. */
+export declare function _resetSupabaseClients(): void;

package/dist/types/src/types/FormFields.d.ts

@@ -1,9 +1,10 @@
 import { FieldFactory } from "../components/Component";
 import { InputProps, TextAreaProps, CheckboxProps } from "../components/ui/fields/Input";
 import { SelectProps } from "../components/ui/fields/Select";
-import { ImageUrlProps } from "../components/ui/fields/ImageUrl";
+import { ImageFieldProps } from "../components/ui/fields/ImageField";
 import { UploadDocumentProps, UploadImageProps } from "../components/ui/fields/Upload";
 import { PromptProps } from "../components/widgets/Prompt";
+import { CodeEditorProps } from "../components/ui/fields/CodeEditor";
 export interface ComponentFormFieldsMap {
     string: FieldFactory<Partial<InputProps>>;
     number: FieldFactory<Partial<InputProps>>;
@@ -24,10 +25,11 @@ export interface ComponentFormFieldsMap {
     uploadImage: FieldFactory<Partial<UploadImageProps>>;
     uploadDocument: FieldFactory<Partial<UploadDocumentProps>>;
     prompt: FieldFactory<Partial<PromptProps>>;
-    imageUrl: FieldFactory<Partial<ImageUrlProps>>;
+    imageField: FieldFactory<Partial<ImageFieldProps>>;
     menu: FieldFactory<{
         defaultValue?: string;
     }>;
+    codeEditor: FieldFactory<Partial<CodeEditorProps>>;
 }
 declare const componentFormFields: ComponentFormFieldsMap;
 export default componentFormFields;

package/dist/types/src/types/FormSchema.d.ts

@@ -0,0 +1,29 @@
+import { FieldFactory } from "../components/Component";
+import { InputProps, TextAreaProps, CheckboxProps } from "../components/ui/fields/Input";
+import { SelectProps, AutocompleteProps, ChecklistProps } from "../components/ui/fields/Select";
+import { UploadImageProps, UploadDocumentProps } from "../components/ui/fields/Upload";
+import { ImageFieldProps } from "../components/ui/fields/ImageField";
+type SchemaFields = Record<string, ReturnType<FieldFactory>>;
+export interface ComponentFormSchemaMap {
+    string: (overrides?: Partial<InputProps>) => SchemaFields;
+    number: (overrides?: Partial<InputProps>) => SchemaFields;
+    email: (overrides?: Partial<InputProps>) => SchemaFields;
+    password: (overrides?: Partial<InputProps>) => SchemaFields;
+    color: (overrides?: Partial<InputProps>) => SchemaFields;
+    date: (overrides?: Partial<InputProps>) => SchemaFields;
+    time: (overrides?: Partial<InputProps>) => SchemaFields;
+    datetime: (overrides?: Partial<InputProps>) => SchemaFields;
+    week: (overrides?: Partial<InputProps>) => SchemaFields;
+    month: (overrides?: Partial<InputProps>) => SchemaFields;
+    textarea: (overrides?: Partial<TextAreaProps>) => SchemaFields;
+    checkbox: (overrides?: Partial<CheckboxProps>) => SchemaFields;
+    switch: (overrides?: Partial<CheckboxProps>) => SchemaFields;
+    select: (overrides?: Partial<SelectProps>) => SchemaFields;
+    autocomplete: (overrides?: Partial<AutocompleteProps>) => SchemaFields;
+    checklist: (overrides?: Partial<ChecklistProps>) => SchemaFields;
+    uploadImage: (overrides?: Partial<UploadImageProps>) => SchemaFields;
+    uploadDocument: (overrides?: Partial<UploadDocumentProps>) => SchemaFields;
+    imageField: (overrides?: Partial<ImageFieldProps>) => SchemaFields;
+}
+declare const componentFormSchema: ComponentFormSchemaMap;
+export default componentFormSchema;

package/dist/types/themes/tokyo-night-light.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeDefinition } from '../src/Theme';
+declare const definition: ThemeDefinition;
+export default definition;

package/dist/types/themes/tokyo-night.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeDefinition } from '../src/Theme';
+declare const definition: ThemeDefinition;
+export default definition;

package/dist/types/themes/vscode-dark-plus.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeDefinition } from '../src/Theme';
+declare const definition: ThemeDefinition;
+export default definition;

package/dist/types/themes/vscode-light-plus.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeDefinition } from '../src/Theme';
+declare const definition: ThemeDefinition;
+export default definition;

package/dist/vite.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u="x-llmnative-proxy",p="/api/proxy",h=async t=>{const e=[];for await(const r of t)e.push(Buffer.isBuffer(r)?r:Buffer.from(r));return e.length===0?void 0:Buffer.concat(e)},l=async(t,e,r)=>{const a=new URL(t.url||"/","http://localhost").searchParams.get("url");if(t.headers[u]!=="1"){e.statusCode=403,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify({error:"Proxy access denied."}));return}if(!a){e.statusCode=400,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify({error:'Missing "url" query parameter.'}));return}try{const o=new URL(a);if(o.pathname.startsWith(r)&&["localhost","127.0.0.1"].includes(o.hostname)){e.statusCode=508,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify({error:"Recursive proxy target detected.",target:a}));return}const d=await h(t),f=new Headers,y=new Set([u,"host","origin","referer","content-length","transfer-encoding","connection"]);Object.entries(t.headers).forEach(([i,n])=>{!n||y.has(i.toLowerCase())||f.set(i,Array.isArray(n)?n.join(", "):n)});const c=await fetch(a,{method:t.method||"GET",headers:f,body:d&&!["GET","HEAD"].includes((t.method||"GET").toUpperCase())?d:void 0,redirect:"follow"});e.statusCode=c.status,c.headers.forEach((i,n)=>{n.toLowerCase()!=="content-encoding"&&e.setHeader(n,i)}),e.end(Buffer.from(await c.arrayBuffer()))}catch(o){e.statusCode=502,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify({error:o instanceof Error?o.message:"Proxy request failed."}))}},g=(t=p)=>({name:"llmnative-dev-proxy",configureServer(e){e.middlewares.use(t,(r,s)=>{l(r,s,t)})},configurePreviewServer(e){e.middlewares.use(t,(r,s)=>{l(r,s,t)})}});exports.PROXY_PATH=p;exports.createProxyPlugin=g;

package/dist/vite.mjs

@@ -0,0 +1,54 @@
+const u = "x-llmnative-proxy", l = "/api/proxy", y = async (t) => {
+  const e = [];
+  for await (const r of t)
+    e.push(Buffer.isBuffer(r) ? r : Buffer.from(r));
+  return e.length === 0 ? void 0 : Buffer.concat(e);
+}, p = async (t, e, r) => {
+  const a = new URL(t.url || "/", "http://localhost").searchParams.get("url");
+  if (t.headers[u] !== "1") {
+    e.statusCode = 403, e.setHeader("Content-Type", "application/json"), e.end(JSON.stringify({ error: "Proxy access denied." }));
+    return;
+  }
+  if (!a) {
+    e.statusCode = 400, e.setHeader("Content-Type", "application/json"), e.end(JSON.stringify({ error: 'Missing "url" query parameter.' }));
+    return;
+  }
+  try {
+    const o = new URL(a);
+    if (o.pathname.startsWith(r) && ["localhost", "127.0.0.1"].includes(o.hostname)) {
+      e.statusCode = 508, e.setHeader("Content-Type", "application/json"), e.end(JSON.stringify({ error: "Recursive proxy target detected.", target: a }));
+      return;
+    }
+    const d = await y(t), f = new Headers(), h = /* @__PURE__ */ new Set([u, "host", "origin", "referer", "content-length", "transfer-encoding", "connection"]);
+    Object.entries(t.headers).forEach(([i, n]) => {
+      !n || h.has(i.toLowerCase()) || f.set(i, Array.isArray(n) ? n.join(", ") : n);
+    });
+    const c = await fetch(a, {
+      method: t.method || "GET",
+      headers: f,
+      body: d && !["GET", "HEAD"].includes((t.method || "GET").toUpperCase()) ? d : void 0,
+      redirect: "follow"
+    });
+    e.statusCode = c.status, c.headers.forEach((i, n) => {
+      n.toLowerCase() !== "content-encoding" && e.setHeader(n, i);
+    }), e.end(Buffer.from(await c.arrayBuffer()));
+  } catch (o) {
+    e.statusCode = 502, e.setHeader("Content-Type", "application/json"), e.end(JSON.stringify({ error: o instanceof Error ? o.message : "Proxy request failed." }));
+  }
+}, g = (t = l) => ({
+  name: "llmnative-dev-proxy",
+  configureServer(e) {
+    e.middlewares.use(t, (r, s) => {
+      p(r, s, t);
+    });
+  },
+  configurePreviewServer(e) {
+    e.middlewares.use(t, (r, s) => {
+      p(r, s, t);
+    });
+  }
+});
+export {
+  l as PROXY_PATH,
+  g as createProxyPlugin
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "0.1.1",
+  "version": "1.1.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -12,17 +12,23 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
+    "./vite": "./dist/vite.mjs",
     "./dist/index.css": "./dist/index.css"
   },
   "scripts": {
     "prebuild": "node scripts/dev/build-local.js --restore-only",
-    "build": "vite build && tsc --emitDeclarationOnly",
-    "build:dev": "vite build --mode development && tsc --emitDeclarationOnly",
+    "themes:compile:vscode": "node scripts/themes/compile-vscode-themes.js",
+    "build": "npm run themes:compile:vscode && vite build && tsc --emitDeclarationOnly",
+    "build:dev": "npm run themes:compile:vscode && vite build --mode development && tsc --emitDeclarationOnly",
     "watch:dev": "vite build --watch",
     "build:local": "node scripts/dev/build-local.js",
     "prepublishOnly": "npm run build",
     "updateReadme": "node scripts/dev/updateReadme.js",
     "test": "vitest run",
+    "test:e2e": "npx playwright test",
+    "test:e2e:proxy-scaffold": "node scripts/e2e/test-proxy-scaffold.js",
+    "test:e2e:proxy-runtime": "vitest run tests/e2e/proxy-runtime.test.ts --environment node",
+    "test:integration": "npx firebase emulators:exec --only database,firestore,storage --project demo-test \"npx vitest run --config vitest.integration.config.mts\"",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage"
   },
@@ -65,11 +71,12 @@
   "homepage": "https://github.com/sherpadvisorylab/llmnative-react#readme",
   "peerDependencies": {
     "@phosphor-icons/react": "^2.0.0",
+    "@supabase/supabase-js": "^2.107.0",
     "firebase": "^10.14.0",
     "lucide-react": "^0.400.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "react-router-dom": "^6.22.0"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^6.30.0"
   },
   "peerDependenciesMeta": {
     "@phosphor-icons/react": {
@@ -86,8 +93,12 @@
     "@babel/preset-env": "^7.25.7",
     "@babel/preset-react": "^7.25.7",
     "@babel/preset-typescript": "^7.25.7",
+    "@firebase/rules-unit-testing": "^5.0.1",
     "@phosphor-icons/react": "^2.1.10",
+    "@playwright/test": "^1.61.1",
+    "@supabase/supabase-js": "^2.107.0",
     "@tailwindcss/postcss": "^4.2.4",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
@@ -97,6 +108,7 @@
     "@types/react-dom": "^18.2.0",
     "@vitest/coverage-v8": "2.1",
     "autoprefixer": "^10.5.0",
+    "firebase": "^12.0.0",
     "googleapis": "^171.4.0",
     "happy-dom": "^20.9.0",
     "jsdom": "^29.1.1",
@@ -108,13 +120,36 @@
     "tailwindcss": "^4.2.4",
     "typescript": "^5.6.2",
     "vite": "^5.4.21",
-    "vitest": "2.1"
+    "vitest": "2.1",
+    "ws": "^8.21.0"
   },
   "dependencies": {
+    "@codemirror/autocomplete": "^6.20.3",
+    "@codemirror/commands": "^6.10.3",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-liquid": "^6.3.2",
+    "@codemirror/language": "^6.12.3",
+    "@codemirror/lint": "^6.9.7",
+    "@codemirror/search": "^6.7.1",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.43.1",
+    "@tiptap/extension-character-count": "^3.26.1",
+    "@tiptap/extension-image": "^3.26.1",
+    "@tiptap/extension-link": "^3.26.1",
+    "@tiptap/extension-placeholder": "^3.26.1",
+    "@tiptap/extension-table": "^3.26.1",
+    "@tiptap/extension-underline": "^3.26.1",
+    "@tiptap/react": "^3.26.1",
+    "@tiptap/starter-kit": "^3.26.1",
     "buffer": "^6.0.3",
     "clsx": "^2.1.1",
+    "codemirror": "^6.0.2",
+    "liquidjs": "^10.27.0",
     "papaparse": "^5.5.3",
-    "prismjs": "^ 1.30.0",
+    "prismjs": "^1.30.0",
     "react-markdown": "^10.1.0",
     "rehype-autolink-headings": "^7.1.0",
     "rehype-sanitize": "^6.0.0",
@@ -122,5 +157,8 @@
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.5.0",
     "tui-image-editor": "^3.15.3"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/scripts/cli/proxy-templates/cloudflare.ts

@@ -0,0 +1,34 @@
+/**
+ * LLMNative proxy - Cloudflare Worker.
+ *
+ * Deploy as a Worker or use as a Pages Function at:
+ *   functions/api/proxy.ts
+ */
+export default {
+    async fetch(request: Request): Promise<Response> {
+        const { searchParams } = new URL(request.url);
+        const targetUrl = searchParams.get('url');
+
+        if (!targetUrl) {
+            return Response.json({ error: 'Missing url query parameter' }, { status: 400 });
+        }
+
+        const headers = new Headers(request.headers);
+        headers.delete('host');
+        headers.delete('x-llmnative-proxy');
+
+        const hasBody = !['GET', 'HEAD'].includes(request.method.toUpperCase());
+
+        const upstream = await fetch(targetUrl, {
+            method: request.method,
+            headers,
+            body: hasBody ? request.body : undefined,
+            ...(hasBody ? { duplex: 'half' } : {}),
+        } as RequestInit);
+
+        return new Response(upstream.body, {
+            status: upstream.status,
+            headers: upstream.headers,
+        });
+    },
+};