basalt-ui 1.41.0 → 2.0.0

package/dist/charts/primitives/chart-card-context.d.ts

@@ -1,33 +0,0 @@
-import type { Dispatch } from 'react';
-/** One frame claiming or releasing the card's header legend slot. */
-export type LegendSlotAction = {
-    type: 'claim' | 'release';
-    id: string;
-};
-/**
- * The ONE owner of the legend-slot protocol (`docs/waves/PLAN.md` wave 3, P2-9): claimants in claim
- * order, and the head owns the slot. A later claimant is denied simply by not being the head, and
- * it takes over the moment everything ahead of it releases — no retry signal, no ownership mirrored
- * in a ref. Returns the same array on a no-op so a repeated claim/release never re-renders the card.
- */
-export declare function legendSlotReducer(claimants: readonly string[], { type, id }: LegendSlotAction): readonly string[];
-/**
- * `ChartCard`'s internal context: `inCard` (a frame inside a card treats its computed height as a
- * MINIMUM and grows into the card body), the legend slot — the empty header-row box a chart will portal its legend into
- * (`docs/CHARTS-SPEC.md` §5, Legend), so a card has one chrome band, not two — and `short`, the same
- * `measuredHeight < CARD_SHORT_HEIGHT` flag `ChartCard` already computes for the header-fold law
- * (`data-basalt-card-short`), threaded through so `ChartFrame` can fold its header-slot legend to
- * 'dots' before it eats the plot floor (`docs/CHARTS-SPEC.md` §5, wave 11). `null`/`false` until the slot
- * mounts, and outside any card. Deliberately not exported from any barrel.
- *
- * `legendClaimants` is {@link legendSlotReducer}'s queue (its head owns the slot) and
- * `dispatchLegendSlot` feeds it. Outside any card there is no slot, so nothing ever claims.
- */
-export declare const ChartCardContext: import("react").Context<{
-    legendSlot: HTMLDivElement | null;
-    inCard: boolean;
-    short: boolean;
-    legendClaimants: readonly string[];
-    dispatchLegendSlot: Dispatch<LegendSlotAction>;
-}>;
-//# sourceMappingURL=chart-card-context.d.ts.map

package/dist/charts/primitives/chart-card-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chart-card-context.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/chart-card-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,GAC7B,SAAS,MAAM,EAAE,CAInB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB;gBACf,cAAc,GAAG,IAAI;YACzB,OAAO;WACR,OAAO;qBACG,SAAS,MAAM,EAAE;wBACd,QAAQ,CAAC,gBAAgB,CAAC;EAO9C,CAAA"}

package/dist/charts/primitives/chart-card-context.js

@@ -1,18 +0,0 @@
-import { createContext } from "react";
-function legendSlotReducer(claimants, { type, id }) {
-  const held = claimants.includes(id);
-  if (type === "claim") return held ? claimants : [...claimants, id];
-  return held ? claimants.filter((c) => c !== id) : claimants;
-}
-const ChartCardContext = createContext({
-  legendSlot: null,
-  inCard: false,
-  short: false,
-  legendClaimants: [],
-  dispatchLegendSlot: () => {
-  }
-});
-export {
-  ChartCardContext,
-  legendSlotReducer
-};

package/dist/charts/primitives/chart-frame-layout.d.ts

@@ -1,185 +0,0 @@
-/**
- * Pure, DOM-free layout math behind `ChartFrame`'s plot/legend split — extracted so the arithmetic
- * is testable without a `ResizeObserver` and `ChartFrame.tsx` stays the measuring/rendering shell.
- */
-import type { ContainerClass } from '../../tokens/size-classes.js';
-import type { ChartMargin } from '../../tokens/index.js';
-import type { LegendEntry } from './ChartLegend.js';
-/** Gap between two wrapped legend rows — tight (4-6px); the wider `VX.legendGap` separates entries. */
-export declare const LEGEND_ROW_GAP = 6;
-/**
- * The real gap a dots-mode entry needs so its `[data-basalt-hit]::after` overlay can reach the
- * full 44px coarse floor with NO overlap into its neighbour's overlay (`hit-floor.layout.test.ts` +
- * `hit-overlap.layout.test.ts`, wave 4's cap: `styles.css`'s `::after` grows to
- * `min(max(size,44), size + 2 + gap)`). Two 44px-wide overlays centred on same-size hosts touch
- * with zero overlap only once their PITCH (real gap + host size) is itself >= 44 — below that, the
- * cap can only shrink the overlay below 44 (honouring WCAG 2.5.8's spacing route) or let it overlap;
- * there is no gap value that lets it hit 44 exactly while staying flush against a same-size sibling.
- * `LEGEND_DOT_SIZE` is 8px, so the floor is 44 − 8 − 2 = 34; a few px of headroom against rounding.
- */
-export declare const LEGEND_DOT_SIZE = 8;
-export declare const DOTS_HIT_GAP: number;
-/**
- * Order entries series → overlay → reference and record where a divider belongs — the ONE ordering
- * both `ChartLegend`'s render and the resolver's fit math (`chart-layout.ts`) use, so a dots-mode
- * fit never disagrees with what actually wraps (a grouped legend renders dividers as flex items).
- */
-export declare function orderEntries(items: readonly LegendEntry[], groups: boolean): {
-    entries: LegendEntry[];
-    dividerAfter: ReadonlySet<number>;
-};
-/**
- * The two metric sets a chart's chrome resolves to. Internally the container class
- * (`micro`/`compact` → `'phone'`, `regular`/`wide` → `'desktop'`) picks one; there is no `tablet`.
- * Internal only — not on any public barrel.
- */
-export type ChartTier = 'phone' | 'desktop';
-/**
- * A chart height stated per container step instead of as one number — the declarative escape from
- * "every chart on this page is 260px tall on a 375px phone too".
- *
- * `base` is the height below the `regular` class; `regular` and `wide` take effect from
- * `CONTAINER_CLASSES.regular` / `.wide` of the frame's MEASURED width (never the viewport).
- *
- * ```tsx
- * <ChartFrame series={series} height={{ base: 180, wide: 260 }}>{…}</ChartFrame>
- * ```
- */
-export type ResponsiveChartHeight = {
-    base: number;
-    /** From the `regular` container class (480px) up. */
-    regular?: number;
-    /** From the `wide` container class (800px) up. */
-    wide?: number;
-};
-/**
- * Resolve a `height` prop — a plain number, or a {@link ResponsiveChartHeight} — for a container
- * class. A plain number passes through untouched. The class is the measured one, or, before the
- * first measurement, the one implied by the viewport ({@link resolveChartLayout}), so the first
- * frame is not a different height from the second.
- */
-export declare function resolveFrameHeight(height: number | ResponsiveChartHeight, containerClass: ContainerClass): number;
-/**
- * Every size a chart's chrome resolves per tier. One object so a new tier-sensitive size is added
- * in one place and read by name, rather than each primitive branching on the tier itself. Internal
- * only — not on any public barrel.
- */
-export type ChartTierMetrics = {
-    /** Which tier these are, so a consumer of the metrics never needs both values threaded. */
-    tier: ChartTier;
-    /** Axis tick label font size, px. Threaded into BOTH `autoMargin`'s measurement and the painted
-     * axis — measured labels must be the painted labels (`docs/CHARTS-SPEC.md` §1). */
-    axisFont: number;
-    /** Legend label font size, px. */
-    legendFontSize: number;
-    /** Crosshair dot radius, px. */
-    dotR: number;
-    /** Floating tooltip `minWidth`, px. */
-    tooltipMinWidth: number;
-    /** Per-side margin FLOORS (`VX.margin` is a floor, never a ceiling — §1). */
-    margin: ChartMargin;
-};
-/** The metric set a container class resolves to (`micro`/`compact` → phone, else desktop). */
-export declare function chartMetrics(containerClass: ContainerClass): ChartTierMetrics;
-/**
- * The whole legend-cap decision in one place: which cap `ChartLegend` gets, and whether the plot
- * pays for it. Pure, because the COMPOSITION is what once broke (1.30.0 ran a measured fit over a
- * caller's stated number) and the frame that combines them needs a `ResizeObserver` to test.
- *
- * Three cases, in order:
- * 1. The caller STATED `legend.maxRows` (deprecated, still honoured) → it is the cap, and on a
- *    `fill` band the plot yields (`legendWins`). Nothing measured trims it.
- * 2. No `fill` band → the resolver's width-measured fit (`fittedMaxRows`), because the frame grows.
- * 3. A `fill` band with nothing stated → the tighter of that fit and the height-measured
- *    {@link legendEntryCap}, because a `fill` box cannot grow.
- */
-export declare function resolveLegendRollup(input: {
-    /** The caller's own `legend.maxRows`. */
-    statedMaxRows?: number | undefined;
-    /** `resolveChartLayout().legend.visible` when it overflows, else `undefined`. */
-    fittedMaxRows?: number | undefined;
-    /** A visible top/bottom legend on a `fill` frame — the one shape whose box cannot grow. */
-    fillBand: boolean;
-    items: readonly LegendEntry[];
-    containerW: number;
-    /** Frame height the legend may consume — `resolvedHeight - VX.minPlotHeight`. */
-    available: number;
-}): {
-    maxRows: number | undefined;
-    legendWins: boolean;
-};
-/**
- * Resolve the plot rect from the measured box and the measured legend band. Pure and exported so
- * the two floors below are testable without a `ResizeObserver`.
- *
- * `minWidth` is a FIRST-FRAME guard, applied only while `containerW` is still 0 (unmeasured, or
- * SSR); once measured the plot tracks the box exactly, floored at 1 so no scale divides by zero.
- * The legend band is subtracted first, and the remainder stops at `VX.minPlotHeight` — the frame's
- * flex box grows by the difference under a fixed height, and under `fill` (which cannot grow) the
- * legend is capped instead ({@link legendEntryCap}). A caller-stated `legend.maxRows` yields the
- * floor itself (`legendWins`) as far as the box has room ({@link SELF_MEASURED_SLACK}); an
- * unmeasured box (`resolvedHeight <= 0`) stays 0 and renders nothing.
- */
-export declare function resolvePlotRect(input: {
-    containerW: number;
-    resolvedHeight: number;
-    minWidth: number;
-    sideLegendWidth: number;
-    topBottomLegendHeight: number;
-    /**
-     * The caller stated `legend.maxRows` on a `fill` frame, so the legend takes the rows it asked
-     * for and the plot takes what is left — `VX.minPlotHeight` stops being a floor. Without this the
-     * honoured cap would push the frame's content PAST its own cell (the plot holds 120px, the legend
-     * band adds its own) and paint over whatever sits below it; with it, the cost of the caller's
-     * number lands where they can see it. Spend the whole box on legend rows and there is no plot
-     * left to draw — that is their arithmetic, made visible rather than silently rolled up.
-     */
-    legendWins?: boolean;
-}): {
-    width: number;
-    height: number;
-};
-/** How many of `items` fit in `rows` wrapped rows of `width` — the same greedy wrap the flex
- * container performs, measured rather than assumed (`docs/CHARTS-SPEC.md` §1). */
-export declare function entriesWithinRows(items: readonly LegendEntry[], width: number, rows: number): number;
-/**
- * Chips-mode counterpart of {@link entriesWithinDotRows}: once the un-reserved fit overflows, a
- * second pass measures against the width LESS the `All N` chip's own footprint, so the count this
- * returns still leaves the chip room to sit beside it in the same row — same reserve law the dots
- * fit already applied, now applied to chip width instead of a dot's pitch. Returns 0 when not even
- * the first chip fits once the chip's width is reserved, so the row renders the disclosure alone
- * rather than one crowded chip plus a chip that doesn't actually fit next to it.
- */
-export declare function entriesWithinChipRows(items: readonly LegendEntry[], width: number, rows: number): number;
-/**
- * How many of `items` fit as DOTS in `rows` wrapped rows of `width` — the dots-mode counterpart of
- * {@link entriesWithinRows}, measured at the dot's own pitch rather than a chip's width.
- * `dividerAfter` (from {@link orderEntries}) counts a rendered group divider's own gap.
- *
- * Two passes: every entry visible with no `All N` chip (if that fits, no chip is drawn); otherwise
- * reserve the chip's measured width up front so it can never wrap to a row of its own — and, once
- * reserved, allow the answer to be 0: a chip wide enough to leave no room for even the first dot
- * means the row draws the disclosure alone, not one dot crowding a chip that no longer fits beside it.
- */
-export declare function entriesWithinDotRows(items: readonly LegendEntry[], width: number, rows: number, dividerAfter?: ReadonlySet<number>): number;
-/**
- * The entry cap a `fill` frame's legend must respect so the plot keeps `VX.minPlotHeight`. A
- * `fill` frame is pinned to its cell, so the only lever is `ChartLegend`'s `maxRows` rollup; how
- * many entries fit follows from MEASURING the labels, not assuming one per row. Returns
- * `undefined` when the whole legend already fits.
- *
- * Resolves an ABSENT cap only: a caller who stated `legend.maxRows` never reaches here
- * ({@link resolveLegendRollup} routes around it), so the documented escape is never made inert.
- */
-export declare function legendEntryCap(input: {
-    items: readonly LegendEntry[];
-    containerW: number;
-    /** Frame height the legend may consume — `resolvedHeight - VX.minPlotHeight`. */
-    available: number;
-    /**
-     * The cap that applies when nothing explicit was stated — the resolver's width fit. Two
-     * defaults contending: the smaller wins.
-     */
-    defaultMaxRows?: number;
-}): number | undefined;
-//# sourceMappingURL=chart-frame-layout.d.ts.map

package/dist/charts/primitives/chart-frame-layout.d.ts.map

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

package/dist/charts/primitives/chart-frame-layout.js

@@ -1,175 +0,0 @@
-import { HIT_COARSE } from "../../common/hit-floor.js";
-import { VX } from "../../tokens/index.js";
-import { measureText } from "../utils/measure-text.js";
-const LEGEND_LINE_H = Math.ceil(VX.legendFontSize * 1.35);
-const LEGEND_PAD_Y = 10;
-const LEGEND_ROW_GAP = 6;
-const LEGEND_SWATCH_W = 24;
-const LEGEND_DOT_SIZE = 8;
-const DOTS_HIT_GAP = HIT_COARSE - LEGEND_DOT_SIZE - 2 + 4;
-const DOT_PITCH = LEGEND_DOT_SIZE + DOTS_HIT_GAP;
-const GROUP_ORDER = ["series", "overlay", "reference"];
-const roleOf = (item) => item.role ?? "series";
-function orderEntries(items, groups) {
-  if (!groups) return { entries: [...items], dividerAfter: /* @__PURE__ */ new Set() };
-  const dividerAfter = /* @__PURE__ */ new Set();
-  const entries = [];
-  const nonEmptyGroups = GROUP_ORDER.map(
-    (role) => items.filter((item) => roleOf(item) === role)
-  ).filter((group) => group.length > 0);
-  nonEmptyGroups.forEach((group, i) => {
-    entries.push(...group);
-    if (i < nonEmptyGroups.length - 1) dividerAfter.add(entries.length - 1);
-  });
-  return { entries, dividerAfter };
-}
-function resolveFrameHeight(height, containerClass) {
-  if (typeof height === "number") return height;
-  if (containerClass === "wide") return height.wide ?? height.regular ?? height.base;
-  if (containerClass === "regular") return height.regular ?? height.base;
-  return height.base;
-}
-const PHONE_MARGIN_SCALE = 0.75;
-const PHONE_DOT_R = Math.max(VX.dotR - 1, 2);
-const TOOLTIP_MIN_WIDTH = { desktop: 140, phone: 110 };
-const DESKTOP_METRICS = {
-  tier: "desktop",
-  axisFont: VX.axisFont,
-  legendFontSize: VX.legendFontSize,
-  dotR: VX.dotR,
-  tooltipMinWidth: TOOLTIP_MIN_WIDTH.desktop,
-  margin: VX.margin
-};
-const PHONE_METRICS = {
-  tier: "phone",
-  // One step DOWN the shared type ladder, never an arbitrary px value: micro → nano for ticks,
-  // sm → xs for the legend (`TEXT` in tokens/index.ts).
-  axisFont: VX.text.nano,
-  legendFontSize: VX.text.xs,
-  dotR: PHONE_DOT_R,
-  tooltipMinWidth: TOOLTIP_MIN_WIDTH.phone,
-  margin: {
-    top: Math.round(VX.margin.top * PHONE_MARGIN_SCALE),
-    right: Math.round(VX.margin.right * PHONE_MARGIN_SCALE),
-    bottom: Math.round(VX.margin.bottom * PHONE_MARGIN_SCALE),
-    left: Math.round(VX.margin.left * PHONE_MARGIN_SCALE)
-  }
-};
-function chartMetrics(containerClass) {
-  return containerClass === "micro" || containerClass === "compact" ? PHONE_METRICS : DESKTOP_METRICS;
-}
-function resolveLegendRollup(input) {
-  const { statedMaxRows, fittedMaxRows, fillBand, items, containerW, available } = input;
-  if (statedMaxRows !== void 0) return { maxRows: statedMaxRows, legendWins: fillBand };
-  if (!fillBand) return { maxRows: fittedMaxRows, legendWins: false };
-  return {
-    maxRows: legendEntryCap({
-      items,
-      containerW,
-      available,
-      ...fittedMaxRows !== void 0 && { defaultMaxRows: fittedMaxRows }
-    }),
-    legendWins: false
-  };
-}
-function resolvePlotRect(input) {
-  const {
-    containerW,
-    resolvedHeight,
-    minWidth,
-    sideLegendWidth,
-    topBottomLegendHeight,
-    legendWins = false
-  } = input;
-  const room = resolvedHeight - topBottomLegendHeight;
-  const plotFloor = legendWins && !isSelfMeasured(room) ? 0 : VX.minPlotHeight;
-  return {
-    width: containerW === 0 ? minWidth : Math.max(containerW - sideLegendWidth, 1),
-    height: resolvedHeight <= 0 ? 0 : Math.max(room, plotFloor)
-  };
-}
-const SELF_MEASURED_SLACK = 0.5;
-function isSelfMeasured(room) {
-  return room >= 0 && room < SELF_MEASURED_SLACK;
-}
-const legendBandHeight = (rows) => LEGEND_PAD_Y + rows * LEGEND_LINE_H + Math.max(rows - 1, 0) * LEGEND_ROW_GAP;
-const legendEntryWidth = (item) => LEGEND_SWATCH_W + measureText(
-  item.note === void 0 ? item.label : `${item.label} ${item.note}`,
-  VX.legendFontSize
-);
-function fitGreedyRows(items, fit) {
-  let row = 1;
-  let x = 0;
-  let fitted = 0;
-  for (const [i, item] of items.entries()) {
-    const w = fit.widthOf(item);
-    const next = x === 0 ? w : x + fit.gap + w;
-    if (x === 0 && fit.allowZero === true && next > fit.width) return 0;
-    if (next > fit.width && x > 0) {
-      row += 1;
-      if (row > fit.rows) return fitted;
-      x = w;
-    } else {
-      x = next;
-    }
-    fitted += 1;
-    x += fit.extraAfter?.(i) ?? 0;
-  }
-  return fitted;
-}
-const chipFit = { widthOf: legendEntryWidth, gap: VX.legendGap };
-function entriesWithinRows(items, width, rows) {
-  return fitGreedyRows(items, { ...chipFit, width, rows });
-}
-function entriesWithinChipRows(items, width, rows) {
-  const total = items.length;
-  const fittedNoReserve = entriesWithinRows(items, width, rows);
-  if (fittedNoReserve >= total) return fittedNoReserve;
-  const reserve = measureText(`All ${total}`, VX.legendFontSize) + VX.legendGap;
-  return fitGreedyRows(items, {
-    ...chipFit,
-    width: Math.max(width - reserve, 0),
-    rows,
-    allowZero: true
-  });
-}
-function entriesWithinDotRows(items, width, rows, dividerAfter = /* @__PURE__ */ new Set()) {
-  const dotFit = {
-    widthOf: () => LEGEND_DOT_SIZE,
-    gap: DOT_PITCH - LEGEND_DOT_SIZE,
-    rows,
-    extraAfter: (i) => dividerAfter.has(i) ? DOT_PITCH : 0
-  };
-  const total = items.length;
-  const fittedNoReserve = fitGreedyRows(items, { ...dotFit, width });
-  if (fittedNoReserve >= total) return fittedNoReserve;
-  const reserve = measureText(`All ${total}`, VX.legendFontSize) + DOT_PITCH;
-  return fitGreedyRows(items, { ...dotFit, width: Math.max(width - reserve, 0), allowZero: true });
-}
-function legendEntryCap(input) {
-  const { items, containerW, available, defaultMaxRows } = input;
-  if (containerW <= 0 || items.length === 0) return defaultMaxRows;
-  const rows = Math.max(
-    1,
-    Math.floor((available - LEGEND_PAD_Y + LEGEND_ROW_GAP) / (LEGEND_LINE_H + LEGEND_ROW_GAP))
-  );
-  if (legendBandHeight(rows) <= available && entriesWithinRows(items, containerW, rows) >= items.length) {
-    return defaultMaxRows;
-  }
-  const fitted = Math.max(1, entriesWithinRows(items, containerW, rows));
-  return defaultMaxRows === void 0 ? fitted : Math.min(fitted, defaultMaxRows);
-}
-export {
-  DOTS_HIT_GAP,
-  LEGEND_DOT_SIZE,
-  LEGEND_ROW_GAP,
-  chartMetrics,
-  entriesWithinChipRows,
-  entriesWithinDotRows,
-  entriesWithinRows,
-  legendEntryCap,
-  orderEntries,
-  resolveFrameHeight,
-  resolveLegendRollup,
-  resolvePlotRect
-};

package/dist/charts/primitives/chart-layout.d.ts

@@ -1,112 +0,0 @@
-/**
- * `resolveChartLayout` — the single, pure decision point for a chart's space
- * (`docs/CHARTS-SPEC.md` §8): container class, height and legend fit. Also hosts the axis-economy
- * ladder (`resolveYPlacement`, `planXLabels`, `yTickCount`, `compactNumber`, …) that
- * `CartesianChart`/`useBandPlot` call directly. DOM-free and Mantine-free; deliberately not on any
- * public barrel.
- */
-import type { ContainerClass, SIZE_CLASSES } from '../../tokens/size-classes.js';
-import type { ChartMargin } from '../../tokens/index.js';
-import type { LegendEntry } from './ChartLegend.js';
-export type ChartLayout = {
-    containerClass: ContainerClass;
-    height: number;
-    legend: {
-        mode: 'none';
-    } | {
-        mode: 'dots' | 'chips';
-        where: 'header' | 'band';
-        visible: number;
-        overflow: number;
-    };
-};
-export type ChartLayoutInput = {
-    /** The chart frame's MEASURED width; `<= 0` is unmeasured (SSR, first paint). */
-    frameW: number;
-    /** Width of the card's header legend slot; `0` when there is none (the legend takes a band). */
-    slotW: number;
-    /** Viewport height in px (`0` unknown). Only read on a coarse pointer. */
-    viewportH: number;
-    legendItems: readonly LegendEntry[];
-    /** Viewport class — decides the container class until the frame is measured. */
-    sizeClass: keyof typeof SIZE_CLASSES;
-    coarse: boolean;
-    /**
-     * The card's own `short` flag (`ChartCard`'s `measuredHeight < CARD_SHORT_HEIGHT`) — the ONE
-     * source of truth for "this legend gets at most one row", not a second narrower threshold.
-     * Default `false` (no card, or an unmeasured/tall one).
-     */
-    cardShort?: boolean;
-    /** The legend's own `groups` config — whether role dividers render (and so count toward the
-     * dots-mode fit). Default `false`. */
-    groups?: boolean;
-    /** Consumer-stated values; each wins over the derived one. */
-    override?: {
-        height?: number;
-    };
-};
-/** Compact and micro plots are tight: y labels move inside and terminal x labels anchor inward. */
-export declare function isTightClass(containerClass: ContainerClass): boolean;
-/**
- * At a tight container class the y labels move inside the plot (micro: no y axis at all), so the
- * left gutter drops to its floor. Not-tight, no left axis, or an explicit `margin.left` all keep
- * the axis outside — the single implementation `CartesianChart`/`useBandPlot` both call.
- */
-export declare function resolveYPlacement(containerClass: ContainerClass, opts?: {
-    hasLeftAxis?: boolean | undefined;
-    marginOverrideLeft?: number | undefined;
-}): 'outside' | 'inside' | 'none';
-/**
- * Left-margin floor once `resolveYPlacement` moves the labels INSIDE the plot: just enough for the
- * axis line and a hair of breathing room, not the outside axis's full label-width floor. Passing
- * the tier's own `margin.left` here reserves a gutter for a label that no longer paints.
- */
-export declare const INSIDE_Y_FLOOR = 4;
-/**
- * The `autoMargin` FLOOR to measure against, once `resolveYPlacement` has decided where the left
- * axis paints — an axis placed `'outside'` keeps the tier's ordinary margin floor; one placed
- * `'inside'` (or dropped, `'none'`) paints IN the plot, so the outside label-width floor is dead
- * space on that side and only {@link INSIDE_Y_FLOOR} applies. `CartesianChart` and `useBandPlot`
- * used to each spell this same ternary out by hand.
- */
-export declare function resolveMarginFloor(yPlacement: 'outside' | 'inside' | 'none', tierMargin: ChartMargin): ChartMargin;
-/**
- * Ladder step 1: `12500` -> `12.5k`, `1_200_000` -> `1.2M`; `null` below 1000 or non-finite. Rounds
- * BEFORE choosing the unit's suffix, so `999_950` reads `1M`, never `1000k`; the largest unit caps.
- */
-export declare function compactNumber(value: number): string | null;
-/** Ladder step 1's rule: compact only when the longest y label is over 4 chars. */
-export declare function shouldCompactYLabels(labels: readonly string[]): boolean;
-/** Ladder step 2 + the `VX.minPlotHeight` guard: one tick per ~44px, 2 when the plot is under the floor. */
-export declare function yTickCount(plotHeight: number): number;
-/** Greedy word wrap by measured px; a single word wider than `maxPx` keeps its own line. */
-export declare function wrapLabel(label: string, maxPx: number, fontPx: number): string[];
-export type XLabelPlan = {
-    wrap: boolean;
-    rotate: 0 | 45;
-    /** Lines the tallest label takes once wrapped (1 when it does not). */
-    lines: number;
-    /** Px one tick label needs: measured width (wrapped width when wrapping) plus the gap. */
-    labelPx: number;
-    /** Width labels wrap to; `0` when they do not wrap. */
-    wrapPx: number;
-};
-/**
- * Ladder step 4: x labels that do not all fit side by side wrap — categorical (band) domains
- * only, and only when wrapping shows EVERY key. A wrap that would still drop keys buys nothing
- * (it costs a line of bottom gutter to thin the same way flat already would), so it falls back to
- * flat/thinned instead. Rotating is the last resort, reached only once even a full wrap can't fit.
- */
-export declare function planXLabels(input: {
-    labels: readonly string[];
-    plotWidth: number;
-    fontPx: number;
-    categorical: boolean;
-}): XLabelPlan;
-/** The container class: the measured width's, or the viewport-implied one while unmeasured. */
-export declare function resolveFrameClass(input: {
-    frameW: number;
-    sizeClass: keyof typeof SIZE_CLASSES;
-}): ContainerClass;
-export declare function resolveChartLayout(input: ChartLayoutInput): ChartLayout;
-//# sourceMappingURL=chart-layout.d.ts.map

package/dist/charts/primitives/chart-layout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chart-layout.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/chart-layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAQhD,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,EAAE,cAAc,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EACF;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5F,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAA;IACd,gGAAgG;IAChG,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,SAAS,WAAW,EAAE,CAAA;IACnC,gFAAgF;IAChF,SAAS,EAAE,MAAM,OAAO,YAAY,CAAA;IACpC,MAAM,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;0CACsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/B,CAAA;AAyFD,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,cAAc,EAC9B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GACxF,SAAS,GAAG,QAAQ,GAAG,MAAM,CAK/B;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,EACzC,UAAU,EAAE,WAAW,GACtB,WAAW,CAEb;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU1D;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEvE;AAED,4GAA4G;AAC5G,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAehF;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,CAAC,GAAG,EAAE,CAAA;IACd,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,UAAU,CAyCb;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,OAAO,YAAY,CAAA;CACrC,GAAG,cAAc,CAIjB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAOvE"}