@vmz/ui 0.3.4 → 0.3.6

package/README.md

@@ -1,51 +1,51 @@
-# @vmz/ui — VMZ UI
-
-Official **VMZ UI** framework package.
-
-```text
-VMZ Design  ≠  VMZ UI
-/designs    ≠  this package
-@vmz/ui     ≠  theme truth source
-```
-
-- Declares **semantic token requirements** (see `contracts/`).
-- Ships ordinary `.vmz` under **`src/components/`** (same hard convention as apps) — **not** `@vmz/plugin-*`, no
-  `componentsRoot` config.
-- **Never** hardcodes brand hex (`#176BFF`, etc.). Applications provide values via `/designs`.
-
-## Preview `0.0.4`
-
-This is a **preview** release. It is **not** `production-ready` and **not** a mature / production UI.
-
-Headline surface for this cut:
-
-- Commercial / Console / Document-Product composition on official homepage
-- Form depth, Structure, Overlay stacking, DataTable (ordinary HTML table — not `@vmz/ui-data-grid`)
-- DatePicker owned calendar overlay (not native `input[type=date]` popup)
-- Upload multipart binary (parent-owned FormData → `#server` File/Blob; progress/cancel)
-- Density / RTL / preset materialize
-- Motion continuity + interrupt/cancel
-- Motion compiler IR thin gate (`pnpm verify -- motion-ir`)
-- UI7 conformance pack (`@vmz/ui/conformance` + `pnpm verify -- ui7`)
-- `@vmz/ui-data-grid` thin gate (virtualization + pinned column — not tree/group/pivot/edit)
-
-Verify:
-
-```bash
-pnpm verify -- ui-automation
-pnpm verify -- ui7
-pnpm verify -- ui-data-grid
-pnpm verify -- official-homepage
-```
-
-Still open relative to Browser Production Profile v1: `browser-production` aggregate core gaps,
-`@vmz/ui-data-grid` deep capabilities, Upload cross-page session / multi-file parallel chunks,
-`@vmz/test` Browser Host U0–U1, sibling `vmz-panel` product app.
-
-## Commercial default surface
-
-Default web surface targets modern commercial console density: flat 32px-class controls,
-quiet borders, restrained radii, layered page/paper surfaces without Bootstrap-era inset
-fields, accent bars, or card lift. Applications replace every semantic value through `/designs`.
-Additional general-purpose components include layout primitives, typography, segmented controls,
-tags, avatars, dropdowns, collapse panels and progress indicators.
+# @vmz/ui — VMZ UI
+
+Official **VMZ UI** framework package.
+
+```text
+VMZ Design  ≠  VMZ UI
+/designs    ≠  this package
+@vmz/ui     ≠  theme truth source
+```
+
+- Declares **semantic token requirements** (see `contracts/`).
+- Ships ordinary `.vmz` under **`src/components/`** (same hard convention as apps) — **not** `@vmz/plugin-*`, no
+  `componentsRoot` config.
+- **Never** hardcodes brand hex (`#176BFF`, etc.). Applications provide values via `/designs`.
+
+## Preview `0.0.4`
+
+This is a **preview** release. It is **not** `production-ready` and **not** a mature / production UI.
+
+Headline surface for this cut:
+
+- Commercial / Console / Document-Product composition on official homepage
+- Form depth, Structure, Overlay stacking, DataTable (ordinary HTML table — not `@vmz/ui-data-grid`)
+- DatePicker owned calendar overlay (not native `input[type=date]` popup)
+- Upload multipart binary (parent-owned FormData → `#server` File/Blob; progress/cancel)
+- Density / RTL / preset materialize
+- Motion continuity + interrupt/cancel
+- Motion compiler IR thin gate (`pnpm verify -- motion-ir`)
+- UI7 conformance pack (`@vmz/ui/conformance` + `pnpm verify -- ui7`)
+- `@vmz/ui-data-grid` thin gate (virtualization + pinned column — not tree/group/pivot/edit)
+
+Verify:
+
+```bash
+pnpm verify -- ui-automation
+pnpm verify -- ui7
+pnpm verify -- ui-data-grid
+pnpm verify -- official-homepage
+```
+
+Still open relative to Browser Production Profile v1: `browser-production` aggregate core gaps,
+`@vmz/ui-data-grid` deep capabilities, Upload cross-page session / multi-file parallel chunks,
+`@vmz/test` Browser Host U0–U1, sibling `vmz-panel` product app.
+
+## Commercial default surface
+
+Default web surface targets modern commercial console density: flat 32px-class controls,
+quiet borders, restrained radii, layered page/paper surfaces without Bootstrap-era inset
+fields, accent bars, or card lift. Applications replace every semantic value through `/designs`.
+Additional general-purpose components include layout primitives, typography, segmented controls,
+tags, avatars, dropdowns, collapse panels and progress indicators.

package/package.json

@@ -82,7 +82,7 @@
   "license": "MIT",
   "name": "@vmz/ui",
   "peerDependencies": {
-    "@vmz/ui-icons": "0.3.4"
+    "@vmz/ui-icons": "0.3.6"
   },
   "peerDependenciesMeta": {
     "@vmz/ui-icons": {
@@ -98,5 +98,5 @@
     "url": "git+https://github.com/doki-land/vmz-framework.git"
   },
   "type": "module",
-  "version": "0.3.4"
+  "version": "0.3.6"
 }

package/presets/web-surface.v0.json

@@ -4,7 +4,13 @@
     "package": "@vmz/ui",
     "materialize": "Copy or resolve into application /designs Style Theme (tokens/*.json + themes/*.json). Preset is not a second runtime theme.",
     "foundation": {
-        "radius": { "sm": "2px", "md": "6px", "lg": "8px" },
+        "radius": {
+            "xs": "2px",
+            "sm": "4px",
+            "md": "6px",
+            "lg": "8px",
+            "pill": "999px"
+        },
         "controlHeight": { "sm": "1.5rem", "middle": "2rem", "lg": "2.5rem" },
         "layoutMaxWidth": "75rem",
         "surfacePage": "#F5F5F5",
@@ -14,22 +20,28 @@
         "lineSubtle": "#F0F0F0",
         "shadowCard": "none",
         "shadowCardHover": "0 1px 2px -2px rgba(0,0,0,.08), 0 3px 6px 0 rgba(0,0,0,.06), 0 5px 12px 4px rgba(0,0,0,.04)",
-        "shadowPopup": "0 6px 16px 0 rgba(0,0,0,.08), 0 3px 6px -4px rgba(0,0,0,.12), 0 9px 28px 8px rgba(0,0,0,.05)"
+        "shadowPopup": "0 6px 16px 0 rgba(0,0,0,.08), 0 3px 6px -4px rgba(0,0,0,.12), 0 9px 28px 8px rgba(0,0,0,.05)",
+        "elevation": {
+            "note": "Floating layers only. Cards stay flat per visualIntent; interactive surfaces lift on hover, never at rest.",
+            "float-sm": "0 1px 2px 0 rgba(0,0,0,.03), 0 1px 6px -1px rgba(0,0,0,.02), 0 2px 4px 0 rgba(0,0,0,.02)",
+            "float-md": "0 6px 16px 0 rgba(0,0,0,.08), 0 3px 6px -4px rgba(0,0,0,.12), 0 9px 28px 8px rgba(0,0,0,.05)",
+            "float-lg": "0 6px 16px 0 rgba(0,0,0,.08), 0 3px 6px -4px rgba(0,0,0,.12), 0 9px 28px 8px rgba(0,0,0,.05), 0 12px 48px 16px rgba(0,0,0,.03)"
+        }
     },
     "density": {
         "control": {
             "padding-y": "0.25rem",
-            "padding-x": "0.75rem",
+            "padding-x": "0.9375rem",
             "gap": "0.5rem"
         },
         "compact": {
             "padding-y": "0.125rem",
-            "padding-x": "0.5rem",
-            "gap": "0.35rem"
+            "padding-x": "0.625rem",
+            "gap": "0.375rem"
         },
         "dense": {
             "padding-y": "0",
-            "padding-x": "0.35rem",
+            "padding-x": "0.4375rem",
             "gap": "0.25rem"
         }
     },
@@ -44,5 +56,5 @@
         "dark": "themes/dark.json overlay",
         "high-contrast": "themes/high-contrast.json overlay — stronger ink/line/focus"
     },
-    "visualIntent": "Modern commercial product chrome: neutral structure borders (never brand outline on every box), flat cards, soft focus rings, quiet page fill. Brand color is for actions/selection — not scaffolding."
+    "visualIntent": "Modern commercial product chrome: neutral structure borders (never brand outline on every box), flat cards, soft focus rings, quiet page fill. Brand color is for actions/selection — not scaffolding. Elevation is reserved for floating layers and hover lift; nothing casts a resting shadow. Motion eases, never jumps: control transitions use a decelerate curve, overlays use a fast-in curve, and reduced-motion is honored."
 }

package/src/components/Accordion.vmz

@@ -1,94 +1,94 @@
-<template>
-    <div data-vmz-ui="accordion" :aria-label="label" class="vmz-ui-accordion">
-        <div v-for="item in items" :key="item.id" :data-vmz-accordion="item.id" class="vmz-ui-accordion__item">
-            <h3 class="vmz-ui-accordion__heading">
-                <button type="button" :id="item.triggerId" :data-vmz-accordion-trigger="item.id" :aria-expanded="openId === item.id ? 'true' : 'false'" :aria-controls="item.panelId" @click="(() => toggle(item.id))" class="vmz-ui-accordion__trigger">
-                    {{ item.title }}
-                </button>
-            </h3>
-            <div v-if="openId === item.id" :id="item.panelId" role="region" :data-vmz-accordion-panel="item.id" :aria-labelledby="item.triggerId" class="vmz-ui-accordion__panel">
-                {{ item.body }}
-            </div>
-        </div>
-    </div>
-</template>
-<style>
-.vmz-ui-accordion {
-    display: flex;
-    flex-direction: column;
-    gap: 0.35rem;
-    max-width: 36rem;
-    border: 1px solid var(--vmz-line-default);
-    border-radius: var(--vmz-radius-md, 6px);
-    background: var(--vmz-surface-paper);
-    color: var(--vmz-text-ink);
-}
-
-.vmz-ui-accordion__item {
-    border-bottom: 1px solid var(--vmz-line-default);
-}
-
-.vmz-ui-accordion__item:last-child {
-    border-bottom: none;
-}
-
-.vmz-ui-accordion__heading {
-    margin: 0;
-    font: inherit;
-}
-
-.vmz-ui-accordion__trigger {
-    display: block;
-    width: 100%;
-    text-align: start;
-    font: inherit;
-    font-weight: 600;
-    padding: var(--vmz-density-control-padding-y) var(--vmz-density-control-padding-x);
-    border: 0;
-    background: transparent;
-    color: inherit;
-    cursor: pointer;
-    outline: none;
-}
-
-.vmz-ui-accordion__trigger:hover {
-    background: color-mix(in srgb, var(--vmz-surface-mist) 85%, transparent);
-}
-
-.vmz-ui-accordion__trigger:focus-visible {
-    box-shadow: inset 0 0 0 2px var(--vmz-focus-ring);
-}
-
-.vmz-ui-accordion__trigger[aria-expanded="true"] {
-    color: var(--vmz-action-primary-active);
-}
-
-.vmz-ui-accordion__panel {
-    padding: 0 var(--vmz-density-control-padding-x) var(--vmz-density-control-padding-y);
-    color: var(--vmz-text-steel);
-    line-height: 1.5;
-}
-</style>
-<script client>
-/**
- * VMZ UI — Accordion.
- * Exclusive open: parent owns `openId`. Toggle same id closes.
- * Panel body lives on items (no per-panel slot runtime).
- */
-export default class Accordion {
-    public label: string = "Accordion";
-    public openId: string = "";
-    /** @type {{ id: string, title: string, body: string, triggerId: string, panelId: string }[]} */
-    public items: {
-        id: string;
-        title: string;
-        body: string;
-        triggerId: string;
-        panelId: string;
-    }[] = [];
-    public onToggle: ((id: string) => void) | null = null;
-    toggle(id) {
-        if (typeof this.onToggle === "function") this.onToggle(id);
-    }
-}
-</script>
+<template>
+    <div data-vmz-ui="accordion" :aria-label="label" class="vmz-ui-accordion">
+        <div v-for="item in items" :key="item.id" :data-vmz-accordion="item.id" class="vmz-ui-accordion__item">
+            <h3 class="vmz-ui-accordion__heading">
+                <button type="button" :id="item.triggerId" :data-vmz-accordion-trigger="item.id" :aria-expanded="openId === item.id ? 'true' : 'false'" :aria-controls="item.panelId" @click="(() => toggle(item.id))" class="vmz-ui-accordion__trigger">
+                    {{ item.title }}
+                </button>
+            </h3>
+            <div v-if="openId === item.id" :id="item.panelId" role="region" :data-vmz-accordion-panel="item.id" :aria-labelledby="item.triggerId" class="vmz-ui-accordion__panel">
+                {{ item.body }}
+            </div>
+        </div>
+    </div>
+</template>
+<style>
+.vmz-ui-accordion {
+    display: flex;
+    flex-direction: column;
+    gap: 0.375rem;
+    max-width: 36rem;
+    border: 1px solid var(--vmz-line-default);
+    border-radius: var(--vmz-radius-md, 6px);
+    background: var(--vmz-surface-paper);
+    color: var(--vmz-text-ink);
+}
+
+.vmz-ui-accordion__item {
+    border-bottom: 1px solid var(--vmz-line-default);
+}
+
+.vmz-ui-accordion__item:last-child {
+    border-bottom: none;
+}
+
+.vmz-ui-accordion__heading {
+    margin: 0;
+    font: inherit;
+}
+
+.vmz-ui-accordion__trigger {
+    display: block;
+    width: 100%;
+    text-align: start;
+    font: inherit;
+    font-weight: 600;
+    padding: var(--vmz-density-control-padding-y) var(--vmz-density-control-padding-x);
+    border: 0;
+    background: transparent;
+    color: inherit;
+    cursor: pointer;
+    outline: none;
+}
+
+.vmz-ui-accordion__trigger:hover {
+    background: color-mix(in srgb, var(--vmz-surface-mist) 85%, transparent);
+}
+
+.vmz-ui-accordion__trigger:focus-visible {
+    box-shadow: inset 0 0 0 3px var(--vmz-focus-ring);
+}
+
+.vmz-ui-accordion__trigger[aria-expanded="true"] {
+    color: var(--vmz-action-primary-active);
+}
+
+.vmz-ui-accordion__panel {
+    padding: 0 var(--vmz-density-control-padding-x) var(--vmz-density-control-padding-y);
+    color: var(--vmz-text-steel);
+    line-height: 1.5;
+}
+</style>
+<script client>
+/**
+ * VMZ UI — Accordion.
+ * Exclusive open: parent owns `openId`. Toggle same id closes.
+ * Panel body lives on items (no per-panel slot runtime).
+ */
+export default class Accordion {
+    public label: string = "Accordion";
+    public openId: string = "";
+    /** @type {{ id: string, title: string, body: string, triggerId: string, panelId: string }[]} */
+    public items: {
+        id: string;
+        title: string;
+        body: string;
+        triggerId: string;
+        panelId: string;
+    }[] = [];
+    public onToggle: ((id: string) => void) | null = null;
+    toggle(id) {
+        if (typeof this.onToggle === "function") this.onToggle(id);
+    }
+}
+</script>

package/src/components/AppShell.vmz

@@ -6,10 +6,11 @@
                     {{ brand }}
                 </a>
                 <nav :aria-label="navLabel" class="vmz-ui-app-shell__nav">
-                    <a v-for="item in nav" :key="item.id" :href="item.href" :data-vmz-nav="item.id">
-                        {{ item.title }}
-                    </a>
+                    <a v-for="item in nav" :key="item.id" :href="item.href" :data-vmz-nav="item.id" :data-active="item.id === activeId ? 'true' : 'false'" :aria-current="item.id === activeId ? 'page' : null" class="vmz-ui-app-shell__nav-item">{{ item.title }}</a>
                 </nav>
+                <div class="vmz-ui-app-shell__actions">
+                    <slot name="actions" />
+                </div>
             </div>
         </header>
         <main data-vmz-shell="main" class="vmz-ui-app-shell__main">
@@ -31,83 +32,124 @@
     top: 0;
     z-index: 30;
     border-bottom: 1px solid var(--vmz-line-subtle, var(--vmz-line-default));
-    background: var(--vmz-surface-paper);
+    background: color-mix(in srgb, var(--vmz-surface-paper) 88%, transparent);
+    backdrop-filter: saturate(180%) blur(0.5rem);
+    -webkit-backdrop-filter: saturate(180%) blur(0.5rem);
 }
+
 .vmz-ui-app-shell__header-inner {
     width: min(var(--vmz-layout-max-width, 75rem), calc(100% - 2rem));
-    min-height: 3rem;
+    min-height: 3.5rem;
     margin: 0 auto;
     display: flex;
     align-items: center;
-    justify-content: space-between;
     gap: 1.5rem;
 }
 
 .vmz-ui-app-shell__brand {
+    flex: none;
+    color: var(--vmz-text-ink);
     font-family: var(--vmz-font-sans);
-    font-weight: 600;
-    font-size: 1.125rem;
-    letter-spacing: 0;
+    font-size: 1.0625rem;
+    font-weight: 650;
+    letter-spacing: -0.01em;
     text-decoration: none;
-    color: var(--vmz-text-ink);
+    border-radius: var(--vmz-radius-sm, 4px);
+    outline: none;
+    transition: color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+}
+
+.vmz-ui-app-shell__brand:hover {
+    color: var(--vmz-action-primary-background);
 }
 
 .vmz-ui-app-shell__brand:focus-visible {
-    outline: none;
-    box-shadow: 0 0 0 2px var(--vmz-focus-ring);
+    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
 }
 
 .vmz-ui-app-shell__nav {
     display: flex;
+    flex: 1 1 auto;
     flex-wrap: wrap;
-    gap: 0.25rem 0.15rem;
+    gap: 0.125rem;
+    min-width: 0;
 }
 
-.vmz-ui-app-shell__nav a {
+.vmz-ui-app-shell__nav-item {
+    position: relative;
+    padding: 0.375rem 0.75rem;
+    border-radius: var(--vmz-radius-sm, 4px);
+    color: var(--vmz-text-steel);
     font: inherit;
     font-size: 0.875rem;
-    font-weight: 400;
+    font-weight: 500;
+    line-height: 1.4286;
     text-decoration: none;
-    color: var(--vmz-text-ink);
-    padding: 0.25rem 0.75rem;
-    border-radius: var(--vmz-radius-md, 6px);
+    white-space: nowrap;
+    outline: none;
+    transition:
+        color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1)),
+        background-color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
 }
 
-.vmz-ui-app-shell__nav a:hover {
-    color: var(--vmz-action-primary-background);
+.vmz-ui-app-shell__nav-item:hover {
+    color: var(--vmz-text-ink);
     background: var(--vmz-surface-mist, #fafafa);
 }
 
-.vmz-ui-app-shell__nav a:focus-visible {
-    outline: none;
-    box-shadow: 0 0 0 2px var(--vmz-focus-ring);
+.vmz-ui-app-shell__nav-item:focus-visible {
+    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
+}
+
+/* Current section: ink emphasis plus a hairline marker, no brand fill. */
+.vmz-ui-app-shell__nav-item[data-active="true"] {
+    color: var(--vmz-text-ink);
+    font-weight: 600;
+}
+
+.vmz-ui-app-shell__nav-item[data-active="true"]::after {
+    content: "";
+    position: absolute;
+    inset: auto 0.75rem 0;
+    height: 2px;
+    border-radius: var(--vmz-radius-pill, 999px);
+    background: var(--vmz-action-primary-background);
+}
+
+.vmz-ui-app-shell__actions {
+    flex: none;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin-left: auto;
 }
 
 .vmz-ui-app-shell__main {
     flex: 1;
     width: min(var(--vmz-layout-max-width, 75rem), calc(100% - 2rem));
     margin: 0 auto;
-    padding: 1.5rem 0 2.5rem;
+    padding: 1.75rem 0 3rem;
     display: flex;
     flex-direction: column;
     gap: 1rem;
 }
+
 @media (max-width: 720px) {
     .vmz-ui-app-shell__header-inner {
-        min-height: 3.5rem;
-        align-items: flex-start;
-        flex-direction: column;
-        gap: 0.35rem;
-        padding: 0.7rem 0;
+        flex-wrap: wrap;
+        gap: 0.5rem 0.75rem;
+        padding: 0.625rem 0;
     }
     .vmz-ui-app-shell__nav {
-        width: 100%;
+        order: 3;
+        flex-basis: 100%;
         overflow-x: auto;
         flex-wrap: nowrap;
-        padding-bottom: 0.2rem;
+        padding-bottom: 0.125rem;
+        scrollbar-width: none;
     }
-    .vmz-ui-app-shell__nav a {
-        white-space: nowrap;
+    .vmz-ui-app-shell__nav::-webkit-scrollbar {
+        display: none;
     }
     .vmz-ui-app-shell__main {
         padding-top: 1.25rem;
@@ -123,6 +165,8 @@ export default class AppShell {
     public brand: string = "VMZ";
     public homeHref: string = "/";
     public navLabel: string = "Primary";
+    /** Id of the nav item representing the current page, for `aria-current` + marker. */
+    public activeId: string = "";
     /** @type {{ id: string, title: string, href: string }[]} */
     public nav: {
         id: string;