@matthieumordrel/chart-studio 0.1.0

package/dist/core/config-utils.js

@@ -0,0 +1,81 @@
+/**
+ * Build the visible runtime option list after applying config restrictions.
+ *
+ * The pipeline is always:
+ * 1. start from runtime-valid options
+ * 2. if `allowed` exists, keep only allowed entries in declared order
+ * 3. if `hidden` exists, subtract hidden entries
+ *
+ * When `fallbackToBaseIfEmpty` is enabled, required controls can recover their
+ * base runtime options if the config leaves nothing selectable for the active
+ * source. This recovery is intentionally separate from default resolution.
+ */
+function restrictConfiguredCollection(items, config, getKey, fallbackToBaseIfEmpty) {
+    const keyedItems = new Map(items.map(item => [getKey(item), item]));
+    const allowedKeys = config?.allowed;
+    const hiddenKeys = config?.hidden ? new Set(config.hidden) : undefined;
+    const orderedItems = allowedKeys
+        ? allowedKeys.flatMap(allowedKey => {
+            const match = keyedItems.get(allowedKey);
+            return match ? [match] : [];
+        })
+        : [...items];
+    const visibleItems = hiddenKeys
+        ? orderedItems.filter(item => !hiddenKeys.has(getKey(item)))
+        : orderedItems;
+    if (fallbackToBaseIfEmpty && visibleItems.length === 0) {
+        return [...items];
+    }
+    return visibleItems;
+}
+/**
+ * Restrict an ID-keyed option list with `allowed`/`hidden`.
+ *
+ * When `fallbackToBaseIfEmpty` is enabled, required controls keep their base
+ * runtime options even if the config does not match the active source.
+ */
+export function restrictConfiguredIdOptions(options, config, fallbackToBaseIfEmpty = false) {
+    return restrictConfiguredCollection(options, config, option => option.id, fallbackToBaseIfEmpty);
+}
+/**
+ * Resolve one ID-based selection against the current option list.
+ */
+export function resolveConfiguredIdSelection(currentValue, options, configuredDefault, fallbackValue, preferFirstAvailable = true) {
+    if (currentValue && options.some(option => option.id === currentValue)) {
+        return currentValue;
+    }
+    if (configuredDefault && options.some(option => option.id === configuredDefault)) {
+        return configuredDefault;
+    }
+    if (preferFirstAvailable) {
+        return options[0]?.id ?? fallbackValue;
+    }
+    return fallbackValue;
+}
+/**
+ * Restrict a primitive option list with `allowed`/`hidden`.
+ */
+export function restrictConfiguredValues(values, config, fallbackToBaseIfEmpty = false) {
+    return restrictConfiguredCollection(values, config, value => value, fallbackToBaseIfEmpty);
+}
+/**
+ * Resolve one primitive selection against the current option list.
+ */
+export function resolveConfiguredValue(currentValue, values, configuredDefault) {
+    if (values.includes(currentValue)) {
+        return currentValue;
+    }
+    if (configuredDefault && values.includes(configuredDefault)) {
+        return configuredDefault;
+    }
+    return values[0] ?? currentValue;
+}
+/**
+ * Ordered time buckets exposed by the headless API.
+ */
+export const TIME_BUCKET_ORDER = ['day', 'week', 'month', 'quarter', 'year'];
+/**
+ * Ordered chart types exposed by the headless API.
+ */
+export const CHART_TYPE_ORDER = ['bar', 'line', 'area', 'pie', 'donut'];
+//# sourceMappingURL=config-utils.js.map

package/dist/core/config-utils.js.map

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

package/dist/core/date-utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Date range utilities for chart-studio.
+ *
+ * Pure functions for filtering data by date range and computing
+ * the min/max date range from a dataset.
+ */
+import type { DateColumn, DateRangeFilter } from './types.js';
+/**
+ * Filter data by a date range on a specific date column.
+ * Both bounds are inclusive (to is extended to end of day).
+ *
+ * @param data - Raw data items
+ * @param dateColumn - The date column to filter on
+ * @param filter - Date range filter with from/to bounds
+ * @returns Filtered data items within the date range
+ */
+export declare function filterByDateRange<T>(data: readonly T[], dateColumn: DateColumn<T>, filter: DateRangeFilter): T[];
+/**
+ * Compute the min/max date range from data for a given date column.
+ *
+ * @param data - Data items to scan
+ * @param dateColumn - The date column to extract dates from
+ * @returns Object with min and max dates (both null if no valid dates)
+ */
+export declare function computeDateRange<T>(data: readonly T[], dateColumn: DateColumn<T>): {
+    min: Date | null;
+    max: Date | null;
+};
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/core/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../src/core/date-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAE,eAAe,EAAC,MAAM,YAAY,CAAA;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,eAAe,GACtB,CAAC,EAAE,CAeL;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GACxB;IAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;CAAC,CActC"}

package/dist/core/date-utils.js

@@ -0,0 +1,59 @@
+/**
+ * Date range utilities for chart-studio.
+ *
+ * Pure functions for filtering data by date range and computing
+ * the min/max date range from a dataset.
+ */
+/**
+ * Filter data by a date range on a specific date column.
+ * Both bounds are inclusive (to is extended to end of day).
+ *
+ * @param data - Raw data items
+ * @param dateColumn - The date column to filter on
+ * @param filter - Date range filter with from/to bounds
+ * @returns Filtered data items within the date range
+ */
+export function filterByDateRange(data, dateColumn, filter) {
+    const { from, to } = filter;
+    if (!from && !to)
+        return [...data];
+    const toEnd = to ? new Date(to.getFullYear(), to.getMonth(), to.getDate(), 23, 59, 59, 999) : null;
+    return data.filter((item) => {
+        const raw = dateColumn.accessor(item);
+        if (raw == null)
+            return false;
+        const d = new Date(raw);
+        if (Number.isNaN(d.getTime()))
+            return false;
+        if (from && d < from)
+            return false;
+        if (toEnd && d > toEnd)
+            return false;
+        return true;
+    });
+}
+/**
+ * Compute the min/max date range from data for a given date column.
+ *
+ * @param data - Data items to scan
+ * @param dateColumn - The date column to extract dates from
+ * @returns Object with min and max dates (both null if no valid dates)
+ */
+export function computeDateRange(data, dateColumn) {
+    let min = null;
+    let max = null;
+    for (const item of data) {
+        const raw = dateColumn.accessor(item);
+        if (raw == null)
+            continue;
+        const d = new Date(raw);
+        if (Number.isNaN(d.getTime()))
+            continue;
+        if (!min || d < min)
+            min = d;
+        if (!max || d > max)
+            max = d;
+    }
+    return { min, max };
+}
+//# sourceMappingURL=date-utils.js.map

package/dist/core/date-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.js","sourceRoot":"","sources":["../../src/core/date-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAkB,EAClB,UAAyB,EACzB,MAAuB;IAEvB,MAAM,EAAC,IAAI,EAAE,EAAE,EAAC,GAAG,MAAM,CAAA;IACzB,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IAElC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAElG,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,KAAK,CAAA;QAC7B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAA6B,CAAC,CAAA;QACjD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,KAAK,CAAA;QAC3C,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI;YAAE,OAAO,KAAK,CAAA;QAClC,IAAI,KAAK,IAAI,CAAC,GAAG,KAAK;YAAE,OAAO,KAAK,CAAA;QACpC,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,UAAyB;IAEzB,IAAI,GAAG,GAAgB,IAAI,CAAA;IAC3B,IAAI,GAAG,GAAgB,IAAI,CAAA;IAE3B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,GAAG,IAAI,IAAI;YAAE,SAAQ;QACzB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAA6B,CAAC,CAAA;QACjD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAE,SAAQ;QACvC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,CAAC,CAAA;QAC5B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,EAAC,GAAG,EAAE,GAAG,EAAC,CAAA;AACnB,CAAC"}

package/dist/core/define-chart-schema.d.ts

@@ -0,0 +1,105 @@
+import type { ChartTypeConfig, DefinedChartSchema, ExactShape, FiltersConfig, GroupByConfig, MetricConfig, ResolvedFilterColumnIdFromSchema, ResolvedGroupByColumnIdFromSchema, ResolvedMetricColumnIdFromSchema, ResolvedXAxisColumnIdFromSchema, SchemaColumnsValidationShape, TimeBucketConfig, XAxisConfig } from './types.js';
+type SchemaFromSections<T, TColumns extends Record<string, unknown> | undefined, TXAxis, TGroupBy, TFilters, TMetric, TChartType, TTimeBucket> = {
+    columns?: Extract<TColumns, Record<string, unknown> | undefined>;
+    xAxis?: Extract<TXAxis, XAxisConfig<ResolvedXAxisColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>> | undefined>;
+    groupBy?: Extract<TGroupBy, GroupByConfig<ResolvedGroupByColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>> | undefined>;
+    filters?: Extract<TFilters, FiltersConfig<ResolvedFilterColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>> | undefined>;
+    metric?: Extract<TMetric, MetricConfig<ResolvedMetricColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>> | undefined>;
+    chartType?: Extract<TChartType, ChartTypeConfig | undefined>;
+    timeBucket?: Extract<TTimeBucket, TimeBucketConfig | undefined>;
+};
+type DefineChartSchemaInput<T, TColumns extends Record<string, unknown> | undefined, TXAxis, TGroupBy, TFilters, TMetric, TChartType, TTimeBucket> = {
+    /**
+     * Shape the available chart columns.
+     *
+     * This is usually the most important part of the schema. Use it to:
+     * - rename inferred raw fields with `label`
+     * - force a field to a specific `type`
+     * - apply `format` or `formatter`
+     * - remove a raw field with `false`
+     * - add brand new derived columns with `kind: 'derived'`
+     */
+    columns?: TColumns & ExactShape<SchemaColumnsValidationShape<T, NoInfer<TColumns>>, NoInfer<TColumns>>;
+    /**
+     * Restrict which resolved columns may be selected on the X-axis.
+     *
+     * Use this when you want to expose only a subset of possible X-axis fields.
+     */
+    xAxis?: TXAxis & ExactShape<XAxisConfig<ResolvedXAxisColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>>, NoInfer<TXAxis>>;
+    /**
+     * Restrict which resolved columns may be used to split the chart into series.
+     *
+     * This powers grouped / multi-series charts.
+     */
+    groupBy?: TGroupBy & ExactShape<GroupByConfig<ResolvedGroupByColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>>, NoInfer<TGroupBy>>;
+    /**
+     * Restrict which resolved columns appear in the filters UI.
+     *
+     * Only category and boolean-like columns are eligible here.
+     */
+    filters?: TFilters & ExactShape<FiltersConfig<ResolvedFilterColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>>, NoInfer<TFilters>>;
+    /**
+     * Restrict which metrics and aggregate combinations remain selectable.
+     *
+     * Use this when you want to curate the metric dropdown rather than exposing
+     * every available numeric aggregate.
+     */
+    metric?: TMetric & ExactShape<MetricConfig<ResolvedMetricColumnIdFromSchema<T, {
+        columns?: TColumns;
+    }>>, NoInfer<TMetric>>;
+    /** Restrict which chart renderers are available to the user. */
+    chartType?: TChartType & ExactShape<ChartTypeConfig, NoInfer<TChartType>>;
+    /**
+     * Restrict which time buckets remain available for date X-axes.
+     *
+     * Example: allow only `'month'` and `'quarter'`.
+     */
+    timeBucket?: TTimeBucket & ExactShape<TimeBucketConfig, NoInfer<TTimeBucket>>;
+};
+/**
+ * Define one explicit chart schema with strict exact-object checking.
+ *
+ * The schema is the single advanced authoring surface for chart-studio:
+ * `columns` can override or exclude inferred raw fields and also define derived
+ * columns, while the top-level control sections restrict the public chart
+ * contract.
+ *
+ * Typical shape:
+ *
+ * ```ts
+ * const schema = defineChartSchema<Row>()({
+ *   columns: {
+ *     createdAt: {type: 'date', label: 'Created'},
+ *     revenue: {type: 'number', format: 'currency'},
+ *     margin: {
+ *       kind: 'derived',
+ *       type: 'number',
+ *       label: 'Margin',
+ *       format: 'percent',
+ *       accessor: row => row.profit / row.revenue,
+ *     },
+ *   },
+ *   xAxis: {allowed: ['createdAt']},
+ *   metric: {
+ *     allowed: [{kind: 'aggregate', columnId: 'revenue', aggregate: 'sum'}],
+ *   },
+ * })
+ * ```
+ */
+export declare function defineChartSchema<T>(): <const TColumns extends Record<string, unknown> | undefined = undefined, const TXAxis = undefined, const TGroupBy = undefined, const TFilters = undefined, const TMetric = undefined, const TChartType = undefined, const TTimeBucket = undefined>(schema: DefineChartSchemaInput<T, TColumns, TXAxis, TGroupBy, TFilters, TMetric, TChartType, TTimeBucket>) => DefinedChartSchema<T, SchemaFromSections<T, TColumns, TXAxis, TGroupBy, TFilters, TMetric, TChartType, TTimeBucket>>;
+export {};
+//# sourceMappingURL=define-chart-schema.d.ts.map

package/dist/core/define-chart-schema.d.ts.map

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

package/dist/core/define-chart-schema.js

@@ -0,0 +1,45 @@
+/**
+ * Define one explicit chart schema with strict exact-object checking.
+ *
+ * The schema is the single advanced authoring surface for chart-studio:
+ * `columns` can override or exclude inferred raw fields and also define derived
+ * columns, while the top-level control sections restrict the public chart
+ * contract.
+ *
+ * Typical shape:
+ *
+ * ```ts
+ * const schema = defineChartSchema<Row>()({
+ *   columns: {
+ *     createdAt: {type: 'date', label: 'Created'},
+ *     revenue: {type: 'number', format: 'currency'},
+ *     margin: {
+ *       kind: 'derived',
+ *       type: 'number',
+ *       label: 'Margin',
+ *       format: 'percent',
+ *       accessor: row => row.profit / row.revenue,
+ *     },
+ *   },
+ *   xAxis: {allowed: ['createdAt']},
+ *   metric: {
+ *     allowed: [{kind: 'aggregate', columnId: 'revenue', aggregate: 'sum'}],
+ *   },
+ * })
+ * ```
+ */
+export function defineChartSchema() {
+    /**
+     * Brand one schema object while preserving its literal types.
+     *
+     * This is what lets the schema stay both strongly typed and editor-friendly
+     * when it is later passed to `useChart(...)`.
+     */
+    return function defineSchema(schema) {
+        return {
+            ...schema,
+            __chartSchemaBrand: 'chart-schema-definition',
+        };
+    };
+}
+//# sourceMappingURL=define-chart-schema.js.map

package/dist/core/define-chart-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-chart-schema.js","sourceRoot":"","sources":["../../src/core/define-chart-schema.ts"],"names":[],"mappings":"AAkGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,iBAAiB;IAC/B;;;;;OAKG;IACH,OAAO,SAAS,YAAY,CAS1B,MAAyG;QAKzG,OAAO;YACL,GAAG,MAAM;YACT,kBAAkB,EAAE,yBAAyB;SAI9C,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/core/formatting.d.ts

@@ -0,0 +1,47 @@
+import type { ChartColumn, ColumnFormat, TimeBucket } from './types.js';
+/** Formatting surfaces exposed by the chart UI. */
+export type ChartValueSurface = 'axis' | 'tooltip' | 'data-label' | 'raw';
+/** Numeric extent used to choose sensible default precision. */
+export type NumericRange = {
+    min: number;
+    max: number;
+};
+type FormatColumnLike<T> = {
+    type: ChartColumn<T>['type'];
+    format?: ColumnFormat;
+    formatter?: ChartColumn<T>['formatter'];
+    trueLabel?: string;
+    falseLabel?: string;
+};
+type FormatValueOptions<T> = {
+    column: FormatColumnLike<T>;
+    surface: ChartValueSurface;
+    timeBucket?: TimeBucket;
+    numericRange?: NumericRange | null;
+    locale?: string;
+    item?: T;
+};
+/**
+ * Build a numeric range from chart values.
+ */
+export declare function createNumericRange(values: readonly number[]): NumericRange | null;
+/**
+ * Decide whether an axis should keep decimal ticks for the current visible
+ * numeric values.
+ */
+export declare function shouldAllowDecimalTicks(values: readonly number[]): boolean;
+/**
+ * Format one chart value for a specific UI surface.
+ */
+export declare function formatChartValue<T>(value: string | number | boolean | Date | null | undefined, options: FormatValueOptions<T>): string;
+/**
+ * Format a date bucket label from the machine-friendly pipeline key.
+ */
+export declare function formatTimeBucketLabel(key: string, bucket: TimeBucket, surface: ChartValueSurface, locale?: string): string;
+/**
+ * Format the Y-axis or label width estimate with the same surface rules used in
+ * the visible chart.
+ */
+export declare function formatNumericSurfaceValue(value: number, surface: ChartValueSurface, numericRange?: NumericRange | null, format?: ColumnFormat, formatter?: ChartColumn<unknown>['formatter'], locale?: string): string;
+export {};
+//# sourceMappingURL=formatting.d.ts.map

package/dist/core/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/core/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAA2C,UAAU,EAAC,MAAM,YAAY,CAAA;AAE9G,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,CAAA;AAEzE,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAuBD,KAAK,gBAAgB,CAAC,CAAC,IAAI;IACzB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,kBAAkB,CAAC,CAAC,IAAI;IAC3B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC3B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,CAAC,CAAA;CACT,CAAA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,GAAG,IAAI,CAcjF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAY1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC1D,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,MAAM,CAyBR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,SAAU,GACf,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,EAClC,MAAM,CAAC,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,EAC7C,MAAM,SAAU,GACf,MAAM,CAWR"}