ai-props 2.1.1 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/.dev.vars +2 -0
  2. package/CHANGELOG.md +24 -0
  3. package/README.md +131 -118
  4. package/package.json +30 -4
  5. package/src/ai.ts +12 -31
  6. package/src/cascade.ts +795 -0
  7. package/src/client.ts +440 -0
  8. package/src/durable-cascade.ts +743 -0
  9. package/src/event-bridge.ts +478 -0
  10. package/src/generate.ts +14 -12
  11. package/src/hoc.ts +15 -19
  12. package/src/hono-jsx.ts +675 -0
  13. package/src/index.ts +30 -0
  14. package/src/mdx-types.ts +169 -0
  15. package/src/mdx-utils.ts +437 -0
  16. package/src/mdx.ts +1008 -0
  17. package/src/rpc.ts +614 -0
  18. package/src/streaming.ts +618 -0
  19. package/src/validate.ts +15 -29
  20. package/src/worker.ts +547 -0
  21. package/test/cascade.test.ts +338 -0
  22. package/test/durable-cascade.test.ts +319 -0
  23. package/test/event-bridge.test.ts +351 -0
  24. package/test/generate.test.ts +6 -16
  25. package/test/mdx.test.ts +817 -0
  26. package/test/worker/capnweb-rpc.test.ts +1084 -0
  27. package/test/worker/full-flow.integration.test.ts +1463 -0
  28. package/test/worker/hono-jsx.test.ts +1258 -0
  29. package/test/worker/mdx-parsing.test.ts +1148 -0
  30. package/test/worker/setup.ts +56 -0
  31. package/test/worker.test.ts +595 -0
  32. package/tsconfig.json +2 -1
  33. package/vitest.config.js +6 -0
  34. package/vitest.config.ts +15 -1
  35. package/vitest.workers.config.ts +58 -0
  36. package/wrangler.jsonc +27 -0
  37. package/.turbo/turbo-build.log +0 -5
  38. package/dist/ai.d.ts +0 -125
  39. package/dist/ai.d.ts.map +0 -1
  40. package/dist/ai.js +0 -199
  41. package/dist/ai.js.map +0 -1
  42. package/dist/cache.d.ts +0 -66
  43. package/dist/cache.d.ts.map +0 -1
  44. package/dist/cache.js +0 -183
  45. package/dist/cache.js.map +0 -1
  46. package/dist/generate.d.ts +0 -69
  47. package/dist/generate.d.ts.map +0 -1
  48. package/dist/generate.js +0 -221
  49. package/dist/generate.js.map +0 -1
  50. package/dist/hoc.d.ts +0 -164
  51. package/dist/hoc.d.ts.map +0 -1
  52. package/dist/hoc.js +0 -236
  53. package/dist/hoc.js.map +0 -1
  54. package/dist/index.d.ts +0 -15
  55. package/dist/index.d.ts.map +0 -1
  56. package/dist/index.js +0 -21
  57. package/dist/index.js.map +0 -1
  58. package/dist/types.d.ts +0 -152
  59. package/dist/types.d.ts.map +0 -1
  60. package/dist/types.js +0 -7
  61. package/dist/types.js.map +0 -1
  62. package/dist/validate.d.ts +0 -58
  63. package/dist/validate.d.ts.map +0 -1
  64. package/dist/validate.js +0 -253
  65. package/dist/validate.js.map +0 -1
  66. package/src/ai.js +0 -198
  67. package/src/cache.js +0 -182
  68. package/src/generate.js +0 -220
  69. package/src/hoc.js +0 -235
  70. package/src/index.js +0 -20
  71. package/src/types.js +0 -6
  72. package/src/validate.js +0 -252
@@ -1,69 +0,0 @@
1
- /**
2
- * Props generation for ai-props
3
- *
4
- * Core functionality for generating component props using AI.
5
- *
6
- * @packageDocumentation
7
- */
8
- import type { PropSchema, GeneratePropsOptions, GeneratePropsResult, AIPropsConfig } from './types.js';
9
- /**
10
- * Configure global AI props settings
11
- */
12
- export declare function configureAIProps(config: Partial<AIPropsConfig>): void;
13
- /**
14
- * Get current configuration
15
- */
16
- export declare function getConfig(): AIPropsConfig;
17
- /**
18
- * Reset configuration to defaults
19
- */
20
- export declare function resetConfig(): void;
21
- /**
22
- * Generate props using AI
23
- *
24
- * @example
25
- * ```ts
26
- * const result = await generateProps({
27
- * schema: {
28
- * title: 'A compelling page title',
29
- * description: 'A brief description',
30
- * keywords: ['Relevant SEO keywords'],
31
- * },
32
- * context: { topic: 'AI-powered applications' },
33
- * })
34
- *
35
- * console.log(result.props)
36
- * // { title: '...', description: '...', keywords: [...] }
37
- * ```
38
- */
39
- export declare function generateProps<T = Record<string, unknown>>(options: GeneratePropsOptions): Promise<GeneratePropsResult<T>>;
40
- /**
41
- * Generate props synchronously from cache or throw
42
- *
43
- * Useful for SSR scenarios where async isn't available.
44
- * Throws if props aren't in cache.
45
- */
46
- export declare function getPropsSync<T = Record<string, unknown>>(schema: PropSchema, context?: Record<string, unknown>): T;
47
- /**
48
- * Pre-generate props for warming the cache
49
- *
50
- * @example
51
- * ```ts
52
- * await prefetchProps([
53
- * { schema: userProfileSchema, context: { userId: '123' } },
54
- * { schema: productSchema, context: { category: 'electronics' } },
55
- * ])
56
- * ```
57
- */
58
- export declare function prefetchProps(requests: GeneratePropsOptions[]): Promise<void>;
59
- /**
60
- * Generate multiple prop sets in parallel
61
- */
62
- export declare function generatePropsMany<T = Record<string, unknown>>(requests: GeneratePropsOptions[]): Promise<GeneratePropsResult<T>[]>;
63
- /**
64
- * Merge partial props with generated props
65
- *
66
- * Generates only the missing props, keeping provided ones.
67
- */
68
- export declare function mergeWithGenerated<T extends Record<string, unknown>>(schema: PropSchema, partialProps: Partial<T>, options?: Omit<GeneratePropsOptions, 'schema' | 'context'>): Promise<T>;
69
- //# sourceMappingURL=generate.d.ts.map
@@ -1 +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"}
package/dist/generate.js DELETED
@@ -1,221 +0,0 @@
1
- /**
2
- * Props generation for ai-props
3
- *
4
- * Core functionality for generating component props using AI.
5
- *
6
- * @packageDocumentation
7
- */
8
- import { generateObject, schema as createSchema } from 'ai-functions';
9
- import { createCacheKey, getDefaultCache } from './cache.js';
10
- /**
11
- * Default configuration
12
- */
13
- const DEFAULT_CONFIG = {
14
- model: 'sonnet',
15
- cache: true,
16
- cacheTTL: 5 * 60 * 1000, // 5 minutes
17
- };
18
- /**
19
- * Global configuration
20
- */
21
- let globalConfig = { ...DEFAULT_CONFIG };
22
- /**
23
- * Configure global AI props settings
24
- */
25
- export function configureAIProps(config) {
26
- globalConfig = { ...globalConfig, ...config };
27
- }
28
- /**
29
- * Get current configuration
30
- */
31
- export function getConfig() {
32
- return { ...globalConfig };
33
- }
34
- /**
35
- * Reset configuration to defaults
36
- */
37
- export function resetConfig() {
38
- globalConfig = { ...DEFAULT_CONFIG };
39
- }
40
- /**
41
- * Resolve a prop schema to a SimpleSchema
42
- *
43
- * If the schema is a string, it's treated as a named type
44
- * that generates a single property or description.
45
- */
46
- function resolveSchema(schema) {
47
- if (typeof schema === 'string') {
48
- // Named type or description string
49
- return { value: schema };
50
- }
51
- return schema;
52
- }
53
- /**
54
- * Build a prompt from context and schema
55
- */
56
- function buildPrompt(schema, context, additionalPrompt) {
57
- const parts = [];
58
- // Add context information
59
- if (context && Object.keys(context).length > 0) {
60
- parts.push('Given the following context:');
61
- parts.push(JSON.stringify(context, null, 2));
62
- parts.push('');
63
- }
64
- // Add schema information
65
- if (typeof schema === 'string') {
66
- parts.push(`Generate a value for: ${schema}`);
67
- }
68
- else {
69
- parts.push('Generate props matching the schema.');
70
- }
71
- // Add additional prompt
72
- if (additionalPrompt) {
73
- parts.push('');
74
- parts.push(additionalPrompt);
75
- }
76
- return parts.join('\n');
77
- }
78
- /**
79
- * Generate props using AI
80
- *
81
- * @example
82
- * ```ts
83
- * const result = await generateProps({
84
- * schema: {
85
- * title: 'A compelling page title',
86
- * description: 'A brief description',
87
- * keywords: ['Relevant SEO keywords'],
88
- * },
89
- * context: { topic: 'AI-powered applications' },
90
- * })
91
- *
92
- * console.log(result.props)
93
- * // { title: '...', description: '...', keywords: [...] }
94
- * ```
95
- */
96
- export async function generateProps(options) {
97
- const { schema, context, prompt, model, system } = options;
98
- const config = getConfig();
99
- const startTime = Date.now();
100
- // Check cache
101
- if (config.cache) {
102
- const cache = getDefaultCache();
103
- const cacheKey = createCacheKey(schema, context);
104
- const cached = cache.get(cacheKey);
105
- if (cached) {
106
- return {
107
- props: cached.props,
108
- cached: true,
109
- metadata: {
110
- model: config.model || 'cached',
111
- },
112
- };
113
- }
114
- }
115
- // Resolve schema
116
- const resolvedSchema = resolveSchema(schema);
117
- // Build prompt
118
- const fullPrompt = buildPrompt(schema, context, prompt);
119
- // Use custom generator if provided
120
- if (config.generate) {
121
- const props = await config.generate(resolvedSchema, context || {});
122
- return {
123
- props,
124
- cached: false,
125
- metadata: {
126
- model: 'custom',
127
- duration: Date.now() - startTime,
128
- },
129
- };
130
- }
131
- // Generate using AI
132
- const result = await generateObject({
133
- model: model || config.model || 'sonnet',
134
- schema: resolvedSchema,
135
- prompt: fullPrompt,
136
- system: system || config.system,
137
- });
138
- const props = result.object;
139
- // Cache result
140
- if (config.cache) {
141
- const cache = getDefaultCache();
142
- const cacheKey = createCacheKey(schema, context);
143
- cache.set(cacheKey, props);
144
- }
145
- return {
146
- props,
147
- cached: false,
148
- metadata: {
149
- model: model || config.model || 'sonnet',
150
- duration: Date.now() - startTime,
151
- },
152
- };
153
- }
154
- /**
155
- * Generate props synchronously from cache or throw
156
- *
157
- * Useful for SSR scenarios where async isn't available.
158
- * Throws if props aren't in cache.
159
- */
160
- export function getPropsSync(schema, context) {
161
- const cache = getDefaultCache();
162
- const cacheKey = createCacheKey(schema, context);
163
- const cached = cache.get(cacheKey);
164
- if (!cached) {
165
- throw new Error('Props not in cache. Use generateProps() first or ensure caching is enabled.');
166
- }
167
- return cached.props;
168
- }
169
- /**
170
- * Pre-generate props for warming the cache
171
- *
172
- * @example
173
- * ```ts
174
- * await prefetchProps([
175
- * { schema: userProfileSchema, context: { userId: '123' } },
176
- * { schema: productSchema, context: { category: 'electronics' } },
177
- * ])
178
- * ```
179
- */
180
- export async function prefetchProps(requests) {
181
- await Promise.all(requests.map(generateProps));
182
- }
183
- /**
184
- * Generate multiple prop sets in parallel
185
- */
186
- export async function generatePropsMany(requests) {
187
- return Promise.all(requests.map(req => generateProps(req)));
188
- }
189
- /**
190
- * Merge partial props with generated props
191
- *
192
- * Generates only the missing props, keeping provided ones.
193
- */
194
- export async function mergeWithGenerated(schema, partialProps, options) {
195
- // Get list of missing keys
196
- const schemaObj = typeof schema === 'string' ? { value: schema } : schema;
197
- const schemaKeys = Object.keys(schemaObj);
198
- const providedKeys = Object.keys(partialProps);
199
- const missingKeys = schemaKeys.filter(k => !providedKeys.includes(k));
200
- // If all props are provided, return as-is
201
- if (missingKeys.length === 0) {
202
- return partialProps;
203
- }
204
- // Build partial schema for missing props only
205
- const partialSchema = {};
206
- for (const key of missingKeys) {
207
- partialSchema[key] = schemaObj[key];
208
- }
209
- // Generate missing props
210
- const result = await generateProps({
211
- schema: partialSchema,
212
- context: partialProps,
213
- ...options,
214
- });
215
- // Merge
216
- return {
217
- ...result.props,
218
- ...partialProps,
219
- };
220
- }
221
- //# sourceMappingURL=generate.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}
package/dist/hoc.d.ts DELETED
@@ -1,164 +0,0 @@
1
- /**
2
- * Higher-Order Component (HOC) for React components
3
- *
4
- * Provides withAIProps HOC for wrapping React components
5
- * with AI-powered prop generation.
6
- *
7
- * @packageDocumentation
8
- */
9
- import type { PropSchema, AIComponentOptions, AIPropsConfig } from './types.js';
10
- /**
11
- * Options for withAIProps HOC
12
- */
13
- export interface WithAIPropsOptions<P> extends Omit<AIComponentOptions<P>, 'schema'> {
14
- /** Schema for props to generate */
15
- schema: PropSchema;
16
- /** Loading component to show while generating */
17
- loading?: () => unknown;
18
- /** Error component to show on generation failure */
19
- error?: (error: Error) => unknown;
20
- /** Fallback props to use if generation fails */
21
- fallback?: Partial<P>;
22
- }
23
- /**
24
- * Create props wrapper that can be used with any component system
25
- *
26
- * This is framework-agnostic and returns the enhanced props.
27
- *
28
- * @example
29
- * ```ts
30
- * const enhancer = createPropsEnhancer({
31
- * schema: {
32
- * title: 'Page title',
33
- * description: 'Page description',
34
- * },
35
- * defaults: {
36
- * title: 'Default Title',
37
- * },
38
- * })
39
- *
40
- * // Use with any component
41
- * const props = await enhancer({ description: 'My page' })
42
- * // { title: 'Default Title', description: 'My page' }
43
- *
44
- * const generatedProps = await enhancer({})
45
- * // { title: 'AI-generated title', description: 'AI-generated description' }
46
- * ```
47
- */
48
- export declare function createPropsEnhancer<P extends Record<string, unknown>>(options: WithAIPropsOptions<P>): (partialProps: Partial<P>) => Promise<P>;
49
- /**
50
- * Create an async props provider
51
- *
52
- * Returns a function that generates props on each call.
53
- * Useful for SSR and static generation.
54
- *
55
- * @example
56
- * ```ts
57
- * const getPageProps = createAsyncPropsProvider({
58
- * schema: {
59
- * title: 'SEO-optimized page title',
60
- * meta: { description: 'Meta description' },
61
- * },
62
- * })
63
- *
64
- * // In getStaticProps or getServerSideProps
65
- * export async function getStaticProps() {
66
- * const props = await getPageProps({ slug: 'about' })
67
- * return { props }
68
- * }
69
- * ```
70
- */
71
- export declare function createAsyncPropsProvider<P extends Record<string, unknown>>(options: WithAIPropsOptions<P>): {
72
- /**
73
- * Get props with AI generation
74
- */
75
- getProps: (partialProps: Partial<P>) => Promise<P>;
76
- /**
77
- * Get props for multiple items
78
- */
79
- getManyProps: (contexts: Partial<P>[]) => Promise<P[]>;
80
- /**
81
- * Get props with caching hint
82
- */
83
- getCachedProps: (context: Partial<P>, revalidate?: number) => Promise<{
84
- props: P;
85
- revalidate?: number;
86
- }>;
87
- };
88
- /**
89
- * Create a props transformer
90
- *
91
- * Transforms existing props by filling in missing values.
92
- *
93
- * @example
94
- * ```ts
95
- * const transformUserProps = createPropsTransformer({
96
- * schema: {
97
- * displayName: 'Display name for the user',
98
- * initials: 'User initials (2 letters)',
99
- * },
100
- * })
101
- *
102
- * const user = await transformUserProps({
103
- * username: 'johndoe',
104
- * email: 'john@example.com',
105
- * })
106
- * // { username: 'johndoe', email: '...', displayName: 'John Doe', initials: 'JD' }
107
- * ```
108
- */
109
- export declare function createPropsTransformer<I extends Record<string, unknown>, O extends Record<string, unknown>>(options: {
110
- schema: PropSchema;
111
- transform?: (input: I, generated: Record<string, unknown>) => O;
112
- config?: AIPropsConfig;
113
- }): (input: I) => Promise<I & O>;
114
- /**
115
- * Create a conditional props generator
116
- *
117
- * Only generates props when a condition is met.
118
- *
119
- * @example
120
- * ```ts
121
- * const maybeGenerateProps = createConditionalGenerator({
122
- * schema: { summary: 'Article summary' },
123
- * condition: (props) => !props.summary && props.content?.length > 100,
124
- * })
125
- * ```
126
- */
127
- export declare function createConditionalGenerator<P extends Record<string, unknown>>(options: {
128
- schema: PropSchema;
129
- condition: (props: Partial<P>) => boolean;
130
- config?: AIPropsConfig;
131
- }): (props: Partial<P>) => Promise<P>;
132
- /**
133
- * Batch props generator for list rendering
134
- *
135
- * Efficiently generates props for multiple items.
136
- *
137
- * @example
138
- * ```ts
139
- * const batchGenerator = createBatchGenerator({
140
- * schema: { title: 'Item title', description: 'Item description' },
141
- * })
142
- *
143
- * const items = await batchGenerator.generate([
144
- * { id: 1, category: 'tech' },
145
- * { id: 2, category: 'science' },
146
- * { id: 3, category: 'art' },
147
- * ])
148
- * ```
149
- */
150
- export declare function createBatchGenerator<P extends Record<string, unknown>>(options: {
151
- schema: PropSchema;
152
- concurrency?: number;
153
- config?: AIPropsConfig;
154
- }): {
155
- /**
156
- * Generate props for multiple items
157
- */
158
- generate: (items: Partial<P>[]) => Promise<P[]>;
159
- /**
160
- * Generate props one at a time (for rate limiting)
161
- */
162
- generateSequential: (items: Partial<P>[]) => Promise<P[]>;
163
- };
164
- //# sourceMappingURL=hoc.d.ts.map
package/dist/hoc.d.ts.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"hoc.d.ts","sourceRoot":"","sources":["../src/hoc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/E;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;IAClF,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;IACvB,oDAAoD;IACpD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACjC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAIhB,cAAc,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,CAgCpD;AAmBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAK5B;;OAEG;;IAGH;;OAEG;6BAC4B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI1D;;OAEG;8BAEQ,OAAO,CAAC,CAAC,CAAC,eACN,MAAM,KAClB,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE;IACT,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/D,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,IAGe,OAAO,CAAC,KAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAgBxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IACrF,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IACzC,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,IAGe,OAAO,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,CAU7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IAC/E,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;IAIG;;OAEG;sBACqB,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoBnD;;OAEG;gCAC+B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;EAchE"}