localwp-mcp 0.1.0

package/dist/local-doctor.js

@@ -0,0 +1,224 @@
+import { config } from "./config.js";
+import { runEnvironmentCheck } from "./environment-check.js";
+import { summarizeLogAvailability } from "./logs.js";
+export async function runLocalDoctor(selection) {
+    const diagnostics = await runEnvironmentCheck(selection, {
+        probeWpCli: true,
+        probeMysql: true,
+    });
+    const logAvailability = await summarizeLogAvailability(selection);
+    const checks = [];
+    const siteCatalogCount = Number(diagnostics.sites.ok && "count" in diagnostics.sites
+        ? diagnostics.sites.count
+        : 0);
+    const siteContext = diagnostics.siteContext.ok && "site" in diagnostics.siteContext
+        ? diagnostics.siteContext
+        : null;
+    checks.push({
+        id: "local_metadata",
+        status: diagnostics.corePaths.localAppSupportDir.readable &&
+            diagnostics.corePaths.localSitesJson.readable &&
+            diagnostics.corePaths.localSiteStatusesJson.readable
+            ? "ok"
+            : "error",
+        title: "Local metadata",
+        message: diagnostics.corePaths.localAppSupportDir.readable &&
+            diagnostics.corePaths.localSitesJson.readable &&
+            diagnostics.corePaths.localSiteStatusesJson.readable
+            ? "Local metadata files are readable."
+            : "Local metadata files are missing or unreadable. Check LOCAL_APP_SUPPORT_DIR or open Local once on this machine.",
+    });
+    checks.push({
+        id: "local_tooling",
+        status: diagnostics.tooling.ok ? "ok" : "error",
+        title: "Local tooling",
+        message: diagnostics.tooling.ok
+            ? "Local's WP-CLI and helper binaries were resolved."
+            : "Local tooling could not be resolved. Check the Local install path or LOCAL_EXTRA_RESOURCES_DIRS.",
+    });
+    checks.push({
+        id: "site_catalog",
+        status: diagnostics.sites.ok && siteCatalogCount > 0 ? "ok" : "error",
+        title: "Site catalog",
+        message: diagnostics.sites.ok && siteCatalogCount > 0
+            ? `Found ${siteCatalogCount} Local site(s).`
+            : "No Local sites were found. Create, import, or start a Local site first.",
+    });
+    if (!siteContext) {
+        checks.push({
+            id: "site_resolution",
+            status: "error",
+            title: "Site resolution",
+            message: "error" in diagnostics.siteContext
+                ? diagnostics.siteContext.error
+                : "The Local site could not be resolved.",
+        });
+    }
+    else {
+        const site = siteContext.site;
+        checks.push({
+            id: "site_status",
+            status: site.status === "running" ? "ok" : "warning",
+            title: "Site status",
+            message: site.status === "running"
+                ? `The selected site '${site.name}' is running.`
+                : `The selected site '${site.name}' is '${site.status}'. Start it in Local before using WP-CLI, MySQL, or backup tools.`,
+        });
+        checks.push({
+            id: "wp_root",
+            status: siteContext.wpRoot.readable ? "ok" : "error",
+            title: "WordPress root",
+            message: siteContext.wpRoot.readable
+                ? "The WordPress root is readable."
+                : "The WordPress root is not readable.",
+        });
+        checks.push({
+            id: "php_runtime",
+            status: siteContext.phpBinary.readable &&
+                siteContext.phpBinary.executable
+                ? "ok"
+                : "error",
+            title: "PHP runtime",
+            message: siteContext.phpBinary.readable &&
+                siteContext.phpBinary.executable
+                ? "The Local PHP runtime is available."
+                : "The Local PHP runtime is missing or not executable.",
+        });
+        checks.push({
+            id: "mysql_runtime",
+            status: siteContext.mysqlBinary.readable &&
+                siteContext.mysqlBinary.executable
+                ? "ok"
+                : "error",
+            title: "MySQL runtime",
+            message: siteContext.mysqlBinary.readable &&
+                siteContext.mysqlBinary.executable
+                ? "The Local MySQL runtime is available."
+                : "The Local MySQL runtime is missing or not executable.",
+        });
+        const mysqlConnectionOk = siteContext.mysqlConnection.mode === "socket"
+            ? Boolean(siteContext.mysqlConnection.socket?.readable)
+            : Boolean(siteContext.mysqlConnection.port);
+        checks.push({
+            id: "mysql_connection",
+            status: mysqlConnectionOk ? "ok" : "warning",
+            title: "MySQL connection",
+            message: mysqlConnectionOk
+                ? "MySQL connection details were resolved."
+                : "MySQL connection details are incomplete. Start the site in Local and check the runtime configuration.",
+        });
+        if (siteContext.wpCliProbe) {
+            checks.push({
+                id: "wp_cli_probe",
+                status: siteContext.wpCliProbe.ok ? "ok" : "error",
+                title: "WP-CLI probe",
+                message: siteContext.wpCliProbe.ok
+                    ? "WP-CLI responded successfully."
+                    : `WP-CLI probe failed: ${siteContext.wpCliProbe.error}`,
+            });
+        }
+        if (siteContext.mysqlProbe) {
+            checks.push({
+                id: "mysql_probe",
+                status: siteContext.mysqlProbe.ok ? "ok" : "error",
+                title: "MySQL probe",
+                message: siteContext.mysqlProbe.ok
+                    ? "MySQL responded successfully."
+                    : `MySQL probe failed: ${siteContext.mysqlProbe.error}`,
+            });
+        }
+    }
+    const readableSiteLogs = logAvailability.siteLogs.filter((log) => log.readable);
+    const readableGlobalLogs = logAvailability.globalLogs.filter((log) => log.readable);
+    checks.push({
+        id: "site_logs",
+        status: logAvailability.site && readableSiteLogs.length > 0 ? "ok" : "warning",
+        title: "Site logs",
+        message: logAvailability.site && readableSiteLogs.length > 0
+            ? `Found ${readableSiteLogs.length} readable site log file(s).`
+            : "No readable site logs were found for the selected site yet.",
+    });
+    checks.push({
+        id: "global_logs",
+        status: readableGlobalLogs.length > 0 ? "ok" : "warning",
+        title: "Local app logs",
+        message: readableGlobalLogs.length > 0
+            ? `Found ${readableGlobalLogs.length} readable Local app log file(s).`
+            : "No readable Local app logs were found.",
+    });
+    const overallStatus = summarizeDoctorStatus(checks);
+    return {
+        overallStatus,
+        summary: buildDoctorSummary(overallStatus),
+        accessProfile: config.profile,
+        requestedSiteId: selection.siteId || null,
+        requestedSiteName: selection.siteName || null,
+        site: siteContext ? siteContext.site : null,
+        checks,
+        nextSteps: buildNextSteps(checks),
+        logSummary: {
+            siteLogs: readableSiteLogs.map((log) => ({
+                label: log.label,
+                path: log.path,
+            })),
+            globalLogs: readableGlobalLogs.map((log) => ({
+                label: log.label,
+                path: log.path,
+            })),
+        },
+    };
+}
+export function summarizeDoctorStatus(checks) {
+    if (checks.some((check) => check.status === "error")) {
+        return "error";
+    }
+    if (checks.some((check) => check.status === "warning")) {
+        return "warning";
+    }
+    return "ok";
+}
+function buildDoctorSummary(status) {
+    if (status === "ok") {
+        return "LocalWP MCP looks healthy for this machine and site.";
+    }
+    if (status === "warning") {
+        return "LocalWP MCP is mostly working, but a few things need attention.";
+    }
+    return "LocalWP MCP found blocking problems that should be fixed before relying on the site tools.";
+}
+function buildNextSteps(checks) {
+    const steps = new Set();
+    for (const check of checks) {
+        if (check.status === "ok") {
+            continue;
+        }
+        switch (check.id) {
+            case "local_metadata":
+                steps.add("Open Local once and confirm the Local metadata directory is readable, or set LOCAL_APP_SUPPORT_DIR explicitly in the MCP config.");
+                break;
+            case "local_tooling":
+                steps.add("Confirm Local is installed correctly and, if needed, set LOCAL_EXTRA_RESOURCES_DIRS or LOCAL_WP_CLI_PHAR in the MCP config.");
+                break;
+            case "site_catalog":
+            case "site_resolution":
+                steps.add("Pass siteName or siteId in the tool call, or set LOCAL_SITE_NAME / LOCAL_SITE_ID in the MCP config.");
+                break;
+            case "site_status":
+            case "mysql_connection":
+            case "mysql_probe":
+                steps.add("Start the site in Local and rerun local_doctor or local_environment_check.");
+                break;
+            case "wp_cli_probe":
+                steps.add("Run local_logs next and check the PHP, nginx, and Local app logs for startup or bootstrap errors.");
+                break;
+            case "site_logs":
+            case "global_logs":
+                steps.add("Use local_logs to inspect available logs and confirm Local has written fresh entries on this machine.");
+                break;
+            default:
+                break;
+        }
+    }
+    return [...steps];
+}
+//# sourceMappingURL=local-doctor.js.map

package/dist/local-doctor.js.map

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

package/dist/local-sites.d.ts

@@ -0,0 +1,103 @@
+import type { LocalSite, SiteSelection } from "./types.js";
+export declare function loadLocalSites(): Promise<{
+    absolutePath: string;
+    wpRoot: string;
+    runtimeDir: string;
+    status: string;
+    id: string;
+    name: string;
+    path: string;
+    domain?: string;
+    localVersion?: string;
+    mysql?: {
+        database?: string;
+        user?: string;
+        password?: string;
+    };
+    services?: import("./types.js").LocalSiteServices;
+}[]>;
+export declare function buildSiteContext(selection: SiteSelection): Promise<{
+    site: {
+        selectionMethod: string;
+        absolutePath: string;
+        wpRoot: string;
+        runtimeDir: string;
+        status: import("./types.js").LocalSiteStatus;
+        id: string;
+        name: string;
+        path: string;
+        domain?: string;
+        localVersion?: string;
+        mysql?: {
+            database?: string;
+            user?: string;
+            password?: string;
+        };
+        services?: import("./types.js").LocalSiteServices;
+    };
+    selectionMethod: string;
+    runtimeDir: string;
+    wpRoot: string;
+    database: string;
+    phpConfigDir: string;
+    mysqlDefaultsFile: string;
+    mysqlSocket: string | null;
+    mysqlPort: number | null;
+    mysqlHost: string | null;
+    php: {
+        packageDir: string;
+        platformDirName: string;
+        binaryPath: string;
+        layout: "lightning-services";
+    } | {
+        packageDir: string;
+        platformDirName: null;
+        binaryPath: string;
+        layout: "site-binaries";
+    };
+    mysql: {
+        packageDir: string;
+        platformDirName: string;
+        binaryPath: string;
+        layout: "lightning-services";
+    } | {
+        packageDir: string;
+        platformDirName: null;
+        binaryPath: string;
+        layout: "site-binaries";
+    };
+    magickCoderModulePath: string;
+}>;
+export declare function resolveSite(selection?: SiteSelection): Promise<{
+    selectionMethod: string;
+    absolutePath: string;
+    wpRoot: string;
+    runtimeDir: string;
+    status: import("./types.js").LocalSiteStatus;
+    id: string;
+    name: string;
+    path: string;
+    domain?: string;
+    localVersion?: string;
+    mysql?: {
+        database?: string;
+        user?: string;
+        password?: string;
+    };
+    services?: import("./types.js").LocalSiteServices;
+}>;
+export declare function summarizeSite(site: LocalSite): {
+    id: string;
+    name: string;
+    status: string;
+    domain: string | undefined;
+    path: string;
+    wpRoot: string;
+    localVersion: string | undefined;
+    phpVersion: string | null;
+    mysqlVersion: string | null;
+    httpPort: number | null;
+    mysqlPort: number | null;
+};
+export declare function readJsonFile<T>(filePath: string, fallbackValue?: T): Promise<T>;
+export declare function expandHome(inputPath: string): string;

package/dist/local-sites.js

@@ -0,0 +1,234 @@
+import { readFile, readdir } from "fs/promises";
+import path from "path";
+import { config } from "./config.js";
+import { getExecutableCandidates, getLegacySiteBinariesDirs, getPlatformBinDirCandidates, } from "./platform-paths.js";
+import { assertReadable, ensureReadableDirectory, isExecutablePath, isReadablePath, } from "./process-utils.js";
+export async function loadLocalSites() {
+    const [sitesPayload, statusesPayload] = await Promise.all([
+        readJsonFile(config.localSitesJson),
+        readJsonFile(config.localSiteStatusesJson, {}),
+    ]);
+    return Object.values(sitesPayload)
+        .map((site) => ({
+        ...site,
+        absolutePath: expandHome(site.path),
+        wpRoot: path.join(expandHome(site.path), "app", "public"),
+        runtimeDir: path.join(config.localRunDir, site.id),
+        status: statusesPayload[site.id] || "unknown",
+    }))
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+export async function buildSiteContext(selection) {
+    const site = await resolveSite(selection);
+    const runtimeDir = path.join(config.localRunDir, site.id);
+    const php = await resolveServiceBinary("php", site.services?.php?.version, "php");
+    const mysql = await resolveServiceBinary("mysql", site.services?.mysql?.version, "mysql");
+    const phpConfigDir = path.join(runtimeDir, "conf", "php");
+    const mysqlDefaultsFile = path.join(runtimeDir, "conf", "mysql", "my.cnf");
+    const mysqlSocket = config.platform === "win32"
+        ? null
+        : path.join(runtimeDir, "mysql", "mysqld.sock");
+    const mysqlPort = site.services?.mysql?.ports?.MYSQL?.[0] || null;
+    const wpRoot = site.wpRoot;
+    await Promise.all([
+        ensureReadableDirectory(site.absolutePath, "Local site path is not readable"),
+        ensureReadableDirectory(wpRoot, "WordPress root is not readable"),
+        ensureReadableDirectory(phpConfigDir, "Local PHP config directory is not readable"),
+        assertReadable(mysqlDefaultsFile, "Local MySQL config file is not readable"),
+    ]);
+    return {
+        site,
+        selectionMethod: site.selectionMethod,
+        runtimeDir,
+        wpRoot,
+        database: site.mysql?.database || "local",
+        phpConfigDir,
+        mysqlDefaultsFile,
+        mysqlSocket,
+        mysqlPort,
+        mysqlHost: config.platform === "win32" ? config.defaultMysqlHost : null,
+        php,
+        mysql,
+        magickCoderModulePath: php.platformDirName
+            ? path.join(php.packageDir, "bin", php.platformDirName, "ImageMagick", "modules-Q16", "coders")
+            : "",
+    };
+}
+export async function resolveSite(selection = {}) {
+    const sites = await loadLocalSites();
+    if (sites.length === 0) {
+        throw new Error(`No LocalWP sites were found in ${config.localSitesJson}. Start by opening Local and creating or importing a site.`);
+    }
+    const explicitSite = resolveExplicitSiteSelection(sites, selection);
+    if (explicitSite) {
+        return explicitSite;
+    }
+    const envSelection = resolveExplicitSiteSelection(sites, {
+        siteId: process.env.LOCAL_SITE_ID,
+        siteName: process.env.LOCAL_SITE_NAME,
+    });
+    if (envSelection) {
+        return envSelection;
+    }
+    const cwdSelection = resolveCwdSiteSelection(sites);
+    if (cwdSelection) {
+        return cwdSelection;
+    }
+    const runningSites = sites.filter((site) => site.status === "running");
+    if (runningSites.length === 1) {
+        return { ...runningSites[0], selectionMethod: "single_running_site" };
+    }
+    if (sites.length === 1) {
+        return { ...sites[0], selectionMethod: "single_site" };
+    }
+    throw new Error("Could not safely choose a Local site. Pass 'siteName' or 'siteId' in the tool call, or set LOCAL_SITE_NAME / LOCAL_SITE_ID in the MCP config.");
+}
+export function summarizeSite(site) {
+    return {
+        id: site.id,
+        name: site.name,
+        status: site.status,
+        domain: site.domain,
+        path: site.absolutePath,
+        wpRoot: site.wpRoot,
+        localVersion: site.localVersion,
+        phpVersion: site.services?.php?.version || null,
+        mysqlVersion: site.services?.mysql?.version || null,
+        httpPort: site.services?.nginx?.ports?.HTTP?.[0] || null,
+        mysqlPort: site.services?.mysql?.ports?.MYSQL?.[0] || null,
+    };
+}
+export async function readJsonFile(filePath, fallbackValue) {
+    try {
+        const raw = await readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        if (fallbackValue !== undefined) {
+            return fallbackValue;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read JSON file '${filePath}': ${message}`);
+    }
+}
+export function expandHome(inputPath) {
+    if (inputPath === "~") {
+        return config.homeDir;
+    }
+    if (inputPath.startsWith("~/")) {
+        return path.join(config.homeDir, inputPath.slice(2));
+    }
+    return inputPath;
+}
+async function resolveServiceBinary(serviceName, serviceVersion, binaryName) {
+    if (!serviceVersion) {
+        throw new Error(`Missing ${serviceName} version in Local site metadata.`);
+    }
+    const executableCandidates = getExecutableCandidates(binaryName, config.platform);
+    const servicePackage = await resolveServicePackageDir(serviceName, serviceVersion);
+    if (servicePackage.layout === "lightning-services") {
+        const binRoot = path.join(servicePackage.packageDir, "bin");
+        const entries = await readdir(binRoot, { withFileTypes: true });
+        const platformDirs = entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+        const preferredPlatformDirs = getPlatformBinDirCandidates(config.platform, config.arch).filter((directory) => platformDirs.includes(directory));
+        const candidatePlatformDirs = [
+            ...preferredPlatformDirs,
+            ...platformDirs.filter((directory) => !preferredPlatformDirs.includes(directory)),
+        ];
+        for (const platformDirName of candidatePlatformDirs) {
+            for (const executableName of executableCandidates) {
+                const binaryPath = path.join(binRoot, platformDirName, "bin", executableName);
+                if (await isExecutablePath(binaryPath)) {
+                    return {
+                        packageDir: servicePackage.packageDir,
+                        platformDirName,
+                        binaryPath,
+                        layout: "lightning-services",
+                    };
+                }
+            }
+        }
+        throw new Error(`Could not find executable '${binaryName}' for ${serviceName} in package '${servicePackage.packageDir}'.`);
+    }
+    for (const executableName of executableCandidates) {
+        const binaryPath = path.join(servicePackage.packageDir, "bin", executableName);
+        if (await isExecutablePath(binaryPath)) {
+            return {
+                packageDir: servicePackage.packageDir,
+                platformDirName: null,
+                binaryPath,
+                layout: "site-binaries",
+            };
+        }
+    }
+    throw new Error(`Could not find executable '${binaryName}' for ${serviceName} in package '${servicePackage.packageDir}'.`);
+}
+async function resolveServicePackageDir(serviceName, serviceVersion) {
+    const currentLayoutMatches = await collectMatchingDirectories(config.localLightningServicesDirs, `${serviceName}-${serviceVersion}+`);
+    if (currentLayoutMatches.length > 0) {
+        return {
+            packageDir: currentLayoutMatches[0],
+            layout: "lightning-services",
+        };
+    }
+    const legacyLayoutMatches = await collectMatchingDirectories(getLegacySiteBinariesDirs(config.platform, config.localExtraResourcesDirs), `${serviceName}-${serviceVersion}`);
+    if (legacyLayoutMatches.length > 0) {
+        return {
+            packageDir: legacyLayoutMatches[0],
+            layout: "site-binaries",
+        };
+    }
+    throw new Error([
+        `Could not find Local ${serviceName} service package for version ${serviceVersion}.`,
+        `Checked lightning-services dirs: ${config.localLightningServicesDirs.join(", ")}`,
+        `Checked legacy site-binaries dirs: ${getLegacySiteBinariesDirs(config.platform, config.localExtraResourcesDirs).join(", ")}`,
+    ].join("\n"));
+}
+function resolveExplicitSiteSelection(sites, selection) {
+    const { siteId, siteName } = selection;
+    if (siteId) {
+        const match = sites.find((site) => site.id === siteId);
+        if (!match) {
+            throw new Error(`No Local site found for siteId '${siteId}'.`);
+        }
+        return { ...match, selectionMethod: "site_id" };
+    }
+    if (siteName) {
+        const normalizedName = siteName.trim().toLowerCase();
+        const matches = sites.filter((site) => site.name.trim().toLowerCase() === normalizedName);
+        if (matches.length === 0) {
+            throw new Error(`No Local site found for siteName '${siteName}'.`);
+        }
+        if (matches.length > 1) {
+            throw new Error(`Multiple Local sites matched siteName '${siteName}'. Use siteId instead.`);
+        }
+        return { ...matches[0], selectionMethod: "site_name" };
+    }
+    return null;
+}
+function resolveCwdSiteSelection(sites) {
+    const cwd = process.cwd();
+    const matchingSite = sites.find((site) => {
+        const sitePath = site.absolutePath;
+        return cwd === sitePath || cwd.startsWith(`${sitePath}${path.sep}`);
+    });
+    return matchingSite
+        ? { ...matchingSite, selectionMethod: "cwd_match" }
+        : null;
+}
+async function collectMatchingDirectories(directories, prefix) {
+    const matches = [];
+    for (const directory of directories) {
+        if (!(await isReadablePath(directory))) {
+            continue;
+        }
+        const entries = await readdir(directory, { withFileTypes: true });
+        matches.push(...entries
+            .filter((entry) => entry.isDirectory() && entry.name.startsWith(prefix))
+            .map((entry) => path.join(directory, entry.name)));
+    }
+    return matches.sort().reverse();
+}
+//# sourceMappingURL=local-sites.js.map

package/dist/local-sites.js.map

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

package/dist/local-tooling.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedLocalTooling } from "./types.js";
+export declare function resolveLocalTooling(): Promise<ResolvedLocalTooling>;

package/dist/local-tooling.js

@@ -0,0 +1,23 @@
+import { config } from "./config.js";
+import { filterReadableDirectories, findFirstReadablePath } from "./process-utils.js";
+let toolingPromise = null;
+export function resolveLocalTooling() {
+    if (!toolingPromise) {
+        toolingPromise = loadLocalTooling();
+    }
+    return toolingPromise;
+}
+async function loadLocalTooling() {
+    const wpCliPhar = await findFirstReadablePath(config.localWpCliPharCandidates);
+    if (!wpCliPhar) {
+        throw new Error(`Could not find wp-cli.phar. Checked: ${config.localWpCliPharCandidates.join(", ")}`);
+    }
+    const wpCliConfig = await findFirstReadablePath(config.localWpCliConfigCandidates);
+    const helperBinDirs = await filterReadableDirectories(config.localHelperBinDirCandidates);
+    return {
+        wpCliPhar,
+        wpCliConfig,
+        helperBinDirs,
+    };
+}
+//# sourceMappingURL=local-tooling.js.map

package/dist/local-tooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tooling.js","sourceRoot":"","sources":["../src/local-tooling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,IAAI,cAAc,GAAyC,IAAI,CAAC;AAEhE,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,gBAAgB,EAAE,CAAC;IACtC,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,gBAAgB;IAC7B,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAE/E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACnF,MAAM,aAAa,GAAG,MAAM,yBAAyB,CACnD,MAAM,CAAC,2BAA2B,CACnC,CAAC;IAEF,OAAO;QACL,SAAS;QACT,WAAW;QACX,aAAa;KACiB,CAAC;AACnC,CAAC"}