milieu-cli 0.1.0

package/dist/bridges/standards/openapi.js

@@ -0,0 +1,424 @@
+import { httpGet } from "../../utils/http-client.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Spec paths -- expect raw JSON/YAML */
+const SPEC_PATHS = [
+    "/openapi.json",
+    "/swagger.json",
+    "/api-docs",
+    "/v3/api-docs",
+    "/v2/api-docs",
+    "/swagger/v1/swagger.json",
+    "/api/openapi.json",
+    "/api/swagger.json",
+    "/.well-known/openapi.json",
+    "/openapi.yaml",
+    "/api/v1/openapi.json",
+    "/api/v1/swagger.json",
+    "/v3/api-docs.yaml",
+    "/v2/swagger.json",
+    "/api/v2/openapi.json",
+    "/api/v3/openapi.json",
+    "/spec.json",
+];
+/** Doc UI paths -- expect HTML with embedded spec URL */
+const DOC_UI_PATHS = [
+    "/",
+    "/swagger-ui.html",
+    "/swagger-ui/",
+    "/docs",
+    "/redoc",
+    "/api/docs",
+    "/documentation",
+];
+/** All paths combined */
+const ALL_PATHS = [...SPEC_PATHS, ...DOC_UI_PATHS];
+const HTML_TYPES = new Set(["text/html", "application/xhtml+xml"]);
+const JSON_TYPES = new Set([
+    "application/json",
+    "application/vnd.oai.openapi+json",
+]);
+const YAML_TYPES = new Set([
+    "application/yaml",
+    "text/yaml",
+    "application/x-yaml",
+    "application/vnd.oai.openapi",
+]);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Extract the media type portion of a Content-Type header (before ;) */
+function mediaType(headers) {
+    return (headers["content-type"] ?? "").split(";")[0].trim().toLowerCase();
+}
+/**
+ * Validate that an HTTP response contains a genuine OpenAPI / Swagger spec.
+ * Returns true only when the body is confirmed to contain spec content.
+ */
+function isOpenApiResponse(response) {
+    const ct = mediaType(response.headers);
+    // Reject HTML responses (Swagger UI pages)
+    if (HTML_TYPES.has(ct))
+        return false;
+    // JSON content types -- parse and check for top-level key
+    if (JSON_TYPES.has(ct)) {
+        return jsonHasSpecKey(response.body);
+    }
+    // YAML content types -- regex check
+    if (YAML_TYPES.has(ct)) {
+        return /^(openapi|swagger):/m.test(response.body);
+    }
+    // Unknown Content-Type -- try JSON.parse fallback if body looks like JSON
+    if (response.body.trimStart().startsWith("{")) {
+        return jsonHasSpecKey(response.body);
+    }
+    return false;
+}
+/** Parse JSON and check for top-level "openapi" or "swagger" key */
+function jsonHasSpecKey(body) {
+    try {
+        const parsed = JSON.parse(body);
+        return "openapi" in parsed || "swagger" in parsed;
+    }
+    catch {
+        return false;
+    }
+}
+/** Determine whether the response is JSON (parseable) or YAML */
+function isJsonParseable(body) {
+    try {
+        JSON.parse(body);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Extract version, spec type, and endpoint count from a JSON body */
+function extractJsonInfo(body) {
+    try {
+        const parsed = JSON.parse(body);
+        const specType = "openapi" in parsed
+            ? "openapi"
+            : "swagger" in parsed
+                ? "swagger"
+                : null;
+        if (!specType)
+            return null;
+        const version = String(parsed[specType]);
+        const endpointCount = parsed.paths
+            ? Object.keys(parsed.paths).length
+            : 0;
+        return { version, specType, endpointCount };
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract version, spec type, and endpoint count from YAML via regex */
+function extractYamlInfo(body) {
+    const versionMatch = body.match(/^(openapi|swagger):\s*["']?(\d+\.\d+(?:\.\d+)?)/m);
+    if (!versionMatch)
+        return null;
+    // Count paths in YAML (lines that start with / at indent level 2)
+    const pathMatches = body.match(/^ {2}\/\S+:/gm);
+    return {
+        version: versionMatch[2],
+        specType: versionMatch[1],
+        endpointCount: pathMatches?.length ?? 0,
+    };
+}
+/** Patterns that extract spec URLs from HTML or JS content */
+const SPEC_URL_PATTERNS = [
+    // 1. Swagger UI initializer: SwaggerUIBundle({ url: "/openapi.json" })
+    /SwaggerUI(?:Bundle|Standalone)?\s*\(\s*\{[^}]*url\s*:\s*["']([^"']+)["']/g,
+    // 2. Swagger UI configUrl: SwaggerUIBundle({ configUrl: "/swagger-config" })
+    /SwaggerUI(?:Bundle|Standalone)?\s*\(\s*\{[^}]*configUrl\s*:\s*["']([^"']+)["']/g,
+    // 3. Swagger UI swaggerUrl (older): swaggerUrl: "/api/swagger.json"
+    /swaggerUrl\s*:\s*["']([^"']+)["']/g,
+    // 4. ReDoc spec-url attribute: <redoc spec-url="/api/openapi.json">
+    /(?:spec-url|data-spec-url)\s*=\s*["']([^"']+)["']/g,
+    // 5. Generic spec path (relative): "/some-path/openapi.json"
+    /["'](\/[^"']*(?:openapi|swagger)\.(?:json|yaml))["']/g,
+    // 6. Generic spec URL (absolute): "https://host/path/openapi.json"
+    /["'](https?:\/\/[^"']*(?:openapi|swagger)\.(?:json|yaml))["']/g,
+    // 7. fetch() call to JSON/YAML (Flasgger pattern): fetch("/spec.json")
+    /fetch\(\s*["']([^"']+\.(?:json|yaml))["']\s*\)/g,
+    // 8. Unquoted spec URLs in JS (template literals, config strings)
+    /(https?:\/\/[^\s,`"'<>]+(?:openapi|swagger)\.(?:json|yaml))/g,
+];
+/**
+ * Extract spec URLs from text content (HTML or JS).
+ * Returns deduplicated, same-origin, absolute URLs.
+ */
+function extractSpecUrls(body, pageUrl) {
+    const origin = new URL(pageUrl).origin;
+    const seen = new Set();
+    const results = [];
+    for (const pattern of SPEC_URL_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(body)) !== null) {
+            const raw = match[1];
+            if (!raw)
+                continue;
+            let absolute;
+            try {
+                absolute = new URL(raw, pageUrl).href;
+            }
+            catch {
+                continue;
+            }
+            try {
+                if (new URL(absolute).origin !== origin)
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            if (!seen.has(absolute)) {
+                seen.add(absolute);
+                results.push(absolute);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Extract Swagger UI config script URLs from HTML.
+ * Returns URLs of JS files that likely contain spec URL configuration.
+ */
+function extractSwaggerScriptUrls(html, pageUrl) {
+    const origin = new URL(pageUrl).origin;
+    // Match <script src="...swagger...js"> or <script src="...swagger...js">
+    const pattern = /<script[^>]+src=["']([^"']*swagger[^"']*\.js)["']/gi;
+    const results = [];
+    let match;
+    while ((match = pattern.exec(html)) !== null) {
+        const raw = match[1];
+        if (!raw)
+            continue;
+        try {
+            const absolute = new URL(raw, pageUrl).href;
+            if (new URL(absolute).origin !== origin)
+                continue;
+            results.push(absolute);
+        }
+        catch {
+            continue;
+        }
+    }
+    return results;
+}
+/** Returns true if response is a 401/403 HTTP error (not bot-protected) */
+function isProtectedResponse(response) {
+    if (response.ok)
+        return false;
+    const { error } = response;
+    return (error.kind === "http_error" &&
+        error.statusCode !== undefined &&
+        (error.statusCode === 401 || error.statusCode === 403));
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Probe 19 common OpenAPI / Swagger spec paths in parallel, then try
+ * extracting spec URLs from HTML doc pages, and finally detect protected specs.
+ *
+ * Returns a Check with id "openapi_spec" and a boolean indicating whether
+ * any valid spec was detected (for ctx.shared.openApiDetected).
+ */
+export async function checkOpenApi(baseUrl, timeout) {
+    const id = "openapi_spec";
+    const label = "OpenAPI Spec";
+    // Phase 1: Fire all 19 probes in parallel
+    const responses = await Promise.all([
+        ...SPEC_PATHS.map((path) => httpGet(new URL(path, baseUrl).href, {
+            timeout,
+            headers: { Accept: "application/json, application/yaml, */*" },
+        })),
+        ...DOC_UI_PATHS.map((path) => httpGet(new URL(path, baseUrl).href, {
+            timeout,
+            headers: { Accept: "text/html, */*" },
+        })),
+    ]);
+    const specPathResponses = responses.slice(0, SPEC_PATHS.length);
+    const docUiResponses = responses.slice(SPEC_PATHS.length);
+    // Phase 2: Check spec-path responses for direct spec hits
+    for (let i = 0; i < specPathResponses.length; i++) {
+        const response = specPathResponses[i];
+        if (!response.ok)
+            continue;
+        if (!isOpenApiResponse(response))
+            continue;
+        const path = SPEC_PATHS[i];
+        if (isJsonParseable(response.body)) {
+            const info = extractJsonInfo(response.body);
+            if (info) {
+                return {
+                    check: {
+                        id,
+                        label,
+                        status: "pass",
+                        detail: `OpenAPI ${info.version} found with ${info.endpointCount} endpoints`,
+                        data: {
+                            version: info.version,
+                            specType: info.specType,
+                            endpointCount: info.endpointCount,
+                            path,
+                        },
+                    },
+                    detected: true,
+                };
+            }
+        }
+        const yamlInfo = extractYamlInfo(response.body);
+        if (yamlInfo) {
+            return {
+                check: {
+                    id,
+                    label,
+                    status: "partial",
+                    detail: `OpenAPI ${yamlInfo.version} found (YAML format)`,
+                    data: {
+                        version: yamlInfo.version,
+                        specType: yamlInfo.specType,
+                        endpointCount: yamlInfo.endpointCount,
+                        path,
+                    },
+                },
+                detected: true,
+            };
+        }
+    }
+    // Phase 3: Check doc-UI-path responses for HTML with extractable spec URLs
+    const allProbedUrls = new Set(ALL_PATHS.map((p) => new URL(p, baseUrl).href));
+    const specCandidateUrls = [];
+    const scriptUrls = [];
+    for (let i = 0; i < docUiResponses.length; i++) {
+        const response = docUiResponses[i];
+        if (!response.ok)
+            continue;
+        const ct = mediaType(response.headers);
+        if (!HTML_TYPES.has(ct))
+            continue;
+        const pageUrl = new URL(DOC_UI_PATHS[i], baseUrl).href;
+        // Extract spec URLs directly from HTML
+        const extracted = extractSpecUrls(response.body, pageUrl);
+        for (const url of extracted) {
+            if (!allProbedUrls.has(url) && !specCandidateUrls.includes(url)) {
+                specCandidateUrls.push(url);
+            }
+        }
+        // Extract Swagger UI config script URLs for secondary fetching
+        if (specCandidateUrls.length === 0) {
+            const scripts = extractSwaggerScriptUrls(response.body, pageUrl);
+            for (const url of scripts) {
+                if (!scriptUrls.includes(url)) {
+                    scriptUrls.push(url);
+                }
+            }
+        }
+    }
+    // Phase 3a: Fetch external Swagger UI config scripts and extract spec URLs from them
+    if (specCandidateUrls.length === 0 && scriptUrls.length > 0) {
+        const scriptResponses = await Promise.all(scriptUrls.slice(0, 3).map((url) => httpGet(url, {
+            timeout,
+            headers: { Accept: "*/*" },
+        })));
+        for (let i = 0; i < scriptResponses.length; i++) {
+            const response = scriptResponses[i];
+            if (!response.ok)
+                continue;
+            const scriptUrl = scriptUrls[i];
+            const extracted = extractSpecUrls(response.body, scriptUrl);
+            for (const url of extracted) {
+                if (!allProbedUrls.has(url) && !specCandidateUrls.includes(url)) {
+                    specCandidateUrls.push(url);
+                }
+            }
+        }
+    }
+    // Phase 3b: Fetch candidate spec URLs and validate
+    if (specCandidateUrls.length > 0) {
+        const secondaryResponses = await Promise.all(specCandidateUrls.slice(0, 3).map((url) => httpGet(url, {
+            timeout,
+            headers: { Accept: "application/json, application/yaml, */*" },
+        })));
+        for (let i = 0; i < secondaryResponses.length; i++) {
+            const response = secondaryResponses[i];
+            if (!response.ok)
+                continue;
+            if (!isOpenApiResponse(response))
+                continue;
+            const path = new URL(specCandidateUrls[i]).pathname;
+            if (isJsonParseable(response.body)) {
+                const info = extractJsonInfo(response.body);
+                if (info) {
+                    return {
+                        check: {
+                            id,
+                            label,
+                            status: "pass",
+                            detail: `OpenAPI ${info.version} found with ${info.endpointCount} endpoints`,
+                            data: {
+                                version: info.version,
+                                specType: info.specType,
+                                endpointCount: info.endpointCount,
+                                path,
+                            },
+                        },
+                        detected: true,
+                    };
+                }
+            }
+            const yamlInfo = extractYamlInfo(response.body);
+            if (yamlInfo) {
+                return {
+                    check: {
+                        id,
+                        label,
+                        status: "partial",
+                        detail: `OpenAPI ${yamlInfo.version} found (YAML format)`,
+                        data: {
+                            version: yamlInfo.version,
+                            specType: yamlInfo.specType,
+                            endpointCount: yamlInfo.endpointCount,
+                            path,
+                        },
+                    },
+                    detected: true,
+                };
+            }
+        }
+    }
+    // Phase 4: Check spec-path responses for 401/403 (not bot_protected)
+    for (let i = 0; i < specPathResponses.length; i++) {
+        const response = specPathResponses[i];
+        if (isProtectedResponse(response)) {
+            return {
+                check: {
+                    id,
+                    label,
+                    status: "partial",
+                    detail: "OpenAPI spec appears to exist but requires authentication",
+                    data: { protected: true, path: SPEC_PATHS[i] },
+                },
+                detected: true,
+            };
+        }
+    }
+    // Phase 5: No valid spec found at any path
+    return {
+        check: {
+            id,
+            label,
+            status: "fail",
+            detail: "No OpenAPI spec found",
+        },
+        detected: false,
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/bridges/standards/openapi.js.map

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

package/dist/bridges/standards/schema-org.d.ts

@@ -0,0 +1,12 @@
+import type { Check } from "../../core/types.js";
+/**
+ * Check for Schema.org markup via JSON-LD vocabulary and Microdata attributes.
+ *
+ * Takes the JSON-LD Check result (from checkJsonLd) to avoid re-parsing HTML
+ * for JSON-LD blocks. Also scans raw HTML for Microdata itemtype attributes
+ * containing schema.org URLs.
+ *
+ * Pure function -- no HTTP calls.
+ */
+export declare function checkSchemaOrg(html: string, jsonLdCheck: Check): Check;
+//# sourceMappingURL=schema-org.d.ts.map

package/dist/bridges/standards/schema-org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-org.d.ts","sourceRoot":"","sources":["../../../src/bridges/standards/schema-org.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,KAAK,GACjB,KAAK,CAmFP"}

package/dist/bridges/standards/schema-org.js

@@ -0,0 +1,101 @@
+/**
+ * Check for Schema.org markup via JSON-LD vocabulary and Microdata attributes.
+ *
+ * Takes the JSON-LD Check result (from checkJsonLd) to avoid re-parsing HTML
+ * for JSON-LD blocks. Also scans raw HTML for Microdata itemtype attributes
+ * containing schema.org URLs.
+ *
+ * Pure function -- no HTTP calls.
+ */
+export function checkSchemaOrg(html, jsonLdCheck) {
+    const id = "schema_org";
+    const label = "Schema.org Markup";
+    const types = [];
+    const sources = [];
+    // Check JSON-LD blocks for schema.org @context
+    if (jsonLdCheck.status === "pass" &&
+        jsonLdCheck.data &&
+        Array.isArray(jsonLdCheck.data.blocks)) {
+        const blocks = jsonLdCheck.data.blocks;
+        let foundSchemaOrg = false;
+        for (const block of blocks) {
+            if (isSchemaOrgContext(block.context)) {
+                foundSchemaOrg = true;
+                const typeNames = flattenType(block.type);
+                for (const t of typeNames) {
+                    if (!types.includes(t)) {
+                        types.push(t);
+                    }
+                }
+            }
+        }
+        if (foundSchemaOrg) {
+            sources.push("json-ld");
+        }
+    }
+    // Check Microdata itemtype attributes for schema.org
+    const microdataRegex = /itemtype=["'](https?:\/\/schema\.org\/[^"']+)["']/gi;
+    let match;
+    const microdataTypes = [];
+    while ((match = microdataRegex.exec(html)) !== null) {
+        const typeUrl = match[1];
+        const typeName = typeUrl.split("/").pop();
+        if (typeName && !microdataTypes.includes(typeName)) {
+            microdataTypes.push(typeName);
+        }
+    }
+    if (microdataTypes.length > 0) {
+        sources.push("microdata");
+        for (const t of microdataTypes) {
+            if (!types.includes(t)) {
+                types.push(t);
+            }
+        }
+    }
+    if (types.length === 0) {
+        return {
+            id,
+            label,
+            status: "fail",
+            detail: "No Schema.org markup found",
+        };
+    }
+    // Build detail string based on sources
+    const typesStr = types.join(", ");
+    let detail;
+    if (sources.includes("json-ld") && sources.includes("microdata")) {
+        detail = `Schema.org types found via JSON-LD and Microdata: ${typesStr}`;
+    }
+    else if (sources.includes("json-ld")) {
+        detail = `Schema.org types found via JSON-LD: ${typesStr}`;
+    }
+    else {
+        detail = `Schema.org types found via Microdata: ${typesStr}`;
+    }
+    return {
+        id,
+        label,
+        status: "pass",
+        detail,
+        data: { types, sources },
+    };
+}
+/**
+ * Check if a JSON-LD @context value references schema.org.
+ */
+function isSchemaOrgContext(context) {
+    if (typeof context === "string") {
+        return context.includes("schema.org");
+    }
+    if (Array.isArray(context)) {
+        return context.some((item) => typeof item === "string" && item.includes("schema.org"));
+    }
+    return false;
+}
+/**
+ * Flatten a @type value to an array of type name strings.
+ */
+function flattenType(type) {
+    return Array.isArray(type) ? type : [type];
+}
+//# sourceMappingURL=schema-org.js.map

package/dist/bridges/standards/schema-org.js.map

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

package/dist/bridges/standards/well-known.d.ts

@@ -0,0 +1,16 @@
+import type { Check } from "../../core/types.js";
+/**
+ * Check for security.txt at /.well-known/security.txt.
+ *
+ * Per RFC 9116: must contain at least a Contact field.
+ * Returns pass if Contact present, partial if file exists but no Contact, fail if missing.
+ */
+export declare function checkSecurityTxt(baseUrl: string, timeout?: number): Promise<Check>;
+/**
+ * Check for ai-plugin.json at /.well-known/ai-plugin.json.
+ *
+ * Validates required fields: schema_version (string), name_for_human (string), api (object).
+ * Returns pass if all present, partial if JSON but missing fields, fail if missing.
+ */
+export declare function checkAiPlugin(baseUrl: string, timeout?: number): Promise<Check>;
+//# sourceMappingURL=well-known.d.ts.map

package/dist/bridges/standards/well-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.d.ts","sourceRoot":"","sources":["../../../src/bridges/standards/well-known.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC,CA2BhB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC,CA4ChB"}

package/dist/bridges/standards/well-known.js

@@ -0,0 +1,77 @@
+import { httpGet } from "../../utils/http-client.js";
+/**
+ * Check for security.txt at /.well-known/security.txt.
+ *
+ * Per RFC 9116: must contain at least a Contact field.
+ * Returns pass if Contact present, partial if file exists but no Contact, fail if missing.
+ */
+export async function checkSecurityTxt(baseUrl, timeout) {
+    const id = "security_txt";
+    const label = "security.txt";
+    const result = await httpGet(`${baseUrl}/.well-known/security.txt`, {
+        timeout,
+    });
+    if (!result.ok || result.body.trim().length === 0) {
+        return { id, label, status: "fail", detail: "No security.txt found" };
+    }
+    if (/^Contact:/mi.test(result.body)) {
+        return {
+            id,
+            label,
+            status: "pass",
+            detail: "security.txt found with Contact field",
+        };
+    }
+    return {
+        id,
+        label,
+        status: "partial",
+        detail: "security.txt found but missing Contact field",
+    };
+}
+/**
+ * Check for ai-plugin.json at /.well-known/ai-plugin.json.
+ *
+ * Validates required fields: schema_version (string), name_for_human (string), api (object).
+ * Returns pass if all present, partial if JSON but missing fields, fail if missing.
+ */
+export async function checkAiPlugin(baseUrl, timeout) {
+    const id = "ai_plugin";
+    const label = "ai-plugin.json";
+    const result = await httpGet(`${baseUrl}/.well-known/ai-plugin.json`, {
+        timeout,
+        headers: { Accept: "application/json" },
+    });
+    if (!result.ok) {
+        return { id, label, status: "fail", detail: "No ai-plugin.json found" };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(result.body);
+    }
+    catch {
+        return { id, label, status: "fail", detail: "No ai-plugin.json found" };
+    }
+    if (typeof parsed.schema_version === "string" &&
+        typeof parsed.name_for_human === "string" &&
+        typeof parsed.api === "object" &&
+        parsed.api !== null) {
+        return {
+            id,
+            label,
+            status: "pass",
+            detail: `ai-plugin.json found: ${parsed.name_for_human}`,
+            data: {
+                nameForHuman: parsed.name_for_human,
+                schemaVersion: parsed.schema_version,
+            },
+        };
+    }
+    return {
+        id,
+        label,
+        status: "partial",
+        detail: "ai-plugin.json found but missing required fields",
+    };
+}
+//# sourceMappingURL=well-known.js.map

package/dist/bridges/standards/well-known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.js","sourceRoot":"","sources":["../../../src/bridges/standards/well-known.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,OAAgB;IAEhB,MAAM,EAAE,GAAG,cAAc,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC;IAE7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,OAAO,2BAA2B,EAAE;QAClE,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACxE,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,EAAE;YACF,KAAK;YACL,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,uCAAuC;SAChD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE;QACF,KAAK;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,8CAA8C;KACvD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,OAAgB;IAEhB,MAAM,EAAE,GAAG,WAAW,CAAC;IACvB,MAAM,KAAK,GAAG,gBAAgB,CAAC;IAE/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,OAAO,6BAA6B,EAAE;QACpE,OAAO;QACP,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;KACxC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAC1E,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAA4B,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAC1E,CAAC;IAED,IACE,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QACzC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QACzC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;QAC9B,MAAM,CAAC,GAAG,KAAK,IAAI,EACnB,CAAC;QACD,OAAO;YACL,EAAE;YACF,KAAK;YACL,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,yBAAyB,MAAM,CAAC,cAAc,EAAE;YACxD,IAAI,EAAE;gBACJ,YAAY,EAAE,MAAM,CAAC,cAAc;gBACnC,aAAa,EAAE,MAAM,CAAC,cAAc;aACrC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE;QACF,KAAK;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,kDAAkD;KAC3D,CAAC;AACJ,CAAC"}