@vmz/ui 0.3.7 → 0.3.8

package/src/components/Dropdown.vmz

@@ -1,15 +1,40 @@
 <template>
     <details data-vmz-ui="dropdown" data-vmz-motion="overlay" data-vmz-motion-token="motion.overlay" class="vmz-ui-dropdown">
         <summary data-vmz-dropdown-trigger="1" class="vmz-ui-dropdown__trigger">
-            {{ label }}
+            <span class="vmz-ui-dropdown__trigger-label">
+                {{ label }}
+            </span>
+            <Icon name="action.chevron-down" size="sm" decorative />
         </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" />
-                <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">
+                <div v-else-if="item.kind === 'group'" role="presentation" class="vmz-ui-dropdown__group">
+                    {{ item.title }}
+                </div>
+                <details v-else-if="item.children && item.children.length" class="vmz-ui-dropdown__sub">
+                    <summary :data-danger="item.danger ? 'true' : 'false'" class="vmz-ui-dropdown__item vmz-ui-dropdown__item--sub">
+                        <span class="vmz-ui-dropdown__label">
+                            {{ item.title }}
+                        </span>
+                        <Icon name="action.chevron-right" size="sm" decorative />
+                    </summary>
+                    <div role="menu" class="vmz-ui-dropdown__subpanel">
+                        <div v-for="child in item.children" :key="child.id" class="vmz-ui-dropdown__row">
+                            <div v-if="child.divider" role="separator" class="vmz-ui-dropdown__divider" />
+                            <a v-else-if="hasHref(child)" :href="child.href" role="menuitem" :data-vmz-dropdown-item="child.id" :data-danger="child.danger ? 'true' : 'false'" :data-active="child.active ? 'true' : 'false'" :data-disabled="child.disabled ? 'true' : 'false'" :aria-disabled="child.disabled ? 'true' : null" :tabindex="child.disabled ? -1 : null" class="vmz-ui-dropdown__item">
+                                {{ child.title }}
+                            </a>
+                            <button v-else type="button" role="menuitem" :data-vmz-dropdown-item="child.id" :data-danger="child.danger ? 'true' : 'false'" :data-active="child.active ? 'true' : 'false'" :data-disabled="child.disabled ? 'true' : 'false'" :aria-disabled="child.disabled ? 'true' : null" :tabindex="child.disabled ? -1 : null" @click="onItemClick" class="vmz-ui-dropdown__item">
+                                {{ child.title }}
+                            </button>
+                        </div>
+                    </div>
+                </details>
+                <a v-else-if="hasHref(item)" :href="item.href" role="menuitem" :data-vmz-dropdown-item="item.id" :data-danger="item.danger ? 'true' : 'false'" :data-active="item.active ? '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">
+                <button v-else type="button" role="menuitem" :data-vmz-dropdown-item="item.id" :data-danger="item.danger ? 'true' : 'false'" :data-active="item.active ? '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>
@@ -24,41 +49,41 @@
 
 .vmz-ui-dropdown__trigger {
     list-style: none;
-    min-height: 2.5rem;
+    min-height: 40px;
+    box-sizing: border-box;
     display: inline-flex;
     align-items: center;
-    gap: 0.375rem;
-    padding: 0 0.9375rem;
+    gap: 6px;
+    padding: 0 15px;
     border: 1px solid var(--vmz-line-default);
-    border-radius: var(--vmz-radius-md, 6px);
+    border-radius: var(--vmz-radius-md);
     background: var(--vmz-surface-paper);
     color: var(--vmz-text-ink);
     cursor: pointer;
-    font-weight: 550;
+    font: inherit;
+    font-size: 14px;
+    font-weight: 500;
+    line-height: 22px;
     outline: none;
     transition:
-        border-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)),
-        box-shadow 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) var(--vmz-motion-control-easing),
+        background-color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing);
 }
 
-/* Chevron: affordance that the trigger opens a surface, not a page. */
-.vmz-ui-dropdown__trigger::after {
-    content: "";
-    width: 0.4375rem;
-    height: 0.4375rem;
-    margin-top: -0.1875rem;
-    border-right: 1.5px solid currentColor;
-    border-bottom: 1.5px solid currentColor;
-    opacity: 0.55;
-    transform: rotate(45deg);
-    transition: transform var(--vmz-motion-control-duration, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+.vmz-ui-dropdown summary::-webkit-details-marker {
+    display: none;
 }
 
-.vmz-ui-dropdown summary::-webkit-details-marker {
+.vmz-ui-dropdown__trigger-label:empty {
     display: none;
 }
 
+.vmz-ui-dropdown__trigger .vmz-ui-icon {
+    flex: 0 0 auto;
+    color: var(--vmz-text-tertiary);
+    transition: transform var(--vmz-motion-control-duration) var(--vmz-motion-control-easing);
+}
+
 .vmz-ui-dropdown__trigger:hover {
     border-color: var(--vmz-action-primary-hover);
     background: var(--vmz-surface-mist);
@@ -72,34 +97,40 @@
     border-color: var(--vmz-action-primary-background);
 }
 
-.vmz-ui-dropdown[open] > .vmz-ui-dropdown__trigger::after {
-    margin-top: 0.125rem;
-    transform: rotate(-135deg);
+.vmz-ui-dropdown[open] > .vmz-ui-dropdown__trigger .vmz-ui-icon {
+    transform: rotate(180deg);
 }
 
 .vmz-ui-dropdown__menu {
     position: absolute;
-    top: calc(100% + 0.375rem);
+    top: calc(100% + 6px);
     right: 0;
     z-index: 50;
-    min-width: 11rem;
-    padding: 0.25rem;
-    border: 1px solid var(--vmz-line-subtle, var(--vmz-line-default));
-    border-radius: var(--vmz-radius-lg, 8px);
+    min-width: 176px;
+    box-sizing: border-box;
+    padding: 4px;
+    border: 1px solid var(--vmz-line-subtle);
+    border-radius: var(--vmz-radius-lg);
     background: var(--vmz-surface-paper);
+    color: var(--vmz-text-ink);
     box-shadow: var(--vmz-shadow-popup);
     transform-origin: top right;
-    animation: vmz-dropdown-in var(--vmz-motion-overlay-duration, 180ms) var(--vmz-motion-overlay-easing, cubic-bezier(0.2, 0, 0, 1));
+    animation: vmz-dropdown-in var(--vmz-motion-overlay-duration)
+        var(--vmz-motion-overlay-easing);
+}
+
+.vmz-ui-dropdown__item--sub {
+    list-style: none;
 }
 
 @keyframes vmz-dropdown-in {
     from {
         opacity: 0;
-        transform: translateY(-0.25rem) scale(0.98);
+        transform: translateY(-4px) scale(0.98);
     }
     to {
         opacity: 1;
-        transform: translateY(0) scale(1);
+        transform: none;
     }
 }
 
@@ -108,7 +139,7 @@
         animation: none;
     }
     .vmz-ui-dropdown__trigger,
-    .vmz-ui-dropdown__trigger::after {
+    .vmz-ui-dropdown__trigger .vmz-ui-icon {
         transition: none;
     }
 }
@@ -118,23 +149,27 @@
 }
 
 .vmz-ui-dropdown__item {
-    display: block;
+    display: flex;
+    align-items: center;
+    gap: 8px;
     width: 100%;
-    padding: 0.5rem 0.75rem;
+    min-height: 32px;
+    box-sizing: border-box;
+    padding: 0 12px;
     border: 0;
-    border-radius: var(--vmz-radius-sm, 4px);
+    border-radius: var(--vmz-radius-md);
     background: transparent;
     color: var(--vmz-text-ink);
     cursor: pointer;
     font: inherit;
-    font-size: 0.875rem;
-    line-height: 1.4286;
+    font-size: 14px;
+    line-height: 22px;
     text-align: left;
     text-decoration: none;
     outline: none;
     transition:
-        background-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, 150ms) var(--vmz-motion-control-easing, cubic-bezier(0.4, 0, 0.2, 1));
+        background-color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing),
+        color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing);
 }
 
 .vmz-ui-dropdown__item:hover {
@@ -143,27 +178,70 @@
 
 .vmz-ui-dropdown__item:focus-visible {
     background: var(--vmz-surface-mist);
-    box-shadow: inset 0 0 0 3px var(--vmz-focus-ring);
+    box-shadow: inset 0 0 0 2px var(--vmz-focus-ring);
+}
+
+.vmz-ui-dropdown__item[data-active="true"] {
+    background: color-mix(in srgb, var(--vmz-action-primary-background) 10%, transparent);
+    box-shadow: inset 2px 0 0 var(--vmz-action-primary-background);
 }
 
 .vmz-ui-dropdown__item[data-danger="true"] {
     color: var(--vmz-status-danger-foreground);
 }
 
-.vmz-ui-dropdown__item[data-danger="true"]:hover {
+.vmz-ui-dropdown__item[data-danger="true"]:hover,
+.vmz-ui-dropdown__item[data-danger="true"]:focus-visible {
     background: color-mix(in srgb, var(--vmz-status-danger-accent) 12%, transparent);
 }
 
 .vmz-ui-dropdown__item[data-disabled="true"] {
-    color: var(--vmz-text-steel);
+    color: var(--vmz-text-tertiary);
     cursor: not-allowed;
     pointer-events: none;
 }
 
 .vmz-ui-dropdown__divider {
     height: 1px;
-    margin: 0.25rem 0.5rem;
-    background: var(--vmz-line-subtle, var(--vmz-line-default));
+    margin: 4px 8px;
+    background: var(--vmz-line-subtle);
+}
+
+.vmz-ui-dropdown__group {
+    padding: 8px 12px 4px;
+    font-size: 12px;
+    font-weight: 600;
+    line-height: 20px;
+    color: var(--vmz-text-tertiary);
+}
+
+.vmz-ui-dropdown__label {
+    flex: 1 1 auto;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.vmz-ui-dropdown__item--sub .vmz-ui-icon {
+    flex: 0 0 auto;
+    color: var(--vmz-text-tertiary);
+}
+
+.vmz-ui-dropdown__sub {
+    position: relative;
+}
+
+.vmz-ui-dropdown__sub[open] > .vmz-ui-dropdown__item--sub {
+    background: var(--vmz-surface-mist);
+}
+
+.vmz-ui-dropdown__subpanel {
+    display: flex;
+    flex-direction: column;
+    margin: 2px 0 4px;
+    padding: 4px 0 4px 12px;
+    border-left: 1px solid var(--vmz-line-subtle);
 }
 </style>
 <script client>
@@ -172,6 +250,9 @@
  * 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.
+ *
+ * Item model adds `kind: "group"` headers, `active` styling and one level of
+ * nested `children` rendered inside a nested `<details>` submenu.
  */
 export type DropdownItem = {
     id: string;
@@ -184,10 +265,16 @@ export type DropdownItem = {
     disabled?: boolean;
     /** Render a separator instead of a row (title/href are ignored). */
     divider?: boolean;
+    /** `"group"` renders a 12px tertiary section title. */
+    kind?: string;
+    /** Current selection — light primary fill plus a 2px leading bar. */
+    active?: boolean;
+    /** One level of nested items rendered as a submenu. */
+    children?: DropdownItem[];
 };
 
 export default class Dropdown {
-    public label: string = "Menu";
+    public label: string = "";
     public items: DropdownItem[] = [];
     /** Action-item selection callback (`:on-select`). Link items bypass it. */
     public onSelect: ((id: string) => void) | null = null;
@@ -203,12 +290,23 @@ export default class Dropdown {
                 ? el.getAttribute("data-vmz-dropdown-item")
                 : null;
         if (!id) return;
-        const item = this.items.find((candidate) => candidate.id === id);
+        const item = this._findItem(id);
         if (!item || item.disabled || this.hasHref(item)) return;
         this.close();
         if (typeof this.onSelect === "function") this.onSelect(id);
     }
 
+    _findItem(id) {
+        for (const item of this.items || []) {
+            if (item.id === id) return item;
+            if (Array.isArray(item.children)) {
+                const child = item.children.find((candidate) => candidate.id === id);
+                if (child) return child;
+            }
+        }
+        return null;
+    }
+
     close() {
         const root = this.__vmzDomRoot;
         if (!root) return;

package/src/components/Empty.vmz

@@ -1,6 +1,9 @@
 <template>
     <div data-vmz-ui="empty" class="vmz-ui-empty">
-        <h2 class="vmz-ui-empty__title">
+        <span aria-hidden="true" class="vmz-ui-empty__illustration">
+            <Icon :name="icon" size="lg" decorative />
+        </span>
+        <h2 v-if="title" class="vmz-ui-empty__title">
             {{ title }}
         </h2>
         <p v-if="description" class="vmz-ui-empty__description">
@@ -15,40 +18,79 @@
 .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));
+    align-items: center;
+    justify-content: center;
+    gap: var(--vmz-space-2, 0.5rem);
+    padding: var(--vmz-space-6, 2rem);
+    text-align: center;
+    background: transparent;
     color: var(--vmz-text-ink);
 }
 
+.vmz-ui-empty__illustration {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 4rem;
+    height: 4rem;
+    margin-bottom: var(--vmz-space-1, 0.25rem);
+    border: 1px solid var(--vmz-line-default, var(--vmz-line-strong));
+    border-radius: var(--vmz-radius-pill, 999px);
+    background: var(--vmz-surface-mist);
+    color: var(--vmz-text-muted);
+}
+
+.vmz-ui-empty__illustration .vmz-ui-icon[data-size] {
+    font-size: 2rem;
+}
+
 .vmz-ui-empty__title {
     margin: 0;
-    font-family: var(--vmz-font-display);
-    font-size: 1.1rem;
-    font-weight: 700;
+    font-family: var(--vmz-font-display, var(--vmz-font-sans, inherit));
+    font-size: 1rem;
+    font-weight: 600;
+    line-height: 1.4;
+    color: var(--vmz-text-ink);
 }
 
 .vmz-ui-empty__description {
     margin: 0;
-    color: var(--vmz-text-steel);
     max-width: 36rem;
-    line-height: 1.45;
+    font-size: 0.875rem;
+    line-height: 1.55;
+    color: var(--vmz-text-tertiary);
+}
+
+.vmz-ui-empty__actions {
+    display: flex;
+    flex-wrap: wrap;
+    justify-content: center;
+    gap: var(--vmz-space-2, 0.5rem);
+    margin-top: var(--vmz-space-2, 0.5rem);
 }
 
 .vmz-ui-empty__actions:empty {
     display: none;
 }
+
+:where([data-density="compact"]) .vmz-ui-empty {
+    gap: var(--vmz-density-compact-gap);
+    padding: var(--vmz-space-5, 1.5rem);
+}
+
+:where([data-density="dense"]) .vmz-ui-empty {
+    gap: var(--vmz-density-dense-gap);
+    padding: var(--vmz-space-4, 1rem);
+}
 </style>
 <script client>
 /**
  * VMZ UI — Empty (Commercial composition).
- * Empty / zero-state surface with optional action slot.
+ * Empty / zero-state surface with neutral registry icon and optional action slot.
  */
 export default class Empty {
-    public title: string = "Nothing here yet";
+    public title: string = "";
     public description: string = "";
+    public icon: string = "feature.runtime";
 }
 </script>

package/src/components/Field.vmz

@@ -1,9 +1,13 @@
 <template>
-    <div data-vmz-ui="field" :data-invalid="invalidAttr" class="vmz-ui-field">
+    <div data-vmz-ui="field" :data-invalid="error ? 'true' : 'false'" 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" />
+        <div :data-prefix="prefix ? 'true' : 'false'" :data-suffix="suffix ? 'true' : 'false'" class="vmz-ui-field__control-wrap">
+            <Icon v-if="prefix" :name="prefix" size="md" decorative class="vmz-ui-field__icon vmz-ui-field__icon--prefix" />
+            <input :id="controlId" :type="type" :value="value" :min="min" :max="max" :step="step" :placeholder="placeholder" :disabled="disabled" :readonly="readonly" :aria-invalid="error ? 'true' : 'false'" :aria-describedby="describedBy" @input="onDomInput" class="vmz-ui-field__control" />
+            <Icon v-if="suffix" :name="suffix" size="md" decorative class="vmz-ui-field__icon vmz-ui-field__icon--suffix" />
+        </div>
         <p v-if="description" :id="descriptionId" class="vmz-ui-field__description">
             {{ description }}
         </p>
@@ -16,7 +20,8 @@
 .vmz-ui-field {
     display: flex;
     flex-direction: column;
-    gap: 0.375rem;
+    gap: var(--vmz-space-2);
+    width: 100%;
     max-width: 28rem;
 }
 
@@ -24,32 +29,67 @@
     font: inherit;
     font-weight: 500;
     font-size: 0.875rem;
-    color: var(--vmz-text-ink, inherit);
+    line-height: 1.5715;
+    color: var(--vmz-text-ink);
+}
+
+.vmz-ui-field__control-wrap {
+    position: relative;
+    display: flex;
+    align-items: center;
+    width: 100%;
 }
 
 .vmz-ui-field__control {
     box-sizing: border-box;
     width: 100%;
-    min-height: var(--vmz-control-height, 2rem);
-    font-family: var(--vmz-font-sans, inherit);
+    min-height: var(--vmz-control-height);
+    font-family: 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);
+    padding: var(--vmz-density-control-padding-y) var(--vmz-density-control-padding-x);
+    border: 1px solid var(--vmz-line-default);
+    border-radius: var(--vmz-radius-lg);
+    background: var(--vmz-surface-paper);
+    color: var(--vmz-text-ink);
     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));
+        border-color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing),
+        box-shadow var(--vmz-motion-control-duration) var(--vmz-motion-control-easing),
+        background-color var(--vmz-motion-control-duration) var(--vmz-motion-control-easing);
+}
+
+.vmz-ui-field__control-wrap[data-prefix="true"] .vmz-ui-field__control {
+    padding-left: calc(
+        var(--vmz-density-control-padding-x) + var(--vmz-space-4) + var(--vmz-space-1)
+    );
+}
+
+.vmz-ui-field__control-wrap[data-suffix="true"] .vmz-ui-field__control {
+    padding-right: calc(
+        var(--vmz-density-control-padding-x) + var(--vmz-space-4) + var(--vmz-space-1)
+    );
+}
+
+.vmz-ui-field__icon {
+    position: absolute;
+    top: 50%;
+    z-index: 1;
+    color: var(--vmz-text-tertiary);
+    transform: translateY(-50%);
+    pointer-events: none;
+}
+
+.vmz-ui-field__icon--prefix {
+    left: var(--vmz-density-control-padding-x);
+}
+
+.vmz-ui-field__icon--suffix {
+    right: var(--vmz-density-control-padding-x);
 }
 
 .vmz-ui-field__control::placeholder {
-    color: var(--vmz-text-steel, #8c8c8c);
+    color: var(--vmz-text-tertiary);
     opacity: 1;
 }
 
@@ -57,8 +97,13 @@
     border-color: var(--vmz-status-danger-accent);
 }
 
+.vmz-ui-field[data-invalid="true"] .vmz-ui-field__control:hover:not(:disabled),
+.vmz-ui-field[data-invalid="true"] .vmz-ui-field__control:focus-visible {
+    border-color: var(--vmz-status-danger-foreground);
+}
+
 .vmz-ui-field__control:hover:not(:disabled):not(:focus-visible) {
-    border-color: var(--vmz-action-primary-background);
+    border-color: var(--vmz-action-primary-hover);
 }
 
 .vmz-ui-field__control:focus-visible {
@@ -67,22 +112,29 @@
 }
 
 .vmz-ui-field__control:disabled {
-    opacity: 0.55;
+    opacity: 0.6;
+    color: var(--vmz-text-muted);
     cursor: not-allowed;
-    background: var(--vmz-surface-mist, #fafafa);
+    background: var(--vmz-surface-mist);
+}
+
+.vmz-ui-field__control:read-only {
+    cursor: default;
+    background: var(--vmz-surface-mist);
 }
 
 .vmz-ui-field__description {
     margin: 0;
-    color: var(--vmz-text-steel, #8c8c8c);
+    color: var(--vmz-text-steel);
     font-size: 0.875rem;
-    line-height: 1.4;
+    line-height: 1.5715;
 }
 
 .vmz-ui-field__error {
     margin: 0;
     color: var(--vmz-status-danger-foreground);
     font-size: 0.875rem;
+    line-height: 1.5715;
 }
 </style>
 <script client>
@@ -97,11 +149,14 @@ export default class Field {
     public error: string = "";
     public value: string = "";
     public type: string = "text";
+    public placeholder: string = "";
+    public prefix: string = "";
+    public suffix: string = "";
     public min: string = "";
     public max: string = "";
     public step: string = "";
     public disabled: boolean = false;
-    public invalidAttr: string = "false";
+    public readonly: boolean = false;
     public controlId: string = "vmz-field";
     public descriptionId: string = "vmz-field-desc";
     public errorId: string = "vmz-field-err";

package/src/components/FilterBar.vmz

@@ -8,10 +8,40 @@
     display: flex;
     flex-wrap: wrap;
     align-items: flex-end;
-    gap: 0.75rem 1rem;
-    padding: 0.75rem 0.85rem;
+    gap: 0.75rem;
+    padding: 1rem;
     border: 1px solid var(--vmz-line-default);
-    border-radius: var(--vmz-radius-md, 6px);
+    border-radius: var(--vmz-radius-lg, 8px);
+    background: var(--vmz-surface-paper);
+}
+
+/* Action controls (Field + buttons) keep 32px height and hug the right edge. */
+.vmz-ui-filter-bar .vmz-ui-field__control,
+.vmz-ui-filter-bar .vmz-ui-select__control,
+.vmz-ui-filter-bar .vmz-ui-btn {
+    min-height: 2rem;
+}
+
+.vmz-ui-filter-bar > :has(.vmz-ui-btn),
+.vmz-ui-filter-bar > button.vmz-ui-btn {
+    margin-left: auto;
+}
+
+@media (max-width: 40rem) {
+    .vmz-ui-filter-bar {
+        flex-direction: column;
+        align-items: flex-start;
+        gap: 0.5rem;
+    }
+
+    .vmz-ui-filter-bar > * {
+        width: 100%;
+    }
+
+    .vmz-ui-filter-bar > :has(.vmz-ui-btn),
+    .vmz-ui-filter-bar > button.vmz-ui-btn {
+        margin-left: 0;
+    }
 }
 </style>
 <script client>
@@ -20,6 +50,6 @@
  * Dense filter/query landmark; parent projects Field + action controls.
  */
 export default class FilterBar {
-    public label: string = "Filters";
+    public label: string = "";
 }
 </script>

package/src/components/Flex.vmz

@@ -8,13 +8,15 @@
     display: flex;
     align-items: center;
     justify-content: flex-start;
-    gap: 0.75rem;
+    gap: var(--vmz-space-3);
     min-width: 0;
 }
+
 .vmz-ui-flex[data-vertical="true"] {
     flex-direction: column;
     align-items: stretch;
 }
+
 .vmz-ui-flex[data-wrap="true"] {
     flex-wrap: wrap;
 }