@vmz/ui 0.3.6 → 0.3.7

package/src/components/Dropdown.vmz

@@ -5,8 +5,13 @@
         </summary>
         <div data-vmz-dropdown-menu="1" role="menu" class="vmz-ui-dropdown__menu">
             <div v-for="item in items" :key="item.id" class="vmz-ui-dropdown__row">
-                <div v-if="item.divider" role="separator" class="vmz-ui-dropdown__divider"></div>
-                <a v-else :href="item.href" role="menuitem" :data-vmz-dropdown-item="item.id" :data-danger="item.danger ? 'true' : 'false'" :data-disabled="item.disabled ? 'true' : 'false'" :aria-disabled="item.disabled ? 'true' : null" :tabindex="item.disabled ? -1 : null" class="vmz-ui-dropdown__item">{{ item.title }}</a>
+                <div v-if="item.divider" role="separator" class="vmz-ui-dropdown__divider" />
+                <a v-else-if="hasHref(item)" :href="item.href" role="menuitem" :data-vmz-dropdown-item="item.id" :data-danger="item.danger ? 'true' : 'false'" :data-disabled="item.disabled ? 'true' : 'false'" :aria-disabled="item.disabled ? 'true' : null" :tabindex="item.disabled ? -1 : null" class="vmz-ui-dropdown__item">
+                    {{ item.title }}
+                </a>
+                <button v-else type="button" role="menuitem" :data-vmz-dropdown-item="item.id" :data-danger="item.danger ? 'true' : 'false'" :data-disabled="item.disabled ? 'true' : 'false'" :aria-disabled="item.disabled ? 'true' : null" :tabindex="item.disabled ? -1 : null" @click="onItemClick" class="vmz-ui-dropdown__item">
+                    {{ item.title }}
+                </button>
             </div>
         </div>
     </details>
@@ -114,11 +119,17 @@
 
 .vmz-ui-dropdown__item {
     display: block;
+    width: 100%;
     padding: 0.5rem 0.75rem;
+    border: 0;
     border-radius: var(--vmz-radius-sm, 4px);
+    background: transparent;
     color: var(--vmz-text-ink);
+    cursor: pointer;
+    font: inherit;
     font-size: 0.875rem;
     line-height: 1.4286;
+    text-align: left;
     text-decoration: none;
     outline: none;
     transition:
@@ -158,16 +169,18 @@
 <script client>
 /**
  * VMZ UI — Dropdown (Menu).
- * Native `<details>` disclosure: works without JS, menu items are plain links
- * unless a host attaches selection handlers.
+ * Native `<details>` disclosure: works without JS. An item with a non-empty
+ * `href` is a plain link; an item without `href` is an action button that
+ * notifies via `onSelect(id)`. Selection handlers never navigate.
  */
 export type DropdownItem = {
     id: string;
     title: string;
+    /** Non-empty → link item (native navigation). Empty/absent → action item. */
     href?: string;
     /** Destructive action styling. */
     danger?: boolean;
-    /** Non-interactive state. */
+    /** Non-interactive state: neither navigates nor selects. */
     disabled?: boolean;
     /** Render a separator instead of a row (title/href are ignored). */
     divider?: boolean;
@@ -176,5 +189,38 @@ export type DropdownItem = {
 export default class Dropdown {
     public label: string = "Menu";
     public items: DropdownItem[] = [];
+    /** Action-item selection callback (`:on-select`). Link items bypass it. */
+    public onSelect: ((id: string) => void) | null = null;
+
+    hasHref(item) {
+        return typeof item?.href === "string" && item.href.length > 0;
+    }
+
+    onItemClick(ev) {
+        const el = ev && ev.currentTarget;
+        const id =
+            el && typeof el.getAttribute === "function"
+                ? el.getAttribute("data-vmz-dropdown-item")
+                : null;
+        if (!id) return;
+        const item = this.items.find((candidate) => candidate.id === id);
+        if (!item || item.disabled || this.hasHref(item)) return;
+        this.close();
+        if (typeof this.onSelect === "function") this.onSelect(id);
+    }
+
+    close() {
+        const root = this.__vmzDomRoot;
+        if (!root) return;
+        const details =
+            root.tagName === "DETAILS"
+                ? root
+                : typeof root.closest === "function"
+                  ? root.closest("details")
+                  : null;
+        if (details && typeof details.removeAttribute === "function") {
+            details.removeAttribute("open");
+        }
+    }
 }
 </script>

package/src/components/Empty.vmz

@@ -1,54 +1,54 @@
-<template>
-    <div data-vmz-ui="empty" class="vmz-ui-empty">
-        <h2 class="vmz-ui-empty__title">
-            {{ title }}
-        </h2>
-        <p v-if="description" class="vmz-ui-empty__description">
-            {{ description }}
-        </p>
-        <div class="vmz-ui-empty__actions">
-            <slot />
-        </div>
-    </div>
-</template>
-<style>
-.vmz-ui-empty {
-    display: flex;
-    flex-direction: column;
-    align-items: flex-start;
-    gap: 0.625rem;
-    padding: 1.5rem 1.15rem;
-    border: 1px dashed var(--vmz-line-default);
-    border-radius: var(--vmz-radius-md, 6px);
-    background: color-mix(in srgb, var(--vmz-surface-mist) 70%, var(--vmz-surface-paper));
-    color: var(--vmz-text-ink);
-}
-
-.vmz-ui-empty__title {
-    margin: 0;
-    font-family: var(--vmz-font-display);
-    font-size: 1.1rem;
-    font-weight: 700;
-}
-
-.vmz-ui-empty__description {
-    margin: 0;
-    color: var(--vmz-text-steel);
-    max-width: 36rem;
-    line-height: 1.45;
-}
-
-.vmz-ui-empty__actions:empty {
-    display: none;
-}
-</style>
-<script client>
-/**
- * VMZ UI — Empty (Commercial composition).
- * Empty / zero-state surface with optional action slot.
- */
-export default class Empty {
-    public title: string = "Nothing here yet";
-    public description: string = "";
-}
-</script>
+<template>
+    <div data-vmz-ui="empty" class="vmz-ui-empty">
+        <h2 class="vmz-ui-empty__title">
+            {{ title }}
+        </h2>
+        <p v-if="description" class="vmz-ui-empty__description">
+            {{ description }}
+        </p>
+        <div class="vmz-ui-empty__actions">
+            <slot />
+        </div>
+    </div>
+</template>
+<style>
+.vmz-ui-empty {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 0.625rem;
+    padding: 1.5rem 1.15rem;
+    border: 1px dashed var(--vmz-line-default);
+    border-radius: var(--vmz-radius-md, 6px);
+    background: color-mix(in srgb, var(--vmz-surface-mist) 70%, var(--vmz-surface-paper));
+    color: var(--vmz-text-ink);
+}
+
+.vmz-ui-empty__title {
+    margin: 0;
+    font-family: var(--vmz-font-display);
+    font-size: 1.1rem;
+    font-weight: 700;
+}
+
+.vmz-ui-empty__description {
+    margin: 0;
+    color: var(--vmz-text-steel);
+    max-width: 36rem;
+    line-height: 1.45;
+}
+
+.vmz-ui-empty__actions:empty {
+    display: none;
+}
+</style>
+<script client>
+/**
+ * VMZ UI — Empty (Commercial composition).
+ * Empty / zero-state surface with optional action slot.
+ */
+export default class Empty {
+    public title: string = "Nothing here yet";
+    public description: string = "";
+}
+</script>

package/src/components/Field.vmz

@@ -1,115 +1,115 @@
-<template>
-    <div data-vmz-ui="field" :data-invalid="invalidAttr" class="vmz-ui-field">
-        <label v-if="label" :for="controlId" class="vmz-ui-field__label">
-            {{ label }}
-        </label>
-        <input :id="controlId" :type="type" :value="value" :min="min" :max="max" :step="step" :disabled="disabled" :aria-invalid="error ? 'true' : 'false'" :aria-describedby="describedBy" @input="onDomInput" class="vmz-ui-field__control" />
-        <p v-if="description" :id="descriptionId" class="vmz-ui-field__description">
-            {{ description }}
-        </p>
-        <p v-if="error" :id="errorId" role="alert" class="vmz-ui-field__error">
-            {{ error }}
-        </p>
-    </div>
-</template>
-<style>
-.vmz-ui-field {
-    display: flex;
-    flex-direction: column;
-    gap: 0.375rem;
-    max-width: 28rem;
-}
-
-.vmz-ui-field__label {
-    font: inherit;
-    font-weight: 500;
-    font-size: 0.875rem;
-    color: var(--vmz-text-ink, inherit);
-}
-
-.vmz-ui-field__control {
-    box-sizing: border-box;
-    width: 100%;
-    min-height: var(--vmz-control-height, 2rem);
-    font-family: var(--vmz-font-sans, inherit);
-    font-size: 0.875rem;
-    line-height: 1.5715;
-    padding: var(--vmz-density-control-padding-y, 0.25rem)
-        var(--vmz-density-control-padding-x, 0.75rem);
-    border: 1px solid var(--vmz-line-default, #d9d9d9);
-    border-radius: var(--vmz-radius-md, 6px);
-    background: var(--vmz-surface-paper, #fff);
-    color: var(--vmz-text-ink, inherit);
-    outline: none;
-    transition:
-        border-color var(--vmz-motion-control-duration, 120ms)
-            var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1)),
-        box-shadow var(--vmz-motion-control-duration, 120ms)
-            var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
-}
-
-.vmz-ui-field__control::placeholder {
-    color: var(--vmz-text-steel, #8c8c8c);
-    opacity: 1;
-}
-
-.vmz-ui-field[data-invalid="true"] .vmz-ui-field__control {
-    border-color: var(--vmz-status-danger-accent);
-}
-
-.vmz-ui-field__control:hover:not(:disabled):not(:focus-visible) {
-    border-color: var(--vmz-action-primary-background);
-}
-
-.vmz-ui-field__control:focus-visible {
-    border-color: var(--vmz-action-primary-background);
-    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
-}
-
-.vmz-ui-field__control:disabled {
-    opacity: 0.55;
-    cursor: not-allowed;
-    background: var(--vmz-surface-mist, #fafafa);
-}
-
-.vmz-ui-field__description {
-    margin: 0;
-    color: var(--vmz-text-steel, #8c8c8c);
-    font-size: 0.875rem;
-    line-height: 1.4;
-}
-
-.vmz-ui-field__error {
-    margin: 0;
-    color: var(--vmz-status-danger-foreground);
-    font-size: 0.875rem;
-}
-</style>
-<script client>
-/**
- * VMZ UI — Field (UI1).
- * Label / description / error association via for + aria-describedby.
- * Colors only from Style Theme semantic tokens.
- */
-export default class Field {
-    public label: string = "";
-    public description: string = "";
-    public error: string = "";
-    public value: string = "";
-    public type: string = "text";
-    public min: string = "";
-    public max: string = "";
-    public step: string = "";
-    public disabled: boolean = false;
-    public invalidAttr: string = "false";
-    public controlId: string = "vmz-field";
-    public descriptionId: string = "vmz-field-desc";
-    public errorId: string = "vmz-field-err";
-    public describedBy: string = "";
-    public onInput: ((e: Event) => void) | null = null;
-    onDomInput(e: Event) {
-        this.emit("input", e);
-        if (typeof this.onInput === "function") this.onInput(e);
-    }
-}
-</script>
+<template>
+    <div data-vmz-ui="field" :data-invalid="invalidAttr" class="vmz-ui-field">
+        <label v-if="label" :for="controlId" class="vmz-ui-field__label">
+            {{ label }}
+        </label>
+        <input :id="controlId" :type="type" :value="value" :min="min" :max="max" :step="step" :disabled="disabled" :aria-invalid="error ? 'true' : 'false'" :aria-describedby="describedBy" @input="onDomInput" class="vmz-ui-field__control" />
+        <p v-if="description" :id="descriptionId" class="vmz-ui-field__description">
+            {{ description }}
+        </p>
+        <p v-if="error" :id="errorId" role="alert" class="vmz-ui-field__error">
+            {{ error }}
+        </p>
+    </div>
+</template>
+<style>
+.vmz-ui-field {
+    display: flex;
+    flex-direction: column;
+    gap: 0.375rem;
+    max-width: 28rem;
+}
+
+.vmz-ui-field__label {
+    font: inherit;
+    font-weight: 500;
+    font-size: 0.875rem;
+    color: var(--vmz-text-ink, inherit);
+}
+
+.vmz-ui-field__control {
+    box-sizing: border-box;
+    width: 100%;
+    min-height: var(--vmz-control-height, 2rem);
+    font-family: var(--vmz-font-sans, inherit);
+    font-size: 0.875rem;
+    line-height: 1.5715;
+    padding: var(--vmz-density-control-padding-y, 0.25rem)
+        var(--vmz-density-control-padding-x, 0.75rem);
+    border: 1px solid var(--vmz-line-default, #d9d9d9);
+    border-radius: var(--vmz-radius-md, 6px);
+    background: var(--vmz-surface-paper, #fff);
+    color: var(--vmz-text-ink, inherit);
+    outline: none;
+    transition:
+        border-color var(--vmz-motion-control-duration, 120ms)
+            var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1)),
+        box-shadow var(--vmz-motion-control-duration, 120ms)
+            var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+}
+
+.vmz-ui-field__control::placeholder {
+    color: var(--vmz-text-steel, #8c8c8c);
+    opacity: 1;
+}
+
+.vmz-ui-field[data-invalid="true"] .vmz-ui-field__control {
+    border-color: var(--vmz-status-danger-accent);
+}
+
+.vmz-ui-field__control:hover:not(:disabled):not(:focus-visible) {
+    border-color: var(--vmz-action-primary-background);
+}
+
+.vmz-ui-field__control:focus-visible {
+    border-color: var(--vmz-action-primary-background);
+    box-shadow: 0 0 0 3px var(--vmz-focus-ring);
+}
+
+.vmz-ui-field__control:disabled {
+    opacity: 0.55;
+    cursor: not-allowed;
+    background: var(--vmz-surface-mist, #fafafa);
+}
+
+.vmz-ui-field__description {
+    margin: 0;
+    color: var(--vmz-text-steel, #8c8c8c);
+    font-size: 0.875rem;
+    line-height: 1.4;
+}
+
+.vmz-ui-field__error {
+    margin: 0;
+    color: var(--vmz-status-danger-foreground);
+    font-size: 0.875rem;
+}
+</style>
+<script client>
+/**
+ * VMZ UI — Field (UI1).
+ * Label / description / error association via for + aria-describedby.
+ * Colors only from Style Theme semantic tokens.
+ */
+export default class Field {
+    public label: string = "";
+    public description: string = "";
+    public error: string = "";
+    public value: string = "";
+    public type: string = "text";
+    public min: string = "";
+    public max: string = "";
+    public step: string = "";
+    public disabled: boolean = false;
+    public invalidAttr: string = "false";
+    public controlId: string = "vmz-field";
+    public descriptionId: string = "vmz-field-desc";
+    public errorId: string = "vmz-field-err";
+    public describedBy: string = "";
+    public onInput: ((e: Event) => void) | null = null;
+    onDomInput(e: Event) {
+        this.emit("input", e);
+        if (typeof this.onInput === "function") this.onInput(e);
+    }
+}
+</script>

package/src/components/FormItem.vmz

@@ -1,79 +1,79 @@
-<template>
-    <div data-vmz-ui="form-item" :data-required="requiredAttr" :data-invalid="invalidAttr" class="vmz-ui-form-item">
-        <label v-if="label" :for="controlId" class="vmz-ui-form-item__label">
-            <span>
-                {{ label }}
-            </span>
-            <span v-if="required" aria-hidden="true" class="vmz-ui-form-item__required">
-                *
-            </span>
-        </label>
-        <div class="vmz-ui-form-item__control">
-            <slot />
-        </div>
-        <p v-if="description" :id="descriptionId" class="vmz-ui-form-item__description">
-            {{ description }}
-        </p>
-        <p v-if="error" :id="errorId" role="alert" class="vmz-ui-form-item__error">
-            {{ error }}
-        </p>
-    </div>
-</template>
-<style>
-.vmz-ui-form-item {
-    display: flex;
-    flex-direction: column;
-    gap: 0.375rem;
-    max-width: 28rem;
-}
-
-.vmz-ui-form-item__label {
-    display: inline-flex;
-    align-items: baseline;
-    gap: 0.25rem;
-    font: inherit;
-    font-weight: 600;
-}
-
-.vmz-ui-form-item__required {
-    color: var(--vmz-status-danger-accent);
-    font-weight: 700;
-}
-
-.vmz-ui-form-item__control {
-    min-width: 0;
-}
-
-.vmz-ui-form-item__description {
-    margin: 0;
-    opacity: 0.75;
-    font-size: 0.9em;
-}
-
-.vmz-ui-form-item__error {
-    margin: 0;
-    color: var(--vmz-status-danger-foreground);
-    font-size: 0.9em;
-}
-
-.vmz-ui-form-item[data-invalid="true"] .vmz-ui-form-item__control :where(input, select, textarea) {
-    border-color: var(--vmz-status-danger-accent);
-}
-</style>
-<script client>
-/**
- * VMZ UI — FormItem.
- * Label / description / error shell for slotted controls; parent owns validation strings.
- */
-export default class FormItem {
-    public label: string = "";
-    public description: string = "";
-    public error: string = "";
-    public required: boolean = false;
-    public requiredAttr: string = "false";
-    public invalidAttr: string = "false";
-    public controlId: string = "vmz-form-item";
-    public descriptionId: string = "vmz-form-item-desc";
-    public errorId: string = "vmz-form-item-err";
-}
-</script>
+<template>
+    <div data-vmz-ui="form-item" :data-required="requiredAttr" :data-invalid="invalidAttr" class="vmz-ui-form-item">
+        <label v-if="label" :for="controlId" class="vmz-ui-form-item__label">
+            <span>
+                {{ label }}
+            </span>
+            <span v-if="required" aria-hidden="true" class="vmz-ui-form-item__required">
+                *
+            </span>
+        </label>
+        <div class="vmz-ui-form-item__control">
+            <slot />
+        </div>
+        <p v-if="description" :id="descriptionId" class="vmz-ui-form-item__description">
+            {{ description }}
+        </p>
+        <p v-if="error" :id="errorId" role="alert" class="vmz-ui-form-item__error">
+            {{ error }}
+        </p>
+    </div>
+</template>
+<style>
+.vmz-ui-form-item {
+    display: flex;
+    flex-direction: column;
+    gap: 0.375rem;
+    max-width: 28rem;
+}
+
+.vmz-ui-form-item__label {
+    display: inline-flex;
+    align-items: baseline;
+    gap: 0.25rem;
+    font: inherit;
+    font-weight: 600;
+}
+
+.vmz-ui-form-item__required {
+    color: var(--vmz-status-danger-accent);
+    font-weight: 700;
+}
+
+.vmz-ui-form-item__control {
+    min-width: 0;
+}
+
+.vmz-ui-form-item__description {
+    margin: 0;
+    opacity: 0.75;
+    font-size: 0.9em;
+}
+
+.vmz-ui-form-item__error {
+    margin: 0;
+    color: var(--vmz-status-danger-foreground);
+    font-size: 0.9em;
+}
+
+.vmz-ui-form-item[data-invalid="true"] .vmz-ui-form-item__control :where(input, select, textarea) {
+    border-color: var(--vmz-status-danger-accent);
+}
+</style>
+<script client>
+/**
+ * VMZ UI — FormItem.
+ * Label / description / error shell for slotted controls; parent owns validation strings.
+ */
+export default class FormItem {
+    public label: string = "";
+    public description: string = "";
+    public error: string = "";
+    public required: boolean = false;
+    public requiredAttr: string = "false";
+    public invalidAttr: string = "false";
+    public controlId: string = "vmz-form-item";
+    public descriptionId: string = "vmz-form-item-desc";
+    public errorId: string = "vmz-form-item-err";
+}
+</script>

package/src/components/Link.vmz

@@ -65,7 +65,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>