@ovalbee/reportifact 0.0.2 → 0.0.3

package/README.md

@@ -736,7 +736,6 @@ pages that only use metric components.
 
 ```vue
 <script setup lang="ts">
-import ReportifactFigure from '@ovalbee/reportifact/widgets/figure';
 import ReportifactChart from '@ovalbee/reportifact/widgets/chart';
 import '@ovalbee/reportifact/style.css';
 
@@ -747,13 +746,11 @@ const chart = {
 </script>
 
 <template>
-  <ReportifactFigure
-    title="Validation mAP"
+  <ReportifactChart
+    type="bar-gradient"
+    :data="chart"
     caption="DEIM leads on the held-out validation set."
-    fallback-src="/case-studies/yolo-vs-deim/map.webp"
-  >
-    <ReportifactChart type="bar-gradient" :data="chart" />
-  </ReportifactFigure>
+  />
 </template>
 ```
 
@@ -762,7 +759,6 @@ Public subpaths:
 | Import | Component | Portable input |
 | --- | --- | --- |
 | `@ovalbee/reportifact/widgets/host` | `ReportifactWidgetHost` | Theme and loading-style boundary. |
-| `@ovalbee/reportifact/widgets/figure` | `ReportifactFigure` | Semantic title/caption, loading, error fallback, source link. |
 | `@ovalbee/reportifact/widgets/chart` | `ReportifactChart` | `src` JSON URL or inline `data`. |
 | `@ovalbee/reportifact/widgets/metric-cards` | `ReportifactMetricCards` | Inline `data` or Markdown-table `content`. |
 | `@ovalbee/reportifact/widgets/metric-callout` | `ReportifactMetricCallout` | Inline `data` or direct props. |
@@ -773,18 +769,22 @@ Public subpaths:
 
 For URL-backed widgets, `src` is the portable spelling and legacy `url` remains
 supported for the full report renderer. Inline `data` takes precedence when
-both are present. `ReportifactFigure` owns the shared loading and fallback
-presentation; its `fallbackImage` is also emitted as a no-JavaScript fallback and replaces a
-failed child widget. `fallbackSrc` remains available as a compatibility alias.
-Wrap lower-level widgets in `ReportifactWidgetHost` when they are not already
-inside a `ReportifactFigure` or full `Reportifact` renderer.
+both are present. Every portable widget already renders a semantic `<figure>`
+and accepts optional `caption`, `sourceHref`, and `sourceLabel` props. The
+shared `WidgetWrapper` owns that semantic frame together with loading and error
+presentation; hosts do not add another wrapper. Static fallback images are not
+part of the portable v1 authoring contract.
+
+The full report directives accept the same `caption`, `sourceHref`, and
+`sourceLabel` options. Existing reports remain valid when those options are
+absent.
 
 `MetricCallout`'s `html` field is trusted pre-rendered HTML. Do not pass
 untrusted user input without sanitizing it first.
 
 Parquet tables, TensorBoard, scopes, and the full widget dispatcher remain
-full-report features. Embed a public full report for those experiences instead
-of importing their internals into a content page.
+full-report features. Publish a static summary or link to a public Live Example
+for those experiences instead of importing their internals into a content page.
 
 ### Custom Widgets
 

package/dist/{Chart.vue_vue_type_style_index_0_lang-Bp14Es_r.js → Chart.vue_vue_type_style_index_0_lang-Bxrsp8Oz.js}

@@ -1,7 +1,7 @@
 import { defineComponent as li, ref as kt, onMounted as ui, onUnmounted as ci, computed as st, watch as vi, createBlock as pa, openBlock as ga, withCtx as da, createElementVNode as lt, normalizeStyle as ma, createCommentVNode as hi, unref as fi } from "vue";
 import { aW as j, b6 as ya, c as Qe, aY as Tt, d as ge, b7 as St, b8 as ba, b9 as Rt, _ as B, u as Vt, a9 as oe, aQ as de, a5 as F, S as Re, ba as pi, bb as gi, bc as ae, bd as et, be as ie, bf as Ce, bg as di, a7 as it, e as re, bh as $e, V as me, bi as De, bj as Sa, bk as xr, a2 as ra, Q as ia, X as Ar, bl as ye, v as Y, bm as _t, bn as Oe, bo as He, bp as mi, bq as _a, br as wa, P as nt, b as K, bs as xa, bt as Te, $ as yi, bu as Aa, R as Me, bv as Ia, aZ as Ee, a8 as ue, bw as bi, bx as Ir, y as z, by as Si, bz as na, bA as _i, bB as wi, bC as Da, bD as Ma, bE as xi, bF as Dr, bG as Ai, f as We, bH as Ii, bI as Fe, aG as oa, bJ as La, M as Z, bK as jt, A as wt, bL as yt, O as Di, bM as Ue, aN as ke, bN as Mr, W as Lr, bO as Mi, bP as Li, bQ as Ci, bR as Ti, bS as Vi, bT as Pi, aI as Ei, bU as ki, m as Cr, bV as Ri, bW as Oi, bX as Ni, aR as $, bY as zi, bZ as Gi, b_ as Bi, b$ as Tr, c0 as Hi, c1 as Vr, aq as te, ap as ne, a1 as Fi, c2 as Ui, c3 as $i, c4 as Ca, aX as sa, c5 as Wi, ak as xt, c6 as Xi, c7 as Yi, c8 as Zi, c9 as qi, ca as Ki, an as Pr, cb as ji, cc as Ji, cd as Qi, ce as Ta, ao as Er, cf as en, aK as kr, cg as tn, ch as Va, aD as an, ci as rn, cj as nn, ck as on, cl as Rr, a_ as At, F as sn, cm as Ot, cn as Nt, n as ln, B as un, co as cn, cp as vn, cq as zt, cr as Pa, ay as hn, cs as fn, a0 as pe, ct as Ea, cu as pn, cv as ka, w as Ra, z as Gt, cw as gn, cx as dn, cy as mn, cz as yn, ar as Or, cA as bn, cB as Sn, aM as _n, s as Jt, cC as wn, as as xn, aV as Bt, aT as Ht, cD as An, cE as In, aU as Dn, cF as Mn, cG as Oa, cH as Ln, cI as Cn, a$ as Tn, b0 as Vn, b1 as Pn, b2 as En, b3 as kn, b4 as Rn } from "./index-DevYhXSC.js";
 import { u as On } from "./useFetch-CHQm_TmB.js";
-import { _ as Nn } from "./WidgetWrapper.vue_vue_type_style_index_0_lang-D-oXqmI2.js";
+import { _ as Nn } from "./WidgetWrapper.vue_vue_type_style_index_0_lang-BbnW8GXT.js";
 function Nr(i, a, e, t, r, n, o, s) {
   var l = r - i, u = n - a, c = e - i, v = t - a, f = Math.sqrt(c * c + v * v);
   c /= f, v /= f;
@@ -5304,6 +5304,7 @@ function ot(i = "15%") {
 }
 function be(i = {}) {
   return {
+    valueFormatter: (a) => Ns(a),
     ...i,
     textStyle: {
       fontSize: 12,
@@ -5311,13 +5312,16 @@ function be(i = {}) {
     }
   };
 }
+function Ns(i) {
+  return typeof i != "number" || !Number.isFinite(i) ? String(i) : i.toLocaleString("en-US", { maximumFractionDigits: 4 });
+}
 function ni(i) {
   const a = typeof i == "object" && i !== null && "value" in i ? i.value : i;
   if (!Array.isArray(a) || a.length < 3) return null;
   const e = a.slice(0, 3).map(Number);
   return e.every(Number.isFinite) ? e : null;
 }
-function Ns(i) {
+function zs(i) {
   if (!i.length)
     return { min: 0, max: 0 };
   const a = i.map((e) => {
@@ -5336,7 +5340,7 @@ function Sr(i, a, e) {
     { offset: 1, color: a }
   ]);
 }
-const zs = (i, a) => {
+const Gs = (i, a) => {
   const e = (a == null ? void 0 : a.horizontal) === !0 || (a == null ? void 0 : a.horizontal) === "true", t = {
     type: "category",
     data: i.xAxis,
@@ -5373,7 +5377,7 @@ const zs = (i, a) => {
       }
     ]
   };
-}, Gs = (i, a) => ({
+}, Bs = (i, a) => ({
   ...he(),
   title: fe(a, "Grouped Bar Chart"),
   tooltip: be({
@@ -5410,19 +5414,19 @@ function _r(i) {
   }
   return 0;
 }
-function Bs(i) {
+function Hs(i) {
   if (typeof i == "object" && i !== null && "clickId" in i) {
     const a = i.clickId;
     return typeof a == "string" ? a : void 0;
   }
 }
-function Hs(i, a) {
+function Fs(i, a) {
   return a.map((e, t) => {
-    const r = _r(e), n = i.reduce((l, u) => l + _r(u.data[t]), 0), o = n ? r / n : 0, s = Bs(e);
+    const r = _r(e), n = i.reduce((l, u) => l + _r(u.data[t]), 0), o = n ? r / n : 0, s = Hs(e);
     return s ? { value: o, clickId: s } : o;
   });
 }
-const Fs = (i, a) => ({
+const Us = (i, a) => ({
   ...he(),
   title: fe(a, "Normalized Bar Chart"),
   tooltip: be({
@@ -5457,9 +5461,9 @@ const Fs = (i, a) => ({
     type: "bar",
     stack: "total",
     emphasis: { focus: "series" },
-    data: Hs(i.series, e.data)
+    data: Fs(i.series, e.data)
   }))
-}), Us = (i, a) => ({
+}), $s = (i, a) => ({
   ...he(),
   title: fe(a, "Stacked Bar Chart"),
   tooltip: be({
@@ -5493,7 +5497,7 @@ const Fs = (i, a) => ({
 function wr(i, a) {
   return `${Number.isInteger(i) ? String(i) : i.toFixed(2).replace(/\.?0+$/, "")}${a}`;
 }
-const $s = (i, a) => {
+const Ws = (i, a) => {
   const e = i.unit ?? rt(a, "unit", "%"), t = i.name ?? rt(a, "seriesName", ""), r = Number(i.value) || 0, n = wr(r, e);
   return {
     ...he(),
@@ -5585,8 +5589,8 @@ const $s = (i, a) => {
       }
     ]
   };
-}, Ws = (i, a) => {
-  const e = Number(i.value) || 0, t = i.grade ?? Xs(e);
+}, Xs = (i, a) => {
+  const e = Number(i.value) || 0, t = i.grade ?? Ys(e);
   return {
     ...he(),
     title: fe(a, "Assistance Score", {
@@ -5668,11 +5672,11 @@ const $s = (i, a) => {
     ]
   };
 };
-function Xs(i) {
+function Ys(i) {
   return i >= 0.9 ? "Production-grade" : i >= 0.6 ? "Strong assist" : i >= 0.3 ? "Partial assist" : "Minimal assist";
 }
-const Ys = (i, a) => {
-  const { min: e, max: t } = Ns(i.data);
+const Zs = (i, a) => {
+  const { min: e, max: t } = zs(i.data);
   return {
     ...he(),
     title: fe(a, "Heatmap"),
@@ -5720,7 +5724,7 @@ const Ys = (i, a) => {
       }
     ]
   };
-}, Zs = (i, a) => ({
+}, qs = (i, a) => ({
   ...he(),
   title: fe(a, "Line Chart"),
   tooltip: be({
@@ -5746,10 +5750,10 @@ const Ys = (i, a) => {
     ...e
   }))
 });
-function qs(i) {
+function Ks(i) {
   return i.includes(",") ? i.split(",").map((a) => a.trim()) : i;
 }
-const Ks = (i, a) => ({
+const js = (i, a) => ({
   ...he(),
   title: fe(a, "Pie Chart"),
   tooltip: be({
@@ -5764,7 +5768,7 @@ const Ks = (i, a) => ({
     {
       name: rt(a, "seriesName", "Data"),
       type: "pie",
-      radius: qs(rt(a, "radius", "50%")),
+      radius: Ks(rt(a, "radius", "50%")),
       data: Array.isArray(i) ? i : i.data,
       label: {
         textBorderWidth: 0
@@ -5778,7 +5782,7 @@ const Ks = (i, a) => ({
       }
     }
   ]
-}), js = (i, a) => {
+}), Js = (i, a) => {
   const e = i.series.length > 1;
   return {
     ...he(),
@@ -5801,30 +5805,33 @@ const Ks = (i, a) => ({
       }
     ]
   };
-}, Js = {
-  pie: Ks,
-  line: Zs,
-  radar: js,
-  "bar-normalized": Fs,
-  heatmap: Ys,
-  "bar-gradient": zs,
-  "bar-grouped": Gs,
-  "bar-stacked": Us,
-  "custom-gauge": $s,
-  "gauge-grade": Ws
+}, Qs = {
+  pie: js,
+  line: qs,
+  radar: Js,
+  "bar-normalized": Us,
+  heatmap: Zs,
+  "bar-gradient": Gs,
+  "bar-grouped": Bs,
+  "bar-stacked": $s,
+  "custom-gauge": Ws,
+  "gauge-grade": Xs
 };
-function Qs(i, a, e) {
-  const t = Js[i];
+function el(i, a, e) {
+  const t = Qs[i];
   return t(a, e);
 }
-const el = "400px";
-function tl(i, a = el) {
+const tl = "400px";
+function al(i, a = tl) {
   const e = i == null ? void 0 : i.height;
   return typeof e == "number" && Number.isFinite(e) && e > 0 ? `${e}px` : typeof e == "string" && e.trim() ? e : a;
 }
-const ol = /* @__PURE__ */ li({
+const sl = /* @__PURE__ */ li({
   __name: "Chart",
   props: {
+    caption: { default: void 0 },
+    sourceHref: { default: void 0 },
+    sourceLabel: { default: void 0 },
     url: { default: void 0 },
     src: { default: void 0 },
     data: { default: void 0 },
@@ -5857,11 +5864,11 @@ const ol = /* @__PURE__ */ li({
     }), ci(() => {
       r == null || r.disconnect();
     });
-    const n = i, o = e, s = kt(null), l = kt(null), u = st(() => n.data === void 0 ? n.src ?? n.url ?? "" : ""), c = st(() => tl(n.options));
+    const n = i, o = e, s = kt(null), l = kt(null), u = st(() => n.data === void 0 ? n.src ?? n.url ?? "" : ""), c = st(() => al(n.options));
     function v(S) {
       const x = d(S) ? S : null;
       l.value = (x == null ? void 0 : x.click) ?? null, s.value = D(
-        Qs(n.type, S, n.options),
+        el(n.type, S, n.options),
         l.value
       );
     }
@@ -5906,7 +5913,10 @@ const ol = /* @__PURE__ */ li({
     }
     return a({ refresh: _ }), (S, x) => (ga(), pa(Nn, {
       loading: !s.value && g.value,
-      error: y.value
+      error: y.value,
+      caption: n.caption,
+      "source-href": n.sourceHref,
+      "source-label": n.sourceLabel
     }, {
       skeleton: da(() => [
         lt("div", {
@@ -5936,11 +5946,11 @@ const ol = /* @__PURE__ */ li({
         ], 4)
       ]),
       _: 1
-    }, 8, ["loading", "error"]));
+    }, 8, ["loading", "error", "caption", "source-href", "source-label"]));
   }
 });
 export {
-  ol as _,
+  sl as _,
   co as i,
-  tl as r
+  al as r
 };