@ovalbee/reportifact 0.0.2 → 0.0.4

package/README.md

@@ -454,7 +454,7 @@ whose names start with `$` are treated as system columns and are hidden from the
 rendered table.
 
 Common OvalBee payload — the single host contract is `action: "asset-preview"`
-(see `.agents/spec/asset-preview.md` for the full contract). It expresses a
+(see `.agents/reports-and-preview.md` for the full contract). It expresses a
 direct single-asset preview, a synchronized side-by-side comparison, and a
 browsable collection grid in one shape via `assets[]` and per-asset `layers[]`:
 
@@ -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