@sentropic/dataviz-core 0.1.0 → 0.2.0

package/dist/categorical.js

@@ -0,0 +1,158 @@
+/**
+ * Categorical/combo chart data contracts.
+ *
+ * This is the rendering-agnostic series model that DS chart components can
+ * consume or adapt for grouped bars, stacked bars, line/area combos, 100 %
+ * stacks, Pareto views and diverging bars.
+ */
+import { aggregate } from './aggregate.js';
+import { findDimension, findMeasure } from './model.js';
+function cellKey(value) {
+    return value == null ? 'null' : String(value);
+}
+function resolveMeasures(model, inputs) {
+    return inputs.map((input) => {
+        const id = typeof input === 'string' ? input : input.id;
+        const measure = findMeasure(model, id);
+        if (!measure) {
+            throw new Error(`Unknown categorical measure: ${id}`);
+        }
+        return {
+            measure,
+            mark: typeof input === 'string' ? 'bar' : (input.mark ?? 'bar'),
+            axis: typeof input === 'string' ? 'left' : (input.axis ?? 'left'),
+        };
+    });
+}
+function assertDimension(model, id, role) {
+    if (!findDimension(model, id)) {
+        throw new Error(`Unknown ${role} dimension: ${id}`);
+    }
+}
+function resolveMeasure(model, id, role) {
+    const measure = findMeasure(model, id);
+    if (!measure) {
+        throw new Error(`Unknown ${role} measure: ${id}`);
+    }
+    return measure;
+}
+function uniqueKeys(data, field) {
+    const seen = new Set();
+    const keys = [];
+    for (const row of data) {
+        const key = cellKey(row[field]);
+        if (!seen.has(key)) {
+            seen.add(key);
+            keys.push(key);
+        }
+    }
+    return keys;
+}
+function normalizeStacked100(series) {
+    const categoryCount = series[0]?.values.length ?? 0;
+    for (let index = 0; index < categoryCount; index += 1) {
+        const total = series.reduce((sum, item) => sum + item.values[index], 0);
+        for (const item of series) {
+            item.values[index] = total === 0 ? 0 : item.values[index] / total;
+        }
+    }
+}
+export function buildCategoricalSeries(model, data, config) {
+    if (!findDimension(model, config.category)) {
+        throw new Error(`Unknown categorical category dimension: ${config.category}`);
+    }
+    if (config.series !== undefined && !findDimension(model, config.series)) {
+        throw new Error(`Unknown categorical series dimension: ${config.series}`);
+    }
+    const measures = resolveMeasures(model, config.measures);
+    const categories = uniqueKeys(data, config.category);
+    const mode = config.mode ?? 'grouped';
+    const output = [];
+    if (config.series === undefined) {
+        for (const item of measures) {
+            output.push({
+                id: `measure:${item.measure.id}`,
+                label: item.measure.label,
+                measureId: item.measure.id,
+                mark: item.mark,
+                axis: item.axis,
+                values: categories.map((category) => aggregate([...data].filter((row) => cellKey(row[config.category]) === category), item.measure)),
+            });
+        }
+    }
+    else {
+        const seriesKeys = uniqueKeys(data, config.series);
+        for (const seriesKey of seriesKeys) {
+            for (const item of measures) {
+                output.push({
+                    id: `series:${seriesKey}:${item.measure.id}`,
+                    label: `${seriesKey} · ${item.measure.label}`,
+                    measureId: item.measure.id,
+                    seriesKey,
+                    seriesLabel: seriesKey,
+                    mark: item.mark,
+                    axis: item.axis,
+                    values: categories.map((category) => aggregate([...data].filter((row) => cellKey(row[config.category]) === category &&
+                        cellKey(row[config.series]) === seriesKey), item.measure)),
+                });
+            }
+        }
+    }
+    if (mode === 'stacked-100') {
+        normalizeStacked100(output);
+    }
+    return { categories, mode, series: output };
+}
+export function buildParetoModel(model, data, config) {
+    assertDimension(model, config.category, 'Pareto category');
+    const measure = resolveMeasure(model, config.measure, 'Pareto');
+    const categories = uniqueKeys(data, config.category);
+    const indexed = categories.map((category, index) => ({
+        key: category,
+        label: category,
+        value: aggregate([...data].filter((row) => cellKey(row[config.category]) === category), measure),
+        index,
+    }));
+    indexed.sort((a, b) => b.value - a.value || a.index - b.index);
+    const total = indexed.reduce((sum, item) => sum + item.value, 0);
+    let cumulativeValue = 0;
+    const items = indexed.map((item, index) => {
+        cumulativeValue += item.value;
+        return {
+            key: item.key,
+            label: item.label,
+            value: item.value,
+            rank: index + 1,
+            cumulativeValue,
+            cumulativePercent: total === 0 ? 0 : cumulativeValue / total,
+        };
+    });
+    return { categoryId: config.category, measureId: measure.id, total, items };
+}
+function directionFor(value) {
+    if (value > 0)
+        return 'positive';
+    if (value < 0)
+        return 'negative';
+    return 'neutral';
+}
+export function buildDivergingBarModel(model, data, config) {
+    assertDimension(model, config.category, 'diverging bar category');
+    const measure = resolveMeasure(model, config.measure, 'diverging bar');
+    const categories = uniqueKeys(data, config.category);
+    const items = categories.map((category) => {
+        const value = aggregate([...data].filter((row) => cellKey(row[config.category]) === category), measure);
+        return {
+            key: category,
+            label: category,
+            value,
+            start: Math.min(0, value),
+            end: Math.max(0, value),
+            direction: directionFor(value),
+        };
+    });
+    const values = items.map((item) => item.value);
+    const domain = values.length === 0 ? [0, 0] : [Math.min(0, ...values), Math.max(0, ...values)];
+    return { categoryId: config.category, measureId: measure.id, baseline: 0, domain, items };
+}
+//# sourceMappingURL=categorical.js.map

package/dist/categorical.js.map

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

package/dist/describe.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Locale-neutral labels for core BI state.
+ *
+ * These helpers produce stable text for adapter-owned presentation such as
+ * FilterPill values. They intentionally avoid framework and design-system
+ * imports so React, Svelte and Vue share exactly the same wording.
+ */
+import type { Dimension } from './model.js';
+import type { FilterSpec } from './store.js';
+export declare function describeFilterSpec(spec: FilterSpec, _dimension?: Dimension): string;
+//# sourceMappingURL=describe.d.ts.map

package/dist/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../src/describe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAcnF"}

package/dist/describe.js

@@ -0,0 +1,26 @@
+/**
+ * Locale-neutral labels for core BI state.
+ *
+ * These helpers produce stable text for adapter-owned presentation such as
+ * FilterPill values. They intentionally avoid framework and design-system
+ * imports so React, Svelte and Vue share exactly the same wording.
+ */
+export function describeFilterSpec(spec, _dimension) {
+    switch (spec.kind) {
+        case 'include':
+            return spec.values.join(', ');
+        case 'exclude':
+            return `≠ ${spec.values.join(', ')}`;
+        case 'range': {
+            const { min, max } = spec;
+            if (min !== undefined && max !== undefined)
+                return `${min} – ${max}`;
+            if (min !== undefined)
+                return `≥ ${min}`;
+            if (max !== undefined)
+                return `≤ ${max}`;
+            return 'tous';
+        }
+    }
+}
+//# sourceMappingURL=describe.js.map

package/dist/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../src/describe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,UAAU,kBAAkB,CAAC,IAAgB,EAAE,UAAsB;IACzE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,SAAS;YACZ,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAC1B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,GAAG,GAAG,MAAM,GAAG,EAAE,CAAC;YACrE,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,KAAK,GAAG,EAAE,CAAC;YACzC,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,KAAK,GAAG,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/distribution.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Distribution and statistical chart data contracts.
+ *
+ * These builders cover rendering-neutral inputs for histograms, box plots,
+ * categorical/calendar heatmaps, bullet charts and gauges.
+ */
+import type { DataModel, Row } from './model.js';
+export interface HistogramConfig {
+    value: string;
+    bins?: number;
+    domain?: readonly [number, number];
+}
+export interface HistogramBin {
+    index: number;
+    x0: number;
+    x1: number;
+    count: number;
+}
+export interface HistogramModel {
+    valueId: string;
+    domain: [number, number];
+    bins: HistogramBin[];
+}
+export interface BoxPlotConfig {
+    value: string;
+    group?: string;
+}
+export interface BoxPlotGroup {
+    key: string;
+    label: string;
+    count: number;
+    min: number;
+    q1: number;
+    median: number;
+    q3: number;
+    max: number;
+    outliers: number[];
+}
+export interface BoxPlotModel {
+    valueId: string;
+    groups: BoxPlotGroup[];
+}
+export interface HeatmapConfig {
+    x: string;
+    y: string;
+    measure: string;
+}
+export interface HeatmapCell {
+    xKey: string;
+    yKey: string;
+    value: number;
+}
+export interface HeatmapModel {
+    xKeys: string[];
+    yKeys: string[];
+    cells: HeatmapCell[];
+}
+export interface BulletChartConfig {
+    value: string;
+    target: string;
+    category?: string;
+    label?: string;
+    ranges?: readonly number[];
+}
+export interface BulletChartDatum {
+    key: string;
+    label: string;
+    value: number;
+    target: number;
+    ranges?: number[];
+}
+export interface BulletChartModel {
+    label: string;
+    valueId: string;
+    targetId: string;
+    data: BulletChartDatum[];
+}
+export type GaugeChartTone = 'neutral' | 'info' | 'success' | 'warning' | 'error' | 'category1' | 'category2' | 'category3' | 'category4' | 'category5' | 'category6' | 'category7' | 'category8';
+export type GaugeChartFormat = 'number' | 'percent';
+export interface GaugeChartThreshold {
+    value: number;
+    tone: GaugeChartTone;
+}
+export interface GaugeChartConfig {
+    value: string;
+    label?: string;
+    min?: number;
+    max?: number;
+    thresholds?: readonly GaugeChartThreshold[];
+    format?: GaugeChartFormat;
+    unit?: string;
+}
+export interface GaugeChartModel {
+    label: string;
+    valueId: string;
+    value: number;
+    displayValue: number;
+    min: number;
+    max: number;
+    thresholds?: GaugeChartThreshold[];
+    format: GaugeChartFormat;
+    unit?: string;
+}
+export declare function buildHistogramModel(model: DataModel, data: readonly Row[], config: HistogramConfig): HistogramModel;
+export declare function buildBoxPlotModel(model: DataModel, data: readonly Row[], config: BoxPlotConfig): BoxPlotModel;
+export declare function buildHeatmapModel(model: DataModel, data: readonly Row[], config: HeatmapConfig): HeatmapModel;
+export declare function buildBulletChartModel(model: DataModel, data: readonly Row[], config: BulletChartConfig): BulletChartModel;
+export declare function buildGaugeChartModel(model: DataModel, data: readonly Row[], config: GaugeChartConfig): GaugeChartModel;
+//# sourceMappingURL=distribution.d.ts.map

package/dist/distribution.d.ts.map

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

package/dist/distribution.js

@@ -0,0 +1,231 @@
+/**
+ * Distribution and statistical chart data contracts.
+ *
+ * These builders cover rendering-neutral inputs for histograms, box plots,
+ * categorical/calendar heatmaps, bullet charts and gauges.
+ */
+import { aggregate, extractNumbers } from './aggregate.js';
+import { findDimension, findMeasure } from './model.js';
+function cellKey(value) {
+    return value == null ? 'null' : String(value);
+}
+function assertDimension(model, id, role) {
+    if (!findDimension(model, id)) {
+        throw new Error(`Unknown ${role} dimension: ${id}`);
+    }
+}
+function assertValueField(model, id, role) {
+    if (!findMeasure(model, id) && !findDimension(model, id)) {
+        throw new Error(`Unknown ${role} value field: ${id}`);
+    }
+}
+function resolveMeasure(model, id, role) {
+    const measure = findMeasure(model, id);
+    if (!measure) {
+        throw new Error(`Unknown ${role} measure: ${id}`);
+    }
+    return measure;
+}
+function finiteNumbers(values, role) {
+    if (values === undefined)
+        return undefined;
+    const out = [...values];
+    if (out.some((value) => !Number.isFinite(value))) {
+        throw new Error(`${role} must be finite`);
+    }
+    return out;
+}
+function assertDomain(min, max, role) {
+    if (!Number.isFinite(min) || !Number.isFinite(max) || min > max) {
+        throw new Error(`${role} domain must be finite and ordered`);
+    }
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function uniqueKeys(rows, field) {
+    const seen = new Set();
+    const keys = [];
+    for (const row of rows) {
+        const key = cellKey(row[field]);
+        if (!seen.has(key)) {
+            seen.add(key);
+            keys.push(key);
+        }
+    }
+    return keys;
+}
+function groupRows(rows, field) {
+    const groups = new Map();
+    for (const row of rows) {
+        const key = cellKey(row[field]);
+        const bucket = groups.get(key);
+        if (bucket) {
+            bucket.push(row);
+        }
+        else {
+            groups.set(key, [row]);
+        }
+    }
+    return groups;
+}
+export function buildHistogramModel(model, data, config) {
+    assertValueField(model, config.value, 'histogram');
+    const binCount = config.bins ?? 10;
+    if (!Number.isInteger(binCount) || binCount <= 0) {
+        throw new Error('Histogram bins must be a positive integer');
+    }
+    const values = extractNumbers([...data], config.value);
+    if (values.length === 0) {
+        return { valueId: config.value, domain: [Number.NaN, Number.NaN], bins: [] };
+    }
+    const min = config.domain?.[0] ?? Math.min(...values);
+    const max = config.domain?.[1] ?? Math.max(...values);
+    if (!Number.isFinite(min) || !Number.isFinite(max) || min > max) {
+        throw new Error('Histogram domain must be finite and ordered');
+    }
+    if (min === max) {
+        return {
+            valueId: config.value,
+            domain: [min, max],
+            bins: [{ index: 0, x0: min, x1: max, count: values.length }],
+        };
+    }
+    const width = (max - min) / binCount;
+    const counts = Array.from({ length: binCount }, () => 0);
+    for (const value of values) {
+        if (value < min || value > max)
+            continue;
+        const index = Math.min(Math.floor((value - min) / width), binCount - 1);
+        counts[index] += 1;
+    }
+    return {
+        valueId: config.value,
+        domain: [min, max],
+        bins: counts.map((count, index) => ({
+            index,
+            x0: min + index * width,
+            x1: index === binCount - 1 ? max : min + (index + 1) * width,
+            count,
+        })),
+    };
+}
+function quantile(sorted, p) {
+    if (sorted.length === 0)
+        return Number.NaN;
+    const position = (sorted.length - 1) * p;
+    const base = Math.floor(position);
+    const rest = position - base;
+    const current = sorted[base];
+    const next = sorted[base + 1] ?? current;
+    return current + rest * (next - current);
+}
+function boxGroup(key, rows, valueField) {
+    const values = extractNumbers([...rows], valueField).sort((a, b) => a - b);
+    const min = values[0] ?? Number.NaN;
+    const max = values[values.length - 1] ?? Number.NaN;
+    const q1 = quantile(values, 0.25);
+    const median = quantile(values, 0.5);
+    const q3 = quantile(values, 0.75);
+    const iqr = q3 - q1;
+    const lowerFence = q1 - 1.5 * iqr;
+    const upperFence = q3 + 1.5 * iqr;
+    return {
+        key,
+        label: key,
+        count: values.length,
+        min,
+        q1,
+        median,
+        q3,
+        max,
+        outliers: values.filter((value) => value < lowerFence || value > upperFence),
+    };
+}
+export function buildBoxPlotModel(model, data, config) {
+    assertValueField(model, config.value, 'box plot');
+    if (config.group !== undefined) {
+        assertDimension(model, config.group, 'box plot group');
+    }
+    const groups = config.group === undefined
+        ? [boxGroup('All', data, config.value)]
+        : Array.from(groupRows(data, config.group), ([key, rows]) => boxGroup(key, rows, config.value));
+    return { valueId: config.value, groups };
+}
+export function buildHeatmapModel(model, data, config) {
+    assertDimension(model, config.x, 'heatmap x');
+    assertDimension(model, config.y, 'heatmap y');
+    const measure = resolveMeasure(model, config.measure, 'heatmap');
+    const xKeys = uniqueKeys(data, config.x);
+    const yKeys = uniqueKeys(data, config.y);
+    const cells = [];
+    for (const yKey of yKeys) {
+        for (const xKey of xKeys) {
+            cells.push({
+                xKey,
+                yKey,
+                value: aggregate([...data].filter((row) => cellKey(row[config.x]) === xKey && cellKey(row[config.y]) === yKey), measure),
+            });
+        }
+    }
+    return { xKeys, yKeys, cells };
+}
+export function buildBulletChartModel(model, data, config) {
+    const valueMeasure = resolveMeasure(model, config.value, 'bullet value');
+    const targetMeasure = resolveMeasure(model, config.target, 'bullet target');
+    if (config.category !== undefined) {
+        assertDimension(model, config.category, 'bullet category');
+    }
+    const ranges = finiteNumbers(config.ranges, 'Bullet ranges');
+    const groups = config.category === undefined
+        ? new Map([['All', [...data]]])
+        : groupRows(data, config.category);
+    return {
+        label: config.label ?? valueMeasure.label,
+        valueId: config.value,
+        targetId: config.target,
+        data: Array.from(groups, ([key, rows]) => {
+            const datum = {
+                key,
+                label: key,
+                value: aggregate([...rows], valueMeasure),
+                target: aggregate([...rows], targetMeasure),
+            };
+            if (ranges !== undefined)
+                datum.ranges = ranges;
+            return datum;
+        }),
+    };
+}
+export function buildGaugeChartModel(model, data, config) {
+    const valueMeasure = resolveMeasure(model, config.value, 'gauge value');
+    const min = config.min ?? 0;
+    const max = config.max ?? 100;
+    assertDomain(min, max, 'Gauge');
+    const thresholds = config.thresholds === undefined
+        ? undefined
+        : [...config.thresholds]
+            .map((threshold) => {
+            if (!Number.isFinite(threshold.value)) {
+                throw new Error('Gauge threshold values must be finite');
+            }
+            return { ...threshold };
+        })
+            .sort((a, b) => a.value - b.value);
+    const value = aggregate([...data], valueMeasure);
+    const out = {
+        label: config.label ?? valueMeasure.label,
+        valueId: config.value,
+        value,
+        displayValue: Number.isFinite(value) ? clamp(value, min, max) : value,
+        min,
+        max,
+        format: config.format ?? 'number',
+    };
+    if (thresholds !== undefined)
+        out.thresholds = thresholds;
+    if (config.unit !== undefined)
+        out.unit = config.unit;
+    return out;
+}
+//# sourceMappingURL=distribution.js.map

package/dist/distribution.js.map

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

package/dist/fields.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Field-pane view models.
+ *
+ * The core owns BI semantics (dimension/measure, folders, hierarchies, stable
+ * field ids). Framework packages can render these models with DS primitives
+ * such as TreeView and Tag without duplicating field logic.
+ */
+import type { Aggregation, DataModel, DimensionType } from './model.js';
+export type FieldKind = 'dimension' | 'measure';
+export type FieldId = `${FieldKind}:${string}`;
+export type FieldPillTone = 'neutral' | 'info' | 'success' | 'warning' | 'error';
+export interface FieldDescriptor {
+    id: FieldId;
+    sourceId: string;
+    kind: FieldKind;
+    label: string;
+    folder?: string;
+    role: DimensionType | Aggregation;
+    type?: DimensionType;
+    aggregation?: Aggregation;
+    hierarchy?: string[];
+}
+export interface FieldPaneNode {
+    id: string;
+    label: string;
+    children?: FieldPaneNode[];
+    disabled?: boolean;
+    field?: FieldDescriptor;
+}
+export interface FieldPaneTree {
+    nodes: FieldPaneNode[];
+    defaultExpandedIds: string[];
+}
+export interface FieldPaneOptions {
+    includeDimensions?: boolean;
+    includeMeasures?: boolean;
+}
+export interface FieldPillModel {
+    id: FieldId;
+    label: string;
+    detail: string;
+    kind: FieldKind;
+    tone: FieldPillTone;
+}
+export declare function fieldId(kind: FieldKind, sourceId: string): FieldId;
+export declare function parseFieldId(id: string): {
+    kind: FieldKind;
+    sourceId: string;
+} | undefined;
+export declare function listFields(model: DataModel): FieldDescriptor[];
+export declare function buildFieldPaneTree(model: DataModel, options?: FieldPaneOptions): FieldPaneTree;
+export declare function fieldToPill(field: FieldDescriptor): FieldPillModel;
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAChD,MAAM,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;AAC/C,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,GAAG,WAAW,CAAC;IAClC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAM1F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,EAAE,CA6B9D;AAqCD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAgCf;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAmBlE"}