@airframeui/build 0.2.0

package/dist/init-agents.js

@@ -0,0 +1,302 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { getFlag, hasFlag } from './theme-cli.js';
+function resolveFromCwd(cwd, specifier) {
+    if (cwd) {
+        try {
+            return createRequire(path.join(cwd, 'package.json')).resolve(specifier);
+        }
+        catch {
+            // fall through to this package
+        }
+    }
+    try {
+        return createRequire(import.meta.url).resolve(specifier);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prefer the project's `@airframeui/core/catalog`, then this package's core
+ * (same resolve order as the ESLint plugin).
+ */
+export function loadCoreCatalog(cwd) {
+    const file = resolveFromCwd(cwd, '@airframeui/core/catalog');
+    if (!file)
+        return null;
+    try {
+        const catalog = JSON.parse(fs.readFileSync(file, 'utf8'));
+        if (!Array.isArray(catalog.components))
+            return null;
+        return catalog;
+    }
+    catch {
+        return null;
+    }
+}
+function tickList(names) {
+    return names.map((name) => `\`${name}\``).join(', ');
+}
+function catalogSummary(catalog) {
+    const layouts = (catalog?.layoutRecipes ?? [])
+        .map((recipe) => recipe.baseClass)
+        .filter(Boolean);
+    const components = catalog?.components ?? [];
+    const examples = ['button', 'card', 'field']
+        .map((name) => components.find((component) => component.name === name)?.baseClass)
+        .filter((name) => Boolean(name));
+    const formControls = components
+        .filter((component) => /already width:\s*100%/i.test(`${component.description ?? ''} ${component.note ?? ''}`))
+        .map((component) => component.baseClass);
+    const naming = catalog?.classNaming;
+    const namingRules = naming?.rules && naming.rules.length > 0
+        ? naming.rules.join('; ')
+        : 'Modifiers use `af-is-*`; BEM parts use `__`; responsive uses `@`';
+    const responsiveExample = catalog?.responsive?.example ?? 'af-grid-2@md';
+    const buttonNote = components.find((component) => component.name === 'button')?.note?.trim() ??
+        'Stretch shrink-to-content patterns with `af-w-full`. There is no `af-is-block`, `af-is-full`, or `af-btn-block`.';
+    return {
+        layoutClasses: layouts.length > 0 ? tickList(layouts) : '`af-stack`, `af-inline`, `af-grid`',
+        examplePatterns: examples.length > 0 ? tickList(examples) : '`af-btn`, `af-card`, `af-field`',
+        patternCount: typeof catalog?.meta?.patternCount === 'number' ? String(catalog.meta.patternCount) : 'the',
+        namingRules,
+        responsiveExample,
+        formControls: formControls.length > 0
+            ? tickList(formControls)
+            : '`af-input`, `af-textarea`, `af-select`, `af-range`',
+        buttonNote,
+    };
+}
+export const AGENT_MARKER_START = '<!-- airframe-agents:start -->';
+export const AGENT_MARKER_END = '<!-- airframe-agents:end -->';
+export const AGENT_DOC_CANDIDATES = [
+    'AGENTS.md',
+    path.join('.cursor', 'rules', 'airframe.mdc'),
+    path.join('.claude', 'CLAUDE.md'),
+];
+export function parsePinnedCoreVersion(text) {
+    const match = text.match(/@airframeui\/core@([0-9][^`\s]*)/);
+    return match?.[1] ?? null;
+}
+export function resolveAgentTarget(raw) {
+    const value = (raw ?? 'agents').toLowerCase();
+    if (value === 'cursor' || value === 'claude' || value === 'codex' || value === 'agents') {
+        return value;
+    }
+    throw new Error(`Unknown --agent value "${raw}". Use agents | cursor | claude | codex.`);
+}
+export function defaultDocsPath(agent) {
+    switch (agent) {
+        case 'cursor':
+            return path.join('.cursor', 'rules', 'airframe.mdc');
+        case 'claude':
+            return path.join('.claude', 'CLAUDE.md');
+        case 'codex':
+        case 'agents':
+        default:
+            return 'AGENTS.md';
+    }
+}
+export function resolveCoreVersion(cwd) {
+    try {
+        const require = createRequire(path.join(cwd, 'package.json'));
+        const pkgPath = require.resolve('@airframeui/core/package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        return pkg.version ?? 'unknown';
+    }
+    catch {
+        try {
+            const pkgPath = path.join(cwd, 'node_modules', '@airframeui', 'core', 'package.json');
+            if (fs.existsSync(pkgPath)) {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+                return pkg.version ?? 'unknown';
+            }
+        }
+        catch {
+            // ignore
+        }
+        return 'unknown';
+    }
+}
+export function renderAgentDocs(options) {
+    const { coreVersion, agent } = options;
+    const summary = catalogSummary(options.catalog === undefined ? loadCoreCatalog() : options.catalog);
+    const cursorFrontmatter = agent === 'cursor'
+        ? `---
+description: Airframe UI structural rules for coding agents
+globs:
+alwaysApply: true
+---
+
+`
+        : '';
+    return `${cursorFrontmatter}${AGENT_MARKER_START}
+# Airframe — agent context
+
+Generated by \`af init --agents\` for \`@airframeui/core@${coreVersion}\`.
+Re-run after upgrading Airframe (\`npx af doctor\`, then \`npx af init --agents\`) to refresh this file.
+
+**Source of truth:** \`@airframeui/core/catalog\` (patterns + layouts) and \`@airframeui/core/classes\` (class list). Same files IntelliSense, ESLint, and Airframe MCP read. Do not invent \`af-*\` names. Do not dump the catalog into context — look up on demand.
+
+## Mission
+
+Build UI with **Airframe structure**, not utility soup and not reinvented components.
+
+Airframe is a **structural UI system**. Use it as the design system, or wrap a kit. Use as much or as little as you need.
+
+- Import CSS: \`@import '@airframeui/core/core.css';\`
+- Prefer layout recipes from the catalog: ${summary.layoutClasses}
+- Prefer patterns from the catalog (${summary.patternCount} patterns). Examples: ${summary.examplePatterns}
+- If the project has a UI kit, wrap those patterns (\`<my-button>\` is an \`af-btn\`). Do not restyle \`.ui-*\` as a second look
+- Theme with \`--af-*\` CSS variables — do not invent unknown token names. Alias existing \`--color-*\` into \`--af-*\` once
+- Semantic HTML first (\`<button>\`, \`<a>\`, \`<label>\`, real headings)
+- ${summary.namingRules}
+- Responsive example: \`${summary.responsiveExample}\`
+- ${summary.buttonNote}
+- Form controls already \`width: 100%\`: ${summary.formControls}. Do not add \`af-w-full\` there
+
+## Before writing markup
+
+1. \`search_patterns\` (MCP) or read \`@airframeui/core/catalog\` — find the pattern/layout
+2. \`get_pattern\` — classes, parts, example (dense by default; \`dense: false\` for the full class list)
+3. \`get_example\` when you need more markup samples
+4. Compose semantic HTML with those \`af-*\` classes — **do not reimplement styles**
+5. \`validate_markup\` on the result — fix unknown \`af-*\` classes before shipping
+
+If MCP is unavailable, import:
+
+- \`@airframeui/core/rules\` — authoritative rules
+- \`@airframeui/core/catalog\` — all patterns
+- \`@airframeui/core/classes\` — class reference
+- Docs: https://airframeui.com/docs/ai-rules
+
+## CLI aliases
+
+Prefer the npm script so the binary path is reliable:
+
+\`\`\`bash
+npm run af -- init --agents
+npm run af -- theme lint theme.css
+\`\`\`
+
+Or: \`npx af …\` after \`npm install -D @airframeui/build\`.
+
+## MCP (recommended)
+
+Live lookup against the same catalog. Cursor: \`.cursor/mcp.json\`. Claude Code: \`.mcp.json\`. Restart the **airframeui** server after saving.
+
+\`\`\`json
+{
+  "mcpServers": {
+    "airframeui": {
+      "command": "npx",
+      "args": ["-y", "@airframeui/mcp"]
+    }
+  }
+}
+\`\`\`
+
+Docs: https://airframeui.com/docs/mcp
+
+UI loop: \`search_patterns\` → \`get_pattern\` → \`get_example\` → compose \`af-*\` → \`validate_markup\`
+Theme loop: \`generate_theme\` / \`map_tokens\` → \`lint_theme\` until clean
+
+## Anti-patterns
+
+- Do not emit Tailwind or Bootstrap class names
+- Do not invent \`af-*\` classes that are not in \`@airframeui/core/catalog\` / \`classes\`
+- Do not dump the entire catalog into context — fetch on demand
+- Do not wrap everything in cards; use layouts for structure
+- Do not paint a second look beside Airframe (\`.ui-button\` that is not an \`af-btn\`)
+- Do not add kit layout utilities that copy the catalog layout recipes
+- Do not keep two token files (\`--color-*\` and \`--af-*\` as separate sources)
+- In product templates, do not use \`af-btn\` when \`<my-button>\` exists
+${AGENT_MARKER_END}
+`;
+}
+function ensureParentDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function upsertPackageScript(cwd) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return false;
+    const raw = fs.readFileSync(pkgPath, 'utf8');
+    const pkg = JSON.parse(raw);
+    pkg.scripts ?? (pkg.scripts = {});
+    const desired = 'node ./node_modules/@airframeui/build/dist/cli.js';
+    if (pkg.scripts['af'] === desired)
+        return false;
+    pkg.scripts['af'] = desired;
+    const indent = raw.includes('\t') ? '\t' : 2;
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + '\n', 'utf8');
+    return true;
+}
+/**
+ * Write agent bootstrap docs into the consumer project.
+ */
+export function runInitAgents(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const agent = options.agent ?? 'agents';
+    const relativePath = options.agentDocsPath ?? defaultDocsPath(agent);
+    const docsPath = path.isAbsolute(relativePath) ? relativePath : path.join(cwd, relativePath);
+    const messages = [];
+    const coreVersion = options.coreVersion ?? resolveCoreVersion(cwd);
+    const catalog = options.catalog !== undefined ? options.catalog : loadCoreCatalog(cwd);
+    const body = renderAgentDocs({ coreVersion, agent, catalog });
+    let wroteDocs = false;
+    if (fs.existsSync(docsPath) && !options.force) {
+        const existing = fs.readFileSync(docsPath, 'utf8');
+        if (existing.includes(AGENT_MARKER_START) && existing.includes(AGENT_MARKER_END)) {
+            const next = existing.replace(new RegExp(`${AGENT_MARKER_START}[\\s\\S]*?${AGENT_MARKER_END}`), body.trim());
+            fs.writeFileSync(docsPath, next.endsWith('\n') ? next : `${next}\n`, 'utf8');
+            wroteDocs = true;
+            messages.push(`Updated Airframe agent block in ${path.relative(cwd, docsPath) || docsPath}`);
+        }
+        else {
+            messages.push(`Skipped ${path.relative(cwd, docsPath) || docsPath} (exists). Re-run with --force to overwrite.`);
+        }
+    }
+    else {
+        ensureParentDir(docsPath);
+        fs.writeFileSync(docsPath, body.endsWith('\n') ? body : `${body}\n`, 'utf8');
+        wroteDocs = true;
+        messages.push(`Wrote ${path.relative(cwd, docsPath) || docsPath}`);
+    }
+    let scriptUpdated = false;
+    if (!options.noScript) {
+        scriptUpdated = upsertPackageScript(cwd);
+        if (scriptUpdated) {
+            messages.push('Added package.json script: "af" → @airframeui/build CLI');
+        }
+    }
+    if (wroteDocs || scriptUpdated) {
+        messages.push('Next: add npx -y @airframeui/mcp to .cursor/mcp.json (or .mcp.json), restart the server, then search_patterns → get_pattern → get_example → validate_markup before writing UI.');
+    }
+    return {
+        exitCode: 0,
+        docsPath,
+        wroteDocs,
+        scriptUpdated,
+        messages,
+    };
+}
+/** Parse `af init` argv after the `init` token. */
+export function parseInitArgs(args) {
+    const agents = hasFlag(args, '--agents') || hasFlag(args, '--features=agents');
+    const agentRaw = getFlag(args, '--agent');
+    const agentDocsPath = getFlag(args, '--agent-docs-path');
+    return {
+        agents,
+        agent: resolveAgentTarget(agentRaw),
+        ...(agentDocsPath ? { agentDocsPath } : {}),
+        force: hasFlag(args, '--force'),
+        noScript: hasFlag(args, '--no-script'),
+    };
+}
+//# sourceMappingURL=init-agents.js.map

package/dist/init-agents.js.map

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

package/dist/load-config.d.ts

@@ -0,0 +1,23 @@
+export type AirframeConfigFile = {
+    breakpoints?: Record<string, string>;
+    theme?: {
+        files?: string[];
+    };
+    /**
+     * Optional directory for generated CSS. Unset skips writing files.
+     * Prefer PostCSS with `@import "@airframeui/core/core.css"`.
+     */
+    outputDir?: string | false | null;
+    /** Merge listed breakpoints onto token defaults. Default true. */
+    useDefaultBreakpoints?: boolean;
+    [key: string]: unknown;
+};
+/**
+ * Load `airframe.config.js` from cwd. Missing explicit `--config` throws.
+ * No file found during default search returns `{}`.
+ */
+export declare function loadConfig(cwd: string, configPath?: string): Promise<{
+    config: AirframeConfigFile;
+    path?: string;
+}>;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../src/load-config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAClC,kEAAkE;IAClE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAeF;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAcxD"}

package/dist/load-config.js

@@ -0,0 +1,31 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+async function loadConfigFile(configPath) {
+    const ext = path.extname(configPath);
+    if (ext === '.json') {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    const configModule = (await import(pathToFileURL(configPath).href));
+    return configModule.default ?? configModule;
+}
+/**
+ * Load `airframe.config.js` from cwd. Missing explicit `--config` throws.
+ * No file found during default search returns `{}`.
+ */
+export async function loadConfig(cwd, configPath) {
+    if (configPath) {
+        const fullPath = path.isAbsolute(configPath) ? configPath : path.join(cwd, configPath);
+        if (!fs.existsSync(fullPath)) {
+            throw new Error(`Config file not found: ${fullPath}`);
+        }
+        return { config: await loadConfigFile(fullPath), path: fullPath };
+    }
+    const fullPath = path.join(cwd, 'airframe.config.js');
+    if (!fs.existsSync(fullPath)) {
+        return { config: {} };
+    }
+    return { config: await loadConfigFile(fullPath), path: fullPath };
+}
+//# sourceMappingURL=load-config.js.map

package/dist/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../src/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAezC,KAAK,UAAU,cAAc,CAAC,UAAkB;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;IACnD,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAE5C,CAAC;IACvB,OAAO,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,UAAmB;IAEnB,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACpE,CAAC"}

package/dist/postcss-plugin.d.ts

@@ -0,0 +1,47 @@
+/**
+ * PostCSS plugin for @airframeui/build
+ * Processes @af bp() / @af-apply and replaces inlined @layer af.responsive when
+ * breakpoints are customized. Writes generated CSS only when outputDir is set.
+ */
+import { type AirframeThemeConfig } from '@airframeui/theme';
+import type { Plugin } from 'postcss';
+export interface AirframeBuildOptions {
+    /** Custom breakpoints. Merged with airframe.config.js unless ignoreConfig is set. */
+    breakpoints?: Record<string, string>;
+    /**
+     * Optional directory for generated CSS (e.g. `.airframeui`).
+     * Unset, `false`, or `null` skips writing files. Prefer PostCSS with
+     * `@import "@airframeui/core/core.css"` — the plugin transforms in memory.
+     */
+    outputDir?: string | false | null;
+    /**
+     * Merge custom breakpoints on top of the token defaults (`xs`/`sm`/`lg`/…).
+     * Default `true`. Set `false` when `breakpoints` is the entire scale.
+     */
+    useDefaultBreakpoints?: boolean;
+    /** Skip airframe.config.js (CLI already loaded it, or tests). */
+    ignoreConfig?: boolean;
+    /** Config search directory. Defaults to process.cwd(). */
+    cwd?: string;
+    /**
+     * `postcss-import` options (inlined before transforms). `false` skips inlining.
+     * Default: run `postcss-import` when the file still has `@import`.
+     */
+    import?: false | Record<string, unknown>;
+}
+export declare function isOutputDirEnabled(outputDir: string | false | null | undefined): outputDir is string;
+export declare function resolveBuildOptions(options?: AirframeBuildOptions): Promise<{
+    breakpoints?: Record<string, string>;
+    useDefaultBreakpoints: boolean;
+    outputDir: string | false | null | undefined;
+    cwd: string;
+    finalBreakpoints: Record<string, string>;
+    hasCustomBreakpoints: boolean;
+    tokenConfig: AirframeThemeConfig;
+}>;
+export declare function postcssAirframe(options?: AirframeBuildOptions): Plugin;
+export declare namespace postcssAirframe {
+    var postcss: boolean;
+}
+export default postcssAirframe;
+//# sourceMappingURL=postcss-plugin.d.ts.map

package/dist/postcss-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcss-plugin.d.ts","sourceRoot":"","sources":["../src/postcss-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,SAAS,CAAC;AAQlE,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAC3C,SAAS,IAAI,MAAM,CAErB;AAMD,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,mBAAmB,CAAC;CAClC,CAAC,CA6BD;AA0GD,wBAAgB,eAAe,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAiK1E;yBAjKe,eAAe;;;AAoK/B,eAAe,eAAe,CAAC"}