react-semaphor 0.1.547 → 0.1.548

package/dist/chunks/{use-create-flow-overlay-state-Csx_Xjsh.js → use-create-flow-overlay-state-CbGIjaVD.js}

@@ -1,6 +1,6 @@
 import { c as fe, C as Se } from "./x-4f5U2XwU.js";
 import { useEffect as K, forwardRef as nt, useMemo as H, useState as M, useRef as ne, useCallback as A, Fragment as st } from "react";
-import { a3 as qe, a4 as ot, aK as dt, u as it, i as ct, aL as ut, aM as mt, aN as De, aO as pt, aP as ft, aQ as ze, aR as Me, aS as ht, aT as gt, aU as bt, aV as xt, aW as vt, aX as yt, aY as Ct } from "./semaphor-ready-indicator-CRm17oIP.js";
+import { a3 as qe, a4 as ot, aK as dt, u as it, i as ct, aL as ut, aM as mt, aN as De, aO as pt, aP as ft, aQ as ze, aR as Me, aS as ht, aT as gt, aU as bt, aV as xt, aW as vt, aX as yt, aY as Ct } from "./semaphor-ready-indicator-Ol6VcaR7.js";
 import { jsx as t, jsxs as o, Fragment as X } from "react/jsx-runtime";
 import "./index-CuHybtft.js";
 import "./validators-C-aOQlTB.js";
@@ -10,7 +10,7 @@ import "zod";
 import "../value-format-preferences/index.js";
 import { c as R } from "./_commonjsHelpers-DimLPMtv.js";
 import { m as Re, n as je, o as Be, p as $e, x as Ue, B as E, l as z, q as Qe, r as se, s as oe, t as de, u as ie, v as ce } from "./switch-CEBOR4n7.js";
-import { c as kt, e as Nt, f as G, h as we, j as Te, k as ue, l as me, m as St, o as Dt, p as _e, q as wt, t as Tt, u as J, w as _t, x as Ve, y as Ye, z as He, A as Xe, B as Ge, C as Vt, I as Lt, D as Le, E as Et, F as Ee, G as It, H as At, J as Ft, K as Ot, L as pe } from "./global-date-filter-utils-BhAu8zIM.js";
+import { c as kt, e as Nt, f as G, h as we, j as Te, k as ue, l as me, m as St, o as Dt, p as _e, q as wt, t as Tt, u as J, w as _t, x as Ve, y as Ye, z as He, A as Xe, B as Ge, C as Vt, I as Lt, D as Le, E as Et, F as Ee, G as It, H as At, J as Ft, K as Ot, L as pe } from "./global-date-filter-utils-CeeFJ1CP.js";
 import { C as Ie } from "./selection-reducer-CJzkTZio.js";
 /**
  * @license lucide-react v0.453.0 - ISC

package/dist/dashboard/index.js

@@ -1,4 +1,4 @@
-import { D as o } from "../chunks/dashboard-DCk26-6i.js";
+import { D as o } from "../chunks/dashboard-BZHL9a-z.js";
 import { C as s, E as C } from "../chunks/table-settings-WysCBj62.js";
 export {
   s as CONTROL_CARD_DEFAULT_VALUE,

package/dist/dashboard-authoring/index.js

@@ -1,21 +1,21 @@
 var Ot = Object.defineProperty;
 var Nt = (e, t, a) => t in e ? Ot(e, t, { enumerable: !0, configurable: !0, writable: !0, value: a }) : e[t] = a;
 var ke = (e, t, a) => Nt(e, typeof t != "symbol" ? t + "" : t, a);
-import { D as it, r as It, b as qt, c as Pt, a as nt, d as Mt } from "../chunks/filter-reach-copy-CGWsL_ez.js";
-import { N as yi, R as _i, f as Ci, j as Si, l as vi, k as wi, u as xi, q as Di, e as Ti, i as ki, y as $i, z as Fi, s as Ai, v as Ri, t as Ei, m as Oi, n as Ni, p as qi, g as Pi, o as Mi, h as Li, x as Bi, w as Vi } from "../chunks/filter-reach-copy-CGWsL_ez.js";
-import { M as Lt, N as Bt, O as $e, P as Vt, Q as Gt, R as Ut, S as jt, T as zt, U as Qt, V as Kt, W as Ht, X as Wt, Y as de, Z as Yt, _ as Xt, $ as fe, a0 as Jt, a1 as Zt, a2 as Me, a3 as yt, a4 as oe, a5 as ne, a6 as Ee, a7 as ea, a8 as Le, a9 as ta, aa, ab as sa, ac as ot, ad as ia, ae as na, af as _t, ag as ie, ah as rt, ai as oa, aj as ra, ak as Oe, al as da, am as dt, an as la, ao as lt, ap as ca, aq as ce, ar as ua, as as ct, b as ha, at as fa, au as pa, av as ma, aw as ga, ax as ut, ay as ba, az as Ia, aA as ya, aB as _a, aC as Ca, aD as Sa, aE as va, aF as wa, aG as xa, aH as Fe, aI as Da } from "../chunks/global-date-filter-utils-BhAu8zIM.js";
-import { cx as Ui, aT as ji, c8 as zi, c9 as Qi, co as Ki, cn as Hi, ch as Wi, cp as Yi, cq as Xi, bO as Ji, bP as Zi, bQ as en, bL as tn, bM as an, bN as sn, bH as nn, bI as on, bK as rn, bJ as dn, bR as ln, cK as cn, ca as un, b7 as hn, b6 as fn, c2 as pn, cz as mn, bh as gn, cD as bn, cl as In, cm as yn, aQ as _n, cC as Cn, bk as Sn, cA as vn, by as wn, cg as xn, bS as Dn, bz as Tn, cM as kn, aL as $n, cE as Fn, ck as An, aM as Rn, c1 as En, c0 as On, bb as Nn, a$ as qn, b3 as Pn, cI as Mn, bt as Ln, d as Bn, a as Vn, bl as Gn, aN as Un, cw as jn, cO as zn, b0 as Qn, b1 as Kn, b2 as Hn, bg as Wn, bi as Yn, c5 as Xn, g as Jn, bG as Zn, bp as eo, bF as to, bC as ao, c6 as so, aV as io, aW as no, cG as oo, bm as ro, b8 as lo, ci as co, bd as uo, cu as ho, br as fo, bY as po, cN as mo, aR as go, b_ as bo, b$ as Io, cJ as yo, bw as _o, bo as Co, bq as So, bc as vo, bs as wo, cr as xo, cF as Do, aO as To, cy as ko, bv as $o, b9 as Fo, bB as Ao, cs as Ro, c3 as Eo, c4 as Oo, aU as No, cL as qo, c7 as Po, ce as Mo, bE as Lo, aY as Bo, ct as Vo, cH as Go, aJ as Uo, cv as jo, bx as zo, ba as Qo, bU as Ko, a_ as Ho, b4 as Wo, b5 as Yo, cb as Xo, cc as Jo, aZ as Zo, bW as er, bX as tr, bV as ar, aX as sr, bD as ir, cd as nr, bu as or, cj as rr, aK as dr, bA as lr, bZ as cr, aS as ur, cB as hr, bj as fr, bn as pr, aP as mr, bT as gr, bf as br, be as Ir, cf as yr } from "../chunks/global-date-filter-utils-BhAu8zIM.js";
+import { D as it, r as It, b as qt, c as Pt, a as nt, d as Mt } from "../chunks/filter-reach-copy-ByzGadUk.js";
+import { N as yi, R as _i, f as Ci, j as Si, l as vi, k as wi, u as xi, q as Di, e as Ti, i as ki, y as $i, z as Fi, s as Ai, v as Ri, t as Ei, m as Oi, n as Ni, p as qi, g as Pi, o as Mi, h as Li, x as Bi, w as Vi } from "../chunks/filter-reach-copy-ByzGadUk.js";
+import { M as Lt, N as Bt, O as $e, P as Vt, Q as Gt, R as Ut, S as jt, T as zt, U as Qt, V as Kt, W as Ht, X as Wt, Y as de, Z as Yt, _ as Xt, $ as fe, a0 as Jt, a1 as Zt, a2 as Me, a3 as yt, a4 as oe, a5 as ne, a6 as Ee, a7 as ea, a8 as Le, a9 as ta, aa, ab as sa, ac as ot, ad as ia, ae as na, af as _t, ag as ie, ah as rt, ai as oa, aj as ra, ak as Oe, al as da, am as dt, an as la, ao as lt, ap as ca, aq as ce, ar as ua, as as ct, b as ha, at as fa, au as pa, av as ma, aw as ga, ax as ut, ay as ba, az as Ia, aA as ya, aB as _a, aC as Ca, aD as Sa, aE as va, aF as wa, aG as xa, aH as Fe, aI as Da } from "../chunks/global-date-filter-utils-CeeFJ1CP.js";
+import { cx as Ui, aT as ji, c8 as zi, c9 as Qi, co as Ki, cn as Hi, ch as Wi, cp as Yi, cq as Xi, bO as Ji, bP as Zi, bQ as en, bL as tn, bM as an, bN as sn, bH as nn, bI as on, bK as rn, bJ as dn, bR as ln, cK as cn, ca as un, b7 as hn, b6 as fn, c2 as pn, cz as mn, bh as gn, cD as bn, cl as In, cm as yn, aQ as _n, cC as Cn, bk as Sn, cA as vn, by as wn, cg as xn, bS as Dn, bz as Tn, cM as kn, aL as $n, cE as Fn, ck as An, aM as Rn, c1 as En, c0 as On, bb as Nn, a$ as qn, b3 as Pn, cI as Mn, bt as Ln, d as Bn, a as Vn, bl as Gn, aN as Un, cw as jn, cO as zn, b0 as Qn, b1 as Kn, b2 as Hn, bg as Wn, bi as Yn, c5 as Xn, g as Jn, bG as Zn, bp as eo, bF as to, bC as ao, c6 as so, aV as io, aW as no, cG as oo, bm as ro, b8 as lo, ci as co, bd as uo, cu as ho, br as fo, bY as po, cN as mo, aR as go, b_ as bo, b$ as Io, cJ as yo, bw as _o, bo as Co, bq as So, bc as vo, bs as wo, cr as xo, cF as Do, aO as To, cy as ko, bv as $o, b9 as Fo, bB as Ao, cs as Ro, c3 as Eo, c4 as Oo, aU as No, cL as qo, c7 as Po, ce as Mo, bE as Lo, aY as Bo, ct as Vo, cH as Go, aJ as Uo, cv as jo, bx as zo, ba as Qo, bU as Ko, a_ as Ho, b4 as Wo, b5 as Yo, cb as Xo, cc as Jo, aZ as Zo, bW as er, bX as tr, bV as ar, aX as sr, bD as ir, cd as nr, bu as or, cj as rr, aK as dr, bA as lr, bZ as cr, aS as ur, cB as hr, bj as fr, bn as pr, aP as mr, bT as gr, bf as br, be as Ir, cf as yr } from "../chunks/global-date-filter-utils-CeeFJ1CP.js";
 import { x as Ta, ao as Be, ap as ka, a3 as Ct, ab as $a, a6 as Fa, ad as St, aD as Aa, aB as vt, aC as Ra } from "../chunks/validators-C-aOQlTB.js";
 import "../chunks/matrix-operation-contract-D6vYkZK4.js";
 import "../chunks/analytics-base-schemas-BKs3flFS.js";
 import "zod";
 import { a as Ea, r as Oa } from "../chunks/index-CtoK1Lgu.js";
 import { n as Na } from "../chunks/operators-B3zZoskU.js";
-import { a as Cr, b as Sr, r as vr } from "../chunks/raw-temporal-presentation-DypB7sMX.js";
+import { a as Cr, b as Sr, r as vr } from "../chunks/raw-temporal-presentation-CrUM2I_o.js";
 import { w as re } from "../chunks/table-settings-WysCBj62.js";
 import { D as xr, x as Dr, y as Tr, F as kr, B as $r, z as Fr, G as Ar, A as Rr, v as Er } from "../chunks/table-settings-WysCBj62.js";
-import { v as ve, w as qa } from "../chunks/resolve-dashboard-input-context-D0JDUa4h.js";
-import { J as Nr, P as qr, K as Pr, b as Mr, N as Lr, I as Br, z as Vr, Q as Gr, R as Ur, M as jr, C as zr, D as Qr, G as Kr, H as Hr, F as Wr, x as Yr, y as Xr, p as Jr, O as Zr, E as ed, A as td, L as ad, B as sd } from "../chunks/resolve-dashboard-input-context-D0JDUa4h.js";
+import { v as ve, w as qa } from "../chunks/resolve-dashboard-input-context-BmWF9hSl.js";
+import { J as Nr, P as qr, K as Pr, b as Mr, N as Lr, I as Br, z as Vr, Q as Gr, R as Ur, M as jr, C as zr, D as Qr, G as Kr, H as Hr, F as Wr, x as Yr, y as Xr, p as Jr, O as Zr, E as ed, A as td, L as ad, B as sd } from "../chunks/resolve-dashboard-input-context-BmWF9hSl.js";
 import { G as nd, F as od, D as rd, E as dd, H as ld, I as cd } from "../chunks/pivot-result-lifecycle-pwq3b7LC.js";
 import { e as Pa, w as Ma } from "../chunks/metric-comparison-zpGw4lD6.js";
 import { p as La } from "../chunks/report-runtime-context-hWiTCzFV.js";

package/dist/data-app-sdk-validation/index.js

@@ -3,7 +3,7 @@ import { Z as Q } from "../chunks/matrix-operation-contract-D6vYkZK4.js";
 import "../chunks/analytics-base-schemas-BKs3flFS.js";
 import "zod";
 import { p as W } from "../chunks/report-runtime-context-hWiTCzFV.js";
-import { o as U } from "../chunks/source-entity-resolution-BIGRvtbG.js";
+import { o as U } from "../chunks/source-entity-resolution-D195CrYS.js";
 import { toSemaphorMetricIntent as J, toSemaphorAnalysisIntent as V, toSemaphorRecordsIntent as G, toSemaphorSqlIntent as L, toSemaphorMatrixIntent as Z, toSemaphorInputOptionsIntent as X } from "../data-app-sdk-adapters/index.js";
 import { m as Y } from "../chunks/matrix-card-LiMEipvq.js";
 function ee({

package/dist/index.js

@@ -1,10 +1,10 @@
-import { D as M } from "./chunks/dashboard-DCk26-6i.js";
+import { D as M } from "./chunks/dashboard-BZHL9a-z.js";
 import { C as fa, E as ma } from "./chunks/table-settings-WysCBj62.js";
-import { C as U, b as V, c as z, d as H, e as W, f as q } from "./chunks/report-preferences-dialog-DoVyriYC.js";
-import { g as ga, A as Ca, h as ba, a as ya, R as va, D as Da } from "./chunks/report-preferences-dialog-DoVyriYC.js";
+import { C as U, b as V, c as z, d as H, e as W, f as q } from "./chunks/report-preferences-dialog-CM7kXmXp.js";
+import { g as ga, A as Ca, h as ba, a as ya, R as va, D as Da } from "./chunks/report-preferences-dialog-CM7kXmXp.js";
 import { jsx as o, jsxs as b } from "react/jsx-runtime";
-import { E as P, F as $, S as G, a as K, U as Q, c as J, A as Y, C as X, u as L, d as Z, f as ee, g as ae, V as te, e as _, h as N, s as se, R as re } from "./chunks/semaphor-ready-indicator-CRm17oIP.js";
-import { O as Aa, aw as Sa, ax as Ta, ay as wa, B as xa, a5 as Ba, I as Fa, G as Pa, z as _a, aG as Na, M as Ra, W as La, k as Ia, n as ja, n as ka, o as Oa, H as Ma, ar as Ua, at as Va, au as za, as as Ha, ai as Wa, al as qa, aF as $a, a9 as Ga, aq as Ka, a2 as Qa, aA as Ja, aB as Ya, ad as Xa, am as Za, y as et, x as at, v as tt, w as st, aJ as rt, a8 as ot, an as nt, ao as it, ah as lt, ak as ct, aE as ut, aD as dt, aC as pt, aI as ft, aH as mt, aj as ht, a7 as gt, a6 as Ct, T as bt, ab as yt, ap as vt, af as Dt, ac as Et, ae as At, ag as St, X as Tt, Y as wt, Z as xt, aa as Bt, P as Ft, N as Pt, t as _t, az as Nt, r as Rt, K as Lt, _ as It, a0 as jt, $ as kt, a1 as Ot, q as Mt, j as Ut, J as Vt, L as zt, l as Ht, a4 as Wt, Q as qt, a3 as $t, i as Gt, p as Kt, m as Qt, av as Jt } from "./chunks/semaphor-ready-indicator-CRm17oIP.js";
+import { E as P, F as $, S as G, a as K, U as Q, c as J, A as Y, C as X, u as L, d as Z, f as ee, g as ae, V as te, e as _, h as N, s as se, R as re } from "./chunks/semaphor-ready-indicator-Ol6VcaR7.js";
+import { O as Aa, aw as Sa, ax as Ta, ay as wa, B as xa, a5 as Ba, I as Fa, G as Pa, z as _a, aG as Na, M as Ra, W as La, k as Ia, n as ja, n as ka, o as Oa, H as Ma, ar as Ua, at as Va, au as za, as as Ha, ai as Wa, al as qa, aF as $a, a9 as Ga, aq as Ka, a2 as Qa, aA as Ja, aB as Ya, ad as Xa, am as Za, y as et, x as at, v as tt, w as st, aJ as rt, a8 as ot, an as nt, ao as it, ah as lt, ak as ct, aE as ut, aD as dt, aC as pt, aI as ft, aH as mt, aj as ht, a7 as gt, a6 as Ct, T as bt, ab as yt, ap as vt, af as Dt, ac as Et, ae as At, ag as St, X as Tt, Y as wt, Z as xt, aa as Bt, P as Ft, N as Pt, t as _t, az as Nt, r as Rt, K as Lt, _ as It, a0 as jt, $ as kt, a1 as Ot, q as Mt, j as Ut, J as Vt, L as zt, l as Ht, a4 as Wt, Q as qt, a3 as $t, i as Gt, p as Kt, m as Qt, av as Jt } from "./chunks/semaphor-ready-indicator-Ol6VcaR7.js";
 import * as T from "react";
 import I, { useMemo as R, useEffect as j } from "react";
 import { C as Xt, D as Zt, L as es, P as as, e as ts, g as ss, j as rs, h as os, k as ns, d as is, b as ls, i as cs, c as us, n as ds, f as ps } from "./chunks/validators-C-aOQlTB.js";
@@ -15,26 +15,26 @@ import "./chunks/matrix-operation-contract-D6vYkZK4.js";
 import "./chunks/analytics-base-schemas-BKs3flFS.js";
 import "./value-format-preferences/index.js";
 import { D as ms } from "./chunks/token-types-BMqRmT-C.js";
-import { c as gs, A as Cs, b as bs, g as ys, D as vs, e as Ds, f as Es, d as As, S as Ss, U as Ts, a as ws, V as xs, W as Bs, i as Fs, u as Ps } from "./chunks/dashboard-briefing-launcher-CQ1eYsGy.js";
+import { c as gs, A as Cs, b as bs, g as ys, D as vs, e as Ds, f as Es, d as As, S as Ss, U as Ts, a as ws, V as xs, W as Bs, i as Fs, u as Ps } from "./chunks/dashboard-briefing-launcher-DML-cAzB.js";
 import { n as Ns, s as Rs, u as Ls } from "./chunks/normalize-dashboard-for-dirty-check-XKgH3GFX.js";
 import { createRoot as ne } from "react-dom/client";
-import "./chunks/shelf-drop-preview-context-vy6P9THz.js";
+import "./chunks/shelf-drop-preview-context-C2SEC3I9.js";
 import "./chunks/index-CuHybtft.js";
 import { D as js } from "./chunks/report-runtime-context-hWiTCzFV.js";
 import { c as B } from "./chunks/_commonjsHelpers-DimLPMtv.js";
 import { P as ie, a as le, B as ce, b as ue, c as de } from "./chunks/switch-CEBOR4n7.js";
-import "./chunks/global-date-filter-utils-BhAu8zIM.js";
+import "./chunks/global-date-filter-utils-CeeFJ1CP.js";
 import { r as Os, a as Ms } from "./chunks/pivot-result-identity-C-Q1j1Wb.js";
-import { a as pe } from "./chunks/resolve-dashboard-input-context-D0JDUa4h.js";
-import { k as Vs, f as zs, n as Hs, m as Ws, s as qs, t as $s, j as Gs, h as Ks, o as Qs, g as Js, d as Ys, i as Xs, u as Zs, q as er } from "./chunks/resolve-dashboard-input-context-D0JDUa4h.js";
+import { a as pe } from "./chunks/resolve-dashboard-input-context-BmWF9hSl.js";
+import { k as Vs, f as zs, n as Hs, m as Ws, s as qs, t as $s, j as Gs, h as Ks, o as Qs, g as Js, d as Ys, i as Xs, u as Zs, q as er } from "./chunks/resolve-dashboard-input-context-BmWF9hSl.js";
 import "./chunks/index-CtoK1Lgu.js";
 import "react-dom";
-import "./chunks/index-DmrLP5Ro.js";
+import "./chunks/index-DeDHr3iz.js";
 import "./chunks/appearance-context-DEYtWinQ.js";
 import "./chunks/color-CJvdlFM_.js";
 import "./chunks/index-CLIro-EG.js";
 import "./chunks/bookmark-state-Cu-a5ie_.js";
-import { I as fe } from "./chunks/use-create-flow-overlay-state-Csx_Xjsh.js";
+import { I as fe } from "./chunks/use-create-flow-overlay-state-CbGIjaVD.js";
 import { C as me } from "./chunks/x-4f5U2XwU.js";
 import "./chunks/appearance-runtime-provider-B-M8gwlZ.js";
 const he = { cssWidth: 960, cssHeight: 540 };

package/dist/surfboard/index.js

@@ -1,4 +1,4 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-DoVyriYC.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-CM7kXmXp.js";
 import { C as f, E as D } from "../chunks/table-settings-WysCBj62.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,

package/dist/types/lib/dashboard-inputs/dashboard-filter-mapping-authoring.d.ts

@@ -194,11 +194,15 @@ export type DashboardFilterMappingDraftRow = DashboardFilterCardState & {
 export type DashboardFilterMappingRowTrigger = {
     kind: 'notApplied';
 }
-/** A field, with "Auto ·" or "Suggested ·" before it. */
+/**
+ * A field, with "Auto ·" or "Suggested ·" before it. `muted`: the field
+ * doesn't apply yet (a suggestion), so all of it reads quiet.
+ */
  | {
     kind: 'field';
     target: DashboardFilterFieldTarget;
     prefix?: 'Auto' | 'Suggested';
+    muted?: true;
 }
 /** A SQL card's Auto: the field it takes the value by. */
  | {
@@ -265,11 +269,22 @@ export type DashboardFilterMappingRowView = {
     state: DashboardFilterMappingRowState;
     /** The status column of the table review. */
     label: string;
-    tone: 'quiet' | 'review' | 'warning' | 'invalid';
-    /** How the row counts in the summary; none while its source or the server's answer is pending. */
-    count?: 'covered' | 'review' | 'excluded' | 'invalid';
-    /** Counted to review or invalid. */
+    /**
+     * Colour means something needs fixing (relationship filter reach R-31):
+     * `review` (amber) a field must be chosen before saving, `invalid` (red) a
+     * decision that no longer runs. Everything else is `quiet`, offers too.
+     */
+    tone: 'quiet' | 'review' | 'invalid';
+    /**
+     * How the row counts in the summary: applied, an open offer (a suggested
+     * field, a path to choose), not applied, a field to choose, or invalid;
+     * none while its source or the server's answer is pending.
+     */
+    count?: 'covered' | 'suggested' | 'pathChoice' | 'excluded' | 'needsChoice' | 'invalid';
+    /** Something breaks or blocks saving: a field to choose, or invalid. The Cards tab dot and the chip warning. */
     attention: boolean;
+    /** A suggested field the row offers to use in one click ("Use"). */
+    suggestion?: DashboardFilterFieldTarget;
     /** Accept is refused while the row stands: a decision that can't run, a field to choose, fields not loaded. */
     blocksAccept: boolean;
     /** A menu, or a control that only says why there is nothing to choose. */
@@ -337,9 +352,15 @@ export type DashboardFilterMappingAcceptance = {
 };
 export type DashboardFilterMappingStatusSummary = {
     coveredCount: number;
-    reviewCount: number;
+    /** Cards with a suggested field to use; they aren't filtered until it's used. */
+    suggestedCount: number;
+    /** Cards with equally preferred paths; they aren't filtered until one is chosen. */
+    pathChoiceCount: number;
     excludedCount: number;
+    /** Cards that need a field chosen before the mapping can be saved. */
+    needsChoiceCount: number;
     invalidCount: number;
+    /** What breaks or blocks saving (needs a field, invalid): the Cards tab dot and the chip warning. */
     attentionCount: number;
 };
 export type DashboardFilterMappingDraft = {
@@ -409,6 +430,21 @@ export type DashboardFilterMappingRequest = {
  * surface uses to decide whether the author needs to act.
  */
 export declare function summarizeDashboardFilterMappingRows(rows: DashboardFilterMappingDraftRow[]): DashboardFilterMappingStatusSummary;
+/**
+ * What breaks or blocks saving, in words, for the chip warning, the Cards
+ * tab dot and the popover footer (relationship filter reach R-31). Absent
+ * when nothing does.
+ */
+export declare function describeDashboardFilterMappingAttention(summary: DashboardFilterMappingStatusSummary): {
+    tone: 'invalid' | 'review';
+    text: string;
+} | undefined;
+/**
+ * Open offers, in words, for the popover footer: cards that aren't filtered
+ * until the author uses a suggestion or chooses a path. Information, not a
+ * warning (R-31). Absent when there are none.
+ */
+export declare function describeDashboardFilterMappingOffers(summary: DashboardFilterMappingStatusSummary): string | undefined;
 /**
  * One Cards row for a source-qualified value field that is not a toolbar
  * filter, such as a field a click carries. It is the same decision chain the

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.547",
+  "version": "0.1.548",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",