@flytedan/flytebot-design-system 0.62.0 → 0.63.0

package/dist/index.d.cts

@@ -2442,6 +2442,10 @@ interface USChoroplethProps {
     /** Show a ranking of this many states beside the map (below it when the component is narrow).
      *  Leave unset for no ranking. */
     topN?: number;
+    /** What 100% is, for every share the component prints (readout, ranking, table). Defaults to the sum
+     *  of `values`; pass a larger whole count when some of what you counted has no state. Smaller than
+     *  the sum throws. */
+    total?: number;
     className?: string;
 }
 /**
@@ -2463,7 +2467,7 @@ interface USChoroplethProps {
  * The outlines and the geo libraries (d3-geo, topojson-client, us-atlas) are one separate chunk,
  * fetched when the map first renders; the legend, ranking and table show at once.
  */
-declare function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, className }: USChoroplethProps): React.JSX.Element;
+declare function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, total, className }: USChoroplethProps): React.JSX.Element;
 
 /**
  * Multi-select control with a 44px comfortable hit area.

package/dist/index.d.ts

@@ -2442,6 +2442,10 @@ interface USChoroplethProps {
     /** Show a ranking of this many states beside the map (below it when the component is narrow).
      *  Leave unset for no ranking. */
     topN?: number;
+    /** What 100% is, for every share the component prints (readout, ranking, table). Defaults to the sum
+     *  of `values`; pass a larger whole count when some of what you counted has no state. Smaller than
+     *  the sum throws. */
+    total?: number;
     className?: string;
 }
 /**
@@ -2463,7 +2467,7 @@ interface USChoroplethProps {
  * The outlines and the geo libraries (d3-geo, topojson-client, us-atlas) are one separate chunk,
  * fetched when the map first renders; the legend, ranking and table show at once.
  */
-declare function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, className }: USChoroplethProps): React.JSX.Element;
+declare function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, total, className }: USChoroplethProps): React.JSX.Element;
 
 /**
  * Multi-select control with a 44px comfortable hit area.

package/dist/index.js

@@ -6423,9 +6423,9 @@ function formatShare(share) {
   return tenths >= 10 ? `${Math.round(percent)}%` : `${tenths.toFixed(1)}%`;
 }
 var byValue = (a, b) => b.value - a.value;
-function buildChoroplethModel(values, topN) {
+function buildChoroplethModel(values, topN, givenTotal) {
   const byCode = /* @__PURE__ */ new Map();
-  let total = 0;
+  let sum = 0;
   for (const { state, value } of values) {
     if (!isUsStateCode(state)) throw new Error(`USChoropleth: "${state}" is not a US state code`);
     if (byCode.has(state)) throw new Error(`USChoropleth: ${state} is given more than once`);
@@ -6433,8 +6433,12 @@ function buildChoroplethModel(values, topN) {
       throw new Error(`USChoropleth: the value for ${state} must be a whole count of 0 or more, got ${value}`);
     }
     byCode.set(state, value);
-    total += value;
+    sum += value;
+  }
+  if (givenTotal !== void 0 && !(Number.isInteger(givenTotal) && givenTotal >= sum)) {
+    throw new Error(`USChoropleth: total must be a whole count of at least the sum of values (${sum}), got ${givenTotal}`);
   }
+  const total = givenTotal ?? sum;
   const share = (value) => total === 0 ? 0 : value / total;
   const rows = US_STATES.map((state) => {
     const value = byCode.get(state.code) ?? 0;
@@ -6544,8 +6548,8 @@ function StateTable({ model, valueLabel, formatValue }) {
   ];
   return /* @__PURE__ */ jsx66(Collapsible, { title: TABLE_TITLE, children: /* @__PURE__ */ jsx66(DataTable, { columns, rows: model.rows, rowKey: "code", compact: true }) });
 }
-function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, className = "" }) {
-  const model = React44.useMemo(() => buildChoroplethModel(values, topN ?? 0), [values, topN]);
+function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, total, className = "" }) {
+  const model = React44.useMemo(() => buildChoroplethModel(values, topN ?? 0, total), [values, topN, total]);
   const figures = React44.useMemo(() => new Map(model.rows.map((row) => [row.code, row])), [model]);
   const { state, retry } = useUsStateShapes();
   return /* @__PURE__ */ jsxs56("div", { className: ["fd-uschoro", className].filter(Boolean).join(" "), children: [