duet-kit 0.1.0

package/dist/schema.js

@@ -0,0 +1,122 @@
+/**
+ * duet-kit - Schema
+ *
+ * Thin wrapper around Zod that adds metadata for UI labels and LLM context.
+ */
+import { z } from 'zod';
+// Schema container with metadata
+export class DuetSchema {
+    constructor(name, fields) {
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: name
+        });
+        Object.defineProperty(this, "fields", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: fields
+        });
+    }
+    // Get default values for all fields
+    getDefaults() {
+        const defaults = {};
+        for (const [key, field] of Object.entries(this.fields)) {
+            defaults[key] = field.default;
+        }
+        return defaults;
+    }
+    // Validate a single field
+    validate(field, value) {
+        return this.fields[field].schema.safeParse(value);
+    }
+    // Validate all fields
+    validateAll(data) {
+        const errors = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (key in this.fields) {
+                const result = this.fields[key].schema.safeParse(value);
+                if (!result.success) {
+                    errors[key] = result.error.errors[0]?.message || 'Invalid value';
+                }
+            }
+        }
+        return { success: Object.keys(errors).length === 0, errors };
+    }
+    // Get field metadata
+    getField(fieldId) {
+        return this.fields[fieldId];
+    }
+    // Get all field IDs
+    getFieldIds() {
+        return Object.keys(this.fields);
+    }
+    // Generate description for LLM context
+    getDescription() {
+        let desc = `Schema: ${this.name}\nFields:\n`;
+        for (const [id, field] of Object.entries(this.fields)) {
+            const zodType = this.getZodTypeDescription(field.schema);
+            desc += `  - ${id} (${zodType}): ${field.label}\n`;
+        }
+        return desc;
+    }
+    // Convert Zod schema to JSON Schema (for function calling)
+    toJSONSchema() {
+        const properties = {};
+        for (const [id, field] of Object.entries(this.fields)) {
+            properties[id] = this.zodToJSONSchema(field.schema, field.label);
+        }
+        return {
+            type: 'object',
+            properties,
+            required: Object.keys(this.fields),
+        };
+    }
+    getZodTypeDescription(schema) {
+        if (schema instanceof z.ZodString)
+            return 'string';
+        if (schema instanceof z.ZodNumber)
+            return 'number';
+        if (schema instanceof z.ZodBoolean)
+            return 'boolean';
+        if (schema instanceof z.ZodEnum)
+            return `enum(${schema.options.join('|')})`;
+        if (schema instanceof z.ZodOptional)
+            return `optional<${this.getZodTypeDescription(schema.unwrap())}>`;
+        return 'unknown';
+    }
+    zodToJSONSchema(schema, description) {
+        const base = { description };
+        if (schema instanceof z.ZodString) {
+            return { ...base, type: 'string' };
+        }
+        if (schema instanceof z.ZodNumber) {
+            const checks = schema._def.checks || [];
+            const result = { ...base, type: 'number' };
+            for (const check of checks) {
+                if (check.kind === 'min')
+                    result.minimum = check.value;
+                if (check.kind === 'max')
+                    result.maximum = check.value;
+            }
+            return result;
+        }
+        if (schema instanceof z.ZodBoolean) {
+            return { ...base, type: 'boolean' };
+        }
+        if (schema instanceof z.ZodEnum) {
+            return { ...base, type: 'string', enum: schema.options };
+        }
+        return { ...base, type: 'string' };
+    }
+}
+// Factory function
+export function createSchema(name, fields) {
+    return new DuetSchema(name, fields);
+}
+// Helper to define a field (for cleaner syntax)
+export function field(schema, label, defaultValue) {
+    return { schema, label, default: defaultValue };
+}

package/dist/store.d.ts

@@ -0,0 +1,18 @@
+/**
+ * duet-kit - Store
+ *
+ * Zustand store factory with validation and persistence.
+ */
+import { type StoreApi, type UseBoundStore } from 'zustand';
+import type { SchemaFields, DuetState } from './types';
+import type { DuetSchema } from './schema';
+export interface StoreOptions {
+    /** localStorage key for persistence (omit to disable) */
+    persist?: string;
+}
+export type DuetStore<T extends SchemaFields> = UseBoundStore<StoreApi<DuetState<T>>>;
+/**
+ * Create a Zustand store bound to a Duet schema
+ */
+export declare function createStore<T extends SchemaFields>(schema: DuetSchema<T>, options?: StoreOptions): DuetStore<T>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAa,SAAS,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtF;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAChD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,OAAO,GAAE,YAAiB,GACzB,SAAS,CAAC,CAAC,CAAC,CAyDd"}

package/dist/store.js

@@ -0,0 +1,58 @@
+/**
+ * duet-kit - Store
+ *
+ * Zustand store factory with validation and persistence.
+ */
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+/**
+ * Create a Zustand store bound to a Duet schema
+ */
+export function createStore(schema, options = {}) {
+    const initialData = schema.getDefaults();
+    const storeCreator = (set) => ({
+        data: initialData,
+        // Set a single field with validation
+        set: (field, value) => {
+            const result = schema.validate(field, value);
+            if (!result.success) {
+                console.warn(`Validation failed for ${String(field)}:`, result.error.message);
+                return false;
+            }
+            set((state) => ({
+                data: { ...state.data, [field]: result.data },
+            }));
+            return true;
+        },
+        // Set multiple fields with validation
+        setMany: (updates) => {
+            const validated = {};
+            for (const [key, value] of Object.entries(updates)) {
+                if (key in schema.fields) {
+                    const result = schema.validate(key, value);
+                    if (!result.success) {
+                        console.warn(`Validation failed for ${key}:`, result.error.message);
+                        return false;
+                    }
+                    validated[key] = result.data;
+                }
+            }
+            set((state) => ({
+                data: { ...state.data, ...validated },
+            }));
+            return true;
+        },
+        // Reset to defaults
+        reset: () => {
+            set(() => ({ data: schema.getDefaults() }));
+        },
+    });
+    // Apply persistence middleware if requested
+    if (options.persist) {
+        return create()(persist(storeCreator, {
+            name: options.persist,
+            partialize: (state) => ({ data: state.data }),
+        }));
+    }
+    return create()(storeCreator);
+}

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * duet-kit - Core Types
+ */
+import { z } from 'zod';
+export interface FieldDef<T = unknown> {
+    schema: z.ZodType<T>;
+    label: string;
+    default: T;
+}
+export type SchemaFields = Record<string, FieldDef>;
+export type InferData<T extends SchemaFields> = {
+    [K in keyof T]: z.infer<T[K]['schema']>;
+};
+export interface JsonPatchOp {
+    op: 'replace' | 'add' | 'remove';
+    path: string;
+    value?: unknown;
+}
+export type EditResult = {
+    success: true;
+    applied: number;
+} | {
+    success: false;
+    error: string;
+};
+export interface HistoryEntry {
+    id: string;
+    timestamp: number;
+    patch: JsonPatchOp[];
+    source: 'user' | 'llm' | 'system';
+    result: EditResult;
+}
+export interface DuetState<T extends SchemaFields> {
+    data: InferData<T>;
+    set: <K extends keyof T>(field: K, value: z.infer<T[K]['schema']>) => boolean;
+    setMany: (updates: Partial<InferData<T>>) => boolean;
+    reset: () => void;
+}
+export interface LLMBridge<T extends SchemaFields> {
+    applyPatch: (patch: JsonPatchOp[], source?: 'user' | 'llm' | 'system') => EditResult;
+    applyJSON: (json: string, source?: 'user' | 'llm' | 'system') => EditResult;
+    getContext: () => string;
+    getCompactContext: () => string;
+    getFunctionSchema: () => object;
+    getCurrentValues: () => InferData<T>;
+    history: () => HistoryEntry[];
+    clearHistory: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;CACZ;AAGD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAGpD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI;KAC7C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CACxC,CAAC;AAGF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAGD,MAAM,MAAM,UAAU,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAGtC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClC,MAAM,EAAE,UAAU,CAAC;CACpB;AAGD,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,YAAY;IAC/C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,OAAO,CAAC;IAC9E,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAGD,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,YAAY;IAC/C,UAAU,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,KAAK,UAAU,CAAC;IACrF,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,KAAK,UAAU,CAAC;IAC5E,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,4 @@
+/**
+ * duet-kit - Core Types
+ */
+export {};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "duet-kit",
+  "version": "0.1.0",
+  "description": "LLM-native UI toolkit - Build UIs where humans and AI edit the same validated state. Built on Zustand + Zod.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "zod": "^3.22.4",
+    "zustand": "^4.4.7"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.43",
+    "typescript": "^5.2.2",
+    "vitest": "^2.1.9"
+  },
+  "keywords": [
+    "llm",
+    "ai",
+    "react",
+    "zustand",
+    "zod",
+    "state-management",
+    "schema",
+    "validation",
+    "openai",
+    "anthropic",
+    "function-calling"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": ""
+}