raffel 0.1.2

package/dist/http/templates.js

@@ -0,0 +1,457 @@
+/**
+ * Template Rendering System
+ *
+ * Provides pluggable template engine support with caching, layouts,
+ * and context helpers for server-side rendering.
+ *
+ * @example
+ * import { createTemplateEngine, renderMiddleware } from 'raffel/http/templates'
+ *
+ * // Create with built-in simple engine
+ * const templates = createTemplateEngine({
+ *   templatesDir: './views',
+ *   extension: '.html',
+ *   cache: true,
+ * })
+ *
+ * // Use with middleware
+ * app.use('*', renderMiddleware(templates))
+ *
+ * // Render in handler
+ * app.get('/', (c) => {
+ *   return c.render('home', { title: 'Welcome' })
+ * })
+ *
+ * // Or use custom engine (EJS, Pug, etc.)
+ * import ejs from 'ejs'
+ * const templates = createTemplateEngine({
+ *   templatesDir: './views',
+ *   engine: {
+ *     name: 'ejs',
+ *     render: (template, data) => ejs.render(template, data),
+ *     renderFile: (path, data) => ejs.renderFile(path, data),
+ *   },
+ * })
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// ─────────────────────────────────────────────────────────────────────────────
+// Built-in Simple Template Engine
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Simple template engine with basic variable substitution
+ *
+ * Supports:
+ * - {{ variable }} - Output escaped value
+ * - {{{ variable }}} - Output raw value (unescaped)
+ * - {{# if condition }}...{{/ if }} - Conditional
+ * - {{# each array }}...{{/ each }} - Loop
+ * - {{> partial }} - Include partial
+ */
+class SimpleTemplateEngine {
+    name = 'simple';
+    helpers = {};
+    partials = {};
+    constructor(helpers, partials) {
+        this.helpers = helpers || {};
+        this.partials = partials || {};
+        // Built-in helpers
+        this.helpers.json = (value) => JSON.stringify(value);
+        this.helpers.upper = (value) => String(value).toUpperCase();
+        this.helpers.lower = (value) => String(value).toLowerCase();
+        this.helpers.capitalize = (value) => {
+            const str = String(value);
+            return str.charAt(0).toUpperCase() + str.slice(1);
+        };
+        this.helpers.date = (value, format) => {
+            const date = value instanceof Date ? value : new Date(String(value));
+            if (format === 'iso')
+                return date.toISOString();
+            if (format === 'locale')
+                return date.toLocaleString();
+            return date.toDateString();
+        };
+    }
+    render(template, data) {
+        let result = template;
+        // Process partials {{> partialName }}
+        result = result.replace(/\{\{>\s*(\w+)\s*\}\}/g, (_match, partialName) => {
+            const partial = this.partials[partialName];
+            if (partial) {
+                return this.render(partial, data);
+            }
+            return `<!-- Partial "${partialName}" not found -->`;
+        });
+        // Process conditionals {{# if condition }}...{{/ if }}
+        result = this.processConditionals(result, data);
+        // Process loops {{# each array }}...{{/ each }}
+        result = this.processLoops(result, data);
+        // Process raw output {{{ variable }}}
+        result = result.replace(/\{\{\{\s*([\w.]+)\s*\}\}\}/g, (_match, key) => {
+            const value = this.getValue(data, key);
+            return value !== undefined ? String(value) : '';
+        });
+        // Process helpers {{ helper arg1 arg2 }}
+        result = result.replace(/\{\{\s*(\w+)\s+([^}]+)\s*\}\}/g, (_match, helperName, argsStr) => {
+            const helper = this.helpers[helperName];
+            if (helper) {
+                const args = argsStr.split(/\s+/).map((arg) => {
+                    // Check if it's a data reference
+                    if (arg.startsWith('"') || arg.startsWith("'")) {
+                        return arg.slice(1, -1);
+                    }
+                    return this.getValue(data, arg);
+                });
+                return String(helper(...args));
+            }
+            // Not a helper, treat as variable
+            return this.escapeHtml(String(this.getValue(data, helperName) ?? ''));
+        });
+        // Process escaped output {{ variable }}
+        result = result.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_match, key) => {
+            const value = this.getValue(data, key);
+            return value !== undefined ? this.escapeHtml(String(value)) : '';
+        });
+        return result;
+    }
+    compile(template) {
+        // For simple engine, just return a function that calls render
+        return (data) => this.render(template, data);
+    }
+    addHelper(name, fn) {
+        this.helpers[name] = fn;
+    }
+    addPartial(name, template) {
+        this.partials[name] = template;
+    }
+    processConditionals(template, data) {
+        // Match {{# if condition }}...{{/ if }} or {{# if condition }}...{{# else }}...{{/ if }}
+        const ifRegex = /\{\{#\s*if\s+([\w.!]+)\s*\}\}([\s\S]*?)\{\{\/\s*if\s*\}\}/g;
+        return template.replace(ifRegex, (_match, condition, content) => {
+            // Check for else clause
+            const elseParts = content.split(/\{\{#\s*else\s*\}\}/);
+            const ifContent = elseParts[0];
+            const elseContent = elseParts[1] || '';
+            // Evaluate condition
+            let conditionValue;
+            if (condition.startsWith('!')) {
+                conditionValue = !this.getValue(data, condition.slice(1));
+            }
+            else {
+                conditionValue = this.getValue(data, condition);
+            }
+            if (conditionValue) {
+                return this.render(ifContent, data);
+            }
+            else {
+                return this.render(elseContent, data);
+            }
+        });
+    }
+    processLoops(template, data) {
+        // Match {{# each array }}...{{/ each }}
+        const eachRegex = /\{\{#\s*each\s+([\w.]+)\s*\}\}([\s\S]*?)\{\{\/\s*each\s*\}\}/g;
+        return template.replace(eachRegex, (_match, arrayKey, content) => {
+            const array = this.getValue(data, arrayKey);
+            if (!Array.isArray(array)) {
+                return '';
+            }
+            return array
+                .map((item, index) => {
+                const itemData = {
+                    ...data,
+                    this: item,
+                    '@index': index,
+                    '@first': index === 0,
+                    '@last': index === array.length - 1,
+                };
+                // If item is an object, spread its properties
+                if (typeof item === 'object' && item !== null) {
+                    Object.assign(itemData, item);
+                }
+                return this.render(content, itemData);
+            })
+                .join('');
+        });
+    }
+    getValue(data, key) {
+        const parts = key.split('.');
+        let value = data;
+        for (const part of parts) {
+            if (value === null || value === undefined) {
+                return undefined;
+            }
+            value = value[part];
+        }
+        return value;
+    }
+    escapeHtml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#x27;');
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Template Manager
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create a template engine manager
+ *
+ * @param options - Template engine configuration
+ * @returns Template manager instance
+ *
+ * @example
+ * const templates = createTemplateEngine({
+ *   templatesDir: './views',
+ *   cache: process.env.NODE_ENV === 'production',
+ *   layout: 'main',
+ *   globals: { appName: 'My App' },
+ * })
+ */
+export function createTemplateEngine(options = {}) {
+    const { templatesDir = './views', extension = '.html', engine: customEngine, cache = process.env.NODE_ENV === 'production', layout: defaultLayout, layoutsDir = templatesDir, partialsDir, globals = {}, helpers = {}, } = options;
+    // Create engine
+    const simpleEngine = new SimpleTemplateEngine(helpers);
+    const engine = customEngine || simpleEngine;
+    // Template cache
+    const templateCache = new Map();
+    let cacheHits = 0;
+    let cacheMisses = 0;
+    // Load partials if directory specified
+    if (partialsDir && fs.existsSync(partialsDir)) {
+        const files = fs.readdirSync(partialsDir);
+        for (const file of files) {
+            if (file.endsWith(extension)) {
+                const name = file.slice(0, -extension.length);
+                const content = fs.readFileSync(path.join(partialsDir, file), 'utf-8');
+                if (simpleEngine) {
+                    simpleEngine.addPartial(name, content);
+                }
+            }
+        }
+    }
+    /**
+     * Get template file path
+     */
+    function getTemplatePath(name, dir = templatesDir) {
+        const fileName = name.includes('.') ? name : `${name}${extension}`;
+        return path.resolve(dir, fileName);
+    }
+    /**
+     * Load and optionally cache a template
+     */
+    async function loadTemplate(name, dir = templatesDir) {
+        const filePath = getTemplatePath(name, dir);
+        const cacheKey = filePath;
+        // Check cache
+        if (cache && templateCache.has(cacheKey)) {
+            cacheHits++;
+            return templateCache.get(cacheKey);
+        }
+        cacheMisses++;
+        // Load file
+        const content = await fs.promises.readFile(filePath, 'utf-8');
+        // Compile if engine supports it
+        let compiled;
+        if (engine.compile) {
+            compiled = engine.compile(content);
+        }
+        else {
+            compiled = (data) => engine.render(content, data);
+        }
+        // Cache
+        if (cache) {
+            templateCache.set(cacheKey, compiled);
+        }
+        return compiled;
+    }
+    return {
+        async render(name, data = {}) {
+            const compiled = await loadTemplate(name);
+            const mergedData = { ...globals, ...data };
+            return compiled(mergedData);
+        },
+        async renderString(template, data = {}) {
+            const mergedData = { ...globals, ...data };
+            return engine.render(template, mergedData);
+        },
+        async renderWithLayout(name, data = {}, layout = defaultLayout) {
+            // Render the main template
+            const content = await this.render(name, data);
+            if (!layout) {
+                return content;
+            }
+            // Render the layout with content
+            const layoutCompiled = await loadTemplate(layout, layoutsDir);
+            const layoutData = {
+                ...globals,
+                ...data,
+                body: content,
+                content, // Alias
+            };
+            return layoutCompiled(layoutData);
+        },
+        clearCache() {
+            templateCache.clear();
+            cacheHits = 0;
+            cacheMisses = 0;
+        },
+        getCacheStats() {
+            return {
+                size: templateCache.size,
+                hits: cacheHits,
+                misses: cacheMisses,
+            };
+        },
+        registerPartial(name, template) {
+            if (simpleEngine) {
+                simpleEngine.addPartial(name, template);
+            }
+        },
+        registerHelper(name, fn) {
+            if (simpleEngine) {
+                simpleEngine.addHelper(name, fn);
+            }
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Middleware
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create render middleware that adds render function to context
+ *
+ * @param templates - Template manager instance
+ * @param options - Middleware options
+ * @returns Middleware function
+ *
+ * @example
+ * const templates = createTemplateEngine({ templatesDir: './views' })
+ * app.use('*', renderMiddleware(templates))
+ *
+ * app.get('/', async (c) => {
+ *   const render = c.get('render')
+ *   return render('home', { title: 'Welcome' })
+ * })
+ */
+export function renderMiddleware(templates, options = {}) {
+    const { contextKey = 'render', contentType = 'text/html; charset=utf-8' } = options;
+    return async (c, next) => {
+        // Add render function to context
+        const render = async (name, data, layout) => {
+            const html = layout !== undefined
+                ? await templates.renderWithLayout(name, data, layout)
+                : await templates.render(name, data);
+            return new Response(html, {
+                status: 200,
+                headers: {
+                    'Content-Type': contentType,
+                },
+            });
+        };
+        c.set(contextKey, render);
+        await next();
+    };
+}
+/**
+ * Render a template directly and return Response
+ *
+ * @param templates - Template manager
+ * @param name - Template name
+ * @param data - Template data
+ * @param options - Render options
+ * @returns Response with rendered HTML
+ *
+ * @example
+ * app.get('/', (c) => {
+ *   return renderTemplate(templates, 'home', { title: 'Welcome' })
+ * })
+ */
+export async function renderTemplate(templates, name, data, options = {}) {
+    const { layout, contentType = 'text/html; charset=utf-8' } = options;
+    const html = layout !== undefined
+        ? await templates.renderWithLayout(name, data, layout)
+        : await templates.render(name, data);
+    return new Response(html, {
+        status: 200,
+        headers: {
+            'Content-Type': contentType,
+        },
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Engine Adapters
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create an EJS adapter (requires ejs package)
+ *
+ * @example
+ * import ejs from 'ejs'
+ * const templates = createTemplateEngine({
+ *   engine: createEjsAdapter(ejs),
+ * })
+ */
+export function createEjsAdapter(ejs) {
+    return {
+        name: 'ejs',
+        render: (template, data) => ejs.render(template, data),
+        renderFile: (filePath, data) => ejs.renderFile(filePath, data),
+        compile: (template) => ejs.compile(template),
+    };
+}
+/**
+ * Create a Pug adapter (requires pug package)
+ *
+ * @example
+ * import pug from 'pug'
+ * const templates = createTemplateEngine({
+ *   engine: createPugAdapter(pug),
+ *   extension: '.pug',
+ * })
+ */
+export function createPugAdapter(pug) {
+    return {
+        name: 'pug',
+        render: (template, data) => pug.render(template, data),
+        renderFile: (filePath, data) => pug.renderFile(filePath, data),
+        compile: (template) => pug.compile(template),
+    };
+}
+/**
+ * Create a Handlebars adapter (requires handlebars package)
+ *
+ * @example
+ * import Handlebars from 'handlebars'
+ * const templates = createTemplateEngine({
+ *   engine: createHandlebarsAdapter(Handlebars),
+ *   extension: '.hbs',
+ * })
+ */
+export function createHandlebarsAdapter(handlebars) {
+    return {
+        name: 'handlebars',
+        render: (template, data) => {
+            const compiled = handlebars.compile(template);
+            return compiled(data);
+        },
+        compile: (template) => {
+            const compiled = handlebars.compile(template);
+            return (data) => compiled(data);
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default {
+    createTemplateEngine,
+    renderMiddleware,
+    renderTemplate,
+    createEjsAdapter,
+    createPugAdapter,
+    createHandlebarsAdapter,
+};
+//# sourceMappingURL=templates.js.map

package/dist/http/templates.js.map

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

package/dist/http/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * HTTP Types
+ *
+ * TypeScript types for HTTP utilities, including:
+ * - StatusCode and ContentfulStatusCode
+ * - TypedResponse for typed JSON responses
+ * - HTTP method types
+ */
+import type { HeadersInit } from './web-types.js';
+/** Informational status codes (1xx) */
+export type InformationalStatusCode = 100 | 101 | 102 | 103;
+/** Successful status codes (2xx) */
+export type SuccessfulStatusCode = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226;
+/** Redirect status codes (3xx) */
+export type RedirectStatusCode = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
+/** Client error status codes (4xx) */
+export type ClientErrorStatusCode = 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451;
+/** Server error status codes (5xx) */
+export type ServerErrorStatusCode = 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+/** All HTTP status codes */
+export type StatusCode = InformationalStatusCode | SuccessfulStatusCode | RedirectStatusCode | ClientErrorStatusCode | ServerErrorStatusCode;
+/** Status codes that can have content (excludes 204, 205, 304) */
+export type ContentfulStatusCode = Exclude<StatusCode, 204 | 205 | 304>;
+/** Status codes for successful responses (2xx excl. no-content) */
+export type SuccessStatusCode = Exclude<SuccessfulStatusCode, 204 | 205>;
+/** Status codes for redirect responses */
+export type RedirectStatusCodeExact = 301 | 302 | 303 | 307 | 308;
+/**
+ * TypedResponse - Response with known data type
+ *
+ * @example
+ * function getUser(): TypedResponse<{ id: string; name: string }> {
+ *   return c.json({ id: '1', name: 'John' })
+ * }
+ */
+export interface TypedResponse<T = unknown, S extends StatusCode = StatusCode> extends Response {
+    /** The response data (available after calling json()) */
+    readonly _data: T;
+    /** The status code */
+    readonly _status: S;
+}
+/**
+ * Create a typed JSON response
+ * This is a type helper for documentation/inference purposes
+ */
+export declare function typedJson<T, S extends ContentfulStatusCode = 200>(data: T, status?: S, headers?: HeadersInit): TypedResponse<T, S>;
+/** HTTP methods */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+/** HTTP methods that typically have a request body */
+export type HttpMethodWithBody = 'POST' | 'PUT' | 'PATCH';
+/** HTTP methods that typically don't have a request body */
+export type HttpMethodWithoutBody = 'GET' | 'DELETE' | 'OPTIONS' | 'HEAD';
+import type { HttpContextInterface } from './context.js';
+/** Route handler that returns a typed response */
+export type TypedHandler<T = unknown, S extends StatusCode = StatusCode, E extends Record<string, unknown> = Record<string, unknown>> = (c: HttpContextInterface<E>) => TypedResponse<T, S> | Promise<TypedResponse<T, S>>;
+/** Middleware function */
+export type Middleware<E extends Record<string, unknown> = Record<string, unknown>> = (c: HttpContextInterface<E>, next: () => Promise<void>) => void | Response | Promise<void | Response>;
+/** Common MIME types */
+export declare const MimeTypes: {
+    readonly TEXT: "text/plain";
+    readonly HTML: "text/html";
+    readonly CSS: "text/css";
+    readonly CSV: "text/csv";
+    readonly JSON: "application/json";
+    readonly XML: "application/xml";
+    readonly JAVASCRIPT: "application/javascript";
+    readonly FORM: "application/x-www-form-urlencoded";
+    readonly OCTET_STREAM: "application/octet-stream";
+    readonly PDF: "application/pdf";
+    readonly ZIP: "application/zip";
+    readonly MULTIPART: "multipart/form-data";
+    readonly PNG: "image/png";
+    readonly JPEG: "image/jpeg";
+    readonly GIF: "image/gif";
+    readonly WEBP: "image/webp";
+    readonly SVG: "image/svg+xml";
+    readonly MP3: "audio/mpeg";
+    readonly OGG: "audio/ogg";
+    readonly WAV: "audio/wav";
+    readonly MP4: "video/mp4";
+    readonly WEBM: "video/webm";
+    readonly SSE: "text/event-stream";
+};
+export type MimeType = (typeof MimeTypes)[keyof typeof MimeTypes];
+/** Extract the data type from a TypedResponse */
+export type InferResponseData<T> = T extends TypedResponse<infer D, StatusCode> ? D : never;
+/** Extract the status code from a TypedResponse */
+export type InferResponseStatus<T> = T extends TypedResponse<unknown, infer S> ? S : never;
+/** Route path parameter type */
+export type PathParams<T extends string> = T extends `${string}:${infer P}/${infer R}` ? {
+    [K in P | keyof PathParams<R>]: string;
+} : T extends `${string}:${infer P}` ? {
+    [K in P]: string;
+} : Record<string, string>;
+/** Make all properties optional except specified ones */
+export type PartialExcept<T, K extends keyof T> = Partial<Omit<T, K>> & Pick<T, K>;
+//# sourceMappingURL=types.d.ts.map

package/dist/http/types.d.ts.map

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

package/dist/http/types.js

@@ -0,0 +1,59 @@
+/**
+ * HTTP Types
+ *
+ * TypeScript types for HTTP utilities, including:
+ * - StatusCode and ContentfulStatusCode
+ * - TypedResponse for typed JSON responses
+ * - HTTP method types
+ */
+/**
+ * Create a typed JSON response
+ * This is a type helper for documentation/inference purposes
+ */
+export function typedJson(data, status = 200, headers) {
+    const response = new Response(JSON.stringify(data), {
+        status,
+        headers: {
+            'Content-Type': 'application/json; charset=UTF-8',
+            ...Object.fromEntries(new Headers(headers)),
+        },
+    });
+    return response;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Content Types
+// ─────────────────────────────────────────────────────────────────────────────
+/** Common MIME types */
+export const MimeTypes = {
+    // Text
+    TEXT: 'text/plain',
+    HTML: 'text/html',
+    CSS: 'text/css',
+    CSV: 'text/csv',
+    // Application
+    JSON: 'application/json',
+    XML: 'application/xml',
+    JAVASCRIPT: 'application/javascript',
+    FORM: 'application/x-www-form-urlencoded',
+    OCTET_STREAM: 'application/octet-stream',
+    PDF: 'application/pdf',
+    ZIP: 'application/zip',
+    // Multipart
+    MULTIPART: 'multipart/form-data',
+    // Image
+    PNG: 'image/png',
+    JPEG: 'image/jpeg',
+    GIF: 'image/gif',
+    WEBP: 'image/webp',
+    SVG: 'image/svg+xml',
+    // Audio
+    MP3: 'audio/mpeg',
+    OGG: 'audio/ogg',
+    WAV: 'audio/wav',
+    // Video
+    MP4: 'video/mp4',
+    WEBM: 'video/webm',
+    // Event stream
+    SSE: 'text/event-stream',
+};
+//# sourceMappingURL=types.js.map

package/dist/http/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8DH;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,IAAO,EACP,SAAY,GAAQ,EACpB,OAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QAClD,MAAM;QACN,OAAO,EAAE;YACP,cAAc,EAAE,iCAAiC;YACjD,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;SAC5C;KACF,CAAC,CAAA;IACF,OAAO,QAA+B,CAAA;AACxC,CAAC;AAkCD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,wBAAwB;AACxB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO;IACP,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IAEf,cAAc;IACd,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,iBAAiB;IACtB,UAAU,EAAE,wBAAwB;IACpC,IAAI,EAAE,mCAAmC;IACzC,YAAY,EAAE,0BAA0B;IACxC,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,iBAAiB;IAEtB,YAAY;IACZ,SAAS,EAAE,qBAAqB;IAEhC,QAAQ;IACR,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,eAAe;IAEpB,QAAQ;IACR,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAEhB,QAAQ;IACR,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAElB,eAAe;IACf,GAAG,EAAE,mBAAmB;CAChB,CAAA"}