@vmz/ui 0.3.6 → 0.3.8

package/src/components/Header.vmz

@@ -1,18 +1,205 @@
 <template>
-    <header data-vmz-ui="header" class="vmz-ui-header">
+    <header data-vmz-ui="header" :data-structured="hasNav() ? 'true' : 'false'" :onKeyDown="onMenuKeyDown" class="vmz-ui-header">
+        <div v-if="hasNav()" class="vmz-ui-header__inner">
+            <a v-if="brand" :href="homeHref" class="vmz-ui-header__brand">
+                {{ brand }}
+            </a>
+            <nav :id="navId" :aria-label="navLabel" :data-open="menuOpen ? 'true' : null" class="vmz-ui-header__nav">
+                <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" @click="closeMenu" class="vmz-ui-header__nav-item">
+                    {{ item.title }}
+                </a>
+            </nav>
+            <div class="vmz-ui-header__actions">
+                <slot name="actions" />
+            </div>
+            <button type="button" :aria-label="menuLabel ? menuLabel : navLabel" :aria-expanded="menuOpen ? 'true' : 'false'" :aria-controls="navId" @click="toggleMenu" class="vmz-ui-header__menu">
+                <Icon :name="menuOpen ? 'action.close' : 'action.menu'" size="md" decorative />
+            </button>
+        </div>
         <slot />
     </header>
 </template>
 <style>
 .vmz-ui-header {
-    min-height: 4rem;
+    position: sticky;
+    top: 0;
+    z-index: 30;
+    background: var(--vmz-surface-paper);
+    border-bottom: 1px solid var(--vmz-line-subtle);
+}
+.vmz-ui-header[data-structured="false"] {
+    display: flex;
+    align-items: center;
+    gap: var(--vmz-space-6, 2rem);
+    min-height: var(--vmz-layout-header-height, 4rem);
+    padding: 0 var(--vmz-layout-gutter, 1rem);
+}
+.vmz-ui-header__inner {
+    width: min(var(--vmz-layout-max-width, 75rem), calc(100% - (var(--vmz-layout-gutter, 1rem) * 2)));
+    height: var(--vmz-layout-header-height, 4rem);
+    margin: 0 auto;
     display: flex;
     align-items: center;
-    padding: 0 1.5rem;
-    border-bottom: 1px solid var(--vmz-line-default, #d9d9d9);
-    background: var(--vmz-surface-paper, #fff);
+    gap: var(--vmz-space-6, 2rem);
+}
+.vmz-ui-header__brand {
+    flex: none;
+    color: var(--vmz-text-ink);
+    font-family: var(--vmz-font-sans);
+    font-size: 1.0625rem;
+    font-weight: 600;
+    line-height: 1.25;
+    letter-spacing: -0.01em;
+    text-decoration: none;
+    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-header__brand:hover {
+    color: var(--vmz-action-primary-background);
+}
+.vmz-ui-header__brand:focus-visible {
+    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
+}
+.vmz-ui-header__nav {
+    flex: 0 1 auto;
+    min-width: 0;
+    height: 100%;
+    display: flex;
+    align-items: center;
+    gap: var(--vmz-space-5, 1.5rem);
+}
+.vmz-ui-header__nav-item {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    height: 100%;
+    box-sizing: border-box;
+    border-bottom: 2px solid transparent;
+    color: var(--vmz-text-steel);
+    font-size: 0.875rem;
+    font-weight: 500;
+    line-height: 1;
+    text-decoration: none;
+    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)),
+        border-color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+}
+.vmz-ui-header__nav-item:hover {
+    color: var(--vmz-action-primary-background);
+}
+.vmz-ui-header__nav-item[data-active="true"] {
+    color: var(--vmz-action-primary-background);
+    border-bottom-color: var(--vmz-action-primary-background);
+}
+.vmz-ui-header__nav-item:focus-visible {
+    border-radius: var(--vmz-radius-sm, 4px);
+    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
+}
+.vmz-ui-header__actions {
+    flex: none;
+    display: flex;
+    align-items: center;
+    gap: var(--vmz-space-2, 0.5rem);
+    margin-left: auto;
+}
+.vmz-ui-header__menu {
+    display: none;
+}
+@media (max-width: 720px) {
+    .vmz-ui-header[data-structured="false"] {
+        min-height: var(--vmz-layout-header-height-compact, 3.5rem);
+        gap: var(--vmz-space-3, 0.75rem);
+    }
+    .vmz-ui-header__inner {
+        height: var(--vmz-layout-header-height-compact, 3.5rem);
+        gap: var(--vmz-space-3, 0.75rem);
+    }
+    .vmz-ui-header__nav {
+        display: none;
+        position: absolute;
+        top: 100%;
+        left: 0;
+        right: 0;
+        height: auto;
+        flex-direction: column;
+        align-items: stretch;
+        gap: 0;
+        padding: var(--vmz-space-2, 0.5rem) var(--vmz-layout-gutter, 1rem) var(--vmz-space-4, 1rem);
+        border-bottom: 1px solid var(--vmz-line-subtle);
+        background: var(--vmz-surface-paper);
+        box-shadow: var(--vmz-shadow-popup);
+    }
+    .vmz-ui-header__nav[data-open="true"] {
+        display: flex;
+    }
+    .vmz-ui-header__nav-item {
+        height: 2.5rem;
+        padding: 0 var(--vmz-space-1, 0.25rem);
+        border-bottom: 0;
+    }
+    .vmz-ui-header__menu {
+        flex: none;
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        width: 2.5rem;
+        height: 2.5rem;
+        padding: 0;
+        border: 0;
+        border-radius: var(--vmz-radius-md, 6px);
+        background: transparent;
+        color: var(--vmz-text-ink);
+        cursor: pointer;
+        outline: none;
+        transition: background-color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+    }
+    .vmz-ui-header__menu:hover {
+        background: var(--vmz-surface-mist);
+    }
+    .vmz-ui-header__menu:focus-visible {
+        box-shadow: 0 0 0 3px var(--vmz-focus-ring);
+    }
 }
 </style>
 <script client>
-export default class Header {}
+/**
+ * VMZ UI — Header (Commercial chrome).
+ * Flat nav links plus a named `actions` slot. With no `nav` items the default
+ * slot renders as a plain padded bar. Copy stays with the parent.
+ */
+export default class Header {
+    public brand: string = "";
+    public homeHref: string = "/";
+    public navLabel: string = "";
+    public menuLabel: string = "";
+    /** Id of the nav item representing the current page. */
+    public activeId: string = "";
+    public navId: string = "vmz-ui-header-nav";
+    /** Parent-supplied labels; the component never hardcodes copy. */
+    public nav: {
+        id: string;
+        title: string;
+        href: string;
+    }[] = [];
+    menuOpen = false;
+
+    hasNav() {
+        return Array.isArray(this.nav) && this.nav.length > 0;
+    }
+
+    toggleMenu() {
+        this.menuOpen = !this.menuOpen;
+    }
+
+    closeMenu() {
+        if (this.menuOpen) this.menuOpen = false;
+    }
+
+    onMenuKeyDown(e) {
+        if (e && e.key === "Escape") this.closeMenu();
+    }
+}
 </script>

package/src/components/Layout.vmz

@@ -8,7 +8,9 @@
     display: flex;
     flex-direction: column;
     min-height: 100%;
-    background: var(--vmz-surface-page, var(--vmz-surface-mist, #f5f5f5));
+    color: var(--vmz-text-ink);
+    background: var(--vmz-surface-page);
+    font-family: var(--vmz-font-sans);
 }
 </style>
 <script client>

package/src/components/Link.vmz

@@ -6,22 +6,21 @@
 <style>
 .vmz-ui-link {
     font: inherit;
-    font-weight: 600;
-    color: var(--vmz-action-primary-background);
+    font-weight: 500;
+    color: var(--vmz-action-link-foreground);
     text-decoration: underline;
     text-underline-offset: 0.2em;
     text-decoration-thickness: 1px;
-    text-decoration-color: color-mix(in srgb, currentColor 35%, transparent);
+    text-decoration-color: currentColor;
     outline: none;
-    border-radius: var(--vmz-radius-sm, 4px);
+    border-radius: var(--vmz-radius-sm);
     transition:
-        color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1)),
-        text-decoration-color var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+        color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing),
+        text-decoration-color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing);
 }
 
 .vmz-ui-link:hover {
-    color: var(--vmz-action-primary-hover);
-    text-decoration-color: currentColor;
+    color: var(--vmz-action-link-hover);
 }
 
 .vmz-ui-link:active {
@@ -39,21 +38,33 @@
 }
 
 .vmz-ui-link[data-variant="muted"]:hover {
-    color: var(--vmz-action-primary-background);
+    color: var(--vmz-action-link-hover);
     text-decoration-color: currentColor;
 }
 
 /* Navigation link: chrome, not prose — underline is the hover affordance. */
 .vmz-ui-link[data-variant="nav"] {
     font-weight: 500;
+    color: var(--vmz-text-ink);
     text-decoration: none;
     text-decoration-color: transparent;
 }
 
 .vmz-ui-link[data-variant="nav"]:hover {
+    color: var(--vmz-action-link-hover);
     text-decoration: underline;
     text-decoration-color: currentColor;
 }
+
+.vmz-ui-link[data-variant="nav"]:active {
+    color: var(--vmz-action-primary-active);
+}
+
+@media (prefers-reduced-motion: reduce) {
+    .vmz-ui-link {
+        transition: none;
+    }
+}
 </style>
 <script client>
 /**
@@ -65,7 +76,11 @@ export default class Link {
     public href: string = "#";
     public target: string = "";
     public rel: string = "";
-    /** `default` inline prose link · `muted` quiet inline link · `nav` chrome link. */
+    /**
+     * `default` inline prose link · `muted` quiet inline link · `nav` chrome link.
+     * Appearance/semantic hint only: navigation, `href`, `target` and `rel` are
+     * unaffected, and unknown values render as `default` without error.
+     */
     public variant: string = "default";
 }
 </script>

package/src/components/List.vmz

@@ -1,102 +1,124 @@
-<template>
-    <div data-vmz-ui="list" class="vmz-ui-list">
-        <p v-if="label" :id="labelId" class="vmz-ui-list__label">
-            {{ label }}
-        </p>
-        <ul role="listbox" :aria-labelledby="labelId" :aria-label="label" @click="onListClick" :onKeyDown="onListKeyDown" class="vmz-ui-list__items">
-            <li v-for="item in items" :key="item.id" role="option" :id="item.id" :data-vmz-list-item="item.id" :aria-selected="selected === item.id ? 'true' : 'false'" :tabindex="selected === item.id ? 0 : -1" class="vmz-ui-list__item">
-                {{ item.title }}
-            </li>
-        </ul>
-    </div>
-</template>
-<style>
-.vmz-ui-list {
-    display: flex;
-    flex-direction: column;
-    gap: 0.375rem;
-    max-width: 28rem;
-}
-
-.vmz-ui-list__label {
-    margin: 0;
-    font-weight: 600;
-    color: var(--vmz-text-ink);
-}
-
-.vmz-ui-list__items {
-    margin: 0;
-    padding: 0.25rem;
-    list-style: none;
-    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-list__item {
-    padding: var(--vmz-density-control-padding-y) var(--vmz-density-control-padding-x);
-    border-radius: var(--vmz-radius-md, 6px);
-    cursor: pointer;
-    outline: none;
-}
-
-.vmz-ui-list__item[aria-selected="true"] {
-    background: var(--vmz-action-primary-background);
-    color: var(--vmz-action-primary-foreground);
-}
-
-.vmz-ui-list__item:hover {
-    background: color-mix(in srgb, var(--vmz-action-primary-background) 14%, transparent);
-}
-
-.vmz-ui-list__item[aria-selected="true"]:hover {
-    background: var(--vmz-action-primary-hover);
-}
-
-.vmz-ui-list__item:focus-visible {
-    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
-}
-</style>
-<script client>
-/**
- * VMZ UI — List (ordinary selectable list).
- * Parent owns `selected` id; click + Arrow/Home/End. Not a DataGrid.
- */
-export default class List {
-    public label: string = "List";
-    public labelId: string = "vmz-list-label";
-    public selected: string = "";
-    /** @type {{ id: string, title: string }[]} */
-    public items: {
-        id: string;
-        title: string;
-    }[] = [];
-    public onSelect: ((id: string) => void) | null = null;
-    select(id) {
-        if (typeof this.onSelect === "function") this.onSelect(id);
-    }
-    onListClick(ev) {
-        const t = ev && ev.target;
-        const el = t && typeof t.closest === "function" ? t.closest("[data-vmz-list-item]") : null;
-        const id =
-            el && typeof el.getAttribute === "function"
-                ? el.getAttribute("data-vmz-list-item")
-                : null;
-        if (id) this.select(id);
-    }
-    onListKeyDown(ev) {
-        if (!ev || !this.items?.length) return;
-        const ids = this.items.map((it) => it.id);
-        const idx = Math.max(0, ids.indexOf(this.selected));
-        let next = idx;
-        if (ev.key === "ArrowDown") next = (idx + 1) % ids.length;
-        else if (ev.key === "ArrowUp") next = (idx - 1 + ids.length) % ids.length;
-        else if (ev.key === "Home") next = 0;
-        else if (ev.key === "End") next = ids.length - 1;
-        else return;
-        ev.preventDefault();
-        this.select(ids[next]);
-    }
-}
-</script>
+<template>
+    <div data-vmz-ui="list" class="vmz-ui-list">
+        <p v-if="label" :id="labelId" class="vmz-ui-list__label">
+            {{ label }}
+        </p>
+        <ul role="listbox" :aria-labelledby="labelId" :aria-label="label" @click="onListClick" :onKeyDown="onListKeyDown" class="vmz-ui-list__items">
+            <li v-for="item in items" :key="item.id" role="option" :id="item.id" :data-vmz-list-item="item.id" :aria-selected="selected === item.id ? 'true' : 'false'" :tabindex="selected === item.id ? 0 : -1" class="vmz-ui-list__item">
+                {{ item.title }}
+            </li>
+        </ul>
+    </div>
+</template>
+<style>
+.vmz-ui-list {
+    display: flex;
+    flex-direction: column;
+    gap: var(--vmz-space-2, 0.5rem);
+    max-width: 28rem;
+}
+
+.vmz-ui-list__label {
+    margin: 0;
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: var(--vmz-text-ink);
+}
+
+.vmz-ui-list__items {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    overflow: hidden;
+    border: 1px solid var(--vmz-line-default, var(--vmz-line-strong));
+    border-radius: var(--vmz-radius-lg, 8px);
+    background: var(--vmz-surface-paper);
+    color: var(--vmz-text-ink);
+}
+
+.vmz-ui-list__item {
+    display: flex;
+    align-items: center;
+    min-height: var(--vmz-control-height, 2rem);
+    padding: var(--vmz-space-2, 0.5rem) var(--vmz-space-4, 1rem);
+    font-size: 0.875rem;
+    line-height: 1.5;
+    cursor: pointer;
+    outline: none;
+    transition:
+        background-color var(--vmz-motion-control-duration, 120ms) var(--vmz-motion-control-easing, cubic-bezier(0.2, 0, 0, 1)),
+        color var(--vmz-motion-control-duration, 120ms) var(--vmz-motion-control-easing, cubic-bezier(0.2, 0, 0, 1));
+}
+
+.vmz-ui-list__item + .vmz-ui-list__item {
+    border-top: 1px solid var(--vmz-line-subtle, var(--vmz-line-default));
+}
+
+.vmz-ui-list__item:hover {
+    background: var(--vmz-surface-mist);
+}
+
+.vmz-ui-list__item[aria-selected="true"] {
+    background: var(--vmz-action-primary-soft, var(--vmz-surface-mist));
+    color: var(--vmz-action-primary-active);
+    font-weight: 500;
+}
+
+.vmz-ui-list__item[aria-selected="true"]:hover {
+    background: var(--vmz-action-primary-soft, var(--vmz-surface-mist));
+}
+
+.vmz-ui-list__item:focus-visible {
+    box-shadow: inset 0 0 0 2px var(--vmz-focus-ring);
+}
+
+:where([data-density="compact"]) .vmz-ui-list__item {
+    padding: var(--vmz-density-compact-padding-y) var(--vmz-density-compact-padding-x);
+}
+
+:where([data-density="dense"]) .vmz-ui-list__item {
+    padding: var(--vmz-density-dense-padding-y) var(--vmz-density-dense-padding-x);
+}
+</style>
+<script client>
+/**
+ * VMZ UI — List (ordinary selectable list).
+ * Parent owns `selected` id; click + Arrow/Home/End. Not a DataGrid.
+ */
+export default class List {
+    public label: string = "";
+    public labelId: string = "vmz-list-label";
+    public selected: string = "";
+    /** @type {{ id: string, title: string }[]} */
+    public items: {
+        id: string;
+        title: string;
+    }[] = [];
+    public onSelect: ((id: string) => void) | null = null;
+    select(id) {
+        if (typeof this.onSelect === "function") this.onSelect(id);
+    }
+    onListClick(ev) {
+        const t = ev && ev.target;
+        const el = t && typeof t.closest === "function" ? t.closest("[data-vmz-list-item]") : null;
+        const id =
+            el && typeof el.getAttribute === "function"
+                ? el.getAttribute("data-vmz-list-item")
+                : null;
+        if (id) this.select(id);
+    }
+    onListKeyDown(ev) {
+        if (!ev || !this.items?.length) return;
+        const ids = this.items.map((it) => it.id);
+        const idx = Math.max(0, ids.indexOf(this.selected));
+        let next = idx;
+        if (ev.key === "ArrowDown") next = (idx + 1) % ids.length;
+        else if (ev.key === "ArrowUp") next = (idx - 1 + ids.length) % ids.length;
+        else if (ev.key === "Home") next = 0;
+        else if (ev.key === "End") next = ids.length - 1;
+        else return;
+        ev.preventDefault();
+        this.select(ids[next]);
+    }
+}
+</script>