@matthieumordrel/chart-studio 0.2.1 → 0.2.2

package/dist/core/chart-capabilities.d.ts

@@ -1,60 +0,0 @@
-import type { ChartType } from './types.js';
-/**
- * X-axis kinds understood by chart-studio when validating chart types.
- */
-export type ChartAxisType = 'date' | 'category' | 'boolean';
-/**
- * Declarative chart-type capability matrix.
- *
- * Centralizing these rules keeps UI controls and state validation aligned as
- * more chart types are added later.
- */
-export type ChartTypeCapabilities = {
-    supportedXAxisTypes: readonly ChartAxisType[];
-    supportsGrouping: boolean;
-    supportsTimeBucketing: boolean;
-};
-/**
- * Capabilities for each supported chart type.
- */
-export declare const CHART_TYPE_CONFIG: {
-    readonly bar: {
-        readonly supportedXAxisTypes: readonly ["date", "category", "boolean"];
-        readonly supportsGrouping: true;
-        readonly supportsTimeBucketing: true;
-    };
-    readonly line: {
-        readonly supportedXAxisTypes: readonly ["date"];
-        readonly supportsGrouping: true;
-        readonly supportsTimeBucketing: true;
-    };
-    readonly area: {
-        readonly supportedXAxisTypes: readonly ["date"];
-        readonly supportsGrouping: true;
-        readonly supportsTimeBucketing: true;
-    };
-    readonly pie: {
-        readonly supportedXAxisTypes: readonly ["category", "boolean"];
-        readonly supportsGrouping: false;
-        readonly supportsTimeBucketing: false;
-    };
-    readonly donut: {
-        readonly supportedXAxisTypes: readonly ["category", "boolean"];
-        readonly supportsGrouping: false;
-        readonly supportsTimeBucketing: false;
-    };
-};
-type ChartTypeAvailability = {
-    hasGroupBy: boolean;
-    xAxisType: ChartAxisType | null;
-};
-/**
- * Whether a chart type can represent the current chart state.
- */
-export declare function isChartTypeAvailable(chartType: ChartType, availability: ChartTypeAvailability): boolean;
-/**
- * Chart types valid for the current axis + feature combination.
- */
-export declare function getAvailableChartTypes(availability: ChartTypeAvailability): ChartType[];
-export {};
-//# sourceMappingURL=chart-capabilities.d.ts.map

package/dist/core/chart-capabilities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chart-capabilities.d.ts","sourceRoot":"","sources":["../../src/core/chart-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAA;AAGzC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,mBAAmB,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,gBAAgB,EAAE,OAAO,CAAA;IACzB,qBAAqB,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B+B,CAAA;AAE7D,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAA;CAChC,CAAA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,qBAAqB,GAClC,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAEvF"}

package/dist/core/chart-capabilities.js

@@ -1,54 +0,0 @@
-import { CHART_TYPE_ORDER } from './config-utils.js';
-/**
- * Capabilities for each supported chart type.
- */
-export const CHART_TYPE_CONFIG = {
-    bar: {
-        supportedXAxisTypes: ['date', 'category', 'boolean'],
-        supportsGrouping: true,
-        supportsTimeBucketing: true,
-    },
-    line: {
-        supportedXAxisTypes: ['date'],
-        supportsGrouping: true,
-        supportsTimeBucketing: true,
-    },
-    area: {
-        supportedXAxisTypes: ['date'],
-        supportsGrouping: true,
-        supportsTimeBucketing: true,
-    },
-    pie: {
-        supportedXAxisTypes: ['category', 'boolean'],
-        supportsGrouping: false,
-        supportsTimeBucketing: false,
-    },
-    donut: {
-        supportedXAxisTypes: ['category', 'boolean'],
-        supportsGrouping: false,
-        supportsTimeBucketing: false,
-    },
-};
-/**
- * Whether a chart type can represent the current chart state.
- */
-export function isChartTypeAvailable(chartType, availability) {
-    const { hasGroupBy, xAxisType } = availability;
-    if (xAxisType === null)
-        return false;
-    const capabilities = CHART_TYPE_CONFIG[chartType];
-    const supportedXAxisTypes = capabilities.supportedXAxisTypes;
-    if (!supportedXAxisTypes.includes(xAxisType)) {
-        return false;
-    }
-    if (hasGroupBy && !capabilities.supportsGrouping) {
-        return false;
-    }
-    return true;
-}
-/**
- * Chart types valid for the current axis + feature combination.
- */
-export function getAvailableChartTypes(availability) {
-    return CHART_TYPE_ORDER.filter((chartType) => isChartTypeAvailable(chartType, availability));
-}

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

@@ -1 +0,0 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/core/colors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,MAAM,CAGtE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,UAAO,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrF"}

package/dist/core/colors.js

@@ -1,54 +0,0 @@
-/**
- * Color assignment for chart series.
- *
- * Uses shadcn chart CSS variables (`--chart-1` through `--chart-5`) by default.
- * Falls back to a built-in OKLCH palette when CSS variables are not available.
- */
-/** Fallback palette using OKLCH for perceptually uniform colors. */
-const FALLBACK_COLORS = [
-    'oklch(0.65 0.15 250)', // blue
-    'oklch(0.65 0.15 350)', // rose
-    'oklch(0.65 0.15 200)', // cyan
-    'oklch(0.65 0.15 70)', // amber
-    'oklch(0.65 0.15 150)', // teal
-    'oklch(0.65 0.15 30)', // orange
-    'oklch(0.65 0.15 300)', // purple
-    'oklch(0.65 0.15 120)', // green
-    'oklch(0.65 0.12 170)', // mint
-    'oklch(0.65 0.12 220)', // slate blue
-];
-/** Shadcn chart CSS variables (5 colors) with safe fallbacks. */
-const SHADCN_CHART_COLORS = [
-    `hsl(var(--chart-1, var(--cs-chart-1, 245 72% 57%)))`,
-    `hsl(var(--chart-2, var(--cs-chart-2, 271 72% 55%)))`,
-    `hsl(var(--chart-3, var(--cs-chart-3, 330 68% 54%)))`,
-    `hsl(var(--chart-4, var(--cs-chart-4, 170 65% 38%)))`,
-    `hsl(var(--chart-5, var(--cs-chart-5, 30 90% 54%)))`,
-];
-/**
- * Get a color for the Nth series.
- * Cycles through the palette when index exceeds palette length.
- *
- * @param index - Zero-based series index
- * @param useShadcn - Whether to use shadcn CSS variables (default: true)
- * @returns CSS color value
- */
-export function getSeriesColor(index, useShadcn = true) {
-    const palette = useShadcn ? SHADCN_CHART_COLORS : FALLBACK_COLORS;
-    return palette[index % palette.length];
-}
-/**
- * Generate a color map for a list of group labels.
- * Assigns colors deterministically based on array order.
- *
- * @param groups - Array of group labels
- * @param useShadcn - Whether to use shadcn CSS variables (default: true)
- * @returns Map from group label to CSS color
- */
-export function buildColorMap(groups, useShadcn = true) {
-    const map = new Map();
-    for (let i = 0; i < groups.length; i++) {
-        map.set(groups[i], getSeriesColor(i, useShadcn));
-    }
-    return map;
-}

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

@@ -1,43 +0,0 @@
-import type { ChartType, TimeBucket } from './types.js';
-type IdOption<TId extends string> = {
-    id: TId;
-};
-type IdControlConfig<TId extends string> = {
-    allowed?: readonly TId[];
-    hidden?: readonly TId[];
-    default?: TId;
-};
-type ValueControlConfig<TValue extends string> = {
-    allowed?: readonly TValue[];
-    hidden?: readonly TValue[];
-    default?: TValue;
-};
-/**
- * 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 declare function restrictConfiguredIdOptions<TId extends string, TOption extends IdOption<TId>>(options: readonly TOption[], config: IdControlConfig<TId> | undefined, fallbackToBaseIfEmpty?: boolean): TOption[];
-/**
- * Resolve one ID-based selection against the current option list.
- */
-export declare function resolveConfiguredIdSelection<TId extends string>(currentValue: TId | null, options: readonly IdOption<TId>[], configuredDefault: TId | undefined, fallbackValue: TId | null, preferFirstAvailable?: boolean): TId | null;
-/**
- * Restrict a primitive option list with `allowed`/`hidden`.
- */
-export declare function restrictConfiguredValues<TValue extends string>(values: readonly TValue[], config: ValueControlConfig<TValue> | undefined, fallbackToBaseIfEmpty?: boolean): TValue[];
-/**
- * Resolve one primitive selection against the current option list.
- */
-export declare function resolveConfiguredValue<TValue extends string>(currentValue: TValue, values: readonly TValue[], configuredDefault: TValue | undefined): TValue;
-/**
- * Ordered time buckets exposed by the headless API.
- */
-export declare const TIME_BUCKET_ORDER: readonly TimeBucket[];
-/**
- * Ordered chart types exposed by the headless API.
- */
-export declare const CHART_TYPE_ORDER: readonly ChartType[];
-export {};
-//# sourceMappingURL=config-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"config-utils.d.ts","sourceRoot":"","sources":["../../src/core/config-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAA;AAEnB,KAAK,QAAQ,CAAC,GAAG,SAAS,MAAM,IAAI;IAClC,EAAE,EAAE,GAAG,CAAA;CACR,CAAA;AAED,KAAK,eAAe,CAAC,GAAG,SAAS,MAAM,IAAI;IACzC,OAAO,CAAC,EAAE,SAAS,GAAG,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,SAAS,GAAG,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,GAAG,CAAA;CACd,CAAA;AAED,KAAK,kBAAkB,CAAC,MAAM,SAAS,MAAM,IAAI;IAC/C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AA+CD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,SAAS,MAAM,EAAE,OAAO,SAAS,QAAQ,CAAC,GAAG,CAAC,EAC3F,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,EACxC,qBAAqB,UAAQ,GAC5B,OAAO,EAAE,CAEX;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,SAAS,MAAM,EAC7D,YAAY,EAAE,GAAG,GAAG,IAAI,EACxB,OAAO,EAAE,SAAS,QAAQ,CAAC,GAAG,CAAC,EAAE,EACjC,iBAAiB,EAAE,GAAG,GAAG,SAAS,EAClC,aAAa,EAAE,GAAG,GAAG,IAAI,EACzB,oBAAoB,UAAO,GAC1B,GAAG,GAAG,IAAI,CAcZ;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,SAAS,MAAM,EAC5D,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,SAAS,EAC9C,qBAAqB,UAAQ,GAC5B,MAAM,EAAE,CAEV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,MAAM,EAC1D,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,MAAM,CAUR;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,UAAU,EAAgD,CAAA;AAEnG;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EAA4C,CAAA"}

package/dist/core/config-utils.js

@@ -1,80 +0,0 @@
-/**
- * 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'];

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

@@ -1,29 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-/**
- * 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 };
-}

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

@@ -1,105 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,44 +0,0 @@
-/**
- * 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',
-        };
-    };
-}

package/dist/core/formatting.d.ts

@@ -1,47 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}