@a5c-ai/extension-mux 5.0.1-staging.04ca6ab00d21

package/dist/types.d.ts

@@ -0,0 +1,204 @@
+export interface A5cPluginManifest {
+    name: string;
+    version: string;
+    description: string;
+    author: string | {
+        name: string;
+        email?: string;
+    };
+    license: string;
+    repository?: {
+        type: string;
+        url: string;
+    };
+    homepage?: string;
+    keywords?: string[];
+    hooks?: Record<string, string | boolean | null>;
+    commands?: string[] | string;
+    skills?: Array<{
+        name: string;
+        file: string;
+    }>;
+    agents?: string | string[];
+    contextFiles?: Record<string, string>;
+    targets?: Record<string, TargetOverride>;
+    extraFileSets?: Record<string, Record<string, string>>;
+    harnessInstallSurfaceExportSets?: Record<string, string[]>;
+    sdk?: {
+        package?: string;
+        cli?: string;
+        proxyPackage?: string;
+        proxyBinary?: string;
+        scope?: string;
+        envPrefix?: string;
+        stateDir?: string;
+    };
+    hookFilePattern?: string;
+    include?: string[];
+    postInstall?: string;
+    installSurface?: string;
+    installSurfaceExports?: string[];
+    hookConfig?: {
+        proxyAdapter?: boolean;
+        matchers?: Record<string, string>;
+    };
+}
+export interface TargetOverride {
+    npmPackageName?: string;
+    type?: 'typescript-build';
+    skills?: 'derive-from-commands' | Array<{
+        name: string;
+        file: string;
+    }>;
+    hooks?: Record<string, string | boolean | null>;
+    commands?: string[] | string;
+    extensionManifest?: {
+        contextFileName?: string;
+        settings?: unknown[];
+    };
+    extraFileSets?: string[];
+    extraFiles?: Record<string, string>;
+    templateVars?: Record<string, string>;
+    harnessInstallSurface?: string;
+    harnessInstallSurfaceExportSets?: string[];
+    harnessInstallSurfaceExports?: string[];
+    hookFilePattern?: string;
+    hookJsPattern?: string;
+    harnessManifest?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface Diagnostic {
+    level: 'info' | 'warning' | 'error';
+    category: 'validation' | 'compatibility' | 'compilation' | 'verification';
+    message: string;
+    component?: string;
+    target?: string;
+    source?: string;
+    suggestion?: string;
+}
+export type HookSupport = 'native' | 'emulated' | 'unsupported';
+export type CommandSupport = 'native' | 'toml' | 'derived' | 'unsupported';
+export type SkillSupport = 'native' | 'derived' | 'unsupported';
+export type AgentSupport = 'native' | 'unsupported';
+export type ContextSupport = 'native' | 'unsupported';
+export interface ComponentSupport {
+    hooks: Record<string, HookSupport>;
+    commands: CommandSupport;
+    skills: SkillSupport;
+    agents: AgentSupport;
+    context: ContextSupport;
+}
+export interface CompilationResult {
+    target: string;
+    status: 'success' | 'warning' | 'error';
+    outputDir: string;
+    emittedFiles: string[];
+    componentSupport: ComponentSupport;
+    diagnostics: Diagnostic[];
+    verificationChecklist: string[];
+}
+export interface DiffFileDifference {
+    path: string;
+    line: number;
+    compiledLine: string | null;
+    existingLine: string | null;
+}
+export interface DiffResult {
+    target: string;
+    sourceDir: string;
+    existingDir: string;
+    compilationStatus: CompilationResult['status'];
+    diagnostics: Diagnostic[];
+    status: 'match' | 'different' | 'error';
+    identical: boolean;
+    differenceCount: number;
+    onlyInCompiled: string[];
+    onlyInExisting: string[];
+    differingFiles: DiffFileDifference[];
+    ignoredExistingFiles: string[];
+}
+export interface ValidateResult {
+    valid: boolean;
+    manifest: A5cPluginManifest | null;
+    diagnostics: Diagnostic[];
+}
+export interface ResolveResult {
+    effectiveManifest: A5cPluginManifest;
+    targetProfile: TargetProfile;
+    componentSupport: ComponentSupport;
+    diagnostics: Diagnostic[];
+}
+export interface TransformedFile {
+    path: string;
+    content: string;
+    binaryContent?: Buffer;
+    executable?: boolean;
+}
+export interface TransformResult {
+    files: TransformedFile[];
+    diagnostics: Diagnostic[];
+}
+export interface EmitResult {
+    emittedFiles: string[];
+    diagnostics: Diagnostic[];
+}
+export interface VerifyResult {
+    diagnostics: Diagnostic[];
+    verificationChecklist: string[];
+}
+export type HookRegistrationFormat = string;
+export type AdapterFamily = 'shell-hook' | 'programmatic';
+export type DistributionModel = 'marketplace' | 'npm-cli' | 'both';
+export interface InstallLayoutMetadata {
+    harnessHomeRelative?: string | null;
+    pluginsDirRelative?: string | null;
+    marketplacePathRelative?: string | null;
+}
+export interface PackageMetadata {
+    moduleType?: 'commonjs' | 'module';
+    binScriptExt?: '.js' | '.cjs';
+    installLifecycle?: 'postinstall' | 'plugin-scripts' | 'none';
+    activationMessage?: 'restart' | 'codex-open-plugins';
+    extraPackageFiles?: string[];
+    extraScripts?: Record<string, string>;
+    peerDependencyPackage?: string;
+    emitCjsWrappers?: boolean;
+}
+export interface TargetComponentSupport {
+    agents: 'native' | 'unsupported';
+    context: 'native' | 'unsupported';
+}
+export interface TargetProfile {
+    name: string;
+    displayName: string;
+    adapterName: string;
+    pluginRootEnvVar: string | null;
+    supportedHooks: Map<string, string>;
+    commandFormat: 'markdown' | 'toml' | 'none';
+    skillHandling: 'native' | 'derived-from-commands' | 'none';
+    manifestFormat: 'plugin.json' | 'package.json' | 'multiple';
+    hookRegistrationFormat: HookRegistrationFormat | null;
+    hookRegistrationOutputPath: string | null;
+    hookRegistrationAliasPaths: string[];
+    harnessManifestPath: string | null;
+    requiredSurfaceFile: string | null;
+    scriptVariants: Array<'bash' | 'powershell' | 'javascript' | 'typescript'>;
+    npmPublishable: boolean;
+    npmPackageName?: string;
+    extraCapabilities?: string[];
+    adapterFamily: AdapterFamily;
+    distribution: DistributionModel;
+    pluginRootEnvVarForExtension?: string;
+    marketplacePath?: string;
+    installLayout?: InstallLayoutMetadata;
+    packageMetadata?: PackageMetadata;
+    componentSupport?: TargetComponentSupport;
+}
+export interface FrontmatterData {
+    [key: string]: unknown;
+}
+export interface ParsedFrontmatter {
+    data: FrontmatterData;
+    body: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+// Type definitions for the Unified Plugin Format (UPF) and compilation pipeline
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,42 @@
+import type { A5cPluginManifest, ParsedFrontmatter } from './types.js';
+export declare function getCommandPaths(sourceDir: string, manifest: A5cPluginManifest): string[];
+/**
+ * Parse YAML frontmatter from a markdown file.
+ * Supports both --- and +++ delimiters.
+ */
+export declare function parseFrontmatter(markdown: string): ParsedFrontmatter;
+/**
+ * Build a skill SKILL.md from a command markdown file.
+ * This mirrors the logic from scripts/plugin-command-sync-lib.cjs.
+ */
+export declare function buildSkillFromCommand(name: string, commandMarkdown: string): string;
+/**
+ * Render a skill SKILL.md file with frontmatter and body.
+ */
+export declare function renderSkillMarkdown(name: string, description: string, body: string): string;
+/**
+ * Convert Markdown command to TOML format (for Gemini).
+ * Extracts description from frontmatter and body as prompt.
+ */
+export declare function markdownToToml(commandMarkdown: string): string;
+/**
+ * Generate TOML from a simple object (flat key-value pairs).
+ */
+export declare function generateToml(obj: Record<string, string>): string;
+/**
+ * Deep merge two objects, with null deletion semantics.
+ * - Scalars: target replaces base
+ * - Objects: deep merge recursively
+ * - Arrays: target replaces base entirely
+ * - null values: delete the key
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>): T;
+/**
+ * Slugify a string to kebab-case for breakpoint IDs.
+ */
+export declare function slugify(text: string): string;
+/**
+ * Check if a value is a plain object.
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAmB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMxF,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,EAAE,CAmBV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0DpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAKnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAWhE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GACnB,CAAC,CA6CH;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E"}

package/dist/utils.js

@@ -0,0 +1,187 @@
+// Utility functions for UPF compilation
+import * as fs from 'fs';
+import * as path from 'path';
+function toOutputPath(value) {
+    return value.replace(/\\/g, '/');
+}
+export function getCommandPaths(sourceDir, manifest) {
+    if (!manifest.commands)
+        return [];
+    const commandPaths = [];
+    if (typeof manifest.commands === 'string') {
+        const commandDir = path.join(sourceDir, manifest.commands);
+        if (fs.existsSync(commandDir)) {
+            const entries = fs.readdirSync(commandDir);
+            for (const entry of entries) {
+                if (entry.endsWith('.md')) {
+                    commandPaths.push(toOutputPath(path.join(manifest.commands, entry)));
+                }
+            }
+        }
+    }
+    else {
+        commandPaths.push(...manifest.commands.map(toOutputPath));
+    }
+    return commandPaths;
+}
+/**
+ * Parse YAML frontmatter from a markdown file.
+ * Supports both --- and +++ delimiters.
+ */
+export function parseFrontmatter(markdown) {
+    const lines = markdown.split('\n');
+    if (lines.length === 0) {
+        return { data: {}, body: markdown };
+    }
+    const firstLine = lines[0].trim();
+    if (firstLine !== '---' && firstLine !== '+++') {
+        return { data: {}, body: markdown };
+    }
+    const delimiter = firstLine;
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === delimiter) {
+            endIndex = i;
+            break;
+        }
+    }
+    if (endIndex === -1) {
+        return { data: {}, body: markdown };
+    }
+    const frontmatterLines = lines.slice(1, endIndex);
+    const bodyLines = lines.slice(endIndex + 1);
+    // Simple YAML parser for frontmatter (key: value format)
+    const data = {};
+    for (const line of frontmatterLines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIndex = trimmed.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const key = trimmed.substring(0, colonIndex).trim();
+        let value = trimmed.substring(colonIndex + 1).trim();
+        // Remove quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Parse booleans and numbers
+        if (value === 'true')
+            value = true;
+        else if (value === 'false')
+            value = false;
+        else if (/^-?\d+(\.\d+)?$/.test(value))
+            value = parseFloat(value);
+        data[key] = value;
+    }
+    const body = bodyLines.join('\n').trim();
+    return { data, body };
+}
+/**
+ * Build a skill SKILL.md from a command markdown file.
+ * This mirrors the logic from scripts/plugin-command-sync-lib.cjs.
+ */
+export function buildSkillFromCommand(name, commandMarkdown) {
+    const parsed = parseFrontmatter(commandMarkdown);
+    const description = parsed.data.description || `${name} mode.`;
+    return renderSkillMarkdown(name, description, parsed.body);
+}
+/**
+ * Render a skill SKILL.md file with frontmatter and body.
+ */
+export function renderSkillMarkdown(name, description, body) {
+    const lines = [
+        '---',
+        `name: ${name}`,
+        `description: ${description}`,
+        '---',
+        '',
+        `# ${name}`,
+        '',
+        body.trim(),
+        '',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Convert Markdown command to TOML format (for Gemini).
+ * Extracts description from frontmatter and body as prompt.
+ */
+export function markdownToToml(commandMarkdown) {
+    const parsed = parseFrontmatter(commandMarkdown);
+    const description = parsed.data.description || '';
+    const prompt = parsed.body.trim();
+    return generateToml({ description, prompt });
+}
+/**
+ * Generate TOML from a simple object (flat key-value pairs).
+ */
+export function generateToml(obj) {
+    const lines = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === '')
+            continue;
+        const escaped = value.replace(/\r/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+        lines.push(`${key} = "${escaped}"`);
+    }
+    return lines.join('\n\n') + '\n';
+}
+/**
+ * Deep merge two objects, with null deletion semantics.
+ * - Scalars: target replaces base
+ * - Objects: deep merge recursively
+ * - Arrays: target replaces base entirely
+ * - null values: delete the key
+ */
+export function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        const overrideValue = override[key];
+        // null deletes the key
+        if (overrideValue === null) {
+            delete result[key];
+            continue;
+        }
+        // If override value is undefined, skip
+        if (overrideValue === undefined) {
+            continue;
+        }
+        const baseValue = result[key];
+        // If base doesn't have this key, just set it
+        if (!(key in result)) {
+            result[key] = overrideValue;
+            continue;
+        }
+        // If both are objects (not arrays), recurse
+        if (typeof baseValue === 'object' &&
+            baseValue !== null &&
+            !Array.isArray(baseValue) &&
+            typeof overrideValue === 'object' &&
+            overrideValue !== null &&
+            !Array.isArray(overrideValue)) {
+            result[key] = deepMerge(baseValue, overrideValue);
+        }
+        else {
+            // Scalars and arrays: override replaces
+            result[key] = overrideValue;
+        }
+    }
+    return result;
+}
+/**
+ * Slugify a string to kebab-case for breakpoint IDs.
+ */
+export function slugify(text) {
+    return text
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Check if a value is a plain object.
+ */
+export function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/validate.d.ts

@@ -0,0 +1,3 @@
+import type { ValidateResult } from './types.js';
+export declare function validate(sourceDir: string): ValidateResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAqB,cAAc,EAAc,MAAM,YAAY,CAAC;AAoChF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CA4K1D"}

package/dist/validate.js

@@ -0,0 +1,188 @@
+// Stage 1: VALIDATE - Validate UPF source directory
+import * as fs from 'fs';
+import * as path from 'path';
+import { validate as validateSchema } from './schema.js';
+function validateReferencedPath(sourceDir, relativePath, diagnostics, options) {
+    const fullPath = path.join(sourceDir, relativePath);
+    if (!fs.existsSync(fullPath)) {
+        diagnostics.push({
+            level: options.level ?? 'error',
+            category: 'validation',
+            message: `${options.messagePrefix}: ${relativePath}`,
+            component: options.component,
+            source: fullPath,
+        });
+        return;
+    }
+    if (!fs.statSync(fullPath).isFile()) {
+        diagnostics.push({
+            level: options.level ?? 'error',
+            category: 'validation',
+            message: `${options.messagePrefix} is not a file: ${relativePath}`,
+            component: options.component,
+            source: fullPath,
+        });
+    }
+}
+export function validate(sourceDir) {
+    const diagnostics = [];
+    // Check if sourceDir exists
+    if (!fs.existsSync(sourceDir)) {
+        diagnostics.push({
+            level: 'error',
+            category: 'validation',
+            message: `Source directory does not exist: ${sourceDir}`,
+        });
+        return { valid: false, manifest: null, diagnostics };
+    }
+    // Load plugin.json
+    const manifestPath = path.join(sourceDir, 'plugin.json');
+    if (!fs.existsSync(manifestPath)) {
+        diagnostics.push({
+            level: 'error',
+            category: 'validation',
+            message: 'Missing required file: plugin.json',
+            source: manifestPath,
+        });
+        return { valid: false, manifest: null, diagnostics };
+    }
+    let manifest;
+    try {
+        const content = fs.readFileSync(manifestPath, 'utf-8');
+        manifest = JSON.parse(content);
+    }
+    catch (error) {
+        diagnostics.push({
+            level: 'error',
+            category: 'validation',
+            message: `Failed to parse plugin.json: ${error.message}`,
+            source: manifestPath,
+        });
+        return { valid: false, manifest: null, diagnostics };
+    }
+    // Validate against schema
+    const schemaResult = validateSchema(manifest);
+    diagnostics.push(...schemaResult.diagnostics);
+    if (!schemaResult.valid) {
+        return { valid: false, manifest, diagnostics };
+    }
+    // Verify referenced files exist
+    if (manifest.hooks) {
+        for (const [hookName, handlerValue] of Object.entries(manifest.hooks)) {
+            if (handlerValue === null || handlerValue === true)
+                continue;
+            if (typeof handlerValue !== 'string')
+                continue;
+            const fullPath = path.join(sourceDir, handlerValue);
+            if (!fs.existsSync(fullPath)) {
+                diagnostics.push({
+                    level: 'error',
+                    category: 'validation',
+                    message: `Hook handler file not found: ${handlerValue}`,
+                    component: `hooks.${hookName}`,
+                    source: fullPath,
+                });
+            }
+        }
+    }
+    // Verify command files
+    if (manifest.commands) {
+        const commandPaths = typeof manifest.commands === 'string'
+            ? [manifest.commands]
+            : manifest.commands;
+        for (const cmdPath of commandPaths) {
+            const fullPath = path.join(sourceDir, cmdPath);
+            if (!fs.existsSync(fullPath)) {
+                diagnostics.push({
+                    level: 'error',
+                    category: 'validation',
+                    message: `Command file or directory not found: ${cmdPath}`,
+                    source: fullPath,
+                });
+            }
+        }
+    }
+    // Verify skill files
+    if (manifest.skills) {
+        for (const skill of manifest.skills) {
+            validateReferencedPath(sourceDir, skill.file, diagnostics, {
+                messagePrefix: 'Skill file not found',
+                component: `skills.${skill.name}`,
+            });
+        }
+    }
+    // Verify agent files
+    if (manifest.agents) {
+        const agentPaths = typeof manifest.agents === 'string'
+            ? [manifest.agents]
+            : manifest.agents;
+        for (const [index, agentPath] of agentPaths.entries()) {
+            validateReferencedPath(sourceDir, agentPath, diagnostics, {
+                messagePrefix: 'Agent file not found',
+                component: agentPaths.length === 1 ? 'agents' : `agents.${index}`,
+            });
+        }
+    }
+    // Verify context files
+    if (manifest.contextFiles) {
+        for (const [target, contextPath] of Object.entries(manifest.contextFiles)) {
+            validateReferencedPath(sourceDir, contextPath, diagnostics, {
+                messagePrefix: `Context file not found for target ${target}`,
+                component: `contextFiles.${target}`,
+            });
+        }
+    }
+    // Verify versions.json exists
+    const versionsPath = path.join(sourceDir, 'versions.json');
+    if (!fs.existsSync(versionsPath)) {
+        diagnostics.push({
+            level: 'error',
+            category: 'validation',
+            message: 'Missing required file: versions.json',
+            source: versionsPath,
+        });
+    }
+    else {
+        try {
+            const versionsContent = fs.readFileSync(versionsPath, 'utf-8');
+            const versions = JSON.parse(versionsContent);
+            if (!versions.sdkVersion) {
+                diagnostics.push({
+                    level: 'error',
+                    category: 'validation',
+                    message: 'versions.json is missing required field: sdkVersion',
+                    source: versionsPath,
+                });
+            }
+        }
+        catch (error) {
+            diagnostics.push({
+                level: 'error',
+                category: 'validation',
+                message: `Failed to parse versions.json: ${error.message}`,
+                source: versionsPath,
+            });
+        }
+    }
+    // Check for duplicate skill names
+    if (manifest.skills) {
+        const skillNames = new Set();
+        for (const skill of manifest.skills) {
+            if (skillNames.has(skill.name)) {
+                diagnostics.push({
+                    level: 'error',
+                    category: 'validation',
+                    message: `Duplicate skill name: ${skill.name}`,
+                    component: `skills.${skill.name}`,
+                });
+            }
+            skillNames.add(skill.name);
+        }
+    }
+    const hasErrors = diagnostics.some((d) => d.level === 'error');
+    return {
+        valid: !hasErrors,
+        manifest,
+        diagnostics,
+    };
+}

package/dist/verify.d.ts

@@ -0,0 +1,6 @@
+import type { VerifyResult } from './types.js';
+export interface VerifyOptions {
+    outputBaseDir?: string;
+}
+export declare function verify(outputDir: string, emittedFiles: string[], options?: VerifyOptions): VerifyResult;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwBD,wBAAgB,MAAM,CACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,GAAE,aAAkB,GAC1B,YAAY,CA2Vd"}