@carto/ps-react-ui 4.7.1 → 4.8.0

package/dist/formula-DuC0NQLH.js

@@ -0,0 +1,79 @@
+import { jsx as a, jsxs as v } from "react/jsx-runtime";
+import { c as h } from "react/compiler-runtime";
+import { u as y } from "./widget-context-DTGO0Yta.js";
+import { u as S } from "./widget-store-registry-_W4Z4xp-.js";
+import "react";
+import "zustand";
+import { Chip as b, Box as u } from "@mui/material";
+import { s as d, S as g, P as $, V as F, a as P, N as w } from "./style-DVnT6HC1.js";
+const D = new Intl.NumberFormat(void 0, {
+  style: "percent",
+  signDisplay: "always",
+  maximumFractionDigits: 1
+}), _ = {
+  positive: "success",
+  negative: "error",
+  neutral: "default"
+};
+function I(t) {
+  const e = h(9), {
+    value: l,
+    label: o,
+    severity: f,
+    format: s,
+    ChipProps: n
+  } = t, i = f ?? O(l);
+  let r;
+  e[0] !== s || e[1] !== o || e[2] !== l ? (r = o ?? (s ? s(l) : D.format(l)), e[0] = s, e[1] = o, e[2] = l, e[3] = r) : r = e[3];
+  const c = r, x = _[i];
+  let m;
+  e[4] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (m = {
+    fontWeight: 600
+  }, e[4] = m) : m = e[4];
+  let p;
+  return e[5] !== n || e[6] !== x || e[7] !== c ? (p = /* @__PURE__ */ a(b, { size: "small", color: x, label: c, sx: m, ...n }), e[5] = n, e[6] = x, e[7] = c, e[8] = p) : p = e[8], p;
+}
+function O(t) {
+  return t > 0 ? "positive" : t < 0 ? "negative" : "neutral";
+}
+function T(t) {
+  const e = h(8), {
+    items: l,
+    formatter: o,
+    ref: f
+  } = t;
+  let s;
+  if (e[0] !== o || e[1] !== l) {
+    let i;
+    e[3] !== o ? (i = (r, c) => /* @__PURE__ */ v(u, { sx: d.row, children: [
+      r.series ? /* @__PURE__ */ a(g, { name: r.series.name, color: r.series.color }) : null,
+      /* @__PURE__ */ v(u, { sx: d.body, children: [
+        /* @__PURE__ */ v(u, { sx: d.valueRow, children: [
+          r.prefix ? /* @__PURE__ */ a($, { children: r.prefix }) : null,
+          /* @__PURE__ */ a(F, { color: r.color, children: o ? o(r.value) : String(r.value) }),
+          r.suffix ? /* @__PURE__ */ a(P, { children: r.suffix }) : null
+        ] }),
+        r.note ? /* @__PURE__ */ a(w, { children: r.note }) : null
+      ] }),
+      r.delta ? /* @__PURE__ */ a(u, { sx: d.delta, children: /* @__PURE__ */ a(I, { value: r.delta.value, label: r.delta.label, severity: r.delta.severity }) }) : null
+    ] }, `formula-${r.series?.name ?? `${r.prefix ?? ""}${r.value}${r.suffix ?? ""}`}-${c}`), e[3] = o, e[4] = i) : i = e[4], s = l.map(i), e[0] = o, e[1] = l, e[2] = s;
+  } else
+    s = e[2];
+  let n;
+  return e[5] !== f || e[6] !== s ? (n = /* @__PURE__ */ a(u, { ref: f, sx: d.root, children: s }), e[5] = f, e[6] = s, e[7] = n) : n = e[7], n;
+}
+const j = Object.freeze([]), C = (t) => ({
+  data: t.data ?? j,
+  formatter: t.formatter
+});
+function B() {
+  const t = h(3), e = y(), l = S(e, C);
+  let o;
+  return t[0] !== l.data || t[1] !== l.formatter ? (o = /* @__PURE__ */ a(T, { items: l.data, formatter: l.formatter }), t[0] = l.data, t[1] = l.formatter, t[2] = o) : o = t[2], o;
+}
+export {
+  I as D,
+  B as F,
+  T as a
+};
+//# sourceMappingURL=formula-DuC0NQLH.js.map

package/dist/formula-DuC0NQLH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula-DuC0NQLH.js","sources":["../src/widgets-v2/formula/delta.tsx","../src/widgets-v2/formula/formula-ui.tsx","../src/widgets-v2/formula/formula.tsx"],"sourcesContent":["import { Chip, type ChipProps } from '@mui/material'\nimport type { DeltaSeverity } from './types'\n\nexport interface DeltaProps {\n  /** Numeric magnitude. Used for the default percent label and severity inference. */\n  value: number\n  /** Pre-formatted label override; skips the default percent formatter. */\n  label?: string\n  /**\n   * Visual treatment. When omitted it's derived from the sign of `value`:\n   * `>0 → 'positive'`, `<0 → 'negative'`, `=0 → 'neutral'`.\n   */\n  severity?: DeltaSeverity\n  /** Override the default `Intl.NumberFormat({style:'percent'})` formatter. */\n  format?: (value: number) => string\n  ChipProps?: ChipProps\n}\n\nconst defaultPercentFormatter = new Intl.NumberFormat(undefined, {\n  style: 'percent',\n  signDisplay: 'always',\n  maximumFractionDigits: 1,\n})\n\nconst SEVERITY_TO_COLOR: Record<DeltaSeverity, ChipProps['color']> = {\n  positive: 'success',\n  negative: 'error',\n  neutral: 'default',\n}\n\n/**\n * Comparative delta rendered as a small filled chip. Colour is driven by\n * `severity` (or the sign of `value`); content is `label`, the result of\n * `format(value)`, or the default percent format.\n */\nexport function Delta({\n  value,\n  label,\n  severity,\n  format,\n  ChipProps: chipProps,\n}: DeltaProps) {\n  const resolvedSeverity = severity ?? inferSeverity(value)\n  const text =\n    label ?? (format ? format(value) : defaultPercentFormatter.format(value))\n  return (\n    <Chip\n      size='small'\n      color={SEVERITY_TO_COLOR[resolvedSeverity]}\n      label={text}\n      sx={{ fontWeight: 600 }}\n      {...chipProps}\n    />\n  )\n}\n\nfunction inferSeverity(value: number): DeltaSeverity {\n  if (value > 0) return 'positive'\n  if (value < 0) return 'negative'\n  return 'neutral'\n}\n","import { Box } from '@mui/material'\nimport type { Ref } from 'react'\nimport type { FormulaDataItem } from './types'\nimport { Delta } from './delta'\nimport { Note } from './note'\nimport { Prefix } from './prefix'\nimport { Series } from './series'\nimport { Suffix } from './suffix'\nimport { Value } from './value'\nimport { styles } from './style'\n\nexport interface FormulaUIProps {\n  items: readonly FormulaDataItem[]\n  /** Number formatter — applied to each item's `value`. */\n  formatter?: (value: number) => string\n  /** Forwarded to the root `<Box>` so consumers can capture the DOM (PNG export). */\n  ref?: Ref<HTMLDivElement>\n}\n\n/**\n * Pure presentational component for the Formula widget. Each item renders as\n * a row containing (in order): optional `Series` avatar, a body with\n * `[prefix] value [suffix]` plus optional `Note`, and an optional `Delta`\n * chip pushed to the right edge.\n *\n * For fully custom layouts, compose {@link Series}, {@link Prefix},\n * {@link Value}, {@link Suffix}, {@link Note}, and {@link Delta} directly\n * instead of passing `items`.\n */\nexport function FormulaUI({ items, formatter, ref }: FormulaUIProps) {\n  return (\n    <Box ref={ref} sx={styles.root}>\n      {items.map((item, i) => (\n        // Series name is the closest stable id; fall back to the literal\n        // value (numeric KPIs rarely repeat with the same prefix/suffix).\n        <Box\n          key={`formula-${item.series?.name ?? `${item.prefix ?? ''}${item.value}${item.suffix ?? ''}`}-${i}`}\n          sx={styles.row}\n        >\n          {item.series ? (\n            <Series name={item.series.name} color={item.series.color} />\n          ) : null}\n          <Box sx={styles.body}>\n            <Box sx={styles.valueRow}>\n              {item.prefix ? <Prefix>{item.prefix}</Prefix> : null}\n              <Value color={item.color}>\n                {formatter ? formatter(item.value) : String(item.value)}\n              </Value>\n              {item.suffix ? <Suffix>{item.suffix}</Suffix> : null}\n            </Box>\n            {item.note ? <Note>{item.note}</Note> : null}\n          </Box>\n          {item.delta ? (\n            <Box sx={styles.delta}>\n              <Delta\n                value={item.delta.value}\n                label={item.delta.label}\n                severity={item.delta.severity}\n              />\n            </Box>\n          ) : null}\n        </Box>\n      ))}\n    </Box>\n  )\n}\n","import { useWidgetId, useWidgetShallow } from '../stores'\nimport { FormulaUI } from './formula-ui'\nimport type { FormulaWidgetData } from './types'\n\ninterface FormulaSlice {\n  data: FormulaWidgetData\n  formatter?: (value: number) => string\n}\n\n// Stable empty-data sentinel — keeps the slice's `data` reference stable\n// when the underlying store value is null/undefined so the shallow-equality\n// gate in `useWidgetShallow` doesn't re-render every commit.\nconst EMPTY_DATA: FormulaWidgetData = Object.freeze([]) as FormulaWidgetData\n\nconst formulaSelector = (s: {\n  data: unknown\n  formatter?: (value: number) => string\n}): FormulaSlice => ({\n  data: (s.data ?? EMPTY_DATA) as FormulaWidgetData,\n  formatter: s.formatter,\n})\n\n/**\n * Stateful Formula bridge — reads `data` (post-pipeline) and `formatter` from\n * the per-widget store and forwards them to the pure {@link FormulaUI}. Sits\n * inside `<Widget.Provider>`. Demonstrates that the composition shell\n * (Provider, Wrapper, State) doesn't care whether the rendered child is\n * ECharts (Bar) or a custom DOM tree (Formula).\n */\nexport function Formula() {\n  const id = useWidgetId()\n  const slice = useWidgetShallow(id, formulaSelector)\n  return <FormulaUI items={slice.data} formatter={slice.formatter} />\n}\n"],"names":["defaultPercentFormatter","Intl","NumberFormat","undefined","style","signDisplay","maximumFractionDigits","SEVERITY_TO_COLOR","positive","negative","neutral","Delta","t0","$","_c","value","label","severity","format","ChipProps","chipProps","resolvedSeverity","inferSeverity","t1","text","t2","t3","Symbol","for","fontWeight","t4","jsx","Chip","FormulaUI","items","formatter","ref","item","i","Box","styles","row","series","Series","name","color","jsxs","body","valueRow","prefix","Prefix","Value","String","suffix","Suffix","note","Note","delta","map","root","EMPTY_DATA","Object","freeze","formulaSelector","s","data","Formula","id","useWidgetId","slice","useWidgetShallow"],"mappings":"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"}