ai-props 0.1.2 → 2.0.2

package/dist/ai.d.ts

@@ -0,0 +1,125 @@
+/**
+ * AI() wrapper for components with intelligent prop generation
+ *
+ * The AI() function wraps a component definition and automatically
+ * generates missing props using AI when the component is rendered.
+ *
+ * @packageDocumentation
+ */
+import type { SimpleSchema } from 'ai-functions';
+import type { PropSchema, AIComponentOptions, AIComponent } from './types.js';
+/**
+ * Create an AI-powered component wrapper
+ *
+ * The returned function accepts partial props and generates
+ * any missing props using AI based on the schema.
+ *
+ * @example
+ * ```ts
+ * const UserCard = AI({
+ *   schema: {
+ *     name: 'Full name of the user',
+ *     bio: 'A short biography',
+ *     avatar: 'URL to avatar image',
+ *   },
+ *   defaults: {
+ *     avatar: 'https://example.com/default-avatar.png',
+ *   },
+ * })
+ *
+ * // Generate all props
+ * const props = await UserCard({})
+ *
+ * // Generate only missing props
+ * const props2 = await UserCard({ name: 'John Doe' })
+ * ```
+ */
+export declare function AI<P extends Record<string, unknown>>(options: AIComponentOptions<P>): AIComponent<P>;
+/**
+ * Create a typed AI component with inference
+ *
+ * @example
+ * ```ts
+ * const ProductCard = createAIComponent<{
+ *   title: string
+ *   price: number
+ *   description: string
+ * }>({
+ *   schema: {
+ *     title: 'Product title',
+ *     price: 'Price in USD (number)',
+ *     description: 'Product description',
+ *   },
+ * })
+ * ```
+ */
+export declare function createAIComponent<P extends Record<string, unknown>>(options: AIComponentOptions<P>): AIComponent<P>;
+/**
+ * Define props schema with type inference
+ *
+ * @example
+ * ```ts
+ * const userSchema = definePropsSchema({
+ *   name: 'User name',
+ *   email: 'Email address',
+ *   age: 'Age (number)',
+ * })
+ * ```
+ */
+export declare function definePropsSchema<T extends Record<string, string | SimpleSchema>>(schema: T): T;
+/**
+ * Create a component factory for generating multiple instances
+ *
+ * @example
+ * ```ts
+ * const factory = createComponentFactory({
+ *   schema: { name: 'Product name', price: 'Price (number)' },
+ * })
+ *
+ * const products = await factory.generateMany([
+ *   { category: 'electronics' },
+ *   { category: 'clothing' },
+ *   { category: 'food' },
+ * ])
+ * ```
+ */
+export declare function createComponentFactory<P extends Record<string, unknown>>(options: AIComponentOptions<P>): {
+    component: AIComponent<P>;
+    schema: PropSchema;
+    /**
+     * Generate a single instance
+     */
+    generate: (context?: Partial<P>) => Promise<P>;
+    /**
+     * Generate multiple instances
+     */
+    generateMany: (contexts: Partial<P>[]) => Promise<P[]>;
+    /**
+     * Generate with specific overrides
+     */
+    generateWith: (context: Partial<P>, overrides: Partial<P>) => Promise<P>;
+};
+/**
+ * Compose multiple AI components
+ *
+ * Creates a component that combines props from multiple schemas.
+ *
+ * @example
+ * ```ts
+ * const FullProfile = composeAIComponents({
+ *   user: userSchema,
+ *   settings: settingsSchema,
+ *   preferences: preferencesSchema,
+ * })
+ *
+ * const profile = await FullProfile({
+ *   user: { name: 'John' },
+ *   settings: {},
+ *   preferences: { theme: 'dark' },
+ * })
+ * ```
+ */
+export declare function composeAIComponents<T extends Record<string, AIComponentOptions<Record<string, unknown>>>>(components: T): AIComponent<{
+    [K in keyof T]: T[K] extends AIComponentOptions<infer P> ? P : never;
+}>;
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,WAAW,EAEZ,MAAM,YAAY,CAAA;AAGnB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CA8ChB;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CAEhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,EAC/E,MAAM,EAAE,CAAC,GACR,CAAC,CAEH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;;;IAQ5B;;OAEG;yBACkB,OAAO,CAAC,CAAC,CAAC;IAE/B;;OAEG;6BAC4B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI1D;;OAEG;4BAEQ,OAAO,CAAC,CAAC,CAAC,aACR,OAAO,CAAC,CAAC,CAAC,KACpB,OAAO,CAAC,CAAC,CAAC;EAKhB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAErE,UAAU,EAAE,CAAC,GACZ,WAAW,CAAC;KACZ,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACrE,CAAC,CAkCD"}

package/dist/ai.js

@@ -0,0 +1,199 @@
+/**
+ * AI() wrapper for components with intelligent prop generation
+ *
+ * The AI() function wraps a component definition and automatically
+ * generates missing props using AI when the component is rendered.
+ *
+ * @packageDocumentation
+ */
+import { generateProps, mergeWithGenerated } from './generate.js';
+/**
+ * Create an AI-powered component wrapper
+ *
+ * The returned function accepts partial props and generates
+ * any missing props using AI based on the schema.
+ *
+ * @example
+ * ```ts
+ * const UserCard = AI({
+ *   schema: {
+ *     name: 'Full name of the user',
+ *     bio: 'A short biography',
+ *     avatar: 'URL to avatar image',
+ *   },
+ *   defaults: {
+ *     avatar: 'https://example.com/default-avatar.png',
+ *   },
+ * })
+ *
+ * // Generate all props
+ * const props = await UserCard({})
+ *
+ * // Generate only missing props
+ * const props2 = await UserCard({ name: 'John Doe' })
+ * ```
+ */
+export function AI(options) {
+    const { schema, defaults = {}, required = [], exclude = [], config = {} } = options;
+    // Build filtered schema (exclude specified props)
+    const filteredSchema = filterSchema(schema, exclude);
+    /**
+     * The AI component function
+     */
+    const aiComponent = async (partialProps) => {
+        // Merge with defaults
+        const propsWithDefaults = { ...defaults, ...partialProps };
+        // Check if all required props are provided
+        const missingRequired = required.filter(key => propsWithDefaults[key] === undefined);
+        if (missingRequired.length > 0) {
+            throw new Error(`Missing required props: ${missingRequired.join(', ')}`);
+        }
+        // Generate missing props
+        const fullProps = await mergeWithGenerated(filteredSchema, propsWithDefaults, {
+            model: config.model,
+            system: config.system,
+        });
+        return fullProps;
+    };
+    // Attach metadata
+    aiComponent.schema = schema;
+    aiComponent.config = config;
+    // Attach helper method
+    aiComponent.generateProps = async (context) => {
+        return aiComponent(context || {});
+    };
+    return aiComponent;
+}
+/**
+ * Filter schema to exclude certain keys
+ */
+function filterSchema(schema, exclude) {
+    if (typeof schema === 'string') {
+        return schema;
+    }
+    const filtered = {};
+    for (const [key, value] of Object.entries(schema)) {
+        if (!exclude.includes(key)) {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+/**
+ * Create a typed AI component with inference
+ *
+ * @example
+ * ```ts
+ * const ProductCard = createAIComponent<{
+ *   title: string
+ *   price: number
+ *   description: string
+ * }>({
+ *   schema: {
+ *     title: 'Product title',
+ *     price: 'Price in USD (number)',
+ *     description: 'Product description',
+ *   },
+ * })
+ * ```
+ */
+export function createAIComponent(options) {
+    return AI(options);
+}
+/**
+ * Define props schema with type inference
+ *
+ * @example
+ * ```ts
+ * const userSchema = definePropsSchema({
+ *   name: 'User name',
+ *   email: 'Email address',
+ *   age: 'Age (number)',
+ * })
+ * ```
+ */
+export function definePropsSchema(schema) {
+    return schema;
+}
+/**
+ * Create a component factory for generating multiple instances
+ *
+ * @example
+ * ```ts
+ * const factory = createComponentFactory({
+ *   schema: { name: 'Product name', price: 'Price (number)' },
+ * })
+ *
+ * const products = await factory.generateMany([
+ *   { category: 'electronics' },
+ *   { category: 'clothing' },
+ *   { category: 'food' },
+ * ])
+ * ```
+ */
+export function createComponentFactory(options) {
+    const component = AI(options);
+    return {
+        component,
+        schema: options.schema,
+        /**
+         * Generate a single instance
+         */
+        generate: (context) => component(context || {}),
+        /**
+         * Generate multiple instances
+         */
+        generateMany: async (contexts) => {
+            return Promise.all(contexts.map(ctx => component(ctx)));
+        },
+        /**
+         * Generate with specific overrides
+         */
+        generateWith: async (context, overrides) => {
+            const generated = await component(context);
+            return { ...generated, ...overrides };
+        },
+    };
+}
+/**
+ * Compose multiple AI components
+ *
+ * Creates a component that combines props from multiple schemas.
+ *
+ * @example
+ * ```ts
+ * const FullProfile = composeAIComponents({
+ *   user: userSchema,
+ *   settings: settingsSchema,
+ *   preferences: preferencesSchema,
+ * })
+ *
+ * const profile = await FullProfile({
+ *   user: { name: 'John' },
+ *   settings: {},
+ *   preferences: { theme: 'dark' },
+ * })
+ * ```
+ */
+export function composeAIComponents(components) {
+    const aiComponent = async (partialProps) => {
+        const results = {};
+        // Generate each component's props
+        await Promise.all(Object.entries(components).map(async ([key, options]) => {
+            const component = AI(options);
+            const partial = partialProps[key] || {};
+            results[key] = await component(partial);
+        }));
+        return results;
+    };
+    // Compose schemas
+    const composedSchema = {};
+    for (const [key, options] of Object.entries(components)) {
+        composedSchema[key] = options.schema;
+    }
+    aiComponent.schema = composedSchema;
+    aiComponent.config = {};
+    aiComponent.generateProps = (context) => aiComponent(context || {});
+    return aiComponent;
+}
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"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"}

package/dist/cache.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Props caching for ai-props
+ *
+ * Provides in-memory caching for generated props to avoid
+ * redundant AI calls with the same context.
+ *
+ * @packageDocumentation
+ */
+import type { PropsCache, PropsCacheEntry } from './types.js';
+/**
+ * Default cache TTL (5 minutes)
+ */
+export declare const DEFAULT_CACHE_TTL: number;
+/**
+ * Create a cache key from schema and context
+ */
+export declare function createCacheKey(schema: unknown, context?: Record<string, unknown>): string;
+/**
+ * In-memory props cache implementation
+ */
+export declare class MemoryPropsCache implements PropsCache {
+    private cache;
+    private ttl;
+    constructor(ttl?: number);
+    get<T>(key: string): PropsCacheEntry<T> | undefined;
+    set<T>(key: string, props: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get all entries (for debugging)
+     */
+    entries(): IterableIterator<[string, PropsCacheEntry]>;
+}
+/**
+ * Get or create the default cache
+ */
+export declare function getDefaultCache(): MemoryPropsCache;
+/**
+ * Configure the default cache
+ */
+export declare function configureCache(ttl: number): void;
+/**
+ * Clear the default cache
+ */
+export declare function clearCache(): void;
+/**
+ * LRU (Least Recently Used) cache implementation
+ * For scenarios where memory usage needs to be bounded
+ */
+export declare class LRUPropsCache implements PropsCache {
+    private cache;
+    private maxSize;
+    private ttl;
+    constructor(maxSize?: number, ttl?: number);
+    get<T>(key: string): PropsCacheEntry<T> | undefined;
+    set<T>(key: string, props: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAgB,CAAA;AAE9C;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAIR;AA6BD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,GAAG,CAAQ;gBAEP,GAAG,GAAE,MAA0B;IAI3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS;IAanD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,IAAI,MAAM;IAcjB;;OAEG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAGvD;AAOD;;GAEG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAKlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,GAAG,CAAQ;gBAEP,OAAO,GAAE,MAAY,EAAE,GAAG,GAAE,MAA0B;IAKlE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS;IAiBnD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAkBnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/cache.js

@@ -0,0 +1,183 @@
+/**
+ * Props caching for ai-props
+ *
+ * Provides in-memory caching for generated props to avoid
+ * redundant AI calls with the same context.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Default cache TTL (5 minutes)
+ */
+export const DEFAULT_CACHE_TTL = 5 * 60 * 1000;
+/**
+ * Create a cache key from schema and context
+ */
+export function createCacheKey(schema, context) {
+    const schemaStr = typeof schema === 'string' ? schema : JSON.stringify(schema);
+    const contextStr = context ? JSON.stringify(sortObject(context)) : '';
+    return `${hashString(schemaStr)}:${hashString(contextStr)}`;
+}
+/**
+ * Simple string hash function
+ */
+function hashString(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    return hash.toString(36);
+}
+/**
+ * Sort object keys for consistent hashing
+ */
+function sortObject(obj) {
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+        const value = obj[key];
+        sorted[key] = value && typeof value === 'object' && !Array.isArray(value)
+            ? sortObject(value)
+            : value;
+    }
+    return sorted;
+}
+/**
+ * In-memory props cache implementation
+ */
+export class MemoryPropsCache {
+    cache = new Map();
+    ttl;
+    constructor(ttl = DEFAULT_CACHE_TTL) {
+        this.ttl = ttl;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        // Check if expired
+        if (Date.now() - entry.timestamp > this.ttl) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry;
+    }
+    set(key, props) {
+        this.cache.set(key, {
+            props,
+            timestamp: Date.now(),
+            key
+        });
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache) {
+            if (now - entry.timestamp > this.ttl) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Get all entries (for debugging)
+     */
+    entries() {
+        return this.cache.entries();
+    }
+}
+/**
+ * Global default cache instance
+ */
+let defaultCache = null;
+/**
+ * Get or create the default cache
+ */
+export function getDefaultCache() {
+    if (!defaultCache) {
+        defaultCache = new MemoryPropsCache();
+    }
+    return defaultCache;
+}
+/**
+ * Configure the default cache
+ */
+export function configureCache(ttl) {
+    defaultCache = new MemoryPropsCache(ttl);
+}
+/**
+ * Clear the default cache
+ */
+export function clearCache() {
+    if (defaultCache) {
+        defaultCache.clear();
+    }
+}
+/**
+ * LRU (Least Recently Used) cache implementation
+ * For scenarios where memory usage needs to be bounded
+ */
+export class LRUPropsCache {
+    cache = new Map();
+    maxSize;
+    ttl;
+    constructor(maxSize = 100, ttl = DEFAULT_CACHE_TTL) {
+        this.maxSize = maxSize;
+        this.ttl = ttl;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        // Check if expired
+        if (Date.now() - entry.timestamp > this.ttl) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry;
+    }
+    set(key, props) {
+        // Remove oldest entries if at capacity
+        while (this.cache.size >= this.maxSize) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest) {
+                this.cache.delete(oldest);
+            }
+            else {
+                break;
+            }
+        }
+        this.cache.set(key, {
+            props,
+            timestamp: Date.now(),
+            key
+        });
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/generate.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Props generation for ai-props
+ *
+ * Core functionality for generating component props using AI.
+ *
+ * @packageDocumentation
+ */
+import type { PropSchema, GeneratePropsOptions, GeneratePropsResult, AIPropsConfig } from './types.js';
+/**
+ * Configure global AI props settings
+ */
+export declare function configureAIProps(config: Partial<AIPropsConfig>): void;
+/**
+ * Get current configuration
+ */
+export declare function getConfig(): AIPropsConfig;
+/**
+ * Reset configuration to defaults
+ */
+export declare function resetConfig(): void;
+/**
+ * Generate props using AI
+ *
+ * @example
+ * ```ts
+ * const result = await generateProps({
+ *   schema: {
+ *     title: 'A compelling page title',
+ *     description: 'A brief description',
+ *     keywords: ['Relevant SEO keywords'],
+ *   },
+ *   context: { topic: 'AI-powered applications' },
+ * })
+ *
+ * console.log(result.props)
+ * // { title: '...', description: '...', keywords: [...] }
+ * ```
+ */
+export declare function generateProps<T = Record<string, unknown>>(options: GeneratePropsOptions): Promise<GeneratePropsResult<T>>;
+/**
+ * Generate props synchronously from cache or throw
+ *
+ * Useful for SSR scenarios where async isn't available.
+ * Throws if props aren't in cache.
+ */
+export declare function getPropsSync<T = Record<string, unknown>>(schema: PropSchema, context?: Record<string, unknown>): T;
+/**
+ * Pre-generate props for warming the cache
+ *
+ * @example
+ * ```ts
+ * await prefetchProps([
+ *   { schema: userProfileSchema, context: { userId: '123' } },
+ *   { schema: productSchema, context: { category: 'electronics' } },
+ * ])
+ * ```
+ */
+export declare function prefetchProps(requests: GeneratePropsOptions[]): Promise<void>;
+/**
+ * Generate multiple prop sets in parallel
+ */
+export declare function generatePropsMany<T = Record<string, unknown>>(requests: GeneratePropsOptions[]): Promise<GeneratePropsResult<T>[]>;
+/**
+ * Merge partial props with generated props
+ *
+ * Generates only the missing props, keeping provided ones.
+ */
+export declare function mergeWithGenerated<T extends Record<string, unknown>>(schema: PropSchema, partialProps: Partial<T>, options?: Omit<GeneratePropsOptions, 'schema' | 'context'>): Promise<T>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAA;AAiBnB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAkEjC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,CAAC,CAYH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAEnC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CA8BZ"}