@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/platform/index.js

@@ -1,31 +1,4 @@
-/**
- * Platform abstraction — Wave G.0.
- *
- * A `Platform` is the seam between the MCP server and a host CMS. Today
- * the only concrete impl is `WordPressPlatform`; `joomla` is reserved
- * as a typed seam-marker so Wave G.4+ can land Joomla without rippling
- * through every call site.
- *
- * Why an interface instead of a tagged union?
- *   - Each platform owns its REST-namespace path verbatim (WP uses
- *     `/wp-json/<ns>`, Joomla will use `/index.php?option=com_ajax&…`).
- *   - Adding a platform = implement the interface + add a `PlatformKind`
- *     member. No switch statements to update.
- *
- * The `RestClient` accepts EITHER a `Platform` OR the legacy
- * `{baseUrl}` form (which internally builds a `WordPressPlatform`),
- * so existing callers keep working unchanged.
- *
- * @license MIT
- */
-/** Canonical WordPress REST-namespace path for this plugin. */
 export const WORDPRESS_REST_NAMESPACE_PATH = '/wp-json/yt-builder-mcp/v1';
-/**
- * WordPress platform implementation.
- *
- * `restNamespacePath` is fixed to the plugin's namespace; the caller
- * supplies only the site origin.
- */
 export class WordPressPlatform {
     kind = 'wordpress';
     baseUrl;
@@ -35,44 +8,14 @@ export class WordPressPlatform {
         this.restNamespacePath = WORDPRESS_REST_NAMESPACE_PATH;
     }
 }
-// Local import keeps the symbol in scope for `platformForUrl` below;
-// the re-export immediately after surfaces it to outside callers so
-// the platform barrel remains the single import point (cookbook
-// Ch1 Finding 2).
 import { JoomlaPlatform } from './joomla.js';
 export { JoomlaPlatform, JOOMLA_REST_NAMESPACE_PATH } from './joomla.js';
-/**
- * Detect which {@link Platform} a base URL targets based on the URL
- * shape alone (no network call).
- *
- *   - pathname starts with `/wp-json/` → `'wordpress'`
- *   - pathname starts with `/api/index.php/` → `'joomla'`
- *   - otherwise → `null` (ambiguous — caller may probe `/identity`)
- *
- * Round-6 A1 polish: detection switched from `String.includes` to a
- * proper `URL`-parse + `pathname.startsWith` so query-string payloads
- * cannot cause mis-detection (e.g. a Joomla site URL like
- * `https://example.com/?redirect=/wp-json/foo` no longer pretends to
- * be WordPress). Malformed URLs that the `URL` constructor rejects
- * gracefully fall back to the legacy substring scan so callers that
- * accidentally pass a host-only string (e.g. `example.com`) keep
- * working — they would have already failed the actual network call
- * with a clearer error before this function was reached in practice.
- *
- * Cookbook §3.7.1 — the runtime tie-breaker (when this returns `null`)
- * is the `/identity` endpoint, which returns
- * `{ product: 'yt-builder-mcp', platform: 'wordpress'|'joomla', ... }`
- * on both platforms.
- */
 export function detectPlatformFromUrl(url) {
     let pathname;
     try {
         pathname = new URL(url).pathname;
     }
     catch {
-        // Fallback for inputs the URL constructor rejects (host-only
-        // strings, relative paths). Preserves the legacy substring
-        // behaviour as a defensive net.
         if (url.includes('/wp-json/'))
             return 'wordpress';
         if (url.includes('/api/index.php/'))
@@ -85,22 +28,6 @@ export function detectPlatformFromUrl(url) {
         return 'joomla';
     return null;
 }
-/**
- * Construct the right {@link Platform} for a base URL.
- *
- * When the URL shape gives an unambiguous hint via
- * {@link detectPlatformFromUrl}, that wins. Otherwise the caller can
- * pass an explicit `hint` (e.g. from a config flag) or fall back to
- * the default (`'wordpress'` for back-compat — Joomla support landed
- * in Wave 7, so existing WordPress installs never need to flag).
- *
- * Synchronous variant — kept for back-compat with callers that cannot
- * (or do not need to) probe over the network. Prefer
- * {@link platformForUrlAsync} when running in the server boot path:
- * it adds a runtime probe that disambiguates origin-only / subfolder
- * URLs (e.g. `https://example.com/joomla`) where the URL shape alone
- * is silent.
- */
 export function platformForUrl(baseUrl, hint) {
     const detected = detectPlatformFromUrl(baseUrl);
     const kind = detected ?? hint ?? 'wordpress';
@@ -108,49 +35,18 @@ export function platformForUrl(baseUrl, hint) {
         ? new JoomlaPlatform(baseUrl)
         : new WordPressPlatform(baseUrl);
 }
-/**
- * Async variant of {@link platformForUrl} that adds a runtime probe
- * step for URLs the URL-shape heuristic cannot disambiguate.
- *
- * Resolution order (first match wins):
- *   1. Explicit `hint` from `YTB_MCP_PLATFORM` env var → no probe.
- *   2. URL-shape via {@link detectPlatformFromUrl} (clear `/wp-json/`
- *      or `/api/index.php/` marker) → no probe.
- *   3. Runtime probe via `detectPlatformAtRuntime` (the F-Platform-
- *      Detect-Probe fix — handles subfolder installs like
- *      `https://dev.example.com/joomla` where steps 1+2 return null).
- *   4. Final fallback: `'wordpress'` (back-compat).
- *
- * The probe step is what unblocks origin-only Joomla customers without
- * forcing them to manually set `YTB_MCP_PLATFORM=joomla` — the MCPB
- * default of `auto` finally lives up to its name.
- *
- * If both probes fail (server unreachable, plugin not installed, etc.)
- * we fall back to the wordpress default and emit a single stderr note
- * so the customer at least sees *why* the next authenticated call may
- * 404; the real diagnosis still belongs to the first authenticated
- * tool invocation.
- *
- * @param opts.probe Optional probe override (tests / DI).
- * @param opts.logger Optional stderr writer (defaults to `process.stderr.write`).
- */
 export async function platformForUrlAsync(baseUrl, hint, opts = {}) {
-    // 1. Explicit hint wins — probe-less, by design (user override).
     if (hint !== undefined) {
         return hint === 'joomla'
             ? new JoomlaPlatform(baseUrl)
             : new WordPressPlatform(baseUrl);
     }
-    // 2. Static URL-shape heuristic.
     const detected = detectPlatformFromUrl(baseUrl);
     if (detected !== null) {
         return detected === 'joomla'
             ? new JoomlaPlatform(baseUrl)
             : new WordPressPlatform(baseUrl);
     }
-    // 3. Runtime probe. Lazy-imported so the sync `platformForUrl`
-    //    barrel above stays free of any fetch dependency for callers
-    //    that do not opt-in.
     const probe = opts.probe
         ?? (async (url) => {
             const mod = await import('./detect.js');
@@ -162,8 +58,6 @@ export async function platformForUrlAsync(baseUrl, hint, opts = {}) {
             ? new JoomlaPlatform(baseUrl)
             : new WordPressPlatform(baseUrl);
     }
-    // 4. Final fallback — emit a single soft note so the user knows
-    //    we tried and that explicit YTB_MCP_PLATFORM may rescue.
     const logger = opts.logger
         ?? ((msg) => {
             process.stderr.write(msg);

package/dist/platform/index.js.map

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

package/dist/platform/joomla.d.ts

@@ -1,40 +1,5 @@
-/**
- * Joomla 5/6 platform implementation — Wave 7 prep.
- *
- * Mirrors {@link WordPressPlatform} but targets the Joomla Web Services
- * API surface registered by `plg_system_ytbmcp` (see
- * `src/packaging/joomla/extensions/plg_system_ytbmcp/src/Extension/Ytbmcp.php`
- * — `onBeforeApiRoute()` mounts the routes under
- * `v1/yt-builder-mcp/...` against `com_ytbmcp`).
- *
- * The full request URL composed by {@link RestClient} is:
- *
- *     {baseUrl}/api/index.php/v1/yt-builder-mcp/{path}
- *
- * — where `{baseUrl}` is the Joomla site origin (e.g. `https://example.com`
- * or `https://example.com/joomla` for a subfolder install) and `{path}`
- * is the per-tool REST path (e.g. `/health`, `/pages`, `/etag`).
- *
- * Cookbook Ch1 Finding 2: the `PlatformKind` union already declared
- * `'joomla'` in Wave G.0; this class fills the seam so no tool handler
- * has to change.
- *
- * Cookbook §3.7 (cross-platform parity): the REST byte-shape returned
- * by every endpoint is identical across platforms — only the route
- * prefix differs.
- *
- * @license MIT
- */
 import type { Platform } from './index.js';
-/** Canonical Joomla REST namespace prefix for this plugin. */
 export declare const JOOMLA_REST_NAMESPACE_PATH = "/api/index.php/v1/yt-builder-mcp";
-/**
- * Joomla platform implementation.
- *
- * `restNamespacePath` is fixed to the Web Services API mount point that
- * `plg_system_ytbmcp::onBeforeApiRoute()` registers; the caller supplies
- * only the site origin.
- */
 export declare class JoomlaPlatform implements Platform {
     readonly kind: "joomla";
     readonly baseUrl: string;

package/dist/platform/joomla.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"joomla.d.ts","sourceRoot":"","sources":["../../src/platform/joomla.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAE7E;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,SAAgB,IAAI,EAAG,QAAQ,CAAU;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,OAAO,EAAE,MAAM;CAI9B"}
+{"version":3,"file":"joomla.d.ts","sourceRoot":"","sources":["../../src/platform/joomla.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAS7E,qBAAa,cAAe,YAAW,QAAQ;IAC3C,SAAgB,IAAI,EAAG,QAAQ,CAAU;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,OAAO,EAAE,MAAM;CAI9B"}

package/dist/platform/joomla.js

@@ -1,39 +1,4 @@
-/**
- * Joomla 5/6 platform implementation — Wave 7 prep.
- *
- * Mirrors {@link WordPressPlatform} but targets the Joomla Web Services
- * API surface registered by `plg_system_ytbmcp` (see
- * `src/packaging/joomla/extensions/plg_system_ytbmcp/src/Extension/Ytbmcp.php`
- * — `onBeforeApiRoute()` mounts the routes under
- * `v1/yt-builder-mcp/...` against `com_ytbmcp`).
- *
- * The full request URL composed by {@link RestClient} is:
- *
- *     {baseUrl}/api/index.php/v1/yt-builder-mcp/{path}
- *
- * — where `{baseUrl}` is the Joomla site origin (e.g. `https://example.com`
- * or `https://example.com/joomla` for a subfolder install) and `{path}`
- * is the per-tool REST path (e.g. `/health`, `/pages`, `/etag`).
- *
- * Cookbook Ch1 Finding 2: the `PlatformKind` union already declared
- * `'joomla'` in Wave G.0; this class fills the seam so no tool handler
- * has to change.
- *
- * Cookbook §3.7 (cross-platform parity): the REST byte-shape returned
- * by every endpoint is identical across platforms — only the route
- * prefix differs.
- *
- * @license MIT
- */
-/** Canonical Joomla REST namespace prefix for this plugin. */
 export const JOOMLA_REST_NAMESPACE_PATH = '/api/index.php/v1/yt-builder-mcp';
-/**
- * Joomla platform implementation.
- *
- * `restNamespacePath` is fixed to the Web Services API mount point that
- * `plg_system_ytbmcp::onBeforeApiRoute()` registers; the caller supplies
- * only the site origin.
- */
 export class JoomlaPlatform {
     kind = 'joomla';
     baseUrl;

package/dist/platform/joomla.js.map

@@ -1 +1 @@
-{"version":3,"file":"joomla.js","sourceRoot":"","sources":["../../src/platform/joomla.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kCAAkC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACP,IAAI,GAAG,QAAiB,CAAC;IACzB,OAAO,CAAS;IAChB,iBAAiB,CAAS;IAE1C,YAAY,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,iBAAiB,GAAG,0BAA0B,CAAC;IACxD,CAAC;CACJ"}
+{"version":3,"file":"joomla.js","sourceRoot":"","sources":["../../src/platform/joomla.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,MAAM,0BAA0B,GAAG,kCAAkC,CAAC;AAS7E,MAAM,OAAO,cAAc;IACP,IAAI,GAAG,QAAiB,CAAC;IACzB,OAAO,CAAS;IAChB,iBAAiB,CAAS;IAE1C,YAAY,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,iBAAiB,GAAG,0BAA0B,CAAC;IACxD,CAAC;CACJ"}

package/dist/proxy/bridge.d.ts

@@ -1,85 +1,45 @@
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-/**
- * Normalise the WordPress↔Joomla `/mcp` envelope asymmetry for `tools/call`
- * responses.
- *
- * The WP mcp-adapter (`ToolsHandler`) treats an Ability's return value as raw
- * data and `wp_json_encode`s our already-final `CallToolResult` into a fresh
- * text-content block. Over the wire that yields a DOUBLE-wrapped result —
- * `result.content[0].text` is itself a serialised `CallToolResult`
- * (`{"content":[{"type":"text","text":"<real-data-json>"}],"isError":…}`).
- * Joomla's `/api/` handler single-wraps: `result.content[0].text` is already
- * the real data JSON. The proxy bridge is a verbatim pipe, so a WP customer
- * would receive doubly-nested tool output while a Joomla customer would not.
- *
- * Strip EXACTLY ONE level of that nesting, and ONLY when the inner payload is
- * unmistakably a nested `CallToolResult`. Every shape check is defensive
- * (try/catch around the parse, strict block typing) so a genuine Joomla data
- * payload is never touched. Non-`tools/call` frames (initialize, tools/list,
- * JSON-RPC errors, notifications) are returned by reference, unchanged.
- *
- * Exported for unit tests.
- */
+import type { CompatNotice } from '../compat-floor.js';
+import { type ProxyMultiSite, type SiteCallRouter, type SitesShadowBridge } from './multi-site.js';
+import { buildProxyRequestHeaders, type ProxyAuthConfig } from './request-headers.js';
+import { type ShadowToolBridge } from './shadow-tools.js';
+import type { SiteRegistry } from '../sites/registry.js';
 export declare function normalizeProxyResponse(msg: unknown): unknown;
-/**
- * Wire two MCP transports into a transparent pipe: every message from one side
- * is relayed to the other, and a close/error on either side tears down the
- * other. The local→remote direction is verbatim; the remote→local direction
- * normalises the WP double-wrap (see `normalizeProxyResponse`) so WP and Joomla
- * customers receive identical, spec-clean tool results. The PHP server otherwise
- * owns the protocol semantics.
- * The caller is responsible for start()ing both transports.
- *
- * `StreamableHTTPClientTransport.send()` re-throws on any upstream failure
- * (401/5xx/connection refused / missing PHP endpoint). The forwarders MUST NOT
- * fire-and-forget that rejection: an unhandled rejection crashes the Node
- * process, so a wrong key / unreachable site would kill the proxy on the first
- * `initialize` instead of surfacing an actionable error. Each direction
- * therefore `.catch()`es its `send()`.
- */
-export declare function bridgeTransports(local: Transport, remote: Transport): void;
-/** Config the proxy run needs: the upstream endpoint, the Bearer, and any
- * corporate extra headers (customer gap #14) to attach to every upstream
- * request. The Bearer always wins on collision. */
-interface ProxyConfig {
-    endpointUrl: URL;
-    token: string;
-    /** Extra headers from `YTB_MCP_EXTRA_HEADERS` (WAF / gateway secret). */
-    extraHeaders?: Record<string, string>;
-    /**
-     * U3 — percent-encoded `user:pass` userinfo for a site-level HTTP Basic-Auth
-     * realm (`YTB_MCP_SITE_BASIC_AUTH`). Spliced into `endpointUrl`
-     * (`https://user:pass@host/…`) so the realm gets `Authorization: Basic …`
-     * while the Bearer header still reaches the plugin. Orthogonal transports —
-     * the Bearer is never overwritten.
-     */
-    siteBasicUserinfo?: string;
+export declare const GATEWAY_TOOL_NAMES: readonly string[];
+export declare const HEALTH_TOOL_NAME = "yootheme_builder_health";
+export interface BridgeOptions {
+    readonly instructions?: string;
+    readonly shadow?: ShadowToolBridge;
+    readonly sitesShadow?: SitesShadowBridge;
+    readonly siteRouter?: SiteCallRouter;
 }
-/**
- * Build the upstream `requestInit.headers` for proxy mode: the Bearer is
- * authoritative; corporate extra headers (customer gap #14) only fill gaps —
- * `Authorization` can NEVER be overwritten. Exported for unit tests.
- */
-export declare function buildProxyRequestHeaders(config: ProxyConfig): Record<string, string>;
-/**
- * Resolve the upstream endpoint URL the proxy connects to, splicing in the U3
- * site-level HTTP Basic userinfo (`https://user:pass@host/…`) when configured so
- * the realm gets `Authorization: Basic …`. The Bearer rides the Authorization
- * header (see {@link buildProxyRequestHeaders}) — independent transport, never
- * clobbered. Returns the original URL unchanged when no site-Basic is set.
- * Exported for unit tests.
- */
-export declare function resolveProxyEndpointUrl(config: ProxyConfig): URL;
-/** Build the real transports + bridge them; resolves when EITHER side closes. */
+export interface BridgeHandle {
+    readonly pendingHostPromptCount: () => number;
+}
+export declare function bridgeTransports(local: Transport, remote: Transport, opts?: BridgeOptions): BridgeHandle;
+export interface ProxyConfig extends ProxyAuthConfig {
+    instructions?: string;
+    registry?: SiteRegistry;
+}
+export { buildProxyRequestHeaders };
+export type ClosedBy = 'local' | 'remote';
 export declare function runProxy(config: ProxyConfig, deps?: {
     makeTransports?: (c: ProxyConfig) => {
         local: Transport;
         remote: Transport;
     };
-}): Promise<void>;
-/** Returns true if proxy mode handled the run; false → caller continues with fat. */
-export declare function maybeRunProxy(env: NodeJS.ProcessEnv, deps?: {
-    runProxy?: (c: ProxyConfig) => Promise<void>;
-}): Promise<boolean>;
-export {};
+    shadow?: ShadowToolBridge;
+    multiSite?: ProxyMultiSite;
+}): Promise<ClosedBy>;
+export type BridgeOutcome = {
+    ran: true;
+    closedBy: ClosedBy;
+} | {
+    ran: false;
+    configProblem: string | null;
+};
+export declare function runBridge(env: NodeJS.ProcessEnv, deps?: {
+    runProxy?: (c: ProxyConfig) => Promise<ClosedBy | void>;
+    probeCompat?: (registry: SiteRegistry | undefined, token: string, extraHeaders: Record<string, string>) => Promise<CompatNotice | undefined>;
+}): Promise<BridgeOutcome>;
 //# sourceMappingURL=bridge.d.ts.map

package/dist/proxy/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/proxy/bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAiE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAoC5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAuD1E;AAED;;mDAEmD;AACnD,UAAU,WAAW;IACnB,WAAW,EAAE,GAAG,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKpF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAKhE;AAcD,iFAAiF;AACjF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK;QACnC,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;KACnB,CAAC;CACE,GACL,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAO,GAC1D,OAAO,CAAC,OAAO,CAAC,CAkBlB"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/proxy/bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAK/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,OAAO,EAAwB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzH,OAAO,EAAE,wBAAwB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAwBlF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAgFzD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAoC5D;AAsHD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAG/C,CAAC;AAoBF,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAwd1D,MAAM,WAAW,aAAa;IAQ5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAQ/B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQnC,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAOzC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;CACtC;AAaD,MAAM,WAAW,YAAY;IAE3B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,MAAM,CAAC;CAC/C;AAuBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAsM5G;AASD,MAAM,WAAW,WAAY,SAAQ,eAAe;IASlD,YAAY,CAAC,EAAE,MAAM,CAAC;IAWtB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAMD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AA+BpC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAG1C,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK;QACnC,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;KACnB,CAAC;IAIF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAU1B,SAAS,CAAC,EAAE,cAAc,CAAC;CACvB,GACL,OAAO,CAAC,QAAQ,CAAC,CAwDnB;AAUD,MAAM,MAAM,aAAa,GACrB;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACjC;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AASjD,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IASxD,WAAW,CAAC,EAAE,CACZ,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACnC,GACL,OAAO,CAAC,aAAa,CAAC,CA4DxB"}