@eide/uniformgen 0.1.0

package/dist/config/types.d.ts

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+/**
+ * Configuration schema for UniformGen
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    /**
+     * API endpoint URL (base URL without /graphql path)
+     * @default 'https://api.eide.app'
+     */
+    apiUrl: z.ZodOptional<z.ZodString>;
+    /**
+     * JWT access token for internal API authentication
+     * Obtained via CLI login
+     */
+    accessToken: z.ZodString;
+    /**
+     * Project API key for public API authentication (optional, kept for backwards compatibility)
+     * Can be set via config, env var, or auto-provisioned by CLI login
+     */
+    projectKey: z.ZodOptional<z.ZodString>;
+    /**
+     * Tenant ID for API context
+     * Obtained from selected project via CLI
+     */
+    tenantId: z.ZodString;
+    /**
+     * Project ID for API context
+     * Obtained from selected project via CLI
+     */
+    projectId: z.ZodString;
+    /**
+     * Target framework for generated hooks
+     * If not set, uses the value from `uniformgen setup` (stored in ~/.uniformgen/settings.json)
+     * Falls back to 'agnostic' if neither is set
+     */
+    framework: z.ZodOptional<z.ZodEnum<["agnostic", "react", "remix"]>>;
+    /**
+     * Output paths for generated files
+     */
+    output: z.ZodOptional<z.ZodObject<{
+        types: z.ZodDefault<z.ZodString>;
+        documents: z.ZodDefault<z.ZodString>;
+        hooks: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        types: string;
+        documents: string;
+        hooks: string;
+    }, {
+        types?: string | undefined;
+        documents?: string | undefined;
+        hooks?: string | undefined;
+    }>>;
+    /**
+     * Entity model filter - only generate for specific models
+     * If not provided, generates for all models
+     */
+    only: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Include inline entity models (modes.inline = true)
+     * Required for type resolution when fields reference inline schemas
+     * @default true
+     */
+    includeInline: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Formatting options
+     */
+    prettier: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    accessToken: string;
+    tenantId: string;
+    projectId: string;
+    includeInline: boolean;
+    prettier: boolean;
+    apiUrl?: string | undefined;
+    projectKey?: string | undefined;
+    framework?: "agnostic" | "react" | "remix" | undefined;
+    output?: {
+        types: string;
+        documents: string;
+        hooks: string;
+    } | undefined;
+    only?: string[] | undefined;
+}, {
+    accessToken: string;
+    tenantId: string;
+    projectId: string;
+    apiUrl?: string | undefined;
+    projectKey?: string | undefined;
+    framework?: "agnostic" | "react" | "remix" | undefined;
+    output?: {
+        types?: string | undefined;
+        documents?: string | undefined;
+        hooks?: string | undefined;
+    } | undefined;
+    only?: string[] | undefined;
+    includeInline?: boolean | undefined;
+    prettier?: boolean | undefined;
+}>;
+export type UniformGenConfig = z.infer<typeof ConfigSchema>;
+/**
+ * User-provided configuration (partial, auth fields come from CLI)
+ */
+export interface UniformGenUserConfig {
+    /**
+     * Target framework for generated hooks
+     * @default 'agnostic'
+     */
+    framework?: 'agnostic' | 'react' | 'remix';
+    /**
+     * Output paths for generated files
+     */
+    output?: {
+        types?: string;
+        documents?: string;
+        hooks?: string;
+    };
+    /**
+     * Entity model filter - only generate for specific models
+     */
+    only?: string[];
+    /**
+     * Include inline entity models
+     * @default true
+     */
+    includeInline?: boolean;
+    /**
+     * Enable Prettier formatting
+     * @default true
+     */
+    prettier?: boolean;
+}
+/**
+ * Helper function to define configuration with type safety
+ * Use in uniformgen.config.ts
+ *
+ * @example
+ * import { defineConfig } from '@eide/uniformgen';
+ *
+ * export default defineConfig({
+ *   framework: 'remix',
+ *   output: {
+ *     types: './app/generated/types',
+ *     hooks: './app/generated/hooks',
+ *   },
+ * });
+ */
+export declare function defineConfig(config: UniformGenUserConfig): UniformGenUserConfig;
+/**
+ * Default configuration values
+ */
+export declare const defaultConfig: Partial<UniformGenConfig>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;;;;;;;;;;;;;IASH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAE3C;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAE/E;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,gBAAgB,CAUnD,CAAC"}

package/dist/config/types.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+/**
+ * Configuration schema for UniformGen
+ */
+export const ConfigSchema = z.object({
+    /**
+     * API endpoint URL (base URL without /graphql path)
+     * @default 'https://api.eide.app'
+     */
+    apiUrl: z.string().url().optional(),
+    /**
+     * JWT access token for internal API authentication
+     * Obtained via CLI login
+     */
+    accessToken: z.string().min(1, 'Access token is required'),
+    /**
+     * Project API key for public API authentication (optional, kept for backwards compatibility)
+     * Can be set via config, env var, or auto-provisioned by CLI login
+     */
+    projectKey: z.string().optional(),
+    /**
+     * Tenant ID for API context
+     * Obtained from selected project via CLI
+     */
+    tenantId: z.string().min(1, 'Tenant ID is required'),
+    /**
+     * Project ID for API context
+     * Obtained from selected project via CLI
+     */
+    projectId: z.string().min(1, 'Project ID is required'),
+    /**
+     * Target framework for generated hooks
+     * If not set, uses the value from `uniformgen setup` (stored in ~/.uniformgen/settings.json)
+     * Falls back to 'agnostic' if neither is set
+     */
+    framework: z.enum(['agnostic', 'react', 'remix']).optional(),
+    /**
+     * Output paths for generated files
+     */
+    output: z
+        .object({
+        types: z.string().default('./src/generated/types'),
+        documents: z.string().default('./src/generated/documents'),
+        hooks: z.string().default('./src/generated/hooks'),
+    })
+        .optional(),
+    /**
+     * Entity model filter - only generate for specific models
+     * If not provided, generates for all models
+     */
+    only: z.array(z.string()).optional(),
+    /**
+     * Include inline entity models (modes.inline = true)
+     * Required for type resolution when fields reference inline schemas
+     * @default true
+     */
+    includeInline: z.boolean().default(true),
+    /**
+     * Formatting options
+     */
+    prettier: z.boolean().default(true),
+});
+/**
+ * Helper function to define configuration with type safety
+ * Use in uniformgen.config.ts
+ *
+ * @example
+ * import { defineConfig } from '@eide/uniformgen';
+ *
+ * export default defineConfig({
+ *   framework: 'remix',
+ *   output: {
+ *     types: './app/generated/types',
+ *     hooks: './app/generated/hooks',
+ *   },
+ * });
+ */
+export function defineConfig(config) {
+    return config;
+}
+/**
+ * Default configuration values
+ */
+export const defaultConfig = {
+    apiUrl: 'https://api.foir.build',
+    // framework intentionally omitted - use `uniformgen setup` to configure
+    output: {
+        types: './src/generated/types',
+        documents: './src/generated/documents',
+        hooks: './src/generated/hooks',
+    },
+    includeInline: true,
+    prettier: true,
+};

package/dist/fetcher/fetch-schemas.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Metadata schema field definition
+ */
+export interface MetadataSchemaField {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object';
+    description?: string;
+    category?: string;
+    required?: boolean;
+}
+/**
+ * Metadata schema definition
+ */
+export interface MetadataSchema {
+    fields?: MetadataSchemaField[];
+}
+/**
+ * Entity model metadata
+ */
+export interface EntityModelMetadata {
+    name: string;
+    pluralName?: string;
+    description?: string;
+    category?: string;
+}
+/**
+ * Entity model from the API
+ */
+export interface EntityModel {
+    key: string;
+    name: string;
+    pluralName?: string;
+    description?: string;
+    category?: string;
+    tier: number;
+    editorMode?: string;
+    fields: FieldSchema[];
+    modes: EntityModelModes;
+    isInfrastructure?: boolean;
+    pages?: PagesConfig;
+    hooks?: EntityHooks;
+    metadataSchema?: MetadataSchema;
+}
+export interface EntityModelModes {
+    records: boolean;
+    inline: boolean;
+    publicApi: boolean;
+}
+export interface PagesConfig {
+    enabled: boolean;
+    sitemap?: {
+        changefreq?: string;
+        priority?: number;
+    };
+    defaultTemplate?: {
+        modelKey: string;
+        naturalKey: string;
+    };
+    parentModels?: Array<{
+        modelKey: string;
+        cascadeDelete?: boolean;
+    }>;
+}
+export interface HookConfig {
+    type: 'webhook' | 'queue-job' | 'expression';
+    [key: string]: unknown;
+}
+export interface EntityHooks {
+    onCreate?: HookConfig[];
+    onUpdate?: HookConfig[];
+    onDelete?: HookConfig[];
+    onPublish?: HookConfig[];
+    onUnpublish?: HookConfig[];
+}
+export interface FieldSchema {
+    key: string;
+    type: string;
+    label: string;
+    required?: boolean;
+    helpText?: string;
+    placeholder?: string;
+    defaultValue?: any;
+    options?: any;
+    validation?: ValidationRule[];
+}
+export interface ValidationRule {
+    type: string;
+    value: any;
+    message?: string;
+}
+/**
+ * Context definition from the API
+ */
+export interface ContextDefinition {
+    /** Context key (e.g., 'market', 'locale') */
+    key: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Entity model that provides values for this context */
+    entityModelKey: string;
+    /** Output keys for resolution context */
+    outputKeys: {
+        /** Key for the context value (e.g., 'market') */
+        valueKey: string;
+        /** Key for the context ID (e.g., 'marketId') */
+        idKey: string;
+    };
+}
+/**
+ * Context value (an instance of a context, e.g., a specific market)
+ */
+export interface ContextValue {
+    /** Natural key / handle */
+    naturalKey: string;
+    /** Display name */
+    name?: string;
+    /** Whether this is the primary/default value */
+    isPrimary?: boolean;
+    /** Whether this value is enabled */
+    enabled?: boolean;
+}
+/**
+ * Fetch context definitions from the API
+ */
+export declare function fetchContextDefinitions(apiUrl: string, accessToken: string, tenantId: string, projectId: string): Promise<ContextDefinition[]>;
+/**
+ * Fetch values for a specific context type
+ */
+export declare function fetchContextValues(apiUrl: string, accessToken: string, tenantId: string, projectId: string, contextModelKey: string): Promise<ContextValue[]>;
+/**
+ * Fetch entity models from the API
+ * Uses the internal GraphQL endpoint with session-based authentication
+ */
+export declare function fetchEntityModels(apiUrl: string, accessToken: string, tenantId: string, projectId: string, options?: {
+    includeInline?: boolean;
+}): Promise<EntityModel[]>;
+//# sourceMappingURL=fetch-schemas.d.ts.map

package/dist/fetcher/fetch-schemas.d.ts.map

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

package/dist/fetcher/fetch-schemas.js

@@ -0,0 +1,223 @@
+import { GraphQLClient, gql } from 'graphql-request';
+/**
+ * GraphQL query to fetch entity models
+ * Excludes system and infrastructure models
+ */
+const GET_ENTITY_MODELS = gql `
+  query GetEntityModels {
+    entityModels {
+      items {
+        id
+        key
+        metadata {
+          name
+          description
+          pluralName
+          category
+        }
+        editorMode
+        schema
+        modes
+        isSystemModel
+        isInfrastructure
+        pages {
+          enabled
+          sitemap {
+            changefreq
+            priority
+          }
+          defaultTemplate {
+            modelKey
+            naturalKey
+          }
+          parentModels {
+            modelKey
+            cascadeDelete
+          }
+        }
+        hooks
+        metadataSchema
+      }
+    }
+  }
+`;
+/**
+ * Get the internal GraphQL endpoint URL from the base API URL
+ */
+function getInternalGraphQLEndpoint(apiUrl) {
+    const base = apiUrl.replace(/\/$/, '').replace(/\/graphql$/, '');
+    return `${base}/graphql`;
+}
+/**
+ * Transform raw API response to EntityModel
+ * Flattens metadata fields to top level for convenience
+ * Extracts tier from schema (defaults to 2 if not specified)
+ * Extracts CMS config from extensions.cms (flattened structure)
+ */
+function transformEntityModel(raw) {
+    return {
+        key: raw.key,
+        name: raw.metadata.name,
+        pluralName: raw.metadata.pluralName,
+        description: raw.metadata.description,
+        category: raw.metadata.category,
+        tier: raw.schema?.tier ?? 2, // Default to tier 2 (versioned, no variants)
+        editorMode: raw.editorMode,
+        fields: raw.schema?.fields || [],
+        modes: {
+            records: raw.modes?.records ?? false,
+            inline: raw.modes?.inline ?? false,
+            publicApi: raw.modes?.publicApi ?? false,
+        },
+        isInfrastructure: raw.isInfrastructure,
+        pages: raw.extensions?.cms, // Extract CMS config from extensions (flattened)
+        hooks: raw.hooks,
+        metadataSchema: raw.metadataSchema,
+    };
+}
+/**
+ * GraphQL query to fetch context definitions
+ * Uses the variants field to access published content
+ */
+const GET_CONTEXTS = gql `
+  query GetContexts {
+    entityRecords(modelKey: "context", limit: 100) {
+      items {
+        id
+        naturalKey
+        variants(limit: 1) {
+          items {
+            publishedVersion {
+              content
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * GraphQL query to fetch context values (instances of a context type)
+ * Uses the variants field to access published content
+ */
+const GET_CONTEXT_VALUES = gql `
+  query GetContextValues($modelKey: String!) {
+    entityRecords(modelKey: $modelKey, limit: 1000) {
+      items {
+        naturalKey
+        metadata
+        variants(limit: 1) {
+          items {
+            publishedVersion {
+              content
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * Fetch context definitions from the API
+ */
+export async function fetchContextDefinitions(apiUrl, accessToken, tenantId, projectId) {
+    const client = new GraphQLClient(getInternalGraphQLEndpoint(apiUrl), {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'x-tenant-id': tenantId,
+            'x-project-id': projectId,
+        },
+    });
+    try {
+        const response = await client.request(GET_CONTEXTS);
+        return response.entityRecords.items
+            .filter((item) => item.variants?.items?.[0]?.publishedVersion?.content)
+            .map((item) => {
+            // After filter, we know variants.items[0].publishedVersion.content exists
+            const content = item.variants.items[0].publishedVersion.content;
+            return {
+                key: item.naturalKey,
+                name: item.naturalKey, // Could be enhanced with a name field
+                entityModelKey: content.entityModelKey || '',
+                outputKeys: content.outputKeys || {
+                    valueKey: item.naturalKey,
+                    idKey: `${item.naturalKey}Id`,
+                },
+            };
+        });
+    }
+    catch (error) {
+        // Contexts may not exist yet - return empty array
+        console.warn('Could not fetch context definitions:', error);
+        return [];
+    }
+}
+/**
+ * Fetch values for a specific context type
+ */
+export async function fetchContextValues(apiUrl, accessToken, tenantId, projectId, contextModelKey) {
+    const client = new GraphQLClient(getInternalGraphQLEndpoint(apiUrl), {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'x-tenant-id': tenantId,
+            'x-project-id': projectId,
+        },
+    });
+    try {
+        const response = await client.request(GET_CONTEXT_VALUES, { modelKey: contextModelKey });
+        return response.entityRecords.items.map((item) => {
+            const content = item.variants?.items?.[0]?.publishedVersion?.content;
+            return {
+                naturalKey: item.naturalKey,
+                name: content?.name ||
+                    item.metadata?.name ||
+                    item.naturalKey,
+                isPrimary: content?.isPrimary,
+                enabled: content?.enabled,
+            };
+        });
+    }
+    catch (error) {
+        console.warn(`Could not fetch values for context ${contextModelKey}:`, error);
+        return [];
+    }
+}
+/**
+ * Fetch entity models from the API
+ * Uses the internal GraphQL endpoint with session-based authentication
+ */
+export async function fetchEntityModels(apiUrl, accessToken, tenantId, projectId, options) {
+    const client = new GraphQLClient(getInternalGraphQLEndpoint(apiUrl), {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'x-tenant-id': tenantId,
+            'x-project-id': projectId,
+        },
+    });
+    try {
+        const response = await client.request(GET_ENTITY_MODELS);
+        // Filter out infrastructure models only (keep system models like design-system, template)
+        const filteredItems = response.entityModels.items.filter((item) => !item.isInfrastructure);
+        const models = filteredItems.map(transformEntityModel);
+        // Filter based on options
+        if (options?.includeInline === false) {
+            return models.filter((m) => m.modes.records);
+        }
+        return models;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            // Parse GraphQL errors
+            if ('response' in error && error.response) {
+                const gqlError = error.response;
+                if (gqlError.errors && gqlError.errors.length > 0) {
+                    const firstError = gqlError.errors[0];
+                    throw new Error(`GraphQL Error: ${firstError.message}\n` +
+                        `Code: ${firstError.extensions?.code || 'UNKNOWN'}`);
+                }
+            }
+            throw new Error(`Failed to fetch entity models: ${error.message}`);
+        }
+        throw new Error('Failed to fetch entity models: Unknown error');
+    }
+}

package/dist/fetcher/fetch-workflows.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Form field schema for workflow inputs
+ */
+export interface WorkflowFormField {
+    key: string;
+    type: string;
+    label?: string;
+    placeholder?: string;
+    required?: boolean;
+    defaultValue?: unknown;
+    helpText?: string;
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    config?: {
+        entityModel?: string;
+        displayField?: string;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        min?: number;
+        max?: number;
+    };
+}
+/**
+ * Workflow output definition
+ */
+export interface WorkflowOutput {
+    key: string;
+    type: string;
+    description?: string;
+}
+/**
+ * Workflow definition from the API
+ */
+export interface WorkflowDefinition {
+    key: string;
+    name: string;
+    description?: string;
+    /** Input configuration */
+    input: {
+        type: string;
+        schema?: WorkflowFormField[];
+    };
+    /** Workflow outputs - derived from output types */
+    outputs: WorkflowOutput[];
+}
+/**
+ * Fetch workflow definitions with API touchpoint from the API
+ */
+export declare function fetchWorkflows(apiUrl: string, accessToken: string, tenantId: string, projectId: string): Promise<WorkflowDefinition[]>;
+//# sourceMappingURL=fetch-workflows.d.ts.map

package/dist/fetcher/fetch-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-workflows.d.ts","sourceRoot":"","sources":["../../src/fetcher/fetch-workflows.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;KAC9B,CAAC;IACF,mDAAmD;IACnD,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AA2KD;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqC/B"}