@neuravision/construct 2.1.5 → 2.1.6

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to `@neuravision/construct` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.6] - 2026-07-19
+
+### Fixed
+
+- Datum registration marks on `ct-datum-frame` and `ct-card--datum` now establish an
+  isolated component stacking context and render above component-local chrome. Opaque,
+  positioned headers (such as terminal captions at `z-index: 1`) previously painted over
+  the orange corner even though `ct-datum-frame` explicitly supports code samples. The
+  mark remains contained below global overlays, and the Storybook contract now covers a
+  clipped, rounded code frame with layered chrome.
+
 ## [2.1.5] - 2026-07-17
 
 ### Fixed

package/components/card.css

@@ -110,6 +110,9 @@
    Both are opt-in and additive — they don't change default cards. */
 .ct-card--datum {
   position: relative;
+  /* Contain the datum's internal paint layer so it cannot overlap adjacent
+     cards or consumer overlays. */
+  isolation: isolate;
 }
 
 .ct-card--datum::before {
@@ -122,6 +125,8 @@
   border-block-start: var(--border-medium) solid var(--color-brand-accent);
   border-inline-start: var(--border-medium) solid var(--color-brand-accent);
   border-start-start-radius: var(--radius-lg);
+  /* Card chrome may use layer 1; the registration mark stays above it. */
+  z-index: 2;
   pointer-events: none;
 }
 

package/components/datum.css

@@ -255,6 +255,9 @@
    forced colors keeps the borders via CanvasText automatically. */
 .ct-datum-frame {
   position: relative;
+  /* Keep the datum's internal paint layer above local figure chrome without
+     allowing it to participate in the consumer's global overlay stack. */
+  isolation: isolate;
 }
 
 .ct-datum-frame::before {
@@ -267,6 +270,9 @@
   border-block-start: var(--border-medium) solid var(--color-brand-accent);
   border-inline-start: var(--border-medium) solid var(--color-brand-accent);
   border-start-start-radius: var(--radius-lg);
+  /* Code-frame headers commonly occupy layer 1. The datum must remain visible
+     above that chrome because it is the frame's registration mark. */
+  z-index: 2;
   pointer-events: none;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neuravision/construct",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Construct Design System - Accessible, token-based design system for modern web applications",
   "license": "MIT",
   "repository": {