@sproutsocial/racine 31.4.0 → 31.5.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Change Log
 
+## 31.5.0
+
+### Minor Changes
+
+- 1aca1d1: `MetricHighlight` now takes a `sparkline` render slot instead of owning the
+  chart itself. Pass any node (e.g. a `<SparklineChart />` from
+  `@sproutsocial/seeds-react-data-viz/sparkline`) to render it beside/below the
+  metric; omit it to render the metric on its own. This replaces the previous
+  `data` and `chart` props.
+- 0b37765: Add the `NarrativeDivider` primitive to `seeds-react-narrative-kit` — a full-width,
+  1px horizontal rule for separating sections within a narrative brief, using the
+  `container.border` token (dark-mode aware). Exported through `@sproutsocial/racine`.
+- 0b37765: Add the `NarrativeSummary` primitive to `seeds-react-narrative-kit` — a composed
+  block pairing a lead column (eyebrow + headline + optional action) with a Summary
+  section and a Key themes list, laid out as a container-query-driven grid with
+  `three-column` and `two-column` (1/3 | 2/3) arrangements. Also adds a `size` prop
+  (`"default" | "small"`) to `NarrativeHeadline`. Exported through
+  `@sproutsocial/racine`.
+
+### Patch Changes
+
+- Updated dependencies [1aca1d1]
+- Updated dependencies [0b37765]
+- Updated dependencies [0b37765]
+  - @sproutsocial/seeds-react-narrative-kit@0.3.0
+
 ## 31.4.0
 
 ### Minor Changes

package/dist/components.css

@@ -1251,47 +1251,37 @@
   stroke-width: 1.5;
 }
 
-/* Sparkline — a single normalized polyline stretched to fit. The non-scaling
-   stroke keeps a crisp 2px line at any aspect ratio. */
-.seeds-metric-highlight-spark {
-  display: block;
+/* Slot for an injected chart (e.g. a data-viz SparklineChart). Layout only — no
+   stroke/background styling, so the injected chart controls its own look. Heights
+   are explicit (never percentage/stretch) so a Highcharts chart always measures a
+   concrete container instead of falling back to its 400px default. */
+.seeds-metric-highlight-chart {
+  box-sizing: border-box;
   flex: 0 0 auto;
-  /* Matches the design's Data Viz / Categorical 01 line color (#0b968f). */
-  stroke: var(--color-teal-700);
-}
-
-/* Downward trend: the red analog at the same scale step (#db3e3e). */
-.seeds-metric-highlight-spark-negative {
-  stroke: var(--color-red-700);
-}
-
-.seeds-metric-highlight-spark path {
-  stroke: inherit;
-  stroke-width: 2;
-  vector-effect: non-scaling-stroke;
+  align-self: center;
+  /* Center the injected chart as a flex item — an inline/inline-block child
+     (e.g. the data-viz SparklineChart) otherwise sits on the text baseline with
+     descender space below it, reading as vertically off-center in the slot. */
+  display: flex;
+  align-items: center;
 }
 
-/* Horizontal: a compact fixed-width chart beside the metric, matched to the
-   metric block's height. */
-.seeds-metric-highlight:not(.seeds-metric-highlight-vertical) .seeds-metric-highlight-spark {
+.seeds-metric-highlight:not(.seeds-metric-highlight-vertical) .seeds-metric-highlight-chart {
   width: 104px;
-  align-self: stretch;
-  min-height: 40px;
+  height: 48px;
 }
 
-.seeds-metric-highlight-small:not(.seeds-metric-highlight-vertical) .seeds-metric-highlight-spark {
+.seeds-metric-highlight-small:not(.seeds-metric-highlight-vertical) .seeds-metric-highlight-chart {
   width: 88px;
   height: 40px;
-  align-self: center;
 }
 
-/* Vertical: a full-width chart stacked beneath the metric. */
-.seeds-metric-highlight-vertical .seeds-metric-highlight-spark {
+.seeds-metric-highlight-vertical .seeds-metric-highlight-chart {
   width: 100%;
   height: 96px;
 }
 
-.seeds-metric-highlight-vertical.seeds-metric-highlight-small .seeds-metric-highlight-spark {
+.seeds-metric-highlight-vertical.seeds-metric-highlight-small .seeds-metric-highlight-chart {
   height: 56px;
 }
 
@@ -1355,6 +1345,35 @@
 
 }
 
+/* --- seeds-react-narrative-kit --- */
+/**
+ * Seeds NarrativeDivider component classes.
+ * Use these instead of writing out individual Tailwind utility classes.
+ *
+ * Requires @sproutsocial/seeds-react-theme/dist/theme-all.css imported for
+ * CSS variable definitions and dark mode support.
+ *
+ * Usage:
+ *   <hr class="seeds-narrative-divider" />
+ */
+
+@layer components {
+
+/* A full-width, 1px horizontal rule. The <hr> ships with user-agent margins
+   and a beveled border, so reset those and draw the line with a single
+   border-top using the container-border-base token (#dee1e1), which also
+   tracks dark mode. */
+.seeds-narrative-divider {
+  box-sizing: border-box;
+  width: 100%;
+  height: 0;
+  margin: 0;
+  border: 0;
+  border-top: 1px solid var(--color-container-border-base); /* #dee1e1 */
+}
+
+}
+
 /* --- seeds-react-narrative-kit --- */
 /**
  * Seeds NarrativeHeadline component classes.
@@ -1385,6 +1404,13 @@
   color: var(--color-text-headline);
 }
 
+/* Compact size for denser layouts (e.g. NarrativeSummary). Weight, letter
+   spacing, and color are inherited from the base class. */
+.seeds-narrative-headline-small {
+  font-size: var(--font-size-600); /* 24px */
+  line-height: var(--line-height-600); /* 32px */
+}
+
 /* Static gradient accent for a span of headline text ("highlighted word").
    Paints the AI brand gradient onto the glyphs via background-clip. */
 .seeds-narrative-headline-highlight {
@@ -1482,6 +1508,134 @@
 
 }
 
+/* --- seeds-react-narrative-kit --- */
+/**
+ * Seeds NarrativeSummary component classes.
+ * Use these instead of writing out individual Tailwind utility classes.
+ *
+ * Requires @sproutsocial/seeds-react-theme/dist/theme-all.css imported for
+ * CSS variable definitions and dark mode support. Also relies on
+ * narrative-headline.css (headline) and eyebrow-token.css (eyebrow).
+ *
+ * The layout is a CSS grid driven by a container query on the root, so the
+ * columns collapse based on the width the component is given, not the viewport.
+ *
+ * Usage:
+ *   <div class="seeds-narrative-summary">
+ *     <div class="seeds-narrative-summary-grid">…</div>
+ *   </div>
+ */
+
+@layer components {
+
+/* Establishes the query container. The grid inside reacts to this element's
+   inline size. */
+.seeds-narrative-summary {
+  container-type: inline-size;
+  box-sizing: border-box;
+  font-family: var(--font-family);
+}
+
+/* Stacked single column by default (narrow). The container query below expands
+   it once there is room. */
+.seeds-narrative-summary-grid {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: var(--space-450); /* 24px */
+}
+
+/* The lead column: eyebrow, headline, optional action. align-items:flex-start
+   keeps the eyebrow pill and the action sized to their content — without it the
+   column's default stretch would blow the eyebrow out to full width. The
+   headline still fills and wraps because its text is wider than the track. */
+.seeds-narrative-summary-lead {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: var(--space-300); /* 8px */
+  min-width: 0;
+}
+
+/* The headline area grows so the action anchors toward the bottom of the lead
+   column when the neighboring columns are taller. align-self:stretch fills the
+   track width (the lead column pins other items to flex-start) so the headline
+   wraps at the column edge regardless of its length. */
+.seeds-narrative-summary-headline {
+  flex: 1 1 auto;
+  align-self: stretch;
+}
+
+/* In three-column mode the content wrapper is transparent to the grid, so its
+   two sections become grid items in their own columns. In two-column mode the
+   container query below turns it into a real, stacking grid item. */
+.seeds-narrative-summary-content {
+  display: contents;
+}
+
+.seeds-narrative-summary-section {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-300); /* 8px */
+  min-width: 0;
+}
+
+/* Section label. 14px / 24px has no exact type token (the scale skips from
+   13px to 16px), so the design value is kept verbatim — same rationale as
+   eyebrow-token.css. All other values use tokens. */
+.seeds-narrative-summary-label {
+  margin: 0;
+  font-size: 14px;
+  line-height: 24px;
+  font-weight: var(--font-weight-bold);
+  color: var(--color-text-headline);
+}
+
+.seeds-narrative-summary-text {
+  margin: 0;
+  font-size: 14px; /* off-scale, see label above */
+  line-height: 24px;
+  font-weight: var(--font-weight-normal);
+  color: var(--color-text-body);
+}
+
+.seeds-narrative-summary-list {
+  margin: 0;
+  padding-inline-start: 21px;
+  list-style: disc;
+  font-size: 14px; /* off-scale, see label above */
+  line-height: 24px;
+  font-weight: var(--font-weight-normal);
+  color: var(--color-text-body);
+}
+
+.seeds-narrative-summary-list li {
+  margin: 0;
+}
+
+/* Expand to the multi-column layout once the component is wide enough. The
+   threshold is on the component's own width (container query), so a narrow card
+   on a wide screen still stacks. 640px = Tailwind/Seeds sm breakpoint. */
+@container (min-width: 640px) {
+  .seeds-narrative-summary-grid {
+    grid-template-columns: repeat(3, 1fr);
+  }
+
+  /* 1/3 lead + 2/3 content. */
+  .seeds-narrative-summary-two-column {
+    grid-template-columns: 1fr 2fr;
+  }
+
+  /* The content wrapper becomes a real grid item that stacks its two sections. */
+  .seeds-narrative-summary-two-column .seeds-narrative-summary-content {
+    display: flex;
+    flex-direction: column;
+    gap: var(--space-450); /* 24px */
+    min-width: 0;
+  }
+}
+
+}
+
 /* --- seeds-react-narrative-kit --- */
 /**
  * Seeds PullQuote component classes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sproutsocial/racine",
-  "version": "31.4.0",
+  "version": "31.5.0",
   "license": "MIT",
   "engines": {
     "node": ">=18"
@@ -111,7 +111,7 @@
     "@sproutsocial/seeds-react-message": "^1.0.48",
     "@sproutsocial/seeds-react-mixins": "^4.3.7",
     "@sproutsocial/seeds-react-modal": "^2.5.22",
-    "@sproutsocial/seeds-react-narrative-kit": "^0.2.0",
+    "@sproutsocial/seeds-react-narrative-kit": "^0.3.0",
     "@sproutsocial/seeds-react-numeral": "^1.0.47",
     "@sproutsocial/seeds-react-pagination": "^0.1.20",
     "@sproutsocial/seeds-react-panel": "^1.0.0",