polen 0.10.0-next.9 → 0.10.0

package/build/lib/graphql-document/schema-integration.d.ts.map

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

package/build/lib/graphql-document/schema-integration.js

@@ -0,0 +1,328 @@
+/**
+ * Layer 2: Schema Integration
+ *
+ * Bridge between GraphQL analysis and Polen's schema system.
+ * Resolves identifiers against the actual schema, extracts documentation,
+ * and generates reference URLs for navigation.
+ */
+import { getNamedType, isInputObjectType, isInterfaceType, isListType, isNonNullType, isObjectType, } from 'graphql';
+import { analyze } from './analysis.js';
+/**
+ * Polen's implementation of SchemaResolver
+ */
+export class PolenSchemaResolver {
+    schema;
+    routeConfig;
+    constructor(schema, routeConfig = {}) {
+        this.schema = schema;
+        this.routeConfig = routeConfig;
+    }
+    /**
+     * Resolve an identifier against the schema
+     */
+    resolveIdentifier(identifier) {
+        const basePath = this.routeConfig.basePath || `/reference`;
+        switch (identifier.kind) {
+            case `Type`:
+                return this.resolveType(identifier, basePath);
+            case `Field`:
+                return this.resolveField(identifier, basePath);
+            case `Argument`:
+                return this.resolveArgument(identifier, basePath);
+            case `Variable`:
+                // Variables don't have schema resolution
+                return {
+                    exists: true,
+                    referenceUrl: `${basePath}#variables`,
+                    documentation: {
+                        typeInfo: `Variable`,
+                        description: `Query variable: $${identifier.name}`,
+                    },
+                };
+            case `Directive`:
+                return this.resolveDirective(identifier, basePath);
+            case `Fragment`:
+                // Fragments don't have schema resolution
+                return {
+                    exists: true,
+                    referenceUrl: `${basePath}#fragments`,
+                    documentation: {
+                        typeInfo: `Fragment`,
+                        description: `Fragment: ${identifier.name}`,
+                    },
+                };
+            default:
+                return null;
+        }
+    }
+    /**
+     * Get documentation for a schema path
+     */
+    getDocumentation(schemaPath) {
+        if (schemaPath.length === 0)
+            return null;
+        const [typeName, fieldName, argName] = schemaPath;
+        if (!typeName)
+            return null;
+        const type = this.schema.getType(typeName);
+        if (!type)
+            return null;
+        // Type-level documentation
+        if (schemaPath.length === 1) {
+            return {
+                typeInfo: this.getTypeSignature(type),
+                description: type.description || undefined,
+                deprecated: `deprecationReason` in type
+                    ? {
+                        reason: type.deprecationReason,
+                    }
+                    : undefined,
+            };
+        }
+        // Field-level documentation
+        if (fieldName && schemaPath.length === 2) {
+            const field = this.getFieldFromType(type, fieldName);
+            if (!field)
+                return null;
+            return {
+                typeInfo: this.getTypeSignature(field.type),
+                description: field.description || undefined,
+                deprecated: field.deprecationReason
+                    ? {
+                        reason: field.deprecationReason,
+                    }
+                    : undefined,
+            };
+        }
+        // Argument-level documentation
+        if (fieldName && argName && schemaPath.length === 3) {
+            const field = this.getFieldFromType(type, fieldName);
+            if (!field || !(`args` in field))
+                return null;
+            const arg = field.args.find((a) => a.name === argName);
+            if (!arg)
+                return null;
+            return {
+                typeInfo: this.getTypeSignature(arg.type),
+                description: arg.description || undefined,
+                defaultValue: arg.defaultValue !== undefined
+                    ? String(arg.defaultValue)
+                    : undefined,
+            };
+        }
+        return null;
+    }
+    /**
+     * Generate a reference URL for a schema path
+     */
+    generateReferenceLink(schemaPath) {
+        const basePath = this.routeConfig.basePath || `/reference`;
+        const includeFragments = this.routeConfig.includeFragments !== false;
+        if (schemaPath.length === 0)
+            return basePath;
+        const [typeName, fieldName, argName] = schemaPath;
+        // Type reference
+        if (schemaPath.length === 1) {
+            return `${basePath}/${typeName}`;
+        }
+        // Field reference
+        if (fieldName && schemaPath.length === 2) {
+            const fragment = includeFragments ? `#${fieldName}` : ``;
+            return `${basePath}/${typeName}${fragment}`;
+        }
+        // Argument reference
+        if (fieldName && argName && schemaPath.length === 3) {
+            const fragment = includeFragments ? `#${fieldName}-${argName}` : ``;
+            return `${basePath}/${typeName}${fragment}`;
+        }
+        return `${basePath}/${typeName}`;
+    }
+    /**
+     * Check if a type exists in the schema
+     */
+    typeExists(typeName) {
+        return !!this.schema.getType(typeName);
+    }
+    /**
+     * Get all available types for validation
+     */
+    getAllTypes() {
+        return Object.keys(this.schema.getTypeMap())
+            .filter(name => !name.startsWith(`__`)); // Filter out introspection types
+    }
+    // Private helper methods
+    resolveType(identifier, basePath) {
+        const type = this.schema.getType(identifier.name);
+        return {
+            exists: !!type,
+            graphqlType: type || undefined,
+            referenceUrl: `${basePath}/${identifier.name}`,
+            documentation: type
+                ? {
+                    typeInfo: this.getTypeSignature(type),
+                    description: type.description || undefined,
+                }
+                : undefined,
+        };
+    }
+    resolveField(identifier, basePath) {
+        if (!identifier.parentType) {
+            return {
+                exists: false,
+                referenceUrl: `${basePath}#${identifier.name}`,
+            };
+        }
+        const parentType = this.schema.getType(identifier.parentType);
+        if (!parentType) {
+            return {
+                exists: false,
+                referenceUrl: `${basePath}/${identifier.parentType}#${identifier.name}`,
+            };
+        }
+        const field = this.getFieldFromType(parentType, identifier.name);
+        return {
+            exists: !!field,
+            referenceUrl: `${basePath}/${identifier.parentType}#${identifier.name}`,
+            documentation: field
+                ? {
+                    typeInfo: this.getTypeSignature(field.type),
+                    description: field.description || undefined,
+                    deprecated: field.deprecationReason
+                        ? {
+                            reason: field.deprecationReason,
+                        }
+                        : undefined,
+                }
+                : undefined,
+            deprecated: field?.deprecationReason
+                ? {
+                    reason: field.deprecationReason,
+                }
+                : undefined,
+        };
+    }
+    resolveArgument(identifier, basePath) {
+        const schemaPath = identifier.schemaPath;
+        if (schemaPath.length < 3) {
+            return {
+                exists: false,
+                referenceUrl: `${basePath}#${identifier.name}`,
+            };
+        }
+        const [typeName, fieldName] = schemaPath;
+        if (!typeName || !fieldName) {
+            return {
+                exists: false,
+                referenceUrl: `${basePath}#${identifier.name}`,
+            };
+        }
+        const parentType = this.schema.getType(typeName);
+        if (!parentType) {
+            return {
+                exists: false,
+                referenceUrl: `${basePath}/${typeName}#${fieldName}-${identifier.name}`,
+            };
+        }
+        const field = this.getFieldFromType(parentType, fieldName);
+        if (!field || !(`args` in field)) {
+            return {
+                exists: false,
+                referenceUrl: `${basePath}/${typeName}#${fieldName}-${identifier.name}`,
+            };
+        }
+        const arg = field.args.find((a) => a.name === identifier.name);
+        return {
+            exists: !!arg,
+            referenceUrl: `${basePath}/${typeName}#${fieldName}-${identifier.name}`,
+            documentation: arg
+                ? {
+                    typeInfo: this.getTypeSignature(arg.type),
+                    description: arg.description || undefined,
+                    defaultValue: arg.defaultValue !== undefined
+                        ? String(arg.defaultValue)
+                        : undefined,
+                }
+                : undefined,
+        };
+    }
+    resolveDirective(identifier, basePath) {
+        const directive = this.schema.getDirective(identifier.name);
+        return {
+            exists: !!directive,
+            referenceUrl: `${basePath}/directives#${identifier.name}`,
+            documentation: directive
+                ? {
+                    typeInfo: `Directive`,
+                    description: directive.description || undefined,
+                }
+                : undefined,
+        };
+    }
+    getFieldFromType(type, fieldName) {
+        if (isObjectType(type) || isInterfaceType(type)) {
+            return type.getFields()[fieldName] || null;
+        }
+        if (isInputObjectType(type)) {
+            return type.getFields()[fieldName] || null;
+        }
+        return null;
+    }
+    getTypeSignature(type) {
+        if (isNonNullType(type)) {
+            return `${this.getTypeSignature(type.ofType)}!`;
+        }
+        if (isListType(type)) {
+            return `[${this.getTypeSignature(type.ofType)}]`;
+        }
+        return getNamedType(type).name;
+    }
+}
+/**
+ * Create a schema resolver for Polen
+ */
+export const createPolenSchemaResolver = (schema, routeConfig) => {
+    return new PolenSchemaResolver(schema, routeConfig);
+};
+/**
+ * Perform schema-aware analysis of a GraphQL document
+ */
+export const analyzeWithSchema = (source, schema, routeConfig) => {
+    const analysis = analyze(source, {
+        schema,
+        validateAgainstSchema: true,
+        includePositions: true,
+    });
+    const resolver = createPolenSchemaResolver(schema, routeConfig);
+    const resolutions = new Map();
+    const schemaErrors = [];
+    // Resolve all identifiers against schema
+    for (const identifier of analysis.identifiers.all) {
+        const key = `${identifier.position.start}-${identifier.name}-${identifier.kind}`;
+        const resolution = resolver.resolveIdentifier(identifier);
+        if (resolution) {
+            resolutions.set(key, resolution);
+            // Add validation errors for non-existent identifiers
+            if (!resolution.exists && (identifier.kind === `Type` || identifier.kind === `Field`)) {
+                schemaErrors.push({
+                    identifier,
+                    message: `${identifier.kind} "${identifier.name}" does not exist in schema`,
+                    severity: `error`,
+                });
+            }
+            // Add deprecation warnings
+            if (resolution.deprecated) {
+                schemaErrors.push({
+                    identifier,
+                    message: `${identifier.kind} "${identifier.name}" is deprecated: ${resolution.deprecated.reason}`,
+                    severity: `warning`,
+                });
+            }
+        }
+    }
+    return {
+        analysis,
+        resolutions,
+        schemaErrors,
+    };
+};
+//# sourceMappingURL=schema-integration.js.map

package/build/lib/graphql-document/schema-integration.js.map

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

package/build/lib/graphql-document/types.d.ts

@@ -0,0 +1,117 @@
+import type { DocumentNode, GraphQLError, GraphQLSchema } from 'graphql';
+/**
+ * Represents a GraphQL identifier found in a document
+ */
+export interface Identifier {
+    /** The name of the identifier (e.g., 'User', 'name', 'id') */
+    name: string;
+    /** The kind of GraphQL construct this identifier represents */
+    kind: `Type` | `Field` | `Argument` | `Directive` | `Variable` | `Fragment`;
+    /** Position information in the source document */
+    position: {
+        /** Character offset from start of document */
+        start: number;
+        /** Character offset for end of identifier */
+        end: number;
+        /** Line number (1-based) */
+        line: number;
+        /** Column number (1-based) */
+        column: number;
+    };
+    /** The parent type name if this is a field or argument */
+    parentType?: string;
+    /** Path through the schema to this identifier (e.g., ['User', 'posts', 'title']) */
+    schemaPath: string[];
+    /** Context about where this identifier appears */
+    context: IdentifierContext;
+}
+/**
+ * Additional context about where an identifier appears in the document
+ */
+export interface IdentifierContext {
+    /** The operation type if this identifier is within an operation */
+    operationType?: `query` | `mutation` | `subscription`;
+    /** The operation name if this identifier is within a named operation */
+    operationName?: string;
+    /** Whether this identifier is in a fragment definition */
+    inFragment?: string;
+    /** The selection path leading to this identifier */
+    selectionPath: string[];
+}
+/**
+ * Map of all identifiers found in a GraphQL document
+ */
+export interface IdentifierMap {
+    /** Quick lookup by character position */
+    byPosition: Map<number, Identifier>;
+    /** Grouped by identifier kind for easy filtering */
+    byKind: Map<Identifier[`kind`], Identifier[]>;
+    /** Any validation errors found during analysis */
+    errors: AnalysisError[];
+    /** All identifiers as a flat array */
+    all: Identifier[];
+}
+/**
+ * Analysis error with context about the identifier that caused it
+ */
+export interface AnalysisError {
+    /** The identifier that caused the error (if applicable) */
+    identifier?: Identifier;
+    /** Human-readable error message */
+    message: string;
+    /** Error severity level */
+    severity: `error` | `warning` | `info`;
+    /** Position in the document where the error occurred */
+    position?: {
+        line: number;
+        column: number;
+    };
+}
+/**
+ * Result of analyzing a GraphQL document
+ */
+export interface AnalysisResult {
+    /** The parsed AST */
+    ast: DocumentNode;
+    /** Map of all identifiers found */
+    identifiers: IdentifierMap;
+    /** Whether the document parsed successfully */
+    isValid: boolean;
+    /** Any parse or validation errors */
+    errors: GraphQLError[];
+}
+/**
+ * Configuration for GraphQL document analysis
+ */
+export interface AnalysisConfig {
+    /** Whether to include position information for identifiers */
+    includePositions?: boolean;
+    /** Whether to validate against a schema (if provided) */
+    validateAgainstSchema?: boolean;
+    /** Schema to validate against */
+    schema?: GraphQLSchema;
+    /** Whether to extract fragment information */
+    includeFragments?: boolean;
+}
+/**
+ * Interface for the main GraphQL analyzer
+ */
+export interface GraphQLAnalyzer {
+    /**
+     * Parse a GraphQL document string into an AST
+     */
+    parse(source: string): DocumentNode;
+    /**
+     * Extract all identifiers from a GraphQL AST
+     */
+    extractIdentifiers(ast: DocumentNode, config?: AnalysisConfig): IdentifierMap;
+    /**
+     * Validate a GraphQL document against a schema
+     */
+    validateAgainstSchema(ast: DocumentNode, schema: GraphQLSchema): GraphQLError[];
+    /**
+     * Perform complete analysis of a GraphQL document
+     */
+    analyze(source: string, config?: AnalysisConfig): AnalysisResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/lib/graphql-document/types.d.ts.map

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

package/build/lib/graphql-document/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/lib/graphql-document/types.js.map

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

package/build/lib/graphql-schema-loader/index.d.ts

@@ -1,2 +1,2 @@
-export * as GraphqlSchemaLoader from './graphql-schema-loader.ts';
+export * as GraphqlSchemaLoader from './graphql-schema-loader.js';
 //# sourceMappingURL=index.d.ts.map

package/build/lib/graphql-schema-loader/index.js

@@ -1,2 +1,2 @@
-export * as GraphqlSchemaLoader from "./graphql-schema-loader.js";
+export * as GraphqlSchemaLoader from './graphql-schema-loader.js';
 //# sourceMappingURL=index.js.map

package/build/lib/helpers.js

@@ -5,7 +5,7 @@ import { Err, Manifest } from '@wollybeard/kit';
 export async function checkIsProjectHasPackageInstalled(projectRoot, packageName) {
     const packageJson = await Manifest.resource.read(projectRoot);
     if (Err.is(packageJson)) {
-        if (packageJson._tag === 'ResourceErrorNotFound')
+        if (packageJson._tag === `ResourceErrorNotFound`)
             return false;
         throw packageJson;
     }

package/build/lib/hono-aid/index.d.ts

@@ -1,2 +1,2 @@
-export * as HonoAid from './hono-aid.ts';
+export * as HonoAid from './hono-aid.js';
 //# sourceMappingURL=index.d.ts.map

package/build/lib/hono-aid/index.js

@@ -1,2 +1,2 @@
-export * as HonoAid from "./hono-aid.js";
+export * as HonoAid from './hono-aid.js';
 //# sourceMappingURL=index.js.map

package/build/lib/html-utils/html-transformer.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from '#dep/hono/index';
+export type HtmlTransformer = (html: string, ctx: Hono.Context) => Promise<string> | string;
+export declare const createHtmlTransformer: (value: HtmlTransformer) => HtmlTransformer;
+//# sourceMappingURL=html-transformer.d.ts.map

package/build/lib/html-utils/html-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-transformer.d.ts","sourceRoot":"","sources":["../../../src/lib/html-utils/html-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAG3C,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;AAE3F,eAAO,MAAM,qBAAqB,6CAA+B,CAAA"}

package/build/lib/html-utils/html-transformer.js

@@ -0,0 +1,3 @@
+import { Fn } from '@wollybeard/kit';
+export const createHtmlTransformer = (Fn.identity);
+//# sourceMappingURL=html-transformer.js.map

package/build/lib/html-utils/html-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-transformer.js","sourceRoot":"","sources":["../../../src/lib/html-utils/html-transformer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAIpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAA,EAAE,CAAC,QAAyB,CAAA,CAAA"}

package/build/lib/html-utils/inject-global-data.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Creates an HTML script tag that injects data into a global variable
+ *
+ * @param globalName - The name of the global variable (e.g., '__POLEN__')
+ * @param data - The data to inject (will be JSON stringified)
+ * @returns HTML script tag string ready to inject into HTML
+ *
+ * @example
+ * ```ts
+ * const script = createGlobalDataScript('__MY_APP__', { user: { id: 1, name: 'John' } })
+ * // Returns: <script>globalThis.__MY_APP__ = {"user":{"id":1,"name":"John"}};</script>
+ * ```
+ */
+export declare const createGlobalDataScript: (globalName: string, data: unknown) => string;
+/**
+ * Creates a script tag that initializes global data and runs initialization code
+ *
+ * @param globalName - The name of the global variable
+ * @param data - The data to inject
+ * @param initCode - Optional initialization code to run after setting the global
+ * @returns HTML script tag string
+ *
+ * @example
+ * ```ts
+ * const script = createGlobalDataScriptWithInit('__THEME__', { theme: 'dark' }, `
+ *   document.documentElement.className = globalThis.__THEME__.theme;
+ * `)
+ * ```
+ */
+export declare const createGlobalDataScriptWithInit: (globalName: string, data: unknown, initCode?: string) => string;
+/**
+ * Injects a global data script into the head of an HTML document
+ *
+ * @param html - The HTML document string
+ * @param globalName - The name of the global variable
+ * @param data - The data to inject
+ * @param initCode - Optional initialization code
+ * @returns Modified HTML with script injected
+ */
+export declare const injectGlobalDataIntoHTML: (html: string, globalName: string, data: unknown, initCode?: string) => string;
+//# sourceMappingURL=inject-global-data.d.ts.map

package/build/lib/html-utils/inject-global-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-global-data.d.ts","sourceRoot":"","sources":["../../../src/lib/html-utils/inject-global-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,GAAI,YAAY,MAAM,EAAE,MAAM,OAAO,KAAG,MAY1E,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,GACzC,YAAY,MAAM,EAClB,MAAM,OAAO,EACb,WAAW,MAAM,KAChB,MAUF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,MAAM,EACZ,YAAY,MAAM,EAClB,MAAM,OAAO,EACb,WAAW,MAAM,KAChB,MAOF,CAAA"}

package/build/lib/html-utils/inject-global-data.js

@@ -0,0 +1,65 @@
+/**
+ * Creates an HTML script tag that injects data into a global variable
+ *
+ * @param globalName - The name of the global variable (e.g., '__POLEN__')
+ * @param data - The data to inject (will be JSON stringified)
+ * @returns HTML script tag string ready to inject into HTML
+ *
+ * @example
+ * ```ts
+ * const script = createGlobalDataScript('__MY_APP__', { user: { id: 1, name: 'John' } })
+ * // Returns: <script>globalThis.__MY_APP__ = {"user":{"id":1,"name":"John"}};</script>
+ * ```
+ */
+export const createGlobalDataScript = (globalName, data) => {
+    // Validate global name to prevent injection attacks
+    if (!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(globalName)) {
+        throw new Error(`Invalid global variable name: ${globalName}`);
+    }
+    // JSON.stringify and then escape </script> tags to prevent XSS
+    const jsonData = JSON.stringify(data)
+        // Escape </script> to prevent breaking out of script tag
+        .replace(/<\/script>/gi, '<\\/script>');
+    return `<script>globalThis.${globalName} = ${jsonData};</script>`;
+};
+/**
+ * Creates a script tag that initializes global data and runs initialization code
+ *
+ * @param globalName - The name of the global variable
+ * @param data - The data to inject
+ * @param initCode - Optional initialization code to run after setting the global
+ * @returns HTML script tag string
+ *
+ * @example
+ * ```ts
+ * const script = createGlobalDataScriptWithInit('__THEME__', { theme: 'dark' }, `
+ *   document.documentElement.className = globalThis.__THEME__.theme;
+ * `)
+ * ```
+ */
+export const createGlobalDataScriptWithInit = (globalName, data, initCode) => {
+    const dataScript = createGlobalDataScript(globalName, data);
+    if (!initCode) {
+        return dataScript;
+    }
+    // Remove the closing </script> tag from data script and append init code
+    const scriptContent = dataScript.replace('</script>', `\n${initCode}\n</script>`);
+    return scriptContent;
+};
+/**
+ * Injects a global data script into the head of an HTML document
+ *
+ * @param html - The HTML document string
+ * @param globalName - The name of the global variable
+ * @param data - The data to inject
+ * @param initCode - Optional initialization code
+ * @returns Modified HTML with script injected
+ */
+export const injectGlobalDataIntoHTML = (html, globalName, data, initCode) => {
+    const script = initCode
+        ? createGlobalDataScriptWithInit(globalName, data, initCode)
+        : createGlobalDataScript(globalName, data);
+    // Inject at the beginning of head to ensure it runs first
+    return html.replace('<head>', `<head>\n${script}`);
+};
+//# sourceMappingURL=inject-global-data.js.map

package/build/lib/html-utils/inject-global-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-global-data.js","sourceRoot":"","sources":["../../../src/lib/html-utils/inject-global-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAkB,EAAE,IAAa,EAAU,EAAE;IAClF,oDAAoD;IACpD,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,EAAE,CAAC,CAAA;IAChE,CAAC;IAED,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QACnC,yDAAyD;SACxD,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;IAEzC,OAAO,sBAAsB,UAAU,MAAM,QAAQ,YAAY,CAAA;AACnE,CAAC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,UAAkB,EAClB,IAAa,EACb,QAAiB,EACT,EAAE;IACV,MAAM,UAAU,GAAG,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAE3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,yEAAyE;IACzE,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,QAAQ,aAAa,CAAC,CAAA;IACjF,OAAO,aAAa,CAAA;AACtB,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,IAAY,EACZ,UAAkB,EAClB,IAAa,EACb,QAAiB,EACT,EAAE;IACV,MAAM,MAAM,GAAG,QAAQ;QACrB,CAAC,CAAC,8BAA8B,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC;QAC5D,CAAC,CAAC,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAE5C,0DAA0D;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,MAAM,EAAE,CAAC,CAAA;AACpD,CAAC,CAAA"}