@comecaramelos/dsh-chrome-mcp 1.0.0 → 2.0.0

package/lib/host/types/settings.d.ts.map

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

package/lib/host/types/stderr.d.ts

@@ -15,7 +15,6 @@ export type BridgeStderrMode = "log" | "console";
 /** The spawn-diagnostics subset {@link noteStderr} reads. */
 export type BridgeStderrNotice = {
     redirect: string;
-    fallback: string;
 };
 /** Spawn target consumed by {@link buildBridgeSpawn}. */
 export type BridgeSpawnTarget = {
@@ -32,18 +31,17 @@ export type BridgeSpawnTarget = {
 };
 /** Options for {@link buildBridgeSpawn}. */
 export type BridgeSpawnOptions = {
-    platform?: NodeJS.Platform;
-    exists?: (candidate: string) => boolean;
+    /** The Node that runs the wrapper; defaults to `process.execPath`. */
+    execPath?: string;
     tmpdir?: string;
     pid?: number;
 };
 /** One built bridge spawn: the (possibly wrapped) command/args plus where the
- * stderr lands (`redirect`, "" when echoed) and why not (`fallback`). */
+ * stderr lands (`redirect`, "" when echoed). */
 export type BridgeSpawnResult = {
     command: string;
     args: string[];
     redirect: string;
-    fallback: string;
 };
 /** Options for {@link bridgeStderrLogPath}. */
 export type BridgeStderrLogPathOptions = {

package/lib/host/types/stderr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stderr.d.ts","sourceRoot":"","sources":["../../../src/host/types/stderr.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAC;AAEjD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;yEACyE;AACzE,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG,+CAA+C;AAC/C,MAAM,MAAM,0BAA0B,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"stderr.d.ts","sourceRoot":"","sources":["../../../src/host/types/stderr.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAC;AAEjD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;gDACgD;AAChD,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,+CAA+C;AAC/C,MAAM,MAAM,0BAA0B,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/lib/host/values.d.ts

@@ -1,40 +1,108 @@
-import type { BridgeStderrMode, PluginContext } from "./types/index.js";
+import type { BridgeStderrMode, ChromeExecutableEntry, ChromeMcpConfig, ConfigField, ConfigLayers, ConfigLiveFields, SettingsFormRow, SettingsForms } from "./types/index.js";
+/**
+ * Environment variable that seeds the launch flags for one dsh run: a
+ * whitespace-separated extraFlags list, e.g.
+ * `DSH_CHROME_MCP_FLAGS="--headless --isolated"`.
+ */
+export { FLAGS_ENV_VAR } from "./constants.js";
+/**
+ * Read one config field. A `.volatile()` field arrives as a reference the fiber
+ * resolves live (dsh 0.2.0: `apply` hands references, ordinary fields plain
+ * values), so reading the field's type is not enough — this is the one way every
+ * volatile read answers, whether what it holds is a reference or, on the cold
+ * path of a hand-built config, the plain value itself.
+ *
+ * A reference hands a snapshot, so arrays come back copied: the running state
+ * holds values, never the reference's own object.
+ * @param field - what the config carries for that field.
+ * @param fallback - what to answer when it holds nothing.
+ */
+export declare function readConfigField<T>(field: ConfigField<T> | undefined, fallback: T): T;
+/**
+ * The canonical default extra-flags list — the live mirror's answer for the
+ * card's **Restore defaults** control (the card carries no copy of it).
+ */
+export declare function readDefaultExtraFlags(): string[];
+/**
+ * The recommended WSL ↔ Windows extra-flags list — the live mirror's answer for
+ * the card's **Flags WSL** control (a fixed recommendation, never persisted).
+ */
+export declare function readWslExtraFlags(): string[];
 /**
  * Parse a whitespace-separated flags list from the environment.
- * @param configured - the row config `extraFlags` value.
+ * @param configured - what the row config answers.
  * @param envValue - `DSH_CHROME_MCP_FLAGS` as seen in the launch env.
  * @returns the env flags when the value is a non-empty string whose every
  * entry is valid, else `configured` (the caller decides on warnings).
  */
 export declare function resolveEnvFlags(configured: string[], envValue: unknown): string[];
 /**
- * Read the last UI-selected extraFlags list from the persisted user layer
- * when the settings service is already up and the stored value is valid.
- * The host consults this before the first bridge spawn so the very first
- * connection launches with the persisted flags — and every in-process
- * reconnect, which reuses the bridge config, comes back on them as well.
- * @param ctx - plugin context.
- * @returns the persisted flags array, or undefined when absent, invalid, or
- * the settings service is not available yet (the installSection initial
- * onChange then applies the persisted selection in place).
+ * One read of the configuration form's layers. `value` answers what runs now —
+ * the references resolve the user layer over the row config, which is exactly
+ * what the bridge launches with. `user` answers "did the user edit this?" (the
+ * selection source, and where the launch environment sits in the flags
+ * precedence), `base` "what does the row config say?", and both stay undefined
+ * until the form answers.
+ *
+ * The live-only volatile fields are not consulted here: they are Host answers,
+ * held in the controller's mirror and published, not read.
+ * @param config - the config `apply` received (references included).
+ * @param row - the described form row, when the service is already up.
  */
-export declare function readPersistedFlags(ctx: PluginContext): string[] | undefined;
+export declare function readConfigLayers(config: ChromeMcpConfig, row?: SettingsFormRow): ConfigLayers;
 /**
- * Environment variable that seeds the launch flags for one dsh run: a
- * whitespace-separated extraFlags list, e.g.
- * `DSH_CHROME_MCP_FLAGS="--headless --isolated"`.
+ * The effective launch flags for one read of the layers (highest first: the
+ * user layer, `DSH_CHROME_MCP_FLAGS`, the row config, the schema default).
+ * Before the layers answer the references stand in, exactly the way the old cold
+ * path did. The executable-pinning flag never reaches argv — the picker owns
+ * that flag, so a layer that still carries one is answered as the selection
+ * source instead (see ./flags.ts), never as a second source of truth.
+ * @param layers - the last read of the form's layers.
+ * @param envValue - the launch environment's `DSH_CHROME_MCP_FLAGS` value.
  */
-export { FLAGS_ENV_VAR } from "./constants.js";
+export declare function resolveLaunchFlags(layers: ConfigLayers, envValue: unknown): string[];
 /**
- * Resolve the effective bridge stderr mode. The persisted UI toggle
- * (`stderrMode`) wins when set; otherwise the row-config `bridgeStderr`
- * (mirrored into the base layer as `rowStderr`). An invalid/empty override
- * falls back to the row config.
- * @param override - persisted `stderrMode` value, or "".
+ * The effective executable selection for one read of the layers: the user layer
+ * (the card's pick, or the host's one seed) wins, then the row config — its
+ * legacy `--executablePath` folded in — and, before either answers, nothing.
+ * There is no auto source and nothing is re-resolved here: a path that breaks
+ * keeps breaking so what the pill claims keeps being what the bridge runs.
+ */
+export declare function resolveSelection(layers: ConfigLayers): {
+    path: string;
+    source: "" | "selected" | "row-config";
+    pinned: boolean;
+};
+/**
+ * Resolve the effective bridge stderr mode. The user layer's toggle
+ * (`stderrMode`) wins when it states one; otherwise the row config's
+ * `bridgeStderr`. An invalid/empty override falls back to the row config.
+ * @param override - the persisted `stderrMode` value, or "".
  * @param rowDefault - the validated row-config `bridgeStderr` ("log"/"console").
  * @returns "log" | "console".
  */
 export declare function resolveStderrMode(override: unknown, rowDefault: unknown): BridgeStderrMode;
+/**
+ * The effective bridge stderr mode from one read of the form's layers, in the
+ * precedence every other layer-resolved field follows: what the user layer says
+ * wins, the **row config** answers under it, and what the references resolved at
+ * boot sits under that again (the references answer both layers before the form
+ * attaches, so the cold path keeps answering).
+ *
+ * The `base` step is what keeps the answer single. The references can resolve an
+ * empty `stderrMode` for a row that states one — no user layer ever wrote it —
+ * while the described row still serves it, and then the card states one mode
+ * while the bridge runs the other. A control that diffs its own flip against
+ * what is *effective* drops every flip as "already served" against a stale
+ * mirror, which is exactly the dead toggle: the profile that configures the
+ * switch in its own row is the profile that can never switch it. Reading the
+ * row-config layer here makes the Host state the same mode the card states, and
+ * the mirror it publishes then stays honest on its own.
+ * @param layers - the last read of the form's layers.
+ * @param rowDefault - the validated row-config `bridgeStderr` ("log"/"console").
+ * @returns "log" | "console".
+ */
+export declare function resolveStderrModeFromLayers(layers: ConfigLayers, rowDefault: unknown): BridgeStderrMode;
 /**
  * The effective Chrome executable path (highest first):
  *
@@ -48,34 +116,39 @@ export declare function resolveStderrMode(override: unknown, rowDefault: unknown
  * Nothing here consults the scan list: a fixed path stays fixed even when it
  * breaks, because re-resolving would be an auto mode in disguise.
  *
- * @param userLayer - persisted `chromePath` value ("" or absent when unset).
+ * @param userLayer - the persisted `chromePath` value ("" when unset).
  * @param rowConfig - validated row-config `chromePath` value.
  * @returns the trimmed effective path, possibly "".
  */
 export declare function resolveEffectiveChromePath(userLayer: unknown, rowConfig: unknown): string;
 /**
- * Read the last UI-seeded (or host-seeded) `chromePath` from the persisted user
- * layer when the settings service is already up. ""/absent/invalid means
- * "nothing picked yet".
- * @param ctx - plugin context.
+ * The persisted user-layer `extraFlags` list (undefined = the user never said
+ * anything, so the launch environment answers instead).
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readPersistedFlags(layers: ConfigLayers): string[] | undefined;
+/**
+ * The last UI-seeded (or host-seeded) `chromePath` from the user layer ("" means
+ * "nothing picked yet" → fall back to the row config).
+ * @param layers - the last read of the form's layers.
  */
-export declare function readPersistedChromePath(ctx: PluginContext): string;
+export declare function readPersistedChromePath(layers: ConfigLayers): string;
 /**
- * Read the last persisted "Reduce log output" mode from the persisted user
- * layer when the settings service is already up. Empty/absent/invalid means
- * "follow the row config".
- * @param ctx - plugin context.
+ * The last persisted "Reduce log output" mode from the user layer.
+ * Empty/absent/invalid means "follow the row config".
+ * @param layers - the last read of the form's layers.
  * @returns "log" | "console" when explicitly set, "" otherwise.
  */
-export declare function readPersistedStderrMode(ctx: PluginContext): "" | BridgeStderrMode;
+export declare function readPersistedStderrMode(layers: ConfigLayers): "" | BridgeStderrMode;
 /**
- * Read the persisted custom-executable MRU from the user layer when the
- * settings service is already up. Invalid entries (non-string, empty, control
- * characters) are dropped rather than poisoning the candidate list.
- * @param ctx - plugin context.
+ * The persisted custom-executable MRU from the user layer — a **legacy** field
+ * nothing writes any more, read once to fold the older hand-typed paths into
+ * the rows. Invalid entries (non-string, empty, control characters) are dropped
+ * rather than poisoning the candidate list.
+ * @param layers - the last read of the form's layers.
  * @returns the stored paths, trimmed and deduplicated ("" list when absent).
  */
-export declare function readPersistedCustomPaths(ctx: PluginContext): string[];
+export declare function readPersistedCustomPaths(layers: ConfigLayers): string[];
 /**
  * Normalized form of a **legacy** custom-path list: trimmed, empty entries
  * dropped, control characters dropped, duplicates folded (first spelling wins),
@@ -86,4 +159,46 @@ export declare function readPersistedCustomPaths(ctx: PluginContext): string[];
  * @param cap - entry cap (default `CUSTOM_PATHS_CAP`).
  */
 export declare function normalizeCustomPaths(value: unknown, cap?: number): string[];
+/**
+ * The saved executable rows the picker shows: re-normalized on every read, since
+ * what a form write hands may carry any shape.
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readSavedExecutables(layers: ConfigLayers): ChromeExecutableEntry[];
+/**
+ * The ids of rows the user has dropped — the ids every merge step must skip so a
+ * deletion outlives the run behind the write that made it (see ./schema.ts
+ * `droppedExecutables`). Deduped; a malformed entry drops out exactly like a
+ * malformed row id.
+ * @param layers - the last read of the form's layers.
+ */
+export declare function readDroppedExecutables(layers: ConfigLayers): string[];
+/**
+ * The live mirror's field names — the fields the Host answers through the
+ * volatile references and never authors by hand. Every write that lands in the
+ * stored row carries this list as **unset** ops: each unset returns the field to
+ * the answer beneath its own patch layer — what the row config says — so what
+ * only the live references stand drops out of what the write lands instead of
+ * riding the write into the file. This is what keeps the persistence boundary
+ * from the inside: a live commit answers, a persisted write clears (measured
+ * live 2026-10-12: booting the plugin with no user write at all filled the row
+ * with the whole live mirror; with the clear riding the write the row stays
+ * clean, and a row that already carries leaked live keys is healed by its first
+ * write).
+ */
+export declare function liveMirrorKeys(): readonly string[];
+/**
+ * The mirror the Host publishes: what every live field answers when nothing has
+ * run yet. The whole point of starting from the defaults is that a card reads
+ * exactly what a Host with no answers would serve, never a hole.
+ */
+export declare function createLiveMirror(): ConfigLiveFields;
+/**
+ * Read the row's two layers through the settings service. Undefined when the
+ * service (or this entry) is not described yet — the cold path, where only the
+ * references answer.
+ * @param settings - the settings service (`SettingsForms`), when resolved.
+ * @param entryId - the profile entry id this row is keyed by.
+ */
+export declare function readConfigForm(settings: SettingsForms | undefined, entryId: string): SettingsFormRow | undefined;
 //# sourceMappingURL=values.d.ts.map

package/lib/host/values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/host/values.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CASjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE,GAAG,SAAS,CAa3E;AAED;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB,CAG1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAKzF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,GAAG,gBAAgB,CAWjF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE,CAYrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAyB,GAAG,MAAM,EAAE,CAc7F"}
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/host/values.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACR,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,YAAY,EAEZ,gBAAgB,EAEhB,eAAe,EACf,aAAa,EAChB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CASpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CASjF;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,YAAY,CA2C7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAMpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,EAAE,GAAG,UAAU,GAAG,YAAY,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAQhI;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB,CAG1F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB,CAEvG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAIzF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,SAAS,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,EAAE,GAAG,gBAAgB,CAGnF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAIvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAyB,GAAG,MAAM,EAAE,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,EAAE,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAarE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,SAAS,MAAM,EAAE,CAElD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAkBnD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAGhH"}