basalt-ui 1.41.0 → 2.0.0

package/dist/charts/types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * The public prop vocabulary of `basalt-ui/charts` (`docs/V2-SPEC.md` § 9). React-free and
+ * engine-light: the only engine type named here is the mark array `marks` returns.
+ */
+import type { StoredChartSpec } from '@tanstack/charts/types/core';
+import type { BasaltProps } from '../common/props.js';
+import type { ContainerClass } from '../tokens/size-classes.js';
+import type { CurveName } from './curves.js';
+/** What `x` may return. The value type picks the x scale (§ 9.4): `Date` → time, `number` → linear,
+ * `string` → point (lines) or band (bars). */
+export type ChartX = Date | number | string;
+/**
+ * A plotted series — the single source of truth for color, dash, legend entry and tooltip row. The
+ * legend and the tooltip are derived from it, never authored beside it.
+ */
+export type ChartSeries<T> = {
+    key: string;
+    label: string;
+    /** A `VX.*` ref or a consumer series token (`var(--…)`), never a literal. */
+    color: string;
+    /** `null` is an ABSENCE, never a zero: a gap in the line, no tooltip row, out of the domain. A
+     * series whose `getValue` is always `null` is a legend-only entry (a zone or reference key). */
+    getValue: (d: T) => number | null;
+    /** The legend swatch shape. Default: the kind's own mark (`line` in `Lines`, `bar` in `Bars`). */
+    mark?: 'line' | 'bar' | 'area';
+    /** Default `'solid'`; `'dashed'` is `VX.dashArray` on the line, the legend and the tooltip. */
+    dash?: 'solid' | 'dashed';
+    /** Interpolation between points. Default `'monotone'`. A piecewise-constant quantity (a price
+     * tier, a config value) is a step: a smoothed curve draws values that never existed. */
+    curve?: CurveName;
+    strokeWidth?: number;
+    /** Dims the plotted stroke (a faint companion line). Strokes only. */
+    strokeOpacity?: number;
+    /** Bars and areas. */
+    fillOpacity?: number;
+    /** `Lines`: a soft gradient fill under the line — `true` in the series color, or a color ref. */
+    area?: boolean | string;
+    /** Which y axis the series is measured against. `'right'` needs the chart's `y2`. */
+    axis?: 'left' | 'right';
+    /** Legend grouping: series → overlay → reference. Default `'series'`. */
+    role?: 'series' | 'overlay' | 'reference';
+    /** `false` keeps it out of the legend (a companion line folded under `parent`). Default `true`. */
+    legend?: boolean;
+    /** `false` draws and legends it but never lists it as a tooltip row. Default `true`. */
+    tooltip?: boolean;
+    /** A companion (an MA line) names its parent, so a legend toggle and hover keep the pair. */
+    parent?: string;
+    /** A short qualifier after the label in the legend and the tooltip row, in muted text. */
+    note?: string;
+    /** Per-series tooltip value format; receives the datum so a row can read more than the value. */
+    formatValue?: (v: number, d: T) => string;
+    /** A marker at a point (a PR star, a status dot); `null` for none. */
+    getMarker?: (d: T) => {
+        color?: string;
+        r?: number;
+        fillOpacity?: number;
+        ring?: boolean;
+    } | null;
+};
+/** One y axis. */
+export type AxisConfig<T> = {
+    /**
+     * `'auto'` (default) derives the domain from the VISIBLE series plus this axis' finite zone and
+     * reference-line bounds; a tuple fixes it; a function computes it from the data and the visible
+     * series (so a legend toggle can shrink a stacked domain).
+     */
+    domain?: readonly [number, number] | 'auto' | ((data: readonly T[], visible: readonly ChartSeries<T>[]) => readonly [number, number]);
+    /** When `'auto'`: the raw upper bound is at least this; padding applies after. */
+    autoMaxFloor?: number;
+    /** When `'auto'`: the lower bound is at most this. Default `0` (a zero baseline); `Infinity` pads
+     * down from the data minimum instead. Ignored on a log axis. */
+    autoMinCeil?: number;
+    /** When `'auto'`: padding multiplier away from the data. Default `1.1`. */
+    autoPad?: number;
+    /** A tick count, or the exact tick values. Default: one per ~48px of plot height, ≤ 5. */
+    ticks?: number | readonly number[];
+    /** Tick and tooltip formatter. Default: compact numbers (`12.5k`). */
+    format?: (v: number) => string;
+    /** Horizontal grid rules. Default: on for `y`, off for `y2`. */
+    grid?: boolean;
+    /** Round the domain outward to nice ticks. Default `false` (a fixed domain stays fixed). */
+    nice?: boolean;
+    /** Default `'linear'`. A log axis floors at the smallest positive visible value. */
+    scale?: 'linear' | 'log';
+};
+/** A horizontal band on one y axis. `±Infinity` reaches the plot edge. */
+export type ZoneSpec = {
+    from: number;
+    to: number;
+    fill: string;
+    axisSide?: 'left' | 'right';
+};
+/**
+ * A vertical band between two x values. An omitted bound is the plot's own edge. `'edge'` widens a
+ * present bound by half a sample step, so a band covers its terminal samples in full (a night
+ * from one hour to another, both hours included).
+ */
+export type XZoneSpec<X extends ChartX = ChartX> = {
+    from?: X;
+    to?: X;
+    fill: string;
+    align?: 'center' | 'edge';
+};
+/** A horizontal reference line — annotation only, no domain role beyond staying inside the plot. */
+export type RefLine = {
+    value: number;
+    color: string;
+    dashed?: boolean;
+    axis?: 'left' | 'right';
+};
+/** A fill between the line and a value, on one side of it, tracking the line. */
+export type Threshold = {
+    value: number;
+    side: 'above' | 'below';
+    fill: string;
+};
+/** How a sibling chart's cursor value lands on this chart's x values. Strings always match exactly. */
+export type CursorResolution = 'exact' | 'nearest' | 'leading';
+/** One tooltip row, as data. */
+export type ChartTooltipRow = {
+    label: string;
+    value: string;
+    /** The row swatch; omitted, the row has none. */
+    color?: string;
+};
+export type ChartTooltipConfig<T, X extends ChartX = ChartX> = {
+    /** The tooltip title. Default: the x value through `formatX`'s long form (a date reads
+     * `Mon Sep 1 2026`). */
+    formatHeader?: (x: X, d: T) => string;
+    /** Rows after the per-series rows (a total, a zone badge, a context line). `visible`/`hidden` are
+     * the legend's split, so a row never names a series the plot no longer draws. */
+    rows?: (d: T, ctx: {
+        visible: readonly ChartSeries<T>[];
+        hidden: readonly ChartSeries<T>[];
+    }) => readonly ChartTooltipRow[];
+    /** Show this chart's tooltip while it FOLLOWS a sibling's cursor. Default `false`: only the chart
+     * under the pointer or keyboard focus shows a tooltip and a live region. */
+    onFollow?: boolean;
+};
+export type ChartLegendConfig = {
+    /** Default `'bottom'`. `'header'` draws the legend at the top of the chart body, spaced as the
+     * enclosing `ChartCard`'s header legend row (in the chart's own markup, so it is in the server
+     * HTML and the header never grows); outside a card it is `'top'`. */
+    placement?: 'top' | 'bottom' | 'header';
+    /** Visually separate roles: series | overlay | reference. */
+    groups?: boolean;
+    /** Clicking an entry hides that series. Default: on whenever there are two or more entries. */
+    toggle?: boolean;
+};
+/** A height per container class, `base` below `regular`. A plain number is fixed. */
+export type ResponsiveChartHeight = {
+    base: number;
+    regular?: number;
+    wide?: number;
+};
+/** The three "nothing to draw" states, pending → error → empty. */
+export type ChartState = {
+    pending?: boolean;
+    /** Truthy = the query failed; an `Error`'s message is the label. */
+    error?: unknown;
+    /** `true`, or the empty label itself. */
+    empty?: boolean | string;
+};
+/** A row of `plot.rows(key)`: one per datum, `y: null` kept as a gap. */
+export type PlotRow<T, X extends ChartX = ChartX> = {
+    x: X;
+    y: number | null;
+    series: string;
+    datum: T;
+};
+/** What `CartesianChart`'s `marks` receives. */
+export type PlotContext<T, X extends ChartX = ChartX> = {
+    /** One row per datum for a VISIBLE series; a hidden series returns `[]`, so a legend toggle hides
+     * the mark, its tooltip row and its share of the auto domain together. */
+    rows: (key: string) => PlotRow<T, X>[];
+    /** `series` minus what the legend toggled off. */
+    visible: readonly ChartSeries<T>[];
+    /** The legend entry under the pointer, for emphasis; `null` when none. */
+    highlighted: string | null;
+    /** The measured container class (`regular` on the server). */
+    containerClass: ContainerClass;
+    /** The chart's size in px, for a kind that lays out labels against the plot. */
+    width: number;
+    height: number;
+    /** Bind a mark to the right axis with `yScale: plot.y2` (present only with a `y2` config). */
+    y2: 'y2' | undefined;
+    /** The resolved y domain (and the right axis', with `y2`): basalt's, never the engine's. */
+    yDomain: readonly [number, number];
+    y2Domain: readonly [number, number] | undefined;
+};
+/** The marks a `marks` function returns: TanStack marks from the allowed `@tanstack/charts/*`
+ * subpaths (V2-SPEC § 9.8). basalt re-exports none. */
+export type ChartMarks = StoredChartSpec['marks'];
+export type CartesianChartProps<T, X extends ChartX = ChartX> = BasaltProps & {
+    /** The accessible name. Required: a chart without one is an unlabeled image. */
+    ariaLabel: string;
+    data: readonly T[];
+    x: (d: T) => X;
+    series: readonly ChartSeries<T>[];
+    /** The plot's marks. Draw `plot.rows(key)` / `plot.visible`, never `series` directly. */
+    marks: (plot: PlotContext<T, X>) => ChartMarks;
+    y?: AxisConfig<T>;
+    /** A right axis; series with `axis: 'right'` and marks bound to `plot.y2` read it. */
+    y2?: AxisConfig<T>;
+    /** A tick count, or the exact x tick values. Default: by container class. */
+    xTicks?: number | readonly X[];
+    /** Tick label for an x value. Default: `DD.MM` for dates, compact numbers, strings verbatim. */
+    formatX?: (x: X) => string;
+    zones?: readonly ZoneSpec[];
+    xZones?: readonly XZoneSpec<X>[];
+    refLines?: readonly RefLine[];
+    /** `false` hides the legend. */
+    legend?: ChartLegendConfig | false;
+    /** Default: the height law (measured width × class ratio, 160–420px, ≤ 45vh on touch). */
+    height?: number | ResponsiveChartHeight;
+    state?: ChartState;
+    /** Joins a named cursor group instead of the page-shared default. */
+    cursorGroup?: string;
+    /** Default `'nearest'`. `'leading'` for a series keyed by a bucket's leading edge (a weekly
+     * value keyed by its Monday). */
+    cursorResolution?: CursorResolution;
+    tooltip?: ChartTooltipConfig<T, X> | false;
+};
+/** The x channel of a `plot.rows()` row, as an accessor (a field name does not type-check against a
+ * generic `X`). */
+export declare const rowX: <T, X extends ChartX>(row: PlotRow<T, X>) => X;
+//# sourceMappingURL=types.d.ts.map

package/dist/charts/types.d.ts.map

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

package/dist/charts/types.js

@@ -0,0 +1,4 @@
+const rowX = (row) => row.x;
+export {
+  rowX
+};

package/dist/cli/audit-allows.d.ts

@@ -2,23 +2,10 @@ import type { GuardConfig } from '../guard/index.js';
 import type { BasaltConfig } from './config.js';
 /**
  * `check-theme --audit-allows` — list every active waiver and prove, per waiver, whether it still
- * suppresses anything.
- *
- * The accountability release shipped `theme-allow-unscoped`, which reports a waiver that names no
- * rule — but a waiver that is perfectly well written and covers a finding that no longer exists is
- * invisible to it, and to everything else. Two consumers found five of those by hand, by editing
- * the token out and re-running the guard. This is that method, automated: for each annotation the
- * file is re-checked with THAT occurrence neutralized, and the findings that appear are exactly
- * what it suppresses. Nothing is inferred from the annotation's text, so the audit cannot disagree
- * with the scan — it IS the scan, run twice.
- *
- * `basalt.exemptRules` entries are audited the same way, one pattern at a time. That also answers
- * the question the key could never answer for itself: a pattern that matches no scanned file (a
- * real relative path, say, where the matcher takes whole path SEGMENTS) suppresses nothing and is
- * reported as dead rather than passing silently.
- *
- * Exit 1 when anything is dead, so it can be wired into CI as a gate. A waiver nobody re-checks is
- * how a rule quietly stops applying to the file that needed the exception most.
+ * suppresses anything: the file is re-checked with THAT occurrence neutralized and the findings that
+ * appear are exactly what it suppresses, so the audit cannot disagree with the scan. `exemptRules`
+ * entries are audited one pattern at a time; a pattern matching no scanned file is reported dead.
+ * Exits 1 when anything is dead, so it can gate CI.
  */
 export declare function auditAllows(cwd: string, cfg: BasaltConfig, guardCfg: GuardConfig, scanned: string[]): number;
 //# sourceMappingURL=audit-allows.d.ts.map

package/dist/cli/audit-allows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-allows.d.ts","sourceRoot":"","sources":["../../src/cli/audit-allows.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAW,WAAW,EAAa,MAAM,UAAU,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,UAAU,CAAA;AAoJ7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAsLR"}
+{"version":3,"file":"audit-allows.d.ts","sourceRoot":"","sources":["../../src/cli/audit-allows.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAW,WAAW,EAAa,MAAM,UAAU,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,UAAU,CAAA;AA2I7D;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAsLR"}

package/dist/cli/config.d.ts

@@ -10,7 +10,7 @@ export type BasaltConfig = {
      * off every guard kind whose remedy is a Mantine component, a Mantine prop or the React theme
      * factory, leaving the color and typography kinds live. Default: `'mantine'`.
      *
-     * Deliberately not inferred from a missing `@mantine/core`: silencing 17 rules (the live count is
+     * Deliberately not inferred from a missing `@mantine/core`: silencing the Mantine-coupled rules (the live count is
      * `TOKENS_ONLY_DISABLED_KINDS.size`, which the check-theme banner prints) is a decision, and
      * a repo that keeps Mantine in a workspace package would otherwise switch off half its own guard
      * without saying so. `basalt-ui doctor` detects the shape and tells you to set this.
@@ -90,26 +90,12 @@ export type BasaltConfig = {
      * `inline-display` check.
      */
     inlineDisplay?: boolean;
-    /**
-     * Flag raw `<AxisLeft>` / `<AxisBottom>` / `<AxisRight>` visx JSX inside chart files (a path
-     * containing `/charts/`) — these bypass the `AxisLeftNumeric` / `AxisBottomDate` /
-     * `AxisRightNumeric` primitives that carry the theme tokens + smart ticks. The legitimate wrapper
-     * (`Axes.tsx`, which IS the primitive) is exempt. Default: `true` (ON). Set `false` to disable the
-     * `raw-visx-axis` check.
-     */
-    rawVisxAxis?: boolean;
     /**
      * Flag a hardcoded duration/spring/ease literal inline in a `transition={{...}}` prop — route it
      * through `MOTION_DURATION` / `MOTION_SPRING` / `MOTION_EASE_STANDARD` instead. Default: `true`
      * (ON). Set `false` to disable the `raw-motion-value` check.
      */
     rawMotionValue?: boolean;
-    /**
-     * Flag a chart entry-point JSX tag (`MultiLine`/`Bars`/`Donut`/`DualPanel`/`Heatmap`/`ZonedLine`/
-     * `StackedArea`/`LineSparkline`/`BarSparkline`) missing an `ariaLabel` prop. Default: `true`
-     * (ON). Set `false` to disable the `chart-missing-aria-label` check.
-     */
-    chartMissingAriaLabel?: boolean;
     /**
      * Flag a raw lowercase `<input>`/`<select>`/`<textarea>` JSX element — it bypasses the entire
      * theme, not just the iOS font-size floor. Use the Mantine equivalents (`TextInput`,
@@ -130,21 +116,14 @@ export type BasaltConfig = {
      */
     seriesModulePath?: string;
     /**
-     * Per-rule, per-path exemptions — complements whole-file `exempt` (which skips ALL rules for a
-     * file) and the hardcoded per-kind `appliesTo` scoping (e.g. `raw-visx-axis` → chart files
-     * only). Each value is a list of patterns matched against a finding's relative path. A pattern
-     * may be a whole path segment (`'agent'` matches `src/agent/x.tsx`, not `src/agenting.ts`), a
-     * relative path (`'public/site.webmanifest'`), a directory prefix, or a glob — `*` stops at `/`,
-     * `**` does not, and a slash-free glob also matches the basename, so `'*.module.css'` works.
-     * A trailing `/` is stripped. An entry that suppresses nothing is reported, and
-     * `check-theme --audit-allows` exits 1 on it. Default: `{}` (no exemptions).
+     * Per-rule, per-path exemptions, complementing whole-file `exempt`. A pattern is matched against a
+     * finding's relative path: a path segment (`'agent'` matches `src/agent/x.tsx`, not
+     * `src/agenting.ts`), a relative path, a directory prefix, or a glob (`*` stops at `/`, `**` does
+     * not; a slash-free glob also matches the basename). An entry that suppresses nothing is reported
+     * and `check-theme --audit-allows` exits 1 on it. Default: `{}`.
      *
-     * Two forms per kind. The bare array is paths only. The object form adds the REASON, which is
-     * the half a `theme-allow` carries and this key could not: JSON has no comments, so a
-     * `.webmanifest` / `.json` finding's only escape is this key, and it was un-reviewable by
-     * construction — the rationale ended up in a CLAUDE.md paragraph nobody reads next to the diff.
-     * `check-theme --audit-allows` prints the reason (or names its absence) beside what the entry
-     * still suppresses. The array form stays supported and unchanged; nothing here is required.
+     * The bare array is paths only; the object form adds the REASON (JSON has no comments, so a
+     * `.webmanifest` finding's only escape is this key), which `--audit-allows` prints.
      *
      * @example
      * { exemptRules: { 'inline-display': ['agent'] } } // inline-display never fires under src/agent/**
@@ -154,22 +133,14 @@ export type BasaltConfig = {
      */
     exemptRules?: Partial<Record<GuardKind, ExemptRuleEntry>>;
     /**
-     * Declares an intentional `ai` package major-version skew across workspace packages, exempting
-     * `doctor`'s `ai-major-parity` hard check. The value IS the reason — a bare `true` is rejected,
-     * because the whole point of this key is that the pairing is written down, not just switched off.
-     * A written declaration is the pin `basalt/ai-sdk-major`'s own comment notes is otherwise missing.
-     *
-     * Semantics: absent (or present but not a non-empty string) → the skew still hard-fails exactly as
-     * without this key. A non-empty string with a skew present → `doctor` passes, echoing both the
-     * skew and this reason. A non-empty string with NO skew present → `doctor` warns that the
-     * exemption is stale and can be deleted (an exemption nobody re-checks is how a real, later skew
-     * slips through unnoticed).
+     * Declares an intentional `ai` package major-version skew, exempting `doctor`'s `ai-major-parity`
+     * hard check. The value IS the reason; a bare `true` is rejected. Absent or empty: the skew still
+     * fails. A reason with a skew: `doctor` passes and echoes both. A reason with NO skew: `doctor`
+     * warns the exemption is stale.
      *
      * @example
-     * // apps/api streams on ai@5; apps/dashboard parses on ai@7; a producer-side TransformStream
-     * // neutralizes the one enum value that differs between the two majors.
-     * { aiMajorSkewReason: 'apps/api pinned to ai@5, apps/dashboard on ai@7 — the skew is neutralized '
-     *   + 'by a producer-side TransformStream in apps/api/src/stream-transform.ts' }
+     * { aiMajorSkewReason: 'apps/api pinned to ai@5, apps/dashboard on ai@7 — neutralized by a '
+     *   + 'producer-side TransformStream in apps/api/src/stream-transform.ts' }
      */
     aiMajorSkewReason?: string;
 };

package/dist/cli/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExD,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG;IACzB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IACnC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;wFACoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;IACpD,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAA;IACzD;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,EAAE,CAG5E;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,eAAO,MAAM,YAAY,QAAQ,CAAA;AACjC,eAAO,MAAM,aAAa,UAAiB,CAAA;AAE3C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAExD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExD,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG;IACzB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IACnC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;wFACoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;IACpD,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAA;IACzD;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,EAAE,CAG5E;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,eAAO,MAAM,YAAY,QAAQ,CAAA;AACjC,eAAO,MAAM,aAAa,UAAiB,CAAA;AAE3C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAExD"}

package/dist/cli/doctor-upgrade.d.ts

@@ -0,0 +1,31 @@
+import type { BasaltConfig } from './config.js';
+import type { BasaltInstall } from './index.js';
+export type Check = {
+    fail: string;
+} | {
+    skip: string;
+} | null;
+/** A reference path is a tsconfig file or the directory holding one. */
+export declare const tsconfigFile: (p: string) => string;
+/** `tsconfig-base`: the app's tsconfig must extend the preset the 2.0 types assume. */
+export declare function tsconfigBaseCheck(cwd: string): Check;
+/** `retired-lint-rules`: `basalt/<id>` entries the installed plugin no longer registers. */
+export declare function retiredLintRulesCheck(cwd: string, install: BasaltInstall): Check;
+/** `dropped-subpaths`: `basalt-ui/<subpath>` imports the installed `exports` map does not have. */
+export declare function droppedSubpathsCheck(cwd: string, cfg: BasaltConfig, install: BasaltInstall): Check;
+/**
+ * `init`'s tsconfig step: make the tsconfig that covers `src` (`tsconfig.json`, or the reference that
+ * includes `src` in a stock Vite app) extend the preset, by inserting the key textually (the file is
+ * JSONC, possibly with a BOM). Never creates one. Returns the line to print, or null when nothing
+ * needs saying.
+ */
+export declare function seedTsconfigExtends(cwd: string): string | null;
+/**
+ * `app-wiring`: the entry module `index.html` loads (default src/main.tsx) mounts `BasaltProvider`
+ * on a `createBasaltRouter` router, and the router tree is generated: the vite config calls a
+ * binding imported from `@tanstack/router-plugin` in `plugins`, or a `routeTree.gen.*` already sits
+ * beside the entry (or in src/). `basaltViteConfig` does not register that plugin, so naming it
+ * proves nothing.
+ */
+export declare function appWiringCheck(cwd: string): Check;
+//# sourceMappingURL=doctor-upgrade.d.ts.map

package/dist/cli/doctor-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-upgrade.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-upgrade.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AAgB9D,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,MACc,CAAA;AA+CvD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAqBpD;AA+CD,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAyBhF;AA4CD,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,aAAa,GACrB,KAAK,CA8BP;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkC9D;AAoDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CA+BjD"}