ai-props 0.1.2 → 2.0.2

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAe;AACf,cAAc,YAAY,CAAA;AAE1B,4BAA4B;AAC5B,OAAO,EACL,EAAE,EACF,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAEhB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAA;AAEtB,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAEnB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GAErB,MAAM,UAAU,CAAA;AAEjB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Type definitions for ai-props
+ *
+ * @packageDocumentation
+ */
+import type { SimpleSchema } from 'ai-functions';
+/**
+ * Configuration for AI prop generation
+ */
+export interface AIPropsConfig {
+    /** Model to use for generation (default: 'sonnet') */
+    model?: string;
+    /** System prompt for generation context */
+    system?: string;
+    /** Whether to cache generated props */
+    cache?: boolean;
+    /** Cache TTL in milliseconds (default: 5 minutes) */
+    cacheTTL?: number;
+    /** Custom generation function */
+    generate?: <T>(schema: SimpleSchema, context: Record<string, unknown>) => Promise<T>;
+}
+/**
+ * Schema definition for component props
+ * Can be a SimpleSchema or a named type string
+ */
+export type PropSchema = SimpleSchema | string;
+/**
+ * Options for prop generation
+ */
+export interface GeneratePropsOptions {
+    /** Schema defining the props to generate */
+    schema: PropSchema;
+    /** Partial props to use as context */
+    context?: Record<string, unknown>;
+    /** Additional prompt context */
+    prompt?: string;
+    /** Model to use */
+    model?: string;
+    /** System prompt */
+    system?: string;
+}
+/**
+ * Result of prop generation
+ */
+export interface GeneratePropsResult<T> {
+    /** Generated props */
+    props: T;
+    /** Whether props were from cache */
+    cached: boolean;
+    /** Generation metadata */
+    metadata?: {
+        model: string;
+        tokens?: number;
+        duration?: number;
+    };
+}
+/**
+ * Cache entry for generated props
+ */
+export interface PropsCacheEntry<T = unknown> {
+    props: T;
+    timestamp: number;
+    key: string;
+}
+/**
+ * Props cache interface
+ */
+export interface PropsCache {
+    get<T>(key: string): PropsCacheEntry<T> | undefined;
+    set<T>(key: string, props: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    size: number;
+}
+/**
+ * Hook result for useAIProps
+ */
+export interface UseAIPropsResult<T> {
+    /** Generated props (null while loading) */
+    props: T | null;
+    /** Whether generation is in progress */
+    loading: boolean;
+    /** Error if generation failed */
+    error: Error | null;
+    /** Regenerate props */
+    regenerate: () => Promise<void>;
+    /** Whether props were from cache */
+    cached: boolean;
+}
+/**
+ * Options for useAIProps hook
+ */
+export interface UseAIPropsOptions<T> extends Omit<GeneratePropsOptions, 'context'> {
+    /** Partial props to merge and use as context */
+    partialProps?: Partial<T>;
+    /** Skip generation if all required props are provided */
+    skipIfComplete?: boolean;
+    /** Dependencies that trigger regeneration */
+    deps?: unknown[];
+}
+/**
+ * Component wrapper options for AI()
+ */
+export interface AIComponentOptions<P> {
+    /** Schema for the component props */
+    schema: PropSchema;
+    /** Default props */
+    defaults?: Partial<P>;
+    /** Props that are always required (never generated) */
+    required?: (keyof P)[];
+    /** Props to exclude from generation */
+    exclude?: (keyof P)[];
+    /** AI generation config */
+    config?: AIPropsConfig;
+}
+/**
+ * Enhanced component type with AI capabilities
+ */
+export interface AIComponent<P> {
+    (props: Partial<P>): Promise<P>;
+    /** Original schema */
+    schema: PropSchema;
+    /** Generate props without rendering */
+    generateProps: (context?: Partial<P>) => Promise<P>;
+    /** Configuration */
+    config: AIPropsConfig;
+}
+/**
+ * Type helper to extract props type from a schema
+ */
+export type InferProps<S extends PropSchema> = S extends SimpleSchema ? S extends string ? string : S extends {
+    [key: string]: SimpleSchema;
+} ? {
+    [K in keyof S]: InferProps<S[K]>;
+} : unknown : unknown;
+/**
+ * Validation result for props
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Individual validation error
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    expected?: string;
+    received?: unknown;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for ai-props
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/validate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Validation utilities for ai-props
+ *
+ * Provides prop validation against schemas.
+ *
+ * @packageDocumentation
+ */
+import type { PropSchema, ValidationResult } from './types.js';
+/**
+ * Validate props against a schema
+ *
+ * @example
+ * ```ts
+ * const result = validateProps(
+ *   { name: 'John', age: '25' },  // props
+ *   { name: 'Name', age: 'Age (number)' }  // schema
+ * )
+ *
+ * if (!result.valid) {
+ *   console.log(result.errors)
+ *   // [{ path: 'age', message: 'Expected number, got string' }]
+ * }
+ * ```
+ */
+export declare function validateProps(props: Record<string, unknown>, schema: PropSchema): ValidationResult;
+/**
+ * Check if all required props are present
+ */
+export declare function hasRequiredProps<P extends Record<string, unknown>>(props: Partial<P>, required: (keyof P)[]): boolean;
+/**
+ * Get list of missing required props
+ */
+export declare function getMissingProps<P extends Record<string, unknown>>(props: Partial<P>, required: (keyof P)[]): (keyof P)[];
+/**
+ * Check if props are complete according to schema
+ */
+export declare function isComplete(props: Record<string, unknown>, schema: PropSchema): boolean;
+/**
+ * Get list of missing props according to schema
+ */
+export declare function getMissingFromSchema(props: Record<string, unknown>, schema: PropSchema): string[];
+/**
+ * Sanitize props by removing extra keys not in schema
+ */
+export declare function sanitizeProps<P extends Record<string, unknown>>(props: P, schema: PropSchema): Partial<P>;
+/**
+ * Merge props with defaults, respecting schema types
+ */
+export declare function mergeWithDefaults<P extends Record<string, unknown>>(props: Partial<P>, defaults: Partial<P>, schema: PropSchema): Partial<P>;
+/**
+ * Create a props validator function
+ */
+export declare function createValidator<P extends Record<string, unknown>>(schema: PropSchema): (props: Partial<P>) => ValidationResult;
+/**
+ * Assert props are valid, throwing on error
+ */
+export declare function assertValidProps(props: Record<string, unknown>, schema: PropSchema): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAA;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU,GACjB,gBAAgB,CAwBlB;AAuID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACpB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACpB,CAAC,MAAM,CAAC,CAAC,EAAE,CAEb;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU,GACjB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU,GACjB,MAAM,EAAE,CAMV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,MAAM,EAAE,UAAU,GACjB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAEzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU,GACjB,IAAI,CAMN"}

package/dist/validate.js

@@ -0,0 +1,253 @@
+/**
+ * Validation utilities for ai-props
+ *
+ * Provides prop validation against schemas.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Validate props against a schema
+ *
+ * @example
+ * ```ts
+ * const result = validateProps(
+ *   { name: 'John', age: '25' },  // props
+ *   { name: 'Name', age: 'Age (number)' }  // schema
+ * )
+ *
+ * if (!result.valid) {
+ *   console.log(result.errors)
+ *   // [{ path: 'age', message: 'Expected number, got string' }]
+ * }
+ * ```
+ */
+export function validateProps(props, schema) {
+    const errors = [];
+    if (typeof schema === 'string') {
+        // Simple string schema - just check if value exists
+        if (!props.value) {
+            errors.push({
+                path: 'value',
+                message: 'Value is required',
+                expected: 'string',
+                received: props.value,
+            });
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // Object schema - validate each key
+    for (const [key, schemaDef] of Object.entries(schema)) {
+        const value = props[key];
+        const keyErrors = validateValue(key, value, schemaDef);
+        errors.push(...keyErrors);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate a single value against a schema definition
+ */
+function validateValue(path, value, schema) {
+    const errors = [];
+    // String schema with type hint
+    if (typeof schema === 'string') {
+        const expectedType = extractTypeFromSchema(schema);
+        if (value === undefined || value === null) {
+            // Optional unless marked required
+            return errors;
+        }
+        if (expectedType && !checkType(value, expectedType)) {
+            errors.push({
+                path,
+                message: `Expected ${expectedType}, got ${typeof value}`,
+                expected: expectedType,
+                received: value,
+            });
+        }
+        return errors;
+    }
+    // Array schema
+    if (Array.isArray(schema)) {
+        if (!Array.isArray(value)) {
+            if (value !== undefined && value !== null) {
+                errors.push({
+                    path,
+                    message: `Expected array, got ${typeof value}`,
+                    expected: 'array',
+                    received: value,
+                });
+            }
+            return errors;
+        }
+        // Validate array items if schema has item definition
+        if (schema.length > 0) {
+            const itemSchema = schema[0];
+            for (let i = 0; i < value.length; i++) {
+                const itemErrors = validateValue(`${path}[${i}]`, value[i], itemSchema);
+                errors.push(...itemErrors);
+            }
+        }
+        return errors;
+    }
+    // Object schema
+    if (typeof schema === 'object' && schema !== null) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            if (value !== undefined && value !== null) {
+                errors.push({
+                    path,
+                    message: `Expected object, got ${Array.isArray(value) ? 'array' : typeof value}`,
+                    expected: 'object',
+                    received: value,
+                });
+            }
+            return errors;
+        }
+        // Recursively validate nested object
+        for (const [key, nestedSchema] of Object.entries(schema)) {
+            const nestedValue = value[key];
+            const nestedErrors = validateValue(`${path}.${key}`, nestedValue, nestedSchema);
+            errors.push(...nestedErrors);
+        }
+    }
+    return errors;
+}
+/**
+ * Extract type hint from schema string
+ * e.g., "Age (number)" -> "number"
+ */
+function extractTypeFromSchema(schema) {
+    const match = schema.match(/\((\w+)\)\s*$/);
+    if (match) {
+        return match[1].toLowerCase();
+    }
+    // Check for enum syntax
+    if (schema.includes(' | ')) {
+        return 'enum';
+    }
+    return null;
+}
+/**
+ * Check if a value matches an expected type
+ */
+function checkType(value, expectedType) {
+    switch (expectedType) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+        case 'integer':
+            return typeof value === 'number';
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'array':
+            return Array.isArray(value);
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        case 'date':
+            return typeof value === 'string' || value instanceof Date;
+        case 'enum':
+            return typeof value === 'string';
+        default:
+            return true;
+    }
+}
+/**
+ * Check if all required props are present
+ */
+export function hasRequiredProps(props, required) {
+    return required.every(key => props[key] !== undefined);
+}
+/**
+ * Get list of missing required props
+ */
+export function getMissingProps(props, required) {
+    return required.filter(key => props[key] === undefined);
+}
+/**
+ * Check if props are complete according to schema
+ */
+export function isComplete(props, schema) {
+    if (typeof schema === 'string') {
+        return props.value !== undefined;
+    }
+    return Object.keys(schema).every(key => props[key] !== undefined);
+}
+/**
+ * Get list of missing props according to schema
+ */
+export function getMissingFromSchema(props, schema) {
+    if (typeof schema === 'string') {
+        return props.value === undefined ? ['value'] : [];
+    }
+    return Object.keys(schema).filter(key => props[key] === undefined);
+}
+/**
+ * Sanitize props by removing extra keys not in schema
+ */
+export function sanitizeProps(props, schema) {
+    if (typeof schema === 'string') {
+        return { value: props.value };
+    }
+    const schemaKeys = new Set(Object.keys(schema));
+    const sanitized = {};
+    for (const [key, value] of Object.entries(props)) {
+        if (schemaKeys.has(key)) {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Merge props with defaults, respecting schema types
+ */
+export function mergeWithDefaults(props, defaults, schema) {
+    const result = { ...defaults, ...props };
+    // Ensure types match schema
+    if (typeof schema !== 'string') {
+        for (const [key, schemaDef] of Object.entries(schema)) {
+            if (result[key] === undefined)
+                continue;
+            const expectedType = typeof schemaDef === 'string'
+                ? extractTypeFromSchema(schemaDef)
+                : null;
+            if (expectedType) {
+                result[key] = coerceType(result[key], expectedType);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Attempt to coerce a value to an expected type
+ */
+function coerceType(value, expectedType) {
+    if (value === undefined || value === null)
+        return value;
+    switch (expectedType) {
+        case 'string':
+            return String(value);
+        case 'number':
+            return typeof value === 'number' ? value : Number(value);
+        case 'integer':
+            return typeof value === 'number' ? Math.floor(value) : parseInt(String(value), 10);
+        case 'boolean':
+            return Boolean(value);
+        default:
+            return value;
+    }
+}
+/**
+ * Create a props validator function
+ */
+export function createValidator(schema) {
+    return (props) => validateProps(props, schema);
+}
+/**
+ * Assert props are valid, throwing on error
+ */
+export function assertValidProps(props, schema) {
+    const result = validateProps(props, schema);
+    if (!result.valid) {
+        const messages = result.errors.map(e => `${e.path}: ${e.message}`).join(', ');
+        throw new Error(`Invalid props: ${messages}`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA8B,EAC9B,MAAkB;IAElB,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,oDAAoD;QACpD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,mBAAmB;gBAC5B,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,KAAK,CAAC,KAAK;aACtB,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAC/C,CAAC;IAED,oCAAoC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QACxB,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,SAAkC,CAAC,CAAA;QAC/E,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,IAAY,EACZ,KAAc,EACd,MAA6B;IAE7B,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,+BAA+B;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;QAElD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,kCAAkC;YAClC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,YAAY,YAAY,SAAS,OAAO,KAAK,EAAE;gBACxD,QAAQ,EAAE,YAAY;gBACtB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,OAAO,EAAE,uBAAuB,OAAO,KAAK,EAAE;oBAC9C,QAAQ,EAAE,OAAO;oBACjB,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,qDAAqD;QACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,UAAU,GAAG,aAAa,CAC9B,GAAG,IAAI,IAAI,CAAC,GAAG,EACf,KAAK,CAAC,CAAC,CAAC,EACR,UAAmC,CACpC,CAAA;gBACD,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,OAAO,EAAE,wBAAwB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE;oBAChF,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,qCAAqC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,MAAM,WAAW,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAA;YAC3D,MAAM,YAAY,GAAG,aAAa,CAChC,GAAG,IAAI,IAAI,GAAG,EAAE,EAChB,WAAW,EACX,YAAqC,CACtC,CAAA;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAA;IAChC,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,KAAc,EAAE,YAAoB;IACrD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;QAClC,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;QAClC,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAA;QACnC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7E,KAAK,MAAM;YACT,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI,CAAA;QAC3D,KAAK,MAAM;YACT,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;QAClC;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,QAAqB;IAErB,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAA;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,QAAqB;IAErB,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAA;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAA8B,EAC9B,MAAkB;IAElB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,CAAA;IAClC,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAA;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA8B,EAC9B,MAAkB;IAElB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAA;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAQ,EACR,MAAkB;IAElB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAG,KAAiC,CAAC,KAAK,EAA2B,CAAA;IACrF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/C,MAAM,SAAS,GAA4B,EAAE,CAAA;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACxB,CAAC;IACH,CAAC;IAED,OAAO,SAAuB,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiB,EACjB,QAAoB,EACpB,MAAkB;IAElB,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAA;IAExC,4BAA4B;IAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,IAAI,MAAM,CAAC,GAAc,CAAC,KAAK,SAAS;gBAAE,SAAQ;YAElD,MAAM,YAAY,GAAG,OAAO,SAAS,KAAK,QAAQ;gBAChD,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC;gBAClC,CAAC,CAAC,IAAI,CAAA;YAER,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,GAAc,CAAC,GAAG,UAAU,CACjC,MAAM,CAAC,GAAc,CAAC,EACtB,YAAY,CACC,CAAA;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,KAAc,EAAE,YAAoB;IACtD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAEvD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC1D,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QACpF,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;QACvB;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAkB;IAElB,OAAO,CAAC,KAAiB,EAAE,EAAE,CAAC,aAAa,CAAC,KAAgC,EAAE,MAAM,CAAC,CAAA;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA8B,EAC9B,MAAkB;IAElB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7E,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC"}

package/package.json

@@ -1,84 +1,37 @@
 {
   "name": "ai-props",
-  "version": "0.1.2",
-  "description": "Magic AI Prop Generation",
-  "repository": "https://github.com/ai-primitives/ai-props",
+  "version": "2.0.2",
+  "description": "AI-powered props primitives for intelligent component properties",
   "type": "module",
-  "main": "./dist/ai-props.umd.js",
-  "module": "./dist/ai-props.es.js",
-  "types": "./dist/index.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/ai-props.es.js",
-      "require": "./dist/ai-props.umd.js",
+      "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
   },
-  "files": [
-    "dist"
-  ],
   "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build && tsc --emitDeclarationOnly",
+    "build": "tsc",
+    "dev": "tsc --watch",
     "test": "vitest",
-    "cosmos": "cosmos",
-    "cosmos:export": "cosmos-export",
-    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx}\""
-  },
-  "release": {
-    "branches": [
-      "main"
-    ],
-    "plugins": [
-      "@semantic-release/commit-analyzer",
-      "@semantic-release/release-notes-generator",
-      "@semantic-release/npm",
-      "@semantic-release/github"
-    ]
-  },
-  "peerDependencies": {
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.0.8",
-    "ai": "^4.0.18",
-    "clsx": "^2.1.1",
-    "tailwind-merge": "^2.5.5"
+    "ai-functions": "2.0.2",
+    "rpc.do": "^0.1.0"
   },
   "devDependencies": {
-    "@opentelemetry/api": "^1.9.0",
-    "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/github": "^11.0.1",
-    "@semantic-release/npm": "^12.0.1",
-    "@semantic-release/release-notes-generator": "^14.0.1",
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/react": "^14.1.0",
-    "@types/node": "^20.10.2",
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
-    "@vitejs/plugin-react": "^4.3.4",
-    "@vitest/coverage-v8": "^2.1.8",
-    "jsdom": "^22.1.0",
-    "prettier": "^3.4.2",
-    "react": "^18.2.0",
-    "react-cosmos": "^6.0.0",
-    "react-dom": "^18.2.0",
-    "semantic-release": "^24.2.0",
-    "typescript": "^5.3.2",
-    "vite": "^5.0.2",
-    "vitest": "^1.0.2",
-    "zod": "^3.24.1"
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.9"
   },
   "keywords": [
-    "react",
     "ai",
     "props",
-    "openai",
-    "gpt"
+    "react",
+    "primitives"
   ],
-  "author": "",
   "license": "MIT"
 }