@zihanw/pi-forge 0.3.0 → 0.3.2

package/dist/preset-command.js

@@ -0,0 +1,232 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { isDisabledPromptStackId, promptStackPath, promptStackReadDirs } from "./loader.js";
+import { renderDiagnostics, renderPreview, showText } from "./preview.js";
+import { importSillyTavernPreset } from "./sillytavern-importer.js";
+import { migrateLegacyPromptStacks, renderMigrationReport } from "./stack-migration.js";
+import { forgeExtensionsDir, globalForgeExtensionsDir } from "./storage.js";
+export function registerPresetCommand(pi, state, deps) {
+    pi.registerCommand("preset", {
+        description: "Manage pi-forge prompt stacks: list, use, preview, validate, reload, ui",
+        getArgumentCompletions: (prefix) => {
+            const parts = prefix.trimStart().split(/\s+/);
+            if (parts.length <= 1 && !prefix.endsWith(" ")) {
+                const commands = ["list", "use", "preview", "validate", "diagnostics", "reload", "status", "import-silly", "migrate-stacks", "ui"];
+                return commands.filter((cmd) => cmd.startsWith(parts[0] ?? "")).map((cmd) => ({ value: cmd, label: cmd }));
+            }
+            const first = parts[0];
+            if (["use", "preview", "validate"].includes(first)) {
+                const fragment = parts[1] ?? "";
+                const ids = ["none", ...state.stacks.map((loaded) => loaded.stack.id)];
+                return ids.filter((id) => id.startsWith(fragment)).map((id) => ({ value: `${first} ${id}`, label: id }));
+            }
+            if (first === "ui" && parts.length <= 2) {
+                const fragment = parts[1] ?? "";
+                const subs = ["stop", "restart"];
+                return subs.filter((s) => s.startsWith(fragment)).map((s) => ({ value: `ui ${s}`, label: s }));
+            }
+            if (first === "migrate-stacks") {
+                const fragment = parts[parts.length - 1] ?? "";
+                const flags = ["--dry-run", "--overwrite", "--delete-legacy"];
+                return flags.filter((flag) => flag.startsWith(fragment)).map((flag) => ({ value: `${parts.slice(0, -1).join(" ")} ${flag}`.trim(), label: flag }));
+            }
+            return null;
+        },
+        handler: async (args, ctx) => {
+            await handlePresetCommand(state, deps, args, ctx);
+        },
+    });
+}
+async function handlePresetCommand(state, deps, args, ctx) {
+    const trimmed = args.trim();
+    const [command = "list", ...rest] = trimmed ? trimmed.split(/\s+/) : ["list"];
+    switch (command) {
+        case "list":
+        case "status":
+            await showText(ctx, "pi-forge prompt stacks", renderStackList(state, ctx));
+            return;
+        case "reload":
+            await deps.reloadStacks(ctx, deps.selectedActiveId());
+            ctx.ui.notify(`pi-forge: reloaded ${state.stacks.length} prompt stack(s).`, "info");
+            return;
+        case "ui": {
+            const sub = rest[0];
+            if (sub === "stop") {
+                await deps.stopWebEditor(ctx);
+                return;
+            }
+            await deps.openWebEditor(ctx, sub === "restart" ? "restart" : "open");
+            return;
+        }
+        case "use": {
+            const id = rest[0];
+            if (!id) {
+                ctx.ui.notify("Usage: /preset use <id|none>", "warning");
+                return;
+            }
+            if (!deps.setActive(id, ctx)) {
+                ctx.ui.notify(`Unknown prompt stack: ${id}`, "error");
+                return;
+            }
+            ctx.ui.notify(state.active ? `pi-forge: active prompt stack ${state.active.stack.id}` : "pi-forge: prompt stack disabled", "info");
+            return;
+        }
+        case "preview": {
+            const target = rest[0] ? state.stacks.find((loaded) => loaded.stack.id === rest[0]) : state.active;
+            if (!target) {
+                ctx.ui.notify(rest[0] ? `Unknown prompt stack: ${rest[0]}` : "No active prompt stack.", "warning");
+                return;
+            }
+            await showText(ctx, `pi-forge preview: ${target.stack.id}`, renderPreview(ctx, target, state.sessionVariables));
+            return;
+        }
+        case "validate": {
+            const target = rest[0] ? state.stacks.find((loaded) => loaded.stack.id === rest[0]) : state.active;
+            if (!target) {
+                ctx.ui.notify(rest[0] ? `Unknown prompt stack: ${rest[0]}` : "No active prompt stack.", "warning");
+                return;
+            }
+            await showText(ctx, `pi-forge validation: ${target.stack.id}`, renderDiagnostics(target.diagnostics));
+            return;
+        }
+        case "diagnostics": {
+            await showText(ctx, "pi-forge diagnostics", renderCurrentDiagnostics(state));
+            return;
+        }
+        case "migrate-stacks": {
+            const flags = new Set(rest);
+            const dryRun = flags.has("--dry-run");
+            if (!ctx.isProjectTrusted() && !dryRun) {
+                ctx.ui.notify("pi-forge: project is not trusted; refusing to migrate prompt stacks.", "warning");
+                return;
+            }
+            const report = migrateLegacyPromptStacks(ctx.cwd, {
+                dryRun,
+                overwrite: flags.has("--overwrite"),
+                deleteLegacy: flags.has("--delete-legacy"),
+            });
+            if (!dryRun)
+                await deps.reloadStacks(ctx, deps.selectedActiveId());
+            const changed = report.copied + report.overwritten;
+            const summary = dryRun
+                ? `pi-forge: migration dry run found ${report.files.length} legacy stack file(s).`
+                : `pi-forge: migrated ${changed} legacy stack file(s), skipped ${report.skipped}, errors ${report.errors}.`;
+            ctx.ui.notify(summary, report.errors ? "warning" : "info");
+            await showText(ctx, "pi-forge prompt-stack migration", renderMigrationReport(report));
+            return;
+        }
+        case "import-silly":
+            await handleImportSilly(state, deps, rest, ctx);
+            return;
+        default:
+            ctx.ui.notify(`Unknown /preset subcommand: ${command}`, "warning");
+            return;
+    }
+}
+async function handleImportSilly(state, deps, rest, ctx) {
+    if (!ctx.isProjectTrusted()) {
+        ctx.ui.notify("pi-forge: project is not trusted; refusing to write imported prompt stacks.", "warning");
+        return;
+    }
+    const sourcePath = rest[0];
+    if (!sourcePath) {
+        ctx.ui.notify("Usage: /preset import-silly <path> [character_id] [--dry-run] [--overwrite]", "warning");
+        return;
+    }
+    const charIdToken = rest[1]?.startsWith("--") ? undefined : rest[1];
+    const flags = new Set(rest.slice(charIdToken ? 2 : 1));
+    const dryRun = flags.has("--dry-run");
+    let overwrite = flags.has("--overwrite");
+    const resolvedPath = sourcePath.startsWith("/") ? sourcePath : join(ctx.cwd, sourcePath);
+    if (!existsSync(resolvedPath)) {
+        ctx.ui.notify(`File not found: ${resolvedPath}`, "error");
+        return;
+    }
+    const charId = charIdToken ? Number(charIdToken) : undefined;
+    if (charIdToken && (Number.isNaN(charId) || !Number.isFinite(charId))) {
+        ctx.ui.notify(`Invalid character_id: ${charIdToken}`, "error");
+        return;
+    }
+    const result = importSillyTavernPreset(resolvedPath, charId);
+    if ("error" in result) {
+        ctx.ui.notify(`pi-forge import error: ${result.error}`, "error");
+        return;
+    }
+    const existingStack = state.stacks.find((candidate) => candidate.stack.id === result.stack.id);
+    const stackPath = existingStack?.filePath ?? promptStackPath(ctx.cwd, result.stack.id);
+    const stacksDir = dirname(stackPath);
+    const reportDir = join(ctx.cwd, ".pi", "forge", "import-reports");
+    const reportPath = join(reportDir, `${result.stack.id}.md`);
+    if (dryRun) {
+        await showText(ctx, `pi-forge import dry run: ${result.stack.id}`, `Would write stack to: ${stackPath}\nWould write report to: ${reportPath}\n\n## Generated stack JSON\n\n\`\`\`json\n${JSON.stringify(result.stack, null, 2)}\n\`\`\`\n\n${result.report}`);
+        return;
+    }
+    const existingPaths = [stackPath, reportPath].filter((path) => existsSync(path));
+    if (existingPaths.length > 0 && !overwrite) {
+        if (!ctx.hasUI) {
+            ctx.ui.notify(`pi-forge: import would overwrite existing file(s): ${existingPaths.join(", ")}. Re-run with --overwrite.`, "error");
+            return;
+        }
+        overwrite = await ctx.ui.confirm("Overwrite pi-forge import output?", `These file(s) already exist:\n${existingPaths.join("\n")}\n\nOverwrite them?`);
+        if (!overwrite) {
+            ctx.ui.notify("pi-forge: import cancelled; existing files were left unchanged.", "info");
+            return;
+        }
+    }
+    if (!existsSync(stacksDir))
+        mkdirSync(stacksDir, { recursive: true });
+    writeFileSync(stackPath, JSON.stringify(result.stack, null, 2), "utf8");
+    if (!existsSync(reportDir))
+        mkdirSync(reportDir, { recursive: true });
+    writeFileSync(reportPath, result.report, "utf8");
+    await deps.reloadStacks(ctx, deps.selectedActiveId());
+    ctx.ui.notify(`pi-forge: imported ${result.stack.id} (${result.stack.items.length} items)`, "info");
+    await showText(ctx, `pi-forge import report: ${result.stack.id}`, `Stack written to: ${stackPath}\nReport written to: ${reportPath}\n\n${result.report}`);
+}
+function renderStackList(state, ctx) {
+    const lines = [
+        "Prompt stack directories:",
+        ...promptStackReadDirs(ctx.cwd).map((dir, index) => `  ${index === 0 ? "primary" : "legacy"}: ${dir}`),
+        "Forge extension directories:",
+        `  global: ${globalForgeExtensionsDir()}`,
+        `  project: ${forgeExtensionsDir(ctx.cwd)}`,
+        `Loaded forge extensions: ${state.forgeExtensionPaths.length}`,
+        `Active stack: ${state.active?.stack.id ?? "(none)"}`,
+        "",
+    ];
+    if (state.stacks.length === 0) {
+        lines.push("No prompt stacks found.", "Create .pi/forge/prompt-stacks/default.json to auto-activate a stack.");
+        return lines.join("\n");
+    }
+    for (const loaded of state.stacks) {
+        const marker = loaded === state.active ? "*" : " ";
+        const errors = loaded.diagnostics.filter((d) => d.level === "error").length;
+        const warnings = loaded.diagnostics.filter((d) => d.level === "warning").length;
+        const suffix = errors || warnings ? ` (${errors} errors, ${warnings} warnings)` : "";
+        lines.push(`${marker} ${loaded.stack.id}${loaded.stack.name ? ` \u2014 ${loaded.stack.name}` : ""}${suffix}`);
+        lines.push(`  ${loaded.filePath}`);
+    }
+    lines.push("", "Commands:", "  /preset use <id|none>", "  /preset preview [id]", "  /preset validate [id]", "  /preset diagnostics", "  /preset reload", "  /preset migrate-stacks [--dry-run] [--overwrite] [--delete-legacy]", "  /preset ui [stop|restart]");
+    return lines.join("\n");
+}
+function renderCurrentDiagnostics(state) {
+    const lines = ["# pi-forge diagnostics", ""];
+    lines.push("## Active stack load/validation diagnostics", "");
+    lines.push(state.active ? renderDiagnostics(state.active.diagnostics) : "No active prompt stack.");
+    lines.push("", "## pi-forge extension diagnostics", "");
+    lines.push(renderDiagnostics(state.forgeExtensionDiagnostics));
+    lines.push("", "## Loaded pi-forge extensions", "");
+    lines.push(state.forgeExtensionPaths.length > 0 ? state.forgeExtensionPaths.map((path) => `- ${path}`).join("\n") : "(none)");
+    lines.push("", "## Latest runtime compile diagnostics", "");
+    lines.push(renderDiagnostics(state.latestCompileDiagnostics));
+    return lines.join("\n");
+}
+export function selectedActiveId(state) {
+    if (state.active)
+        return state.active.stack.id;
+    return isDisabledPromptStackId(state.lastPersistedActiveId) ? "none" : undefined;
+}
+export function findStack(state, id) {
+    return state.stacks.find((candidate) => candidate.stack.id === id);
+}
+//# sourceMappingURL=preset-command.js.map

package/dist/preset-command.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,12 @@
+import type { BuildSystemPromptOptions, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { LoadedPromptStack, PromptStackDiagnostic, PromptVariableValue } from "./types.ts";
+import type { WebEditorPreview } from "./web-editor/index.ts";
+export declare function renderPreview(ctx: ExtensionCommandContext, target: LoadedPromptStack, sessionVariables: Record<string, PromptVariableValue>): string;
+export declare function buildPreview(ctx: ExtensionCommandContext, target: LoadedPromptStack, sessionVariables: Record<string, PromptVariableValue>, optionsOverride?: BuildSystemPromptOptions): {
+    text: string;
+    preview: WebEditorPreview;
+    diagnostics: PromptStackDiagnostic[];
+};
+export declare function renderDiagnostics(diagnostics: PromptStackDiagnostic[]): string;
+export declare function showText(ctx: ExtensionCommandContext, title: string, text: string): Promise<void>;
+//# 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":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AASzG,OAAO,KAAK,EAAwB,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,uBAAuB,CAAC;AAEvF,wBAAgB,aAAa,CAC5B,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,iBAAiB,EACzB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACnD,MAAM,CAER;AAED,wBAAgB,YAAY,CAC3B,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,iBAAiB,EACzB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACrD,eAAe,CAAC,EAAE,wBAAwB,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,qBAAqB,EAAE,CAAA;CAAE,CA0CnF;AAkJD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAG9E;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvG"}

package/dist/preview.js

@@ -0,0 +1,179 @@
+import { agentMessageToPreviewText, compileMessages, compileSystemPrompt, createPromptVariableStore, getLatestUserMessage, } from "./compiler.js";
+import { estimatePayloadTokens } from "./payload-capture.js";
+export function renderPreview(ctx, target, sessionVariables) {
+    return buildPreview(ctx, target, sessionVariables).text;
+}
+export function buildPreview(ctx, target, sessionVariables, optionsOverride) {
+    const options = optionsOverride ?? ctx.getSystemPromptOptions();
+    const sessionMessages = getPreviewSessionMessages(ctx);
+    const latestUserMessage = getLatestUserMessage(sessionMessages);
+    const previewVariables = createPromptVariableStore(sessionVariables);
+    const runtime = { options, ctx, latestUserMessage, now: new Date(), variables: previewVariables };
+    const system = compileSystemPrompt(target.stack, runtime, ctx.getSystemPrompt());
+    const messages = compileMessages(target.stack, runtime, sessionMessages);
+    const diagnostics = [...target.diagnostics, ...system.diagnostics, ...messages.diagnostics];
+    const messageSections = messages.messages.map((message, index) => {
+        const content = agentMessageToPreviewText(message);
+        const source = messages.messageSources[index];
+        return previewSection(`message-${index}`, previewMessageTitle(source, index), content, message.role);
+    });
+    const systemSection = previewSection("system", "System prompt", system.systemPrompt || "(empty)");
+    const totalChars = systemSection.chars + messageSections.reduce((sum, section) => sum + section.chars, 0);
+    const preview = {
+        stackId: target.stack.id,
+        generatedAt: new Date().toISOString(),
+        system: systemSection,
+        messages: messageSections,
+        totalChars,
+        approxTokens: estimatePayloadTokens(`${system.systemPrompt}\n${messageSections.map((section) => section.content).join("\n")}`),
+    };
+    const text = [
+        `# Prompt stack preview: ${target.stack.id}`,
+        "",
+        "## System prompt",
+        "",
+        system.systemPrompt || "(empty)",
+        "",
+        "## Message layout",
+        "",
+        renderPreviewSectionText(messageSections),
+        "",
+        "## Diagnostics",
+        "",
+        renderDiagnostics(diagnostics),
+    ].join("\n");
+    return { text, preview, diagnostics };
+}
+function getPreviewSessionMessages(ctx) {
+    const entries = getCurrentBranchEntries(ctx).map(asSessionEntry);
+    const compaction = latestCompactionEntry(entries);
+    const messages = [];
+    const appendMessage = (entry) => {
+        if (entry.type === "message" && isAgentMessage(entry.message)) {
+            messages.push(entry.message);
+            return;
+        }
+        if (entry.type === "custom_message" && typeof entry.customType === "string") {
+            messages.push({
+                role: "custom",
+                customType: entry.customType,
+                content: typeof entry.content === "string" || Array.isArray(entry.content) ? entry.content : "",
+                display: entry.display === true,
+                details: entry.details,
+                timestamp: entryTimestamp(entry),
+            });
+            return;
+        }
+        if (entry.type === "branch_summary" && typeof entry.summary === "string" && entry.summary) {
+            messages.push({
+                role: "branchSummary",
+                summary: entry.summary,
+                fromId: typeof entry.fromId === "string" ? entry.fromId : "",
+                timestamp: entryTimestamp(entry),
+            });
+        }
+    };
+    if (compaction && typeof compaction.summary === "string") {
+        messages.push({
+            role: "compactionSummary",
+            summary: compaction.summary,
+            tokensBefore: typeof compaction.tokensBefore === "number" ? compaction.tokensBefore : 0,
+            timestamp: entryTimestamp(compaction),
+        });
+        const compactionIndex = entries.findIndex((entry) => entry.type === "compaction" && entry.id === compaction.id);
+        let foundFirstKept = false;
+        for (let index = 0; index < compactionIndex; index++) {
+            const entry = entries[index];
+            if (entry.id === compaction.firstKeptEntryId)
+                foundFirstKept = true;
+            if (foundFirstKept)
+                appendMessage(entry);
+        }
+        for (let index = compactionIndex + 1; index < entries.length; index++) {
+            appendMessage(entries[index]);
+        }
+        return messages;
+    }
+    for (const entry of entries)
+        appendMessage(entry);
+    return messages;
+}
+function latestCompactionEntry(entries) {
+    for (let index = entries.length - 1; index >= 0; index--) {
+        const entry = entries[index];
+        if (entry.type === "compaction")
+            return entry;
+    }
+    return undefined;
+}
+function getCurrentBranchEntries(ctx) {
+    const leafId = ctx.sessionManager.getLeafId();
+    if (leafId === null)
+        return [];
+    const sessionManager = ctx.sessionManager;
+    return sessionManager.getBranch ? sessionManager.getBranch(leafId ?? undefined) : sessionManager.getEntries();
+}
+function asSessionEntry(value) {
+    return value && typeof value === "object" ? value : {};
+}
+function isAgentMessage(value) {
+    return !!value && typeof value === "object" && typeof value.role === "string";
+}
+function entryTimestamp(entry) {
+    if (typeof entry.timestamp === "number")
+        return entry.timestamp;
+    if (typeof entry.timestamp === "string") {
+        const timestamp = new Date(entry.timestamp).getTime();
+        if (Number.isFinite(timestamp))
+            return timestamp;
+    }
+    return Date.now();
+}
+function previewMessageTitle(source, index) {
+    if (source?.kind === "stack-item") {
+        return source.itemName?.trim() || source.itemId || `Stack item ${index + 1}`;
+    }
+    if (source?.kind === "chat-history") {
+        const label = source.itemName?.trim() || "Chat history";
+        return `${label} #${source.historyIndex ?? index + 1}`;
+    }
+    if (source?.kind === "implicit-history") {
+        return `Conversation history #${source.historyIndex ?? index + 1}`;
+    }
+    return `Message ${index + 1}`;
+}
+function renderPreviewSectionText(sections, maxChars = 8000) {
+    let text = "";
+    for (const section of sections) {
+        const role = section.role ? ` (${section.role})` : "";
+        text += `\n--- ${section.title}${role} ---\n`;
+        text += section.content;
+        text += "\n";
+        if (text.length > maxChars)
+            return `${text.slice(0, maxChars)}\n\n[preview truncated]`;
+    }
+    return text.trimStart();
+}
+function previewSection(id, title, content, role) {
+    return {
+        id,
+        title,
+        role,
+        content,
+        chars: content.length,
+        approxTokens: estimatePayloadTokens(content),
+    };
+}
+export function renderDiagnostics(diagnostics) {
+    if (diagnostics.length === 0)
+        return "No diagnostics.";
+    return diagnostics.map((d) => `${d.level.toUpperCase()}${d.itemId ? ` [${d.itemId}]` : ""}: ${d.message}`).join("\n");
+}
+export async function showText(ctx, title, text) {
+    if (ctx.hasUI) {
+        await ctx.ui.editor(title, text);
+        return;
+    }
+    console.log(text);
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

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

package/dist/regex.d.ts

@@ -0,0 +1,7 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { PromptRegexStage, PromptRegexTarget, PromptStack, PromptStackDiagnostic } from "./types.ts";
+export declare function validateRegexConfig(config: unknown): PromptStackDiagnostic[];
+export declare function applyRegexRulesToString(stack: PromptStack, text: string, stage: PromptRegexStage, target: PromptRegexTarget, diagnostics: PromptStackDiagnostic[]): string;
+export declare function applyRegexRulesToMessages(stack: PromptStack, messages: AgentMessage[], stage: PromptRegexStage, diagnostics: PromptStackDiagnostic[]): AgentMessage[];
+export declare function applyFinalizeRegexRulesToMessage(stack: PromptStack, message: AgentMessage, diagnostics: PromptStackDiagnostic[]): AgentMessage | undefined;
+//# sourceMappingURL=regex.d.ts.map

package/dist/regex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.d.ts","sourceRoot":"","sources":["../src/regex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAGX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAiCpB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,EAAE,CAwB5E;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,qBAAqB,EAAE,GAClC,MAAM,CAWR;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,qBAAqB,EAAE,GAClC,YAAY,EAAE,CAQhB;AAED,wBAAgB,gCAAgC,CAC/C,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,qBAAqB,EAAE,GAClC,YAAY,GAAG,SAAS,CAiB1B"}