@elaraai/e3-ui-components 1.0.11 → 1.0.13

package/dist/components/UITaskPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UITaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/UITaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAStE,MAAM,WAAW,kBAAkB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,eAAO,MAAM,aAAa,0DAsGxB,CAAC"}
+{"version":3,"file":"UITaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/UITaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAS9E,MAAM,WAAW,kBAAkB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,eAAO,MAAM,aAAa,0DA0GxB,CAAC"}

package/dist/experiment/bind-runtime.d.ts

@@ -0,0 +1,26 @@
+import { ValueTypeOf } from '@elaraai/east';
+import { DiffBindingType } from '@elaraai/e3-ui/internal';
+type DiffBindingValue = ValueTypeOf<typeof DiffBindingType>;
+export interface UseBindingValueResult<T> {
+    /** Current value (buffered if staged, otherwise server). `null` until the
+     *  binding has run or if the binding is absent. */
+    value: T | null;
+    /** The binding's write mode — `'staged'` buffers edits until `commit()`,
+     *  `'direct'` writes through. `'direct'` when the binding is absent. */
+    mode: 'staged' | 'direct';
+    /** True when there is an in-flight staged change. */
+    pending: boolean;
+    /** Replace the bound value (staged buffers, direct writes through). */
+    mutate: (next: T) => void;
+    /** Resolve the in-flight change. */
+    commit: () => Promise<void>;
+    /** Drop the in-flight change. */
+    discard: () => void;
+}
+/**
+ * Resolve a {@link DiffBindingType} value (or `null`) into a live, reactive
+ * value of type `T`, delegating to the shared bind runtime.
+ */
+export declare function useBindingValue<T>(binding: DiffBindingValue | null): UseBindingValueResult<T>;
+export {};
+//# sourceMappingURL=bind-runtime.d.ts.map

package/dist/experiment/bind-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-runtime.d.ts","sourceRoot":"","sources":["../../src/experiment/bind-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW1D,KAAK,gBAAgB,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAI5D,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACpC;uDACmD;IACnD,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB;4EACwE;IACxE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1B,oCAAoC;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,iCAAiC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AA0BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAqC7F"}

package/dist/experiment/charts.d.ts

@@ -0,0 +1,68 @@
+import { ReactElement } from 'react';
+import { HelpId } from './help.js';
+type Tone = 'neg' | 'pos' | 'warn' | 'muted' | 'brand' | string;
+export interface ForestRow {
+    label: string;
+    note?: string;
+    est: number;
+    lo: number;
+    hi: number;
+    tone: Tone;
+}
+export interface ForestPlotProps {
+    rows: ForestRow[];
+    min: number;
+    max: number;
+    unit?: string;
+    height?: number;
+    /** Optional per-row help id, aligned to `rows` — renders a `.hlp` glyph
+     *  after the row label, opening that glossary entry. */
+    rowHelp?: HelpId[];
+}
+/** Horizontal CI estimates with a dashed zero ("no effect") reference. */
+export declare function ForestPlot({ rows, min, max, unit, height, rowHelp }: ForestPlotProps): ReactElement;
+export interface AreaMark {
+    at: number;
+    label: string;
+    tone: Tone;
+    /** Optional glossary id — renders a `.hlp` glyph after the marker label. */
+    help?: HelpId;
+}
+export interface AreaRangeProps {
+    lo: number[];
+    mid: number[];
+    hi: number[];
+    xTicks?: string[];
+    yTicks?: string[];
+    zero?: number;
+    tone?: Tone;
+    marks?: AreaMark[];
+    height?: number;
+    /** Y-axis label format: `signed` (default, e.g. `+5.2`) or `percent` (`80%`). */
+    yFormat?: 'signed' | 'percent';
+}
+/** Low-high CI ribbon + mid line with hairline axes, optional zero + markers. */
+export declare function AreaRange({ lo, mid, hi, xTicks, yTicks, zero, tone: toneName, marks, height, yFormat }: AreaRangeProps): ReactElement;
+export interface OverlapHistogramProps {
+    /** Treated-arm propensity histogram (one count/fraction per bin over [0,1]). */
+    treated: number[];
+    /** Control-arm propensity histogram (same binning). */
+    control: number[];
+    /** Domain of the propensity axis (default [0,1]). */
+    domain?: [number, number];
+    /** Caption shown at top-right (e.g. "62% common support"). */
+    supportLabel?: string;
+    /** Whether positivity clears the guard — toggles the caption tone. */
+    positivityOk?: boolean;
+    height?: number;
+}
+/**
+ * A mirrored (back-to-back) histogram of the two arms' propensity scores:
+ * treated bars rise above a centre axis, control bars fall below it. Where the
+ * two densities both have mass is the **common support** — the only region a
+ * like-for-like comparison can be drawn. Contract-agnostic: the caller converts
+ * the two `Vector<Float>` to `number[]` and passes the [0,1] domain.
+ */
+export declare function OverlapHistogram({ treated, control, domain, supportLabel, positivityOk, height }: OverlapHistogramProps): ReactElement;
+export {};
+//# sourceMappingURL=charts.d.ts.map

package/dist/experiment/charts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../src/experiment/charts.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAyD,KAAK,YAAY,EAAkC,MAAM,OAAO,CAAC;AAOjI,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAqDxC,KAAK,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAmEhE,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;4DACwD;IACxD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,eAAe,GAAG,YAAY,CAqDnG;AAMD,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAClC;AAID,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAW,EAAE,MAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAU,EAAE,MAAM,EAAE,OAAkB,EAAE,EAAE,cAAc,GAAG,YAAY,CAyE/J;AAMD,MAAM,WAAW,qBAAqB;IAClC,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAG,YAAY,CAkD/I"}

package/dist/experiment/derive.d.ts

@@ -0,0 +1,336 @@
+import { HelpId } from './help.js';
+export type Opt<T> = {
+    type: 'none';
+    value: null;
+} | {
+    type: 'some';
+    value: T;
+};
+type Var<K extends string, V = unknown> = {
+    type: K;
+    value: V;
+};
+type Vec = ArrayLike<number> & Iterable<number>;
+type VecI = ArrayLike<bigint> & Iterable<bigint>;
+export interface Ci {
+    lower: number;
+    upper: number;
+}
+/** Which robustness checks the config asked for. */
+export interface RefuteSpecValue {
+    placebo: boolean;
+    random_common_cause: boolean;
+    data_subset: boolean;
+    sensitivity: Opt<Vec>;
+}
+/** The staged experiment config (= `ExperimentConfigType`). */
+export interface ConfigValue {
+    treatment: string;
+    outcome: string;
+    common_causes: string[];
+    categorical: Opt<string[]>;
+    method: Opt<Var<'linear_regression' | 'propensity_score_weighting'>>;
+    estimand: Opt<Var<'ate' | 'att' | 'atc'>>;
+    refute: Opt<RefuteSpecValue>;
+    dose_feature: Opt<string>;
+    min_overlap: Opt<number>;
+    min_treatment_variation: Opt<number>;
+    bootstrap: Opt<unknown>;
+    random_state: Opt<bigint>;
+}
+export interface BalanceValue {
+    column: string;
+    base_column: string;
+    treated_mean: number;
+    control_mean: number;
+    std_diff: number;
+}
+export interface AdjustedValue {
+    effect: number;
+    ci: Opt<Ci>;
+}
+export interface OverlapValue {
+    treated_propensity: Vec;
+    control_propensity: Vec;
+    common_support_frac: number;
+    positivity_ok: boolean;
+}
+export interface SensitivityValue {
+    strengths: Vec;
+    effects: Vec;
+}
+export interface RefutationValue {
+    placebo_effect: Opt<number>;
+    placebo_passes: Opt<boolean>;
+    random_cc_within_ci: Opt<boolean>;
+    data_subset_effect: Opt<number>;
+    data_subset_std: Opt<number>;
+    robustness_value: Opt<number>;
+    sensitivity: Opt<SensitivityValue>;
+}
+export interface DoseValue {
+    feature: string;
+    grid: Vec;
+    effect: Vec;
+    lower: Opt<Vec>;
+    upper: Opt<Vec>;
+    size: VecI;
+}
+/** The honesty verdict — only `not_estimable` carries a (reason) string. */
+export type VerdictValue = Var<'causal', null> | Var<'modest', null> | Var<'adjustment_insufficient', null> | Var<'non_identifiable_positivity', null> | Var<'not_estimable', string>;
+export type VerdictTag = VerdictValue['type'];
+export interface ResultValue {
+    naive: number;
+    naive_ci: Opt<Ci>;
+    adjusted: Opt<AdjustedValue>;
+    n_total: bigint;
+    n_treated: bigint;
+    n_control: bigint;
+    n_dropped: bigint;
+    balance: BalanceValue[];
+    overlap: OverlapValue;
+    refutation: Opt<RefutationValue>;
+    dose_response: Opt<DoseValue>;
+    verdict: VerdictValue;
+}
+export interface JournalRowValue {
+    config: ConfigValue;
+    verdict: VerdictValue;
+    naive: number;
+    adjusted: Opt<number>;
+    committed_at: Date;
+    committed_by: string;
+}
+export type ColMeta = Map<string, {
+    label: Opt<string>;
+    unit: Opt<string>;
+    higherIsBetter: Opt<boolean>;
+}>;
+/** A column the surface can frame over — name + coarse type family. */
+export interface Column {
+    name: string;
+    kind: 'boolean' | 'integer' | 'float' | 'string' | 'datetime' | 'other';
+}
+export interface VMVerdict {
+    tag: VerdictTag;
+    tone: string;
+    label: string;
+}
+export interface VMConfounder {
+    col: string;
+    reason: string;
+    imbalance: number;
+    level: string;
+    tone: string;
+}
+export interface VMSpec {
+    treatment: string;
+    treatmentKind: string;
+    outcome: string;
+    outcomeKind: string;
+    comparison: string;
+    confounders: VMConfounder[];
+    suggestion: string;
+    method: string;
+    target: string;
+    dataLabel: string;
+}
+export interface VMBalance {
+    col: string;
+    treated: number;
+    control: number;
+    display: string;
+    frac: number;
+    tone: string;
+}
+export interface VMAnswer {
+    treatment: string;
+    outcome: string;
+    unit: string;
+    naive: number;
+    naiveLo: number;
+    naiveHi: number;
+    effect: number;
+    lo: number;
+    hi: number;
+    clear: boolean;
+    flip: boolean;
+    cautious: boolean;
+    nTotal: bigint;
+    nTreated: bigint;
+    nControl: bigint;
+    nCompared: bigint;
+    nDropped: bigint;
+    balance: VMBalance[];
+}
+/** A refusal zone (the engine returned `adjusted = none`). */
+export interface VMRefusal {
+    kind: 'positivity' | 'not_estimable';
+    title: string;
+    body: string;
+    evidence: {
+        label: string;
+        value: string;
+    }[];
+}
+/** The propensity-overlap diagnostic (always derivable; the centrepiece of a
+ *  positivity refusal, a small diagnostic card otherwise). */
+export interface VMOverlap {
+    treated: number[];
+    control: number[];
+    commonSupportFrac: number;
+    positivityOk: boolean;
+    supportLabel: string;
+}
+export interface VMRefuteCheck {
+    name: string;
+    desc: string;
+    value: string;
+    passed: boolean;
+    tip: Opt<string>;
+    help: HelpId;
+}
+export interface VMRefute {
+    checks: VMRefuteCheck[];
+    sens: VMSensitivity | null;
+}
+export interface VMSensitivity {
+    lo: number[];
+    mid: number[];
+    hi: number[];
+    xTicks: string[];
+    yTicks: string[];
+}
+export interface VMDoseMark {
+    at: number;
+    label: string;
+    tone: string;
+    help: HelpId;
+}
+export interface VMMarginal {
+    label: string;
+    value: number;
+    frac: number;
+}
+export interface VMDose {
+    feature: string;
+    outcome: string;
+    lo: number[];
+    mid: number[];
+    hi: number[];
+    xTicks: string[];
+    yTicks: string[];
+    marks: VMDoseMark[];
+    recoLabel: string;
+    recoEffect: number;
+    recoLo: number;
+    recoHi: number;
+    tradeoff: string;
+    marginal: VMMarginal[];
+}
+export interface VMJournalRow {
+    treatment: string;
+    outcome: string;
+    confounders: string;
+    effect: string;
+    verdict: string;
+    verdictTone: string;
+    who: string;
+    when: string;
+}
+declare const getOpt: <T>(o: Opt<T> | undefined) => T | undefined;
+declare const fmt: (x: number) => string;
+declare const signed: (x: number) => string;
+declare const cap: (s: string) => string;
+declare const unitOf: (meta: ColMeta | undefined, col: string) => string;
+export interface ExperimentView {
+    spec: VMSpec;
+    verdict: VMVerdict | null;
+    answer: VMAnswer | null;
+    refusal: VMRefusal | null;
+    overlap: VMOverlap | null;
+    refute: VMRefute | null;
+    dose: VMDose | null;
+    journal: VMJournalRow[] | null;
+}
+/**
+ * Derive the full view-model from the staged config, the bound data's columns
+ * and the (possibly absent) single experiment result.
+ *
+ * @param config - The staged {@link ConfigValue}.
+ * @param cols - The bound dataset's columns (name + type family).
+ * @param result - The experiment result, or `null` until the first Run settles.
+ * @param journal - Committed rows, or `null`.
+ * @param meta - Optional per-column display metadata.
+ * @param dataLen - Row count of the bound dataset (for the header label).
+ * @param now - "Now" for relative journal timestamps (injected for determinism).
+ */
+export declare function deriveView(config: ConfigValue, ranConfig: ConfigValue, cols: Column[], result: ResultValue | null, journal: JournalRowValue[] | null, meta: ColMeta | undefined, dataLen: number, now: Date): ExperimentView;
+/** Decoded `ExperimentDesignType` (the `design` function's result). */
+export interface DesignValue {
+    verdict: VerdictValue;
+    basis: {
+        type: string;
+    };
+    target_effect: number;
+    outcome_sd: number;
+    target_power: number;
+    alpha: number;
+    current_power: Opt<number>;
+    match_on: string[];
+    options: {
+        label: string;
+        treated_share: number;
+        n_treated: bigint;
+        n_control: bigint;
+        n_total: bigint;
+    }[];
+    power_curve: {
+        n: VecI;
+        power: Vec;
+    };
+    rationale: string;
+}
+export interface VMDesignOption {
+    label: string;
+    nTotal: number;
+    nTreated: number;
+    nControl: number;
+    treatedShare: number;
+}
+export interface VMDesignMatch {
+    col: string;
+    frac: number;
+    tone: string;
+    display: string;
+}
+export interface VMDesign {
+    /** Verdict-framed eyebrow headline. */
+    headline: string;
+    rationale: string;
+    /** The recommended (first) option — the KPI + split meter read from this. */
+    primary: VMDesignOption;
+    /** Alternate split options (rows under the primary). */
+    alternates: VMDesignOption[];
+    /** Categories to match the arms on, with imbalance bar widths from the result. */
+    matchOn: VMDesignMatch[];
+    /** Power curve: total-N → chance of detecting (0..100), with target + "you're here". */
+    curve: {
+        mid: number[];
+        xTicks: string[];
+        marks: VMDoseMark[];
+    };
+    /** Signed target effect with unit, e.g. "+5.2 MPa". */
+    targetLabel: string;
+    targetPctLabel: string;
+    /** create_control → frame the split as a hold-back; no current-power marker. */
+    holdback: boolean;
+    /** non_identifiable_positivity → point at the overlap chart. */
+    showOverlap: boolean;
+    /** Effect too faint to size sanely — the head-count is a capped sentinel. */
+    faint: boolean;
+}
+/** Design value → the "Validate" tab view-model (numbers → recipe + chart). */
+export declare function deriveDesign(d: DesignValue, result: ResultValue | null, ranConfig: ConfigValue, meta: ColMeta | undefined): VMDesign;
+export { getOpt, fmt, signed, cap, unitOf };
+//# sourceMappingURL=derive.d.ts.map

package/dist/experiment/derive.d.ts.map

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

package/dist/experiment/help-ui.d.ts

@@ -0,0 +1,29 @@
+import { ReactNode } from 'react';
+import { HelpId } from './help.js';
+/** Provide the guidance on/off state + the `{treatment}`/`{outcome}` nouns. */
+export declare function GuidanceProvider({ on, vars, children }: {
+    on: boolean;
+    vars: Record<string, string>;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Make an element its own help trigger — hovering the heading / value / label
+ * itself opens its glossary card (no separate icon to aim at). Renders children
+ * untouched when guidance is off. `display` defaults to `inline` so prose still
+ * wraps; pass `inline-flex` + `gap` to keep a multi-part row laid out.
+ */
+export declare function Help({ id, extraVars, children, display, gap }: {
+    id: HelpId;
+    extraVars?: Record<string, string> | undefined;
+    children: ReactNode;
+    display?: 'inline' | 'inline-flex';
+    gap?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** The header guidance toggle — an icon-only on/off button (no label). The filled
+ *  (`subtle`) state + brand tint show guidance is active; ghost + muted is off.
+ *  Hovering it always explains the feature (even when off), so it's discoverable. */
+export declare function GuidanceToggle({ on, onToggle }: {
+    on: boolean;
+    onToggle: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=help-ui.d.ts.map

package/dist/experiment/help-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-ui.d.ts","sourceRoot":"","sources":["../../src/experiment/help-ui.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlE,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAKxD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAE1H;AA6CD;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAkB,EAAE,GAAG,EAAE,EAAE;IACvE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAChF,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACpD,2CAWA;AAED;;qFAEqF;AACrF,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAAE,2CAWrF"}