@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/statistics/violin-plot.d.ts

@@ -0,0 +1,144 @@
+/**
+ * `violinPlot`: a violin plot, its own chart with one mirrored kernel
+ * density silhouette per group and its median marked.
+ *
+ * The preset reads groups as `boxPlot` does (`groups.ts`). Its inner layer
+ * draws every violin and every median tick as **one path batch** (each
+ * violin's outline is its own; one batch keeps the order, a violin then
+ * its tick). Hover resolves per item (`event.item`).
+ *
+ * The reveal is geometry: each violin widens out of its centre line (every
+ * x pulled `t` of the way out from it), its tick with it. Keyed transitions
+ * blend densities on a shared grid (`blendViolinProfiles`) and move medians
+ * in data units.
+ */
+import type { SceneNode } from "@sophistry/core";
+import type { ColorInput } from "@sophistry/core/color";
+import type { BandKey, Point, Range } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { ChartYAxisOptions } from "../frame/types";
+import type { RevealProps, TransitionProps } from "../props";
+/**
+ * Props of {@link violinPlot}. `values` is required unless `data` is
+ * `number[][]`.
+ *
+ * @category Charts
+ */
+export interface ViolinPlotProps<T = unknown> extends TransitionProps<T>, RevealProps {
+    /** One violin per datum, each holding (or yielding via `values`) one group's raw sample. */
+    data: readonly T[];
+    /**
+     * The group's raw sample, in data units. Defaults to the datum when `data` is `number[][]`;
+     * required otherwise. Groups with fewer than 2 finite values draw no violin.
+     */
+    values?: Channel<T, readonly number[]>;
+    /** The name drawn under each violin. With a `series`, violins sharing a name share its slot. */
+    label?: Channel<T, string>;
+    /**
+     * The series each violin belongs to: colours violins through the chart's colour scale and
+     * legend; with a `label`, violins sharing a name stand side by side in its slot. `color` wins.
+     */
+    series?: Channel<T, BandKey>;
+    /**
+     * The legend for `series`: `"right"`, `"top"`, or `false`. As `chart`'s `legend`. Defaults to
+     * `"right"` with a series.
+     */
+    legend?: boolean | "right" | "top";
+    /**
+     * Gaussian kernel bandwidth, in data units. Defaults to Silverman's rule of thumb, per group.
+     */
+    bandwidth?: number;
+    /**
+     * How many points each violin's density is evaluated at.
+     * @default 80
+     */
+    samples?: number;
+    /**
+     * Half-width of a violin at its widest, as a fraction of the slot pitch. Every violin shares
+     * it, so shapes compare but absolute densities don't.
+     * @default 0.4
+     */
+    scale?: number;
+    /** `[min, max, step?]` in data units. Omitted, fitted to the data (including 0). */
+    yRange?: Range;
+    /** Width of the plotting area. */
+    width: number;
+    /** Height of the plotting area. */
+    height: number;
+    /** Centre of the plotting area. Defaults to the origin. */
+    center?: Point;
+    /**
+     * One colour for every violin, or `(d, i) => colour`. Wins over `colors` and `series` (whose
+     * legend then goes).
+     */
+    color?: ColorChannel<T>;
+    /**
+     * Colours cycled across the violins by index, or across the `series` categories. Defaults to
+     * the theme's categorical colours.
+     */
+    colors?: readonly ColorInput[];
+    /**
+     * Fill opacity, 0..1.
+     * @default 0.7
+     */
+    fillOpacity?: number;
+    /**
+     * Draw a short tick at each group's median.
+     * @default true
+     */
+    median?: boolean;
+    /**
+     * The value axis: `false` hides it; an object styles it and sets its ticks.
+     * @default true
+     */
+    yAxis?: boolean | ChartYAxisOptions;
+    /**
+     * Reveal, 0..1: the frame first, then each violin widens out of its centre line.
+     * @default 1
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the violins' reveal spent staggering violin after violin, left to right, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /**
+     * The data to transition to, groups matched by `label` and `series` (else by place): densities
+     * blend on a shared grid and medians move; new groups widen in, removed ones narrow out. See
+     * {@link TransitionProps}.
+     * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+     */
+    to?: readonly T[];
+    zIndex?: number;
+    visible?: boolean;
+    /** Drawn inside the chart's coordinate context. */
+    children?: readonly SceneNode[];
+}
+/**
+ * A violin plot: one mirrored kernel density silhouette per group, with its
+ * median marked. It is its own plot, sized by `width`/`height`; don't put it
+ * inside an `axes` or `chart`. Violins and median ticks draw as one path
+ * batch. See {@link violinRing} for the geometry alone.
+ *
+ * @example
+ * ```ts
+ * import { violinPlot } from "@sophistry/charts";
+ *
+ * violinPlot.create({
+ * 	data: [
+ * 		{ arm: "control", scores: [3, 4, 4, 5, 6, 7, 12] },
+ * 		{ arm: "treated", scores: [5, 6, 7, 7, 8, 9, 10] },
+ * 	],
+ * 	values: "scores",
+ * 	label: "arm",
+ * 	width: 6,
+ * 	height: 4,
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#box-and-violin-plots
+ * @category Charts
+ */
+export declare const violinPlot: import("@sophistry/core").Definition<ViolinPlotProps<any>, import("@sophistry/core/internal").CompositeNode<ViolinPlotProps<any>>, keyof ViolinPlotProps<any>>;
+//# sourceMappingURL=violin-plot.d.ts.map

package/dist/statistics/violin-plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violin-plot.d.ts","sourceRoot":"","sources":["../../src/statistics/violin-plot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAIX,SAAS,EACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAItE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,KAAK,EAAc,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAkBpE,OAAO,KAAK,EAAY,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA+BvE;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO,CAC3C,SAAQ,eAAe,CAAC,CAAC,CAAC,EACzB,WAAW;IACZ,4FAA4F;IAC5F,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACvC,gGAAgG;IAChG,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AAqbD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,UAAU,gKA8CrB,CAAC"}

package/dist/text-width.d.ts

@@ -0,0 +1,10 @@
+/** Text measurement for chart layout: the one place marks ask how wide a label is. Internal to the charts. */
+/**
+ * The advance width of `text` at `fontSize`, in scene units, as `label`
+ * draws it: measured on a canvas where there is one, else estimated.
+ *
+ * @param fontFamily - The theme's `defaults.fontFamily`.
+ * @param fontWeight - Defaults to `label`'s, 500.
+ */
+export declare function textWidth(text: string, fontSize: number, fontFamily: string, fontWeight?: number): number;
+//# sourceMappingURL=text-width.d.ts.map

package/dist/text-width.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-width.d.ts","sourceRoot":"","sources":["../src/text-width.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAI9G;;;;;;GAMG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,SAAsB,GAC9B,MAAM,CAQR"}

package/dist/tooltip.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Chart tooltips, the state half: what a tooltip shows (rows, templates,
+ * formats), which datum is showing, the handlers marks attach, and the
+ * shared nearest-x mode's points. The panel itself is drawn by the chart
+ * (`frame/tooltip-overlay.ts`).
+ *
+ * A chart provides one {@link TooltipState} through {@link tooltipContext};
+ * marks read it with `ctx.context(tooltipContext)`.
+ */
+import type { ContextKey, Readable, ScenePointerEvent } from "@sophistry/core";
+import type { BandKey, Bounds, Point } from "@sophistry/core/geometry";
+/** Gap between a tooltip panel and the point it describes, scene units. */
+export declare const TIP_GAP = 0.18;
+/**
+ * One line of a tooltip: a channel's name and its formatted value.
+ *
+ * @category Charts
+ */
+export interface TooltipRow {
+    /** The channel the value comes from (`"x"`, `"y"`, `"series"`, `"size"`, `"value"`, …); `"text"` for a sentence. */
+    channel: string;
+    /** The row's name: the field's name when the channel is a key of the datum, else the channel's. Empty for none. */
+    name: string;
+    /** The value, formatted. */
+    value: string;
+    /** The value before formatting, when there is one. */
+    raw?: number | BandKey;
+    /** A swatch drawn before the row: the datum's series colour. */
+    color?: string;
+}
+/**
+ * What a tooltip shows: one line of text (`\n` breaks it), or rows of names
+ * and values in two columns.
+ *
+ * @category Charts
+ */
+export type TooltipContent = string | readonly TooltipRow[];
+/**
+ * Per-channel formatters replacing the chart's own, keyed by channel
+ * (`{ y: (v) => `$${v}` }`). A band axis's value is its category key.
+ *
+ * @category Charts
+ */
+export type TooltipFormat = {
+    readonly [channel: string]: ((value: number | BandKey) => string) | undefined;
+};
+/**
+ * A mark's `tooltip` as an object: the default rows, reformatted or rewritten.
+ *
+ * @see https://sophistry.dev/guides/charts/#tooltips
+ * @category Charts
+ */
+export interface TooltipOptions<T> {
+    /** Formatters for some channels, replacing the axis's or legend's format. */
+    format?: TooltipFormat;
+    /** Your own content from the formatted default rows: return text, or rows (filtered, reordered, renamed or added to). */
+    content?: (rows: readonly TooltipRow[], datum: T, index: number) => TooltipContent;
+}
+/**
+ * A mark's `tooltip` prop: `true` for its default rows (one per channel,
+ * formatted as the chart's axes write them); a template such as
+ * `"{series}: {y}"`; `(d, i) => string`; a {@link TooltipOptions} object;
+ * or `false` for none. Omitted, the enclosing `<Chart tooltip>` decides.
+ *
+ * @see https://sophistry.dev/guides/charts/#tooltips
+ * @category Charts
+ */
+export type TooltipSpec<T> = boolean | string | ((datum: T, index: number) => string) | TooltipOptions<T>;
+/**
+ * Where a hover tooltip stands: by the pointer, following it, or above its datum.
+ *
+ * @category Charts
+ */
+export type TooltipAnchor = "pointer" | "datum";
+/**
+ * A chart's tooltip settings (`<Chart tooltip>`), as its {@link TooltipState} carries them.
+ *
+ * @category Extending
+ */
+export interface TooltipConfig {
+    /** Marks without a `tooltip` of their own show their default. */
+    all: boolean;
+    /** Formatters for some channels; a mark's own win. */
+    format?: TooltipFormat;
+    /** Where a hover tooltip stands. @default "pointer" */
+    anchor?: TooltipAnchor;
+    /**
+     * `"x"`: one shared tooltip for every series at the x nearest the pointer,
+     * with a crosshair; marks' own tooltips are off.
+     * @default "item"
+     */
+    mode?: "item" | "x";
+}
+/**
+ * What a tooltip shows and where, in scene units.
+ *
+ * @category Extending
+ */
+export interface ActiveTooltip {
+    owner: object;
+    /** The content as one string: the accessible name. */
+    text: string;
+    content: TooltipContent;
+    at: Point;
+    /** Opened by a hovering pointer, so it follows it. */
+    follow: boolean;
+}
+/**
+ * One point a mark offers a chart's shared nearest-x tooltip
+ * (`<Chart tooltip={{ mode: "x" }}>`).
+ *
+ * @category Extending
+ */
+export interface TooltipPoint {
+    /** Where it is drawn, in scene units. */
+    at: Point;
+    /** Its x, as the x axis writes it: the tooltip's heading. */
+    x: string;
+    /** The row it adds: its series' name and its formatted y. */
+    row: TooltipRow;
+}
+/**
+ * One chart's tooltip: which datum, if any, it is showing.
+ *
+ * @category Extending
+ */
+export interface TooltipState {
+    /** What is showing, if anything; the overlay binds to it. */
+    active: Readable<ActiveTooltip | null>;
+    /** Shows `content` about the point `at` on behalf of `owner`; with `follow`, by the pointer while it hovers. */
+    show(owner: object, content: TooltipContent, at: Point, follow?: boolean): void;
+    /** Hides the tooltip, if `owner` is the one showing it. */
+    hide(owner: object): void;
+    /** The chart's settings (`chart`'s `tooltip`): undefined for none, false to turn tooltips off. */
+    config(): TooltipConfig | false | undefined;
+    /**
+     * Sets the points `owner` offers the shared nearest-x tooltip (a mark
+     * calls it from each update); `null` withdraws them (on dispose).
+     */
+    offerPoints(owner: object, points: readonly TooltipPoint[] | null): void;
+    /** Every point offered, from every mark, in the order they were first offered. */
+    points(): readonly TooltipPoint[];
+    /** Bumps whenever the offered points change: the overlay binds to it. */
+    pointsVersion: Readable<number>;
+}
+/**
+ * Creates a {@link TooltipState}.
+ *
+ * @param config - The chart's tooltip settings, read when asked.
+ * @category Extending
+ */
+export declare function createTooltipState(config?: () => TooltipConfig | false | undefined): TooltipState;
+/**
+ * The enclosing chart's tooltip state, or null outside a chart. Read it with
+ * `ctx.context(tooltipContext)`.
+ *
+ * @category Extending
+ */
+export declare const tooltipContext: ContextKey<TooltipState | null>;
+/**
+ * One channel a mark's default tooltip reports, before formatting.
+ *
+ * @category Extending
+ */
+export interface TooltipField {
+    /** The channel's prop name: `"x"`, `"y"`, `"series"`, `"size"`, … */
+    channel: string;
+    /** The channel prop as given; a key of the datum names the row. */
+    of?: unknown;
+    /** The row's name, overriding the one `of` gives. */
+    name?: string;
+    /** The value; null or undefined drops the row. */
+    value: number | BandKey | null | undefined;
+    /**
+     * How the chart writes the value (`useChart().format(…)`). Defaults to `formatTick` for
+     * numbers.
+     */
+    format?: (value: number | BandKey) => string;
+    /** A swatch before the row. */
+    color?: string;
+}
+/**
+ * A tooltip's content as one string, its accessible name: text as is, rows
+ * as `name: value` joined by commas.
+ *
+ * @category Extending
+ */
+export declare function tooltipLabel(content: TooltipContent): string;
+/**
+ * Resolves a {@link TooltipSpec} to one datum's content, or undefined for
+ * none. `fallback` is the mark's default; with `state`, the chart's
+ * `<Chart tooltip>` settings apply.
+ */
+export declare function tooltipText<T>(spec: TooltipSpec<T> | undefined, fallback: (datum: T, index: number) => string | readonly TooltipField[], datum: T, index: number, state?: TooltipState): TooltipContent | undefined;
+/**
+ * Interaction props that make a shape show its tooltip on hover, tap or
+ * Enter; spread onto the shape. A mark whose `tooltip` is off registers no
+ * interaction. Outside a chart, only the accessible `label` is set.
+ *
+ * @param tooltip - The chart's tooltip state, if any.
+ * @param text - The content, or undefined for none; read reactively.
+ * @param at - Where the tooltip points, in scene units.
+ * @category Extending
+ */
+export declare function tooltipHandlers(tooltip: TooltipState | undefined, text: () => TooltipContent | undefined, at: () => Point): {
+    readonly label?: string;
+    readonly onEnter?: (event: ScenePointerEvent) => void;
+    readonly onLeave?: (event: ScenePointerEvent) => void;
+    readonly onTap?: (event: ScenePointerEvent) => void;
+};
+/** Width and height of a tooltip's panel, padding included. */
+interface TooltipSize {
+    width: number;
+    height: number;
+}
+/**
+ * A tooltip panel's bounds: `"above"` centred over `at`, `"right"` beside it,
+ * flipped when `frame`'s edge would cut it, then clamped inside `frame`.
+ *
+ * @internal
+ */
+export declare function placeTooltip(size: TooltipSize, at: Point, frame: Bounds | undefined, side?: "above" | "right", gap?: number): Bounds;
+/**
+ * The points at the scene x nearest `x` (all within a hair of it, so series
+ * on one grid share a tooltip). Undefined for none.
+ *
+ * @internal
+ */
+export declare function nearestX(points: readonly TooltipPoint[], x: number): {
+    x: number;
+    points: TooltipPoint[];
+} | undefined;
+/**
+ * {@link nearestX} over one set of points, for a pointer that asks on every
+ * move: the points are sorted by x once and each query bisects, rather than
+ * scanning and filtering them all. Answers exactly as the scan did: the
+ * nearest finite point wins, a tie going to the one offered first, and the
+ * group is every point within a hair of its x, in the order offered.
+ *
+ * @internal
+ */
+export declare function nearestXIndex(points: readonly TooltipPoint[]): (x: number) => {
+    x: number;
+    points: TooltipPoint[];
+} | undefined;
+/**
+ * One datum's channel value: a key, or `(d, i) => value`; undefined for an
+ * omitted or constant channel.
+ *
+ * @internal
+ */
+export declare function datumValue<T>(of: unknown, datum: T, index: number): number | BandKey | undefined;
+/** One datum a mark offers the shared nearest-x tooltip, before formatting. @internal */
+export interface SharedTooltipDatum {
+    /** Data units. */
+    x: number;
+    y: number;
+    /** Where it is drawn, in scene units. */
+    at: Point;
+    /** Its series, naming its row; omitted, the row is named by the `y` channel. */
+    series?: BandKey;
+    color?: string;
+}
+/**
+ * The points a mark offers the shared nearest-x tooltip: one row each, named
+ * by series (else the `y` channel). Empty unless the chart's tooltip mode is
+ * `"x"`, so `data` is only read while it is on. Pass the result to
+ * `tooltip.offerPoints(owner, points)`.
+ *
+ * @internal
+ */
+export declare function sharedTooltipPoints(tooltip: TooltipState | null | undefined, data: () => readonly SharedTooltipDatum[], channels: {
+    y: unknown;
+    format?: (channel: "x" | "y" | "series") => (value: number | BandKey) => string;
+}): readonly TooltipPoint[];
+export {};
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/tooltip.d.ts.map

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

package/dist/util.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Small helpers the chart components share: value equality for memo
+ * boundaries, point mixing, bisection. Internal; not exported from the
+ * package entry.
+ */
+import type { Point } from "@sophistry/core/geometry";
+/**
+ * Whether two values are equal one level deep: the same value, or arrays
+ * (or plain objects) whose members are identical (`Object.is`).
+ */
+export declare function shallowEqual(a: unknown, b: unknown): boolean;
+/**
+ * Whether two values are equal by structure (arrays, plain objects,
+ * primitives; functions and class instances by identity). For reports and
+ * other small configuration values, never for large data.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/** `a + (b − a)·t`. */
+export declare function mix(a: number, b: number, t: number): number;
+/** Two points mixed by `t`. */
+export declare function mixPoint(a: Point, b: Point, t: number): Point;
+/** The first index of sorted `values` whose value is `>= target`. */
+export declare function lowerBound(values: readonly number[], target: number): number;
+/**
+ * A last-value cache by equality: returns the previous value while
+ * `equals(previous, next)` holds, so identity-keyed caches downstream hit.
+ */
+export declare function stableValue<T>(equals?: (a: T, b: T) => boolean): (next: T) => T;
+/**
+ * A last-input cache over a dependency list: `make()` runs only when `deps`
+ * differ (shallowly) from the last call's, else the last result is returned.
+ */
+export declare function keyedMemo<T>(): (deps: readonly unknown[], make: () => T) => T;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA4B5D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA+BzD;AAED,uBAAuB;AACvB,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAE7D;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS5E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,MAAM,GAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAsB,GAC5C,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAOhB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAQ7E"}