basalt-ui 1.27.0 → 1.28.0

package/dist/charts/utils/format.js

@@ -1,7 +1,10 @@
 const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
 const SHORT_DAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+const NON_FINITE = "\u2014";
 function fmtAxisDate(value) {
+  if (typeof value === "number" && !Number.isFinite(value)) return NON_FINITE;
   if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return NON_FINITE;
     const dd = String(value.getDate()).padStart(2, "0");
     const mm = String(value.getMonth() + 1).padStart(2, "0");
     return `${dd}.${mm}`;
@@ -12,7 +15,9 @@ function fmtAxisDate(value) {
   return s;
 }
 function fmtTooltipDate(date) {
+  if (typeof date === "number" && !Number.isFinite(date)) return NON_FINITE;
   if (date instanceof Date) {
+    if (Number.isNaN(date.getTime())) return NON_FINITE;
     return `${SHORT_DAYS[date.getDay()]} ${MONTHS[date.getMonth()]} ${date.getDate()} ${date.getFullYear()}`;
   }
   const s = String(date ?? "");
@@ -21,7 +26,65 @@ function fmtTooltipDate(date) {
   const d = new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]));
   return `${SHORT_DAYS[d.getDay()]} ${MONTHS[d.getMonth()]} ${d.getDate()} ${d.getFullYear()}`;
 }
+const formatterCache = /* @__PURE__ */ new Map();
+const COMPACT_K = /(\d\s?)K/;
+function numberFormat(locale, options) {
+  const key = `${locale ?? ""}|${JSON.stringify(options)}`;
+  const cached = formatterCache.get(key);
+  if (cached !== void 0) return cached;
+  const created = new Intl.NumberFormat(locale, options);
+  formatterCache.set(key, created);
+  return created;
+}
+function fmtCompact(value, options = {}) {
+  if (!Number.isFinite(value)) return NON_FINITE;
+  const { digits = 1, locale } = options;
+  return numberFormat(locale, {
+    notation: "compact",
+    compactDisplay: "short",
+    maximumFractionDigits: digits
+  }).format(value).replace(COMPACT_K, "$1k");
+}
+function fmtPercent(value, options = {}) {
+  if (!Number.isFinite(value)) return NON_FINITE;
+  const { digits = 0, input = "ratio", locale } = options;
+  return numberFormat(locale, {
+    style: "percent",
+    minimumFractionDigits: digits,
+    maximumFractionDigits: digits
+  }).format(input === "percent" ? value / 100 : value);
+}
+function fmtCurrency(value, options) {
+  if (!Number.isFinite(value)) return NON_FINITE;
+  const { currency, compact = false, digits, locale } = options;
+  const fractionDigits = digits ?? (compact ? 1 : 0);
+  return numberFormat(locale, {
+    style: "currency",
+    currency,
+    ...compact && { notation: "compact", compactDisplay: "short" },
+    minimumFractionDigits: compact ? 0 : fractionDigits,
+    maximumFractionDigits: fractionDigits
+  }).format(value).replace(COMPACT_K, "$1k");
+}
+function fmtInt(value, options = {}) {
+  if (!Number.isFinite(value)) return NON_FINITE;
+  return numberFormat(options.locale, { maximumFractionDigits: 0 }).format(value);
+}
+const formatters = {
+  compact: fmtCompact,
+  percent: fmtPercent,
+  currency: fmtCurrency,
+  int: fmtInt,
+  axisDate: fmtAxisDate,
+  tooltipDate: fmtTooltipDate
+};
 export {
+  NON_FINITE,
   fmtAxisDate,
-  fmtTooltipDate
+  fmtCompact,
+  fmtCurrency,
+  fmtInt,
+  fmtPercent,
+  fmtTooltipDate,
+  formatters
 };

package/dist/charts/utils/ticks.d.ts

@@ -1,5 +1,84 @@
-/** Pick evenly-spaced tick values that fit the available width */
-export declare function smartTicks(dates: string[], xMax: number): string[];
+import type { ChartTier } from '../primitives/chart-frame-layout.js';
+/**
+ * The horizontal room one x tick label needs: the widest string in `labels`, plus breathing space
+ * to its neighbour. Feeds `smartTicks`, which otherwise thinned the axis by a constant that knew
+ * nothing about what was actually painted (`docs/CHARTS-SPEC.md` §1). Shared by `CartesianChart`,
+ * `useBandPlot` and `DualPanel` — the three call sites that used to reimplement this formula.
+ *
+ * `fontPx` defaults to `VX.axisFont`; a phone-tier chart passes its own smaller tick font
+ * (`chartTierMetrics().axisFont`) so the spacing is derived from the size actually painted.
+ */
+export declare function xLabelPxFor(labels: string[], fontPx?: number): number;
+/**
+ * Pick evenly-spaced tick values that fit the available width.
+ *
+ * `labelPx` is the width one formatted label actually needs (measured, plus the gap it wants from
+ * its neighbour) and overrides the `VX.minPxPerTick` floor whenever it is wider. Without it the
+ * spacing came from that constant alone regardless of what was painted, so a `formatX` returning
+ * `Mar 08 14:00` overlapped at every width — the one side of the chart that did not follow §1's
+ * "measure what you paint" law. Omit it and nothing moves.
+ *
+ * The final key is still appended when the step misses the last index — a thinned axis would
+ * otherwise paint no label at the right edge at all — but it no longer prints ON TOP of its
+ * neighbour. An appended tick lands a PARTIAL step from the last one on the grid, so at any tick
+ * count wide enough labels overlap there; measured at `/charts-stress` block (f1), `Mar 13 14:00`
+ * and `Mar 14 14:00` printed over each other at 1440px. When that gap is narrower than one label,
+ * the grid tick before it is dropped instead. Index 0 is never dropped: the left edge is the one
+ * label a reader orients from.
+ */
+export declare function smartTicks(dates: string[], xMax: number, labelPx?: number): string[];
+/**
+ * Which of a BAND axis's category labels may be painted so that no two neighbours overlap — the
+ * same measured law {@link smartTicks} applies to a point axis, for a chart that lays its labels
+ * out itself instead of through the `Axis*` primitives.
+ *
+ * `Heatmap` was the one kind rendering labels as plain `<text>`, and therefore the one kind exempt
+ * from §1's measured-margin law: it printed all 12 columns at 390px, ten of them overlapping. Here
+ * `bandPx` is the pitch between two neighbouring labels (a cell's width for columns, its height for
+ * rows) and `labelPx` the room one label needs ({@link xLabelPxFor} for a horizontal run, the line
+ * box for a vertical one); a label is kept every `ceil(labelPx / bandPx)` bands, so the gap between
+ * two painted labels is never narrower than one label.
+ *
+ * The first and last band always keep theirs — they are the two a reader orients from — and when
+ * the last one lands a partial step from the grid, the grid label before it is dropped rather than
+ * printed underneath, exactly as `smartTicks` does with its appended final tick.
+ */
+export declare function thinLabels(labels: readonly string[], bandPx: number, labelPx: number): Set<number>;
 /** Variant of smartTicks that targets an exact tick count rather than deriving from width. */
 export declare function smartTicksEvery(dates: string[], count: number): string[];
+/**
+ * The phone tier's default x-label rotation: 45° when the labels are so wide that fewer than
+ * {@link MIN_HORIZONTAL_TICKS} of them fit side by side, else none.
+ *
+ * `xLabelRotate` already existed as the answer to a `formatX` too wide to repeat horizontally
+ * (`docs/CHARTS-SPEC.md` §1) — it just had to be reached for by hand, per chart, by someone who
+ * had already seen it collide on a phone. This makes it the DEFAULT at phone width and only there:
+ * rotating trades horizontal crowding for bottom-gutter depth, which is the cheap axis on a narrow
+ * viewport and the expensive one on a wide screen that had room all along. Opt out with an
+ * explicit `xLabelRotate: 0`.
+ *
+ * Deliberately measured against the same `labelPx` `smartTicks` thins by, so the decision and the
+ * thinning cannot disagree about how wide a label is.
+ *
+ * **Wanting to rotate is not the same as rotating fitting.** A rotated label reaches into the LEFT
+ * gutter (`rotatedLabelExtents`), so rotating BUYS bottom-gutter depth and SPENDS plot width — and
+ * at a narrow enough box it spends more than it buys. `/charts-stress` block (f1) is the case:
+ * three clean horizontal labels at 390, and at 320 an auto-rotation that reached off the left edge
+ * and bought not one extra label for it. So the trade is CHECKED, not assumed. Pass `rotatedXMax`
+ * (the width left once `autoMargin({ rotate: 45 })` has taken its deeper left gutter) and the
+ * rotation is taken only when the rotated axis paints MORE labels than the flat one at its
+ * projected pitch (`labelPx · cos 45°`), and at least two of them. Otherwise the axis stays flat
+ * and `smartTicks` thins further — two readable horizontal labels beat two tilted ones in a
+ * narrower plot. Omit `rotatedXMax` and the check is skipped.
+ */
+export declare function autoXLabelRotate(input: {
+    tier: ChartTier;
+    /** Plot width available to the x axis, from the UNROTATED margin. */
+    xMax: number;
+    /** What one x label needs horizontally ({@link xLabelPxFor}). */
+    labelPx: number;
+    /** Plot width that would REMAIN once the rotated margin takes its deeper left gutter
+     * (`autoMargin({ rotate: 45 })`). Omit to skip the fit check. */
+    rotatedXMax?: number;
+}): 0 | 45;
 //# sourceMappingURL=ticks.d.ts.map

package/dist/charts/utils/ticks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/ticks.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlE;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxE"}
+{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/ticks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAMjE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAoB,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBpF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,GAAG,CAAC,MAAM,CAAC,CAkBb;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxE;AAaD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf;qEACiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,CAAC,GAAG,EAAE,CAST"}

package/dist/charts/utils/ticks.js

@@ -1,10 +1,45 @@
 import { VX } from "../../tokens/index.js";
-function smartTicks(dates, xMax) {
+import { maxTextWidth } from "./measure-text.js";
+const X_TICK_LABEL_GAP = 8;
+function xLabelPxFor(labels, fontPx = VX.axisFont) {
+  return maxTextWidth(labels, fontPx) + X_TICK_LABEL_GAP;
+}
+function smartTicks(dates, xMax, labelPx) {
   if (dates.length === 0) return [];
-  const maxTicks = Math.max(2, Math.floor(xMax / VX.minPxPerTick));
+  const perTick = Math.max(VX.minPxPerTick, labelPx ?? 0);
+  const maxTicks = Math.max(2, Math.floor(xMax / perTick));
   if (dates.length <= maxTicks) return dates;
   const step = Math.ceil(dates.length / maxTicks);
-  return dates.filter((_, i) => i % step === 0 || i === dates.length - 1);
+  const last = dates.length - 1;
+  const keep = /* @__PURE__ */ new Set();
+  for (let i = 0; i <= last; i += step) keep.add(i);
+  const lastOnGrid = Math.floor(last / step) * step;
+  if (lastOnGrid !== last) {
+    const pxPerIndex = dates.length > 0 ? xMax / dates.length : 0;
+    const gapPx = (last - lastOnGrid) * pxPerIndex;
+    if (lastOnGrid > 0 && gapPx > 0 && gapPx < perTick) keep.delete(lastOnGrid);
+    keep.add(last);
+  }
+  return dates.filter((_, i) => keep.has(i));
+}
+function thinLabels(labels, bandPx, labelPx) {
+  const keep = /* @__PURE__ */ new Set();
+  const last = labels.length - 1;
+  if (last < 0) return keep;
+  keep.add(0);
+  if (last === 0) return keep;
+  if (bandPx <= 0 || labelPx <= 0) {
+    keep.add(last);
+    return keep;
+  }
+  const step = Math.max(1, Math.ceil(labelPx / bandPx));
+  for (let i = 0; i <= last; i += step) keep.add(i);
+  const lastOnGrid = Math.floor(last / step) * step;
+  if (lastOnGrid !== last && lastOnGrid > 0 && (last - lastOnGrid) * bandPx < labelPx) {
+    keep.delete(lastOnGrid);
+  }
+  keep.add(last);
+  return keep;
 }
 function smartTicksEvery(dates, count) {
   if (dates.length === 0) return [];
@@ -12,7 +47,22 @@ function smartTicksEvery(dates, count) {
   const step = Math.ceil(dates.length / count);
   return dates.filter((_, i) => i % step === 0 || i === dates.length - 1);
 }
+const MIN_HORIZONTAL_TICKS = 3;
+const COS_45 = Math.SQRT1_2;
+function autoXLabelRotate(input) {
+  const { tier, xMax, labelPx, rotatedXMax } = input;
+  if (tier !== "phone") return 0;
+  if (labelPx <= 0 || xMax <= 0) return 0;
+  const flatLabels = Math.floor(xMax / labelPx);
+  if (flatLabels >= MIN_HORIZONTAL_TICKS) return 0;
+  if (rotatedXMax === void 0) return 45;
+  const rotatedLabels = Math.floor(rotatedXMax / (labelPx * COS_45));
+  return rotatedLabels >= 2 && rotatedLabels > flatLabels ? 45 : 0;
+}
 export {
+  autoXLabelRotate,
   smartTicks,
-  smartTicksEvery
+  smartTicksEvery,
+  thinLabels,
+  xLabelPxFor
 };

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

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

package/dist/cli/index.js

@@ -1621,7 +1621,7 @@ const AGENT_LINE_BUDGETS = {
   "agent/rules/basalt-mantine.md": 180,
   "agent/rules/basalt-charts.md": 140,
   "agent/rules/basalt-state.md": 160,
-  "agent/rules/basalt-controls.md": 160,
+  "agent/rules/basalt-controls.md": 185,
   "agent/rules/basalt-batteries.md": 220,
   "agent/skills/basalt-app/SKILL.md": 100,
   "agent/skills/basalt-design/SKILL.md": 100,
@@ -1682,7 +1682,7 @@ function checkCoverage(flags = []) {
     }
   }
   for (const exportKey of pkgExports) {
-    if (exportKey === "." || exportKey === "./styles.css" || exportKey.startsWith("./configs/"))
+    if (exportKey === "." || exportKey === "./styles.css" || exportKey === "./package.json" || exportKey.startsWith("./configs/"))
       continue;
     if (!Object.hasOwn(SURFACES, exportKey)) {
       failures.push(`package.json exports key '${exportKey}' has no matching SURFACES entry`);

package/dist/commands/ShortcutsHelp.d.ts

@@ -1,4 +1,5 @@
-export type ShortcutsHelpProps = {
+import type { BasaltProps } from '../common/props.js';
+export type ShortcutsHelpProps = BasaltProps & {
     /** Section title. Default: 'Keyboard shortcuts'. */
     title?: string;
     /** Max-width passthrough (Mantine style prop). */
@@ -13,5 +14,5 @@ export type ShortcutsHelpProps = {
  * @example
  * <ShortcutsHelp title="Keyboard shortcuts" />
  */
-export declare function ShortcutsHelp({ title, maw }: ShortcutsHelpProps): import("react").JSX.Element | null;
+export declare function ShortcutsHelp({ title, maw, className, style, }: ShortcutsHelpProps): import("react").JSX.Element | null;
 //# sourceMappingURL=ShortcutsHelp.d.ts.map

package/dist/commands/ShortcutsHelp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShortcutsHelp.d.ts","sourceRoot":"","sources":["../../src/commands/ShortcutsHelp.tsx"],"names":[],"mappings":"AA2BA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB,CAAA;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAA4B,EAAE,GAAG,EAAE,EAAE,kBAAkB,sCAyDtF"}
+{"version":3,"file":"ShortcutsHelp.d.ts","sourceRoot":"","sources":["../../src/commands/ShortcutsHelp.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAQlD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAC7C,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB,CAAA;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAA4B,EAC5B,GAAG,EACH,SAAS,EACT,KAAK,GACN,EAAE,kBAAkB,sCAyDpB"}

package/dist/commands/ShortcutsHelp.js

@@ -1,6 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Box, Group, Kbd, Stack, Text, Title } from "@mantine/core";
+import { cx } from "../common/props.js";
 import { toShortcutList } from "./projectors.js";
 import { detectMac, parseShortcut } from "./shortcut-format.js";
 import { VX } from "../tokens/index.js";
@@ -15,7 +16,12 @@ function ShortcutRow({
     /* @__PURE__ */ jsx(Group, { gap: 4, children: keys.map((key, i) => /* @__PURE__ */ jsx(Kbd, { size: "xs", children: key }, i)) })
   ] });
 }
-function ShortcutsHelp({ title = "Keyboard shortcuts", maw }) {
+function ShortcutsHelp({
+  title = "Keyboard shortcuts",
+  maw,
+  className,
+  style
+}) {
   const [isMac, setIsMac] = useState(false);
   useEffect(() => {
     setIsMac(detectMac());
@@ -32,7 +38,7 @@ function ShortcutsHelp({ title = "Keyboard shortcuts", maw }) {
       grouped.set(key, [entry]);
     }
   }
-  return /* @__PURE__ */ jsxs(Box, { maw, children: [
+  return /* @__PURE__ */ jsxs(Box, { maw, className: cx(className), ...style !== void 0 && { style }, children: [
     /* @__PURE__ */ jsx(Title, { order: 5, mb: "sm", children: title }),
     /* @__PURE__ */ jsx(Stack, { gap: "md", children: [...grouped.entries()].map(([group, entries]) => /* @__PURE__ */ jsxs(Stack, { gap: 2, children: [
       group !== "" && /* @__PURE__ */ jsx(

package/dist/commands/define-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-commands.d.ts","sourceRoot":"","sources":["../../src/commands/define-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAIvC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;IACpB,yCAAyC;IACzC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAIhD,wEAAwE;AACxE,KAAK,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAA;AAcvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGrE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvF;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,UAAU,CAAC,CAExD"}
+{"version":3,"file":"define-commands.d.ts","sourceRoot":"","sources":["../../src/commands/define-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAKvC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;IACpB,yCAAyC;IACzC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAIhD,wEAAwE;AACxE,KAAK,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAA;AAcvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGrE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvF;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,UAAU,CAAC,CAExD"}

package/dist/commands/define-commands.js

@@ -1,3 +1,4 @@
+import { isDev } from "../utils/is-dev.js";
 let activeCommands = {};
 function defineCommands(spec) {
   activeCommands = spec;
@@ -9,8 +10,7 @@ function defineCommand(cmd) {
 function runCommand(id, ctx) {
   const cmd = activeCommands[id];
   if (cmd === void 0) {
-    if (process.env["NODE_ENV"] !== "production")
-      console.warn(`[basalt] runCommand: no command registered for "${id}"`);
+    if (isDev()) console.warn(`[basalt] runCommand: no command registered for "${id}"`);
     return;
   }
   return cmd.run(ctx);

package/dist/commands/define-overlays.d.ts

@@ -27,6 +27,27 @@
  */
 import type { ReactNode } from 'react';
 import type { Slot } from '../register.js';
+/**
+ * Declare that a `@mantine/modals` `<ModalsProvider>` is mounted and serving, and get back the
+ * function that retracts it. `BasaltOverlays` calls this for its own provider; a consumer mounting
+ * the provider THEMSELVES (with `<BasaltOverlays modals={false} />`, or with no `BasaltOverlays` at
+ * all) calls it too, or `overlays.confirm` cannot tell their provider from no provider and rejects.
+ *
+ * There is no way to detect the provider from outside React — its context is only readable through
+ * `useModals()`, and `confirm` is an imperative call with no component to read it from. So the
+ * registration is explicit.
+ *
+ * @example
+ * useEffect(() => registerModalsProvider(), [])
+ * // …beside your own <ModalsProvider> mount.
+ */
+export declare function registerModalsProvider(): () => void;
+/**
+ * Internal — `BasaltOverlays` registers its OWN lazy `ModalsProvider` here, and only when it
+ * actually renders one. Deliberately NOT on the `./commands` barrel (internal wiring only, same as
+ * `notifications/mount-guard`); the consumer-facing half is {@link registerModalsProvider}.
+ */
+export declare function useModalsLayer(enabled: boolean): void;
 /**
  * A single registered overlay. The per-overlay props type P is the consumer's own payload.
  *
@@ -92,6 +113,68 @@ export declare function defineOverlays<const T extends OverlayMap>(spec: T): T;
  * // Then include it in a defineOverlays({ 'confirm:delete': deleteOverlay }) call to register it.
  */
 export declare function defineOverlay<P = Record<string, unknown>>(overlay: Overlay<P>): Overlay<P>;
+/** Options for {@link overlays.confirm} — a two-button dialog that resolves to the answer. */
+export type ConfirmOptions = {
+    /** Dialog title — the question itself ("Delete photo.jpg?"), not a category. */
+    title: ReactNode;
+    /** Optional body under the title. A plain string is fine; a ReactNode renders as-is. */
+    body?: ReactNode;
+    /** Confirm button label. Default: 'Confirm'. */
+    confirmLabel?: string;
+    /** Cancel button label. Default: 'Cancel'. */
+    cancelLabel?: string;
+    /** Paint the confirm button in the destructive tone (the theme's derived `red` family). */
+    danger?: boolean;
+    /** Runs once, before the promise resolves `true`. */
+    onConfirm: () => void;
+    /** Runs once on cancel, escape, click-outside or the close button — every non-confirm exit. */
+    onCancel?: () => void;
+};
+/** Options for {@link overlays.confirmDelete} — the delete idiom over {@link ConfirmOptions}. */
+export type ConfirmDeleteOptions = {
+    /**
+     * The singular noun for what is being deleted — `'item'`, `'photo'`, `'API key'`. Pluralised by
+     * appending `s` when `count` is not 1; a noun that does not pluralise that way calls
+     * {@link overlays.confirm} directly with its own title.
+     */
+    subject: string;
+    /** How many. Default: 1. */
+    count?: number;
+    /** Runs once, before the promise resolves `true`. */
+    onConfirm: () => void;
+};
+/**
+ * Open a confirm dialog and resolve to the user's answer — `true` on confirm, `false` on every
+ * other exit (cancel, escape, click-outside, the close button). `onConfirm`/`onCancel` fire exactly
+ * once each at most, before the promise settles.
+ *
+ * Rejects with a named `[basalt]` error when the modals layer cannot serve the dialog — the
+ * `@mantine/modals` peer is absent, or no `ModalsProvider` is registered as live (see
+ * {@link registerModalsProvider}). Both would otherwise leave the promise pending forever: the
+ * imperative API is a window event bus with nothing subscribed.
+ *
+ * @example
+ * if (await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })) navigate('/')
+ *
+ * @example
+ * await overlays.confirm({
+ *   title: 'Revoke access?',
+ *   body: 'The key stops working immediately.',
+ *   confirmLabel: 'Revoke',
+ *   danger: true,
+ *   onConfirm: () => revoke(),
+ * })
+ */
+declare function confirm(options: ConfirmOptions): Promise<boolean>;
+/**
+ * The delete confirmation every app writes — `confirm` with the destructive tone, the `Delete`
+ * label and a counted title already filled in.
+ *
+ * @example
+ * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+ * // → "Delete 3 items?"
+ */
+declare function confirmDelete(options: ConfirmDeleteOptions): Promise<boolean>;
 /**
  * Extract the props type for a registered overlay key.
  * When Overlays is un-augmented ({}) this resolves to `never` so open() is uncallable.
@@ -106,8 +189,13 @@ type OverlayProps<K extends OverlayKey> = Overlays extends {
  * quick-edit panels). For shareable/back-button/refreshable overlays use route masks via
  * ./router-tanstack.
  *
+ * `open` needs a REGISTERED overlay; `confirm`/`confirmDelete` need none — they are the two-button
+ * dialog every app was hand-writing as a registry entry.
+ *
  * @example
  * overlays.open('confirm:delete', { name: 'photo.jpg' })
+ * await overlays.confirm({ title: 'Discard draft?', danger: true, onConfirm: () => reset() })
+ * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
  * overlays.close()
  */
 export declare const overlays: {
@@ -122,6 +210,20 @@ export declare const overlays: {
      * overlays.open('user:edit', { id: '42' })
      */
     open<K extends OverlayKey>(key: K, props: OverlayProps<K>): void;
+    /**
+     * Open a confirm dialog and resolve to the answer — see {@link confirm}.
+     *
+     * @example
+     * const ok = await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })
+     */
+    confirm: typeof confirm;
+    /**
+     * The one-line delete idiom over {@link confirm} — see {@link confirmDelete}.
+     *
+     * @example
+     * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+     */
+    confirmDelete: typeof confirmDelete;
     /**
      * Close all open overlays (delegates to modals.closeAll()).
      *

package/dist/commands/define-overlays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-overlays.d.ts","sourceRoot":"","sources":["../../src/commands/define-overlays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAmBvC;;;;;;;;GAQG;AAEH,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACjD,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,iDAAiD;IACjD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAA;CAChC,CAAA;AAED;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;AAIrD,wEAAwE;AACxE,KAAK,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAA;AAaxD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGrE;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F;AAID;;;;GAIG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,UAAU,IAAI,QAAQ,SAAS;KAAG,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAAE,GACtF,CAAC,GACD,KAAK,CAAA;AAET;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;;;;;;OASG;SACE,CAAC,SAAS,UAAU,OAAO,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAehE;;;;;OAKG;aACM,IAAI;CAGd,CAAA"}
+{"version":3,"file":"define-overlays.d.ts","sourceRoot":"","sources":["../../src/commands/define-overlays.ts"],"names":[],"mappings":"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"}

package/dist/commands/define-overlays.js

@@ -1,8 +1,27 @@
+import { useEffect } from "react";
+import { missingLayer } from "../common/errors.js";
+import { isDev } from "../utils/is-dev.js";
 let modalsPromise;
 function loadModals() {
   modalsPromise ??= import("@mantine/modals").then((m) => m.modals).catch(() => void 0);
   return modalsPromise;
 }
+let mountedModalsProviders = 0;
+function registerModalsProvider() {
+  mountedModalsProviders++;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    mountedModalsProviders--;
+  };
+}
+function useModalsLayer(enabled) {
+  useEffect(() => {
+    if (!enabled) return;
+    return registerModalsProvider();
+  }, [enabled]);
+}
 let activeOverlays = {};
 function defineOverlays(spec) {
   activeOverlays = spec;
@@ -11,6 +30,71 @@ function defineOverlays(spec) {
 function defineOverlay(overlay) {
   return overlay;
 }
+async function confirm(options) {
+  const {
+    title,
+    body,
+    confirmLabel = "Confirm",
+    cancelLabel = "Cancel",
+    danger = false,
+    onConfirm,
+    onCancel
+  } = options;
+  const modals = await loadModals();
+  if (modals === void 0) {
+    throw new Error(
+      missingLayer(
+        "overlays.confirm",
+        "@mantine/modals",
+        "install the @mantine/modals peer and mount <BasaltOverlays>"
+      )
+    );
+  }
+  if (mountedModalsProviders === 0) {
+    throw new Error(
+      missingLayer(
+        "overlays.confirm",
+        "a mounted <ModalsProvider>",
+        "drop `modals={false}` from <BasaltOverlays>, or mount <ModalsProvider> yourself and call registerModalsProvider() from an effect for as long as it is up"
+      )
+    );
+  }
+  return new Promise((resolve) => {
+    let settled = false;
+    const settle = (confirmed) => {
+      if (settled) return;
+      settled = true;
+      try {
+        if (confirmed) onConfirm();
+        else onCancel?.();
+      } finally {
+        resolve(confirmed);
+      }
+    };
+    modals.openConfirmModal({
+      title,
+      ...body !== void 0 && { children: body },
+      labels: { confirm: confirmLabel, cancel: cancelLabel },
+      // The destructive tone is the theme's `red` family (derived from the palette, bound to the
+      // --vx-* status tokens by cssVariablesResolver) — never a raw color.
+      ...danger && { confirmProps: { color: "red" } },
+      onConfirm: () => settle(true),
+      onCancel: () => settle(false),
+      onClose: () => settle(false)
+    });
+  });
+}
+function confirmDelete(options) {
+  const { subject, count = 1, onConfirm } = options;
+  const what = count === 1 ? subject : `${count} ${subject}s`;
+  return confirm({
+    title: `Delete ${what}?`,
+    body: "This cannot be undone.",
+    confirmLabel: "Delete",
+    danger: true,
+    onConfirm
+  });
+}
 const overlays = {
   /**
    * Open a registered overlay by key. Resolves the Overlay spec from the runtime stash and calls
@@ -25,7 +109,7 @@ const overlays = {
   open(key, props) {
     const spec = activeOverlays[key];
     if (spec === void 0) {
-      if (process.env["NODE_ENV"] !== "production")
+      if (isDev())
         console.warn(`[basalt] overlays.open: no overlay registered for "${String(key)}"`);
       return;
     }
@@ -36,6 +120,20 @@ const overlays = {
       })
     );
   },
+  /**
+   * Open a confirm dialog and resolve to the answer — see {@link confirm}.
+   *
+   * @example
+   * const ok = await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })
+   */
+  confirm,
+  /**
+   * The one-line delete idiom over {@link confirm} — see {@link confirmDelete}.
+   *
+   * @example
+   * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+   */
+  confirmDelete,
   /**
    * Close all open overlays (delegates to modals.closeAll()).
    *
@@ -49,5 +147,7 @@ const overlays = {
 export {
   defineOverlay,
   defineOverlays,
-  overlays
+  overlays,
+  registerModalsProvider,
+  useModalsLayer
 };