@eifi1/ui-kit 0.48.2 → 0.50.0

package/dist/theme/palette-presets.js

@@ -1,9 +1,45 @@
 "use client";
 import { contrastStep, rememberTokenSet } from "./contrast-tokens.js";
+const IMPRINT_HUES = [
+  "#009e73",
+  // brand green   — first series, always
+  "#c475fd",
+  // lavender      — creative
+  "#4467a3",
+  // blue          — cool / info
+  "#bd8233",
+  // ochre         — earth / commodity
+  "#ae3030",
+  // matte red     — bad / loss / error
+  "#2abccd",
+  // cyan          — sky / tech-cool
+  "#954477",
+  // rose          — wellness / health
+  "#99b314"
+  // lime          — growth / nature
+];
+const ANYPLOT_HEAT = {
+  light: {
+    neutral: "#faf8f1",
+    under: "#4467a3",
+    over: "#ae3030",
+    seqLow: "#009e73",
+    seqHigh: "#4467a3",
+    empty: "rgba(148,163,184,0.14)"
+  },
+  dark: {
+    neutral: "#1a1a17",
+    under: "#4467a3",
+    over: "#ae3030",
+    seqLow: "#009e73",
+    seqHigh: "#4467a3",
+    empty: "rgba(148,163,184,0.10)"
+  }
+};
 const DEFAULT_PRESET = {
   id: "default",
-  name: "Default",
-  blurb: "Solar-dusk light \xB7 indigo-noir dark",
+  name: "Imprint",
+  blurb: "anyplot.ai chart hues \xB7 solar-dusk light \xB7 indigo-noir dark",
   light: {
     // Solar Dusk (light) surfaces, with the brand unified to indigo (see above).
     bgPage: "#ede3cf",
@@ -22,15 +58,8 @@ const DEFAULT_PRESET = {
     moneyExpense: "#905902",
     moneyNet: "#7a4fa3",
     moneyNeutral: "#6b6453",
-    chart: ["#332288", "#88ccee", "#44aa99", "#117733", "#999933", "#ddcc77", "#cc6677", "#882255", "#aa4499"],
-    heat: {
-      neutral: "#f1e7d2",
-      under: "#0b6650",
-      over: "#9c6418",
-      seqLow: "#f6ecd0",
-      seqHigh: "#9c6418",
-      empty: "rgba(148,163,184,0.14)"
-    }
+    chart: IMPRINT_HUES,
+    heat: ANYPLOT_HEAT.light
   },
   dark: {
     // Indigo Noir (dark)
@@ -53,6 +82,28 @@ const DEFAULT_PRESET = {
     moneyExpense: "#e4b035",
     moneyNet: "#b39aef",
     moneyNeutral: "#9aa1bd",
+    chart: IMPRINT_HUES,
+    heat: ANYPLOT_HEAT.dark
+  }
+};
+const PAUL_TOL_PRESET = {
+  id: "paul-tol",
+  name: "Paul Tol muted",
+  blurb: "Paul Tol's CVD-safe chart hues \xB7 solar-dusk light \xB7 indigo-noir dark",
+  light: {
+    ...DEFAULT_PRESET.light,
+    chart: ["#332288", "#88ccee", "#44aa99", "#117733", "#999933", "#ddcc77", "#cc6677", "#882255", "#aa4499"],
+    heat: {
+      neutral: "#f1e7d2",
+      under: "#0b6650",
+      over: "#9c6418",
+      seqLow: "#f6ecd0",
+      seqHigh: "#9c6418",
+      empty: "rgba(148,163,184,0.14)"
+    }
+  },
+  dark: {
+    ...DEFAULT_PRESET.dark,
     chart: ["#7e72d6", "#9fd8f2", "#5fc4b0", "#3fa45f", "#bfbf5e", "#e8dda0", "#e08c9a", "#c25a78", "#cc78be"],
     heat: {
       neutral: "#363a5a",
@@ -64,47 +115,8 @@ const DEFAULT_PRESET = {
     }
   }
 };
-const IMPRINT_HUES_LIGHT = [
-  "#009E73",
-  // brand green   — first series
-  "#C475FD",
-  // lavender      — creative
-  "#4467A3",
-  // blue          — cool / info
-  "#BD8233",
-  // ochre         — earth / commodity
-  "#AE3030",
-  // matte red     — bad / loss / error
-  "#2ABCCD",
-  // cyan          — sky / tech-cool
-  "#954477",
-  // rose          — wellness / health
-  "#99B314",
-  // lime          — growth / nature
-  "#DDCC77"
-  // amber         — anyplot's semantic anchor, used here as slot 9
-];
-const IMPRINT_HUES_DARK = [
-  "#009E73",
-  "#C475FD",
-  "#4467A3",
-  "#BD8233",
-  "#BF413E",
-  // matte red, L-lifted for our dark surface
-  "#2ABCCD",
-  "#A25083",
-  // rose, L-lifted for our dark surface
-  "#99B314",
-  "#DDCC77"
-];
-const IMPRINT_PRESET = {
-  id: "imprint",
-  name: "Imprint",
-  blurb: "Colourblind-safe chart hues by anyplot.ai",
-  light: { ...DEFAULT_PRESET.light, chart: IMPRINT_HUES_LIGHT },
-  dark: { ...DEFAULT_PRESET.dark, chart: IMPRINT_HUES_DARK }
-};
-const PAUL_TOL = {
+const IMPRINT_PRESET = DEFAULT_PRESET;
+const KIT_RAMP = {
   light: DEFAULT_PRESET.light.chart,
   dark: DEFAULT_PRESET.dark.chart
 };
@@ -128,7 +140,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#8e5900",
       moneyNet: "#7356a2",
       moneyNeutral: "#61646c",
-      chart: PAUL_TOL.light,
+      chart: KIT_RAMP.light,
       heat: {
         neutral: "#dce2ef",
         under: "#00725f",
@@ -153,7 +165,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#b77b29",
       moneyNet: "#9679c9",
       moneyNeutral: "#a1a5ac",
-      chart: PAUL_TOL.dark,
+      chart: KIT_RAMP.dark,
       heat: {
         neutral: "#1d212b",
         under: "#009a80",
@@ -183,7 +195,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#8e5900",
       moneyNet: "#7356a2",
       moneyNeutral: "#5f6662",
-      chart: PAUL_TOL.light,
+      chart: KIT_RAMP.light,
       heat: {
         neutral: "#d8e6dd",
         under: "#00725f",
@@ -208,7 +220,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#b87c2a",
       moneyNet: "#977ac9",
       moneyNeutral: "#9fa7a2",
-      chart: PAUL_TOL.dark,
+      chart: KIT_RAMP.dark,
       heat: {
         neutral: "#1a241e",
         under: "#009a80",
@@ -238,7 +250,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#8d5800",
       moneyNet: "#7355a2",
       moneyNeutral: "#676269",
-      chart: PAUL_TOL.light,
+      chart: KIT_RAMP.light,
       heat: {
         neutral: "#e7dfea",
         under: "#00715e",
@@ -263,7 +275,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#b77b29",
       moneyNet: "#9679c9",
       moneyNeutral: "#a8a2aa",
-      chart: PAUL_TOL.dark,
+      chart: KIT_RAMP.dark,
       heat: {
         neutral: "#251f27",
         under: "#009980",
@@ -293,7 +305,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#8d5800",
       moneyNet: "#7255a1",
       moneyNeutral: "#616467",
-      chart: PAUL_TOL.light,
+      chart: KIT_RAMP.light,
       heat: {
         neutral: "#e1e2e3",
         under: "#00715e",
@@ -318,7 +330,7 @@ const DERIVED_PRESETS = [
       moneyExpense: "#b77b29",
       moneyNet: "#9679c9",
       moneyNeutral: "#a2a5a8",
-      chart: PAUL_TOL.dark,
+      chart: KIT_RAMP.dark,
       heat: {
         neutral: "#212122",
         under: "#009a80",
@@ -330,7 +342,7 @@ const DERIVED_PRESETS = [
     }
   }
 ];
-const PALETTES = [DEFAULT_PRESET, IMPRINT_PRESET, ...DERIVED_PRESETS];
+const PALETTES = [DEFAULT_PRESET, PAUL_TOL_PRESET, ...DERIVED_PRESETS];
 function presetById(id) {
   return PALETTES.find((p) => p.id === id) ?? DEFAULT_PRESET;
 }
@@ -353,13 +365,16 @@ function applyTokenSet(el, t, contrast = el.getAttribute("data-contrast") === "m
   el.style.setProperty("--money-expense", step?.well?.moneyExpense ?? t.moneyExpense);
   el.style.setProperty("--money-net", step?.well?.moneyNet ?? t.moneyNet);
   el.style.setProperty("--money-neutral", step?.well?.moneyNeutral ?? t.moneyNeutral);
-  t.chart.forEach((c, i) => el.style.setProperty(`--chart-${i + 1}`, c));
+  if (t.chart.length > 0) {
+    for (let i = 0; i < 9; i++) el.style.setProperty(`--chart-${i + 1}`, t.chart[i % t.chart.length]);
+  }
 }
 export {
   DEFAULT_PRESET,
   DERIVED_PRESETS,
   IMPRINT_PRESET,
   PALETTES,
+  PAUL_TOL_PRESET,
   applyTokenSet,
   presetById
 };

package/dist/theme/palette-presets.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/palette-presets.ts"],"sourcesContent":["// Appearance presets — the single source of truth for the \"palette switcher\"\n// (feedback #307). Each preset is a full set of design-token values for BOTH\n// light and dark, covering the page/surface backgrounds, the brand accent, the\n// semantic money trio and the 9-colour categorical chart palette, plus the\n// heatmap stops. A preset is applied at runtime by writing these as CSS custom\n// properties onto <html> (see palette-store.ts), which instantly re-skins every\n// token-driven surface and chart. The two heatmaps and the treemap interpolate\n// concrete hex in JS, so they read the same values from here via the hooks in\n// palette-store.\n//\n// The default preset here mirrors the :root/.dark blocks in tokens.css exactly. The\n// five hand-picked alternatives of #307 (`ALTERNATIVE_PRESETS`, a reference bank that\n// `presetById` never resolved) were removed in 0.35 (refactor audit 2026-10, API-6c;\n// deprecated in 0.34): `PALETTES` is what an app offers, and `derivePalette` makes a\n// palette of its own.\n\nimport type { HeatStops } from \"./chart-palette\";\nimport { contrastStep, rememberTokenSet } from \"./contrast-tokens\";\n\nexport interface TokenSet {\n  // Backgrounds & chrome\n  bgPage: string;\n  bgSurface: string;\n  bgSurface2: string;\n  border: string;\n  textPrimary: string;\n  // The two quieter text roles. Derived per preset by blending `textPrimary` toward\n  // that preset's own surfaces until the contrast against the WORST of bgPage /\n  // bgSurface / bgSurface2 hits 7:1 and 4.8:1 — so both clear WCAG AA for normal text\n  // (4.5:1) on every surface they can land on, and both inherit the preset's warmth\n  // instead of importing a cool grey from Tailwind's palette.\n  textSecondary: string;\n  textMuted: string;\n  // Interactive brand accent\n  brand: string;\n  brandHover: string;\n  brandContrast: string;\n  // Semantic money (never red/green — CVD-safe, paired with +/- cues elsewhere)\n  moneyIncome: string;\n  moneyExpense: string;\n  moneyNet: string;\n  moneyNeutral: string;\n  // Categorical chart series (Paul Tol \"Muted\" by default — CVD-safe), exactly 9\n  chart: string[];\n  // Heatmap interpolation stops (variance diverging + spending sequential)\n  heat: HeatStops;\n}\n\nexport interface PalettePreset {\n  id: string;\n  name: string;\n  blurb: string;\n  light: TokenSet;\n  dark: TokenSet;\n}\n\n// The shipped default (feedback #328): SOLAR-DUSK warm light + INDIGO-NOIR deep\n// dark surfaces — the two curated presets the user picked per mode — but with a\n// SINGLE unified brand accent (indigo) across both modes rather than each\n// preset's own accent (the user asked for the brand accent to stay the same).\n// So the light block is Solar Dusk with its teal brand overridden to indigo, and\n// the dark block is Indigo Noir (already indigo). The money trio\n// (income/expense/net) drives the chart bars and stays palette-driven so those\n// semantic colours adapt to each mode's contrast (best practice — feedback #328).\nexport const DEFAULT_PRESET: PalettePreset = {\n  id: \"default\",\n  name: \"Default\",\n  blurb: \"Solar-dusk light · indigo-noir dark\",\n  light: {\n    // Solar Dusk (light) surfaces, with the brand unified to indigo (see above).\n    bgPage: \"#ede3cf\",\n    bgSurface: \"#f6ecd9\",\n    // The well is the page in light (0.33, k26): #f3ead6 stood 1.02:1 from the card it\n    // is inset in. Every light preset does the same; see SURFACE_L in palette-derive.ts.\n    bgSurface2: \"#ede3cf\",\n    border: \"#e2d6bd\",\n    textPrimary: \"#463f33\",\n    textSecondary: \"#50493c\",\n    textMuted: \"#696153\",\n    brand: \"#4f46e5\",\n    brandHover: \"#4338ca\",\n    brandContrast: \"#ffffff\",\n    moneyIncome: \"#0b6650\",\n    moneyExpense: \"#905902\",\n    moneyNet: \"#7a4fa3\",\n    moneyNeutral: \"#6b6453\",\n    chart: [\"#332288\", \"#88ccee\", \"#44aa99\", \"#117733\", \"#999933\", \"#ddcc77\", \"#cc6677\", \"#882255\", \"#aa4499\"],\n    heat: {\n      neutral: \"#f1e7d2\",\n      under: \"#0b6650\",\n      over: \"#9c6418\",\n      seqLow: \"#f6ecd0\",\n      seqHigh: \"#9c6418\",\n      empty: \"rgba(148,163,184,0.14)\",\n    },\n  },\n  dark: {\n    // Indigo Noir (dark)\n    bgPage: \"#0e0f1c\",\n    bgSurface: \"#181a2c\",\n    bgSurface2: \"#21243a\",\n    border: \"#2e3252\",\n    textPrimary: \"#e6e8f4\",\n    textSecondary: \"#adafbe\",\n    textMuted: \"#8d90a0\",\n    brand: \"#8b93f8\",\n    brandHover: \"#aab1fb\",\n    brandContrast: \"#16182b\",\n    moneyIncome: \"#22c3b6\",\n    // Amber-400 (#fbbf24) sat at OKLab L 0.84 while every other dark token lives\n    // at 0.68–0.74, so outflows outshouted the inflows they are paired with. Same\n    // hue and chroma, pulled to L 0.785 (dev#434). The heat stops below keep the\n    // brighter amber on purpose: a gradient endpoint is meant to be the loudest\n    // thing in its scale, and it is a fill, not a figure.\n    moneyExpense: \"#e4b035\",\n    moneyNet: \"#b39aef\",\n    moneyNeutral: \"#9aa1bd\",\n    chart: [\"#7e72d6\", \"#9fd8f2\", \"#5fc4b0\", \"#3fa45f\", \"#bfbf5e\", \"#e8dda0\", \"#e08c9a\", \"#c25a78\", \"#cc78be\"],\n    heat: {\n      neutral: \"#363a5a\",\n      under: \"#22c3b6\",\n      over: \"#fbbf24\",\n      seqLow: \"#3a2c14\",\n      seqHigh: \"#fbbf24\",\n      empty: \"rgba(148,163,184,0.10)\",\n    },\n  },\n};\n\n// ── \"Imprint\" chart hues (feedback #119) ──────────────────────────────────────\n// anyplot's categorical palette (https://anyplot.ai/palette), by a colleague of\n// Marcel's. 8 hues + an amber semantic anchor, derived from Wong 2011 by a\n// Petroff-style max-min ΔE search in CAM02-UCS with Machado 2009 CVD simulation —\n// the same lineage as our default Paul Tol \"Muted\", one generation on, and tuned\n// for exactly the warm cream paper our light theme uses.\n//\n// This preset is DEFAULT_PRESET with ONLY the 9 categorical chart hues swapped;\n// surfaces, brand and the semantic money trio stay put, because those were their\n// own deliberate decisions (#307/#328) and are not what the palette is for. The\n// heatmap stops likewise stay teal/amber: they encode under/over, and imprint's\n// own diverging ramp is red↔blue, which would fight the money semantics.\n//\n// Measured on our surfaces (CIEDE2000, Machado severity-100, 8 like-for-like\n// slots on the cream light surface #f6ecd9) — neither palette dominates:\n//   Paul Tol Muted  min-contrast 1.38 · worst-CVD ΔE00 11.8 · normal ΔE00 16.1\n//   imprint         min-contrast 1.95 · worst-CVD ΔE00  7.2 · normal ΔE00 22.2\n// i.e. imprint is punchier and has no near-invisible pale slot (Tol's #88ccee\n// sits at 1.5:1 on cream), while Tol separates better under colour-vision\n// deficiency. So this ships as a CHOICE, not as a new default.\n//\n// The dark set keeps imprint's hues verbatim except matte-red and rose, whose\n// lightness is lifted (oklch L 0.50→0.55) because verbatim they land at 2.67:1\n// and 2.76:1 on our deep-indigo dark surface — under WCAG 2.1 SC 1.4.11's 3:1\n// non-text minimum. Lifted they clear it at 3.30:1 / 3.28:1. anyplot documents\n// the same shortfall on their own dark ground and answers it with a stroke halo;\n// lifting keeps the fix in the token layer instead of every chart component.\nconst IMPRINT_HUES_LIGHT = [\n  \"#009E73\", // brand green   — first series\n  \"#C475FD\", // lavender      — creative\n  \"#4467A3\", // blue          — cool / info\n  \"#BD8233\", // ochre         — earth / commodity\n  \"#AE3030\", // matte red     — bad / loss / error\n  \"#2ABCCD\", // cyan          — sky / tech-cool\n  \"#954477\", // rose          — wellness / health\n  \"#99B314\", // lime          — growth / nature\n  \"#DDCC77\", // amber         — anyplot's semantic anchor, used here as slot 9\n];\nconst IMPRINT_HUES_DARK = [\n  \"#009E73\",\n  \"#C475FD\",\n  \"#4467A3\",\n  \"#BD8233\",\n  \"#BF413E\", // matte red, L-lifted for our dark surface\n  \"#2ABCCD\",\n  \"#A25083\", // rose, L-lifted for our dark surface\n  \"#99B314\",\n  \"#DDCC77\",\n];\n\nexport const IMPRINT_PRESET: PalettePreset = {\n  id: \"imprint\",\n  name: \"Imprint\",\n  blurb: \"Colourblind-safe chart hues by anyplot.ai\",\n  light: { ...DEFAULT_PRESET.light, chart: IMPRINT_HUES_LIGHT },\n  dark: { ...DEFAULT_PRESET.dark, chart: IMPRINT_HUES_DARK },\n};\n\n// The full-theme switcher from #307 stayed retired (feedback #328) — the default\n// is still the single source of truth for surfaces, brand and money (its five\n// alternatives are gone, see the header). What IS selectable is\n// the categorical chart ramp (feedback #119), so these two presets are the live\n// set; presetById falls back to the default for any stale persisted id.\n/**\n * The categorical chart ramp, shared by every derived preset below.\n *\n * Paul Tol's \"Muted\" set, unchanged, and deliberately NOT re-derived per preset. A\n * categorical ramp solves a different problem from a UI palette — separability among\n * nine unknown siblings, rather than contrast against one known surface — and a set\n * optimised against real dichromat confusion lines beats one spaced evenly by formula.\n * `auditChartRamp` in palette-derive.ts measures it: 0.059 minimum separation in the\n * light variant, which is the number MIN_SEPARATION was calibrated under.\n *\n * It pays for that in contrast: four of the nine light hues sit below the 3:1 WCAG\n * 1.4.11 asks of a filled shape. That is not fixable by darkening them — see\n * SINGLE_LIGHTNESS_MAX_SERIES — so a chart with more than four series must carry a\n * second channel (a direct label, a pattern, a legend adjacent to the mark).\n */\nconst PAUL_TOL = {\n  light: DEFAULT_PRESET.light.chart,\n  dark: DEFAULT_PRESET.dark.chart,\n} as const;\n\n/**\n * Presets DERIVED rather than picked, by `derivePalette` from one brand colour each.\n *\n * Every text role here was solved to a contrast target against the worst of the three\n * surfaces it can land on, every semantic colour against both the page and its own badge\n * tint, and the whole set is re-checked by `__tests__/palette-audit.test.ts` (\"derived\n * presets\") — which re-runs the deriver and fails if these committed values drift from\n * what it now produces.\n *\n * They are committed rather than derived at import because deriving eight token sets\n * costs ~34ms, and charging every consumer that at startup for palettes most of them\n * will never select is the wrong trade. The test is what keeps the two in agreement.\n *\n * Regenerated in 0.34 (round 0.34 BUG-8): the solve now measures the hex it ships rather\n * than the float before rounding, and the audit no longer lets a hex pair pass 0.05 under\n * its threshold. 52 values moved one step (66 counting the heat stops that repeat them);\n * Contrast's neutrals lost half their slate tint, its brand having half the chroma at\n * which the neutrals carry a hue in full.\n */\nexport const DERIVED_PRESETS: PalettePreset[] = [\n  {\n    id: \"ink\",\n    name: \"Ink\",\n    blurb: \"Cool blue-grey ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#dce2ef\",\n      bgSurface: \"#e6edfa\",\n      bgSurface2: \"#dce2ef\",\n      border: \"#b0bace\",\n      textPrimary: \"#2e3139\",\n      textSecondary: \"#454850\",\n      textMuted: \"#5f636c\",\n      brand: \"#2f5fd0\",\n      brandHover: \"#1f4cbc\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#61646c\",\n      chart: PAUL_TOL.light,\n      heat: {\n        neutral: \"#dce2ef\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#090d15\",\n      bgSurface: \"#131720\",\n      bgSurface2: \"#1d212b\",\n      border: \"#363e4f\",\n      textPrimary: \"#c8ccd6\",\n      textSecondary: \"#a7abb5\",\n      textMuted: \"#858a92\",\n      brand: \"#3466d7\",\n      brandHover: \"#2353c3\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a1a5ac\",\n      chart: PAUL_TOL.dark,\n      heat: {\n        neutral: \"#1d212b\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"moss\",\n    name: \"Moss\",\n    blurb: \"Green ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#d8e6dd\",\n      bgSurface: \"#e3f1e8\",\n      bgSurface2: \"#d8e6dd\",\n      border: \"#abbfb2\",\n      textPrimary: \"#2c332e\",\n      textSecondary: \"#424b45\",\n      textMuted: \"#5d6660\",\n      brand: \"#2f7a52\",\n      brandHover: \"#196842\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#5f6662\",\n      chart: PAUL_TOL.light,\n      heat: {\n        neutral: \"#d8e6dd\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#060f0a\",\n      bgSurface: \"#101a14\",\n      bgSurface2: \"#1a241e\",\n      border: \"#314337\",\n      textPrimary: \"#c6cfc9\",\n      textSecondary: \"#a5aea8\",\n      textMuted: \"#838c86\",\n      brand: \"#317b53\",\n      brandHover: \"#1c6943\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b87c2a\",\n      moneyNet: \"#977ac9\",\n      moneyNeutral: \"#9fa7a2\",\n      chart: PAUL_TOL.dark,\n      heat: {\n        neutral: \"#1a241e\",\n        under: \"#009a80\",\n        over: \"#b87c2a\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b87c2a\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"plum\",\n    name: \"Plum\",\n    blurb: \"Violet ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#e7dfea\",\n      bgSurface: \"#f2e9f5\",\n      bgSurface2: \"#e7dfea\",\n      border: \"#c2b5c6\",\n      textPrimary: \"#352f36\",\n      textSecondary: \"#4c464e\",\n      textMuted: \"#676169\",\n      brand: \"#7b3f8f\",\n      brandHover: \"#692d7d\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7355a2\",\n      moneyNeutral: \"#676269\",\n      chart: PAUL_TOL.light,\n      heat: {\n        neutral: \"#e7dfea\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#100b12\",\n      bgSurface: \"#1b151d\",\n      bgSurface2: \"#251f27\",\n      border: \"#453b48\",\n      textPrimary: \"#d0cad2\",\n      textSecondary: \"#afa9b1\",\n      textMuted: \"#8d8790\",\n      brand: \"#9154a6\",\n      brandHover: \"#7f4293\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009980\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a8a2aa\",\n      chart: PAUL_TOL.dark,\n      heat: {\n        neutral: \"#251f27\",\n        under: \"#009980\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"contrast\",\n    name: \"High contrast\",\n    blurb: \"Near-neutral ground · text solved to 13:1 / 8.5:1 / 5.5:1\",\n    light: {\n      bgPage: \"#e1e2e3\",\n      bgSurface: \"#ecedee\",\n      bgSurface2: \"#e1e2e3\",\n      border: \"#b8babc\",\n      textPrimary: \"#1b1d21\",\n      textSecondary: \"#3a3c40\",\n      textMuted: \"#55585c\",\n      brand: \"#1f2937\",\n      brandHover: \"#111b28\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7255a1\",\n      moneyNeutral: \"#616467\",\n      chart: PAUL_TOL.light,\n      heat: {\n        neutral: \"#e1e2e3\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#0c0d0e\",\n      bgSurface: \"#171718\",\n      bgSurface2: \"#212122\",\n      border: \"#3d3e3f\",\n      textPrimary: \"#e4e8ec\",\n      textSecondary: \"#b9bdc1\",\n      textMuted: \"#95979c\",\n      brand: \"#556c8e\",\n      brandHover: \"#455b7c\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a2a5a8\",\n      chart: PAUL_TOL.dark,\n      heat: {\n        neutral: \"#212122\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n];\n\nexport const PALETTES: PalettePreset[] = [DEFAULT_PRESET, IMPRINT_PRESET, ...DERIVED_PRESETS];\n\nexport function presetById(id: string): PalettePreset {\n  return PALETTES.find((p) => p.id === id) ?? DEFAULT_PRESET;\n}\n\n/**\n * Write a token set onto an element's inline style as CSS custom properties.\n *\n * This is the only writer, and there is no un-writer: `presetById` falls back to\n * `DEFAULT_PRESET` and this then writes the full set, so returning to the default\n * APPLIES it rather than clearing anything. A `clearTokenSet` and the hand-kept\n * 24-name `TOKEN_VARS` list it looped over used to live here, both exported, both\n * called by nobody in either consumer — a second copy of these property names with\n * nothing comparing the two, so adding a token here and forgetting it there would\n * have been silent and only a dead function would have noticed. The list is gone;\n * the test beside this asserts instead that every field of a `TokenSet` reaches the\n * element, which is what that list was standing in for.\n *\n * **More contrast (0.32, docs/text-size-harmonization.md §5, §10.5).** With `contrast`\n * the text and border tokens are written one step stronger — in a light set the well and\n * the four money colours too (0.36, docs/colour-roles-harmonization.md §13) — and `--text-placeholder` —\n * otherwise derived in tokens.css — is written inline too; without it that inline\n * placeholder is removed again, so the stylesheet's formula applies. The step is made\n * HERE because these tokens are inline: no `[data-contrast=more]` rule could beat them.\n *\n * `contrast` defaults to the element's own `data-contrast=\"more\"`, which the contrast\n * layer (`applyContrast`, `useApplyContrast`) sets first. That is how the palette and the\n * contrast cooperate without knowing each other: a palette change re-applies through\n * here and keeps the contrast, and a contrast change re-applies the set remembered here.\n */\nexport function applyTokenSet(\n  el: HTMLElement,\n  t: TokenSet,\n  contrast: boolean = el.getAttribute(\"data-contrast\") === \"more\",\n): void {\n  rememberTokenSet(el, t);\n  const step = contrast ? contrastStep(t) : null;\n  el.style.setProperty(\"--bg-page\", t.bgPage);\n  el.style.setProperty(\"--bg-surface\", t.bgSurface);\n  // The light well and money step under More contrast (0.36, colour-roles §13); in dark\n  // and at Standard `well` is null and the set's own are written.\n  el.style.setProperty(\"--bg-surface-2\", step?.well?.bgSurface2 ?? t.bgSurface2);\n  el.style.setProperty(\"--border\", step?.border ?? t.border);\n  el.style.setProperty(\"--text-primary\", t.textPrimary);\n  el.style.setProperty(\"--text-secondary\", step?.textSecondary ?? t.textSecondary);\n  el.style.setProperty(\"--text-muted\", step?.textMuted ?? t.textMuted);\n  if (step) el.style.setProperty(\"--text-placeholder\", step.textPlaceholder);\n  else el.style.removeProperty(\"--text-placeholder\");\n  el.style.setProperty(\"--brand\", t.brand);\n  el.style.setProperty(\"--brand-hover\", t.brandHover);\n  el.style.setProperty(\"--brand-contrast\", t.brandContrast);\n  el.style.setProperty(\"--money-income\", step?.well?.moneyIncome ?? t.moneyIncome);\n  el.style.setProperty(\"--money-expense\", step?.well?.moneyExpense ?? t.moneyExpense);\n  el.style.setProperty(\"--money-net\", step?.well?.moneyNet ?? t.moneyNet);\n  el.style.setProperty(\"--money-neutral\", step?.well?.moneyNeutral ?? t.moneyNeutral);\n  t.chart.forEach((c, i) => el.style.setProperty(`--chart-${i + 1}`, c));\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/theme/palette-presets.ts"],"sourcesContent":["// Appearance presets — the single source of truth for the \"palette switcher\"\n// (feedback #307). Each preset is a full set of design-token values for BOTH\n// light and dark, covering the page/surface backgrounds, the brand accent, the\n// semantic money trio and the categorical chart palette (anyplot's eight \"Imprint\"\n// hues by default since 0.49, Paul Tol's nine in `PAUL_TOL_PRESET`), plus the\n// heatmap stops. A preset is applied at runtime by writing these as CSS custom\n// properties onto <html> (see palette-store.ts), which instantly re-skins every\n// token-driven surface and chart. The two heatmaps and the treemap interpolate\n// concrete hex in JS, so they read the same values from here via the hooks in\n// palette-store.\n//\n// The default preset here mirrors the :root/.dark blocks in tokens.css exactly. The\n// five hand-picked alternatives of #307 (`ALTERNATIVE_PRESETS`, a reference bank that\n// `presetById` never resolved) were removed in 0.35 (refactor audit 2026-10, API-6c;\n// deprecated in 0.34): `PALETTES` is what an app offers, and `derivePalette` makes a\n// palette of its own.\n\nimport type { HeatStops } from \"./chart-palette\";\nimport { contrastStep, rememberTokenSet } from \"./contrast-tokens\";\n\nexport interface TokenSet {\n  // Backgrounds & chrome\n  bgPage: string;\n  bgSurface: string;\n  bgSurface2: string;\n  border: string;\n  textPrimary: string;\n  // The two quieter text roles. Derived per preset by blending `textPrimary` toward\n  // that preset's own surfaces until the contrast against the WORST of bgPage /\n  // bgSurface / bgSurface2 hits 7:1 and 4.8:1 — so both clear WCAG AA for normal text\n  // (4.5:1) on every surface they can land on, and both inherit the preset's warmth\n  // instead of importing a cool grey from Tailwind's palette.\n  textSecondary: string;\n  textMuted: string;\n  // Interactive brand accent\n  brand: string;\n  brandHover: string;\n  brandContrast: string;\n  // Semantic money (never red/green — CVD-safe, paired with +/- cues elsewhere)\n  moneyIncome: string;\n  moneyExpense: string;\n  moneyNet: string;\n  moneyNeutral: string;\n  // Categorical chart series, written as `--chart-1…9`. anyplot's eight \"Imprint\" hues by\n  // default (0.49), Paul Tol \"Muted\"'s nine in `PAUL_TOL_PRESET`. `paletteFor` cycles\n  // eight; a shorter ramp is repeated to fill `--chart-9` (see `applyTokenSet`).\n  chart: string[];\n  // Heatmap interpolation stops (variance diverging + spending sequential)\n  heat: HeatStops;\n}\n\nexport interface PalettePreset {\n  id: string;\n  name: string;\n  blurb: string;\n  light: TokenSet;\n  dark: TokenSet;\n}\n\n// ── \"Imprint\" chart hues (feedback #119; the default since 0.49) ─────────────\n// anyplot's categorical palette (https://anyplot.ai/palette), by a colleague of\n// Marcel's. 8 hues + an amber semantic anchor, derived from Wong 2011 by a\n// Petroff-style max-min ΔE search in CAM02-UCS with Machado 2009 CVD simulation —\n// the same lineage as Paul Tol \"Muted\", one generation on, and tuned for exactly the\n// warm cream paper our light theme uses.\n//\n// 0.49 (Marcel, 2026-10-22): the DEFAULT, in anyplot's slot order, eight slots — amber\n// #DDCC77 left the pool, it is anyplot's semantic warning anchor, not a series colour.\n// The SAME hues in both themes: 0.48 lifted matte red and rose for the dark ground\n// (#BF413E, #A25083), which made the dark chart a different palette from the light one.\n// anyplot answers a hue under 3:1 with a 1px ink edge instead, and so does the kit now\n// (`chartEdge`, drawn by SeriesChart's bars and areas and by Treemap's tiles).\n//\n// Measured on our surfaces (CIEDE2000, Machado severity-100, 8 like-for-like slots on\n// the cream light surface #f6ecd9) — neither palette dominates:\n//   Paul Tol Muted  min-contrast 1.38 · worst-CVD ΔE00 11.8 · normal ΔE00 16.1\n//   imprint         min-contrast 1.95 · worst-CVD ΔE00  7.2 · normal ΔE00 22.2\n// i.e. imprint is punchier and has no near-invisible pale slot (Tol's #88ccee sits at\n// 1.5:1 on cream), while Tol separates better under colour-vision deficiency — which is\n// why `paletteFor` offers anyplot's CVD-optimal order (`{ order: \"cvd\" }`).\nconst IMPRINT_HUES = [\n  \"#009e73\", // brand green   — first series, always\n  \"#c475fd\", // lavender      — creative\n  \"#4467a3\", // blue          — cool / info\n  \"#bd8233\", // ochre         — earth / commodity\n  \"#ae3030\", // matte red     — bad / loss / error\n  \"#2abccd\", // cyan          — sky / tech-cool\n  \"#954477\", // rose          — wellness / health\n  \"#99b314\", // lime          — growth / nature\n];\n\n/** anyplot's scales (0.49): sequential green → blue, diverging blue (under) ↔ paper or\n *  ink (0) ↔ matte red (over). `chart-palette.ts`'s `HEATMAP_HEX` holds the same. */\nconst ANYPLOT_HEAT: Record<\"light\" | \"dark\", HeatStops> = {\n  light: {\n    neutral: \"#faf8f1\",\n    under: \"#4467a3\",\n    over: \"#ae3030\",\n    seqLow: \"#009e73\",\n    seqHigh: \"#4467a3\",\n    empty: \"rgba(148,163,184,0.14)\",\n  },\n  dark: {\n    neutral: \"#1a1a17\",\n    under: \"#4467a3\",\n    over: \"#ae3030\",\n    seqLow: \"#009e73\",\n    seqHigh: \"#4467a3\",\n    empty: \"rgba(148,163,184,0.10)\",\n  },\n};\n\n// The shipped default (feedback #328): SOLAR-DUSK warm light + INDIGO-NOIR deep\n// dark surfaces — the two curated presets the user picked per mode — but with a\n// SINGLE unified brand accent (indigo) across both modes rather than each\n// preset's own accent (the user asked for the brand accent to stay the same).\n// So the light block is Solar Dusk with its teal brand overridden to indigo, and\n// the dark block is Indigo Noir (already indigo). The money trio\n// (income/expense/net) drives the chart bars and stays palette-driven so those\n// semantic colours adapt to each mode's contrast (best practice — feedback #328).\n//\n// 0.49: its chart ramp and heat stops are anyplot's (\"Imprint\", above) — the money\n// trio stays the kit's own (Marcel, 2026-10-22: chart income/expense/net/neutral keep\n// the money tokens, never anyplot's green/red). The 0.48 default, the same surfaces\n// with Paul Tol's ramp, is `PAUL_TOL_PRESET`.\nexport const DEFAULT_PRESET: PalettePreset = {\n  id: \"default\",\n  name: \"Imprint\",\n  blurb: \"anyplot.ai chart hues · solar-dusk light · indigo-noir dark\",\n  light: {\n    // Solar Dusk (light) surfaces, with the brand unified to indigo (see above).\n    bgPage: \"#ede3cf\",\n    bgSurface: \"#f6ecd9\",\n    // The well is the page in light (0.33, k26): #f3ead6 stood 1.02:1 from the card it\n    // is inset in. Every light preset does the same; see SURFACE_L in palette-derive.ts.\n    bgSurface2: \"#ede3cf\",\n    border: \"#e2d6bd\",\n    textPrimary: \"#463f33\",\n    textSecondary: \"#50493c\",\n    textMuted: \"#696153\",\n    brand: \"#4f46e5\",\n    brandHover: \"#4338ca\",\n    brandContrast: \"#ffffff\",\n    moneyIncome: \"#0b6650\",\n    moneyExpense: \"#905902\",\n    moneyNet: \"#7a4fa3\",\n    moneyNeutral: \"#6b6453\",\n    chart: IMPRINT_HUES,\n    heat: ANYPLOT_HEAT.light,\n  },\n  dark: {\n    // Indigo Noir (dark)\n    bgPage: \"#0e0f1c\",\n    bgSurface: \"#181a2c\",\n    bgSurface2: \"#21243a\",\n    border: \"#2e3252\",\n    textPrimary: \"#e6e8f4\",\n    textSecondary: \"#adafbe\",\n    textMuted: \"#8d90a0\",\n    brand: \"#8b93f8\",\n    brandHover: \"#aab1fb\",\n    brandContrast: \"#16182b\",\n    moneyIncome: \"#22c3b6\",\n    // Amber-400 (#fbbf24) sat at OKLab L 0.84 while every other dark token lives\n    // at 0.68–0.74, so outflows outshouted the inflows they are paired with. Same\n    // hue and chroma, pulled to L 0.785 (dev#434). The heat stops below keep the\n    // brighter amber on purpose: a gradient endpoint is meant to be the loudest\n    // thing in its scale, and it is a fill, not a figure.\n    moneyExpense: \"#e4b035\",\n    moneyNet: \"#b39aef\",\n    moneyNeutral: \"#9aa1bd\",\n    chart: IMPRINT_HUES,\n    heat: ANYPLOT_HEAT.dark,\n  },\n};\n\n\n/**\n * The 0.48 default: the same surfaces, brand and money, with Paul Tol's \"Muted\" nine\n * as the chart ramp and the teal/amber heat stops that went with it. Selectable, no\n * longer the default (0.49). `paletteFor` cycles eight, so its ninth hue (#aa4499) is\n * reachable only as `var(--chart-9)`.\n */\nexport const PAUL_TOL_PRESET: PalettePreset = {\n  id: \"paul-tol\",\n  name: \"Paul Tol muted\",\n  blurb: \"Paul Tol's CVD-safe chart hues · solar-dusk light · indigo-noir dark\",\n  light: {\n    ...DEFAULT_PRESET.light,\n    chart: [\"#332288\", \"#88ccee\", \"#44aa99\", \"#117733\", \"#999933\", \"#ddcc77\", \"#cc6677\", \"#882255\", \"#aa4499\"],\n    heat: {\n      neutral: \"#f1e7d2\",\n      under: \"#0b6650\",\n      over: \"#9c6418\",\n      seqLow: \"#f6ecd0\",\n      seqHigh: \"#9c6418\",\n      empty: \"rgba(148,163,184,0.14)\",\n    },\n  },\n  dark: {\n    ...DEFAULT_PRESET.dark,\n    chart: [\"#7e72d6\", \"#9fd8f2\", \"#5fc4b0\", \"#3fa45f\", \"#bfbf5e\", \"#e8dda0\", \"#e08c9a\", \"#c25a78\", \"#cc78be\"],\n    heat: {\n      neutral: \"#363a5a\",\n      under: \"#22c3b6\",\n      over: \"#fbbf24\",\n      seqLow: \"#3a2c14\",\n      seqHigh: \"#fbbf24\",\n      empty: \"rgba(148,163,184,0.10)\",\n    },\n  },\n};\n\n/** @deprecated 0.49 — use `DEFAULT_PRESET` (Imprint IS the default now); removed in 0.51.\n *  A persisted `\"imprint\"` id resolves to it through `presetById`'s fallback. */\nexport const IMPRINT_PRESET: PalettePreset = DEFAULT_PRESET;\n\n// The full-theme switcher from #307 stayed retired (feedback #328) — the default\n// is still the single source of truth for surfaces, brand and money (its five\n// alternatives are gone, see the header). What IS selectable is\n// the categorical chart ramp (feedback #119), so Imprint (the default) and Paul Tol are\n// the live set; presetById falls back to the default for any stale persisted id.\n/**\n * The categorical chart ramp, shared by every derived preset below.\n *\n * The default's ramp (anyplot's eight since 0.49, Paul Tol's \"Muted\" before), and\n * deliberately NOT re-derived per preset. A\n * categorical ramp solves a different problem from a UI palette — separability among\n * nine unknown siblings, rather than contrast against one known surface — and a set\n * optimised against real dichromat confusion lines beats one spaced evenly by formula.\n * `auditChartRamp` in palette-derive.ts measures it: 0.059 minimum separation in the\n * light variant, which is the number MIN_SEPARATION was calibrated under.\n *\n * It pays for that in contrast: four of the nine light hues sit below the 3:1 WCAG\n * 1.4.11 asks of a filled shape. That is not fixable by darkening them — see\n * SINGLE_LIGHTNESS_MAX_SERIES — so a chart with more than four series must carry a\n * second channel (a direct label, a pattern, a legend adjacent to the mark).\n */\nconst KIT_RAMP = {\n  light: DEFAULT_PRESET.light.chart,\n  dark: DEFAULT_PRESET.dark.chart,\n} as const;\n\n/**\n * Presets DERIVED rather than picked, by `derivePalette` from one brand colour each.\n *\n * Every text role here was solved to a contrast target against the worst of the three\n * surfaces it can land on, every semantic colour against both the page and its own badge\n * tint, and the whole set is re-checked by `__tests__/palette-audit.test.ts` (\"derived\n * presets\") — which re-runs the deriver and fails if these committed values drift from\n * what it now produces.\n *\n * They are committed rather than derived at import because deriving eight token sets\n * costs ~34ms, and charging every consumer that at startup for palettes most of them\n * will never select is the wrong trade. The test is what keeps the two in agreement.\n *\n * Regenerated in 0.34 (round 0.34 BUG-8): the solve now measures the hex it ships rather\n * than the float before rounding, and the audit no longer lets a hex pair pass 0.05 under\n * its threshold. 52 values moved one step (66 counting the heat stops that repeat them);\n * Contrast's neutrals lost half their slate tint, its brand having half the chroma at\n * which the neutrals carry a hue in full.\n */\nexport const DERIVED_PRESETS: PalettePreset[] = [\n  {\n    id: \"ink\",\n    name: \"Ink\",\n    blurb: \"Cool blue-grey ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#dce2ef\",\n      bgSurface: \"#e6edfa\",\n      bgSurface2: \"#dce2ef\",\n      border: \"#b0bace\",\n      textPrimary: \"#2e3139\",\n      textSecondary: \"#454850\",\n      textMuted: \"#5f636c\",\n      brand: \"#2f5fd0\",\n      brandHover: \"#1f4cbc\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#61646c\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#dce2ef\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#090d15\",\n      bgSurface: \"#131720\",\n      bgSurface2: \"#1d212b\",\n      border: \"#363e4f\",\n      textPrimary: \"#c8ccd6\",\n      textSecondary: \"#a7abb5\",\n      textMuted: \"#858a92\",\n      brand: \"#3466d7\",\n      brandHover: \"#2353c3\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a1a5ac\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#1d212b\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"moss\",\n    name: \"Moss\",\n    blurb: \"Green ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#d8e6dd\",\n      bgSurface: \"#e3f1e8\",\n      bgSurface2: \"#d8e6dd\",\n      border: \"#abbfb2\",\n      textPrimary: \"#2c332e\",\n      textSecondary: \"#424b45\",\n      textMuted: \"#5d6660\",\n      brand: \"#2f7a52\",\n      brandHover: \"#196842\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#5f6662\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#d8e6dd\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#060f0a\",\n      bgSurface: \"#101a14\",\n      bgSurface2: \"#1a241e\",\n      border: \"#314337\",\n      textPrimary: \"#c6cfc9\",\n      textSecondary: \"#a5aea8\",\n      textMuted: \"#838c86\",\n      brand: \"#317b53\",\n      brandHover: \"#1c6943\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b87c2a\",\n      moneyNet: \"#977ac9\",\n      moneyNeutral: \"#9fa7a2\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#1a241e\",\n        under: \"#009a80\",\n        over: \"#b87c2a\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b87c2a\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"plum\",\n    name: \"Plum\",\n    blurb: \"Violet ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#e7dfea\",\n      bgSurface: \"#f2e9f5\",\n      bgSurface2: \"#e7dfea\",\n      border: \"#c2b5c6\",\n      textPrimary: \"#352f36\",\n      textSecondary: \"#4c464e\",\n      textMuted: \"#676169\",\n      brand: \"#7b3f8f\",\n      brandHover: \"#692d7d\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7355a2\",\n      moneyNeutral: \"#676269\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#e7dfea\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#100b12\",\n      bgSurface: \"#1b151d\",\n      bgSurface2: \"#251f27\",\n      border: \"#453b48\",\n      textPrimary: \"#d0cad2\",\n      textSecondary: \"#afa9b1\",\n      textMuted: \"#8d8790\",\n      brand: \"#9154a6\",\n      brandHover: \"#7f4293\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009980\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a8a2aa\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#251f27\",\n        under: \"#009980\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"contrast\",\n    name: \"High contrast\",\n    blurb: \"Near-neutral ground · text solved to 13:1 / 8.5:1 / 5.5:1\",\n    light: {\n      bgPage: \"#e1e2e3\",\n      bgSurface: \"#ecedee\",\n      bgSurface2: \"#e1e2e3\",\n      border: \"#b8babc\",\n      textPrimary: \"#1b1d21\",\n      textSecondary: \"#3a3c40\",\n      textMuted: \"#55585c\",\n      brand: \"#1f2937\",\n      brandHover: \"#111b28\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7255a1\",\n      moneyNeutral: \"#616467\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#e1e2e3\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#0c0d0e\",\n      bgSurface: \"#171718\",\n      bgSurface2: \"#212122\",\n      border: \"#3d3e3f\",\n      textPrimary: \"#e4e8ec\",\n      textSecondary: \"#b9bdc1\",\n      textMuted: \"#95979c\",\n      brand: \"#556c8e\",\n      brandHover: \"#455b7c\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a2a5a8\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#212122\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n];\n\nexport const PALETTES: PalettePreset[] = [DEFAULT_PRESET, PAUL_TOL_PRESET, ...DERIVED_PRESETS];\n\nexport function presetById(id: string): PalettePreset {\n  return PALETTES.find((p) => p.id === id) ?? DEFAULT_PRESET;\n}\n\n/**\n * Write a token set onto an element's inline style as CSS custom properties.\n *\n * This is the only writer, and there is no un-writer: `presetById` falls back to\n * `DEFAULT_PRESET` and this then writes the full set, so returning to the default\n * APPLIES it rather than clearing anything. A `clearTokenSet` and the hand-kept\n * 24-name `TOKEN_VARS` list it looped over used to live here, both exported, both\n * called by nobody in either consumer — a second copy of these property names with\n * nothing comparing the two, so adding a token here and forgetting it there would\n * have been silent and only a dead function would have noticed. The list is gone;\n * the test beside this asserts instead that every field of a `TokenSet` reaches the\n * element, which is what that list was standing in for.\n *\n * **More contrast (0.32, docs/text-size-harmonization.md §5, §10.5).** With `contrast`\n * the text and border tokens are written one step stronger — in a light set the well and\n * the four money colours too (0.36, docs/colour-roles-harmonization.md §13) — and `--text-placeholder` —\n * otherwise derived in tokens.css — is written inline too; without it that inline\n * placeholder is removed again, so the stylesheet's formula applies. The step is made\n * HERE because these tokens are inline: no `[data-contrast=more]` rule could beat them.\n *\n * `contrast` defaults to the element's own `data-contrast=\"more\"`, which the contrast\n * layer (`applyContrast`, `useApplyContrast`) sets first. That is how the palette and the\n * contrast cooperate without knowing each other: a palette change re-applies through\n * here and keeps the contrast, and a contrast change re-applies the set remembered here.\n */\nexport function applyTokenSet(\n  el: HTMLElement,\n  t: TokenSet,\n  contrast: boolean = el.getAttribute(\"data-contrast\") === \"more\",\n): void {\n  rememberTokenSet(el, t);\n  const step = contrast ? contrastStep(t) : null;\n  el.style.setProperty(\"--bg-page\", t.bgPage);\n  el.style.setProperty(\"--bg-surface\", t.bgSurface);\n  // The light well and money step under More contrast (0.36, colour-roles §13); in dark\n  // and at Standard `well` is null and the set's own are written.\n  el.style.setProperty(\"--bg-surface-2\", step?.well?.bgSurface2 ?? t.bgSurface2);\n  el.style.setProperty(\"--border\", step?.border ?? t.border);\n  el.style.setProperty(\"--text-primary\", t.textPrimary);\n  el.style.setProperty(\"--text-secondary\", step?.textSecondary ?? t.textSecondary);\n  el.style.setProperty(\"--text-muted\", step?.textMuted ?? t.textMuted);\n  if (step) el.style.setProperty(\"--text-placeholder\", step.textPlaceholder);\n  else el.style.removeProperty(\"--text-placeholder\");\n  el.style.setProperty(\"--brand\", t.brand);\n  el.style.setProperty(\"--brand-hover\", t.brandHover);\n  el.style.setProperty(\"--brand-contrast\", t.brandContrast);\n  el.style.setProperty(\"--money-income\", step?.well?.moneyIncome ?? t.moneyIncome);\n  el.style.setProperty(\"--money-expense\", step?.well?.moneyExpense ?? t.moneyExpense);\n  el.style.setProperty(\"--money-net\", step?.well?.moneyNet ?? t.moneyNet);\n  el.style.setProperty(\"--money-neutral\", step?.well?.moneyNeutral ?? t.moneyNeutral);\n  // All nine `--chart-N`, a shorter ramp repeated: Imprint's eight write `--chart-9` as\n  // slot 0 — what `paletteFor(8)` names — so a host addressing `var(--chart-9)` directly\n  // follows the cycle, and switching away from Paul Tol's nine leaves no stale ninth hue.\n  // An empty ramp (a `derivePalette` set) leaves whatever was there, deliberately.\n  if (t.chart.length > 0) {\n    for (let i = 0; i < 9; i++) el.style.setProperty(`--chart-${i + 1}`, t.chart[i % t.chart.length]);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tour/tour-dock.d.ts

@@ -0,0 +1,42 @@
+import type { CSSProperties } from "react";
+export type DockEdge = "top" | "bottom";
+export interface DockRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+/** The band, in layout-viewport px (what `position: fixed` measures from). */
+export interface Band {
+    top: number;
+    bottom: number;
+}
+/** Below this the docked layout applies (Tailwind's `sm`). */
+export declare const DOCK_MAX_WIDTH = 640;
+/**
+ * The usable band now: the visual viewport while a keyboard is up (`readKeyboardInset`'s
+ * rules — pinch zoom is not a keyboard, 100 px minimum), else the layout viewport; its
+ * bottom raised to the top of the highest visible obstruction that holds neither the field
+ * nor the card. An obstruction that starts at the band's top (a full-screen picker, opened
+ * over everything) is not a bottom layer and is ignored; a tall one (the number pad at
+ * Large text is over half a phone) still counts.
+ */
+export declare function readBand(target: Element | null, card: Element | null): Band;
+/**
+ * The edge away from the field: the bottom when the spotlight's centre is in the band's
+ * upper half, else the top. With a `previous` edge, it stays unless the card would have to
+ * cover the spotlight there (no flip on every keyboard animation frame).
+ */
+export declare function dockEdge(spot: DockRect, band: Band, previous: DockEdge | null, cardHeight: number): DockEdge;
+/** The docked card's position: full-width with 8 px (safe-area aware) gutters, its height
+ *  capped to the free space so its body scrolls and its title and buttons show. */
+export declare function dockStyle(edge: DockEdge, spot: DockRect | null, band: Band): CSSProperties;
+/** The target's nearest ancestor that scrolls vertically now (a sheet's body), or null. */
+export declare function scrollParent(el: Element): HTMLElement | null;
+/**
+ * Scroll the field into the half of the band away from the card, through its nearest
+ * scrollable ancestor (the window only when there is none — the page behind a sheet never
+ * moves). A field already inside that half is left where it is. Returns the edge the card
+ * takes.
+ */
+export declare function scrollIntoFreeHalf(el: Element, card: Element | null, previous: DockEdge | null): DockEdge;

package/dist/tour/tour-dock.js

@@ -0,0 +1,80 @@
+"use client";
+import { readKeyboardInset } from "../hooks/use-anchored-panel.js";
+const DOCK_MAX_WIDTH = 640;
+const GUTTER = 8;
+const FULL_SCREEN_SLACK = 64;
+const MIN_DOCK = 140;
+function readBand(target, card) {
+  const vh = window.innerHeight;
+  let top = 0;
+  let bottom = vh;
+  const vv = window.visualViewport;
+  if (vv && readKeyboardInset() > 0) {
+    top = vv.offsetTop;
+    bottom = vv.offsetTop + vv.height;
+  }
+  for (const el of Array.from(document.querySelectorAll("[data-tour-obstruction]"))) {
+    if (target && el.contains(target) || card && el.contains(card)) continue;
+    const r = el.getBoundingClientRect();
+    if (r.width <= 0 || r.height <= 0 || r.top <= top + FULL_SCREEN_SLACK) continue;
+    if (r.top < bottom) bottom = r.top;
+  }
+  return { top, bottom };
+}
+function room(edge, spot, band) {
+  return edge === "bottom" ? band.bottom - (spot.top + spot.height) - GUTTER * 2 : spot.top - band.top - GUTTER * 2;
+}
+function dockEdge(spot, band, previous, cardHeight) {
+  const preferred = spot.top + spot.height / 2 < band.top + (band.bottom - band.top) / 2 ? "bottom" : "top";
+  if (!previous || previous === preferred) return preferred;
+  return room(previous, spot, band) >= Math.min(MIN_DOCK, cardHeight) ? previous : preferred;
+}
+function dockStyle(edge, spot, band) {
+  const vh = window.innerHeight;
+  const cap = spot ? Math.max(MIN_DOCK / 2, room(edge, spot, band)) : band.bottom - band.top - GUTTER * 2;
+  const base = {
+    left: `max(${GUTTER}px, env(safe-area-inset-left))`,
+    right: `max(${GUTTER}px, env(safe-area-inset-right))`,
+    width: "auto",
+    maxWidth: "none",
+    maxHeight: cap
+  };
+  if (edge === "top") {
+    return { ...base, top: band.top <= 0 ? `max(${GUTTER}px, env(safe-area-inset-top))` : band.top + GUTTER, bottom: "auto" };
+  }
+  const fromBottom = vh - band.bottom;
+  return {
+    ...base,
+    top: "auto",
+    bottom: fromBottom <= 0 ? `max(${GUTTER}px, env(safe-area-inset-bottom))` : fromBottom + GUTTER
+  };
+}
+function scrollParent(el) {
+  for (let node = el.parentElement; node && node !== document.body; node = node.parentElement) {
+    const { overflowY } = getComputedStyle(node);
+    if ((overflowY === "auto" || overflowY === "scroll") && node.scrollHeight > node.clientHeight) return node;
+  }
+  return null;
+}
+function scrollIntoFreeHalf(el, card, previous) {
+  const r = el.getBoundingClientRect();
+  const band = readBand(el, card);
+  const edge = dockEdge(r, band, previous, card instanceof HTMLElement ? card.offsetHeight : MIN_DOCK);
+  const mid = band.top + (band.bottom - band.top) / 2;
+  const half = edge === "bottom" ? { top: band.top + GUTTER, bottom: mid } : { top: mid, bottom: band.bottom - GUTTER };
+  if (r.top >= half.top && r.top + r.height <= half.bottom) return edge;
+  const delta = r.height > half.bottom - half.top ? r.top - half.top : r.top + r.height / 2 - (half.top + half.bottom) / 2;
+  const scroller = scrollParent(el);
+  if (scroller) scroller.scrollTop += delta;
+  else if (!el.closest("[data-kit-layer]")) window.scrollBy?.(0, delta);
+  return edge;
+}
+export {
+  DOCK_MAX_WIDTH,
+  dockEdge,
+  dockStyle,
+  readBand,
+  scrollIntoFreeHalf,
+  scrollParent
+};
+//# sourceMappingURL=tour-dock.js.map

package/dist/tour/tour-dock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tour/tour-dock.ts"],"sourcesContent":["import type { CSSProperties } from \"react\";\nimport { readKeyboardInset } from \"../hooks/use-anchored-panel\";\n\n/*\n * # The docked card (docs/tours-harmonization.md §11.7, contract round 054 §6)\n *\n * On a phone a field step's card is pinned full-width to the top or bottom edge of the\n * USABLE BAND — the visual viewport less the keyboard, raised above the highest\n * `[data-tour-obstruction]` (the number pad, a picker sheet) — on the edge away from the\n * spotlighted field, so it covers neither the field nor the keyboard nor the pad.\n */\n\nexport type DockEdge = \"top\" | \"bottom\";\n\nexport interface DockRect {\n  top: number;\n  left: number;\n  width: number;\n  height: number;\n}\n\n/** The band, in layout-viewport px (what `position: fixed` measures from). */\nexport interface Band {\n  top: number;\n  bottom: number;\n}\n\n/** Below this the docked layout applies (Tailwind's `sm`). */\nexport const DOCK_MAX_WIDTH = 640;\n/** The gutter between the card and the band's edge, and between the card and the field. */\nconst GUTTER = 8;\n/** An obstruction whose top is within this of the band's top covers the screen. */\nconst FULL_SCREEN_SLACK = 64;\n/** Under this much free space on its edge the card flips (the hysteresis floor). */\nconst MIN_DOCK = 140;\n\n/**\n * The usable band now: the visual viewport while a keyboard is up (`readKeyboardInset`'s\n * rules — pinch zoom is not a keyboard, 100 px minimum), else the layout viewport; its\n * bottom raised to the top of the highest visible obstruction that holds neither the field\n * nor the card. An obstruction that starts at the band's top (a full-screen picker, opened\n * over everything) is not a bottom layer and is ignored; a tall one (the number pad at\n * Large text is over half a phone) still counts.\n */\nexport function readBand(target: Element | null, card: Element | null): Band {\n  const vh = window.innerHeight;\n  let top = 0;\n  let bottom = vh;\n  const vv = window.visualViewport;\n  if (vv && readKeyboardInset() > 0) {\n    top = vv.offsetTop;\n    bottom = vv.offsetTop + vv.height;\n  }\n  for (const el of Array.from(document.querySelectorAll(\"[data-tour-obstruction]\"))) {\n    if ((target && el.contains(target)) || (card && el.contains(card))) continue;\n    const r = el.getBoundingClientRect();\n    if (r.width <= 0 || r.height <= 0 || r.top <= top + FULL_SCREEN_SLACK) continue;\n    if (r.top < bottom) bottom = r.top;\n  }\n  return { top, bottom };\n}\n\n/** The card's free space on `edge`, between the band's edge and the spotlight. */\nfunction room(edge: DockEdge, spot: DockRect, band: Band): number {\n  return edge === \"bottom\" ? band.bottom - (spot.top + spot.height) - GUTTER * 2 : spot.top - band.top - GUTTER * 2;\n}\n\n/**\n * The edge away from the field: the bottom when the spotlight's centre is in the band's\n * upper half, else the top. With a `previous` edge, it stays unless the card would have to\n * cover the spotlight there (no flip on every keyboard animation frame).\n */\nexport function dockEdge(spot: DockRect, band: Band, previous: DockEdge | null, cardHeight: number): DockEdge {\n  const preferred: DockEdge = spot.top + spot.height / 2 < band.top + (band.bottom - band.top) / 2 ? \"bottom\" : \"top\";\n  if (!previous || previous === preferred) return preferred;\n  return room(previous, spot, band) >= Math.min(MIN_DOCK, cardHeight) ? previous : preferred;\n}\n\n/** The docked card's position: full-width with 8 px (safe-area aware) gutters, its height\n *  capped to the free space so its body scrolls and its title and buttons show. */\nexport function dockStyle(edge: DockEdge, spot: DockRect | null, band: Band): CSSProperties {\n  const vh = window.innerHeight;\n  const cap = spot ? Math.max(MIN_DOCK / 2, room(edge, spot, band)) : band.bottom - band.top - GUTTER * 2;\n  const base: CSSProperties = {\n    left: `max(${GUTTER}px, env(safe-area-inset-left))`,\n    right: `max(${GUTTER}px, env(safe-area-inset-right))`,\n    width: \"auto\",\n    maxWidth: \"none\",\n    maxHeight: cap,\n  };\n  if (edge === \"top\") {\n    return { ...base, top: band.top <= 0 ? `max(${GUTTER}px, env(safe-area-inset-top))` : band.top + GUTTER, bottom: \"auto\" };\n  }\n  const fromBottom = vh - band.bottom;\n  return {\n    ...base,\n    top: \"auto\",\n    bottom: fromBottom <= 0 ? `max(${GUTTER}px, env(safe-area-inset-bottom))` : fromBottom + GUTTER,\n  };\n}\n\n/** The target's nearest ancestor that scrolls vertically now (a sheet's body), or null. */\nexport function scrollParent(el: Element): HTMLElement | null {\n  for (let node = el.parentElement; node && node !== document.body; node = node.parentElement) {\n    const { overflowY } = getComputedStyle(node);\n    if ((overflowY === \"auto\" || overflowY === \"scroll\") && node.scrollHeight > node.clientHeight) return node;\n  }\n  return null;\n}\n\n/**\n * Scroll the field into the half of the band away from the card, through its nearest\n * scrollable ancestor (the window only when there is none — the page behind a sheet never\n * moves). A field already inside that half is left where it is. Returns the edge the card\n * takes.\n */\nexport function scrollIntoFreeHalf(el: Element, card: Element | null, previous: DockEdge | null): DockEdge {\n  const r = el.getBoundingClientRect();\n  const band = readBand(el, card);\n  const edge = dockEdge(r, band, previous, card instanceof HTMLElement ? card.offsetHeight : MIN_DOCK);\n  const mid = band.top + (band.bottom - band.top) / 2;\n  const half = edge === \"bottom\" ? { top: band.top + GUTTER, bottom: mid } : { top: mid, bottom: band.bottom - GUTTER };\n  if (r.top >= half.top && r.top + r.height <= half.bottom) return edge;\n  // Centred in the half, or its top at the half's top when it is taller than the half.\n  const delta =\n    r.height > half.bottom - half.top ? r.top - half.top : r.top + r.height / 2 - (half.top + half.bottom) / 2;\n  const scroller = scrollParent(el);\n  if (scroller) scroller.scrollTop += delta;\n  // A field in a kit layer with nothing to scroll: the page behind it stays put.\n  else if (!el.closest(\"[data-kit-layer]\")) window.scrollBy?.(0, delta);\n  return edge;\n}\n"],"mappings":"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","names":[]}

package/dist/tour/tour-gates.d.ts

@@ -0,0 +1,71 @@
+/** One publisher of a key. */
+interface GateEntry {
+    satisfied: boolean;
+}
+/** `release(key)` / `refuse(key, reason)` from the app, as the provider hears them. */
+export type GateSignal = {
+    kind: "release";
+    key: string;
+} | {
+    kind: "refuse";
+    key: string;
+    reason?: string;
+};
+export interface GateRegistry {
+    /** The current publisher's value; `undefined` while nobody publishes `key`. */
+    get(key: string): boolean | undefined;
+    /** Is anyone publishing `key`? */
+    has(key: string): boolean;
+    /** For `useSyncExternalStore`: bumped on every change. */
+    subscribe(listener: () => void): () => void;
+    version(): number;
+    push(key: string, entry: GateEntry): void;
+    pop(key: string, entry: GateEntry): void;
+    changed(key: string): void;
+    /** Whether a tour runs (for the two-publishers warning). */
+    setActive(active: boolean): void;
+    /** The release bus. */
+    listen(listener: (signal: GateSignal) => void): () => void;
+    emit(signal: GateSignal): void;
+}
+/** The kit's dev switch (as number-input's): a development build, never under vitest. */
+export declare function devWarnings(): boolean;
+export declare function createGateRegistry(): GateRegistry;
+/** What the provider shares with the gate hooks and `TourGuideButton` — internal. */
+export interface TourInternals {
+    gates: GateRegistry;
+    /** Did the provider get a `launch`? */
+    canLaunch: boolean;
+}
+export declare const TourInternalContext: import("react").Context<TourInternals | null>;
+/**
+ * Publish whether this field holds what a tour waits for (§11.1): `useTourGate("txn.amount",
+ * amount !== "")` beside the field. A step with `gate: "txn.amount"` keeps its Next locked
+ * until it is `true`. A key no step names as `gate` is a FACT a step's `when` can ask
+ * (`ctx.gate("txn.transfer")`).
+ *
+ * - `key` `null`/`undefined` publishes nothing: one field component used by a create and
+ *   an edit form takes part only in create (`mode === "create" ? "txn.memo" : null`).
+ * - Publish the value's state. Do not invent a "touched" gate: a field already filled
+ *   when the step arrives (a date prefilled with today) shows Next open at once, which is
+ *   intended.
+ * - Qualify keys by form (`txn.amount`, not `amount`). Two publishers of one key: the one
+ *   mounted last wins.
+ * - A no-op without a `TourProvider`, so a form's tests need none. It keeps publishing
+ *   while no tour runs, because "Guide me" can start inside a form already filled.
+ */
+export declare function useTourGate(key: string | null | undefined, satisfied: boolean): void;
+/** What {@link useTourGateRelease} hands back. */
+export interface TourGateRelease {
+    /** The awaited thing happened (a save succeeded): the tour moves past the step that awaits `key`. */
+    release(key: string): void;
+    /** It was refused (a save failed): the step awaiting `key` stays and shows `reason`. */
+    refuse(key: string, reason?: string): void;
+}
+/**
+ * The signals of `awaitGate` steps (§11.4), usually from a mutation's `onSuccess` /
+ * `onError`. Stable identities. No-ops without a provider, and while no tour runs or no
+ * step of the run awaits the key: a release is an event and is never buffered.
+ */
+export declare function useTourGateRelease(): TourGateRelease;
+export {};