@vanduo-oss/framework 1.4.6 → 1.5.1

package/CHANGELOG.md

@@ -8,6 +8,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 Full release notes — covering the framework, the documentation site, and
 ecosystem packages side by side — live at <https://vanduo.dev/#changelog>.
 
+## [1.5.1] - 2026-06-20
+
+### Changed
+- Opened `dev-v151` development branch for the v1.5.1 patch cycle.
+
+### Enhanced
+- **Expanding Cards — mobile** — Below `768px`, panels stack vertically and expand in place using the same flex-grow redistribution as the desktop strip (replacing progressive hide and non-animatable `order` reorder). Inactive rows render as compact stripes with icon + title; labels and subtitles transition smoothly. `ArrowUp`/`ArrowDown` keyboard navigation added alongside left/right.
+
+### Fixed
+- **Expanding Cards — photo backgrounds** — Active panels use `background-size: cover` and `background-repeat: no-repeat` so wide expanded cards no longer show tiled repeats on the sides.
+
+## [1.5.0] - 2026-06-18
+
+### Added
+- **Layout primitives** — CSS-only `.vd-box`, `.vd-stack`, `.vd-inline`, `.vd-center`, `.vd-frame` (golden-ratio aspect box), `.vd-cover`, and `.vd-switcher` (responsive row→column without a media query) containers (`css/primitives/primitives.css`) with a `data-*` API consuming the existing Fibonacci spacing/radius and semantic tokens. The composition layer between utilities and components; zero JS, no new public tokens. Unit specs in `tests/unit/primitives.spec.ts`.
+
+### Removed
+- **Hex grid source** (`js/components/vd-hex.js`, `js/utils/hex-math.js`) and its tests. `VdHexGrid` was never bundled; it now ships solely as the standalone `@vanduo-oss/hex-grid` package.
+
+### Changed
+- Removed the unused empty `packages/` workspace and `pnpm-workspace.yaml` (the esbuild build-approval remains in `package.json` `pnpm.allowedBuilds`).
+
 ## [1.4.6] - 2026-06-12
 
 ### Added

package/README.md

@@ -1,4 +1,4 @@
-# Vanduo Framework v1.4.6
+# Vanduo Framework v1.5.1
 
 <p align="center">
   <img src="vanduo-banner.svg" alt="Vanduo Framework Banner" width="100%">
@@ -25,7 +25,16 @@ Vanduo is a zero-dependency UI framework built with HTML, CSS, and vanilla JavaS
 - Theme Switcher menu variant for icon-only light/dark/system selection in navbars
 - Playwright-based browser coverage across Chromium, Firefox, and WebKit
 
-## What's New in 1.4.6
+## What's New in 1.5.1
+
+- Development branch opened for the v1.5.1 patch cycle (`dev-v151`).
+
+## Previous: 1.5.0
+
+- **Layout primitives** — new CSS-only layout containers — `.vd-box`, `.vd-stack`, `.vd-inline`, `.vd-center`, `.vd-frame` (golden-ratio aspect box), `.vd-cover`, and `.vd-switcher` (container-query-free responsive row→column) — with a `data-*` API (`data-pad`, `data-gap`, `data-align`, `data-justify`, `data-round`, `data-ratio`…) that consumes the existing Fibonacci spacing/radius and semantic tokens. They are the composition layer between utilities and components — *utilities style an element; primitives arrange elements*. Zero JS, zero new public tokens.
+- **Hex grid is now a standalone package** — `VdHexGrid` was never part of the bundle; its source has moved out of the framework tree. Install [`@vanduo-oss/hex-grid`](https://www.npmjs.com/package/@vanduo-oss/hex-grid) directly.
+
+## Previous: 1.4.6
 
 - **Leaner default CSS** — `css/vanduo.css` now bundles the `regular` + `fill` icon weights only (~45% smaller minified CSS). Need all six weights? Import `css/icons/icons-all.css`.
 - **No-icons core build** — new `dist/vanduo-core.min.css` (`@vanduo-oss/framework/css/core`) drops the bundled icons entirely (~123 KB lighter) for consumers who ship their own icon set.
@@ -47,8 +56,8 @@ Vanduo is a zero-dependency UI framework built with HTML, CSS, and vanilla JavaS
 ### CDN
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.4.6/dist/vanduo.min.css">
-<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.4.6/dist/vanduo.min.js"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.5.1/dist/vanduo.min.css">
+<script src="https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.5.1/dist/vanduo.min.js"></script>
 <script>
   Vanduo.init();
 </script>

package/css/components/expanding-cards.css

@@ -33,7 +33,8 @@
   border-radius: 30px;
   cursor: pointer;
   background: var(--vd-expanding-card-bg, var(--vd-expanding-card-bg-default, #e6e9ed));
-  background-size: auto 120%;
+  background-repeat: no-repeat;
+  background-size: cover;
   background-position: center;
   transition: 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95);
 }
@@ -68,7 +69,6 @@
   max-width: 600px;
   margin: 0;
   border-radius: 40px;
-  background-size: auto 100%;
 }
 
 .vd-expanding-card.is-active .vd-expanding-card-shadow {
@@ -164,44 +164,113 @@
   transition-delay: 0.1s;
 }
 
-/* Progressive hide: narrow viewports hide rightmost cards (matches original) */
-@media screen and (max-width: 718px) {
+/* Mobile: vertical stack, expand in place (mirrors desktop flex-grow model) */
+@media screen and (max-width: 767.98px) {
   .vd-expanding-cards {
-    min-width: 520px;
+    --vd-expanding-card-mobile-stripe: 56px;
+    --vd-expanding-card-mobile-active: clamp(200px, 55vw, 280px);
+    --vd-expanding-card-mobile-gap: 8px;
+
+    flex-direction: column;
+    align-items: stretch;
+    overflow: hidden;
+    min-width: 0;
+    max-width: 100%;
+    width: 100%;
+    height: min(
+      72vh,
+      calc(
+        var(--vd-expanding-card-mobile-active) +
+          5 * (var(--vd-expanding-card-mobile-stripe) + var(--vd-expanding-card-mobile-gap))
+      )
+    );
+    gap: var(--vd-expanding-card-mobile-gap);
   }
 
-  .vd-expanding-card:nth-child(5) {
-    display: none;
+  .vd-expanding-card {
+    min-width: 0;
+    width: 100%;
+    margin: 0;
+    flex: 1 1 var(--vd-expanding-card-mobile-stripe);
+    min-height: var(--vd-expanding-card-mobile-stripe);
+    transition:
+      flex 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95),
+      min-height 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95),
+      border-radius 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95),
+      margin 0.5s cubic-bezier(0.05, 0.61, 0.41, 0.95);
   }
-}
 
-@media screen and (max-width: 638px) {
-  .vd-expanding-cards {
-    min-width: 440px;
+  .vd-expanding-card.is-active {
+    flex: 10000 1 var(--vd-expanding-card-mobile-active);
+    min-height: var(--vd-expanding-card-mobile-active);
+    max-width: none;
+    border-radius: 32px;
   }
 
-  .vd-expanding-card:nth-child(4) {
-    display: none;
+  .vd-expanding-card:not(.is-active) {
+    flex: 1 1 var(--vd-expanding-card-mobile-stripe);
+    min-height: var(--vd-expanding-card-mobile-stripe);
+    border-radius: 28px;
   }
-}
 
-@media screen and (max-width: 558px) {
-  .vd-expanding-cards {
-    min-width: 360px;
+  .vd-expanding-card.is-active .vd-expanding-card-shadow {
+    box-shadow:
+      inset 0 -120px 120px -120px black,
+      inset 0 -120px 120px -100px black;
   }
 
-  .vd-expanding-card:nth-child(3) {
-    display: none;
+  .vd-expanding-card:not(.is-active) .vd-expanding-card-shadow {
+    bottom: 0;
+    height: 100%;
+    box-shadow: inset 0 0 80px 0 rgb(0 0 0 / 35%);
   }
-}
 
-@media screen and (max-width: 478px) {
-  .vd-expanding-cards {
-    min-width: 280px;
+  .vd-expanding-card.is-active .vd-expanding-card-label {
+    bottom: 20px;
+    left: 20px;
+    top: auto;
+    transform: none;
+    align-items: flex-end;
+  }
+
+  .vd-expanding-card:not(.is-active) .vd-expanding-card-label {
+    bottom: 8px;
+    left: 12px;
+    top: auto;
+    right: auto;
+    height: 40px;
+    transform: none;
+    align-items: center;
+  }
+
+  .vd-expanding-card:not(.is-active) .vd-expanding-card-info {
+    min-width: 0;
+    flex: 1;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  .vd-expanding-card:not(.is-active) .vd-expanding-card-info > div {
+    left: 0;
+    opacity: 1;
+  }
+
+  .vd-expanding-card:not(.is-active) .vd-expanding-card-subtitle {
+    opacity: 0;
+    max-height: 0;
+    overflow: hidden;
+  }
+
+  .vd-expanding-card.is-active .vd-expanding-card-subtitle {
+    opacity: 1;
+    max-height: 2em;
   }
 
-  .vd-expanding-card:nth-child(2) {
-    display: none;
+  .vd-expanding-card:not(.is-active) .vd-expanding-card-title {
+    font-size: 1rem;
+    overflow: hidden;
+    text-overflow: ellipsis;
   }
 }
 

package/css/primitives/primitives.css

@@ -0,0 +1,257 @@
+/**
+ * Vanduo Framework - Layout Primitives
+ *
+ * Unstyled, single-responsibility layout containers that consume design tokens.
+ * They express a layout INTENT (vertical rhythm, wrapping row, centered column)
+ * rather than a single property — the composition layer between utilities and
+ * components:  tokens -> (utilities | primitives) -> components.
+ *
+ * Override semantics: this file is imported BEFORE core/helpers.css and the
+ * utilities layer, so a spacing/gap/padding/radius utility on the same element
+ * (e.g. .vd-gap-5) always wins over a primitive's default on equal specificity.
+ * Each primitive sets a vd-prefixed internal custom property defaulted from a
+ * token; data-* attributes remap that property.
+ *
+ *   .vd-box      data-pad data-bg data-round data-border
+ *   .vd-stack    data-gap data-align
+ *   .vd-inline   data-gap data-align data-justify data-wrap
+ *   .vd-center   data-axis data-max
+ *   .vd-frame    data-ratio
+ *   .vd-cover    data-min data-gap
+ *   .vd-switcher data-threshold data-gap
+ *
+ * @since 1.5.0
+ * @license MIT
+ */
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * BOX — a single padded / optionally skinned surface
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-box {
+  --vd-box-pad: 0;
+  --vd-box-radius: 0;
+
+  display: block;
+  padding: var(--vd-box-pad);
+  border-radius: var(--vd-box-radius);
+}
+
+.vd-box[data-pad="0"] { --vd-box-pad: 0; }
+.vd-box[data-pad="fib-1"] { --vd-box-pad: var(--vd-space-fib-1); }
+.vd-box[data-pad="fib-2"] { --vd-box-pad: var(--vd-space-fib-2); }
+.vd-box[data-pad="fib-3"] { --vd-box-pad: var(--vd-space-fib-3); }
+.vd-box[data-pad="fib-5"] { --vd-box-pad: var(--vd-space-fib-5); }
+.vd-box[data-pad="fib-8"] { --vd-box-pad: var(--vd-space-fib-8); }
+.vd-box[data-pad="fib-13"] { --vd-box-pad: var(--vd-space-fib-13); }
+.vd-box[data-pad="fib-21"] { --vd-box-pad: var(--vd-space-fib-21); }
+.vd-box[data-pad="fib-34"] { --vd-box-pad: var(--vd-space-fib-34); }
+.vd-box[data-pad="fib-55"] { --vd-box-pad: var(--vd-space-fib-55); }
+
+/* Background — canonical semantic surfaces */
+.vd-box[data-bg="primary"] { background-color: var(--vd-bg-primary); }
+.vd-box[data-bg="secondary"] { background-color: var(--vd-bg-secondary); }
+.vd-box[data-bg="tertiary"] { background-color: var(--vd-bg-tertiary); }
+.vd-box[data-bg="dark"] { background-color: var(--vd-bg-dark); }
+.vd-box[data-bg="darker"] { background-color: var(--vd-bg-darker); }
+
+/* Radius — mirrors the .vd-rounded-* scale (uses data-round, NOT data-radius,
+   which is the global theme-customizer radius hook). */
+.vd-box[data-round="none"] { --vd-box-radius: 0; }
+.vd-box[data-round="sm"] { --vd-box-radius: var(--vd-radius-fib-2); }
+.vd-box[data-round="md"] { --vd-box-radius: var(--vd-radius-fib-5); }
+.vd-box[data-round="lg"] { --vd-box-radius: var(--vd-radius-fib-8); }
+.vd-box[data-round="xl"] { --vd-box-radius: var(--vd-radius-fib-13); }
+.vd-box[data-round="2xl"] { --vd-box-radius: var(--vd-radius-fib-21); }
+.vd-box[data-round="full"] { --vd-box-radius: 9999px; }
+
+.vd-box[data-border] { border: 1px solid var(--vd-border-color); }
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * STACK — vertical rhythm (flex column with token-driven gap)
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-stack {
+  --vd-stack-gap: 0;
+
+  display: flex;
+  flex-direction: column;
+  gap: var(--vd-stack-gap);
+}
+
+.vd-stack[data-gap="0"] { --vd-stack-gap: 0; }
+.vd-stack[data-gap="fib-1"] { --vd-stack-gap: var(--vd-space-fib-1); }
+.vd-stack[data-gap="fib-2"] { --vd-stack-gap: var(--vd-space-fib-2); }
+.vd-stack[data-gap="fib-3"] { --vd-stack-gap: var(--vd-space-fib-3); }
+.vd-stack[data-gap="fib-5"] { --vd-stack-gap: var(--vd-space-fib-5); }
+.vd-stack[data-gap="fib-8"] { --vd-stack-gap: var(--vd-space-fib-8); }
+.vd-stack[data-gap="fib-13"] { --vd-stack-gap: var(--vd-space-fib-13); }
+.vd-stack[data-gap="fib-21"] { --vd-stack-gap: var(--vd-space-fib-21); }
+.vd-stack[data-gap="fib-34"] { --vd-stack-gap: var(--vd-space-fib-34); }
+.vd-stack[data-gap="fib-55"] { --vd-stack-gap: var(--vd-space-fib-55); }
+
+.vd-stack[data-align="start"] { align-items: flex-start; }
+.vd-stack[data-align="center"] { align-items: center; }
+.vd-stack[data-align="end"] { align-items: flex-end; }
+.vd-stack[data-align="stretch"] { align-items: stretch; }
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * INLINE — horizontal cluster (wrapping flex row with token-driven gap)
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-inline {
+  --vd-inline-gap: 0;
+
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--vd-inline-gap);
+}
+
+.vd-inline[data-gap="0"] { --vd-inline-gap: 0; }
+.vd-inline[data-gap="fib-1"] { --vd-inline-gap: var(--vd-space-fib-1); }
+.vd-inline[data-gap="fib-2"] { --vd-inline-gap: var(--vd-space-fib-2); }
+.vd-inline[data-gap="fib-3"] { --vd-inline-gap: var(--vd-space-fib-3); }
+.vd-inline[data-gap="fib-5"] { --vd-inline-gap: var(--vd-space-fib-5); }
+.vd-inline[data-gap="fib-8"] { --vd-inline-gap: var(--vd-space-fib-8); }
+.vd-inline[data-gap="fib-13"] { --vd-inline-gap: var(--vd-space-fib-13); }
+.vd-inline[data-gap="fib-21"] { --vd-inline-gap: var(--vd-space-fib-21); }
+.vd-inline[data-gap="fib-34"] { --vd-inline-gap: var(--vd-space-fib-34); }
+.vd-inline[data-gap="fib-55"] { --vd-inline-gap: var(--vd-space-fib-55); }
+
+.vd-inline[data-align="start"] { align-items: flex-start; }
+.vd-inline[data-align="center"] { align-items: center; }
+.vd-inline[data-align="end"] { align-items: flex-end; }
+.vd-inline[data-align="baseline"] { align-items: baseline; }
+.vd-inline[data-align="stretch"] { align-items: stretch; }
+
+.vd-inline[data-justify="start"] { justify-content: flex-start; }
+.vd-inline[data-justify="center"] { justify-content: center; }
+.vd-inline[data-justify="end"] { justify-content: flex-end; }
+.vd-inline[data-justify="between"] { justify-content: space-between; }
+.vd-inline[data-justify="around"] { justify-content: space-around; }
+.vd-inline[data-justify="evenly"] { justify-content: space-evenly; }
+
+.vd-inline[data-wrap="nowrap"] { flex-wrap: nowrap; }
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * CENTER — center a column horizontally (data-max) and/or its content (data-axis)
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-center {
+  --vd-center-max: none;
+
+  display: block;
+  max-width: var(--vd-center-max);
+  margin-inline: auto;
+}
+
+.vd-center[data-max="fib-377"] { --vd-center-max: 377px; }
+.vd-center[data-max="fib-610"] { --vd-center-max: 610px; }
+.vd-center[data-max="fib-987"] { --vd-center-max: 987px; }
+
+.vd-center[data-axis="both"] {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.vd-center[data-axis="horizontal"] {
+  display: flex;
+  justify-content: center;
+}
+
+.vd-center[data-axis="vertical"] {
+  display: flex;
+  align-items: center;
+}
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * FRAME — a fixed aspect-ratio box (golden by default); media children cover it
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-frame {
+  --vd-frame-ratio: 1.618;
+
+  display: block;
+  overflow: hidden;
+  aspect-ratio: var(--vd-frame-ratio);
+}
+
+.vd-frame > img,
+.vd-frame > video,
+.vd-frame > canvas,
+.vd-frame > svg,
+.vd-frame > iframe {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.vd-frame[data-ratio="golden"] { --vd-frame-ratio: 1.618; }
+.vd-frame[data-ratio="golden-portrait"] { --vd-frame-ratio: 0.618; }
+.vd-frame[data-ratio="square"] { --vd-frame-ratio: 1; }
+.vd-frame[data-ratio="16-9"] { --vd-frame-ratio: 1.7778; }
+.vd-frame[data-ratio="4-3"] { --vd-frame-ratio: 1.3333; }
+.vd-frame[data-ratio="3-2"] { --vd-frame-ratio: 1.5; }
+.vd-frame[data-ratio="21-9"] { --vd-frame-ratio: 2.3333; }
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * COVER — a min-height region that vertically centers its content
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-cover {
+  --vd-cover-min: 100vh;
+  --vd-cover-gap: 0;
+
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  gap: var(--vd-cover-gap);
+  min-height: var(--vd-cover-min);
+}
+
+.vd-cover[data-min="screen"] { --vd-cover-min: 100vh; }
+.vd-cover[data-min="half"] { --vd-cover-min: 50vh; }
+.vd-cover[data-min="fib-610"] { --vd-cover-min: 610px; }
+.vd-cover[data-min="fib-987"] { --vd-cover-min: 987px; }
+
+.vd-cover[data-gap="fib-3"] { --vd-cover-gap: var(--vd-space-fib-3); }
+.vd-cover[data-gap="fib-5"] { --vd-cover-gap: var(--vd-space-fib-5); }
+.vd-cover[data-gap="fib-8"] { --vd-cover-gap: var(--vd-space-fib-8); }
+.vd-cover[data-gap="fib-13"] { --vd-cover-gap: var(--vd-space-fib-13); }
+.vd-cover[data-gap="fib-21"] { --vd-cover-gap: var(--vd-space-fib-21); }
+.vd-cover[data-gap="fib-34"] { --vd-cover-gap: var(--vd-space-fib-34); }
+
+/* ═══════════════════════════════════════════════════════════════════════════
+ * SWITCHER — auto row→column at a container-width threshold (no media query).
+ * When the container is wider than the threshold the children share a row;
+ * narrower and they each take a full row. Thresholds are Fibonacci by design.
+ * ═══════════════════════════════════════════════════════════════════════════ */
+
+.vd-switcher {
+  --vd-switcher-threshold: 610px;
+  --vd-switcher-gap: 0;
+
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--vd-switcher-gap);
+}
+
+.vd-switcher > * {
+  flex-grow: 1;
+  flex-basis: calc((var(--vd-switcher-threshold) - 100%) * 999);
+}
+
+.vd-switcher[data-threshold="fib-377"] { --vd-switcher-threshold: 377px; }
+.vd-switcher[data-threshold="fib-610"] { --vd-switcher-threshold: 610px; }
+.vd-switcher[data-threshold="fib-987"] { --vd-switcher-threshold: 987px; }
+
+.vd-switcher[data-gap="fib-3"] { --vd-switcher-gap: var(--vd-space-fib-3); }
+.vd-switcher[data-gap="fib-5"] { --vd-switcher-gap: var(--vd-space-fib-5); }
+.vd-switcher[data-gap="fib-8"] { --vd-switcher-gap: var(--vd-space-fib-8); }
+.vd-switcher[data-gap="fib-13"] { --vd-switcher-gap: var(--vd-space-fib-13); }
+.vd-switcher[data-gap="fib-21"] { --vd-switcher-gap: var(--vd-space-fib-21); }
+.vd-switcher[data-gap="fib-34"] { --vd-switcher-gap: var(--vd-space-fib-34); }

package/css/vanduo.css

@@ -12,6 +12,13 @@
 @import url('core/typography.css');
 @import url('core/tokens.css');
 @import url('core/grid.css');
+
+/* Layer 1.5: Layout primitives (Box, Stack, Inline, Center).
+   Imported BEFORE helpers so the spacing/gap/padding/radius utilities that follow
+   override a primitive default on equal specificity (utilities stay the escape
+   hatch). Primitive token references resolve order-independently from :root. */
+@import url('primitives/primitives.css');
+
 @import url('core/helpers.css');
 
 /* Layer 2: Icons (regular + fill; import css/icons/icons-all.css for all 6 weights) */

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.4.6",
-  "builtAt": "2026-06-13T10:32:26.875Z",
-  "commit": "82019ff",
+  "version": "1.5.1",
+  "builtAt": "2026-06-20T15:00:18.257Z",
+  "commit": "baf8178",
   "mode": "development+production"
 }