@doxbrix/doxloop 0.1.0

package/dist/generator-runtime.js

@@ -0,0 +1,265 @@
+import { spawn } from 'node:child_process';
+import { createReadStream } from 'node:fs';
+import { access, readFile, stat, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { delimiter, extname, join, normalize, resolve, sep } from 'node:path';
+import { DoxloopError } from './errors.js';
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+export function resolvePublicAsset(root, directory, reference) {
+    if (!reference.startsWith('/'))
+        return undefined;
+    const base = resolve(root, directory);
+    const target = resolve(base, `.${reference}`);
+    return target === base || target.startsWith(`${base}${sep}`)
+        ? target
+        : undefined;
+}
+export async function readPackageJson(root) {
+    try {
+        return JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return {};
+        throw error;
+    }
+}
+export async function writeJsonFile(path, value) {
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+export function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+export function slugFromTitle(title) {
+    return (title
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'documentation');
+}
+export function shownHost(host) {
+    return host === '0.0.0.0' || host === '::' ? 'localhost' : host;
+}
+export function nodeBinary(root, name) {
+    return resolve(root, 'node_modules', '.bin', process.platform === 'win32' ? `${name}.cmd` : name);
+}
+export async function findExecutable(name) {
+    const path = process.env.PATH;
+    if (!path)
+        return undefined;
+    const suffixes = process.platform === 'win32'
+        ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';')
+        : [''];
+    for (const directory of path.split(delimiter)) {
+        for (const suffix of suffixes) {
+            const candidate = join(directory, `${name}${suffix.toLowerCase()}`);
+            if (await pathExists(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+export async function nodeInstallInvocation(root) {
+    const suffix = process.platform === 'win32' ? '.cmd' : '';
+    if (await pathExists(join(root, 'pnpm-lock.yaml'))) {
+        return { command: `pnpm${suffix}`, args: ['install'] };
+    }
+    if (await pathExists(join(root, 'yarn.lock'))) {
+        return { command: `yarn${suffix}`, args: ['install'] };
+    }
+    return { command: `npm${suffix}`, args: ['install'] };
+}
+export async function ensureNodeDependencies(root, binaryName, label) {
+    const binary = nodeBinary(root, binaryName);
+    if (await pathExists(binary))
+        return binary;
+    if (!(await pathExists(join(root, 'package.json')))) {
+        throw new DoxloopError(`This ${label} project has no package.json.`, 2);
+    }
+    const install = await nodeInstallInvocation(root);
+    process.stdout.write(`Installing ${label} dependencies with \`${install.command} ${install.args.join(' ')}\` (first preview only)...\n`);
+    const code = await runCommand(install.command, install.args, root);
+    if (code !== 0 || !(await pathExists(binary))) {
+        throw new DoxloopError(`${label} dependency installation did not complete. Run \`${install.command} ${install.args.join(' ')}\` in this documentation project.`, 2);
+    }
+    return binary;
+}
+export async function ensureNodeModule(root, modulePath, label) {
+    if (await pathExists(join(root, 'node_modules', ...modulePath.split('/'))))
+        return;
+    if (!(await pathExists(join(root, 'package.json')))) {
+        throw new DoxloopError(`This ${label} project has no package.json.`, 2);
+    }
+    const install = await nodeInstallInvocation(root);
+    process.stdout.write(`Installing ${label} dependencies with \`${install.command} ${install.args.join(' ')}\` (first preview only)...\n`);
+    const code = await runCommand(install.command, install.args, root);
+    if (code !== 0 ||
+        !(await pathExists(join(root, 'node_modules', ...modulePath.split('/'))))) {
+        throw new DoxloopError(`${label} dependency installation did not complete. Run \`${install.command} ${install.args.join(' ')}\` in this documentation project.`, 2);
+    }
+}
+export function venvExecutable(root, name) {
+    return join(root, '.doxloop', 'venv', process.platform === 'win32' ? 'Scripts' : 'bin', process.platform === 'win32' ? `${name}.exe` : name);
+}
+export async function ensurePythonDependencies(root, binaryName, label) {
+    const binary = venvExecutable(root, binaryName);
+    if (await pathExists(binary))
+        return binary;
+    if (!(await pathExists(join(root, 'requirements.txt')))) {
+        throw new DoxloopError(`This ${label} project has no requirements.txt.`, 2);
+    }
+    const python = process.platform === 'win32' ? 'python' : 'python3';
+    const venv = join(root, '.doxloop', 'venv');
+    process.stdout.write(`Creating .doxloop/venv and installing ${label} dependencies (first preview only)...\n`);
+    let code = await runCommand(python, ['-m', 'venv', venv], root);
+    if (code === 0) {
+        code = await runCommand(venvExecutable(root, 'python'), ['-m', 'pip', 'install', '-r', 'requirements.txt'], root);
+    }
+    if (code !== 0 || !(await pathExists(binary))) {
+        throw new DoxloopError(`${label} dependency installation did not complete. Create a Python virtual environment and run \`pip install -r requirements.txt\`.`, 2);
+    }
+    return binary;
+}
+export async function runCommand(command, args, root) {
+    return new Promise((resolveExit, reject) => {
+        const child = spawn(command, args, { cwd: root, stdio: 'inherit' });
+        child.once('error', reject);
+        child.once('exit', (code) => resolveExit(code ?? 1));
+    });
+}
+export async function runPreviewProcess(command, args, root, label, environment = process.env) {
+    const child = spawn(command, args, {
+        cwd: root,
+        env: environment,
+        stdio: 'inherit',
+    });
+    const forward = (signal) => {
+        if (!child.killed)
+            child.kill(signal);
+    };
+    const onSigint = () => forward('SIGINT');
+    const onSigterm = () => forward('SIGTERM');
+    process.once('SIGINT', onSigint);
+    process.once('SIGTERM', onSigterm);
+    try {
+        const result = await new Promise((resolveExit, reject) => {
+            child.once('error', reject);
+            child.once('exit', (code, signal) => resolveExit({ code, signal }));
+        });
+        if (result.code !== 0 && result.signal === null) {
+            throw new DoxloopError(`${label} preview exited with code ${result.code ?? 1}.`);
+        }
+    }
+    finally {
+        process.off('SIGINT', onSigint);
+        process.off('SIGTERM', onSigterm);
+    }
+}
+export async function openBrowser(url) {
+    const invocation = process.platform === 'darwin'
+        ? { command: 'open', args: [url] }
+        : process.platform === 'win32'
+            ? { command: 'cmd', args: ['/c', 'start', '', url] }
+            : { command: 'xdg-open', args: [url] };
+    await new Promise((resolveOpen) => {
+        const child = spawn(invocation.command, invocation.args, {
+            stdio: 'ignore',
+            detached: true,
+        });
+        child.once('error', () => resolveOpen());
+        child.once('spawn', () => {
+            child.unref();
+            resolveOpen();
+        });
+    });
+}
+export function requiredFileIssues(label, files, existing) {
+    return files
+        .filter((file) => !existing.has(file))
+        .map((file) => ({
+        severity: 'error',
+        code: 'missing-generator-file',
+        message: `${label} project is missing ${file}.`,
+        file,
+    }));
+}
+const CONTENT_TYPES = {
+    '.css': 'text/css; charset=utf-8',
+    '.gif': 'image/gif',
+    '.html': 'text/html; charset=utf-8',
+    '.ico': 'image/x-icon',
+    '.jpeg': 'image/jpeg',
+    '.jpg': 'image/jpeg',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+};
+export async function serveStaticDirectory(options, directory, label) {
+    const root = resolve(options.root, directory);
+    if (!(await pathExists(join(root, 'index.html')))) {
+        throw new DoxloopError(`${label} output is missing ${directory}/index.html.`, 2);
+    }
+    const server = createServer(async (request, response) => {
+        try {
+            const url = new URL(request.url ?? '/', `http://${request.headers.host ?? 'localhost'}`);
+            const decoded = decodeURIComponent(url.pathname);
+            const relativePath = normalize(decoded).replace(/^([/\\])+/, '');
+            let path = resolve(root, relativePath);
+            if (path !== root && !path.startsWith(`${root}${sep}`)) {
+                response.writeHead(403).end('Forbidden');
+                return;
+            }
+            try {
+                if ((await stat(path)).isDirectory())
+                    path = join(path, 'index.html');
+            }
+            catch {
+                if (extname(path) === '')
+                    path = join(path, 'index.html');
+            }
+            if (!(await pathExists(path))) {
+                response.writeHead(404).end('Not found');
+                return;
+            }
+            response.writeHead(200, {
+                'Content-Type': CONTENT_TYPES[extname(path).toLowerCase()] ??
+                    'application/octet-stream',
+            });
+            createReadStream(path).pipe(response);
+        }
+        catch {
+            response.writeHead(400).end('Bad request');
+        }
+    });
+    await new Promise((resolveListen, reject) => {
+        server.once('error', reject);
+        server.listen(options.port, options.host, resolveListen);
+    });
+    const url = `http://${shownHost(options.host)}:${options.port}`;
+    process.stdout.write(`Starting ${label} preview at ${url}\n`);
+    if (options.open)
+        void openBrowser(url);
+    await new Promise((resolveClose) => {
+        const close = () => {
+            server.close(() => resolveClose());
+        };
+        process.once('SIGINT', close);
+        process.once('SIGTERM', close);
+    });
+}
+//# sourceMappingURL=generator-runtime.js.map

package/dist/generator-runtime.js.map

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

package/dist/generators.d.ts

@@ -0,0 +1,21 @@
+import { type GeneratorAdapter } from './generator-api.js';
+import type { DoxloopProject, GeneratorName } from './types.js';
+export interface GeneratorCatalogEntry {
+    id: GeneratorName;
+    displayName: string;
+    packageName?: string;
+    skillName: string;
+    buildCommand?: string;
+    outputDir?: string;
+}
+export declare const GENERATOR_CATALOG: readonly GeneratorCatalogEntry[];
+export declare function generatorCatalogEntry(id: string): GeneratorCatalogEntry | undefined;
+export declare function parseGenerator(value: string | undefined): GeneratorName | undefined;
+export declare function generatorPackageName(generator: GeneratorName, configured?: string): string | undefined;
+export declare function generatorSkillName(generator: GeneratorName): string;
+export declare function loadGeneratorAdapter(root: string, projectOrGenerator: DoxloopProject | GeneratorName, configuredPackage?: string): Promise<GeneratorAdapter>;
+export declare function resolveGeneratorPackage(root: string, packageName: string): string | undefined;
+export declare function installedGeneratorEntries(root: string): Promise<Array<GeneratorCatalogEntry & {
+    installed: boolean;
+}>>;
+//# sourceMappingURL=generators.d.ts.map

package/dist/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../src/generators.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,aAAa,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,iBAAiB,EAAE,SAAS,qBAAqB,EAsFpD,CAAA;AAEV,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAOnF;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,aAAa,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,cAAc,GAAG,aAAa,EAClD,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAsC3B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAapB;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAUhE"}

package/dist/generators.js

@@ -0,0 +1,202 @@
+import { createRequire } from 'node:module';
+import { join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { DoxloopError, UsageError } from './errors.js';
+import { GENERATOR_API_VERSION, } from './generator-api.js';
+export const GENERATOR_CATALOG = [
+    {
+        id: 'doxbrix',
+        displayName: 'Doxbrix',
+        skillName: 'doxloop-doxbrix',
+    },
+    {
+        id: 'docusaurus',
+        displayName: 'Docusaurus',
+        packageName: '@doxbrix/doxloop-generator-docusaurus',
+        skillName: 'doxloop-docusaurus',
+        buildCommand: 'npm run build',
+        outputDir: 'build',
+    },
+    {
+        id: 'mkdocs',
+        displayName: 'MkDocs Material',
+        packageName: '@doxbrix/doxloop-generator-mkdocs',
+        skillName: 'doxloop-mkdocs',
+        buildCommand: 'mkdocs build --strict',
+        outputDir: 'site',
+    },
+    {
+        id: 'sphinx',
+        displayName: 'Sphinx',
+        packageName: '@doxbrix/doxloop-generator-sphinx',
+        skillName: 'doxloop-sphinx',
+        buildCommand: 'sphinx-build -W -b html docs _build/html',
+        outputDir: '_build/html',
+    },
+    {
+        id: 'hugo',
+        displayName: 'Hugo',
+        packageName: '@doxbrix/doxloop-generator-hugo',
+        skillName: 'doxloop-hugo',
+        buildCommand: 'hugo --minify',
+        outputDir: 'public',
+    },
+    {
+        id: 'vitepress',
+        displayName: 'VitePress',
+        packageName: '@doxbrix/doxloop-generator-vitepress',
+        skillName: 'doxloop-vitepress',
+        buildCommand: 'npm run docs:build',
+        outputDir: 'docs/.vitepress/dist',
+    },
+    {
+        id: 'markdoc',
+        displayName: 'Markdoc',
+        packageName: '@doxbrix/doxloop-generator-markdoc',
+        skillName: 'doxloop-markdoc',
+        buildCommand: 'npm run build',
+        outputDir: 'dist',
+    },
+    {
+        id: 'nextra',
+        displayName: 'Nextra',
+        packageName: '@doxbrix/doxloop-generator-nextra',
+        skillName: 'doxloop-nextra',
+        buildCommand: 'npm run build',
+        outputDir: 'out',
+    },
+    {
+        id: 'starlight',
+        displayName: 'Starlight',
+        packageName: '@doxbrix/doxloop-generator-starlight',
+        skillName: 'doxloop-starlight',
+        buildCommand: 'npm run build',
+        outputDir: 'dist',
+    },
+    {
+        id: 'jekyll',
+        displayName: 'Jekyll',
+        packageName: '@doxbrix/doxloop-generator-jekyll',
+        skillName: 'doxloop-jekyll',
+        buildCommand: 'bundle exec jekyll build --strict_front_matter',
+        outputDir: '_site',
+    },
+    {
+        id: 'static',
+        displayName: 'Prebuilt static HTML',
+        packageName: '@doxbrix/doxloop-generator-static',
+        skillName: 'doxloop-static',
+        buildCommand: 'npm run build',
+        outputDir: 'site',
+    },
+];
+export function generatorCatalogEntry(id) {
+    return GENERATOR_CATALOG.find((entry) => entry.id === id);
+}
+export function parseGenerator(value) {
+    if (value === undefined)
+        return undefined;
+    const entry = generatorCatalogEntry(value);
+    if (entry)
+        return entry.id;
+    throw new UsageError(`--generator must be one of: ${GENERATOR_CATALOG.map((entry) => entry.id).join(', ')}`);
+}
+export function generatorPackageName(generator, configured) {
+    return configured ?? generatorCatalogEntry(generator)?.packageName;
+}
+export function generatorSkillName(generator) {
+    return generatorCatalogEntry(generator)?.skillName ?? `doxloop-${generator}`;
+}
+export async function loadGeneratorAdapter(root, projectOrGenerator, configuredPackage) {
+    const generator = typeof projectOrGenerator === 'string'
+        ? projectOrGenerator
+        : projectOrGenerator.generator;
+    if (generator === 'doxbrix') {
+        throw new DoxloopError('Doxbrix is a built-in generator and has no external adapter.');
+    }
+    const packageName = generatorPackageName(generator, typeof projectOrGenerator === 'string'
+        ? configuredPackage
+        : projectOrGenerator.generatorPackage);
+    if (!packageName) {
+        throw new DoxloopError(`No generator package is configured for "${generator}".`, 2);
+    }
+    const resolved = resolveGeneratorPackage(root, packageName);
+    if (!resolved) {
+        throw new DoxloopError(`The ${generator} generator package is not installed.\nInstall it in the documentation project with:\n  npm install --save-dev ${packageName}`, 2);
+    }
+    let loaded;
+    try {
+        const module = (await import(pathToFileURL(resolved).href));
+        loaded = module.default;
+    }
+    catch (error) {
+        throw new DoxloopError(`Cannot load generator package ${packageName}: ${errorMessage(error)}`);
+    }
+    return validateAdapter(loaded, generator, packageName);
+}
+export function resolveGeneratorPackage(root, packageName) {
+    const attempts = [
+        createRequire(join(resolve(root), 'package.json')),
+        createRequire(import.meta.url),
+    ];
+    for (const require of attempts) {
+        try {
+            return require.resolve(packageName);
+        }
+        catch (error) {
+            if (error.code !== 'MODULE_NOT_FOUND')
+                throw error;
+        }
+    }
+    return undefined;
+}
+export async function installedGeneratorEntries(root) {
+    return Promise.all(GENERATOR_CATALOG.map(async (entry) => ({
+        ...entry,
+        installed: entry.id === 'doxbrix' ||
+            (entry.packageName !== undefined &&
+                resolveGeneratorPackage(root, entry.packageName) !== undefined),
+    })));
+}
+function validateAdapter(value, expectedId, packageName) {
+    if (!value || typeof value !== 'object') {
+        throw incompatible(packageName, 'does not export a default generator adapter');
+    }
+    const adapter = value;
+    if (adapter.apiVersion !== GENERATOR_API_VERSION) {
+        throw incompatible(packageName, `uses generator API ${String(adapter.apiVersion)}; Doxloop requires ${GENERATOR_API_VERSION}`);
+    }
+    if (adapter.id !== expectedId) {
+        throw incompatible(packageName, `registers "${String(adapter.id)}" instead of "${expectedId}"`);
+    }
+    if (adapter.packageName !== packageName ||
+        typeof adapter.displayName !== 'string' ||
+        typeof adapter.packageVersion !== 'string' ||
+        !adapter.authoring ||
+        typeof adapter.authoring.skillName !== 'string' ||
+        typeof adapter.authoring.skillDirectory !== 'string' ||
+        !adapter.project ||
+        !Array.isArray(adapter.project.pageExtensions) ||
+        !Array.isArray(adapter.project.gitignore) ||
+        (adapter.project.contentFormat !== undefined &&
+            !['markdown', 'rst', 'html'].includes(adapter.project.contentFormat)) ||
+        !adapter.build ||
+        typeof adapter.build.command !== 'string' ||
+        typeof adapter.build.outputDir !== 'string' ||
+        typeof adapter.scaffold !== 'function' ||
+        typeof adapter.preview !== 'function' ||
+        typeof adapter.validate !== 'function' ||
+        (adapter.resolveLocalAsset !== undefined &&
+            typeof adapter.resolveLocalAsset !== 'function') ||
+        (adapter.readPage !== undefined && typeof adapter.readPage !== 'function')) {
+        throw incompatible(packageName, 'does not satisfy the generator adapter contract');
+    }
+    return adapter;
+}
+function incompatible(packageName, reason) {
+    return new DoxloopError(`Generator package ${packageName} is incompatible: ${reason}.`);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=generators.js.map

package/dist/generators.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,21 @@
+import { type TocEntry } from './doxbrix-markdown.js';
+import type { DoxbrixSiteConfig } from './types.js';
+interface PreviewOptions {
+    root: string;
+    host: string;
+    port: number;
+    open: boolean;
+}
+export declare function startPreview(options: PreviewOptions): Promise<void>;
+export declare function doxbrixDocument(input: {
+    site: DoxbrixSiteConfig;
+    title: string;
+    description?: string;
+    current: string;
+    rendered: {
+        html: string;
+        toc: TocEntry[];
+    };
+}): string;
+export {};
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAYrE,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAEnB,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AA2CD,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAyHD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAA;CAC5C,GAAG,MAAM,CAqNT"}